All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.amazonaws.services.appmesh.AWSAppMeshAsync Maven / Gradle / Ivy

/*
 * Copyright 2014-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
 * the License. A copy of the License is located at
 * 
 * http://aws.amazon.com/apache2.0
 * 
 * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
 * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
 * and limitations under the License.
 */
package com.amazonaws.services.appmesh;

import javax.annotation.Generated;

import com.amazonaws.services.appmesh.model.*;

/**
 * Interface for accessing AWS App Mesh asynchronously. Each asynchronous method will return a Java Future object
 * representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive
 * notification when an asynchronous operation completes.
 * 

* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.appmesh.AbstractAWSAppMeshAsync} instead. *

*

*

* 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. *

*
*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AWSAppMeshAsync extends AWSAppMesh { /** *

* Creates 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. *

* * @param createMeshRequest * @return A Java Future containing the result of the CreateMesh operation returned by the service. * @sample AWSAppMeshAsync.CreateMesh * @see AWS API * Documentation */ java.util.concurrent.Future createMeshAsync(CreateMeshRequest createMeshRequest); /** *

* Creates 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. *

* * @param createMeshRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the CreateMesh operation returned by the service. * @sample AWSAppMeshAsyncHandler.CreateMesh * @see AWS API * Documentation */ java.util.concurrent.Future createMeshAsync(CreateMeshRequest createMeshRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Creates 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. *

* * @param createRouteRequest * @return A Java Future containing the result of the CreateRoute operation returned by the service. * @sample AWSAppMeshAsync.CreateRoute * @see AWS API * Documentation */ java.util.concurrent.Future createRouteAsync(CreateRouteRequest createRouteRequest); /** *

* Creates 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. *

* * @param createRouteRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the CreateRoute operation returned by the service. * @sample AWSAppMeshAsyncHandler.CreateRoute * @see AWS API * Documentation */ java.util.concurrent.Future createRouteAsync(CreateRouteRequest createRouteRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Creates 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. *

*
* * @param createVirtualNodeRequest * @return A Java Future containing the result of the CreateVirtualNode operation returned by the service. * @sample AWSAppMeshAsync.CreateVirtualNode * @see AWS API * Documentation */ java.util.concurrent.Future createVirtualNodeAsync(CreateVirtualNodeRequest createVirtualNodeRequest); /** *

* Creates 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. *

*
* * @param createVirtualNodeRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the CreateVirtualNode operation returned by the service. * @sample AWSAppMeshAsyncHandler.CreateVirtualNode * @see AWS API * Documentation */ java.util.concurrent.Future createVirtualNodeAsync(CreateVirtualNodeRequest createVirtualNodeRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Creates 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. *

* * @param createVirtualRouterRequest * @return A Java Future containing the result of the CreateVirtualRouter operation returned by the service. * @sample AWSAppMeshAsync.CreateVirtualRouter * @see AWS * API Documentation */ java.util.concurrent.Future createVirtualRouterAsync(CreateVirtualRouterRequest createVirtualRouterRequest); /** *

* Creates 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. *

* * @param createVirtualRouterRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the CreateVirtualRouter operation returned by the service. * @sample AWSAppMeshAsyncHandler.CreateVirtualRouter * @see AWS * API Documentation */ java.util.concurrent.Future createVirtualRouterAsync(CreateVirtualRouterRequest createVirtualRouterRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Deletes 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. *

* * @param deleteMeshRequest * @return A Java Future containing the result of the DeleteMesh operation returned by the service. * @sample AWSAppMeshAsync.DeleteMesh * @see AWS API * Documentation */ java.util.concurrent.Future deleteMeshAsync(DeleteMeshRequest deleteMeshRequest); /** *

* Deletes 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. *

* * @param deleteMeshRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the DeleteMesh operation returned by the service. * @sample AWSAppMeshAsyncHandler.DeleteMesh * @see AWS API * Documentation */ java.util.concurrent.Future deleteMeshAsync(DeleteMeshRequest deleteMeshRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Deletes an existing route. *

* * @param deleteRouteRequest * @return A Java Future containing the result of the DeleteRoute operation returned by the service. * @sample AWSAppMeshAsync.DeleteRoute * @see AWS API * Documentation */ java.util.concurrent.Future deleteRouteAsync(DeleteRouteRequest deleteRouteRequest); /** *

* Deletes an existing route. *

* * @param deleteRouteRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the DeleteRoute operation returned by the service. * @sample AWSAppMeshAsyncHandler.DeleteRoute * @see AWS API * Documentation */ java.util.concurrent.Future deleteRouteAsync(DeleteRouteRequest deleteRouteRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Deletes an existing virtual node. *

* * @param deleteVirtualNodeRequest * @return A Java Future containing the result of the DeleteVirtualNode operation returned by the service. * @sample AWSAppMeshAsync.DeleteVirtualNode * @see AWS API * Documentation */ java.util.concurrent.Future deleteVirtualNodeAsync(DeleteVirtualNodeRequest deleteVirtualNodeRequest); /** *

* Deletes an existing virtual node. *

* * @param deleteVirtualNodeRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the DeleteVirtualNode operation returned by the service. * @sample AWSAppMeshAsyncHandler.DeleteVirtualNode * @see AWS API * Documentation */ java.util.concurrent.Future deleteVirtualNodeAsync(DeleteVirtualNodeRequest deleteVirtualNodeRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Deletes an existing virtual router. *

*

* You must delete any routes associated with the virtual router before you can delete the router itself. *

* * @param deleteVirtualRouterRequest * @return A Java Future containing the result of the DeleteVirtualRouter operation returned by the service. * @sample AWSAppMeshAsync.DeleteVirtualRouter * @see AWS * API Documentation */ java.util.concurrent.Future deleteVirtualRouterAsync(DeleteVirtualRouterRequest deleteVirtualRouterRequest); /** *

* Deletes an existing virtual router. *

*

* You must delete any routes associated with the virtual router before you can delete the router itself. *

* * @param deleteVirtualRouterRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the DeleteVirtualRouter operation returned by the service. * @sample AWSAppMeshAsyncHandler.DeleteVirtualRouter * @see AWS * API Documentation */ java.util.concurrent.Future deleteVirtualRouterAsync(DeleteVirtualRouterRequest deleteVirtualRouterRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Describes an existing service mesh. *

* * @param describeMeshRequest * @return A Java Future containing the result of the DescribeMesh operation returned by the service. * @sample AWSAppMeshAsync.DescribeMesh * @see AWS API * Documentation */ java.util.concurrent.Future describeMeshAsync(DescribeMeshRequest describeMeshRequest); /** *

* Describes an existing service mesh. *

* * @param describeMeshRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the DescribeMesh operation returned by the service. * @sample AWSAppMeshAsyncHandler.DescribeMesh * @see AWS API * Documentation */ java.util.concurrent.Future describeMeshAsync(DescribeMeshRequest describeMeshRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Describes an existing route. *

* * @param describeRouteRequest * @return A Java Future containing the result of the DescribeRoute operation returned by the service. * @sample AWSAppMeshAsync.DescribeRoute * @see AWS API * Documentation */ java.util.concurrent.Future describeRouteAsync(DescribeRouteRequest describeRouteRequest); /** *

* Describes an existing route. *

* * @param describeRouteRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the DescribeRoute operation returned by the service. * @sample AWSAppMeshAsyncHandler.DescribeRoute * @see AWS API * Documentation */ java.util.concurrent.Future describeRouteAsync(DescribeRouteRequest describeRouteRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Describes an existing virtual node. *

* * @param describeVirtualNodeRequest * @return A Java Future containing the result of the DescribeVirtualNode operation returned by the service. * @sample AWSAppMeshAsync.DescribeVirtualNode * @see AWS * API Documentation */ java.util.concurrent.Future describeVirtualNodeAsync(DescribeVirtualNodeRequest describeVirtualNodeRequest); /** *

* Describes an existing virtual node. *

* * @param describeVirtualNodeRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the DescribeVirtualNode operation returned by the service. * @sample AWSAppMeshAsyncHandler.DescribeVirtualNode * @see AWS * API Documentation */ java.util.concurrent.Future describeVirtualNodeAsync(DescribeVirtualNodeRequest describeVirtualNodeRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Describes an existing virtual router. *

* * @param describeVirtualRouterRequest * @return A Java Future containing the result of the DescribeVirtualRouter operation returned by the service. * @sample AWSAppMeshAsync.DescribeVirtualRouter * @see AWS * API Documentation */ java.util.concurrent.Future describeVirtualRouterAsync(DescribeVirtualRouterRequest describeVirtualRouterRequest); /** *

* Describes an existing virtual router. *

* * @param describeVirtualRouterRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the DescribeVirtualRouter operation returned by the service. * @sample AWSAppMeshAsyncHandler.DescribeVirtualRouter * @see AWS * API Documentation */ java.util.concurrent.Future describeVirtualRouterAsync(DescribeVirtualRouterRequest describeVirtualRouterRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns a list of existing service meshes. *

* * @param listMeshesRequest * @return A Java Future containing the result of the ListMeshes operation returned by the service. * @sample AWSAppMeshAsync.ListMeshes * @see AWS API * Documentation */ java.util.concurrent.Future listMeshesAsync(ListMeshesRequest listMeshesRequest); /** *

* Returns a list of existing service meshes. *

* * @param listMeshesRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the ListMeshes operation returned by the service. * @sample AWSAppMeshAsyncHandler.ListMeshes * @see AWS API * Documentation */ java.util.concurrent.Future listMeshesAsync(ListMeshesRequest listMeshesRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns a list of existing routes in a service mesh. *

* * @param listRoutesRequest * @return A Java Future containing the result of the ListRoutes operation returned by the service. * @sample AWSAppMeshAsync.ListRoutes * @see AWS API * Documentation */ java.util.concurrent.Future listRoutesAsync(ListRoutesRequest listRoutesRequest); /** *

* Returns a list of existing routes in a service mesh. *

* * @param listRoutesRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the ListRoutes operation returned by the service. * @sample AWSAppMeshAsyncHandler.ListRoutes * @see AWS API * Documentation */ java.util.concurrent.Future listRoutesAsync(ListRoutesRequest listRoutesRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns a list of existing virtual nodes. *

* * @param listVirtualNodesRequest * @return A Java Future containing the result of the ListVirtualNodes operation returned by the service. * @sample AWSAppMeshAsync.ListVirtualNodes * @see AWS API * Documentation */ java.util.concurrent.Future listVirtualNodesAsync(ListVirtualNodesRequest listVirtualNodesRequest); /** *

* Returns a list of existing virtual nodes. *

* * @param listVirtualNodesRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the ListVirtualNodes operation returned by the service. * @sample AWSAppMeshAsyncHandler.ListVirtualNodes * @see AWS API * Documentation */ java.util.concurrent.Future listVirtualNodesAsync(ListVirtualNodesRequest listVirtualNodesRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns a list of existing virtual routers in a service mesh. *

* * @param listVirtualRoutersRequest * @return A Java Future containing the result of the ListVirtualRouters operation returned by the service. * @sample AWSAppMeshAsync.ListVirtualRouters * @see AWS API * Documentation */ java.util.concurrent.Future listVirtualRoutersAsync(ListVirtualRoutersRequest listVirtualRoutersRequest); /** *

* Returns a list of existing virtual routers in a service mesh. *

* * @param listVirtualRoutersRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the ListVirtualRouters operation returned by the service. * @sample AWSAppMeshAsyncHandler.ListVirtualRouters * @see AWS API * Documentation */ java.util.concurrent.Future listVirtualRoutersAsync(ListVirtualRoutersRequest listVirtualRoutersRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Updates an existing route for a specified service mesh and virtual router. *

* * @param updateRouteRequest * @return A Java Future containing the result of the UpdateRoute operation returned by the service. * @sample AWSAppMeshAsync.UpdateRoute * @see AWS API * Documentation */ java.util.concurrent.Future updateRouteAsync(UpdateRouteRequest updateRouteRequest); /** *

* Updates an existing route for a specified service mesh and virtual router. *

* * @param updateRouteRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the UpdateRoute operation returned by the service. * @sample AWSAppMeshAsyncHandler.UpdateRoute * @see AWS API * Documentation */ java.util.concurrent.Future updateRouteAsync(UpdateRouteRequest updateRouteRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Updates an existing virtual node in a specified service mesh. *

* * @param updateVirtualNodeRequest * @return A Java Future containing the result of the UpdateVirtualNode operation returned by the service. * @sample AWSAppMeshAsync.UpdateVirtualNode * @see AWS API * Documentation */ java.util.concurrent.Future updateVirtualNodeAsync(UpdateVirtualNodeRequest updateVirtualNodeRequest); /** *

* Updates an existing virtual node in a specified service mesh. *

* * @param updateVirtualNodeRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the UpdateVirtualNode operation returned by the service. * @sample AWSAppMeshAsyncHandler.UpdateVirtualNode * @see AWS API * Documentation */ java.util.concurrent.Future updateVirtualNodeAsync(UpdateVirtualNodeRequest updateVirtualNodeRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Updates an existing virtual router in a specified service mesh. *

* * @param updateVirtualRouterRequest * @return A Java Future containing the result of the UpdateVirtualRouter operation returned by the service. * @sample AWSAppMeshAsync.UpdateVirtualRouter * @see AWS * API Documentation */ java.util.concurrent.Future updateVirtualRouterAsync(UpdateVirtualRouterRequest updateVirtualRouterRequest); /** *

* Updates an existing virtual router in a specified service mesh. *

* * @param updateVirtualRouterRequest * @param asyncHandler * 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. * @return A Java Future containing the result of the UpdateVirtualRouter operation returned by the service. * @sample AWSAppMeshAsyncHandler.UpdateVirtualRouter * @see AWS * API Documentation */ java.util.concurrent.Future updateVirtualRouterAsync(UpdateVirtualRouterRequest updateVirtualRouterRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); }




© 2015 - 2025 Weber Informatics LLC | Privacy Policy