BatchUpdateRule

$result = $client->batchUpdateRule([/* ... */]);
$promise = $client->batchUpdateRuleAsync([/* ... */]);

Updates the listener rules in a batch. You can use this operation to change the priority of listener rules. This can be useful when bulk updating or swapping rule priority.

Required permissions: vpc-lattice:UpdateRule

For more information, see How Amazon VPC Lattice works with IAM in the Amazon VPC Lattice User Guide.

Parameter Syntax

$result = $client->batchUpdateRule([
    'listenerIdentifier' => '<string>', // REQUIRED
    'rules' => [ // REQUIRED
        [
            'action' => [
                'fixedResponse' => [
                    'statusCode' => <integer>, // REQUIRED
                ],
                'forward' => [
                    'targetGroups' => [ // REQUIRED
                        [
                            'targetGroupIdentifier' => '<string>', // REQUIRED
                            'weight' => <integer>,
                        ],
                        // ...
                    ],
                ],
            ],
            'match' => [
                'httpMatch' => [
                    'headerMatches' => [
                        [
                            'caseSensitive' => true || false,
                            'match' => [ // REQUIRED
                                'contains' => '<string>',
                                'exact' => '<string>',
                                'prefix' => '<string>',
                            ],
                            'name' => '<string>', // REQUIRED
                        ],
                        // ...
                    ],
                    'method' => '<string>',
                    'pathMatch' => [
                        'caseSensitive' => true || false,
                        'match' => [ // REQUIRED
                            'exact' => '<string>',
                            'prefix' => '<string>',
                        ],
                    ],
                ],
            ],
            'priority' => <integer>,
            'ruleIdentifier' => '<string>', // REQUIRED
        ],
        // ...
    ],
    'serviceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'successful' => [
        [
            'action' => [
                'fixedResponse' => [
                    'statusCode' => <integer>,
                ],
                'forward' => [
                    'targetGroups' => [
                        [
                            'targetGroupIdentifier' => '<string>',
                            'weight' => <integer>,
                        ],
                        // ...
                    ],
                ],
            ],
            'arn' => '<string>',
            'id' => '<string>',
            'isDefault' => true || false,
            'match' => [
                'httpMatch' => [
                    'headerMatches' => [
                        [
                            'caseSensitive' => true || false,
                            'match' => [
                                'contains' => '<string>',
                                'exact' => '<string>',
                                'prefix' => '<string>',
                            ],
                            'name' => '<string>',
                        ],
                        // ...
                    ],
                    'method' => '<string>',
                    'pathMatch' => [
                        'caseSensitive' => true || false,
                        'match' => [
                            'exact' => '<string>',
                            'prefix' => '<string>',
                        ],
                    ],
                ],
            ],
            'name' => '<string>',
            'priority' => <integer>,
        ],
        // ...
    ],
    'unsuccessful' => [
        [
            'failureCode' => '<string>',
            'failureMessage' => '<string>',
            'ruleIdentifier' => '<string>',
        ],
        // ...
    ],
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

CreateAccessLogSubscription

$result = $client->createAccessLogSubscription([/* ... */]);
$promise = $client->createAccessLogSubscriptionAsync([/* ... */]);

Enables access logs to be sent to Amazon CloudWatch, Amazon S3, and Amazon Kinesis Data Firehose. The service network owner can use the access logs to audit the services in the network. The service network owner can only see access logs from clients and services that are associated with their service network. Access log entries represent traffic originated from VPCs associated with that network. For more information, see Access logs in the Amazon VPC Lattice User Guide.

Parameter Syntax

$result = $client->createAccessLogSubscription([
    'clientToken' => '<string>',
    'destinationArn' => '<string>', // REQUIRED
    'resourceIdentifier' => '<string>', // REQUIRED
    'serviceNetworkLogType' => 'SERVICE|RESOURCE',
    'tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'destinationArn' => '<string>',
    'id' => '<string>',
    'resourceArn' => '<string>',
    'resourceId' => '<string>',
    'serviceNetworkLogType' => 'SERVICE|RESOURCE',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

CreateListener

$result = $client->createListener([/* ... */]);
$promise = $client->createListenerAsync([/* ... */]);

Creates a listener for a service. Before you start using your Amazon VPC Lattice service, you must add one or more listeners. A listener is a process that checks for connection requests to your services. For more information, see Listeners in the Amazon VPC Lattice User Guide.

Parameter Syntax

$result = $client->createListener([
    'clientToken' => '<string>',
    'defaultAction' => [ // REQUIRED
        'fixedResponse' => [
            'statusCode' => <integer>, // REQUIRED
        ],
        'forward' => [
            'targetGroups' => [ // REQUIRED
                [
                    'targetGroupIdentifier' => '<string>', // REQUIRED
                    'weight' => <integer>,
                ],
                // ...
            ],
        ],
    ],
    'name' => '<string>', // REQUIRED
    'port' => <integer>,
    'protocol' => 'HTTP|HTTPS|TLS_PASSTHROUGH', // REQUIRED
    'serviceIdentifier' => '<string>', // REQUIRED
    'tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'defaultAction' => [
        'fixedResponse' => [
            'statusCode' => <integer>,
        ],
        'forward' => [
            'targetGroups' => [
                [
                    'targetGroupIdentifier' => '<string>',
                    'weight' => <integer>,
                ],
                // ...
            ],
        ],
    ],
    'id' => '<string>',
    'name' => '<string>',
    'port' => <integer>,
    'protocol' => 'HTTP|HTTPS|TLS_PASSTHROUGH',
    'serviceArn' => '<string>',
    'serviceId' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

ServiceQuotaExceededException:

The request would cause a service quota to be exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

CreateResourceConfiguration

$result = $client->createResourceConfiguration([/* ... */]);
$promise = $client->createResourceConfigurationAsync([/* ... */]);

Creates a resource configuration. A resource configuration defines a specific resource. You can associate a resource configuration with a service network or a VPC endpoint.

Parameter Syntax

$result = $client->createResourceConfiguration([
    'allowAssociationToShareableServiceNetwork' => true || false,
    'clientToken' => '<string>',
    'name' => '<string>', // REQUIRED
    'portRanges' => ['<string>', ...],
    'protocol' => 'TCP',
    'resourceConfigurationDefinition' => [
        'arnResource' => [
            'arn' => '<string>',
        ],
        'dnsResource' => [
            'domainName' => '<string>',
            'ipAddressType' => 'IPV4|IPV6|DUALSTACK',
        ],
        'ipResource' => [
            'ipAddress' => '<string>',
        ],
    ],
    'resourceConfigurationGroupIdentifier' => '<string>',
    'resourceGatewayIdentifier' => '<string>',
    'tags' => ['<string>', ...],
    'type' => 'GROUP|CHILD|SINGLE|ARN', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'allowAssociationToShareableServiceNetwork' => true || false,
    'arn' => '<string>',
    'createdAt' => <DateTime>,
    'failureReason' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'portRanges' => ['<string>', ...],
    'protocol' => 'TCP',
    'resourceConfigurationDefinition' => [
        'arnResource' => [
            'arn' => '<string>',
        ],
        'dnsResource' => [
            'domainName' => '<string>',
            'ipAddressType' => 'IPV4|IPV6|DUALSTACK',
        ],
        'ipResource' => [
            'ipAddress' => '<string>',
        ],
    ],
    'resourceConfigurationGroupId' => '<string>',
    'resourceGatewayId' => '<string>',
    'status' => 'ACTIVE|CREATE_IN_PROGRESS|UPDATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|UPDATE_FAILED|DELETE_FAILED',
    'type' => 'GROUP|CHILD|SINGLE|ARN',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

ServiceQuotaExceededException:

The request would cause a service quota to be exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

CreateResourceGateway

$result = $client->createResourceGateway([/* ... */]);
$promise = $client->createResourceGatewayAsync([/* ... */]);

Creates a resource gateway.

Parameter Syntax

$result = $client->createResourceGateway([
    'clientToken' => '<string>',
    'ipAddressType' => 'IPV4|IPV6|DUALSTACK',
    'name' => '<string>', // REQUIRED
    'securityGroupIds' => ['<string>', ...],
    'subnetIds' => ['<string>', ...], // REQUIRED
    'tags' => ['<string>', ...],
    'vpcIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'id' => '<string>',
    'ipAddressType' => 'IPV4|IPV6|DUALSTACK',
    'name' => '<string>',
    'securityGroupIds' => ['<string>', ...],
    'status' => 'ACTIVE|CREATE_IN_PROGRESS|UPDATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|UPDATE_FAILED|DELETE_FAILED',
    'subnetIds' => ['<string>', ...],
    'vpcIdentifier' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

ServiceQuotaExceededException:

The request would cause a service quota to be exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

CreateRule

$result = $client->createRule([/* ... */]);
$promise = $client->createRuleAsync([/* ... */]);

Creates a listener rule. Each listener has a default rule for checking connection requests, but you can define additional rules. Each rule consists of a priority, one or more actions, and one or more conditions. For more information, see Listener rules in the Amazon VPC Lattice User Guide.

Parameter Syntax

$result = $client->createRule([
    'action' => [ // REQUIRED
        'fixedResponse' => [
            'statusCode' => <integer>, // REQUIRED
        ],
        'forward' => [
            'targetGroups' => [ // REQUIRED
                [
                    'targetGroupIdentifier' => '<string>', // REQUIRED
                    'weight' => <integer>,
                ],
                // ...
            ],
        ],
    ],
    'clientToken' => '<string>',
    'listenerIdentifier' => '<string>', // REQUIRED
    'match' => [ // REQUIRED
        'httpMatch' => [
            'headerMatches' => [
                [
                    'caseSensitive' => true || false,
                    'match' => [ // REQUIRED
                        'contains' => '<string>',
                        'exact' => '<string>',
                        'prefix' => '<string>',
                    ],
                    'name' => '<string>', // REQUIRED
                ],
                // ...
            ],
            'method' => '<string>',
            'pathMatch' => [
                'caseSensitive' => true || false,
                'match' => [ // REQUIRED
                    'exact' => '<string>',
                    'prefix' => '<string>',
                ],
            ],
        ],
    ],
    'name' => '<string>', // REQUIRED
    'priority' => <integer>, // REQUIRED
    'serviceIdentifier' => '<string>', // REQUIRED
    'tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'action' => [
        'fixedResponse' => [
            'statusCode' => <integer>,
        ],
        'forward' => [
            'targetGroups' => [
                [
                    'targetGroupIdentifier' => '<string>',
                    'weight' => <integer>,
                ],
                // ...
            ],
        ],
    ],
    'arn' => '<string>',
    'id' => '<string>',
    'match' => [
        'httpMatch' => [
            'headerMatches' => [
                [
                    'caseSensitive' => true || false,
                    'match' => [
                        'contains' => '<string>',
                        'exact' => '<string>',
                        'prefix' => '<string>',
                    ],
                    'name' => '<string>',
                ],
                // ...
            ],
            'method' => '<string>',
            'pathMatch' => [
                'caseSensitive' => true || false,
                'match' => [
                    'exact' => '<string>',
                    'prefix' => '<string>',
                ],
            ],
        ],
    ],
    'name' => '<string>',
    'priority' => <integer>,
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

ServiceQuotaExceededException:

The request would cause a service quota to be exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

CreateService

$result = $client->createService([/* ... */]);
$promise = $client->createServiceAsync([/* ... */]);

Creates a service. A service is any software application that can run on instances containers, or serverless functions within an account or virtual private cloud (VPC).

For more information, see Services in the Amazon VPC Lattice User Guide.

Parameter Syntax

$result = $client->createService([
    'authType' => 'NONE|AWS_IAM',
    'certificateArn' => '<string>',
    'clientToken' => '<string>',
    'customDomainName' => '<string>',
    'name' => '<string>', // REQUIRED
    'tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'authType' => 'NONE|AWS_IAM',
    'certificateArn' => '<string>',
    'customDomainName' => '<string>',
    'dnsEntry' => [
        'domainName' => '<string>',
        'hostedZoneId' => '<string>',
    ],
    'id' => '<string>',
    'name' => '<string>',
    'status' => 'ACTIVE|CREATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

ServiceQuotaExceededException:

The request would cause a service quota to be exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

CreateServiceNetwork

$result = $client->createServiceNetwork([/* ... */]);
$promise = $client->createServiceNetworkAsync([/* ... */]);

Creates a service network. A service network is a logical boundary for a collection of services. You can associate services and VPCs with a service network.

For more information, see Service networks in the Amazon VPC Lattice User Guide.

Parameter Syntax

$result = $client->createServiceNetwork([
    'authType' => 'NONE|AWS_IAM',
    'clientToken' => '<string>',
    'name' => '<string>', // REQUIRED
    'sharingConfig' => [
        'enabled' => true || false,
    ],
    'tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'authType' => 'NONE|AWS_IAM',
    'id' => '<string>',
    'name' => '<string>',
    'sharingConfig' => [
        'enabled' => true || false,
    ],
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

ServiceQuotaExceededException:

The request would cause a service quota to be exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

CreateServiceNetworkResourceAssociation

$result = $client->createServiceNetworkResourceAssociation([/* ... */]);
$promise = $client->createServiceNetworkResourceAssociationAsync([/* ... */]);

Associates the specified service network with the specified resource configuration. This allows the resource configuration to receive connections through the service network, including through a service network VPC endpoint.

Parameter Syntax

$result = $client->createServiceNetworkResourceAssociation([
    'clientToken' => '<string>',
    'resourceConfigurationIdentifier' => '<string>', // REQUIRED
    'serviceNetworkIdentifier' => '<string>', // REQUIRED
    'tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'createdBy' => '<string>',
    'id' => '<string>',
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|PARTIAL|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

ServiceQuotaExceededException:

The request would cause a service quota to be exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

CreateServiceNetworkServiceAssociation

$result = $client->createServiceNetworkServiceAssociation([/* ... */]);
$promise = $client->createServiceNetworkServiceAssociationAsync([/* ... */]);

Associates the specified service with the specified service network. For more information, see Manage service associations in the Amazon VPC Lattice User Guide.

You can't use this operation if the service and service network are already associated or if there is a disassociation or deletion in progress. If the association fails, you can retry the operation by deleting the association and recreating it.

You cannot associate a service and service network that are shared with a caller. The caller must own either the service or the service network.

As a result of this operation, the association is created in the service network account and the association owner account.

Parameter Syntax

$result = $client->createServiceNetworkServiceAssociation([
    'clientToken' => '<string>',
    'serviceIdentifier' => '<string>', // REQUIRED
    'serviceNetworkIdentifier' => '<string>', // REQUIRED
    'tags' => ['<string>', ...],
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'createdBy' => '<string>',
    'customDomainName' => '<string>',
    'dnsEntry' => [
        'domainName' => '<string>',
        'hostedZoneId' => '<string>',
    ],
    'id' => '<string>',
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

ServiceQuotaExceededException:

The request would cause a service quota to be exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

CreateServiceNetworkVpcAssociation

$result = $client->createServiceNetworkVpcAssociation([/* ... */]);
$promise = $client->createServiceNetworkVpcAssociationAsync([/* ... */]);

Associates a VPC with a service network. When you associate a VPC with the service network, it enables all the resources within that VPC to be clients and communicate with other services in the service network. For more information, see Manage VPC associations in the Amazon VPC Lattice User Guide.

You can't use this operation if there is a disassociation in progress. If the association fails, retry by deleting the association and recreating it.

As a result of this operation, the association gets created in the service network account and the VPC owner account.

If you add a security group to the service network and VPC association, the association must continue to always have at least one security group. You can add or edit security groups at any time. However, to remove all security groups, you must first delete the association and recreate it without security groups.

Parameter Syntax

$result = $client->createServiceNetworkVpcAssociation([
    'clientToken' => '<string>',
    'securityGroupIds' => ['<string>', ...],
    'serviceNetworkIdentifier' => '<string>', // REQUIRED
    'tags' => ['<string>', ...],
    'vpcIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'createdBy' => '<string>',
    'id' => '<string>',
    'securityGroupIds' => ['<string>', ...],
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|UPDATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED|UPDATE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

ServiceQuotaExceededException:

The request would cause a service quota to be exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

CreateTargetGroup

$result = $client->createTargetGroup([/* ... */]);
$promise = $client->createTargetGroupAsync([/* ... */]);

Creates a target group. A target group is a collection of targets, or compute resources, that run your application or service. A target group can only be used by a single service.

For more information, see Target groups in the Amazon VPC Lattice User Guide.

Parameter Syntax

$result = $client->createTargetGroup([
    'clientToken' => '<string>',
    'config' => [
        'healthCheck' => [
            'enabled' => true || false,
            'healthCheckIntervalSeconds' => <integer>,
            'healthCheckTimeoutSeconds' => <integer>,
            'healthyThresholdCount' => <integer>,
            'matcher' => [
                'httpCode' => '<string>',
            ],
            'path' => '<string>',
            'port' => <integer>,
            'protocol' => 'HTTP|HTTPS|TCP',
            'protocolVersion' => 'HTTP1|HTTP2',
            'unhealthyThresholdCount' => <integer>,
        ],
        'ipAddressType' => 'IPV4|IPV6',
        'lambdaEventStructureVersion' => 'V1|V2',
        'port' => <integer>,
        'protocol' => 'HTTP|HTTPS|TCP',
        'protocolVersion' => 'HTTP1|HTTP2|GRPC',
        'vpcIdentifier' => '<string>',
    ],
    'name' => '<string>', // REQUIRED
    'tags' => ['<string>', ...],
    'type' => 'IP|LAMBDA|INSTANCE|ALB', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'config' => [
        'healthCheck' => [
            'enabled' => true || false,
            'healthCheckIntervalSeconds' => <integer>,
            'healthCheckTimeoutSeconds' => <integer>,
            'healthyThresholdCount' => <integer>,
            'matcher' => [
                'httpCode' => '<string>',
            ],
            'path' => '<string>',
            'port' => <integer>,
            'protocol' => 'HTTP|HTTPS|TCP',
            'protocolVersion' => 'HTTP1|HTTP2',
            'unhealthyThresholdCount' => <integer>,
        ],
        'ipAddressType' => 'IPV4|IPV6',
        'lambdaEventStructureVersion' => 'V1|V2',
        'port' => <integer>,
        'protocol' => 'HTTP|HTTPS|TCP',
        'protocolVersion' => 'HTTP1|HTTP2|GRPC',
        'vpcIdentifier' => '<string>',
    ],
    'id' => '<string>',
    'name' => '<string>',
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
    'type' => 'IP|LAMBDA|INSTANCE|ALB',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

ServiceQuotaExceededException:

The request would cause a service quota to be exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteAccessLogSubscription

$result = $client->deleteAccessLogSubscription([/* ... */]);
$promise = $client->deleteAccessLogSubscriptionAsync([/* ... */]);

Deletes the specified access log subscription.

Parameter Syntax

$result = $client->deleteAccessLogSubscription([
    'accessLogSubscriptionIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteAuthPolicy

$result = $client->deleteAuthPolicy([/* ... */]);
$promise = $client->deleteAuthPolicyAsync([/* ... */]);

Deletes the specified auth policy. If an auth is set to AWS_IAM and the auth policy is deleted, all requests are denied. If you are trying to remove the auth policy completely, you must set the auth type to NONE. If auth is enabled on the resource, but no auth policy is set, all requests are denied.

Parameter Syntax

$result = $client->deleteAuthPolicy([
    'resourceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteListener

$result = $client->deleteListener([/* ... */]);
$promise = $client->deleteListenerAsync([/* ... */]);

Deletes the specified listener.

Parameter Syntax

$result = $client->deleteListener([
    'listenerIdentifier' => '<string>', // REQUIRED
    'serviceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteResourceConfiguration

$result = $client->deleteResourceConfiguration([/* ... */]);
$promise = $client->deleteResourceConfigurationAsync([/* ... */]);

Deletes the specified resource configuration.

Parameter Syntax

$result = $client->deleteResourceConfiguration([
    'resourceConfigurationIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteResourceEndpointAssociation

$result = $client->deleteResourceEndpointAssociation([/* ... */]);
$promise = $client->deleteResourceEndpointAssociationAsync([/* ... */]);

Disassociates the resource configuration from the resource VPC endpoint.

Parameter Syntax

$result = $client->deleteResourceEndpointAssociation([
    'resourceEndpointAssociationIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'id' => '<string>',
    'resourceConfigurationArn' => '<string>',
    'resourceConfigurationId' => '<string>',
    'vpcEndpointId' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteResourceGateway

$result = $client->deleteResourceGateway([/* ... */]);
$promise = $client->deleteResourceGatewayAsync([/* ... */]);

Deletes the specified resource gateway.

Parameter Syntax

$result = $client->deleteResourceGateway([
    'resourceGatewayIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'status' => 'ACTIVE|CREATE_IN_PROGRESS|UPDATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|UPDATE_FAILED|DELETE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteResourcePolicy

$result = $client->deleteResourcePolicy([/* ... */]);
$promise = $client->deleteResourcePolicyAsync([/* ... */]);

Deletes the specified resource policy.

Parameter Syntax

$result = $client->deleteResourcePolicy([
    'resourceArn' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteRule

$result = $client->deleteRule([/* ... */]);
$promise = $client->deleteRuleAsync([/* ... */]);

Deletes a listener rule. Each listener has a default rule for checking connection requests, but you can define additional rules. Each rule consists of a priority, one or more actions, and one or more conditions. You can delete additional listener rules, but you cannot delete the default rule.

For more information, see Listener rules in the Amazon VPC Lattice User Guide.

Parameter Syntax

$result = $client->deleteRule([
    'listenerIdentifier' => '<string>', // REQUIRED
    'ruleIdentifier' => '<string>', // REQUIRED
    'serviceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteService

$result = $client->deleteService([/* ... */]);
$promise = $client->deleteServiceAsync([/* ... */]);

Deletes a service. A service can't be deleted if it's associated with a service network. If you delete a service, all resources related to the service, such as the resource policy, auth policy, listeners, listener rules, and access log subscriptions, are also deleted. For more information, see Delete a service in the Amazon VPC Lattice User Guide.

Parameter Syntax

$result = $client->deleteService([
    'serviceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'id' => '<string>',
    'name' => '<string>',
    'status' => 'ACTIVE|CREATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteServiceNetwork

$result = $client->deleteServiceNetwork([/* ... */]);
$promise = $client->deleteServiceNetworkAsync([/* ... */]);

Deletes a service network. You can only delete the service network if there is no service or VPC associated with it. If you delete a service network, all resources related to the service network, such as the resource policy, auth policy, and access log subscriptions, are also deleted. For more information, see Delete a service network in the Amazon VPC Lattice User Guide.

Parameter Syntax

$result = $client->deleteServiceNetwork([
    'serviceNetworkIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteServiceNetworkResourceAssociation

$result = $client->deleteServiceNetworkResourceAssociation([/* ... */]);
$promise = $client->deleteServiceNetworkResourceAssociationAsync([/* ... */]);

Deletes the association between a service network and a resource configuration.

Parameter Syntax

$result = $client->deleteServiceNetworkResourceAssociation([
    'serviceNetworkResourceAssociationIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'id' => '<string>',
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|PARTIAL|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteServiceNetworkServiceAssociation

$result = $client->deleteServiceNetworkServiceAssociation([/* ... */]);
$promise = $client->deleteServiceNetworkServiceAssociationAsync([/* ... */]);

Deletes the association between a service and a service network. This operation fails if an association is still in progress.

Parameter Syntax

$result = $client->deleteServiceNetworkServiceAssociation([
    'serviceNetworkServiceAssociationIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'id' => '<string>',
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteServiceNetworkVpcAssociation

$result = $client->deleteServiceNetworkVpcAssociation([/* ... */]);
$promise = $client->deleteServiceNetworkVpcAssociationAsync([/* ... */]);

Disassociates the VPC from the service network. You can't disassociate the VPC if there is a create or update association in progress.

Parameter Syntax

$result = $client->deleteServiceNetworkVpcAssociation([
    'serviceNetworkVpcAssociationIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'id' => '<string>',
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|UPDATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED|UPDATE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

DeleteTargetGroup

$result = $client->deleteTargetGroup([/* ... */]);
$promise = $client->deleteTargetGroupAsync([/* ... */]);

Deletes a target group. You can't delete a target group if it is used in a listener rule or if the target group creation is in progress.

Parameter Syntax

$result = $client->deleteTargetGroup([
    'targetGroupIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'id' => '<string>',
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

DeregisterTargets

$result = $client->deregisterTargets([/* ... */]);
$promise = $client->deregisterTargetsAsync([/* ... */]);

Deregisters the specified targets from the specified target group.

Parameter Syntax

$result = $client->deregisterTargets([
    'targetGroupIdentifier' => '<string>', // REQUIRED
    'targets' => [ // REQUIRED
        [
            'id' => '<string>', // REQUIRED
            'port' => <integer>,
        ],
        // ...
    ],
]);

Parameter Details

Result Syntax

[
    'successful' => [
        [
            'id' => '<string>',
            'port' => <integer>,
        ],
        // ...
    ],
    'unsuccessful' => [
        [
            'failureCode' => '<string>',
            'failureMessage' => '<string>',
            'id' => '<string>',
            'port' => <integer>,
        ],
        // ...
    ],
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

ConflictException:

The request conflicts with the current state of the resource. Updating or deleting a resource can cause an inconsistent state.

InternalServerException:

An unexpected error occurred while processing the request.

GetAccessLogSubscription

$result = $client->getAccessLogSubscription([/* ... */]);
$promise = $client->getAccessLogSubscriptionAsync([/* ... */]);

Retrieves information about the specified access log subscription.

Parameter Syntax

$result = $client->getAccessLogSubscription([
    'accessLogSubscriptionIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'createdAt' => <DateTime>,
    'destinationArn' => '<string>',
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'resourceArn' => '<string>',
    'resourceId' => '<string>',
    'serviceNetworkLogType' => 'SERVICE|RESOURCE',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetAuthPolicy

$result = $client->getAuthPolicy([/* ... */]);
$promise = $client->getAuthPolicyAsync([/* ... */]);

Retrieves information about the auth policy for the specified service or service network.

Parameter Syntax

$result = $client->getAuthPolicy([
    'resourceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'createdAt' => <DateTime>,
    'lastUpdatedAt' => <DateTime>,
    'policy' => '<string>',
    'state' => 'Active|Inactive',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetListener

$result = $client->getListener([/* ... */]);
$promise = $client->getListenerAsync([/* ... */]);

Retrieves information about the specified listener for the specified service.

Parameter Syntax

$result = $client->getListener([
    'listenerIdentifier' => '<string>', // REQUIRED
    'serviceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'createdAt' => <DateTime>,
    'defaultAction' => [
        'fixedResponse' => [
            'statusCode' => <integer>,
        ],
        'forward' => [
            'targetGroups' => [
                [
                    'targetGroupIdentifier' => '<string>',
                    'weight' => <integer>,
                ],
                // ...
            ],
        ],
    ],
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'port' => <integer>,
    'protocol' => 'HTTP|HTTPS|TLS_PASSTHROUGH',
    'serviceArn' => '<string>',
    'serviceId' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetResourceConfiguration

$result = $client->getResourceConfiguration([/* ... */]);
$promise = $client->getResourceConfigurationAsync([/* ... */]);

Retrieves information about the specified resource configuration.

Parameter Syntax

$result = $client->getResourceConfiguration([
    'resourceConfigurationIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'allowAssociationToShareableServiceNetwork' => true || false,
    'amazonManaged' => true || false,
    'arn' => '<string>',
    'createdAt' => <DateTime>,
    'customDomainName' => '<string>',
    'failureReason' => '<string>',
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'portRanges' => ['<string>', ...],
    'protocol' => 'TCP',
    'resourceConfigurationDefinition' => [
        'arnResource' => [
            'arn' => '<string>',
        ],
        'dnsResource' => [
            'domainName' => '<string>',
            'ipAddressType' => 'IPV4|IPV6|DUALSTACK',
        ],
        'ipResource' => [
            'ipAddress' => '<string>',
        ],
    ],
    'resourceConfigurationGroupId' => '<string>',
    'resourceGatewayId' => '<string>',
    'status' => 'ACTIVE|CREATE_IN_PROGRESS|UPDATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|UPDATE_FAILED|DELETE_FAILED',
    'type' => 'GROUP|CHILD|SINGLE|ARN',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetResourceGateway

$result = $client->getResourceGateway([/* ... */]);
$promise = $client->getResourceGatewayAsync([/* ... */]);

Retrieves information about the specified resource gateway.

Parameter Syntax

$result = $client->getResourceGateway([
    'resourceGatewayIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'createdAt' => <DateTime>,
    'id' => '<string>',
    'ipAddressType' => 'IPV4|IPV6|DUALSTACK',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'securityGroupIds' => ['<string>', ...],
    'status' => 'ACTIVE|CREATE_IN_PROGRESS|UPDATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|UPDATE_FAILED|DELETE_FAILED',
    'subnetIds' => ['<string>', ...],
    'vpcId' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetResourcePolicy

$result = $client->getResourcePolicy([/* ... */]);
$promise = $client->getResourcePolicyAsync([/* ... */]);

Retrieves information about the specified resource policy. The resource policy is an IAM policy created on behalf of the resource owner when they share a resource.

Parameter Syntax

$result = $client->getResourcePolicy([
    'resourceArn' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'policy' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetRule

$result = $client->getRule([/* ... */]);
$promise = $client->getRuleAsync([/* ... */]);

Retrieves information about the specified listener rules. You can also retrieve information about the default listener rule. For more information, see Listener rules in the Amazon VPC Lattice User Guide.

Parameter Syntax

$result = $client->getRule([
    'listenerIdentifier' => '<string>', // REQUIRED
    'ruleIdentifier' => '<string>', // REQUIRED
    'serviceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'action' => [
        'fixedResponse' => [
            'statusCode' => <integer>,
        ],
        'forward' => [
            'targetGroups' => [
                [
                    'targetGroupIdentifier' => '<string>',
                    'weight' => <integer>,
                ],
                // ...
            ],
        ],
    ],
    'arn' => '<string>',
    'createdAt' => <DateTime>,
    'id' => '<string>',
    'isDefault' => true || false,
    'lastUpdatedAt' => <DateTime>,
    'match' => [
        'httpMatch' => [
            'headerMatches' => [
                [
                    'caseSensitive' => true || false,
                    'match' => [
                        'contains' => '<string>',
                        'exact' => '<string>',
                        'prefix' => '<string>',
                    ],
                    'name' => '<string>',
                ],
                // ...
            ],
            'method' => '<string>',
            'pathMatch' => [
                'caseSensitive' => true || false,
                'match' => [
                    'exact' => '<string>',
                    'prefix' => '<string>',
                ],
            ],
        ],
    ],
    'name' => '<string>',
    'priority' => <integer>,
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetService

$result = $client->getService([/* ... */]);
$promise = $client->getServiceAsync([/* ... */]);

Retrieves information about the specified service.

Parameter Syntax

$result = $client->getService([
    'serviceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'authType' => 'NONE|AWS_IAM',
    'certificateArn' => '<string>',
    'createdAt' => <DateTime>,
    'customDomainName' => '<string>',
    'dnsEntry' => [
        'domainName' => '<string>',
        'hostedZoneId' => '<string>',
    ],
    'failureCode' => '<string>',
    'failureMessage' => '<string>',
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'status' => 'ACTIVE|CREATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetServiceNetwork

$result = $client->getServiceNetwork([/* ... */]);
$promise = $client->getServiceNetworkAsync([/* ... */]);

Retrieves information about the specified service network.

Parameter Syntax

$result = $client->getServiceNetwork([
    'serviceNetworkIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'authType' => 'NONE|AWS_IAM',
    'createdAt' => <DateTime>,
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'numberOfAssociatedServices' => <integer>,
    'numberOfAssociatedVPCs' => <integer>,
    'sharingConfig' => [
        'enabled' => true || false,
    ],
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetServiceNetworkResourceAssociation

$result = $client->getServiceNetworkResourceAssociation([/* ... */]);
$promise = $client->getServiceNetworkResourceAssociationAsync([/* ... */]);

Retrieves information about the specified association between a service network and a resource configuration.

Parameter Syntax

$result = $client->getServiceNetworkResourceAssociation([
    'serviceNetworkResourceAssociationIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'dnsEntry' => [
        'domainName' => '<string>',
        'hostedZoneId' => '<string>',
    ],
    'failureCode' => '<string>',
    'failureReason' => '<string>',
    'id' => '<string>',
    'isManagedAssociation' => true || false,
    'lastUpdatedAt' => <DateTime>,
    'privateDnsEntry' => [
        'domainName' => '<string>',
        'hostedZoneId' => '<string>',
    ],
    'resourceConfigurationArn' => '<string>',
    'resourceConfigurationId' => '<string>',
    'resourceConfigurationName' => '<string>',
    'serviceNetworkArn' => '<string>',
    'serviceNetworkId' => '<string>',
    'serviceNetworkName' => '<string>',
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|PARTIAL|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetServiceNetworkServiceAssociation

$result = $client->getServiceNetworkServiceAssociation([/* ... */]);
$promise = $client->getServiceNetworkServiceAssociationAsync([/* ... */]);

Retrieves information about the specified association between a service network and a service.

Parameter Syntax

$result = $client->getServiceNetworkServiceAssociation([
    'serviceNetworkServiceAssociationIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'customDomainName' => '<string>',
    'dnsEntry' => [
        'domainName' => '<string>',
        'hostedZoneId' => '<string>',
    ],
    'failureCode' => '<string>',
    'failureMessage' => '<string>',
    'id' => '<string>',
    'serviceArn' => '<string>',
    'serviceId' => '<string>',
    'serviceName' => '<string>',
    'serviceNetworkArn' => '<string>',
    'serviceNetworkId' => '<string>',
    'serviceNetworkName' => '<string>',
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetServiceNetworkVpcAssociation

$result = $client->getServiceNetworkVpcAssociation([/* ... */]);
$promise = $client->getServiceNetworkVpcAssociationAsync([/* ... */]);

Retrieves information about the specified association between a service network and a VPC.

Parameter Syntax

$result = $client->getServiceNetworkVpcAssociation([
    'serviceNetworkVpcAssociationIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'createdAt' => <DateTime>,
    'createdBy' => '<string>',
    'failureCode' => '<string>',
    'failureMessage' => '<string>',
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'securityGroupIds' => ['<string>', ...],
    'serviceNetworkArn' => '<string>',
    'serviceNetworkId' => '<string>',
    'serviceNetworkName' => '<string>',
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|UPDATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED|UPDATE_FAILED',
    'vpcId' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

GetTargetGroup

$result = $client->getTargetGroup([/* ... */]);
$promise = $client->getTargetGroupAsync([/* ... */]);

Retrieves information about the specified target group.

Parameter Syntax

$result = $client->getTargetGroup([
    'targetGroupIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'arn' => '<string>',
    'config' => [
        'healthCheck' => [
            'enabled' => true || false,
            'healthCheckIntervalSeconds' => <integer>,
            'healthCheckTimeoutSeconds' => <integer>,
            'healthyThresholdCount' => <integer>,
            'matcher' => [
                'httpCode' => '<string>',
            ],
            'path' => '<string>',
            'port' => <integer>,
            'protocol' => 'HTTP|HTTPS|TCP',
            'protocolVersion' => 'HTTP1|HTTP2',
            'unhealthyThresholdCount' => <integer>,
        ],
        'ipAddressType' => 'IPV4|IPV6',
        'lambdaEventStructureVersion' => 'V1|V2',
        'port' => <integer>,
        'protocol' => 'HTTP|HTTPS|TCP',
        'protocolVersion' => 'HTTP1|HTTP2|GRPC',
        'vpcIdentifier' => '<string>',
    ],
    'createdAt' => <DateTime>,
    'failureCode' => '<string>',
    'failureMessage' => '<string>',
    'id' => '<string>',
    'lastUpdatedAt' => <DateTime>,
    'name' => '<string>',
    'serviceArns' => ['<string>', ...],
    'status' => 'CREATE_IN_PROGRESS|ACTIVE|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
    'type' => 'IP|LAMBDA|INSTANCE|ALB',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

ListAccessLogSubscriptions

$result = $client->listAccessLogSubscriptions([/* ... */]);
$promise = $client->listAccessLogSubscriptionsAsync([/* ... */]);

Lists the access log subscriptions for the specified service network or service.

Parameter Syntax

$result = $client->listAccessLogSubscriptions([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'resourceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'items' => [
        [
            'arn' => '<string>',
            'createdAt' => <DateTime>,
            'destinationArn' => '<string>',
            'id' => '<string>',
            'lastUpdatedAt' => <DateTime>,
            'resourceArn' => '<string>',
            'resourceId' => '<string>',
            'serviceNetworkLogType' => 'SERVICE|RESOURCE',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

ListListeners

$result = $client->listListeners([/* ... */]);
$promise = $client->listListenersAsync([/* ... */]);

Lists the listeners for the specified service.

Parameter Syntax

$result = $client->listListeners([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'serviceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'items' => [
        [
            'arn' => '<string>',
            'createdAt' => <DateTime>,
            'id' => '<string>',
            'lastUpdatedAt' => <DateTime>,
            'name' => '<string>',
            'port' => <integer>,
            'protocol' => 'HTTP|HTTPS|TLS_PASSTHROUGH',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

ListResourceConfigurations

$result = $client->listResourceConfigurations([/* ... */]);
$promise = $client->listResourceConfigurationsAsync([/* ... */]);

Lists the resource configurations owned by or shared with this account.

Parameter Syntax

$result = $client->listResourceConfigurations([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'resourceConfigurationGroupIdentifier' => '<string>',
    'resourceGatewayIdentifier' => '<string>',
]);

Parameter Details

Result Syntax

[
    'items' => [
        [
            'amazonManaged' => true || false,
            'arn' => '<string>',
            'createdAt' => <DateTime>,
            'id' => '<string>',
            'lastUpdatedAt' => <DateTime>,
            'name' => '<string>',
            'resourceConfigurationGroupId' => '<string>',
            'resourceGatewayId' => '<string>',
            'status' => 'ACTIVE|CREATE_IN_PROGRESS|UPDATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|UPDATE_FAILED|DELETE_FAILED',
            'type' => 'GROUP|CHILD|SINGLE|ARN',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

ListResourceEndpointAssociations

$result = $client->listResourceEndpointAssociations([/* ... */]);
$promise = $client->listResourceEndpointAssociationsAsync([/* ... */]);

Lists the associations for the specified VPC endpoint.

Parameter Syntax

$result = $client->listResourceEndpointAssociations([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'resourceConfigurationIdentifier' => '<string>', // REQUIRED
    'resourceEndpointAssociationIdentifier' => '<string>',
    'vpcEndpointId' => '<string>',
    'vpcEndpointOwner' => '<string>',
]);

Parameter Details

Result Syntax

[
    'items' => [
        [
            'arn' => '<string>',
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'id' => '<string>',
            'resourceConfigurationArn' => '<string>',
            'resourceConfigurationId' => '<string>',
            'resourceConfigurationName' => '<string>',
            'vpcEndpointId' => '<string>',
            'vpcEndpointOwner' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

ListResourceGateways

$result = $client->listResourceGateways([/* ... */]);
$promise = $client->listResourceGatewaysAsync([/* ... */]);

Lists the resource gateways that you own or that were shared with you.

Parameter Syntax

$result = $client->listResourceGateways([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'items' => [
        [
            'arn' => '<string>',
            'createdAt' => <DateTime>,
            'id' => '<string>',
            'ipAddressType' => 'IPV4|IPV6|DUALSTACK',
            'lastUpdatedAt' => <DateTime>,
            'name' => '<string>',
            'securityGroupIds' => ['<string>', ...],
            'status' => 'ACTIVE|CREATE_IN_PROGRESS|UPDATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|UPDATE_FAILED|DELETE_FAILED',
            'subnetIds' => ['<string>', ...],
            'vpcIdentifier' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

ListRules

$result = $client->listRules([/* ... */]);
$promise = $client->listRulesAsync([/* ... */]);

Lists the rules for the specified listener.

Parameter Syntax

$result = $client->listRules([
    'listenerIdentifier' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'serviceIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'items' => [
        [
            'arn' => '<string>',
            'createdAt' => <DateTime>,
            'id' => '<string>',
            'isDefault' => true || false,
            'lastUpdatedAt' => <DateTime>,
            'name' => '<string>',
            'priority' => <integer>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

ResourceNotFoundException:

The request references a resource that does not exist.

InternalServerException:

An unexpected error occurred while processing the request.

ListServiceNetworkResourceAssociations

$result = $client->listServiceNetworkResourceAssociations([/* ... */]);
$promise = $client->listServiceNetworkResourceAssociationsAsync([/* ... */]);

Lists the associations between a service network and a resource configuration.

Parameter Syntax

$result = $client->listServiceNetworkResourceAssociations([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'resourceConfigurationIdentifier' => '<string>',
    'serviceNetworkIdentifier' => '<string>',
]);

Parameter Details

Result Syntax

[
    'items' => [
        [
            'arn' => '<string>',
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'dnsEntry' => [
                'domainName' => '<string>',
                'hostedZoneId' => '<string>',
            ],
            'failureCode' => '<string>',
            'id' => '<string>',
            'isManagedAssociation' => true || false,
            'privateDnsEntry' => [
                'domainName' => '<string>',
                'hostedZoneId' => '<string>',
            ],
            'resourceConfigurationArn' => '<string>',
            'resourceConfigurationId' => '<string>',
            'resourceConfigurationName' => '<string>',
            'serviceNetworkArn' => '<string>',
            'serviceNetworkId' => '<string>',
            'serviceNetworkName' => '<string>',
            'status' => 'CREATE_IN_PROGRESS|ACTIVE|PARTIAL|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

ListServiceNetworkServiceAssociations

$result = $client->listServiceNetworkServiceAssociations([/* ... */]);
$promise = $client->listServiceNetworkServiceAssociationsAsync([/* ... */]);

Lists the associations between a service network and a service. You can filter the list either by service or service network. You must provide either the service network identifier or the service identifier.

Every association in Amazon VPC Lattice has a unique Amazon Resource Name (ARN), such as when a service network is associated with a VPC or when a service is associated with a service network. If the association is for a resource is shared with another account, the association includes the local account ID as the prefix in the ARN.

Parameter Syntax

$result = $client->listServiceNetworkServiceAssociations([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'serviceIdentifier' => '<string>',
    'serviceNetworkIdentifier' => '<string>',
]);

Parameter Details

Result Syntax

[
    'items' => [
        [
            'arn' => '<string>',
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'customDomainName' => '<string>',
            'dnsEntry' => [
                'domainName' => '<string>',
                'hostedZoneId' => '<string>',
            ],
            'id' => '<string>',
            'serviceArn' => '<string>',
            'serviceId' => '<string>',
            'serviceName' => '<string>',
            'serviceNetworkArn' => '<string>',
            'serviceNetworkId' => '<string>',
            'serviceNetworkName' => '<string>',
            'status' => 'CREATE_IN_PROGRESS|ACTIVE|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

ListServiceNetworkVpcAssociations

$result = $client->listServiceNetworkVpcAssociations([/* ... */]);
$promise = $client->listServiceNetworkVpcAssociationsAsync([/* ... */]);

Lists the associations between a service network and a VPC. You can filter the list either by VPC or service network. You must provide either the ID of the service network identifier or the ID of the VPC.

Parameter Syntax

$result = $client->listServiceNetworkVpcAssociations([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'serviceNetworkIdentifier' => '<string>',
    'vpcIdentifier' => '<string>',
]);

Parameter Details

Result Syntax

[
    'items' => [
        [
            'arn' => '<string>',
            'createdAt' => <DateTime>,
            'createdBy' => '<string>',
            'id' => '<string>',
            'lastUpdatedAt' => <DateTime>,
            'serviceNetworkArn' => '<string>',
            'serviceNetworkId' => '<string>',
            'serviceNetworkName' => '<string>',
            'status' => 'CREATE_IN_PROGRESS|ACTIVE|UPDATE_IN_PROGRESS|DELETE_IN_PROGRESS|CREATE_FAILED|DELETE_FAILED|UPDATE_FAILED',
            'vpcId' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

ListServiceNetworkVpcEndpointAssociations

$result = $client->listServiceNetworkVpcEndpointAssociations([/* ... */]);
$promise = $client->listServiceNetworkVpcEndpointAssociationsAsync([/* ... */]);

Lists the associations between a service network and a VPC endpoint.

Parameter Syntax

$result = $client->listServiceNetworkVpcEndpointAssociations([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'serviceNetworkIdentifier' => '<string>', // REQUIRED
]);

Parameter Details

Result Syntax

[
    'items' => [
        [
            'createdAt' => <DateTime>,
            'id' => '<string>',
            'serviceNetworkArn' => '<string>',
            'state' => '<string>',
            'vpcEndpointId' => '<string>',
            'vpcEndpointOwnerId' => '<string>',
            'vpcId' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

ListServiceNetworks

$result = $client->listServiceNetworks([/* ... */]);
$promise = $client->listServiceNetworksAsync([/* ... */]);

Lists the service networks owned by or shared with this account. The account ID in the ARN shows which account owns the service network.

Parameter Syntax

$result = $client->listServiceNetworks([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Result Syntax

[
    'items' => [
        [
            'arn' => '<string>',
            'createdAt' => <DateTime>,
            'id' => '<string>',
            'lastUpdatedAt' => <DateTime>,
            'name' => '<string>',
            'numberOfAssociatedResourceConfigurations' => <integer>,
            'numberOfAssociatedServices' => <integer>,
            'numberOfAssociatedVPCs' => <integer>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Errors

ValidationException:

The input does not satisfy the constraints specified by an Amazon Web Services service.

AccessDeniedException:

The user does not have sufficient access to perform this action.

ThrottlingException:

The limit on the number of requests per second was exceeded.

InternalServerException:

An unexpected error occurred while processing the request.

ListServices

$result = $client->listServices([/* ... */]);
$promise = $client->listServicesAsync([/* ... */]);

Lists the services owned by the caller account or shared with the caller account.

Parameter Syntax

$result = $client->listServices([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details