From Code to Community: Sponsoring The Perl and Raku Conference 2025 Learn more

NAME

Paws::AppMesh::CreateVirtualGateway - Arguments for method CreateVirtualGateway on Paws::AppMesh

DESCRIPTION

This class represents the parameters used for calling the method CreateVirtualGateway on the AWS App Mesh service. Use the attributes of this class as arguments to method CreateVirtualGateway.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to CreateVirtualGateway.

SYNOPSIS

my $appmesh = Paws->service('AppMesh');
my $CreateVirtualGatewayOutput = $appmesh->CreateVirtualGateway(
MeshName => 'MyResourceName',
Spec => {
Listeners => [
{
PortMapping => {
Port => 1, # min: 1, max: 65535
Protocol => 'http', # values: http, http2, grpc
},
ConnectionPool => {
Grpc => {
MaxRequests => 1, # min: 1
}, # OPTIONAL
Http => {
MaxConnections => 1, # min: 1
MaxPendingRequests => 1, # min: 1; OPTIONAL
}, # OPTIONAL
Http2 => {
MaxRequests => 1, # min: 1
}, # OPTIONAL
}, # OPTIONAL
HealthCheck => {
HealthyThreshold => 1, # min: 2, max: 10
IntervalMillis => 1, # min: 5000, max: 300000
Protocol => 'http', # values: http, http2, grpc
TimeoutMillis => 1, # min: 2000, max: 60000
UnhealthyThreshold => 1, # min: 2, max: 10
Path => 'MyString', # OPTIONAL
Port => 1, # min: 1, max: 65535
}, # OPTIONAL
Tls => {
Certificate => {
Acm => {
CertificateArn => 'MyArn',
}, # OPTIONAL
File => {
CertificateChain => 'MyFilePath', # min: 1, max: 255
PrivateKey => 'MyFilePath', # min: 1, max: 255
}, # OPTIONAL
Sds => {
SecretName => 'MyVirtualGatewaySdsSecretName',
}, # OPTIONAL
},
Mode => 'STRICT', # values: STRICT, PERMISSIVE, DISABLED
Validation => {
Trust => {
File => {
CertificateChain => 'MyFilePath', # min: 1, max: 255
}, # OPTIONAL
Sds => {
SecretName => 'MyVirtualGatewaySdsSecretName',
}, # OPTIONAL
},
SubjectAlternativeNames => {
Match => {
Exact => [
'MySubjectAlternativeName', ... # min: 1, max: 254
],
},
}, # OPTIONAL
}, # OPTIONAL
}, # OPTIONAL
},
...
], # max: 1
BackendDefaults => {
ClientPolicy => {
Tls => {
Validation => {
Trust => {
Acm => {
CertificateAuthorityArns => [ 'MyArn', ... ]
, # min: 1, max: 3
}, # OPTIONAL
File => {
CertificateChain => 'MyFilePath', # min: 1, max: 255
}, # OPTIONAL
Sds => {
SecretName => 'MyVirtualGatewaySdsSecretName',
}, # OPTIONAL
},
SubjectAlternativeNames => {
Match => {
Exact => [
'MySubjectAlternativeName', ... # min: 1, max: 254
],
},
}, # OPTIONAL
},
Certificate => {
File => {
CertificateChain => 'MyFilePath', # min: 1, max: 255
PrivateKey => 'MyFilePath', # min: 1, max: 255
}, # OPTIONAL
Sds => {
SecretName => 'MyVirtualGatewaySdsSecretName',
}, # OPTIONAL
}, # OPTIONAL
Enforce => 1, # OPTIONAL
Ports => [
1, ... # min: 1, max: 65535
], # OPTIONAL
}, # OPTIONAL
}, # OPTIONAL
}, # OPTIONAL
Logging => {
AccessLog => {
File => {
Path => 'MyFilePath', # min: 1, max: 255
}, # OPTIONAL
}, # OPTIONAL
}, # OPTIONAL
},
VirtualGatewayName => 'MyResourceName',
ClientToken => 'MyString', # OPTIONAL
MeshOwner => 'MyAccountId', # OPTIONAL
Tags => [
{
Key => 'MyTagKey', # min: 1, max: 128
Value => 'MyTagValue', # max: 256
},
...
], # OPTIONAL
);
# Results:
my $VirtualGateway = $CreateVirtualGatewayOutput->VirtualGateway;
# Returns a L<Paws::AppMesh::CreateVirtualGatewayOutput> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/appmesh/CreateVirtualGateway

ATTRIBUTES

ClientToken => Str

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Up to 36 letters, numbers, hyphens, and underscores are allowed.

REQUIRED MeshName => Str

The name of the service mesh to create the virtual gateway in.

MeshOwner => Str

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes (https://docs.aws.amazon.com/app-mesh/latest/userguide/sharing.html).

REQUIRED Spec => Paws::AppMesh::VirtualGatewaySpec

The virtual gateway specification to apply.

Tags => ArrayRef[Paws::AppMesh::TagRef]

Optional metadata that you can apply to the virtual gateway to assist with categorization and organization. Each tag consists of a key and an optional value, both of which you define. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.

REQUIRED VirtualGatewayName => Str

The name to use for the virtual gateway.

SEE ALSO

This class forms part of Paws, documenting arguments for method CreateVirtualGateway in Paws::AppMesh

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues