Struct aws_sdk_ram::client::fluent_builders::CreateResourceShare

pub struct CreateResourceShare<C = DynConnector, M = DefaultMiddleware, R = Standard> { /* fields omitted */ }

Fluent builder constructing a request to CreateResourceShare.

Creates a resource share. You must provide a list of the Amazon Resource Names (ARNs) for the resources you want to share. You must also specify who you want to share the resources with, and the permissions that you grant them.

Sharing a resource makes it available for use by principals outside of the Amazon Web Services account that created the resource. Sharing doesn't change any permissions or quotas that apply to the resource in the account that created it.

Implementations

impl<C, M, R> CreateResourceShare<C, M, R> where
    C: SmithyConnector,
    M: SmithyMiddleware<C>,
    R: NewRequestPolicy, 

pub async fn send(
    self
) -> Result<CreateResourceShareOutput, SdkError<CreateResourceShareError>> where
    R::Policy: SmithyRetryPolicy<CreateResourceShareInputOperationOutputAlias, CreateResourceShareOutput, CreateResourceShareError, CreateResourceShareInputOperationRetryAlias>, 

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 name(self, inp: impl Into<String>) -> Self

The name of the resource share.

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

The name of the resource share.

pub fn resource_arns(self, inp: impl Into<String>) -> Self

Appends an item to resourceArns.

To override the contents of this collection use set_resource_arns.

The ARNs of the resources to associate with the resource share.

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

The ARNs of the resources to associate with the resource share.

pub fn principals(self, inp: impl Into<String>) -> Self

Appends an item to principals.

To override the contents of this collection use set_principals.

The principals to associate with the resource share. The possible values are:

• An Amazon Web Services account ID

• An Amazon Resource Name (ARN) of an organization in Organizations

• An ARN of an organizational unit (OU) in Organizations

• An ARN of an IAM role

• An ARN of an IAM user

Not all resource types can be shared with IAM roles and IAM users. For more information, see Sharing with IAM roles and IAM users in the Resource Access Manager User Guide.

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

The principals to associate with the resource share. The possible values are:

• An Amazon Web Services account ID

• An Amazon Resource Name (ARN) of an organization in Organizations

• An ARN of an organizational unit (OU) in Organizations

• An ARN of an IAM role

• An ARN of an IAM user

Not all resource types can be shared with IAM roles and IAM users. For more information, see Sharing with IAM roles and IAM users in the Resource Access Manager User Guide.

pub fn tags(self, inp: impl Into<Tag>) -> Self

Appends an item to tags.

To override the contents of this collection use set_tags.

One or more tags.

pub fn set_tags(self, input: Option<Vec<Tag>>) -> Self

One or more tags.

pub fn allow_external_principals(self, inp: bool) -> Self

Indicates whether principals outside your organization in Organizations can be associated with a resource share.

pub fn set_allow_external_principals(self, input: Option<bool>) -> Self

Indicates whether principals outside your organization in Organizations can be associated with a resource share.

pub fn client_token(self, inp: impl Into<String>) -> Self

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

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

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

pub fn permission_arns(self, inp: impl Into<String>) -> Self

Appends an item to permissionArns.

To override the contents of this collection use set_permission_arns.

The Amazon Resource Names (ARNs) of the permissions to associate with the resource share. If you do not specify an ARN for the permission, RAM automatically attaches the default version of the permission for each resource type. Only one permission can be associated with each resource type in a resource share.

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

The Amazon Resource Names (ARNs) of the permissions to associate with the resource share. If you do not specify an ARN for the permission, RAM automatically attaches the default version of the permission for each resource type. Only one permission can be associated with each resource type in a resource share.

Trait Implementations

impl<C: Debug, M: Debug, R: Debug> Debug for CreateResourceShare<C, M, R>

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

Formats the value using the given formatter.