1. Packages
  2. Alibaba Cloud Provider
  3. API Docs
  4. ga
  5. getBasicEndpoints
Alibaba Cloud v3.88.0 published on Saturday, Nov 1, 2025 by Pulumi
pulumi/pulumi-alicloud

alicloud.ga.getBasicEndpoints

Get Started
alicloud logo
Alibaba Cloud v3.88.0 published on Saturday, Nov 1, 2025 by Pulumi
pulumi/pulumi-alicloud

    This data source provides the Global Accelerator (GA) Basic Endpoints of the current Alibaba Cloud user.

    NOTE: Available since v1.194.0.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";

const ids = alicloud.ga.getBasicEndpoints({
    ids: ["example_id"],
    endpointGroupId: "example_id",
});
export const gaBasicEndpointsId1 = ids.then(ids => ids.endpoints?.[0]?.id);
const nameRegex = alicloud.ga.getBasicEndpoints({
    nameRegex: "tf-example",
    endpointGroupId: "example_id",
});
export const gaBasicEndpointsId2 = nameRegex.then(nameRegex => nameRegex.endpoints?.[0]?.id);

    import pulumi
import pulumi_alicloud as alicloud

ids = alicloud.ga.get_basic_endpoints(ids=["example_id"],
    endpoint_group_id="example_id")
pulumi.export("gaBasicEndpointsId1", ids.endpoints[0].id)
name_regex = alicloud.ga.get_basic_endpoints(name_regex="tf-example",
    endpoint_group_id="example_id")
pulumi.export("gaBasicEndpointsId2", name_regex.endpoints[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 {
		ids, err := ga.GetBasicEndpoints(ctx, &ga.GetBasicEndpointsArgs{
			Ids: []string{
				"example_id",
			},
			EndpointGroupId: "example_id",
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("gaBasicEndpointsId1", ids.Endpoints[0].Id)
		nameRegex, err := ga.GetBasicEndpoints(ctx, &ga.GetBasicEndpointsArgs{
			NameRegex:       pulumi.StringRef("tf-example"),
			EndpointGroupId: "example_id",
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("gaBasicEndpointsId2", nameRegex.Endpoints[0].Id)
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;

return await Deployment.RunAsync(() => 
{
    var ids = AliCloud.Ga.GetBasicEndpoints.Invoke(new()
    {
        Ids = new[]
        {
            "example_id",
        },
        EndpointGroupId = "example_id",
    });

    var nameRegex = AliCloud.Ga.GetBasicEndpoints.Invoke(new()
    {
        NameRegex = "tf-example",
        EndpointGroupId = "example_id",
    });

    return new Dictionary<string, object?>
    {
        ["gaBasicEndpointsId1"] = ids.Apply(getBasicEndpointsResult => getBasicEndpointsResult.Endpoints[0]?.Id),
        ["gaBasicEndpointsId2"] = nameRegex.Apply(getBasicEndpointsResult => getBasicEndpointsResult.Endpoints[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.GetBasicEndpointsArgs;
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 ids = GaFunctions.getBasicEndpoints(GetBasicEndpointsArgs.builder()
            .ids("example_id")
            .endpointGroupId("example_id")
            .build());

        ctx.export("gaBasicEndpointsId1", ids.endpoints()[0].id());
        final var nameRegex = GaFunctions.getBasicEndpoints(GetBasicEndpointsArgs.builder()
            .nameRegex("tf-example")
            .endpointGroupId("example_id")
            .build());

        ctx.export("gaBasicEndpointsId2", nameRegex.endpoints()[0].id());
    }
}

    variables:
  ids:
    fn::invoke:
      function: alicloud:ga:getBasicEndpoints
      arguments:
        ids:
          - example_id
        endpointGroupId: example_id
  nameRegex:
    fn::invoke:
      function: alicloud:ga:getBasicEndpoints
      arguments:
        nameRegex: tf-example
        endpointGroupId: example_id
outputs:
  gaBasicEndpointsId1: ${ids.endpoints[0].id}
  gaBasicEndpointsId2: ${nameRegex.endpoints[0].id}

    Using getBasicEndpoints

    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 getBasicEndpoints(args: GetBasicEndpointsArgs, opts?: InvokeOptions): Promise<GetBasicEndpointsResult>
function getBasicEndpointsOutput(args: GetBasicEndpointsOutputArgs, opts?: InvokeOptions): Output<GetBasicEndpointsResult>
    def get_basic_endpoints(endpoint_group_id: Optional[str] = None,
                        endpoint_id: Optional[str] = None,
                        endpoint_type: Optional[str] = None,
                        ids: Optional[Sequence[str]] = None,
                        name: Optional[str] = None,
                        name_regex: Optional[str] = None,
                        output_file: Optional[str] = None,
                        status: Optional[str] = None,
                        opts: Optional[InvokeOptions] = None) -> GetBasicEndpointsResult
def get_basic_endpoints_output(endpoint_group_id: Optional[pulumi.Input[str]] = None,
                        endpoint_id: Optional[pulumi.Input[str]] = None,
                        endpoint_type: Optional[pulumi.Input[str]] = None,
                        ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                        name: Optional[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[GetBasicEndpointsResult]
    func GetBasicEndpoints(ctx *Context, args *GetBasicEndpointsArgs, opts ...InvokeOption) (*GetBasicEndpointsResult, error)
func GetBasicEndpointsOutput(ctx *Context, args *GetBasicEndpointsOutputArgs, opts ...InvokeOption) GetBasicEndpointsResultOutput

    > Note: This function is named GetBasicEndpoints in the Go SDK.

    public static class GetBasicEndpoints 
{
    public static Task<GetBasicEndpointsResult> InvokeAsync(GetBasicEndpointsArgs args, InvokeOptions? opts = null)
    public static Output<GetBasicEndpointsResult> Invoke(GetBasicEndpointsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetBasicEndpointsResult> getBasicEndpoints(GetBasicEndpointsArgs args, InvokeOptions options)
public static Output<GetBasicEndpointsResult> getBasicEndpoints(GetBasicEndpointsArgs args, InvokeOptions options)

    fn::invoke:
  function: alicloud:ga/getBasicEndpoints:getBasicEndpoints
  arguments:
    # arguments dictionary

    The following arguments are supported:

    EndpointGroupId string
    The ID of the Basic Endpoint Group.
    EndpointId string
    The ID of the Basic Endpoint.
    EndpointType string
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    Ids List<string>
    A list of Global Accelerator Basic Endpoints IDs.
    Name string
    The name of the Basic Endpoint.
    NameRegex string
    A regex string to filter results by Global Accelerator Basic Endpoints name.
    OutputFile string
    File name where to save data source results (after running pulumi preview).
    Status string
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.
    EndpointGroupId string
    The ID of the Basic Endpoint Group.
    EndpointId string
    The ID of the Basic Endpoint.
    EndpointType string
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    Ids []string
    A list of Global Accelerator Basic Endpoints IDs.
    Name string
    The name of the Basic Endpoint.
    NameRegex string
    A regex string to filter results by Global Accelerator Basic Endpoints name.
    OutputFile string
    File name where to save data source results (after running pulumi preview).
    Status string
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.
    endpointGroupId String
    The ID of the Basic Endpoint Group.
    endpointId String
    The ID of the Basic Endpoint.
    endpointType String
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    ids List<String>
    A list of Global Accelerator Basic Endpoints IDs.
    name String
    The name of the Basic Endpoint.
    nameRegex String
    A regex string to filter results by Global Accelerator Basic Endpoints name.
    outputFile String
    File name where to save data source results (after running pulumi preview).
    status String
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.
    endpointGroupId string
    The ID of the Basic Endpoint Group.
    endpointId string
    The ID of the Basic Endpoint.
    endpointType string
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    ids string[]
    A list of Global Accelerator Basic Endpoints IDs.
    name string
    The name of the Basic Endpoint.
    nameRegex string
    A regex string to filter results by Global Accelerator Basic Endpoints name.
    outputFile string
    File name where to save data source results (after running pulumi preview).
    status string
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.
    endpoint_group_id str
    The ID of the Basic Endpoint Group.
    endpoint_id str
    The ID of the Basic Endpoint.
    endpoint_type str
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    ids Sequence[str]
    A list of Global Accelerator Basic Endpoints IDs.
    name str
    The name of the Basic Endpoint.
    name_regex str
    A regex string to filter results by Global Accelerator Basic Endpoints name.
    output_file str
    File name where to save data source results (after running pulumi preview).
    status str
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.
    endpointGroupId String
    The ID of the Basic Endpoint Group.
    endpointId String
    The ID of the Basic Endpoint.
    endpointType String
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    ids List<String>
    A list of Global Accelerator Basic Endpoints IDs.
    name String
    The name of the Basic Endpoint.
    nameRegex String
    A regex string to filter results by Global Accelerator Basic Endpoints name.
    outputFile String
    File name where to save data source results (after running pulumi preview).
    status String
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.

    getBasicEndpoints Result

    The following output properties are available:

    EndpointGroupId string
    The ID of the Basic Endpoint Group.
    Endpoints List<Pulumi.AliCloud.Ga.Outputs.GetBasicEndpointsEndpoint>
    A list of Global Accelerator Basic Endpoints. Each element contains the following attributes:
    Id string
    The provider-assigned unique ID for this managed resource.
    Ids List<string>
    Names List<string>
    A list of Global Accelerator Basic Endpoint names.
    EndpointId string
    The ID of the Basic Endpoint.
    EndpointType string
    The type of the Basic Endpoint.
    Name string
    NameRegex string
    OutputFile string
    Status string
    The status of the Basic Endpoint.
    EndpointGroupId string
    The ID of the Basic Endpoint Group.
    Endpoints []GetBasicEndpointsEndpoint
    A list of Global Accelerator Basic Endpoints. Each element contains the following attributes:
    Id string
    The provider-assigned unique ID for this managed resource.
    Ids []string
    Names []string
    A list of Global Accelerator Basic Endpoint names.
    EndpointId string
    The ID of the Basic Endpoint.
    EndpointType string
    The type of the Basic Endpoint.
    Name string
    NameRegex string
    OutputFile string
    Status string
    The status of the Basic Endpoint.
    endpointGroupId String
    The ID of the Basic Endpoint Group.
    endpoints List<GetBasicEndpointsEndpoint>
    A list of Global Accelerator Basic Endpoints. Each element contains the following attributes:
    id String
    The provider-assigned unique ID for this managed resource.
    ids List<String>
    names List<String>
    A list of Global Accelerator Basic Endpoint names.
    endpointId String
    The ID of the Basic Endpoint.
    endpointType String
    The type of the Basic Endpoint.
    name String
    nameRegex String
    outputFile String
    status String
    The status of the Basic Endpoint.
    endpointGroupId string
    The ID of the Basic Endpoint Group.
    endpoints GetBasicEndpointsEndpoint[]
    A list of Global Accelerator Basic Endpoints. Each element contains the following attributes:
    id string
    The provider-assigned unique ID for this managed resource.
    ids string[]
    names string[]
    A list of Global Accelerator Basic Endpoint names.
    endpointId string
    The ID of the Basic Endpoint.
    endpointType string
    The type of the Basic Endpoint.
    name string
    nameRegex string
    outputFile string
    status string
    The status of the Basic Endpoint.
    endpoint_group_id str
    The ID of the Basic Endpoint Group.
    endpoints Sequence[GetBasicEndpointsEndpoint]
    A list of Global Accelerator Basic Endpoints. Each element contains the following attributes:
    id str
    The provider-assigned unique ID for this managed resource.
    ids Sequence[str]
    names Sequence[str]
    A list of Global Accelerator Basic Endpoint names.
    endpoint_id str
    The ID of the Basic Endpoint.
    endpoint_type str
    The type of the Basic Endpoint.
    name str
    name_regex str
    output_file str
    status str
    The status of the Basic Endpoint.
    endpointGroupId String
    The ID of the Basic Endpoint Group.
    endpoints List<Property Map>
    A list of Global Accelerator Basic Endpoints. Each element contains the following attributes:
    id String
    The provider-assigned unique ID for this managed resource.
    ids List<String>
    names List<String>
    A list of Global Accelerator Basic Endpoint names.
    endpointId String
    The ID of the Basic Endpoint.
    endpointType String
    The type of the Basic Endpoint.
    name String
    nameRegex String
    outputFile String
    status String
    The status of the Basic Endpoint.

    Supporting Types

    GetBasicEndpointsEndpoint

    AcceleratorId string
    The ID of the Global Accelerator Basic Accelerator instance.
    BasicEndpointName string
    The name of the Basic Endpoint.
    EndpointAddress string
    The address of the Basic Endpoint.
    EndpointGroupId string
    The ID of the Basic Endpoint Group.
    EndpointId string
    The ID of the Basic Endpoint.
    EndpointSubAddress string
    The sub address of the Basic Endpoint.
    EndpointSubAddressType string
    The sub address type of the Basic Endpoint.
    EndpointType string
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    EndpointZoneId string
    The zone id of the Basic Endpoint.
    Id string
    The id of the Global Accelerator Basic Endpoint. It formats as <endpoint_group_id>:<endpoint_id>.
    Status string
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.
    AcceleratorId string
    The ID of the Global Accelerator Basic Accelerator instance.
    BasicEndpointName string
    The name of the Basic Endpoint.
    EndpointAddress string
    The address of the Basic Endpoint.
    EndpointGroupId string
    The ID of the Basic Endpoint Group.
    EndpointId string
    The ID of the Basic Endpoint.
    EndpointSubAddress string
    The sub address of the Basic Endpoint.
    EndpointSubAddressType string
    The sub address type of the Basic Endpoint.
    EndpointType string
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    EndpointZoneId string
    The zone id of the Basic Endpoint.
    Id string
    The id of the Global Accelerator Basic Endpoint. It formats as <endpoint_group_id>:<endpoint_id>.
    Status string
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.
    acceleratorId String
    The ID of the Global Accelerator Basic Accelerator instance.
    basicEndpointName String
    The name of the Basic Endpoint.
    endpointAddress String
    The address of the Basic Endpoint.
    endpointGroupId String
    The ID of the Basic Endpoint Group.
    endpointId String
    The ID of the Basic Endpoint.
    endpointSubAddress String
    The sub address of the Basic Endpoint.
    endpointSubAddressType String
    The sub address type of the Basic Endpoint.
    endpointType String
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    endpointZoneId String
    The zone id of the Basic Endpoint.
    id String
    The id of the Global Accelerator Basic Endpoint. It formats as <endpoint_group_id>:<endpoint_id>.
    status String
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.
    acceleratorId string
    The ID of the Global Accelerator Basic Accelerator instance.
    basicEndpointName string
    The name of the Basic Endpoint.
    endpointAddress string
    The address of the Basic Endpoint.
    endpointGroupId string
    The ID of the Basic Endpoint Group.
    endpointId string
    The ID of the Basic Endpoint.
    endpointSubAddress string
    The sub address of the Basic Endpoint.
    endpointSubAddressType string
    The sub address type of the Basic Endpoint.
    endpointType string
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    endpointZoneId string
    The zone id of the Basic Endpoint.
    id string
    The id of the Global Accelerator Basic Endpoint. It formats as <endpoint_group_id>:<endpoint_id>.
    status string
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.
    accelerator_id str
    The ID of the Global Accelerator Basic Accelerator instance.
    basic_endpoint_name str
    The name of the Basic Endpoint.
    endpoint_address str
    The address of the Basic Endpoint.
    endpoint_group_id str
    The ID of the Basic Endpoint Group.
    endpoint_id str
    The ID of the Basic Endpoint.
    endpoint_sub_address str
    The sub address of the Basic Endpoint.
    endpoint_sub_address_type str
    The sub address type of the Basic Endpoint.
    endpoint_type str
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    endpoint_zone_id str
    The zone id of the Basic Endpoint.
    id str
    The id of the Global Accelerator Basic Endpoint. It formats as <endpoint_group_id>:<endpoint_id>.
    status str
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.
    acceleratorId String
    The ID of the Global Accelerator Basic Accelerator instance.
    basicEndpointName String
    The name of the Basic Endpoint.
    endpointAddress String
    The address of the Basic Endpoint.
    endpointGroupId String
    The ID of the Basic Endpoint Group.
    endpointId String
    The ID of the Basic Endpoint.
    endpointSubAddress String
    The sub address of the Basic Endpoint.
    endpointSubAddressType String
    The sub address type of the Basic Endpoint.
    endpointType String
    The type of the Basic Endpoint. Valid values: ENI, SLB, ECS and NLB.
    endpointZoneId String
    The zone id of the Basic Endpoint.
    id String
    The id of the Global Accelerator Basic Endpoint. It formats as <endpoint_group_id>:<endpoint_id>.
    status String
    The status of the Global Accelerator Basic Endpoint. Valid Value: init, active, updating, binding, unbinding, deleting, bound.

    Package Details

    Repository
    Alibaba Cloud pulumi/pulumi-alicloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the alicloud Terraform Provider.
    alicloud logo
    Alibaba Cloud v3.88.0 published on Saturday, Nov 1, 2025 by Pulumi
    pulumi/pulumi-alicloud
      Meet Neo: Your AI Platform Teammate