1. Packages
  2. AWS
  3. API Docs
  4. appmesh
  5. getVirtualGateway
AWS v6.78.0 published on Thursday, Apr 24, 2025 by Pulumi

aws.appmesh.getVirtualGateway

Explore with Pulumi AI

Data source for managing an AWS App Mesh Virtual Gateway.

Example Usage

Basic Usage

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

const example = aws.appmesh.getVirtualGateway({
    meshName: "mesh-gateway",
    name: "example-mesh",
});
Copy
import pulumi
import pulumi_aws as aws

example = aws.appmesh.get_virtual_gateway(mesh_name="mesh-gateway",
    name="example-mesh")
Copy
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/appmesh"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := appmesh.LookupVirtualGateway(ctx, &appmesh.LookupVirtualGatewayArgs{
			MeshName: "mesh-gateway",
			Name:     "example-mesh",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = Aws.AppMesh.GetVirtualGateway.Invoke(new()
    {
        MeshName = "mesh-gateway",
        Name = "example-mesh",
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.appmesh.AppmeshFunctions;
import com.pulumi.aws.appmesh.inputs.GetVirtualGatewayArgs;
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 = AppmeshFunctions.getVirtualGateway(GetVirtualGatewayArgs.builder()
            .meshName("mesh-gateway")
            .name("example-mesh")
            .build());

    }
}
Copy
variables:
  example:
    fn::invoke:
      function: aws:appmesh:getVirtualGateway
      arguments:
        meshName: mesh-gateway
        name: example-mesh
Copy
Coming soon!
Coming soon!
Coming soon!
Coming soon!
Coming soon!
variables:
  current:
    fn::invoke:
      function: aws:getCallerIdentity
      arguments: {}
  test:
    fn::invoke:
      function: aws:appmesh:getVirtualGateway
      arguments:
        name: example.mesh.local
        meshName: example-mesh
        meshOwner: ${current.accountId}
Copy

Using getVirtualGateway

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 getVirtualGateway(args: GetVirtualGatewayArgs, opts?: InvokeOptions): Promise<GetVirtualGatewayResult>
function getVirtualGatewayOutput(args: GetVirtualGatewayOutputArgs, opts?: InvokeOptions): Output<GetVirtualGatewayResult>
Copy
def get_virtual_gateway(mesh_name: Optional[str] = None,
                        name: Optional[str] = None,
                        tags: Optional[Mapping[str, str]] = None,
                        opts: Optional[InvokeOptions] = None) -> GetVirtualGatewayResult
def get_virtual_gateway_output(mesh_name: Optional[pulumi.Input[str]] = None,
                        name: Optional[pulumi.Input[str]] = None,
                        tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                        opts: Optional[InvokeOptions] = None) -> Output[GetVirtualGatewayResult]
Copy
func LookupVirtualGateway(ctx *Context, args *LookupVirtualGatewayArgs, opts ...InvokeOption) (*LookupVirtualGatewayResult, error)
func LookupVirtualGatewayOutput(ctx *Context, args *LookupVirtualGatewayOutputArgs, opts ...InvokeOption) LookupVirtualGatewayResultOutput
Copy

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

public static class GetVirtualGateway 
{
    public static Task<GetVirtualGatewayResult> InvokeAsync(GetVirtualGatewayArgs args, InvokeOptions? opts = null)
    public static Output<GetVirtualGatewayResult> Invoke(GetVirtualGatewayInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetVirtualGatewayResult> getVirtualGateway(GetVirtualGatewayArgs args, InvokeOptions options)
public static Output<GetVirtualGatewayResult> getVirtualGateway(GetVirtualGatewayArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: aws:appmesh/getVirtualGateway:getVirtualGateway
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

MeshName This property is required. string
Name of the service mesh in which the virtual gateway exists.
Name This property is required. string
Name of the virtual gateway.
Tags Dictionary<string, string>
Map of tags.
MeshName This property is required. string
Name of the service mesh in which the virtual gateway exists.
Name This property is required. string
Name of the virtual gateway.
Tags map[string]string
Map of tags.
meshName This property is required. String
Name of the service mesh in which the virtual gateway exists.
name This property is required. String
Name of the virtual gateway.
tags Map<String,String>
Map of tags.
meshName This property is required. string
Name of the service mesh in which the virtual gateway exists.
name This property is required. string
Name of the virtual gateway.
tags {[key: string]: string}
Map of tags.
mesh_name This property is required. str
Name of the service mesh in which the virtual gateway exists.
name This property is required. str
Name of the virtual gateway.
tags Mapping[str, str]
Map of tags.
meshName This property is required. String
Name of the service mesh in which the virtual gateway exists.
name This property is required. String
Name of the virtual gateway.
tags Map<String>
Map of tags.

getVirtualGateway Result

The following output properties are available:

Arn string
ARN of the virtual gateway.
CreatedDate string
Creation date of the virtual gateway.
Id string
The provider-assigned unique ID for this managed resource.
LastUpdatedDate string
Last update date of the virtual gateway.
MeshName string
MeshOwner string
Name string
ResourceOwner string
Resource owner's AWS account ID.
Specs List<GetVirtualGatewaySpec>
Virtual gateway specification. See the aws.appmesh.VirtualGateway resource for details.
Tags Dictionary<string, string>
Map of tags.
Arn string
ARN of the virtual gateway.
CreatedDate string
Creation date of the virtual gateway.
Id string
The provider-assigned unique ID for this managed resource.
LastUpdatedDate string
Last update date of the virtual gateway.
MeshName string
MeshOwner string
Name string
ResourceOwner string
Resource owner's AWS account ID.
Specs []GetVirtualGatewaySpec
Virtual gateway specification. See the aws.appmesh.VirtualGateway resource for details.
Tags map[string]string
Map of tags.
arn String
ARN of the virtual gateway.
createdDate String
Creation date of the virtual gateway.
id String
The provider-assigned unique ID for this managed resource.
lastUpdatedDate String
Last update date of the virtual gateway.
meshName String
meshOwner String
name String
resourceOwner String
Resource owner's AWS account ID.
specs List<GetVirtualGatewaySpec>
Virtual gateway specification. See the aws.appmesh.VirtualGateway resource for details.
tags Map<String,String>
Map of tags.
arn string
ARN of the virtual gateway.
createdDate string
Creation date of the virtual gateway.
id string
The provider-assigned unique ID for this managed resource.
lastUpdatedDate string
Last update date of the virtual gateway.
meshName string
meshOwner string
name string
resourceOwner string
Resource owner's AWS account ID.
specs GetVirtualGatewaySpec[]
Virtual gateway specification. See the aws.appmesh.VirtualGateway resource for details.
tags {[key: string]: string}
Map of tags.
arn str
ARN of the virtual gateway.
created_date str
Creation date of the virtual gateway.
id str
The provider-assigned unique ID for this managed resource.
last_updated_date str
Last update date of the virtual gateway.
mesh_name str
mesh_owner str
name str
resource_owner str
Resource owner's AWS account ID.
specs Sequence[GetVirtualGatewaySpec]
Virtual gateway specification. See the aws.appmesh.VirtualGateway resource for details.
tags Mapping[str, str]
Map of tags.
arn String
ARN of the virtual gateway.
createdDate String
Creation date of the virtual gateway.
id String
The provider-assigned unique ID for this managed resource.
lastUpdatedDate String
Last update date of the virtual gateway.
meshName String
meshOwner String
name String
resourceOwner String
Resource owner's AWS account ID.
specs List<Property Map>
Virtual gateway specification. See the aws.appmesh.VirtualGateway resource for details.
tags Map<String>
Map of tags.

Supporting Types

GetVirtualGatewaySpec

backendDefaults This property is required. List<Property Map>
listeners This property is required. List<Property Map>
loggings This property is required. List<Property Map>

GetVirtualGatewaySpecBackendDefault

clientPolicies This property is required. List<Property Map>

GetVirtualGatewaySpecBackendDefaultClientPolicy

tls This property is required. List<Property Map>

GetVirtualGatewaySpecBackendDefaultClientPolicyTl

Certificates This property is required. List<GetVirtualGatewaySpecBackendDefaultClientPolicyTlCertificate>
Enforce This property is required. bool
Ports This property is required. List<int>
Validations This property is required. List<GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidation>
Certificates This property is required. []GetVirtualGatewaySpecBackendDefaultClientPolicyTlCertificate
Enforce This property is required. bool
Ports This property is required. []int
Validations This property is required. []GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidation
certificates This property is required. List<GetVirtualGatewaySpecBackendDefaultClientPolicyTlCertificate>
enforce This property is required. Boolean
ports This property is required. List<Integer>
validations This property is required. List<GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidation>
certificates This property is required. GetVirtualGatewaySpecBackendDefaultClientPolicyTlCertificate[]
enforce This property is required. boolean
ports This property is required. number[]
validations This property is required. GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidation[]
certificates This property is required. Sequence[GetVirtualGatewaySpecBackendDefaultClientPolicyTlCertificate]
enforce This property is required. bool
ports This property is required. Sequence[int]
validations This property is required. Sequence[GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidation]
certificates This property is required. List<Property Map>
enforce This property is required. Boolean
ports This property is required. List<Number>
validations This property is required. List<Property Map>

GetVirtualGatewaySpecBackendDefaultClientPolicyTlCertificate

files This property is required. List<Property Map>
sds This property is required. List<Property Map>

GetVirtualGatewaySpecBackendDefaultClientPolicyTlCertificateFile

CertificateChain This property is required. string
PrivateKey This property is required. string
CertificateChain This property is required. string
PrivateKey This property is required. string
certificateChain This property is required. String
privateKey This property is required. String
certificateChain This property is required. string
privateKey This property is required. string
certificate_chain This property is required. str
private_key This property is required. str
certificateChain This property is required. String
privateKey This property is required. String

GetVirtualGatewaySpecBackendDefaultClientPolicyTlCertificateSd

SecretName This property is required. string
SecretName This property is required. string
secretName This property is required. String
secretName This property is required. string
secret_name This property is required. str
secretName This property is required. String

GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidation

subjectAlternativeNames This property is required. List<Property Map>
trusts This property is required. List<Property Map>

GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidationSubjectAlternativeName

matches This property is required. List<Property Map>

GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidationSubjectAlternativeNameMatch

Exacts This property is required. List<string>
Exacts This property is required. []string
exacts This property is required. List<String>
exacts This property is required. string[]
exacts This property is required. Sequence[str]
exacts This property is required. List<String>

GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidationTrust

acms This property is required. List<Property Map>
files This property is required. List<Property Map>
sds This property is required. List<Property Map>

GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidationTrustAcm

CertificateAuthorityArns This property is required. List<string>
CertificateAuthorityArns This property is required. []string
certificateAuthorityArns This property is required. List<String>
certificateAuthorityArns This property is required. string[]
certificate_authority_arns This property is required. Sequence[str]
certificateAuthorityArns This property is required. List<String>

GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidationTrustFile

CertificateChain This property is required. string
CertificateChain This property is required. string
certificateChain This property is required. String
certificateChain This property is required. string
certificate_chain This property is required. str
certificateChain This property is required. String

GetVirtualGatewaySpecBackendDefaultClientPolicyTlValidationTrustSd

SecretName This property is required. string
SecretName This property is required. string
secretName This property is required. String
secretName This property is required. string
secret_name This property is required. str
secretName This property is required. String

GetVirtualGatewaySpecListener

connectionPools This property is required. List<Property Map>
healthChecks This property is required. List<Property Map>
portMappings This property is required. List<Property Map>
tls This property is required. List<Property Map>

GetVirtualGatewaySpecListenerConnectionPool

grpcs This property is required. List<Property Map>
http2s This property is required. List<Property Map>
https This property is required. List<Property Map>

GetVirtualGatewaySpecListenerConnectionPoolGrpc

MaxRequests This property is required. int
MaxRequests This property is required. int
maxRequests This property is required. Integer
maxRequests This property is required. number
max_requests This property is required. int
maxRequests This property is required. Number

GetVirtualGatewaySpecListenerConnectionPoolHttp

MaxConnections This property is required. int
MaxPendingRequests This property is required. int
MaxConnections This property is required. int
MaxPendingRequests This property is required. int
maxConnections This property is required. Integer
maxPendingRequests This property is required. Integer
maxConnections This property is required. number
maxPendingRequests This property is required. number
max_connections This property is required. int
max_pending_requests This property is required. int
maxConnections This property is required. Number
maxPendingRequests This property is required. Number

GetVirtualGatewaySpecListenerConnectionPoolHttp2

MaxRequests This property is required. int
MaxRequests This property is required. int
maxRequests This property is required. Integer
maxRequests This property is required. number
max_requests This property is required. int
maxRequests This property is required. Number

GetVirtualGatewaySpecListenerHealthCheck

HealthyThreshold This property is required. int
IntervalMillis This property is required. int
Path This property is required. string
Port This property is required. int
Protocol This property is required. string
TimeoutMillis This property is required. int
UnhealthyThreshold This property is required. int
HealthyThreshold This property is required. int
IntervalMillis This property is required. int
Path This property is required. string
Port This property is required. int
Protocol This property is required. string
TimeoutMillis This property is required. int
UnhealthyThreshold This property is required. int
healthyThreshold This property is required. Integer
intervalMillis This property is required. Integer
path This property is required. String
port This property is required. Integer
protocol This property is required. String
timeoutMillis This property is required. Integer
unhealthyThreshold This property is required. Integer
healthyThreshold This property is required. number
intervalMillis This property is required. number
path This property is required. string
port This property is required. number
protocol This property is required. string
timeoutMillis This property is required. number
unhealthyThreshold This property is required. number
healthy_threshold This property is required. int
interval_millis This property is required. int
path This property is required. str
port This property is required. int
protocol This property is required. str
timeout_millis This property is required. int
unhealthy_threshold This property is required. int
healthyThreshold This property is required. Number
intervalMillis This property is required. Number
path This property is required. String
port This property is required. Number
protocol This property is required. String
timeoutMillis This property is required. Number
unhealthyThreshold This property is required. Number

GetVirtualGatewaySpecListenerPortMapping

Port This property is required. int
Protocol This property is required. string
Port This property is required. int
Protocol This property is required. string
port This property is required. Integer
protocol This property is required. String
port This property is required. number
protocol This property is required. string
port This property is required. int
protocol This property is required. str
port This property is required. Number
protocol This property is required. String

GetVirtualGatewaySpecListenerTl

Certificates This property is required. List<GetVirtualGatewaySpecListenerTlCertificate>
Mode This property is required. string
Validations This property is required. List<GetVirtualGatewaySpecListenerTlValidation>
Certificates This property is required. []GetVirtualGatewaySpecListenerTlCertificate
Mode This property is required. string
Validations This property is required. []GetVirtualGatewaySpecListenerTlValidation
certificates This property is required. List<GetVirtualGatewaySpecListenerTlCertificate>
mode This property is required. String
validations This property is required. List<GetVirtualGatewaySpecListenerTlValidation>
certificates This property is required. GetVirtualGatewaySpecListenerTlCertificate[]
mode This property is required. string
validations This property is required. GetVirtualGatewaySpecListenerTlValidation[]
certificates This property is required. Sequence[GetVirtualGatewaySpecListenerTlCertificate]
mode This property is required. str
validations This property is required. Sequence[GetVirtualGatewaySpecListenerTlValidation]
certificates This property is required. List<Property Map>
mode This property is required. String
validations This property is required. List<Property Map>

GetVirtualGatewaySpecListenerTlCertificate

acms This property is required. List<Property Map>
files This property is required. List<Property Map>
sds This property is required. List<Property Map>

GetVirtualGatewaySpecListenerTlCertificateAcm

CertificateArn This property is required. string
CertificateArn This property is required. string
certificateArn This property is required. String
certificateArn This property is required. string
certificate_arn This property is required. str
certificateArn This property is required. String

GetVirtualGatewaySpecListenerTlCertificateFile

CertificateChain This property is required. string
PrivateKey This property is required. string
CertificateChain This property is required. string
PrivateKey This property is required. string
certificateChain This property is required. String
privateKey This property is required. String
certificateChain This property is required. string
privateKey This property is required. string
certificate_chain This property is required. str
private_key This property is required. str
certificateChain This property is required. String
privateKey This property is required. String

GetVirtualGatewaySpecListenerTlCertificateSd

SecretName This property is required. string
SecretName This property is required. string
secretName This property is required. String
secretName This property is required. string
secret_name This property is required. str
secretName This property is required. String

GetVirtualGatewaySpecListenerTlValidation

subjectAlternativeNames This property is required. List<Property Map>
trusts This property is required. List<Property Map>

GetVirtualGatewaySpecListenerTlValidationSubjectAlternativeName

matches This property is required. List<Property Map>

GetVirtualGatewaySpecListenerTlValidationSubjectAlternativeNameMatch

Exacts This property is required. List<string>
Exacts This property is required. []string
exacts This property is required. List<String>
exacts This property is required. string[]
exacts This property is required. Sequence[str]
exacts This property is required. List<String>

GetVirtualGatewaySpecListenerTlValidationTrust

files This property is required. List<Property Map>
sds This property is required. List<Property Map>

GetVirtualGatewaySpecListenerTlValidationTrustFile

CertificateChain This property is required. string
CertificateChain This property is required. string
certificateChain This property is required. String
certificateChain This property is required. string
certificate_chain This property is required. str
certificateChain This property is required. String

GetVirtualGatewaySpecListenerTlValidationTrustSd

SecretName This property is required. string
SecretName This property is required. string
secretName This property is required. String
secretName This property is required. string
secret_name This property is required. str
secretName This property is required. String

GetVirtualGatewaySpecLogging

accessLogs This property is required. List<Property Map>

GetVirtualGatewaySpecLoggingAccessLog

files This property is required. List<Property Map>

GetVirtualGatewaySpecLoggingAccessLogFile

Formats This property is required. List<GetVirtualGatewaySpecLoggingAccessLogFileFormat>
Path This property is required. string
Formats This property is required. []GetVirtualGatewaySpecLoggingAccessLogFileFormat
Path This property is required. string
formats This property is required. List<GetVirtualGatewaySpecLoggingAccessLogFileFormat>
path This property is required. String
formats This property is required. GetVirtualGatewaySpecLoggingAccessLogFileFormat[]
path This property is required. string
formats This property is required. Sequence[GetVirtualGatewaySpecLoggingAccessLogFileFormat]
path This property is required. str
formats This property is required. List<Property Map>
path This property is required. String

GetVirtualGatewaySpecLoggingAccessLogFileFormat

Jsons This property is required. List<GetVirtualGatewaySpecLoggingAccessLogFileFormatJson>
Text This property is required. string
Jsons This property is required. []GetVirtualGatewaySpecLoggingAccessLogFileFormatJson
Text This property is required. string
jsons This property is required. List<GetVirtualGatewaySpecLoggingAccessLogFileFormatJson>
text This property is required. String
jsons This property is required. GetVirtualGatewaySpecLoggingAccessLogFileFormatJson[]
text This property is required. string
jsons This property is required. Sequence[GetVirtualGatewaySpecLoggingAccessLogFileFormatJson]
text This property is required. str
jsons This property is required. List<Property Map>
text This property is required. String

GetVirtualGatewaySpecLoggingAccessLogFileFormatJson

Key This property is required. string
Value This property is required. string
Key This property is required. string
Value This property is required. string
key This property is required. String
value This property is required. String
key This property is required. string
value This property is required. string
key This property is required. str
value This property is required. str
key This property is required. String
value This property is required. String

Package Details

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