Struct aws_sdk_codestar::Client

pub struct Client { /* private fields */ }

Client for AWS CodeStar

Client for invoking operations on AWS CodeStar. Each operation on AWS CodeStar 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_codestar::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_codestar::config::Builder::from(&shared_config)
  .retry_config(RetryConfig::disabled())
  .build();
let client = aws_sdk_codestar::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 associate_team_member(&self) -> AssociateTeamMember

Constructs a fluent builder for the AssociateTeamMember operation.

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

    The ID of the project to which you will add the IAM user.

  • client_request_token(impl Into<String>) / set_client_request_token(Option<String>):

    A user- or system-generated token that identifies the entity that requested the team member association to the project. This token can be used to repeat the request.

  • user_arn(impl Into<String>) / set_user_arn(Option<String>):

    The Amazon Resource Name (ARN) for the IAM user you want to add to the AWS CodeStar project.

  • project_role(impl Into<String>) / set_project_role(Option<String>):

    The AWS CodeStar project role that will apply to this user. This role determines what actions a user can take in an AWS CodeStar project.

  • remote_access_allowed(bool) / set_remote_access_allowed(Option<bool>):

    Whether the team member is allowed to use an SSH public/private key pair to remotely access project resources, for example Amazon EC2 instances.

• On success, responds with AssociateTeamMemberOutput with field(s):
  • client_request_token(Option<String>):

    The user- or system-generated token from the initial request that can be used to repeat the request.

• On failure, responds with SdkError<AssociateTeamMemberError>

pub fn create_project(&self) -> CreateProject

Constructs a fluent builder for the CreateProject operation.

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

    The display name for the project to be created in AWS CodeStar.

  • id(impl Into<String>) / set_id(Option<String>):

    The ID of the project to be created in AWS CodeStar.

  • description(impl Into<String>) / set_description(Option<String>):

    The description of the project, if any.

  • client_request_token(impl Into<String>) / set_client_request_token(Option<String>):

    A user- or system-generated token that identifies the entity that requested project creation. This token can be used to repeat the request.

  • source_code(Vec<Code>) / set_source_code(Option<Vec<Code>>):

    A list of the Code objects submitted with the project request. If this parameter is specified, the request must also include the toolchain parameter.

  • toolchain(Toolchain) / set_toolchain(Option<Toolchain>):

    The name of the toolchain template file submitted with the project request. If this parameter is specified, the request must also include the sourceCode parameter.

  • tags(HashMap<String, String>) / set_tags(Option<HashMap<String, String>>):

    The tags created for the project.

• On success, responds with CreateProjectOutput with field(s):
  • id(Option<String>):

    The ID of the project.

  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the created project.

  • client_request_token(Option<String>):

    A user- or system-generated token that identifies the entity that requested project creation.

  • project_template_id(Option<String>):

    Reserved for future use.

• On failure, responds with SdkError<CreateProjectError>

pub fn create_user_profile(&self) -> CreateUserProfile

Constructs a fluent builder for the CreateUserProfile operation.

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

    The Amazon Resource Name (ARN) of the user in IAM.

  • display_name(impl Into<String>) / set_display_name(Option<String>):

    The name that will be displayed as the friendly name for the user in AWS CodeStar.

  • email_address(impl Into<String>) / set_email_address(Option<String>):

    The email address that will be displayed as part of the user’s profile in AWS CodeStar.

  • ssh_public_key(impl Into<String>) / set_ssh_public_key(Option<String>):

    The SSH public key associated with the user in AWS CodeStar. If a project owner allows the user remote access to project resources, this public key will be used along with the user’s private key for SSH access.

• On success, responds with CreateUserProfileOutput with field(s):
  • user_arn(Option<String>):

    The Amazon Resource Name (ARN) of the user in IAM.

  • display_name(Option<String>):

    The name that is displayed as the friendly name for the user in AWS CodeStar.

  • email_address(Option<String>):

    The email address that is displayed as part of the user’s profile in AWS CodeStar.

  • ssh_public_key(Option<String>):

    The SSH public key associated with the user in AWS CodeStar. This is the public portion of the public/private keypair the user can use to access project resources if a project owner allows the user remote access to those resources.

  • created_timestamp(Option<DateTime>):

    The date the user profile was created, in timestamp format.

  • last_modified_timestamp(Option<DateTime>):

    The date the user profile was last modified, in timestamp format.

• On failure, responds with SdkError<CreateUserProfileError>

pub fn delete_project(&self) -> DeleteProject

Constructs a fluent builder for the DeleteProject operation.

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

    The ID of the project to be deleted in AWS CodeStar.

  • client_request_token(impl Into<String>) / set_client_request_token(Option<String>):

    A user- or system-generated token that identifies the entity that requested project deletion. This token can be used to repeat the request.

  • delete_stack(bool) / set_delete_stack(bool):

    Whether to send a delete request for the primary stack in AWS CloudFormation originally used to generate the project and its resources. This option will delete all AWS resources for the project (except for any buckets in Amazon S3) as well as deleting the project itself. Recommended for most use cases.

• On success, responds with DeleteProjectOutput with field(s):
  • stack_id(Option<String>):

    The ID of the primary stack in AWS CloudFormation that will be deleted as part of deleting the project and its resources.

  • project_arn(Option<String>):

    The Amazon Resource Name (ARN) of the deleted project.

• On failure, responds with SdkError<DeleteProjectError>

pub fn delete_user_profile(&self) -> DeleteUserProfile

Constructs a fluent builder for the DeleteUserProfile operation.

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

    The Amazon Resource Name (ARN) of the user to delete from AWS CodeStar.

• On success, responds with DeleteUserProfileOutput with field(s):
  • user_arn(Option<String>):

    The Amazon Resource Name (ARN) of the user deleted from AWS CodeStar.

• On failure, responds with SdkError<DeleteUserProfileError>

pub fn describe_project(&self) -> DescribeProject

Constructs a fluent builder for the DescribeProject operation.

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

    The ID of the project.

• On success, responds with DescribeProjectOutput with field(s):
  • name(Option<String>):

    The display name for the project.

  • id(Option<String>):

    The ID of the project.

  • arn(Option<String>):

    The Amazon Resource Name (ARN) for the project.

  • description(Option<String>):

    The description of the project, if any.

  • client_request_token(Option<String>):

    A user- or system-generated token that identifies the entity that requested project creation.

  • created_time_stamp(Option<DateTime>):

    The date and time the project was created, in timestamp format.

  • stack_id(Option<String>):

    The ID of the primary stack in AWS CloudFormation used to generate resources for the project.

  • project_template_id(Option<String>):

    The ID for the AWS CodeStar project template used to create the project.

  • status(Option<ProjectStatus>):

    The project creation or deletion status.

• On failure, responds with SdkError<DescribeProjectError>

pub fn describe_user_profile(&self) -> DescribeUserProfile

Constructs a fluent builder for the DescribeUserProfile operation.

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

    The Amazon Resource Name (ARN) of the user.

• On success, responds with DescribeUserProfileOutput with field(s):
  • user_arn(Option<String>):

    The Amazon Resource Name (ARN) of the user.

  • display_name(Option<String>):

    The display name shown for the user in AWS CodeStar projects. For example, this could be set to both first and last name (“Mary Major”) or a single name (“Mary”). The display name is also used to generate the initial icon associated with the user in AWS CodeStar projects. If spaces are included in the display name, the first character that appears after the space will be used as the second character in the user initial icon. The initial icon displays a maximum of two characters, so a display name with more than one space (for example “Mary Jane Major”) would generate an initial icon using the first character and the first character after the space (“MJ”, not “MM”).

  • email_address(Option<String>):

    The email address for the user. Optional.

  • ssh_public_key(Option<String>):

    The SSH public key associated with the user. This SSH public key is associated with the user profile, and can be used in conjunction with the associated private key for access to project resources, such as Amazon EC2 instances, if a project owner grants remote access to those resources.

  • created_timestamp(Option<DateTime>):

    The date and time when the user profile was created in AWS CodeStar, in timestamp format.

  • last_modified_timestamp(Option<DateTime>):

    The date and time when the user profile was last modified, in timestamp format.

• On failure, responds with SdkError<DescribeUserProfileError>

pub fn disassociate_team_member(&self) -> DisassociateTeamMember

Constructs a fluent builder for the DisassociateTeamMember operation.

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

    The ID of the AWS CodeStar project from which you want to remove a team member.

  • user_arn(impl Into<String>) / set_user_arn(Option<String>):

    The Amazon Resource Name (ARN) of the IAM user or group whom you want to remove from the project.

• On success, responds with DisassociateTeamMemberOutput
• On failure, responds with SdkError<DisassociateTeamMemberError>

pub fn list_projects(&self) -> ListProjects

Constructs a fluent builder for the ListProjects operation.

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

    The continuation token to be used to return the next set of results, if the results cannot be returned in one response.

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

    The maximum amount of data that can be contained in a single set of results.

• On success, responds with ListProjectsOutput with field(s):
  • projects(Option<Vec<ProjectSummary>>):

    A list of projects.

  • next_token(Option<String>):

    The continuation token to use when requesting the next set of results, if there are more results to be returned.

• On failure, responds with SdkError<ListProjectsError>

pub fn list_resources(&self) -> ListResources

Constructs a fluent builder for the ListResources operation.

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

    The ID of the project.

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

    The continuation token for the next set of results, if the results cannot be returned in one response.

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

    The maximum amount of data that can be contained in a single set of results.

• On success, responds with ListResourcesOutput with field(s):
  • resources(Option<Vec<Resource>>):

    An array of resources associated with the project.

  • next_token(Option<String>):

    The continuation token to use when requesting the next set of results, if there are more results to be returned.

• On failure, responds with SdkError<ListResourcesError>

pub fn list_tags_for_project(&self) -> ListTagsForProject

Constructs a fluent builder for the ListTagsForProject operation.

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

    The ID of the project to get tags for.

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

    Reserved for future use.

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

    Reserved for future use.

• On success, responds with ListTagsForProjectOutput with field(s):
  • tags(Option<HashMap<String, String>>):

    The tags for the project.

  • next_token(Option<String>):

    Reserved for future use.

• On failure, responds with SdkError<ListTagsForProjectError>

pub fn list_team_members(&self) -> ListTeamMembers

Constructs a fluent builder for the ListTeamMembers operation.

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

    The ID of the project for which you want to list team members.

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

    The continuation token for the next set of results, if the results cannot be returned in one response.

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

    The maximum number of team members you want returned in a response.

• On success, responds with ListTeamMembersOutput with field(s):
  • team_members(Option<Vec<TeamMember>>):

    A list of team member objects for the project.

  • next_token(Option<String>):

    The continuation token to use when requesting the next set of results, if there are more results to be returned.

• On failure, responds with SdkError<ListTeamMembersError>

pub fn list_user_profiles(&self) -> ListUserProfiles

Constructs a fluent builder for the ListUserProfiles operation.

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

    The continuation token for the next set of results, if the results cannot be returned in one response.

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

    The maximum number of results to return in a response.

• On success, responds with ListUserProfilesOutput with field(s):
  • user_profiles(Option<Vec<UserProfileSummary>>):

    All the user profiles configured in AWS CodeStar for an AWS account.

  • next_token(Option<String>):

    The continuation token to use when requesting the next set of results, if there are more results to be returned.

• On failure, responds with SdkError<ListUserProfilesError>

pub fn tag_project(&self) -> TagProject

Constructs a fluent builder for the TagProject operation.

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

    The ID of the project you want to add a tag to.

  • tags(HashMap<String, String>) / set_tags(Option<HashMap<String, String>>):

    The tags you want to add to the project.

• On success, responds with TagProjectOutput with field(s):
  • tags(Option<HashMap<String, String>>):

    The tags for the project.

• On failure, responds with SdkError<TagProjectError>

pub fn untag_project(&self) -> UntagProject

Constructs a fluent builder for the UntagProject operation.

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

    The ID of the project to remove tags from.

  • tags(Vec<String>) / set_tags(Option<Vec<String>>):

    The tags to remove from the project.

• On success, responds with UntagProjectOutput
• On failure, responds with SdkError<UntagProjectError>

pub fn update_project(&self) -> UpdateProject

Constructs a fluent builder for the UpdateProject operation.

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

    The ID of the project you want to update.

  • name(impl Into<String>) / set_name(Option<String>):

    The name of the project you want to update.

  • description(impl Into<String>) / set_description(Option<String>):

    The description of the project, if any.

• On success, responds with UpdateProjectOutput
• On failure, responds with SdkError<UpdateProjectError>

pub fn update_team_member(&self) -> UpdateTeamMember

Constructs a fluent builder for the UpdateTeamMember operation.

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

    The ID of the project.

  • user_arn(impl Into<String>) / set_user_arn(Option<String>):

    The Amazon Resource Name (ARN) of the user for whom you want to change team membership attributes.

  • project_role(impl Into<String>) / set_project_role(Option<String>):

    The role assigned to the user in the project. Project roles have different levels of access. For more information, see Working with Teams in the AWS CodeStar User Guide.

  • remote_access_allowed(bool) / set_remote_access_allowed(Option<bool>):

    Whether a team member is allowed to remotely access project resources using the SSH public key associated with the user’s profile. Even if this is set to True, the user must associate a public key with their profile before the user can access resources.

• On success, responds with UpdateTeamMemberOutput with field(s):
  • user_arn(Option<String>):

    The Amazon Resource Name (ARN) of the user whose team membership attributes were updated.

  • project_role(Option<String>):

    The project role granted to the user.

  • remote_access_allowed(Option<bool>):

    Whether a team member is allowed to remotely access project resources using the SSH public key associated with the user’s profile.

• On failure, responds with SdkError<UpdateTeamMemberError>

pub fn update_user_profile(&self) -> UpdateUserProfile

Constructs a fluent builder for the UpdateUserProfile operation.

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

    The name that will be displayed as the friendly name for the user in AWS CodeStar.

  • display_name(impl Into<String>) / set_display_name(Option<String>):

    The name that is displayed as the friendly name for the user in AWS CodeStar.

  • email_address(impl Into<String>) / set_email_address(Option<String>):

    The email address that is displayed as part of the user’s profile in AWS CodeStar.

  • ssh_public_key(impl Into<String>) / set_ssh_public_key(Option<String>):

    The SSH public key associated with the user in AWS CodeStar. If a project owner allows the user remote access to project resources, this public key will be used along with the user’s private key for SSH access.

• On success, responds with UpdateUserProfileOutput with field(s):
  • user_arn(Option<String>):

    The Amazon Resource Name (ARN) of the user in IAM.

  • display_name(Option<String>):

    The name that is displayed as the friendly name for the user in AWS CodeStar.

  • email_address(Option<String>):

    The email address that is displayed as part of the user’s profile in AWS CodeStar.

  • ssh_public_key(Option<String>):

    The SSH public key associated with the user in AWS CodeStar. This is the public portion of the public/private keypair the user can use to access project resources if a project owner allows the user remote access to those resources.

  • created_timestamp(Option<DateTime>):

    The date the user profile was created, in timestamp format.

  • last_modified_timestamp(Option<DateTime>):

    The date the user profile was last modified, in timestamp format.

• On failure, responds with SdkError<UpdateUserProfileError>

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.