The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

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