The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

NAME

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

DESCRIPTION

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

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

SYNOPSIS

my $appmesh = Paws->service('AppMesh');
my $CreateVirtualNodeOutput = $appmesh->CreateVirtualNode(
MeshName => 'MyResourceName',
Spec => {
BackendDefaults => {
ClientPolicy => {
Tls => {
Validation => {
Trust => {
Acm => {
CertificateAuthorityArns => [ 'MyArn', ... ]
, # min: 1, max: 3
}, # OPTIONAL
File => {
CertificateChain => 'MyFilePath', # min: 1, max: 255
}, # OPTIONAL
Sds => {
SecretName => 'MySdsSecretName',
}, # 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 => 'MySdsSecretName',
}, # OPTIONAL
}, # OPTIONAL
Enforce => 1, # OPTIONAL
Ports => [
1, ... # min: 1, max: 65535
], # OPTIONAL
}, # OPTIONAL
}, # OPTIONAL
}, # OPTIONAL
Backends => [
{
VirtualService => {
VirtualServiceName => 'MyServiceName',
ClientPolicy => {
Tls => {
Validation => {
Trust => {
Acm => {
CertificateAuthorityArns => [ 'MyArn', ... ]
, # min: 1, max: 3
}, # OPTIONAL
File => {
CertificateChain => 'MyFilePath', # min: 1, max: 255
}, # OPTIONAL
Sds => {
SecretName => 'MySdsSecretName',
}, # 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 => 'MySdsSecretName',
}, # OPTIONAL
}, # OPTIONAL
Enforce => 1, # OPTIONAL
Ports => [
1, ... # min: 1, max: 65535
], # OPTIONAL
}, # OPTIONAL
}, # OPTIONAL
}, # OPTIONAL
},
...
], # OPTIONAL
Listeners => [
{
PortMapping => {
Port => 1, # min: 1, max: 65535
Protocol => 'http', # values: http, tcp, 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
Tcp => {
MaxConnections => 1, # min: 1
}, # OPTIONAL
}, # OPTIONAL
HealthCheck => {
HealthyThreshold => 1, # min: 2, max: 10
IntervalMillis => 1, # min: 5000, max: 300000
Protocol => 'http', # values: http, tcp, http2, grpc
TimeoutMillis => 1, # min: 2000, max: 60000
UnhealthyThreshold => 1, # min: 2, max: 10
Path => 'MyString', # OPTIONAL
Port => 1, # min: 1, max: 65535
}, # OPTIONAL
OutlierDetection => {
BaseEjectionDuration => {
Unit => 's', # values: s, ms; OPTIONAL
Value => 1, # OPTIONAL
},
Interval => {
Unit => 's', # values: s, ms; OPTIONAL
Value => 1, # OPTIONAL
},
MaxEjectionPercent => 1, # max: 100
MaxServerErrors => 1, # min: 1
}, # OPTIONAL
Timeout => {
Grpc => {
Idle => {
Unit => 's', # values: s, ms; OPTIONAL
Value => 1, # OPTIONAL
},
PerRequest => {
Unit => 's', # values: s, ms; OPTIONAL
Value => 1, # OPTIONAL
},
}, # OPTIONAL
Http => {
Idle => {
Unit => 's', # values: s, ms; OPTIONAL
Value => 1, # OPTIONAL
},
PerRequest => {
Unit => 's', # values: s, ms; OPTIONAL
Value => 1, # OPTIONAL
},
}, # OPTIONAL
Http2 => {
Idle => {
Unit => 's', # values: s, ms; OPTIONAL
Value => 1, # OPTIONAL
},
PerRequest => {
Unit => 's', # values: s, ms; OPTIONAL
Value => 1, # OPTIONAL
},
}, # OPTIONAL
Tcp => {
Idle => {
Unit => 's', # values: s, ms; OPTIONAL
Value => 1, # OPTIONAL
},
}, # OPTIONAL
}, # OPTIONAL
Tls => {
Certificate => {
Acm => {
CertificateArn => 'MyArn',
}, # OPTIONAL
File => {
CertificateChain => 'MyFilePath', # min: 1, max: 255
PrivateKey => 'MyFilePath', # min: 1, max: 255
}, # OPTIONAL
Sds => {
SecretName => 'MySdsSecretName',
}, # OPTIONAL
},
Mode => 'STRICT', # values: STRICT, PERMISSIVE, DISABLED
Validation => {
Trust => {
File => {
CertificateChain => 'MyFilePath', # min: 1, max: 255
}, # OPTIONAL
Sds => {
SecretName => 'MySdsSecretName',
}, # OPTIONAL
},
SubjectAlternativeNames => {
Match => {
Exact => [
'MySubjectAlternativeName', ... # min: 1, max: 254
],
},
}, # OPTIONAL
}, # OPTIONAL
}, # OPTIONAL
},
...
], # max: 1; OPTIONAL
Logging => {
AccessLog => {
File => {
Path => 'MyFilePath', # min: 1, max: 255
}, # OPTIONAL
}, # OPTIONAL
}, # OPTIONAL
ServiceDiscovery => {
AwsCloudMap => {
NamespaceName => 'MyAwsCloudMapName', # min: 1, max: 1024
ServiceName => 'MyAwsCloudMapName', # min: 1, max: 1024
Attributes => [
{
Key => 'MyAwsCloudMapInstanceAttributeKey', # min: 1, max: 255
Value =>
'MyAwsCloudMapInstanceAttributeValue', # min: 1, max: 1024
},
...
], # OPTIONAL
}, # OPTIONAL
Dns => {
Hostname => 'MyHostname',
ResponseType =>
'LOADBALANCER', # values: LOADBALANCER, ENDPOINTS; OPTIONAL
}, # OPTIONAL
}, # OPTIONAL
},
VirtualNodeName => 'MyResourceName',
ClientToken => 'MyString', # OPTIONAL
MeshOwner => 'MyAccountId', # OPTIONAL
Tags => [
{
Key => 'MyTagKey', # min: 1, max: 128
Value => 'MyTagValue', # max: 256
},
...
], # OPTIONAL
);
# Results:
my $VirtualNode = $CreateVirtualNodeOutput->VirtualNode;
# Returns a L<Paws::AppMesh::CreateVirtualNodeOutput> 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/CreateVirtualNode

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 node 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::VirtualNodeSpec

The virtual node specification to apply.

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

Optional metadata that you can apply to the virtual node 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 VirtualNodeName => Str

The name to use for the virtual node.

SEE ALSO

This class forms part of Paws, documenting arguments for method CreateVirtualNode 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