Interface AppMeshAsyncClient

All Superinterfaces:
AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient

@Generated("software.amazon.awssdk:codegen") @ThreadSafe public interface AppMeshAsyncClient extends AwsClient
Service client for accessing AWS App Mesh asynchronously. This can be created using the static builder() method.

App Mesh is a service mesh based on the Envoy proxy that makes it easy to monitor and control 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 Web Services Fargate, Amazon ECS, Amazon EKS, Kubernetes on Amazon Web Services, and Amazon EC2.

App Mesh supports microservice applications that use service discovery naming for their components. For more information about service discovery on Amazon ECS, see Service Discovery in the Amazon Elastic Container Service Developer Guide. Kubernetes kube-dns and coredns are supported. For more information, see DNS for Services and Pods in the Kubernetes documentation.

  • Field Details

  • Method Details

    • createGatewayRoute

      default CompletableFuture<CreateGatewayRouteResponse> createGatewayRoute(CreateGatewayRouteRequest createGatewayRouteRequest)

      Creates a gateway route.

      A gateway route is attached to a virtual gateway and routes traffic to an existing virtual service. If a route matches a request, it can distribute traffic to a target virtual service.

      For more information about gateway routes, see Gateway routes.

      Parameters:
      createGatewayRouteRequest -
      Returns:
      A Java Future containing the result of the CreateGatewayRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createGatewayRoute

      default CompletableFuture<CreateGatewayRouteResponse> createGatewayRoute(Consumer<CreateGatewayRouteRequest.Builder> createGatewayRouteRequest)

      Creates a gateway route.

      A gateway route is attached to a virtual gateway and routes traffic to an existing virtual service. If a route matches a request, it can distribute traffic to a target virtual service.

      For more information about gateway routes, see Gateway routes.


      This is a convenience which creates an instance of the CreateGatewayRouteRequest.Builder avoiding the need to create one manually via CreateGatewayRouteRequest.builder()

      Parameters:
      createGatewayRouteRequest - A Consumer that will call methods on CreateGatewayRouteRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateGatewayRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createMesh

      default CompletableFuture<CreateMeshResponse> createMesh(CreateMeshRequest createMeshRequest)

      Creates a service mesh.

      A service mesh is a logical boundary for network traffic between services that are represented by resources within the mesh. After you create your service mesh, you can create virtual services, virtual nodes, virtual routers, and routes to distribute traffic between the applications in your mesh.

      For more information about service meshes, see Service meshes.

      Parameters:
      createMeshRequest -
      Returns:
      A Java Future containing the result of the CreateMesh operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createMesh

      default CompletableFuture<CreateMeshResponse> createMesh(Consumer<CreateMeshRequest.Builder> createMeshRequest)

      Creates a service mesh.

      A service mesh is a logical boundary for network traffic between services that are represented by resources within the mesh. After you create your service mesh, you can create virtual services, virtual nodes, virtual routers, and routes to distribute traffic between the applications in your mesh.

      For more information about service meshes, see Service meshes.


      This is a convenience which creates an instance of the CreateMeshRequest.Builder avoiding the need to create one manually via CreateMeshRequest.builder()

      Parameters:
      createMeshRequest - A Consumer that will call methods on CreateMeshRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateMesh operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createRoute

      default CompletableFuture<CreateRouteResponse> createRoute(CreateRouteRequest createRouteRequest)

      Creates a route that is associated with a virtual router.

      You can route several different protocols and define a retry policy for a route. Traffic can be routed to one or more virtual nodes.

      For more information about routes, see Routes.

      Parameters:
      createRouteRequest -
      Returns:
      A Java Future containing the result of the CreateRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createRoute

      default CompletableFuture<CreateRouteResponse> createRoute(Consumer<CreateRouteRequest.Builder> createRouteRequest)

      Creates a route that is associated with a virtual router.

      You can route several different protocols and define a retry policy for a route. Traffic can be routed to one or more virtual nodes.

      For more information about routes, see Routes.


      This is a convenience which creates an instance of the CreateRouteRequest.Builder avoiding the need to create one manually via CreateRouteRequest.builder()

      Parameters:
      createRouteRequest - A Consumer that will call methods on CreateRouteRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createVirtualGateway

      default CompletableFuture<CreateVirtualGatewayResponse> createVirtualGateway(CreateVirtualGatewayRequest createVirtualGatewayRequest)

      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.

      Parameters:
      createVirtualGatewayRequest -
      Returns:
      A Java Future containing the result of the CreateVirtualGateway operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createVirtualGateway

      default CompletableFuture<CreateVirtualGatewayResponse> createVirtualGateway(Consumer<CreateVirtualGatewayRequest.Builder> createVirtualGatewayRequest)

      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.


      This is a convenience which creates an instance of the CreateVirtualGatewayRequest.Builder avoiding the need to create one manually via CreateVirtualGatewayRequest.builder()

      Parameters:
      createVirtualGatewayRequest - A Consumer that will call methods on CreateVirtualGatewayRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateVirtualGateway operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createVirtualNode

      default CompletableFuture<CreateVirtualNodeResponse> createVirtualNode(CreateVirtualNodeRequest createVirtualNodeRequest)

      Creates a virtual node within a service mesh.

      A virtual node acts as a logical pointer to a particular task group, such as an Amazon ECS service or a Kubernetes deployment. When you create a virtual node, you can specify the service discovery information for your task group, and whether the proxy running in a task group will communicate with other proxies using Transport Layer Security (TLS).

      You define a listener for any inbound traffic that your virtual node expects. Any virtual service that your virtual node expects to communicate to is 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 to the full ARN; for example, arn:aws:appmesh:us-west-2:123456789012:myMesh/default/virtualNode/myApp) as the APPMESH_RESOURCE_ARN 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.

      By default, App Mesh uses the name of the resource you specified in APPMESH_RESOURCE_ARN when Envoy is referring to itself in metrics and traces. You can override this behavior by setting the APPMESH_RESOURCE_CLUSTER environment variable with your own name.

      For more information about virtual nodes, see Virtual nodes. You must be using 1.15.0 or later of the Envoy image when setting these variables. For more information aboutApp Mesh Envoy variables, see Envoy image in the App Mesh User Guide.

      Parameters:
      createVirtualNodeRequest -
      Returns:
      A Java Future containing the result of the CreateVirtualNode operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createVirtualNode

      default CompletableFuture<CreateVirtualNodeResponse> createVirtualNode(Consumer<CreateVirtualNodeRequest.Builder> createVirtualNodeRequest)

      Creates a virtual node within a service mesh.

      A virtual node acts as a logical pointer to a particular task group, such as an Amazon ECS service or a Kubernetes deployment. When you create a virtual node, you can specify the service discovery information for your task group, and whether the proxy running in a task group will communicate with other proxies using Transport Layer Security (TLS).

      You define a listener for any inbound traffic that your virtual node expects. Any virtual service that your virtual node expects to communicate to is 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 to the full ARN; for example, arn:aws:appmesh:us-west-2:123456789012:myMesh/default/virtualNode/myApp) as the APPMESH_RESOURCE_ARN 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.

      By default, App Mesh uses the name of the resource you specified in APPMESH_RESOURCE_ARN when Envoy is referring to itself in metrics and traces. You can override this behavior by setting the APPMESH_RESOURCE_CLUSTER environment variable with your own name.

      For more information about virtual nodes, see Virtual nodes. You must be using 1.15.0 or later of the Envoy image when setting these variables. For more information aboutApp Mesh Envoy variables, see Envoy image in the App Mesh User Guide.


      This is a convenience which creates an instance of the CreateVirtualNodeRequest.Builder avoiding the need to create one manually via CreateVirtualNodeRequest.builder()

      Parameters:
      createVirtualNodeRequest - A Consumer that will call methods on CreateVirtualNodeRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateVirtualNode operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createVirtualRouter

      default CompletableFuture<CreateVirtualRouterResponse> createVirtualRouter(CreateVirtualRouterRequest createVirtualRouterRequest)

      Creates a virtual router within a service mesh.

      Specify a listener for any inbound traffic that your virtual router receives. Create a virtual router for each protocol and port that you need to route. Virtual routers handle traffic for one or more virtual services 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.

      For more information about virtual routers, see Virtual routers.

      Parameters:
      createVirtualRouterRequest -
      Returns:
      A Java Future containing the result of the CreateVirtualRouter operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createVirtualRouter

      default CompletableFuture<CreateVirtualRouterResponse> createVirtualRouter(Consumer<CreateVirtualRouterRequest.Builder> createVirtualRouterRequest)

      Creates a virtual router within a service mesh.

      Specify a listener for any inbound traffic that your virtual router receives. Create a virtual router for each protocol and port that you need to route. Virtual routers handle traffic for one or more virtual services 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.

      For more information about virtual routers, see Virtual routers.


      This is a convenience which creates an instance of the CreateVirtualRouterRequest.Builder avoiding the need to create one manually via CreateVirtualRouterRequest.builder()

      Parameters:
      createVirtualRouterRequest - A Consumer that will call methods on CreateVirtualRouterRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateVirtualRouter operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createVirtualService

      default CompletableFuture<CreateVirtualServiceResponse> createVirtualService(CreateVirtualServiceRequest createVirtualServiceRequest)

      Creates a virtual service within a service mesh.

      A virtual service is an abstraction of a real service that is provided by a virtual node directly or indirectly by means of a virtual router. Dependent services call your virtual service by its virtualServiceName , and those requests are routed to the virtual node or virtual router that is specified as the provider for the virtual service.

      For more information about virtual services, see Virtual services.

      Parameters:
      createVirtualServiceRequest -
      Returns:
      A Java Future containing the result of the CreateVirtualService operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • createVirtualService

      default CompletableFuture<CreateVirtualServiceResponse> createVirtualService(Consumer<CreateVirtualServiceRequest.Builder> createVirtualServiceRequest)

      Creates a virtual service within a service mesh.

      A virtual service is an abstraction of a real service that is provided by a virtual node directly or indirectly by means of a virtual router. Dependent services call your virtual service by its virtualServiceName , and those requests are routed to the virtual node or virtual router that is specified as the provider for the virtual service.

      For more information about virtual services, see Virtual services.


      This is a convenience which creates an instance of the CreateVirtualServiceRequest.Builder avoiding the need to create one manually via CreateVirtualServiceRequest.builder()

      Parameters:
      createVirtualServiceRequest - A Consumer that will call methods on CreateVirtualServiceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateVirtualService operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteGatewayRoute

      default CompletableFuture<DeleteGatewayRouteResponse> deleteGatewayRoute(DeleteGatewayRouteRequest deleteGatewayRouteRequest)

      Deletes an existing gateway route.

      Parameters:
      deleteGatewayRouteRequest -
      Returns:
      A Java Future containing the result of the DeleteGatewayRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteGatewayRoute

      default CompletableFuture<DeleteGatewayRouteResponse> deleteGatewayRoute(Consumer<DeleteGatewayRouteRequest.Builder> deleteGatewayRouteRequest)

      Deletes an existing gateway route.


      This is a convenience which creates an instance of the DeleteGatewayRouteRequest.Builder avoiding the need to create one manually via DeleteGatewayRouteRequest.builder()

      Parameters:
      deleteGatewayRouteRequest - A Consumer that will call methods on DeleteGatewayRouteRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteGatewayRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteMesh

      default CompletableFuture<DeleteMeshResponse> deleteMesh(DeleteMeshRequest deleteMeshRequest)

      Deletes an existing service mesh.

      You must delete all resources (virtual services, routes, virtual routers, and virtual nodes) in the service mesh before you can delete the mesh itself.

      Parameters:
      deleteMeshRequest -
      Returns:
      A Java Future containing the result of the DeleteMesh operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteMesh

      default CompletableFuture<DeleteMeshResponse> deleteMesh(Consumer<DeleteMeshRequest.Builder> deleteMeshRequest)

      Deletes an existing service mesh.

      You must delete all resources (virtual services, routes, virtual routers, and virtual nodes) in the service mesh before you can delete the mesh itself.


      This is a convenience which creates an instance of the DeleteMeshRequest.Builder avoiding the need to create one manually via DeleteMeshRequest.builder()

      Parameters:
      deleteMeshRequest - A Consumer that will call methods on DeleteMeshRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteMesh operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteRoute

      default CompletableFuture<DeleteRouteResponse> deleteRoute(DeleteRouteRequest deleteRouteRequest)

      Deletes an existing route.

      Parameters:
      deleteRouteRequest -
      Returns:
      A Java Future containing the result of the DeleteRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteRoute

      default CompletableFuture<DeleteRouteResponse> deleteRoute(Consumer<DeleteRouteRequest.Builder> deleteRouteRequest)

      Deletes an existing route.


      This is a convenience which creates an instance of the DeleteRouteRequest.Builder avoiding the need to create one manually via DeleteRouteRequest.builder()

      Parameters:
      deleteRouteRequest - A Consumer that will call methods on DeleteRouteRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteVirtualGateway

      default CompletableFuture<DeleteVirtualGatewayResponse> deleteVirtualGateway(DeleteVirtualGatewayRequest deleteVirtualGatewayRequest)

      Deletes an existing virtual gateway. You cannot delete a virtual gateway if any gateway routes are associated to it.

      Parameters:
      deleteVirtualGatewayRequest -
      Returns:
      A Java Future containing the result of the DeleteVirtualGateway operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteVirtualGateway

      default CompletableFuture<DeleteVirtualGatewayResponse> deleteVirtualGateway(Consumer<DeleteVirtualGatewayRequest.Builder> deleteVirtualGatewayRequest)

      Deletes an existing virtual gateway. You cannot delete a virtual gateway if any gateway routes are associated to it.


      This is a convenience which creates an instance of the DeleteVirtualGatewayRequest.Builder avoiding the need to create one manually via DeleteVirtualGatewayRequest.builder()

      Parameters:
      deleteVirtualGatewayRequest - A Consumer that will call methods on DeleteVirtualGatewayRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteVirtualGateway operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteVirtualNode

      default CompletableFuture<DeleteVirtualNodeResponse> deleteVirtualNode(DeleteVirtualNodeRequest deleteVirtualNodeRequest)

      Deletes an existing virtual node.

      You must delete any virtual services that list a virtual node as a service provider before you can delete the virtual node itself.

      Parameters:
      deleteVirtualNodeRequest - Deletes a virtual node input.
      Returns:
      A Java Future containing the result of the DeleteVirtualNode operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteVirtualNode

      default CompletableFuture<DeleteVirtualNodeResponse> deleteVirtualNode(Consumer<DeleteVirtualNodeRequest.Builder> deleteVirtualNodeRequest)

      Deletes an existing virtual node.

      You must delete any virtual services that list a virtual node as a service provider before you can delete the virtual node itself.


      This is a convenience which creates an instance of the DeleteVirtualNodeRequest.Builder avoiding the need to create one manually via DeleteVirtualNodeRequest.builder()

      Parameters:
      deleteVirtualNodeRequest - A Consumer that will call methods on DeleteVirtualNodeRequest.Builder to create a request. Deletes a virtual node input.
      Returns:
      A Java Future containing the result of the DeleteVirtualNode operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteVirtualRouter

      default CompletableFuture<DeleteVirtualRouterResponse> deleteVirtualRouter(DeleteVirtualRouterRequest deleteVirtualRouterRequest)

      Deletes an existing virtual router.

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

      Parameters:
      deleteVirtualRouterRequest -
      Returns:
      A Java Future containing the result of the DeleteVirtualRouter operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteVirtualRouter

      default CompletableFuture<DeleteVirtualRouterResponse> deleteVirtualRouter(Consumer<DeleteVirtualRouterRequest.Builder> deleteVirtualRouterRequest)

      Deletes an existing virtual router.

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


      This is a convenience which creates an instance of the DeleteVirtualRouterRequest.Builder avoiding the need to create one manually via DeleteVirtualRouterRequest.builder()

      Parameters:
      deleteVirtualRouterRequest - A Consumer that will call methods on DeleteVirtualRouterRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteVirtualRouter operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteVirtualService

      default CompletableFuture<DeleteVirtualServiceResponse> deleteVirtualService(DeleteVirtualServiceRequest deleteVirtualServiceRequest)

      Deletes an existing virtual service.

      Parameters:
      deleteVirtualServiceRequest -
      Returns:
      A Java Future containing the result of the DeleteVirtualService operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • deleteVirtualService

      default CompletableFuture<DeleteVirtualServiceResponse> deleteVirtualService(Consumer<DeleteVirtualServiceRequest.Builder> deleteVirtualServiceRequest)

      Deletes an existing virtual service.


      This is a convenience which creates an instance of the DeleteVirtualServiceRequest.Builder avoiding the need to create one manually via DeleteVirtualServiceRequest.builder()

      Parameters:
      deleteVirtualServiceRequest - A Consumer that will call methods on DeleteVirtualServiceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteVirtualService operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ResourceInUseException You can't delete the specified resource because it's in use or required by another resource.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeGatewayRoute

      default CompletableFuture<DescribeGatewayRouteResponse> describeGatewayRoute(DescribeGatewayRouteRequest describeGatewayRouteRequest)

      Describes an existing gateway route.

      Parameters:
      describeGatewayRouteRequest -
      Returns:
      A Java Future containing the result of the DescribeGatewayRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeGatewayRoute

      default CompletableFuture<DescribeGatewayRouteResponse> describeGatewayRoute(Consumer<DescribeGatewayRouteRequest.Builder> describeGatewayRouteRequest)

      Describes an existing gateway route.


      This is a convenience which creates an instance of the DescribeGatewayRouteRequest.Builder avoiding the need to create one manually via DescribeGatewayRouteRequest.builder()

      Parameters:
      describeGatewayRouteRequest - A Consumer that will call methods on DescribeGatewayRouteRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeGatewayRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeMesh

      default CompletableFuture<DescribeMeshResponse> describeMesh(DescribeMeshRequest describeMeshRequest)

      Describes an existing service mesh.

      Parameters:
      describeMeshRequest -
      Returns:
      A Java Future containing the result of the DescribeMesh operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeMesh

      default CompletableFuture<DescribeMeshResponse> describeMesh(Consumer<DescribeMeshRequest.Builder> describeMeshRequest)

      Describes an existing service mesh.


      This is a convenience which creates an instance of the DescribeMeshRequest.Builder avoiding the need to create one manually via DescribeMeshRequest.builder()

      Parameters:
      describeMeshRequest - A Consumer that will call methods on DescribeMeshRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeMesh operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeRoute

      default CompletableFuture<DescribeRouteResponse> describeRoute(DescribeRouteRequest describeRouteRequest)

      Describes an existing route.

      Parameters:
      describeRouteRequest -
      Returns:
      A Java Future containing the result of the DescribeRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeRoute

      default CompletableFuture<DescribeRouteResponse> describeRoute(Consumer<DescribeRouteRequest.Builder> describeRouteRequest)

      Describes an existing route.


      This is a convenience which creates an instance of the DescribeRouteRequest.Builder avoiding the need to create one manually via DescribeRouteRequest.builder()

      Parameters:
      describeRouteRequest - A Consumer that will call methods on DescribeRouteRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeVirtualGateway

      default CompletableFuture<DescribeVirtualGatewayResponse> describeVirtualGateway(DescribeVirtualGatewayRequest describeVirtualGatewayRequest)

      Describes an existing virtual gateway.

      Parameters:
      describeVirtualGatewayRequest -
      Returns:
      A Java Future containing the result of the DescribeVirtualGateway operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeVirtualGateway

      default CompletableFuture<DescribeVirtualGatewayResponse> describeVirtualGateway(Consumer<DescribeVirtualGatewayRequest.Builder> describeVirtualGatewayRequest)

      Describes an existing virtual gateway.


      This is a convenience which creates an instance of the DescribeVirtualGatewayRequest.Builder avoiding the need to create one manually via DescribeVirtualGatewayRequest.builder()

      Parameters:
      describeVirtualGatewayRequest - A Consumer that will call methods on DescribeVirtualGatewayRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeVirtualGateway operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeVirtualNode

      default CompletableFuture<DescribeVirtualNodeResponse> describeVirtualNode(DescribeVirtualNodeRequest describeVirtualNodeRequest)

      Describes an existing virtual node.

      Parameters:
      describeVirtualNodeRequest -
      Returns:
      A Java Future containing the result of the DescribeVirtualNode operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeVirtualNode

      default CompletableFuture<DescribeVirtualNodeResponse> describeVirtualNode(Consumer<DescribeVirtualNodeRequest.Builder> describeVirtualNodeRequest)

      Describes an existing virtual node.


      This is a convenience which creates an instance of the DescribeVirtualNodeRequest.Builder avoiding the need to create one manually via DescribeVirtualNodeRequest.builder()

      Parameters:
      describeVirtualNodeRequest - A Consumer that will call methods on DescribeVirtualNodeRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeVirtualNode operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeVirtualRouter

      default CompletableFuture<DescribeVirtualRouterResponse> describeVirtualRouter(DescribeVirtualRouterRequest describeVirtualRouterRequest)

      Describes an existing virtual router.

      Parameters:
      describeVirtualRouterRequest -
      Returns:
      A Java Future containing the result of the DescribeVirtualRouter operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeVirtualRouter

      default CompletableFuture<DescribeVirtualRouterResponse> describeVirtualRouter(Consumer<DescribeVirtualRouterRequest.Builder> describeVirtualRouterRequest)

      Describes an existing virtual router.


      This is a convenience which creates an instance of the DescribeVirtualRouterRequest.Builder avoiding the need to create one manually via DescribeVirtualRouterRequest.builder()

      Parameters:
      describeVirtualRouterRequest - A Consumer that will call methods on DescribeVirtualRouterRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeVirtualRouter operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeVirtualService

      default CompletableFuture<DescribeVirtualServiceResponse> describeVirtualService(DescribeVirtualServiceRequest describeVirtualServiceRequest)

      Describes an existing virtual service.

      Parameters:
      describeVirtualServiceRequest -
      Returns:
      A Java Future containing the result of the DescribeVirtualService operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • describeVirtualService

      default CompletableFuture<DescribeVirtualServiceResponse> describeVirtualService(Consumer<DescribeVirtualServiceRequest.Builder> describeVirtualServiceRequest)

      Describes an existing virtual service.


      This is a convenience which creates an instance of the DescribeVirtualServiceRequest.Builder avoiding the need to create one manually via DescribeVirtualServiceRequest.builder()

      Parameters:
      describeVirtualServiceRequest - A Consumer that will call methods on DescribeVirtualServiceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeVirtualService operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listGatewayRoutes

      default CompletableFuture<ListGatewayRoutesResponse> listGatewayRoutes(ListGatewayRoutesRequest listGatewayRoutesRequest)

      Returns a list of existing gateway routes that are associated to a virtual gateway.

      Parameters:
      listGatewayRoutesRequest -
      Returns:
      A Java Future containing the result of the ListGatewayRoutes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listGatewayRoutes

      default CompletableFuture<ListGatewayRoutesResponse> listGatewayRoutes(Consumer<ListGatewayRoutesRequest.Builder> listGatewayRoutesRequest)

      Returns a list of existing gateway routes that are associated to a virtual gateway.


      This is a convenience which creates an instance of the ListGatewayRoutesRequest.Builder avoiding the need to create one manually via ListGatewayRoutesRequest.builder()

      Parameters:
      listGatewayRoutesRequest - A Consumer that will call methods on ListGatewayRoutesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListGatewayRoutes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listGatewayRoutesPaginator

      default ListGatewayRoutesPublisher listGatewayRoutesPaginator(ListGatewayRoutesRequest listGatewayRoutesRequest)

      This is a variant of listGatewayRoutes(software.amazon.awssdk.services.appmesh.model.ListGatewayRoutesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListGatewayRoutesPublisher publisher = client.listGatewayRoutesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListGatewayRoutesPublisher publisher = client.listGatewayRoutesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListGatewayRoutesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListGatewayRoutesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listGatewayRoutes(software.amazon.awssdk.services.appmesh.model.ListGatewayRoutesRequest) operation.

      Parameters:
      listGatewayRoutesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listGatewayRoutesPaginator

      default ListGatewayRoutesPublisher listGatewayRoutesPaginator(Consumer<ListGatewayRoutesRequest.Builder> listGatewayRoutesRequest)

      This is a variant of listGatewayRoutes(software.amazon.awssdk.services.appmesh.model.ListGatewayRoutesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListGatewayRoutesPublisher publisher = client.listGatewayRoutesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListGatewayRoutesPublisher publisher = client.listGatewayRoutesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListGatewayRoutesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListGatewayRoutesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listGatewayRoutes(software.amazon.awssdk.services.appmesh.model.ListGatewayRoutesRequest) operation.


      This is a convenience which creates an instance of the ListGatewayRoutesRequest.Builder avoiding the need to create one manually via ListGatewayRoutesRequest.builder()

      Parameters:
      listGatewayRoutesRequest - A Consumer that will call methods on ListGatewayRoutesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listMeshes

      default CompletableFuture<ListMeshesResponse> listMeshes(ListMeshesRequest listMeshesRequest)

      Returns a list of existing service meshes.

      Parameters:
      listMeshesRequest -
      Returns:
      A Java Future containing the result of the ListMeshes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listMeshes

      default CompletableFuture<ListMeshesResponse> listMeshes(Consumer<ListMeshesRequest.Builder> listMeshesRequest)

      Returns a list of existing service meshes.


      This is a convenience which creates an instance of the ListMeshesRequest.Builder avoiding the need to create one manually via ListMeshesRequest.builder()

      Parameters:
      listMeshesRequest - A Consumer that will call methods on ListMeshesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListMeshes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listMeshes

      default CompletableFuture<ListMeshesResponse> listMeshes()

      Returns a list of existing service meshes.

      Returns:
      A Java Future containing the result of the ListMeshes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listMeshesPaginator

      default ListMeshesPublisher listMeshesPaginator()

      This is a variant of listMeshes(software.amazon.awssdk.services.appmesh.model.ListMeshesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListMeshesPublisher publisher = client.listMeshesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListMeshesPublisher publisher = client.listMeshesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListMeshesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListMeshesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listMeshes(software.amazon.awssdk.services.appmesh.model.ListMeshesRequest) operation.

      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listMeshesPaginator

      default ListMeshesPublisher listMeshesPaginator(ListMeshesRequest listMeshesRequest)

      This is a variant of listMeshes(software.amazon.awssdk.services.appmesh.model.ListMeshesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListMeshesPublisher publisher = client.listMeshesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListMeshesPublisher publisher = client.listMeshesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListMeshesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListMeshesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listMeshes(software.amazon.awssdk.services.appmesh.model.ListMeshesRequest) operation.

      Parameters:
      listMeshesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listMeshesPaginator

      default ListMeshesPublisher listMeshesPaginator(Consumer<ListMeshesRequest.Builder> listMeshesRequest)

      This is a variant of listMeshes(software.amazon.awssdk.services.appmesh.model.ListMeshesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListMeshesPublisher publisher = client.listMeshesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListMeshesPublisher publisher = client.listMeshesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListMeshesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListMeshesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listMeshes(software.amazon.awssdk.services.appmesh.model.ListMeshesRequest) operation.


      This is a convenience which creates an instance of the ListMeshesRequest.Builder avoiding the need to create one manually via ListMeshesRequest.builder()

      Parameters:
      listMeshesRequest - A Consumer that will call methods on ListMeshesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listRoutes

      default CompletableFuture<ListRoutesResponse> listRoutes(ListRoutesRequest listRoutesRequest)

      Returns a list of existing routes in a service mesh.

      Parameters:
      listRoutesRequest -
      Returns:
      A Java Future containing the result of the ListRoutes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listRoutes

      default CompletableFuture<ListRoutesResponse> listRoutes(Consumer<ListRoutesRequest.Builder> listRoutesRequest)

      Returns a list of existing routes in a service mesh.


      This is a convenience which creates an instance of the ListRoutesRequest.Builder avoiding the need to create one manually via ListRoutesRequest.builder()

      Parameters:
      listRoutesRequest - A Consumer that will call methods on ListRoutesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListRoutes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listRoutesPaginator

      default ListRoutesPublisher listRoutesPaginator(ListRoutesRequest listRoutesRequest)

      This is a variant of listRoutes(software.amazon.awssdk.services.appmesh.model.ListRoutesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListRoutesPublisher publisher = client.listRoutesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListRoutesPublisher publisher = client.listRoutesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListRoutesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListRoutesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listRoutes(software.amazon.awssdk.services.appmesh.model.ListRoutesRequest) operation.

      Parameters:
      listRoutesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listRoutesPaginator

      default ListRoutesPublisher listRoutesPaginator(Consumer<ListRoutesRequest.Builder> listRoutesRequest)

      This is a variant of listRoutes(software.amazon.awssdk.services.appmesh.model.ListRoutesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListRoutesPublisher publisher = client.listRoutesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListRoutesPublisher publisher = client.listRoutesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListRoutesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListRoutesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listRoutes(software.amazon.awssdk.services.appmesh.model.ListRoutesRequest) operation.


      This is a convenience which creates an instance of the ListRoutesRequest.Builder avoiding the need to create one manually via ListRoutesRequest.builder()

      Parameters:
      listRoutesRequest - A Consumer that will call methods on ListRoutesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listTagsForResource

      default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)

      List the tags for an App Mesh resource.

      Parameters:
      listTagsForResourceRequest -
      Returns:
      A Java Future containing the result of the ListTagsForResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listTagsForResource

      default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)

      List the tags for an App Mesh resource.


      This is a convenience which creates an instance of the ListTagsForResourceRequest.Builder avoiding the need to create one manually via ListTagsForResourceRequest.builder()

      Parameters:
      listTagsForResourceRequest - A Consumer that will call methods on ListTagsForResourceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListTagsForResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listTagsForResourcePaginator

      default ListTagsForResourcePublisher listTagsForResourcePaginator(ListTagsForResourceRequest listTagsForResourceRequest)

      This is a variant of listTagsForResource(software.amazon.awssdk.services.appmesh.model.ListTagsForResourceRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListTagsForResourcePublisher publisher = client.listTagsForResourcePaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListTagsForResourcePublisher publisher = client.listTagsForResourcePaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListTagsForResourceResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListTagsForResourceResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listTagsForResource(software.amazon.awssdk.services.appmesh.model.ListTagsForResourceRequest) operation.

      Parameters:
      listTagsForResourceRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listTagsForResourcePaginator

      default ListTagsForResourcePublisher listTagsForResourcePaginator(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)

      This is a variant of listTagsForResource(software.amazon.awssdk.services.appmesh.model.ListTagsForResourceRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListTagsForResourcePublisher publisher = client.listTagsForResourcePaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListTagsForResourcePublisher publisher = client.listTagsForResourcePaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListTagsForResourceResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListTagsForResourceResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listTagsForResource(software.amazon.awssdk.services.appmesh.model.ListTagsForResourceRequest) operation.


      This is a convenience which creates an instance of the ListTagsForResourceRequest.Builder avoiding the need to create one manually via ListTagsForResourceRequest.builder()

      Parameters:
      listTagsForResourceRequest - A Consumer that will call methods on ListTagsForResourceRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualGateways

      default CompletableFuture<ListVirtualGatewaysResponse> listVirtualGateways(ListVirtualGatewaysRequest listVirtualGatewaysRequest)

      Returns a list of existing virtual gateways in a service mesh.

      Parameters:
      listVirtualGatewaysRequest -
      Returns:
      A Java Future containing the result of the ListVirtualGateways operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualGateways

      default CompletableFuture<ListVirtualGatewaysResponse> listVirtualGateways(Consumer<ListVirtualGatewaysRequest.Builder> listVirtualGatewaysRequest)

      Returns a list of existing virtual gateways in a service mesh.


      This is a convenience which creates an instance of the ListVirtualGatewaysRequest.Builder avoiding the need to create one manually via ListVirtualGatewaysRequest.builder()

      Parameters:
      listVirtualGatewaysRequest - A Consumer that will call methods on ListVirtualGatewaysRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListVirtualGateways operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualGatewaysPaginator

      default ListVirtualGatewaysPublisher listVirtualGatewaysPaginator(ListVirtualGatewaysRequest listVirtualGatewaysRequest)

      This is a variant of listVirtualGateways(software.amazon.awssdk.services.appmesh.model.ListVirtualGatewaysRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualGatewaysPublisher publisher = client.listVirtualGatewaysPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualGatewaysPublisher publisher = client.listVirtualGatewaysPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListVirtualGatewaysResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListVirtualGatewaysResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listVirtualGateways(software.amazon.awssdk.services.appmesh.model.ListVirtualGatewaysRequest) operation.

      Parameters:
      listVirtualGatewaysRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualGatewaysPaginator

      default ListVirtualGatewaysPublisher listVirtualGatewaysPaginator(Consumer<ListVirtualGatewaysRequest.Builder> listVirtualGatewaysRequest)

      This is a variant of listVirtualGateways(software.amazon.awssdk.services.appmesh.model.ListVirtualGatewaysRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualGatewaysPublisher publisher = client.listVirtualGatewaysPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualGatewaysPublisher publisher = client.listVirtualGatewaysPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListVirtualGatewaysResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListVirtualGatewaysResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listVirtualGateways(software.amazon.awssdk.services.appmesh.model.ListVirtualGatewaysRequest) operation.


      This is a convenience which creates an instance of the ListVirtualGatewaysRequest.Builder avoiding the need to create one manually via ListVirtualGatewaysRequest.builder()

      Parameters:
      listVirtualGatewaysRequest - A Consumer that will call methods on ListVirtualGatewaysRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualNodes

      default CompletableFuture<ListVirtualNodesResponse> listVirtualNodes(ListVirtualNodesRequest listVirtualNodesRequest)

      Returns a list of existing virtual nodes.

      Parameters:
      listVirtualNodesRequest -
      Returns:
      A Java Future containing the result of the ListVirtualNodes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualNodes

      default CompletableFuture<ListVirtualNodesResponse> listVirtualNodes(Consumer<ListVirtualNodesRequest.Builder> listVirtualNodesRequest)

      Returns a list of existing virtual nodes.


      This is a convenience which creates an instance of the ListVirtualNodesRequest.Builder avoiding the need to create one manually via ListVirtualNodesRequest.builder()

      Parameters:
      listVirtualNodesRequest - A Consumer that will call methods on ListVirtualNodesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListVirtualNodes operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualNodesPaginator

      default ListVirtualNodesPublisher listVirtualNodesPaginator(ListVirtualNodesRequest listVirtualNodesRequest)

      This is a variant of listVirtualNodes(software.amazon.awssdk.services.appmesh.model.ListVirtualNodesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualNodesPublisher publisher = client.listVirtualNodesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualNodesPublisher publisher = client.listVirtualNodesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListVirtualNodesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListVirtualNodesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listVirtualNodes(software.amazon.awssdk.services.appmesh.model.ListVirtualNodesRequest) operation.

      Parameters:
      listVirtualNodesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualNodesPaginator

      default ListVirtualNodesPublisher listVirtualNodesPaginator(Consumer<ListVirtualNodesRequest.Builder> listVirtualNodesRequest)

      This is a variant of listVirtualNodes(software.amazon.awssdk.services.appmesh.model.ListVirtualNodesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualNodesPublisher publisher = client.listVirtualNodesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualNodesPublisher publisher = client.listVirtualNodesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListVirtualNodesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListVirtualNodesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listVirtualNodes(software.amazon.awssdk.services.appmesh.model.ListVirtualNodesRequest) operation.


      This is a convenience which creates an instance of the ListVirtualNodesRequest.Builder avoiding the need to create one manually via ListVirtualNodesRequest.builder()

      Parameters:
      listVirtualNodesRequest - A Consumer that will call methods on ListVirtualNodesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualRouters

      default CompletableFuture<ListVirtualRoutersResponse> listVirtualRouters(ListVirtualRoutersRequest listVirtualRoutersRequest)

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

      Parameters:
      listVirtualRoutersRequest -
      Returns:
      A Java Future containing the result of the ListVirtualRouters operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualRouters

      default CompletableFuture<ListVirtualRoutersResponse> listVirtualRouters(Consumer<ListVirtualRoutersRequest.Builder> listVirtualRoutersRequest)

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


      This is a convenience which creates an instance of the ListVirtualRoutersRequest.Builder avoiding the need to create one manually via ListVirtualRoutersRequest.builder()

      Parameters:
      listVirtualRoutersRequest - A Consumer that will call methods on ListVirtualRoutersRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListVirtualRouters operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualRoutersPaginator

      default ListVirtualRoutersPublisher listVirtualRoutersPaginator(ListVirtualRoutersRequest listVirtualRoutersRequest)

      This is a variant of listVirtualRouters(software.amazon.awssdk.services.appmesh.model.ListVirtualRoutersRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualRoutersPublisher publisher = client.listVirtualRoutersPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualRoutersPublisher publisher = client.listVirtualRoutersPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListVirtualRoutersResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListVirtualRoutersResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listVirtualRouters(software.amazon.awssdk.services.appmesh.model.ListVirtualRoutersRequest) operation.

      Parameters:
      listVirtualRoutersRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualRoutersPaginator

      default ListVirtualRoutersPublisher listVirtualRoutersPaginator(Consumer<ListVirtualRoutersRequest.Builder> listVirtualRoutersRequest)

      This is a variant of listVirtualRouters(software.amazon.awssdk.services.appmesh.model.ListVirtualRoutersRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualRoutersPublisher publisher = client.listVirtualRoutersPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualRoutersPublisher publisher = client.listVirtualRoutersPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListVirtualRoutersResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListVirtualRoutersResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listVirtualRouters(software.amazon.awssdk.services.appmesh.model.ListVirtualRoutersRequest) operation.


      This is a convenience which creates an instance of the ListVirtualRoutersRequest.Builder avoiding the need to create one manually via ListVirtualRoutersRequest.builder()

      Parameters:
      listVirtualRoutersRequest - A Consumer that will call methods on ListVirtualRoutersRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualServices

      default CompletableFuture<ListVirtualServicesResponse> listVirtualServices(ListVirtualServicesRequest listVirtualServicesRequest)

      Returns a list of existing virtual services in a service mesh.

      Parameters:
      listVirtualServicesRequest -
      Returns:
      A Java Future containing the result of the ListVirtualServices operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualServices

      default CompletableFuture<ListVirtualServicesResponse> listVirtualServices(Consumer<ListVirtualServicesRequest.Builder> listVirtualServicesRequest)

      Returns a list of existing virtual services in a service mesh.


      This is a convenience which creates an instance of the ListVirtualServicesRequest.Builder avoiding the need to create one manually via ListVirtualServicesRequest.builder()

      Parameters:
      listVirtualServicesRequest - A Consumer that will call methods on ListVirtualServicesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListVirtualServices operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualServicesPaginator

      default ListVirtualServicesPublisher listVirtualServicesPaginator(ListVirtualServicesRequest listVirtualServicesRequest)

      This is a variant of listVirtualServices(software.amazon.awssdk.services.appmesh.model.ListVirtualServicesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualServicesPublisher publisher = client.listVirtualServicesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualServicesPublisher publisher = client.listVirtualServicesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListVirtualServicesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListVirtualServicesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listVirtualServices(software.amazon.awssdk.services.appmesh.model.ListVirtualServicesRequest) operation.

      Parameters:
      listVirtualServicesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • listVirtualServicesPaginator

      default ListVirtualServicesPublisher listVirtualServicesPaginator(Consumer<ListVirtualServicesRequest.Builder> listVirtualServicesRequest)

      This is a variant of listVirtualServices(software.amazon.awssdk.services.appmesh.model.ListVirtualServicesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualServicesPublisher publisher = client.listVirtualServicesPaginator(request);
       CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
       future.get();
       
       
      2) Using a custom subscriber
       
       software.amazon.awssdk.services.appmesh.paginators.ListVirtualServicesPublisher publisher = client.listVirtualServicesPaginator(request);
       publisher.subscribe(new Subscriber<software.amazon.awssdk.services.appmesh.model.ListVirtualServicesResponse>() {
       
       public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
       
       
       public void onNext(software.amazon.awssdk.services.appmesh.model.ListVirtualServicesResponse response) { //... };
       });
       
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of limit won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listVirtualServices(software.amazon.awssdk.services.appmesh.model.ListVirtualServicesRequest) operation.


      This is a convenience which creates an instance of the ListVirtualServicesRequest.Builder avoiding the need to create one manually via ListVirtualServicesRequest.builder()

      Parameters:
      listVirtualServicesRequest - A Consumer that will call methods on ListVirtualServicesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest)

      Associates the specified tags to a resource with the specified resourceArn. If existing tags on a resource aren't specified in the request parameters, they aren't changed. When a resource is deleted, the tags associated with that resource are also deleted.

      Parameters:
      tagResourceRequest -
      Returns:
      A Java Future containing the result of the TagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • TooManyTagsException The request exceeds the maximum allowed number of tags allowed per resource. The current limit is 50 user tags per resource. You must reduce the number of tags in the request. None of the tags in this request were applied.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)

      Associates the specified tags to a resource with the specified resourceArn. If existing tags on a resource aren't specified in the request parameters, they aren't changed. When a resource is deleted, the tags associated with that resource are also deleted.


      This is a convenience which creates an instance of the TagResourceRequest.Builder avoiding the need to create one manually via TagResourceRequest.builder()

      Parameters:
      tagResourceRequest - A Consumer that will call methods on TagResourceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the TagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • TooManyTagsException The request exceeds the maximum allowed number of tags allowed per resource. The current limit is 50 user tags per resource. You must reduce the number of tags in the request. None of the tags in this request were applied.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest)

      Deletes specified tags from a resource.

      Parameters:
      untagResourceRequest -
      Returns:
      A Java Future containing the result of the UntagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)

      Deletes specified tags from a resource.


      This is a convenience which creates an instance of the UntagResourceRequest.Builder avoiding the need to create one manually via UntagResourceRequest.builder()

      Parameters:
      untagResourceRequest - A Consumer that will call methods on UntagResourceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UntagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • BadRequestException The request syntax was malformed. Check your request syntax and try again.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateGatewayRoute

      default CompletableFuture<UpdateGatewayRouteResponse> updateGatewayRoute(UpdateGatewayRouteRequest updateGatewayRouteRequest)

      Updates an existing gateway route that is associated to a specified virtual gateway in a service mesh.

      Parameters:
      updateGatewayRouteRequest -
      Returns:
      A Java Future containing the result of the UpdateGatewayRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateGatewayRoute

      default CompletableFuture<UpdateGatewayRouteResponse> updateGatewayRoute(Consumer<UpdateGatewayRouteRequest.Builder> updateGatewayRouteRequest)

      Updates an existing gateway route that is associated to a specified virtual gateway in a service mesh.


      This is a convenience which creates an instance of the UpdateGatewayRouteRequest.Builder avoiding the need to create one manually via UpdateGatewayRouteRequest.builder()

      Parameters:
      updateGatewayRouteRequest - A Consumer that will call methods on UpdateGatewayRouteRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateGatewayRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateMesh

      default CompletableFuture<UpdateMeshResponse> updateMesh(UpdateMeshRequest updateMeshRequest)

      Updates an existing service mesh.

      Parameters:
      updateMeshRequest -
      Returns:
      A Java Future containing the result of the UpdateMesh operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateMesh

      default CompletableFuture<UpdateMeshResponse> updateMesh(Consumer<UpdateMeshRequest.Builder> updateMeshRequest)

      Updates an existing service mesh.


      This is a convenience which creates an instance of the UpdateMeshRequest.Builder avoiding the need to create one manually via UpdateMeshRequest.builder()

      Parameters:
      updateMeshRequest - A Consumer that will call methods on UpdateMeshRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateMesh operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • InternalServerErrorException The request processing has failed because of an unknown error, exception, or failure.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateRoute

      default CompletableFuture<UpdateRouteResponse> updateRoute(UpdateRouteRequest updateRouteRequest)

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

      Parameters:
      updateRouteRequest -
      Returns:
      A Java Future containing the result of the UpdateRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateRoute

      default CompletableFuture<UpdateRouteResponse> updateRoute(Consumer<UpdateRouteRequest.Builder> updateRouteRequest)

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


      This is a convenience which creates an instance of the UpdateRouteRequest.Builder avoiding the need to create one manually via UpdateRouteRequest.builder()

      Parameters:
      updateRouteRequest - A Consumer that will call methods on UpdateRouteRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateRoute operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateVirtualGateway

      default CompletableFuture<UpdateVirtualGatewayResponse> updateVirtualGateway(UpdateVirtualGatewayRequest updateVirtualGatewayRequest)

      Updates an existing virtual gateway in a specified service mesh.

      Parameters:
      updateVirtualGatewayRequest -
      Returns:
      A Java Future containing the result of the UpdateVirtualGateway operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateVirtualGateway

      default CompletableFuture<UpdateVirtualGatewayResponse> updateVirtualGateway(Consumer<UpdateVirtualGatewayRequest.Builder> updateVirtualGatewayRequest)

      Updates an existing virtual gateway in a specified service mesh.


      This is a convenience which creates an instance of the UpdateVirtualGatewayRequest.Builder avoiding the need to create one manually via UpdateVirtualGatewayRequest.builder()

      Parameters:
      updateVirtualGatewayRequest - A Consumer that will call methods on UpdateVirtualGatewayRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateVirtualGateway operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateVirtualNode

      default CompletableFuture<UpdateVirtualNodeResponse> updateVirtualNode(UpdateVirtualNodeRequest updateVirtualNodeRequest)

      Updates an existing virtual node in a specified service mesh.

      Parameters:
      updateVirtualNodeRequest -
      Returns:
      A Java Future containing the result of the UpdateVirtualNode operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateVirtualNode

      default CompletableFuture<UpdateVirtualNodeResponse> updateVirtualNode(Consumer<UpdateVirtualNodeRequest.Builder> updateVirtualNodeRequest)

      Updates an existing virtual node in a specified service mesh.


      This is a convenience which creates an instance of the UpdateVirtualNodeRequest.Builder avoiding the need to create one manually via UpdateVirtualNodeRequest.builder()

      Parameters:
      updateVirtualNodeRequest - A Consumer that will call methods on UpdateVirtualNodeRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateVirtualNode operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateVirtualRouter

      default CompletableFuture<UpdateVirtualRouterResponse> updateVirtualRouter(UpdateVirtualRouterRequest updateVirtualRouterRequest)

      Updates an existing virtual router in a specified service mesh.

      Parameters:
      updateVirtualRouterRequest -
      Returns:
      A Java Future containing the result of the UpdateVirtualRouter operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateVirtualRouter

      default CompletableFuture<UpdateVirtualRouterResponse> updateVirtualRouter(Consumer<UpdateVirtualRouterRequest.Builder> updateVirtualRouterRequest)

      Updates an existing virtual router in a specified service mesh.


      This is a convenience which creates an instance of the UpdateVirtualRouterRequest.Builder avoiding the need to create one manually via UpdateVirtualRouterRequest.builder()

      Parameters:
      updateVirtualRouterRequest - A Consumer that will call methods on UpdateVirtualRouterRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateVirtualRouter operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateVirtualService

      default CompletableFuture<UpdateVirtualServiceResponse> updateVirtualService(UpdateVirtualServiceRequest updateVirtualServiceRequest)

      Updates an existing virtual service in a specified service mesh.

      Parameters:
      updateVirtualServiceRequest -
      Returns:
      A Java Future containing the result of the UpdateVirtualService operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • updateVirtualService

      default CompletableFuture<UpdateVirtualServiceResponse> updateVirtualService(Consumer<UpdateVirtualServiceRequest.Builder> updateVirtualServiceRequest)

      Updates an existing virtual service in a specified service mesh.


      This is a convenience which creates an instance of the UpdateVirtualServiceRequest.Builder avoiding the need to create one manually via UpdateVirtualServiceRequest.builder()

      Parameters:
      updateVirtualServiceRequest - A Consumer that will call methods on UpdateVirtualServiceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateVirtualService operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.
      • NotFoundException The specified resource doesn't exist. Check your request syntax and try again.
      • 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.
      • 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.
      • ForbiddenException You don't have permissions to perform this action.
      • ServiceUnavailableException The request has failed due to a temporary failure of the service.
      • 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.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • AppMeshException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:
    • serviceClientConfiguration

      default AppMeshServiceClientConfiguration serviceClientConfiguration()
      Description copied from interface: SdkClient
      The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration
      Specified by:
      serviceClientConfiguration in interface AwsClient
      Specified by:
      serviceClientConfiguration in interface SdkClient
      Returns:
      SdkServiceClientConfiguration
    • create

      static AppMeshAsyncClient create()
      Create a AppMeshAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
    • builder

      static AppMeshAsyncClientBuilder builder()
      Create a builder that can be used to configure and create a AppMeshAsyncClient.