Struct aws_sdk_cloudcontrol::Client

pub struct Client { /* private fields */ }

Client for AWS Cloud Control API

Client for invoking operations on AWS Cloud Control API. Each operation on AWS Cloud Control API 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_cloudcontrol::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::retry::RetryConfig;
let shared_config = aws_config::load_from_env().await;
let config = aws_sdk_cloudcontrol::config::Builder::from(&shared_config)
  .retry_config(RetryConfig::disabled())
  .build();
let client = aws_sdk_cloudcontrol::Client::from_conf(config);

Implementations

impl Client

pub fn with_config(
    client: Client<DynConnector, DynMiddleware<DynConnector>>,
    conf: Config
) -> Self

Creates a client with the given service configuration.

pub fn conf(&self) -> &Config

Returns the client’s configuration.

impl Client

pub fn cancel_resource_request(&self) -> CancelResourceRequest

Constructs a fluent builder for the CancelResourceRequest operation.

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

    The RequestToken of the ProgressEvent object returned by the resource operation request.

• On success, responds with CancelResourceRequestOutput with field(s):
  • progress_event(Option<ProgressEvent>):

    Represents the current status of a resource operation request. For more information, see Managing resource operation requests in the Amazon Web Services Cloud Control API User Guide.

• On failure, responds with SdkError<CancelResourceRequestError>

pub fn create_resource(&self) -> CreateResource

Constructs a fluent builder for the CreateResource operation.

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

    The name of the resource type.

  • type_version_id(impl Into<String>) / set_type_version_id(Option<String>):

    For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.

  • role_arn(impl Into<String>) / set_role_arn(Option<String>):

    The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the handlers section of the resource type definition schema.

    If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.

    For more information, see Specifying credentials in the Amazon Web Services Cloud Control API User Guide.

  • client_token(impl Into<String>) / set_client_token(Option<String>):

    A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.

    A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.

    If you do not specify a client token, one is generated for inclusion in the request.

    For more information, see Ensuring resource operation requests are unique in the Amazon Web Services Cloud Control API User Guide.

  • desired_state(impl Into<String>) / set_desired_state(Option<String>):

    Structured data format representing the desired state of the resource, consisting of that resource’s properties and their desired values.

    Cloud Control API currently supports JSON as a structured data format.

    Specify the desired state as one of the following:

    • A JSON blob

    • A local path containing the desired state in JSON data format

    For more information, see Composing the desired state of the resource in the Amazon Web Services Cloud Control API User Guide.

    For more information about the properties of a specific resource, refer to the related topic for the resource in the Resource and property types reference in the CloudFormation Users Guide.

• On success, responds with CreateResourceOutput with field(s):
  • progress_event(Option<ProgressEvent>):

    Represents the current status of the resource creation request.

    After you have initiated a resource creation request, you can monitor the progress of your request by calling GetResourceRequestStatus using the RequestToken of the ProgressEvent returned by CreateResource.

• On failure, responds with SdkError<CreateResourceError>

pub fn delete_resource(&self) -> DeleteResource

Constructs a fluent builder for the DeleteResource operation.

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

    The name of the resource type.

  • type_version_id(impl Into<String>) / set_type_version_id(Option<String>):

    For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.

  • role_arn(impl Into<String>) / set_role_arn(Option<String>):

    The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the handlers section of the resource type definition schema.

    If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.

    For more information, see Specifying credentials in the Amazon Web Services Cloud Control API User Guide.

  • client_token(impl Into<String>) / set_client_token(Option<String>):

    A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.

    A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.

    If you do not specify a client token, one is generated for inclusion in the request.

    For more information, see Ensuring resource operation requests are unique in the Amazon Web Services Cloud Control API User Guide.

  • identifier(impl Into<String>) / set_identifier(Option<String>):

    The identifier for the resource.

    You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.

    For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values in the order they are specified in the primary identifier definition, separated by |.

    For more information, see Identifying resources in the Amazon Web Services Cloud Control API User Guide.

• On success, responds with DeleteResourceOutput with field(s):
  • progress_event(Option<ProgressEvent>):

    Represents the current status of the resource deletion request.

    After you have initiated a resource deletion request, you can monitor the progress of your request by calling GetResourceRequestStatus using the RequestToken of the ProgressEvent returned by DeleteResource.

• On failure, responds with SdkError<DeleteResourceError>

pub fn get_resource(&self) -> GetResource

Constructs a fluent builder for the GetResource operation.

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

    The name of the resource type.

  • type_version_id(impl Into<String>) / set_type_version_id(Option<String>):

    For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.

  • role_arn(impl Into<String>) / set_role_arn(Option<String>):

    The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the handlers section of the resource type definition schema.

    If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.

    For more information, see Specifying credentials in the Amazon Web Services Cloud Control API User Guide.

  • identifier(impl Into<String>) / set_identifier(Option<String>):

    The identifier for the resource.

    You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.

    For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values in the order they are specified in the primary identifier definition, separated by |.

    For more information, see Identifying resources in the Amazon Web Services Cloud Control API User Guide.

• On success, responds with GetResourceOutput with field(s):
  • type_name(Option<String>):

    The name of the resource type.

  • resource_description(Option<ResourceDescription>):

    Represents information about a provisioned resource.

• On failure, responds with SdkError<GetResourceError>

pub fn get_resource_request_status(&self) -> GetResourceRequestStatus

Constructs a fluent builder for the GetResourceRequestStatus operation.

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

    A unique token used to track the progress of the resource operation request.

    Request tokens are included in the ProgressEvent type returned by a resource operation request.

• On success, responds with GetResourceRequestStatusOutput with field(s):
  • progress_event(Option<ProgressEvent>):

    Represents the current status of the resource operation request.

• On failure, responds with SdkError<GetResourceRequestStatusError>

pub fn list_resource_requests(&self) -> ListResourceRequests

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

• The fluent builder is configurable:
  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a NextToken value that you can assign to the NextToken request parameter to get the next set of results.

    The default is 20.

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

    If the previous paginated request didn’t return all of the remaining results, the response object’s NextToken parameter value is set to a token. To retrieve the next set of results, call this action again and assign that token to the request object’s NextToken parameter. If there are no remaining results, the previous response object’s NextToken parameter is set to null.

  • resource_request_status_filter(ResourceRequestStatusFilter) / set_resource_request_status_filter(Option<ResourceRequestStatusFilter>):

    The filter criteria to apply to the requests returned.

• On success, responds with ListResourceRequestsOutput with field(s):
  • resource_request_status_summaries(Option<Vec<ProgressEvent>>):

    The requests that match the specified filter criteria.

  • next_token(Option<String>):

    If the request doesn’t return all of the remaining results, NextToken is set to a token. To retrieve the next set of results, call ListResources again and assign that token to the request object’s NextToken parameter. If the request returns all results, NextToken is set to null.

• On failure, responds with SdkError<ListResourceRequestsError>

pub fn list_resources(&self) -> ListResources

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

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

    The name of the resource type.

  • type_version_id(impl Into<String>) / set_type_version_id(Option<String>):

    For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.

  • role_arn(impl Into<String>) / set_role_arn(Option<String>):

    The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the handlers section of the resource type definition schema.

    If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.

    For more information, see Specifying credentials in the Amazon Web Services Cloud Control API User Guide.

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

    If the previous paginated request didn’t return all of the remaining results, the response object’s NextToken parameter value is set to a token. To retrieve the next set of results, call this action again and assign that token to the request object’s NextToken parameter. If there are no remaining results, the previous response object’s NextToken parameter is set to null.

  • max_results(i32) / set_max_results(Option<i32>):

    Reserved.

  • resource_model(impl Into<String>) / set_resource_model(Option<String>):

    The resource model to use to select the resources to return.

• On success, responds with ListResourcesOutput with field(s):
  • type_name(Option<String>):

    The name of the resource type.

  • resource_descriptions(Option<Vec<ResourceDescription>>):

    Information about the specified resources, including primary identifier and resource model.

  • next_token(Option<String>):

    If the request doesn’t return all of the remaining results, NextToken is set to a token. To retrieve the next set of results, call ListResources again and assign that token to the request object’s NextToken parameter. If the request returns all results, NextToken is set to null.

• On failure, responds with SdkError<ListResourcesError>

pub fn update_resource(&self) -> UpdateResource

Constructs a fluent builder for the UpdateResource operation.

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

    The name of the resource type.

  • type_version_id(impl Into<String>) / set_type_version_id(Option<String>):

    For private resource types, the type version to use in this resource operation. If you do not specify a resource version, CloudFormation uses the default version.

  • role_arn(impl Into<String>) / set_role_arn(Option<String>):

    The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role for Cloud Control API to use when performing this resource operation. The role specified must have the permissions required for this operation. The necessary permissions for each event handler are defined in the handlers section of the resource type definition schema.

    If you do not specify a role, Cloud Control API uses a temporary session created using your Amazon Web Services user credentials.

    For more information, see Specifying credentials in the Amazon Web Services Cloud Control API User Guide.

  • client_token(impl Into<String>) / set_client_token(Option<String>):

    A unique identifier to ensure the idempotency of the resource request. As a best practice, specify this token to ensure idempotency, so that Amazon Web Services Cloud Control API can accurately distinguish between request retries and new resource requests. You might retry a resource request to ensure that it was successfully received.

    A client token is valid for 36 hours once used. After that, a resource request with the same client token is treated as a new request.

    If you do not specify a client token, one is generated for inclusion in the request.

    For more information, see Ensuring resource operation requests are unique in the Amazon Web Services Cloud Control API User Guide.

  • identifier(impl Into<String>) / set_identifier(Option<String>):

    The identifier for the resource.

    You can specify the primary identifier, or any secondary identifier defined for the resource type in its resource schema. You can only specify one identifier. Primary identifiers can be specified as a string or JSON; secondary identifiers must be specified as JSON.

    For compound primary identifiers (that is, one that consists of multiple resource properties strung together), to specify the primary identifier as a string, list the property values in the order they are specified in the primary identifier definition, separated by |.

    For more information, see Identifying resources in the Amazon Web Services Cloud Control API User Guide.

  • patch_document(impl Into<String>) / set_patch_document(Option<String>):

    A JavaScript Object Notation (JSON) document listing the patch operations that represent the updates to apply to the current resource properties. For details, see Composing the patch document in the Amazon Web Services Cloud Control API User Guide.

• On success, responds with UpdateResourceOutput with field(s):
  • progress_event(Option<ProgressEvent>):

    Represents the current status of the resource update request.

    Use the RequestToken of the ProgressEvent with GetResourceRequestStatus to return the current status of a resource operation request.

• On failure, responds with SdkError<UpdateResourceError>

impl Client

pub fn new(sdk_config: &SdkConfig) -> Self

Creates a new client from an SDK Config.

Panics

• This method will panic if the sdk_config is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
• This method will panic if the sdk_config is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.

pub fn from_conf(conf: Config) -> Self

Creates a new client from the service Config.

Panics

• This method will panic if the conf is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
• This method will panic if the conf is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Client<DynConnector, DynMiddleware<DynConnector>, Standard>> for Client

fn from(client: Client<DynConnector, DynMiddleware<DynConnector>>) -> Self

Converts to this type from the input type.