Struct aws_sdk_iam::client::fluent_builders::AddRoleToInstanceProfile

pub struct AddRoleToInstanceProfile { /* private fields */ }

Fluent builder constructing a request to AddRoleToInstanceProfile.

Adds the specified IAM role to the specified instance profile. An instance profile can contain only one role, and this quota cannot be increased. You can remove the existing role and then add a different role to an instance profile. You must then wait for the change to appear across all of Amazon Web Services because of eventual consistency. To force the change, you must disassociate the instance profile and then associate the instance profile, or you can stop your instance and then restart it.

The caller of this operation must be granted the PassRole permission on the IAM role by a permissions policy.

For more information about roles, see Working with roles. For more information about instance profiles, see About instance profiles.

Implementations

impl AddRoleToInstanceProfile

pub async fn customize(
    self
) -> Result<CustomizableOperation<AddRoleToInstanceProfile, AwsResponseRetryClassifier>, SdkError<AddRoleToInstanceProfileError>>

Consume this builder, creating a customizable operation that can be modified before being sent. The operation’s inner http::Request can be modified as well.

pub async fn send(
    self
) -> Result<AddRoleToInstanceProfileOutput, SdkError<AddRoleToInstanceProfileError>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn instance_profile_name(self, input: impl Into<String>) -> Self

The name of the instance profile to update.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

pub fn set_instance_profile_name(self, input: Option<String>) -> Self

The name of the instance profile to update.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

pub fn role_name(self, input: impl Into<String>) -> Self

The name of the role to add.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

pub fn set_role_name(self, input: Option<String>) -> Self

The name of the role to add.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

Trait Implementations

impl Clone for AddRoleToInstanceProfile

fn clone(&self) -> AddRoleToInstanceProfile

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AddRoleToInstanceProfile

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

Formats the value using the given formatter.