Alibaba Cloud v3.76.0 published on Tuesday, Apr 8, 2025 by Pulumi
alicloud.ga.getListeners
Explore with Pulumi AI
This data source provides the Global Accelerator (GA) Listeners of the current Alibaba Cloud user.
NOTE: Available since v1.111.0.
Example Usage
Basic Usage
import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const example = alicloud.ga.getListeners({
acceleratorId: "example_value",
ids: ["example_value"],
nameRegex: "the_resource_name",
});
export const firstGaListenerId = example.then(example => example.listeners?.[0]?.id);
import pulumi
import pulumi_alicloud as alicloud
example = alicloud.ga.get_listeners(accelerator_id="example_value",
ids=["example_value"],
name_regex="the_resource_name")
pulumi.export("firstGaListenerId", example.listeners[0].id)
package main
import (
"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/ga"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := ga.GetListeners(ctx, &ga.GetListenersArgs{
AcceleratorId: "example_value",
Ids: []string{
"example_value",
},
NameRegex: pulumi.StringRef("the_resource_name"),
}, nil)
if err != nil {
return err
}
ctx.Export("firstGaListenerId", example.Listeners[0].Id)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
var example = AliCloud.Ga.GetListeners.Invoke(new()
{
AcceleratorId = "example_value",
Ids = new[]
{
"example_value",
},
NameRegex = "the_resource_name",
});
return new Dictionary<string, object?>
{
["firstGaListenerId"] = example.Apply(getListenersResult => getListenersResult.Listeners[0]?.Id),
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.ga.GaFunctions;
import com.pulumi.alicloud.ga.inputs.GetListenersArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var example = GaFunctions.getListeners(GetListenersArgs.builder()
.acceleratorId("example_value")
.ids("example_value")
.nameRegex("the_resource_name")
.build());
ctx.export("firstGaListenerId", example.applyValue(getListenersResult -> getListenersResult.listeners()[0].id()));
}
}
variables:
example:
fn::invoke:
function: alicloud:ga:getListeners
arguments:
acceleratorId: example_value
ids:
- example_value
nameRegex: the_resource_name
outputs:
firstGaListenerId: ${example.listeners[0].id}
Using getListeners
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getListeners(args: GetListenersArgs, opts?: InvokeOptions): Promise<GetListenersResult>
function getListenersOutput(args: GetListenersOutputArgs, opts?: InvokeOptions): Output<GetListenersResult>
def get_listeners(accelerator_id: Optional[str] = None,
ids: Optional[Sequence[str]] = None,
name_regex: Optional[str] = None,
output_file: Optional[str] = None,
status: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetListenersResult
def get_listeners_output(accelerator_id: Optional[pulumi.Input[str]] = None,
ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
name_regex: Optional[pulumi.Input[str]] = None,
output_file: Optional[pulumi.Input[str]] = None,
status: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetListenersResult]
func GetListeners(ctx *Context, args *GetListenersArgs, opts ...InvokeOption) (*GetListenersResult, error)
func GetListenersOutput(ctx *Context, args *GetListenersOutputArgs, opts ...InvokeOption) GetListenersResultOutput
> Note: This function is named GetListeners
in the Go SDK.
public static class GetListeners
{
public static Task<GetListenersResult> InvokeAsync(GetListenersArgs args, InvokeOptions? opts = null)
public static Output<GetListenersResult> Invoke(GetListenersInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetListenersResult> getListeners(GetListenersArgs args, InvokeOptions options)
public static Output<GetListenersResult> getListeners(GetListenersArgs args, InvokeOptions options)
fn::invoke:
function: alicloud:ga/getListeners:getListeners
arguments:
# arguments dictionary
The following arguments are supported:
- Accelerator
Id This property is required. Changes to this property will trigger replacement.
- The accelerator id.
- Ids
Changes to this property will trigger replacement.
- A list of Listener IDs.
- Name
Regex Changes to this property will trigger replacement.
- A regex string to filter results by Listener name.
- Output
File string - File name where to save data source results (after running
pulumi preview
). - Status
Changes to this property will trigger replacement.
- The status of the listener. Valid values:
active
,configuring
,creating
.
- Accelerator
Id This property is required. Changes to this property will trigger replacement.
- The accelerator id.
- Ids
Changes to this property will trigger replacement.
- A list of Listener IDs.
- Name
Regex Changes to this property will trigger replacement.
- A regex string to filter results by Listener name.
- Output
File string - File name where to save data source results (after running
pulumi preview
). - Status
Changes to this property will trigger replacement.
- The status of the listener. Valid values:
active
,configuring
,creating
.
- accelerator
Id This property is required. Changes to this property will trigger replacement.
- The accelerator id.
- ids
Changes to this property will trigger replacement.
- A list of Listener IDs.
- name
Regex Changes to this property will trigger replacement.
- A regex string to filter results by Listener name.
- output
File String - File name where to save data source results (after running
pulumi preview
). - status
Changes to this property will trigger replacement.
- The status of the listener. Valid values:
active
,configuring
,creating
.
- accelerator
Id This property is required. Changes to this property will trigger replacement.
- The accelerator id.
- ids
Changes to this property will trigger replacement.
- A list of Listener IDs.
- name
Regex Changes to this property will trigger replacement.
- A regex string to filter results by Listener name.
- output
File string - File name where to save data source results (after running
pulumi preview
). - status
Changes to this property will trigger replacement.
- The status of the listener. Valid values:
active
,configuring
,creating
.
- accelerator_
id This property is required. Changes to this property will trigger replacement.
- The accelerator id.
- ids
Changes to this property will trigger replacement.
- A list of Listener IDs.
- name_
regex Changes to this property will trigger replacement.
- A regex string to filter results by Listener name.
- output_
file str - File name where to save data source results (after running
pulumi preview
). - status
Changes to this property will trigger replacement.
- The status of the listener. Valid values:
active
,configuring
,creating
.
- accelerator
Id This property is required. Changes to this property will trigger replacement.
- The accelerator id.
- ids
Changes to this property will trigger replacement.
- A list of Listener IDs.
- name
Regex Changes to this property will trigger replacement.
- A regex string to filter results by Listener name.
- output
File String - File name where to save data source results (after running
pulumi preview
). - status
Changes to this property will trigger replacement.
- The status of the listener. Valid values:
active
,configuring
,creating
.
getListeners Result
The following output properties are available:
- Accelerator
Id string - Id string
- The provider-assigned unique ID for this managed resource.
- Ids List<string>
- Listeners
List<Pulumi.
Ali Cloud. Ga. Outputs. Get Listeners Listener> - A list of Ga Listeners. Each element contains the following attributes:
- Names List<string>
- A list of Listener names.
- Name
Regex string - Output
File string - Status string
- The status of the listener.
- Accelerator
Id string - Id string
- The provider-assigned unique ID for this managed resource.
- Ids []string
- Listeners
[]Get
Listeners Listener - A list of Ga Listeners. Each element contains the following attributes:
- Names []string
- A list of Listener names.
- Name
Regex string - Output
File string - Status string
- The status of the listener.
- accelerator
Id String - id String
- The provider-assigned unique ID for this managed resource.
- ids List<String>
- listeners
List<Get
Listeners Listener> - A list of Ga Listeners. Each element contains the following attributes:
- names List<String>
- A list of Listener names.
- name
Regex String - output
File String - status String
- The status of the listener.
- accelerator
Id string - id string
- The provider-assigned unique ID for this managed resource.
- ids string[]
- listeners
Get
Listeners Listener[] - A list of Ga Listeners. Each element contains the following attributes:
- names string[]
- A list of Listener names.
- name
Regex string - output
File string - status string
- The status of the listener.
- accelerator_
id str - id str
- The provider-assigned unique ID for this managed resource.
- ids Sequence[str]
- listeners
Sequence[Get
Listeners Listener] - A list of Ga Listeners. Each element contains the following attributes:
- names Sequence[str]
- A list of Listener names.
- name_
regex str - output_
file str - status str
- The status of the listener.
- accelerator
Id String - id String
- The provider-assigned unique ID for this managed resource.
- ids List<String>
- listeners List<Property Map>
- A list of Ga Listeners. Each element contains the following attributes:
- names List<String>
- A list of Listener names.
- name
Regex String - output
File String - status String
- The status of the listener.
Supporting Types
GetListenersListener
- Certificates
This property is required. List<Pulumi.Ali Cloud. Ga. Inputs. Get Listeners Listener Certificate> - The certificates of the listener.
- Client
Affinity This property is required. string - The clientAffinity of the listener.
- Description
This property is required. string - The description of the listener.
- Id
This property is required. string - The ID of the Listener.
- Listener
Id This property is required. string - The listenerId of the listener.
- Name
This property is required. string - The name of the listener. The length of the name is 2-128 characters. It starts with uppercase and lowercase letters or Chinese characters. It can contain numbers and underscores and dashes.
- Port
Ranges This property is required. List<Pulumi.Ali Cloud. Ga. Inputs. Get Listeners Listener Port Range> - The portRanges of the listener.
- Protocol
This property is required. string - Type of network transport protocol monitored.
- Status
This property is required. string - The status of the listener. Valid values:
active
,configuring
,creating
.
- Certificates
This property is required. []GetListeners Listener Certificate - The certificates of the listener.
- Client
Affinity This property is required. string - The clientAffinity of the listener.
- Description
This property is required. string - The description of the listener.
- Id
This property is required. string - The ID of the Listener.
- Listener
Id This property is required. string - The listenerId of the listener.
- Name
This property is required. string - The name of the listener. The length of the name is 2-128 characters. It starts with uppercase and lowercase letters or Chinese characters. It can contain numbers and underscores and dashes.
- Port
Ranges This property is required. []GetListeners Listener Port Range - The portRanges of the listener.
- Protocol
This property is required. string - Type of network transport protocol monitored.
- Status
This property is required. string - The status of the listener. Valid values:
active
,configuring
,creating
.
- certificates
This property is required. List<GetListeners Listener Certificate> - The certificates of the listener.
- client
Affinity This property is required. String - The clientAffinity of the listener.
- description
This property is required. String - The description of the listener.
- id
This property is required. String - The ID of the Listener.
- listener
Id This property is required. String - The listenerId of the listener.
- name
This property is required. String - The name of the listener. The length of the name is 2-128 characters. It starts with uppercase and lowercase letters or Chinese characters. It can contain numbers and underscores and dashes.
- port
Ranges This property is required. List<GetListeners Listener Port Range> - The portRanges of the listener.
- protocol
This property is required. String - Type of network transport protocol monitored.
- status
This property is required. String - The status of the listener. Valid values:
active
,configuring
,creating
.
- certificates
This property is required. GetListeners Listener Certificate[] - The certificates of the listener.
- client
Affinity This property is required. string - The clientAffinity of the listener.
- description
This property is required. string - The description of the listener.
- id
This property is required. string - The ID of the Listener.
- listener
Id This property is required. string - The listenerId of the listener.
- name
This property is required. string - The name of the listener. The length of the name is 2-128 characters. It starts with uppercase and lowercase letters or Chinese characters. It can contain numbers and underscores and dashes.
- port
Ranges This property is required. GetListeners Listener Port Range[] - The portRanges of the listener.
- protocol
This property is required. string - Type of network transport protocol monitored.
- status
This property is required. string - The status of the listener. Valid values:
active
,configuring
,creating
.
- certificates
This property is required. Sequence[GetListeners Listener Certificate] - The certificates of the listener.
- client_
affinity This property is required. str - The clientAffinity of the listener.
- description
This property is required. str - The description of the listener.
- id
This property is required. str - The ID of the Listener.
- listener_
id This property is required. str - The listenerId of the listener.
- name
This property is required. str - The name of the listener. The length of the name is 2-128 characters. It starts with uppercase and lowercase letters or Chinese characters. It can contain numbers and underscores and dashes.
- port_
ranges This property is required. Sequence[GetListeners Listener Port Range] - The portRanges of the listener.
- protocol
This property is required. str - Type of network transport protocol monitored.
- status
This property is required. str - The status of the listener. Valid values:
active
,configuring
,creating
.
- certificates
This property is required. List<Property Map> - The certificates of the listener.
- client
Affinity This property is required. String - The clientAffinity of the listener.
- description
This property is required. String - The description of the listener.
- id
This property is required. String - The ID of the Listener.
- listener
Id This property is required. String - The listenerId of the listener.
- name
This property is required. String - The name of the listener. The length of the name is 2-128 characters. It starts with uppercase and lowercase letters or Chinese characters. It can contain numbers and underscores and dashes.
- port
Ranges This property is required. List<Property Map> - The portRanges of the listener.
- protocol
This property is required. String - Type of network transport protocol monitored.
- status
This property is required. String - The status of the listener. Valid values:
active
,configuring
,creating
.
GetListenersListenerCertificate
GetListenersListenerPortRange
Package Details
- Repository
- Alibaba Cloud pulumi/pulumi-alicloud
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
alicloud
Terraform Provider.