pub struct Client<C = DynConnector, M = DefaultMiddleware, R = Standard> { /* private fields */ }
Expand description

Client for AWS App Mesh

Client for invoking operations on AWS App Mesh. Each operation on AWS App Mesh is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

Examples

Constructing a client and invoking an operation

    // create a shared configuration. This can be used & shared between multiple service clients.
    let shared_config = aws_config::load_from_env().await;
    let client = aws_sdk_appmesh::Client::new(&shared_config);
    // invoke an operation
    /* let rsp = client
        .<operation_name>().
        .<param>("some value")
        .send().await; */

Constructing a client with custom configuration

use aws_config::RetryConfig;
    let shared_config = aws_config::load_from_env().await;
    let config = aws_sdk_appmesh::config::Builder::from(&shared_config)
        .retry_config(RetryConfig::disabled())
        .build();
    let client = aws_sdk_appmesh::Client::from_conf(config);

Implementations

Creates a client with the given service configuration.

Returns the client’s configuration.

Constructs a fluent builder for the CreateGatewayRoute operation.

Constructs a fluent builder for the CreateMesh operation.

Constructs a fluent builder for the CreateRoute operation.

Constructs a fluent builder for the CreateVirtualGateway operation.

Constructs a fluent builder for the CreateVirtualNode operation.

Constructs a fluent builder for the CreateVirtualRouter operation.

Constructs a fluent builder for the CreateVirtualService operation.

Constructs a fluent builder for the DeleteGatewayRoute operation.

Constructs a fluent builder for the DeleteMesh operation.

Constructs a fluent builder for the DeleteRoute operation.

Constructs a fluent builder for the DeleteVirtualGateway operation.

Constructs a fluent builder for the DeleteVirtualNode operation.

Constructs a fluent builder for the DeleteVirtualRouter operation.

Constructs a fluent builder for the DeleteVirtualService operation.

Constructs a fluent builder for the DescribeGatewayRoute operation.

Constructs a fluent builder for the DescribeMesh operation.

Constructs a fluent builder for the DescribeRoute operation.

Constructs a fluent builder for the DescribeVirtualGateway operation.

Constructs a fluent builder for the DescribeVirtualNode operation.

Constructs a fluent builder for the DescribeVirtualRouter operation.

Constructs a fluent builder for the DescribeVirtualService operation.

Constructs a fluent builder for the ListGatewayRoutes operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListMeshes operation. This operation supports pagination; See into_paginator().

  • The fluent builder is configurable:
    • next_token(impl Into<String>) / set_next_token(Option<String>):

      The nextToken value returned from a previous paginated ListMeshes request where limit was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

      This token should be treated as an opaque identifier that is used only to retrieve the next items in a list and not for other programmatic purposes.

    • limit(i32) / set_limit(Option<i32>):

      The maximum number of results returned by ListMeshes in paginated output. When you use this parameter, ListMeshes returns only limit results in a single page along with a nextToken response element. You can see the remaining results of the initial request by sending another ListMeshes request with the returned nextToken value. This value can be between 1 and 100. If you don’t use this parameter, ListMeshes returns up to 100 results and a nextToken value if applicable.

  • On success, responds with ListMeshesOutput with field(s):
    • meshes(Option<Vec<MeshRef>>):

      The list of existing service meshes.

    • next_token(Option<String>):

      The nextToken value to include in a future ListMeshes request. When the results of a ListMeshes request exceed limit, you can use this value to retrieve the next page of results. This value is null when there are no more results to return.

  • On failure, responds with SdkError<ListMeshesError>

Constructs a fluent builder for the ListRoutes operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListTagsForResource operation. This operation supports pagination; See into_paginator().

  • The fluent builder is configurable:
    • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):

      The Amazon Resource Name (ARN) that identifies the resource to list the tags for.

    • next_token(impl Into<String>) / set_next_token(Option<String>):

      The nextToken value returned from a previous paginated ListTagsForResource request where limit was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

    • limit(i32) / set_limit(Option<i32>):

      The maximum number of tag results returned by ListTagsForResource in paginated output. When this parameter is used, ListTagsForResource returns only limit results in a single page along with a nextToken response element. You can see the remaining results of the initial request by sending another ListTagsForResource request with the returned nextToken value. This value can be between 1 and 100. If you don’t use this parameter, ListTagsForResource returns up to 100 results and a nextToken value if applicable.

  • On success, responds with ListTagsForResourceOutput with field(s):
    • tags(Option<Vec<TagRef>>):

      The tags for the resource.

    • next_token(Option<String>):

      The nextToken value to include in a future ListTagsForResource request. When the results of a ListTagsForResource request exceed limit, you can use this value to retrieve the next page of results. This value is null when there are no more results to return.

  • On failure, responds with SdkError<ListTagsForResourceError>

Constructs a fluent builder for the ListVirtualGateways operation. This operation supports pagination; See into_paginator().

  • The fluent builder is configurable:
    • mesh_name(impl Into<String>) / set_mesh_name(Option<String>):

      The name of the service mesh to list virtual gateways in.

    • next_token(impl Into<String>) / set_next_token(Option<String>):

      The nextToken value returned from a previous paginated ListVirtualGateways request where limit was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

    • limit(i32) / set_limit(Option<i32>):

      The maximum number of results returned by ListVirtualGateways in paginated output. When you use this parameter, ListVirtualGateways returns only limit results in a single page along with a nextToken response element. You can see the remaining results of the initial request by sending another ListVirtualGateways request with the returned nextToken value. This value can be between 1 and 100. If you don’t use this parameter, ListVirtualGateways returns up to 100 results and a nextToken value if applicable.

    • mesh_owner(impl Into<String>) / set_mesh_owner(Option<String>):

      The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it’s the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

  • On success, responds with ListVirtualGatewaysOutput with field(s):
    • virtual_gateways(Option<Vec<VirtualGatewayRef>>):

      The list of existing virtual gateways for the specified service mesh.

    • next_token(Option<String>):

      The nextToken value to include in a future ListVirtualGateways request. When the results of a ListVirtualGateways request exceed limit, you can use this value to retrieve the next page of results. This value is null when there are no more results to return.

  • On failure, responds with SdkError<ListVirtualGatewaysError>

Constructs a fluent builder for the ListVirtualNodes operation. This operation supports pagination; See into_paginator().

  • The fluent builder is configurable:
    • mesh_name(impl Into<String>) / set_mesh_name(Option<String>):

      The name of the service mesh to list virtual nodes in.

    • next_token(impl Into<String>) / set_next_token(Option<String>):

      The nextToken value returned from a previous paginated ListVirtualNodes request where limit was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

    • limit(i32) / set_limit(Option<i32>):

      The maximum number of results returned by ListVirtualNodes in paginated output. When you use this parameter, ListVirtualNodes returns only limit results in a single page along with a nextToken response element. You can see the remaining results of the initial request by sending another ListVirtualNodes request with the returned nextToken value. This value can be between 1 and 100. If you don’t use this parameter, ListVirtualNodes returns up to 100 results and a nextToken value if applicable.

    • mesh_owner(impl Into<String>) / set_mesh_owner(Option<String>):

      The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it’s the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

  • On success, responds with ListVirtualNodesOutput with field(s):
    • virtual_nodes(Option<Vec<VirtualNodeRef>>):

      The list of existing virtual nodes for the specified service mesh.

    • next_token(Option<String>):

      The nextToken value to include in a future ListVirtualNodes request. When the results of a ListVirtualNodes request exceed limit, you can use this value to retrieve the next page of results. This value is null when there are no more results to return.

  • On failure, responds with SdkError<ListVirtualNodesError>

Constructs a fluent builder for the ListVirtualRouters operation. This operation supports pagination; See into_paginator().

  • The fluent builder is configurable:
    • mesh_name(impl Into<String>) / set_mesh_name(Option<String>):

      The name of the service mesh to list virtual routers in.

    • next_token(impl Into<String>) / set_next_token(Option<String>):

      The nextToken value returned from a previous paginated ListVirtualRouters request where limit was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

    • limit(i32) / set_limit(Option<i32>):

      The maximum number of results returned by ListVirtualRouters in paginated output. When you use this parameter, ListVirtualRouters returns only limit results in a single page along with a nextToken response element. You can see the remaining results of the initial request by sending another ListVirtualRouters request with the returned nextToken value. This value can be between 1 and 100. If you don’t use this parameter, ListVirtualRouters returns up to 100 results and a nextToken value if applicable.

    • mesh_owner(impl Into<String>) / set_mesh_owner(Option<String>):

      The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it’s the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

  • On success, responds with ListVirtualRoutersOutput with field(s):
    • virtual_routers(Option<Vec<VirtualRouterRef>>):

      The list of existing virtual routers for the specified service mesh.

    • next_token(Option<String>):

      The nextToken value to include in a future ListVirtualRouters request. When the results of a ListVirtualRouters request exceed limit, you can use this value to retrieve the next page of results. This value is null when there are no more results to return.

  • On failure, responds with SdkError<ListVirtualRoutersError>

Constructs a fluent builder for the ListVirtualServices operation. This operation supports pagination; See into_paginator().

  • The fluent builder is configurable:
    • mesh_name(impl Into<String>) / set_mesh_name(Option<String>):

      The name of the service mesh to list virtual services in.

    • next_token(impl Into<String>) / set_next_token(Option<String>):

      The nextToken value returned from a previous paginated ListVirtualServices request where limit was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

    • limit(i32) / set_limit(Option<i32>):

      The maximum number of results returned by ListVirtualServices in paginated output. When you use this parameter, ListVirtualServices returns only limit results in a single page along with a nextToken response element. You can see the remaining results of the initial request by sending another ListVirtualServices request with the returned nextToken value. This value can be between 1 and 100. If you don’t use this parameter, ListVirtualServices returns up to 100 results and a nextToken value if applicable.

    • mesh_owner(impl Into<String>) / set_mesh_owner(Option<String>):

      The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it’s the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

  • On success, responds with ListVirtualServicesOutput with field(s):
    • virtual_services(Option<Vec<VirtualServiceRef>>):

      The list of existing virtual services for the specified service mesh.

    • next_token(Option<String>):

      The nextToken value to include in a future ListVirtualServices request. When the results of a ListVirtualServices request exceed limit, you can use this value to retrieve the next page of results. This value is null when there are no more results to return.

  • On failure, responds with SdkError<ListVirtualServicesError>

Constructs a fluent builder for the TagResource operation.

Constructs a fluent builder for the UntagResource operation.

Constructs a fluent builder for the UpdateGatewayRoute operation.

Constructs a fluent builder for the UpdateMesh operation.

Constructs a fluent builder for the UpdateRoute operation.

Constructs a fluent builder for the UpdateVirtualGateway operation.

Constructs a fluent builder for the UpdateVirtualNode operation.

Constructs a fluent builder for the UpdateVirtualRouter operation.

Constructs a fluent builder for the UpdateVirtualService operation.

Creates a client with the given service config and connector override.

Creates a new client from a shared config.

Creates a new client from the service Config.

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Performs the conversion.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Performs the conversion.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Performs the conversion.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more