Struct aws_sdk_cloudcontrol::client::Client
source · [−]pub struct Client<C = DynConnector, M = DefaultMiddleware, R = Standard> { /* private fields */ }
Expand description
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::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<C, M, R> Client<C, M, R> where
C: SmithyConnector,
M: SmithyMiddleware<C>,
R: NewRequestPolicy,
impl<C, M, R> Client<C, M, R> where
C: SmithyConnector,
M: SmithyMiddleware<C>,
R: NewRequestPolicy,
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 theProgressEvent
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>
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) 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 Amazon Web Services 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 theProgressEvent
returned byCreateResource
.
- On failure, responds with
SdkError<CreateResourceError>
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) 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 theProgressEvent
returned byDeleteResource
.
- On failure, responds with
SdkError<DeleteResourceError>
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) 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>
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>
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 theNextToken
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’sNextToken
parameter. If there are no remaining results, the previous response object’sNextToken
parameter is set tonull
.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, callListResources
again and assign that token to the request object’sNextToken
parameter. If the request returns all results,NextToken
is set to null.
- On failure, responds with
SdkError<ListResourceRequestsError>
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) 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’sNextToken
parameter. If there are no remaining results, the previous response object’sNextToken
parameter is set tonull
.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 theNextToken
request parameter to get the next set of results.The default is
20
.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, callListResources
again and assign that token to the request object’sNextToken
parameter. If the request returns all results,NextToken
is set to null.
- On failure, responds with
SdkError<ListResourcesError>
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) 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 theProgressEvent
with GetResourceRequestStatus to return the current status of a resource operation request.
- On failure, responds with
SdkError<UpdateResourceError>
Creates a client with the given service config and connector override.
Trait Implementations
Auto Trait Implementations
impl<C = DynConnector, M = DefaultMiddleware, R = Standard> !RefUnwindSafe for Client<C, M, R>
impl<C = DynConnector, M = DefaultMiddleware, R = Standard> !UnwindSafe for Client<C, M, R>
Blanket Implementations
Mutably borrows from an owned value. Read more
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