@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSAppMeshAsyncClient extends AWSAppMeshClient implements AWSAppMeshAsync
AsyncHandler can be used to receive
notification when an asynchronous operation completes.
AWS App Mesh is a service mesh based on the Envoy proxy that makes it easy to monitor and control containerized microservices. App Mesh standardizes how your microservices communicate, giving you end-to-end visibility and helping to ensure high-availability for your applications.
App Mesh gives you consistent visibility and network traffic controls for every microservice in an application. You can use App Mesh with Amazon ECS (using the Amazon EC2 launch type), Amazon EKS, and Kubernetes on AWS.
App Mesh supports containerized microservice applications that use service discovery naming for their components. To
use App Mesh, you must have a containerized application running on Amazon EC2 instances, hosted in either Amazon ECS,
Amazon EKS, or Kubernetes on AWS. For more information about service discovery on Amazon ECS, see Service Discovery in the
Amazon Elastic Container Service Developer Guide. Kubernetes kube-dns is supported. For more
information, see DNS for Services
and Pods in the Kubernetes documentation.
LOGGING_AWS_REQUEST_METRICENDPOINT_PREFIXbuilder, createMesh, createRoute, createVirtualNode, createVirtualRouter, deleteMesh, deleteRoute, deleteVirtualNode, deleteVirtualRouter, describeMesh, describeRoute, describeVirtualNode, describeVirtualRouter, getCachedResponseMetadata, listMeshes, listRoutes, listVirtualNodes, listVirtualRouters, updateRoute, updateVirtualNode, updateVirtualRouteraddRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffsetequals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitcreateMesh, createRoute, createVirtualNode, createVirtualRouter, deleteMesh, deleteRoute, deleteVirtualNode, deleteVirtualRouter, describeMesh, describeRoute, describeVirtualNode, describeVirtualRouter, getCachedResponseMetadata, listMeshes, listRoutes, listVirtualNodes, listVirtualRouters, updateRoute, updateVirtualNode, updateVirtualRouterpublic static AWSAppMeshAsyncClientBuilder asyncBuilder()
public ExecutorService getExecutorService()
public Future<CreateMeshResult> createMeshAsync(CreateMeshRequest request)
AWSAppMeshAsyncCreates a new service mesh. A service mesh is a logical boundary for network traffic between the services that reside within it.
After you create your service mesh, you can create virtual nodes, virtual routers, and routes to distribute traffic between the applications in your mesh.
createMeshAsync in interface AWSAppMeshAsyncpublic Future<CreateMeshResult> createMeshAsync(CreateMeshRequest request, AsyncHandler<CreateMeshRequest,CreateMeshResult> asyncHandler)
AWSAppMeshAsyncCreates a new service mesh. A service mesh is a logical boundary for network traffic between the services that reside within it.
After you create your service mesh, you can create virtual nodes, virtual routers, and routes to distribute traffic between the applications in your mesh.
createMeshAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateRouteResult> createRouteAsync(CreateRouteRequest request)
AWSAppMeshAsyncCreates a new route that is associated with a virtual router.
You can use the prefix parameter in your route specification for path-based routing of requests. For
example, if your virtual router service name is my-service.local, and you want the route to match
requests to my-service.local/metrics, then your prefix should be /metrics.
If your route matches a request, you can distribute traffic to one or more target virtual nodes with relative weighting.
createRouteAsync in interface AWSAppMeshAsyncpublic Future<CreateRouteResult> createRouteAsync(CreateRouteRequest request, AsyncHandler<CreateRouteRequest,CreateRouteResult> asyncHandler)
AWSAppMeshAsyncCreates a new route that is associated with a virtual router.
You can use the prefix parameter in your route specification for path-based routing of requests. For
example, if your virtual router service name is my-service.local, and you want the route to match
requests to my-service.local/metrics, then your prefix should be /metrics.
If your route matches a request, you can distribute traffic to one or more target virtual nodes with relative weighting.
createRouteAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateVirtualNodeResult> createVirtualNodeAsync(CreateVirtualNodeRequest request)
AWSAppMeshAsyncCreates a new virtual node within a service mesh.
A virtual node acts as logical pointer to a particular task group, such as an Amazon ECS service or a Kubernetes deployment. When you create a virtual node, you must specify the DNS service discovery name for your task group.
Any inbound traffic that your virtual node expects should be specified as a listener. Any outbound
traffic that your virtual node expects to reach should be specified as a backend.
The response metadata for your new virtual node contains the arn that is associated with the virtual
node. Set this value (either the full ARN or the truncated resource name, for example,
mesh/default/virtualNode/simpleapp, as the APPMESH_VIRTUAL_NODE_NAME environment
variable for your task group's Envoy proxy container in your task definition or pod spec. This is then mapped to
the node.id and node.cluster Envoy parameters.
If you require your Envoy stats or tracing to use a different name, you can override the
node.cluster value that is set by APPMESH_VIRTUAL_NODE_NAME with the
APPMESH_VIRTUAL_NODE_CLUSTER environment variable.
createVirtualNodeAsync in interface AWSAppMeshAsyncpublic Future<CreateVirtualNodeResult> createVirtualNodeAsync(CreateVirtualNodeRequest request, AsyncHandler<CreateVirtualNodeRequest,CreateVirtualNodeResult> asyncHandler)
AWSAppMeshAsyncCreates a new virtual node within a service mesh.
A virtual node acts as logical pointer to a particular task group, such as an Amazon ECS service or a Kubernetes deployment. When you create a virtual node, you must specify the DNS service discovery name for your task group.
Any inbound traffic that your virtual node expects should be specified as a listener. Any outbound
traffic that your virtual node expects to reach should be specified as a backend.
The response metadata for your new virtual node contains the arn that is associated with the virtual
node. Set this value (either the full ARN or the truncated resource name, for example,
mesh/default/virtualNode/simpleapp, as the APPMESH_VIRTUAL_NODE_NAME environment
variable for your task group's Envoy proxy container in your task definition or pod spec. This is then mapped to
the node.id and node.cluster Envoy parameters.
If you require your Envoy stats or tracing to use a different name, you can override the
node.cluster value that is set by APPMESH_VIRTUAL_NODE_NAME with the
APPMESH_VIRTUAL_NODE_CLUSTER environment variable.
createVirtualNodeAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateVirtualRouterResult> createVirtualRouterAsync(CreateVirtualRouterRequest request)
AWSAppMeshAsyncCreates a new virtual router within a service mesh.
Virtual routers handle traffic for one or more service names within your mesh. After you create your virtual router, create and associate routes for your virtual router that direct incoming requests to different virtual nodes.
createVirtualRouterAsync in interface AWSAppMeshAsyncpublic Future<CreateVirtualRouterResult> createVirtualRouterAsync(CreateVirtualRouterRequest request, AsyncHandler<CreateVirtualRouterRequest,CreateVirtualRouterResult> asyncHandler)
AWSAppMeshAsyncCreates a new virtual router within a service mesh.
Virtual routers handle traffic for one or more service names within your mesh. After you create your virtual router, create and associate routes for your virtual router that direct incoming requests to different virtual nodes.
createVirtualRouterAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteMeshResult> deleteMeshAsync(DeleteMeshRequest request)
AWSAppMeshAsyncDeletes an existing service mesh.
You must delete all resources (routes, virtual routers, virtual nodes) in the service mesh before you can delete the mesh itself.
deleteMeshAsync in interface AWSAppMeshAsyncpublic Future<DeleteMeshResult> deleteMeshAsync(DeleteMeshRequest request, AsyncHandler<DeleteMeshRequest,DeleteMeshResult> asyncHandler)
AWSAppMeshAsyncDeletes an existing service mesh.
You must delete all resources (routes, virtual routers, virtual nodes) in the service mesh before you can delete the mesh itself.
deleteMeshAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteRouteResult> deleteRouteAsync(DeleteRouteRequest request)
AWSAppMeshAsyncDeletes an existing route.
deleteRouteAsync in interface AWSAppMeshAsyncpublic Future<DeleteRouteResult> deleteRouteAsync(DeleteRouteRequest request, AsyncHandler<DeleteRouteRequest,DeleteRouteResult> asyncHandler)
AWSAppMeshAsyncDeletes an existing route.
deleteRouteAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteVirtualNodeResult> deleteVirtualNodeAsync(DeleteVirtualNodeRequest request)
AWSAppMeshAsyncDeletes an existing virtual node.
deleteVirtualNodeAsync in interface AWSAppMeshAsyncpublic Future<DeleteVirtualNodeResult> deleteVirtualNodeAsync(DeleteVirtualNodeRequest request, AsyncHandler<DeleteVirtualNodeRequest,DeleteVirtualNodeResult> asyncHandler)
AWSAppMeshAsyncDeletes an existing virtual node.
deleteVirtualNodeAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteVirtualRouterResult> deleteVirtualRouterAsync(DeleteVirtualRouterRequest request)
AWSAppMeshAsyncDeletes an existing virtual router.
You must delete any routes associated with the virtual router before you can delete the router itself.
deleteVirtualRouterAsync in interface AWSAppMeshAsyncpublic Future<DeleteVirtualRouterResult> deleteVirtualRouterAsync(DeleteVirtualRouterRequest request, AsyncHandler<DeleteVirtualRouterRequest,DeleteVirtualRouterResult> asyncHandler)
AWSAppMeshAsyncDeletes an existing virtual router.
You must delete any routes associated with the virtual router before you can delete the router itself.
deleteVirtualRouterAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DescribeMeshResult> describeMeshAsync(DescribeMeshRequest request)
AWSAppMeshAsyncDescribes an existing service mesh.
describeMeshAsync in interface AWSAppMeshAsyncpublic Future<DescribeMeshResult> describeMeshAsync(DescribeMeshRequest request, AsyncHandler<DescribeMeshRequest,DescribeMeshResult> asyncHandler)
AWSAppMeshAsyncDescribes an existing service mesh.
describeMeshAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DescribeRouteResult> describeRouteAsync(DescribeRouteRequest request)
AWSAppMeshAsyncDescribes an existing route.
describeRouteAsync in interface AWSAppMeshAsyncpublic Future<DescribeRouteResult> describeRouteAsync(DescribeRouteRequest request, AsyncHandler<DescribeRouteRequest,DescribeRouteResult> asyncHandler)
AWSAppMeshAsyncDescribes an existing route.
describeRouteAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DescribeVirtualNodeResult> describeVirtualNodeAsync(DescribeVirtualNodeRequest request)
AWSAppMeshAsyncDescribes an existing virtual node.
describeVirtualNodeAsync in interface AWSAppMeshAsyncpublic Future<DescribeVirtualNodeResult> describeVirtualNodeAsync(DescribeVirtualNodeRequest request, AsyncHandler<DescribeVirtualNodeRequest,DescribeVirtualNodeResult> asyncHandler)
AWSAppMeshAsyncDescribes an existing virtual node.
describeVirtualNodeAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DescribeVirtualRouterResult> describeVirtualRouterAsync(DescribeVirtualRouterRequest request)
AWSAppMeshAsyncDescribes an existing virtual router.
describeVirtualRouterAsync in interface AWSAppMeshAsyncpublic Future<DescribeVirtualRouterResult> describeVirtualRouterAsync(DescribeVirtualRouterRequest request, AsyncHandler<DescribeVirtualRouterRequest,DescribeVirtualRouterResult> asyncHandler)
AWSAppMeshAsyncDescribes an existing virtual router.
describeVirtualRouterAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListMeshesResult> listMeshesAsync(ListMeshesRequest request)
AWSAppMeshAsyncReturns a list of existing service meshes.
listMeshesAsync in interface AWSAppMeshAsyncpublic Future<ListMeshesResult> listMeshesAsync(ListMeshesRequest request, AsyncHandler<ListMeshesRequest,ListMeshesResult> asyncHandler)
AWSAppMeshAsyncReturns a list of existing service meshes.
listMeshesAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListRoutesResult> listRoutesAsync(ListRoutesRequest request)
AWSAppMeshAsyncReturns a list of existing routes in a service mesh.
listRoutesAsync in interface AWSAppMeshAsyncpublic Future<ListRoutesResult> listRoutesAsync(ListRoutesRequest request, AsyncHandler<ListRoutesRequest,ListRoutesResult> asyncHandler)
AWSAppMeshAsyncReturns a list of existing routes in a service mesh.
listRoutesAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListVirtualNodesResult> listVirtualNodesAsync(ListVirtualNodesRequest request)
AWSAppMeshAsyncReturns a list of existing virtual nodes.
listVirtualNodesAsync in interface AWSAppMeshAsyncpublic Future<ListVirtualNodesResult> listVirtualNodesAsync(ListVirtualNodesRequest request, AsyncHandler<ListVirtualNodesRequest,ListVirtualNodesResult> asyncHandler)
AWSAppMeshAsyncReturns a list of existing virtual nodes.
listVirtualNodesAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListVirtualRoutersResult> listVirtualRoutersAsync(ListVirtualRoutersRequest request)
AWSAppMeshAsyncReturns a list of existing virtual routers in a service mesh.
listVirtualRoutersAsync in interface AWSAppMeshAsyncpublic Future<ListVirtualRoutersResult> listVirtualRoutersAsync(ListVirtualRoutersRequest request, AsyncHandler<ListVirtualRoutersRequest,ListVirtualRoutersResult> asyncHandler)
AWSAppMeshAsyncReturns a list of existing virtual routers in a service mesh.
listVirtualRoutersAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateRouteResult> updateRouteAsync(UpdateRouteRequest request)
AWSAppMeshAsyncUpdates an existing route for a specified service mesh and virtual router.
updateRouteAsync in interface AWSAppMeshAsyncpublic Future<UpdateRouteResult> updateRouteAsync(UpdateRouteRequest request, AsyncHandler<UpdateRouteRequest,UpdateRouteResult> asyncHandler)
AWSAppMeshAsyncUpdates an existing route for a specified service mesh and virtual router.
updateRouteAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateVirtualNodeResult> updateVirtualNodeAsync(UpdateVirtualNodeRequest request)
AWSAppMeshAsyncUpdates an existing virtual node in a specified service mesh.
updateVirtualNodeAsync in interface AWSAppMeshAsyncpublic Future<UpdateVirtualNodeResult> updateVirtualNodeAsync(UpdateVirtualNodeRequest request, AsyncHandler<UpdateVirtualNodeRequest,UpdateVirtualNodeResult> asyncHandler)
AWSAppMeshAsyncUpdates an existing virtual node in a specified service mesh.
updateVirtualNodeAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateVirtualRouterResult> updateVirtualRouterAsync(UpdateVirtualRouterRequest request)
AWSAppMeshAsyncUpdates an existing virtual router in a specified service mesh.
updateVirtualRouterAsync in interface AWSAppMeshAsyncpublic Future<UpdateVirtualRouterResult> updateVirtualRouterAsync(UpdateVirtualRouterRequest request, AsyncHandler<UpdateVirtualRouterRequest,UpdateVirtualRouterResult> asyncHandler)
AWSAppMeshAsyncUpdates an existing virtual router in a specified service mesh.
updateVirtualRouterAsync in interface AWSAppMeshAsyncasyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public void shutdown()
getExecutorService().shutdown() followed by getExecutorService().awaitTermination() prior to
calling this method.shutdown in interface AWSAppMeshshutdown in class AmazonWebServiceClientCopyright © 2013 Amazon Web Services, Inc. All Rights Reserved.