AWS Classic v5.32.0, Mar 17 23

aws.ec2transitgateway.getDirectConnectGatewayAttachment

Get information on an EC2 Transit Gateway’s attachment to a Direct Connect Gateway.

Example Usage

By Transit Gateway and Direct Connect Gateway Identifiers

using System.Collections.Generic;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = Aws.Ec2TransitGateway.GetDirectConnectGatewayAttachment.Invoke(new()
    {
        TransitGatewayId = aws_ec2_transit_gateway.Example.Id,
        DxGatewayId = aws_dx_gateway.Example.Id,
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/ec2transitgateway"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ec2transitgateway.GetDirectConnectGatewayAttachment(ctx, &ec2transitgateway.GetDirectConnectGatewayAttachmentArgs{
			TransitGatewayId: pulumi.StringRef(aws_ec2_transit_gateway.Example.Id),
			DxGatewayId:      pulumi.StringRef(aws_dx_gateway.Example.Id),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2transitgateway.Ec2transitgatewayFunctions;
import com.pulumi.aws.ec2transitgateway.inputs.GetDirectConnectGatewayAttachmentArgs;
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 = Ec2transitgatewayFunctions.getDirectConnectGatewayAttachment(GetDirectConnectGatewayAttachmentArgs.builder()
            .transitGatewayId(aws_ec2_transit_gateway.example().id())
            .dxGatewayId(aws_dx_gateway.example().id())
            .build());

    }
}

import pulumi
import pulumi_aws as aws

example = aws.ec2transitgateway.get_direct_connect_gateway_attachment(transit_gateway_id=aws_ec2_transit_gateway["example"]["id"],
    dx_gateway_id=aws_dx_gateway["example"]["id"])

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

const example = aws.ec2transitgateway.getDirectConnectGatewayAttachment({
    transitGatewayId: aws_ec2_transit_gateway.example.id,
    dxGatewayId: aws_dx_gateway.example.id,
});

variables:
  example:
    fn::invoke:
      Function: aws:ec2transitgateway:getDirectConnectGatewayAttachment
      Arguments:
        transitGatewayId: ${aws_ec2_transit_gateway.example.id}
        dxGatewayId: ${aws_dx_gateway.example.id}

Using getDirectConnectGatewayAttachment

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 getDirectConnectGatewayAttachment(args: GetDirectConnectGatewayAttachmentArgs, opts?: InvokeOptions): Promise<GetDirectConnectGatewayAttachmentResult>
function getDirectConnectGatewayAttachmentOutput(args: GetDirectConnectGatewayAttachmentOutputArgs, opts?: InvokeOptions): Output<GetDirectConnectGatewayAttachmentResult>

def get_direct_connect_gateway_attachment(dx_gateway_id: Optional[str] = None,
                                          filters: Optional[Sequence[GetDirectConnectGatewayAttachmentFilter]] = None,
                                          tags: Optional[Mapping[str, str]] = None,
                                          transit_gateway_id: Optional[str] = None,
                                          opts: Optional[InvokeOptions] = None) -> GetDirectConnectGatewayAttachmentResult
def get_direct_connect_gateway_attachment_output(dx_gateway_id: Optional[pulumi.Input[str]] = None,
                                          filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetDirectConnectGatewayAttachmentFilterArgs]]]] = None,
                                          tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                                          transit_gateway_id: Optional[pulumi.Input[str]] = None,
                                          opts: Optional[InvokeOptions] = None) -> Output[GetDirectConnectGatewayAttachmentResult]

func GetDirectConnectGatewayAttachment(ctx *Context, args *GetDirectConnectGatewayAttachmentArgs, opts ...InvokeOption) (*GetDirectConnectGatewayAttachmentResult, error)
func GetDirectConnectGatewayAttachmentOutput(ctx *Context, args *GetDirectConnectGatewayAttachmentOutputArgs, opts ...InvokeOption) GetDirectConnectGatewayAttachmentResultOutput

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

public static class GetDirectConnectGatewayAttachment 
{
    public static Task<GetDirectConnectGatewayAttachmentResult> InvokeAsync(GetDirectConnectGatewayAttachmentArgs args, InvokeOptions? opts = null)
    public static Output<GetDirectConnectGatewayAttachmentResult> Invoke(GetDirectConnectGatewayAttachmentInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetDirectConnectGatewayAttachmentResult> getDirectConnectGatewayAttachment(GetDirectConnectGatewayAttachmentArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet

fn::invoke:
  function: aws:ec2transitgateway/getDirectConnectGatewayAttachment:getDirectConnectGatewayAttachment
  arguments:
    # arguments dictionary

The following arguments are supported:

DxGatewayId string: Identifier of the Direct Connect Gateway.
Filters List<GetDirectConnectGatewayAttachmentFilter>: Configuration block(s) for filtering. Detailed below.
Tags Dictionary<string, string>: Map of tags, each pair of which must exactly match a pair on the desired Transit Gateway Direct Connect Gateway Attachment.
TransitGatewayId string: Identifier of the EC2 Transit Gateway.

DxGatewayId string: Identifier of the Direct Connect Gateway.
Filters []GetDirectConnectGatewayAttachmentFilter: Configuration block(s) for filtering. Detailed below.
Tags map[string]string: Map of tags, each pair of which must exactly match a pair on the desired Transit Gateway Direct Connect Gateway Attachment.
TransitGatewayId string: Identifier of the EC2 Transit Gateway.

dxGatewayId String: Identifier of the Direct Connect Gateway.
filters List<GetDirectConnectGatewayAttachmentFilter>: Configuration block(s) for filtering. Detailed below.
tags Map<String,String>: Map of tags, each pair of which must exactly match a pair on the desired Transit Gateway Direct Connect Gateway Attachment.
transitGatewayId String: Identifier of the EC2 Transit Gateway.

dxGatewayId string: Identifier of the Direct Connect Gateway.
filters GetDirectConnectGatewayAttachmentFilter[]: Configuration block(s) for filtering. Detailed below.
tags {[key: string]: string}: Map of tags, each pair of which must exactly match a pair on the desired Transit Gateway Direct Connect Gateway Attachment.
transitGatewayId string: Identifier of the EC2 Transit Gateway.

dx_gateway_id str: Identifier of the Direct Connect Gateway.
filters Sequence[GetDirectConnectGatewayAttachmentFilter]: Configuration block(s) for filtering. Detailed below.
tags Mapping[str, str]: Map of tags, each pair of which must exactly match a pair on the desired Transit Gateway Direct Connect Gateway Attachment.
transit_gateway_id str: Identifier of the EC2 Transit Gateway.

dxGatewayId String: Identifier of the Direct Connect Gateway.
filters List<Property Map>: Configuration block(s) for filtering. Detailed below.
tags Map<String>: Map of tags, each pair of which must exactly match a pair on the desired Transit Gateway Direct Connect Gateway Attachment.
transitGatewayId String: Identifier of the EC2 Transit Gateway.

getDirectConnectGatewayAttachment Result

The following output properties are available:

Id string: The provider-assigned unique ID for this managed resource.
Tags Dictionary<string, string>: Key-value tags for the EC2 Transit Gateway Attachment
DxGatewayId string
Filters List<GetDirectConnectGatewayAttachmentFilter>
TransitGatewayId string

Id string: The provider-assigned unique ID for this managed resource.
Tags map[string]string: Key-value tags for the EC2 Transit Gateway Attachment
DxGatewayId string
Filters []GetDirectConnectGatewayAttachmentFilter
TransitGatewayId string

id String: The provider-assigned unique ID for this managed resource.
tags Map<String,String>: Key-value tags for the EC2 Transit Gateway Attachment
dxGatewayId String
filters List<GetDirectConnectGatewayAttachmentFilter>
transitGatewayId String

id string: The provider-assigned unique ID for this managed resource.
tags {[key: string]: string}: Key-value tags for the EC2 Transit Gateway Attachment
dxGatewayId string
filters GetDirectConnectGatewayAttachmentFilter[]
transitGatewayId string

id str: The provider-assigned unique ID for this managed resource.
tags Mapping[str, str]: Key-value tags for the EC2 Transit Gateway Attachment
dx_gateway_id str
filters Sequence[GetDirectConnectGatewayAttachmentFilter]
transit_gateway_id str

id String: The provider-assigned unique ID for this managed resource.
tags Map<String>: Key-value tags for the EC2 Transit Gateway Attachment
dxGatewayId String
filters List<Property Map>
transitGatewayId String

Supporting Types

GetDirectConnectGatewayAttachmentFilter

Name string: Name of the filter field. Valid values can be found in the EC2 DescribeTransitGatewayAttachments API Reference.
Values List<string>: Set of values that are accepted for the given filter field. Results will be selected if any given value matches.

Name string: Name of the filter field. Valid values can be found in the EC2 DescribeTransitGatewayAttachments API Reference.
Values []string: Set of values that are accepted for the given filter field. Results will be selected if any given value matches.

name String: Name of the filter field. Valid values can be found in the EC2 DescribeTransitGatewayAttachments API Reference.
values List<String>: Set of values that are accepted for the given filter field. Results will be selected if any given value matches.

name string: Name of the filter field. Valid values can be found in the EC2 DescribeTransitGatewayAttachments API Reference.
values string[]: Set of values that are accepted for the given filter field. Results will be selected if any given value matches.

name str: Name of the filter field. Valid values can be found in the EC2 DescribeTransitGatewayAttachments API Reference.
values Sequence[str]: Set of values that are accepted for the given filter field. Results will be selected if any given value matches.

name String: Name of the filter field. Valid values can be found in the EC2 DescribeTransitGatewayAttachments API Reference.
values List<String>: Set of values that are accepted for the given filter field. Results will be selected if any given value matches.

Package Details

Repository: AWS Classic pulumi/pulumi-aws
License: Apache-2.0
Notes: This Pulumi package is based on the aws Terraform Provider.