1. Packages
  2. AWS
  3. API Docs
  4. vpc
  5. getEndpointAssociations
AWS v7.2.0 published on Thursday, Jul 31, 2025 by Pulumi

aws.vpc.getEndpointAssociations

Explore with Pulumi AI

aws logo
AWS v7.2.0 published on Thursday, Jul 31, 2025 by Pulumi

    Data source for managing an AWS EC2 (Elastic Compute Cloud) Vpc Endpoint Associations.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = aws.vpc.getEndpointAssociations({
        vpcEndpointId: exampleAwsVpcEndpoint.id,
    });
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.vpc.get_endpoint_associations(vpc_endpoint_id=example_aws_vpc_endpoint["id"])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/vpc"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := vpc.GetEndpointAssociations(ctx, &vpc.GetEndpointAssociationsArgs{
    			VpcEndpointId: exampleAwsVpcEndpoint.Id,
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Aws.Vpc.GetEndpointAssociations.Invoke(new()
        {
            VpcEndpointId = exampleAwsVpcEndpoint.Id,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.vpc.VpcFunctions;
    import com.pulumi.aws.vpc.inputs.GetEndpointAssociationsArgs;
    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 = VpcFunctions.getEndpointAssociations(GetEndpointAssociationsArgs.builder()
                .vpcEndpointId(exampleAwsVpcEndpoint.id())
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: aws:vpc:getEndpointAssociations
          arguments:
            vpcEndpointId: ${exampleAwsVpcEndpoint.id}
    

    Using getEndpointAssociations

    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 getEndpointAssociations(args: GetEndpointAssociationsArgs, opts?: InvokeOptions): Promise<GetEndpointAssociationsResult>
    function getEndpointAssociationsOutput(args: GetEndpointAssociationsOutputArgs, opts?: InvokeOptions): Output<GetEndpointAssociationsResult>
    def get_endpoint_associations(region: Optional[str] = None,
                                  vpc_endpoint_id: Optional[str] = None,
                                  opts: Optional[InvokeOptions] = None) -> GetEndpointAssociationsResult
    def get_endpoint_associations_output(region: Optional[pulumi.Input[str]] = None,
                                  vpc_endpoint_id: Optional[pulumi.Input[str]] = None,
                                  opts: Optional[InvokeOptions] = None) -> Output[GetEndpointAssociationsResult]
    func GetEndpointAssociations(ctx *Context, args *GetEndpointAssociationsArgs, opts ...InvokeOption) (*GetEndpointAssociationsResult, error)
    func GetEndpointAssociationsOutput(ctx *Context, args *GetEndpointAssociationsOutputArgs, opts ...InvokeOption) GetEndpointAssociationsResultOutput

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

    public static class GetEndpointAssociations 
    {
        public static Task<GetEndpointAssociationsResult> InvokeAsync(GetEndpointAssociationsArgs args, InvokeOptions? opts = null)
        public static Output<GetEndpointAssociationsResult> Invoke(GetEndpointAssociationsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetEndpointAssociationsResult> getEndpointAssociations(GetEndpointAssociationsArgs args, InvokeOptions options)
    public static Output<GetEndpointAssociationsResult> getEndpointAssociations(GetEndpointAssociationsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: aws:vpc/getEndpointAssociations:getEndpointAssociations
      arguments:
        # arguments dictionary

    The following arguments are supported:

    VpcEndpointId string
    ID of the specific VPC Endpoint to retrieve.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    VpcEndpointId string
    ID of the specific VPC Endpoint to retrieve.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    vpcEndpointId String
    ID of the specific VPC Endpoint to retrieve.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    vpcEndpointId string
    ID of the specific VPC Endpoint to retrieve.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    vpc_endpoint_id str
    ID of the specific VPC Endpoint to retrieve.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    vpcEndpointId String
    ID of the specific VPC Endpoint to retrieve.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.

    getEndpointAssociations Result

    The following output properties are available:

    Associations List<GetEndpointAssociationsAssociation>
    Associations for the VPC Endpoint. Association blocks are documented below.
    Id string
    The provider-assigned unique ID for this managed resource.
    Region string
    VpcEndpointId string
    Associations []GetEndpointAssociationsAssociation
    Associations for the VPC Endpoint. Association blocks are documented below.
    Id string
    The provider-assigned unique ID for this managed resource.
    Region string
    VpcEndpointId string
    associations List<GetEndpointAssociationsAssociation>
    Associations for the VPC Endpoint. Association blocks are documented below.
    id String
    The provider-assigned unique ID for this managed resource.
    region String
    vpcEndpointId String
    associations GetEndpointAssociationsAssociation[]
    Associations for the VPC Endpoint. Association blocks are documented below.
    id string
    The provider-assigned unique ID for this managed resource.
    region string
    vpcEndpointId string
    associations Sequence[GetEndpointAssociationsAssociation]
    Associations for the VPC Endpoint. Association blocks are documented below.
    id str
    The provider-assigned unique ID for this managed resource.
    region str
    vpc_endpoint_id str
    associations List<Property Map>
    Associations for the VPC Endpoint. Association blocks are documented below.
    id String
    The provider-assigned unique ID for this managed resource.
    region String
    vpcEndpointId String

    Supporting Types

    GetEndpointAssociationsAssociation

    AssociatedResourceAccessibility string
    Accessibility of the resource.
    AssociatedResourceArn string
    ARN of the resource for this association.
    DnsEntries List<GetEndpointAssociationsAssociationDnsEntry>
    DNS entries for the Association. DNS entry blocks are documented below.
    Id string
    PrivateDnsEntries List<GetEndpointAssociationsAssociationPrivateDnsEntry>
    DNS entries for the Association. Private DNS entry blocks are documented below.
    ResourceConfigurationGroupArn string
    ARN of the Resource Group if the Resource is a member of a group.
    ServiceNetworkArn string
    Service Network ARN. Applicable for endpoints of type ServiceNetwork.
    ServiceNetworkName string
    Service Network Name. Applicable for endpoints of type ServiceNetwork.
    Tags Dictionary<string, string>
    Tags of the association.
    AssociatedResourceAccessibility string
    Accessibility of the resource.
    AssociatedResourceArn string
    ARN of the resource for this association.
    DnsEntries []GetEndpointAssociationsAssociationDnsEntry
    DNS entries for the Association. DNS entry blocks are documented below.
    Id string
    PrivateDnsEntries []GetEndpointAssociationsAssociationPrivateDnsEntry
    DNS entries for the Association. Private DNS entry blocks are documented below.
    ResourceConfigurationGroupArn string
    ARN of the Resource Group if the Resource is a member of a group.
    ServiceNetworkArn string
    Service Network ARN. Applicable for endpoints of type ServiceNetwork.
    ServiceNetworkName string
    Service Network Name. Applicable for endpoints of type ServiceNetwork.
    Tags map[string]string
    Tags of the association.
    associatedResourceAccessibility String
    Accessibility of the resource.
    associatedResourceArn String
    ARN of the resource for this association.
    dnsEntries List<GetEndpointAssociationsAssociationDnsEntry>
    DNS entries for the Association. DNS entry blocks are documented below.
    id String
    privateDnsEntries List<GetEndpointAssociationsAssociationPrivateDnsEntry>
    DNS entries for the Association. Private DNS entry blocks are documented below.
    resourceConfigurationGroupArn String
    ARN of the Resource Group if the Resource is a member of a group.
    serviceNetworkArn String
    Service Network ARN. Applicable for endpoints of type ServiceNetwork.
    serviceNetworkName String
    Service Network Name. Applicable for endpoints of type ServiceNetwork.
    tags Map<String,String>
    Tags of the association.
    associatedResourceAccessibility string
    Accessibility of the resource.
    associatedResourceArn string
    ARN of the resource for this association.
    dnsEntries GetEndpointAssociationsAssociationDnsEntry[]
    DNS entries for the Association. DNS entry blocks are documented below.
    id string
    privateDnsEntries GetEndpointAssociationsAssociationPrivateDnsEntry[]
    DNS entries for the Association. Private DNS entry blocks are documented below.
    resourceConfigurationGroupArn string
    ARN of the Resource Group if the Resource is a member of a group.
    serviceNetworkArn string
    Service Network ARN. Applicable for endpoints of type ServiceNetwork.
    serviceNetworkName string
    Service Network Name. Applicable for endpoints of type ServiceNetwork.
    tags {[key: string]: string}
    Tags of the association.
    associated_resource_accessibility str
    Accessibility of the resource.
    associated_resource_arn str
    ARN of the resource for this association.
    dns_entries Sequence[GetEndpointAssociationsAssociationDnsEntry]
    DNS entries for the Association. DNS entry blocks are documented below.
    id str
    private_dns_entries Sequence[GetEndpointAssociationsAssociationPrivateDnsEntry]
    DNS entries for the Association. Private DNS entry blocks are documented below.
    resource_configuration_group_arn str
    ARN of the Resource Group if the Resource is a member of a group.
    service_network_arn str
    Service Network ARN. Applicable for endpoints of type ServiceNetwork.
    service_network_name str
    Service Network Name. Applicable for endpoints of type ServiceNetwork.
    tags Mapping[str, str]
    Tags of the association.
    associatedResourceAccessibility String
    Accessibility of the resource.
    associatedResourceArn String
    ARN of the resource for this association.
    dnsEntries List<Property Map>
    DNS entries for the Association. DNS entry blocks are documented below.
    id String
    privateDnsEntries List<Property Map>
    DNS entries for the Association. Private DNS entry blocks are documented below.
    resourceConfigurationGroupArn String
    ARN of the Resource Group if the Resource is a member of a group.
    serviceNetworkArn String
    Service Network ARN. Applicable for endpoints of type ServiceNetwork.
    serviceNetworkName String
    Service Network Name. Applicable for endpoints of type ServiceNetwork.
    tags Map<String>
    Tags of the association.

    GetEndpointAssociationsAssociationDnsEntry

    DnsName string
    DNS name.
    HostedZoneId string
    ID of the private hosted zone.
    DnsName string
    DNS name.
    HostedZoneId string
    ID of the private hosted zone.
    dnsName String
    DNS name.
    hostedZoneId String
    ID of the private hosted zone.
    dnsName string
    DNS name.
    hostedZoneId string
    ID of the private hosted zone.
    dns_name str
    DNS name.
    hosted_zone_id str
    ID of the private hosted zone.
    dnsName String
    DNS name.
    hostedZoneId String
    ID of the private hosted zone.

    GetEndpointAssociationsAssociationPrivateDnsEntry

    DnsName string
    DNS name.
    HostedZoneId string
    ID of the private hosted zone.
    DnsName string
    DNS name.
    HostedZoneId string
    ID of the private hosted zone.
    dnsName String
    DNS name.
    hostedZoneId String
    ID of the private hosted zone.
    dnsName string
    DNS name.
    hostedZoneId string
    ID of the private hosted zone.
    dns_name str
    DNS name.
    hosted_zone_id str
    ID of the private hosted zone.
    dnsName String
    DNS name.
    hostedZoneId String
    ID of the private hosted zone.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    AWS v7.2.0 published on Thursday, Jul 31, 2025 by Pulumi