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

Client for Amazon CodeCatalyst

Client for invoking operations on Amazon CodeCatalyst. Each operation on Amazon CodeCatalyst 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_codecatalyst::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_codecatalyst::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 GetUserDetails operation has a Client::get_user_details, function which returns a builder for that operation. The fluent builder ultimately has a call() function that returns an async future that returns a result, as illustrated below:

let result = client.get_user_details()
    .id("example")
    .call()
    .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 create_access_token(&self) -> CreateAccessTokenFluentBuilder

Constructs a fluent builder for the CreateAccessToken operation.

source§

impl Client

source

pub fn create_dev_environment(&self) -> CreateDevEnvironmentFluentBuilder

Constructs a fluent builder for the CreateDevEnvironment operation.

source§

impl Client

source

pub fn create_project(&self) -> CreateProjectFluentBuilder

Constructs a fluent builder for the CreateProject operation.

source§

impl Client

source

pub fn create_source_repository_branch( &self ) -> CreateSourceRepositoryBranchFluentBuilder

Constructs a fluent builder for the CreateSourceRepositoryBranch operation.

source§

impl Client

source

pub fn delete_access_token(&self) -> DeleteAccessTokenFluentBuilder

Constructs a fluent builder for the DeleteAccessToken operation.

source§

impl Client

source

pub fn delete_dev_environment(&self) -> DeleteDevEnvironmentFluentBuilder

Constructs a fluent builder for the DeleteDevEnvironment operation.

source§

impl Client

source

pub fn get_dev_environment(&self) -> GetDevEnvironmentFluentBuilder

Constructs a fluent builder for the GetDevEnvironment operation.

source§

impl Client

source

pub fn get_project(&self) -> GetProjectFluentBuilder

Constructs a fluent builder for the GetProject operation.

source§

impl Client

source

pub fn get_source_repository_clone_urls( &self ) -> GetSourceRepositoryCloneUrlsFluentBuilder

Constructs a fluent builder for the GetSourceRepositoryCloneUrls operation.

source§

impl Client

source

pub fn get_space(&self) -> GetSpaceFluentBuilder

Constructs a fluent builder for the GetSpace operation.

source§

impl Client

source

pub fn get_subscription(&self) -> GetSubscriptionFluentBuilder

Constructs a fluent builder for the GetSubscription operation.

source§

impl Client

source

pub fn get_user_details(&self) -> GetUserDetailsFluentBuilder

Constructs a fluent builder for the GetUserDetails operation.

source§

impl Client

source

pub fn list_access_tokens(&self) -> ListAccessTokensFluentBuilder

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

source§

impl Client

source

pub fn list_dev_environments(&self) -> ListDevEnvironmentsFluentBuilder

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

source§

impl Client

source

pub fn list_event_logs(&self) -> ListEventLogsFluentBuilder

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

source§

impl Client

source

pub fn list_projects(&self) -> ListProjectsFluentBuilder

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

source§

impl Client

source

pub fn list_source_repositories(&self) -> ListSourceRepositoriesFluentBuilder

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

source§

impl Client

source

pub fn list_source_repository_branches( &self ) -> ListSourceRepositoryBranchesFluentBuilder

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

source§

impl Client

source

pub fn list_spaces(&self) -> ListSpacesFluentBuilder

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

source§

impl Client

source

pub fn start_dev_environment(&self) -> StartDevEnvironmentFluentBuilder

Constructs a fluent builder for the StartDevEnvironment operation.

source§

impl Client

source

pub fn start_dev_environment_session( &self ) -> StartDevEnvironmentSessionFluentBuilder

Constructs a fluent builder for the StartDevEnvironmentSession operation.

source§

impl Client

source

pub fn stop_dev_environment(&self) -> StopDevEnvironmentFluentBuilder

Constructs a fluent builder for the StopDevEnvironment operation.

source§

impl Client

source

pub fn stop_dev_environment_session( &self ) -> StopDevEnvironmentSessionFluentBuilder

Constructs a fluent builder for the StopDevEnvironmentSession operation.

source§

impl Client

source

pub fn update_dev_environment(&self) -> UpdateDevEnvironmentFluentBuilder

Constructs a fluent builder for the UpdateDevEnvironment operation.

source§

impl Client

source

pub fn verify_session(&self) -> VerifySessionFluentBuilder

Constructs a fluent builder for the VerifySession operation.

source§

impl Client

source

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

Creates a client with the given service configuration.

source

pub fn conf(&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.
source

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§

source§

impl Clone for Client

source§

fn clone(&self) -> Self

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
source§

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

source§

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

Converts to this type from the input type.

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 Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

const: unstable · source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

const: unstable · source§

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

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

const: unstable · 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 Twhere U: From<T>,

const: unstable · 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<T> Same<T> for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for Twhere 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 Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
const: unstable · source§

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

Performs the conversion.
source§

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

§

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

The type returned in the event of a conversion error.
const: unstable · 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