[ aws . ram ]

accept-resource-share-invitation

Description

Accepts an invitation to a resource share from another Amazon Web Services account.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  accept-resource-share-invitation
--resource-share-invitation-arn <value>
[--client-token <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--resource-share-invitation-arn (string)

The Amazon Resource Name (ARN) of the invitation.

--client-token (string)

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

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Examples

To accept a resource share invitation

The following reject-resource-share-invitation example rejects the specified resource share invitation.

aws ram reject-resource-share-invitation \
    --resource-share-invitation-arn arn:aws:ram:us-west-2:123456789012:resource-share-invitation/arn:aws:ram:us-east-1:210774411744:resource-share-invitation/32b639f0-14b8-7e8f-55ea-e6117EXAMPLE

Output:

{
    "resourceShareInvitations": [
        {
            "resourceShareInvitationArn": "arn:aws:ram:us-west2-1:21077EXAMPLE:resource-share-invitation/32b639f0-14b8-7e8f-55ea-e6117EXAMPLE",
            "resourceShareName": "project-resource-share",
            "resourceShareArn": "arn:aws:ram:us-west-2:21077EXAMPLE:resource-share/fcb639f0-1449-4744-35bc-a983fc0d4ce1",
            "senderAccountId": "21077EXAMPLE",
            "receiverAccountId": "123456789012",
            "invitationTimestamp": 1565319592.463,
            "status": "ACCEPTED"
        }
    ]
}

Output

resourceShareInvitation -> (structure)

Information about the invitation.

resourceShareInvitationArn -> (string)

The Amazon Resource Name (ARN) of the invitation.

resourceShareName -> (string)

The name of the resource share.

resourceShareArn -> (string)

The Amazon Resource Name (ARN) of the resource share.

senderAccountId -> (string)

The ID of the Amazon Web Services account that sent the invitation.

receiverAccountId -> (string)

The ID of the Amazon Web Services account that received the invitation.

invitationTimestamp -> (timestamp)

The date and time when the invitation was sent.

status -> (string)

The status of the invitation.

resourceShareAssociations -> (list)

To view the resources associated with a pending resource share invitation, use ListPendingInvitationResources .

(structure)

Describes an association with a resource share.

resourceShareArn -> (string)

The Amazon Resource Name (ARN) of the resource share.

resourceShareName -> (string)

The name of the resource share.

associatedEntity -> (string)

The associated entity. For resource associations, this is the Amazon Resource Name (ARN) of the resource. For principal associations, this is one of the following:

  • An Amazon Web Services account ID

  • An 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

associationType -> (string)

The association type.

status -> (string)

The status of the association.

statusMessage -> (string)

A message about the status of the association.

creationTime -> (timestamp)

The time when the association was created.

lastUpdatedTime -> (timestamp)

The time when the association was last updated.

external -> (boolean)

Indicates whether the principal belongs to the same organization in Organizations as the Amazon Web Services account that owns the resource share.

receiverArn -> (string)

The Amazon Resource Name (ARN) of the IAM user or IAM role that received the invitation.

clientToken -> (string)

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