AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates a virtual gateway.

A virtual gateway allows resources outside your mesh to communicate to resources that are inside your mesh. The virtual gateway represents an Envoy proxy running in an Amazon ECS task, in a Kubernetes service, or on an Amazon EC2 instance. Unlike a virtual node, which represents an Envoy running with an application, a virtual gateway represents Envoy deployed by itself.

For more information about virtual gateways, see Virtual gateways.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateVirtualGateway and EndCreateVirtualGateway.

Namespace: Amazon.AppMesh
Assembly: AWSSDK.AppMesh.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<CreateVirtualGatewayResponse> CreateVirtualGatewayAsync(
         CreateVirtualGatewayRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.AppMesh.Model.CreateVirtualGatewayRequest

Container for the necessary parameters to execute the CreateVirtualGateway service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the CreateVirtualGateway service method, as returned by AppMesh.

Exceptions

ExceptionCondition
BadRequestException The request syntax was malformed. Check your request syntax and try again.
ConflictException The request contains a client token that was used for a previous update resource call with different specifications. Try the request again with a new client token.
ForbiddenException You don't have permissions to perform this action.
InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
LimitExceededException You have exceeded a service limit for your account. For more information, see Service Limits in the App Mesh User Guide.
NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
ServiceUnavailableException The request has failed due to a temporary failure of the service.
TooManyRequestsException The maximum request rate permitted by the App Mesh APIs has been exceeded for your account. For best results, use an increasing or variable sleep interval between requests.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also