Struct aws_sdk_proton::Client

source ·
pub struct Client { /* private fields */ }
Expand description

Client for AWS Proton

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

Constructing a Client

A Config is required to construct a client. For most use cases, the aws-config crate should be used to automatically resolve this config using aws_config::load_from_env(), since this will resolve an SdkConfig which can be shared across multiple different AWS SDK clients. This config resolution process can be customized by calling aws_config::from_env() instead, which returns a ConfigLoader that uses the builder pattern to customize the default config.

In the simplest case, creating a client looks as follows:

let config = aws_config::load_from_env().await;
let client = aws_sdk_proton::Client::new(&config);

Occasionally, SDKs may have additional service-specific that can be set on the Config that is absent from SdkConfig, or slightly different settings for a specific client may be desired. The Config struct implements From<&SdkConfig>, so setting these specific settings can be done as follows:

let sdk_config = ::aws_config::load_from_env().await;
let config = aws_sdk_proton::config::Builder::from(&sdk_config)
    .some_service_specific_setting("value")
    .build();

See the aws-config docs and Config for more information on customizing configuration.

Note: Client construction is expensive due to connection thread pool initialization, and should be done once at application start-up.

Using the Client

A client has a function for every operation that can be performed by the service. For example, the CancelComponentDeployment operation has a Client::cancel_component_deployment, function which returns a builder for that operation. The fluent builder ultimately has a send() function that returns an async future that returns a result, as illustrated below:

let result = client.cancel_component_deployment()
    .component_name("example")
    .send()
    .await;

The underlying HTTP requests that get made by this can be modified with the customize_operation function on the fluent builder. See the customize module for more information.

Implementations§

source§

impl Client

source

pub fn accept_environment_account_connection( &self ) -> AcceptEnvironmentAccountConnectionFluentBuilder

Constructs a fluent builder for the AcceptEnvironmentAccountConnection operation.

source§

impl Client

source

pub fn cancel_component_deployment( &self ) -> CancelComponentDeploymentFluentBuilder

Constructs a fluent builder for the CancelComponentDeployment operation.

source§

impl Client

source

pub fn cancel_environment_deployment( &self ) -> CancelEnvironmentDeploymentFluentBuilder

Constructs a fluent builder for the CancelEnvironmentDeployment operation.

source§

impl Client

source

pub fn cancel_service_instance_deployment( &self ) -> CancelServiceInstanceDeploymentFluentBuilder

Constructs a fluent builder for the CancelServiceInstanceDeployment operation.

source§

impl Client

source

pub fn cancel_service_pipeline_deployment( &self ) -> CancelServicePipelineDeploymentFluentBuilder

Constructs a fluent builder for the CancelServicePipelineDeployment operation.

source§

impl Client

source

pub fn create_component(&self) -> CreateComponentFluentBuilder

Constructs a fluent builder for the CreateComponent operation.

source§

impl Client

source

pub fn create_environment(&self) -> CreateEnvironmentFluentBuilder

Constructs a fluent builder for the CreateEnvironment operation.

source§

impl Client

source

pub fn create_environment_account_connection( &self ) -> CreateEnvironmentAccountConnectionFluentBuilder

Constructs a fluent builder for the CreateEnvironmentAccountConnection operation.

source§

impl Client

source

pub fn create_environment_template( &self ) -> CreateEnvironmentTemplateFluentBuilder

Constructs a fluent builder for the CreateEnvironmentTemplate operation.

source§

impl Client

source

pub fn create_environment_template_version( &self ) -> CreateEnvironmentTemplateVersionFluentBuilder

Constructs a fluent builder for the CreateEnvironmentTemplateVersion operation.

source§

impl Client

source

pub fn create_repository(&self) -> CreateRepositoryFluentBuilder

Constructs a fluent builder for the CreateRepository operation.

source§

impl Client

source

pub fn create_service(&self) -> CreateServiceFluentBuilder

Constructs a fluent builder for the CreateService operation.

source§

impl Client

source

pub fn create_service_instance(&self) -> CreateServiceInstanceFluentBuilder

Constructs a fluent builder for the CreateServiceInstance operation.

source§

impl Client

source

pub fn create_service_sync_config(&self) -> CreateServiceSyncConfigFluentBuilder

Constructs a fluent builder for the CreateServiceSyncConfig operation.

source§

impl Client

source

pub fn create_service_template(&self) -> CreateServiceTemplateFluentBuilder

Constructs a fluent builder for the CreateServiceTemplate operation.

source§

impl Client

source

pub fn create_service_template_version( &self ) -> CreateServiceTemplateVersionFluentBuilder

Constructs a fluent builder for the CreateServiceTemplateVersion operation.

source§

impl Client

source

pub fn create_template_sync_config( &self ) -> CreateTemplateSyncConfigFluentBuilder

Constructs a fluent builder for the CreateTemplateSyncConfig operation.

source§

impl Client

source

pub fn delete_component(&self) -> DeleteComponentFluentBuilder

Constructs a fluent builder for the DeleteComponent operation.

source§

impl Client

source

pub fn delete_deployment(&self) -> DeleteDeploymentFluentBuilder

Constructs a fluent builder for the DeleteDeployment operation.

source§

impl Client

source

pub fn delete_environment(&self) -> DeleteEnvironmentFluentBuilder

Constructs a fluent builder for the DeleteEnvironment operation.

source§

impl Client

source

pub fn delete_environment_account_connection( &self ) -> DeleteEnvironmentAccountConnectionFluentBuilder

Constructs a fluent builder for the DeleteEnvironmentAccountConnection operation.

source§

impl Client

source

pub fn delete_environment_template( &self ) -> DeleteEnvironmentTemplateFluentBuilder

Constructs a fluent builder for the DeleteEnvironmentTemplate operation.

source§

impl Client

source

pub fn delete_environment_template_version( &self ) -> DeleteEnvironmentTemplateVersionFluentBuilder

Constructs a fluent builder for the DeleteEnvironmentTemplateVersion operation.

source§

impl Client

source

pub fn delete_repository(&self) -> DeleteRepositoryFluentBuilder

Constructs a fluent builder for the DeleteRepository operation.

source§

impl Client

source

pub fn delete_service(&self) -> DeleteServiceFluentBuilder

Constructs a fluent builder for the DeleteService operation.

source§

impl Client

source

pub fn delete_service_sync_config(&self) -> DeleteServiceSyncConfigFluentBuilder

Constructs a fluent builder for the DeleteServiceSyncConfig operation.

source§

impl Client

source

pub fn delete_service_template(&self) -> DeleteServiceTemplateFluentBuilder

Constructs a fluent builder for the DeleteServiceTemplate operation.

source§

impl Client

source

pub fn delete_service_template_version( &self ) -> DeleteServiceTemplateVersionFluentBuilder

Constructs a fluent builder for the DeleteServiceTemplateVersion operation.

source§

impl Client

source

pub fn delete_template_sync_config( &self ) -> DeleteTemplateSyncConfigFluentBuilder

Constructs a fluent builder for the DeleteTemplateSyncConfig operation.

source§

impl Client

source

pub fn get_account_settings(&self) -> GetAccountSettingsFluentBuilder

Constructs a fluent builder for the GetAccountSettings operation.

source§

impl Client

source

pub fn get_component(&self) -> GetComponentFluentBuilder

Constructs a fluent builder for the GetComponent operation.

source§

impl Client

source

pub fn get_deployment(&self) -> GetDeploymentFluentBuilder

Constructs a fluent builder for the GetDeployment operation.

source§

impl Client

source

pub fn get_environment(&self) -> GetEnvironmentFluentBuilder

Constructs a fluent builder for the GetEnvironment operation.

source§

impl Client

source

pub fn get_environment_account_connection( &self ) -> GetEnvironmentAccountConnectionFluentBuilder

Constructs a fluent builder for the GetEnvironmentAccountConnection operation.

source§

impl Client

source

pub fn get_environment_template(&self) -> GetEnvironmentTemplateFluentBuilder

Constructs a fluent builder for the GetEnvironmentTemplate operation.

source§

impl Client

source

pub fn get_environment_template_version( &self ) -> GetEnvironmentTemplateVersionFluentBuilder

Constructs a fluent builder for the GetEnvironmentTemplateVersion operation.

source§

impl Client

source

pub fn get_repository(&self) -> GetRepositoryFluentBuilder

Constructs a fluent builder for the GetRepository operation.

source§

impl Client

source

pub fn get_repository_sync_status(&self) -> GetRepositorySyncStatusFluentBuilder

Constructs a fluent builder for the GetRepositorySyncStatus operation.

source§

impl Client

source

pub fn get_resources_summary(&self) -> GetResourcesSummaryFluentBuilder

Constructs a fluent builder for the GetResourcesSummary operation.

source§

impl Client

source

pub fn get_service(&self) -> GetServiceFluentBuilder

Constructs a fluent builder for the GetService operation.

source§

impl Client

source

pub fn get_service_instance(&self) -> GetServiceInstanceFluentBuilder

Constructs a fluent builder for the GetServiceInstance operation.

source§

impl Client

source

pub fn get_service_instance_sync_status( &self ) -> GetServiceInstanceSyncStatusFluentBuilder

Constructs a fluent builder for the GetServiceInstanceSyncStatus operation.

source§

impl Client

source

pub fn get_service_sync_blocker_summary( &self ) -> GetServiceSyncBlockerSummaryFluentBuilder

Constructs a fluent builder for the GetServiceSyncBlockerSummary operation.

source§

impl Client

source

pub fn get_service_sync_config(&self) -> GetServiceSyncConfigFluentBuilder

Constructs a fluent builder for the GetServiceSyncConfig operation.

source§

impl Client

source

pub fn get_service_template(&self) -> GetServiceTemplateFluentBuilder

Constructs a fluent builder for the GetServiceTemplate operation.

source§

impl Client

source

pub fn get_service_template_version( &self ) -> GetServiceTemplateVersionFluentBuilder

Constructs a fluent builder for the GetServiceTemplateVersion operation.

source§

impl Client

source

pub fn get_template_sync_config(&self) -> GetTemplateSyncConfigFluentBuilder

Constructs a fluent builder for the GetTemplateSyncConfig operation.

source§

impl Client

source

pub fn get_template_sync_status(&self) -> GetTemplateSyncStatusFluentBuilder

Constructs a fluent builder for the GetTemplateSyncStatus operation.

source§

impl Client

source

pub fn list_component_outputs(&self) -> ListComponentOutputsFluentBuilder

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

source§

impl Client

source

pub fn list_component_provisioned_resources( &self ) -> ListComponentProvisionedResourcesFluentBuilder

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

source§

impl Client

source

pub fn list_components(&self) -> ListComponentsFluentBuilder

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

source§

impl Client

source

pub fn list_deployments(&self) -> ListDeploymentsFluentBuilder

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

source§

impl Client

source

pub fn list_environment_account_connections( &self ) -> ListEnvironmentAccountConnectionsFluentBuilder

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

source§

impl Client

source

pub fn list_environment_outputs(&self) -> ListEnvironmentOutputsFluentBuilder

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

source§

impl Client

source

pub fn list_environment_provisioned_resources( &self ) -> ListEnvironmentProvisionedResourcesFluentBuilder

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

source§

impl Client

source

pub fn list_environment_template_versions( &self ) -> ListEnvironmentTemplateVersionsFluentBuilder

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

source§

impl Client

source

pub fn list_environment_templates( &self ) -> ListEnvironmentTemplatesFluentBuilder

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

source§

impl Client

source

pub fn list_environments(&self) -> ListEnvironmentsFluentBuilder

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

source§

impl Client

source

pub fn list_repositories(&self) -> ListRepositoriesFluentBuilder

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

source§

impl Client

source

pub fn list_repository_sync_definitions( &self ) -> ListRepositorySyncDefinitionsFluentBuilder

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

source§

impl Client

source

pub fn list_service_instance_outputs( &self ) -> ListServiceInstanceOutputsFluentBuilder

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

source§

impl Client

source

pub fn list_service_instance_provisioned_resources( &self ) -> ListServiceInstanceProvisionedResourcesFluentBuilder

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

source§

impl Client

source

pub fn list_service_instances(&self) -> ListServiceInstancesFluentBuilder

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

source§

impl Client

source

pub fn list_service_pipeline_outputs( &self ) -> ListServicePipelineOutputsFluentBuilder

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

source§

impl Client

source

pub fn list_service_pipeline_provisioned_resources( &self ) -> ListServicePipelineProvisionedResourcesFluentBuilder

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

source§

impl Client

source

pub fn list_service_template_versions( &self ) -> ListServiceTemplateVersionsFluentBuilder

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

source§

impl Client

source

pub fn list_service_templates(&self) -> ListServiceTemplatesFluentBuilder

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

source§

impl Client

source

pub fn list_services(&self) -> ListServicesFluentBuilder

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

source§

impl Client

source

pub fn list_tags_for_resource(&self) -> ListTagsForResourceFluentBuilder

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

source§

impl Client

source

pub fn notify_resource_deployment_status_change( &self ) -> NotifyResourceDeploymentStatusChangeFluentBuilder

Constructs a fluent builder for the NotifyResourceDeploymentStatusChange operation.

source§

impl Client

source

pub fn reject_environment_account_connection( &self ) -> RejectEnvironmentAccountConnectionFluentBuilder

Constructs a fluent builder for the RejectEnvironmentAccountConnection operation.

source§

impl Client

source

pub fn tag_resource(&self) -> TagResourceFluentBuilder

Constructs a fluent builder for the TagResource operation.

source§

impl Client

source

pub fn untag_resource(&self) -> UntagResourceFluentBuilder

Constructs a fluent builder for the UntagResource operation.

source§

impl Client

source

pub fn update_account_settings(&self) -> UpdateAccountSettingsFluentBuilder

Constructs a fluent builder for the UpdateAccountSettings operation.

source§

impl Client

source

pub fn update_component(&self) -> UpdateComponentFluentBuilder

Constructs a fluent builder for the UpdateComponent operation.

source§

impl Client

source

pub fn update_environment(&self) -> UpdateEnvironmentFluentBuilder

Constructs a fluent builder for the UpdateEnvironment operation.

source§

impl Client

source

pub fn update_environment_account_connection( &self ) -> UpdateEnvironmentAccountConnectionFluentBuilder

Constructs a fluent builder for the UpdateEnvironmentAccountConnection operation.

source§

impl Client

source

pub fn update_environment_template( &self ) -> UpdateEnvironmentTemplateFluentBuilder

Constructs a fluent builder for the UpdateEnvironmentTemplate operation.

source§

impl Client

source

pub fn update_environment_template_version( &self ) -> UpdateEnvironmentTemplateVersionFluentBuilder

Constructs a fluent builder for the UpdateEnvironmentTemplateVersion operation.

source§

impl Client

source

pub fn update_service(&self) -> UpdateServiceFluentBuilder

Constructs a fluent builder for the UpdateService operation.

source§

impl Client

source

pub fn update_service_instance(&self) -> UpdateServiceInstanceFluentBuilder

Constructs a fluent builder for the UpdateServiceInstance operation.

source§

impl Client

source

pub fn update_service_pipeline(&self) -> UpdateServicePipelineFluentBuilder

Constructs a fluent builder for the UpdateServicePipeline operation.

source§

impl Client

source

pub fn update_service_sync_blocker( &self ) -> UpdateServiceSyncBlockerFluentBuilder

Constructs a fluent builder for the UpdateServiceSyncBlocker operation.

source§

impl Client

source

pub fn update_service_sync_config(&self) -> UpdateServiceSyncConfigFluentBuilder

Constructs a fluent builder for the UpdateServiceSyncConfig operation.

source§

impl Client

source

pub fn update_service_template(&self) -> UpdateServiceTemplateFluentBuilder

Constructs a fluent builder for the UpdateServiceTemplate operation.

source§

impl Client

source

pub fn update_service_template_version( &self ) -> UpdateServiceTemplateVersionFluentBuilder

Constructs a fluent builder for the UpdateServiceTemplateVersion operation.

source§

impl Client

source

pub fn update_template_sync_config( &self ) -> UpdateTemplateSyncConfigFluentBuilder

Constructs a fluent builder for the UpdateTemplateSyncConfig operation.

source§

impl Client

source

pub fn from_conf(conf: Config) -> Self

Creates a new client from the service Config.

Panics

This method will panic in the following cases:

  • Retries or timeouts are enabled without a sleep_impl configured.
  • Identity caching is enabled without a sleep_impl and time_source configured.
  • No behavior_version is provided.

The panic message for each of these will have instructions on how to resolve them.

source

pub fn config(&self) -> &Config

Returns the client’s configuration.

source§

impl Client

source

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.
  • This method will panic if no BehaviorVersion is provided. If you experience this panic, set behavior_version on the Config or enable the behavior-version-latest Cargo feature.

Trait Implementations§

source§

impl Clone for Client

source§

fn clone(&self) -> Client

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Client

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl !RefUnwindSafe for Client

§

impl Send for Client

§

impl Sync for Client

§

impl Unpin for Client

§

impl !UnwindSafe for Client

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

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

fn in_current_span(self) -> Instrumented<Self>

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

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

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

fn clone_into(&self, target: &mut T)

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

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

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

fn with_current_subscriber(self) -> WithDispatch<Self>

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