S3Control / Client / get_access_grants_instance

get_access_grants_instance#

S3Control.Client.get_access_grants_instance(**kwargs)#

Retrieves the S3 Access Grants instance for a Region in your account.

Permissions

You must have the s3:GetAccessGrantsInstance permission to use this operation.

Note

GetAccessGrantsInstance is not supported for cross-account access. You can only call the API from the account that owns the S3 Access Grants instance.

See also: AWS API Documentation

Request Syntax

response = client.get_access_grants_instance(
    AccountId='string'
)
Parameters:

AccountId (string) –

[REQUIRED]

The Amazon Web Services account ID of the S3 Access Grants instance.

Return type:

dict

Returns:

Response Syntax

{
    'AccessGrantsInstanceArn': 'string',
    'AccessGrantsInstanceId': 'string',
    'IdentityCenterArn': 'string',
    'IdentityCenterInstanceArn': 'string',
    'IdentityCenterApplicationArn': 'string',
    'CreatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) –

    • AccessGrantsInstanceArn (string) –

      The Amazon Resource Name (ARN) of the S3 Access Grants instance.

    • AccessGrantsInstanceId (string) –

      The ID of the S3 Access Grants instance. The ID is default. You can have one S3 Access Grants instance per Region per account.

    • IdentityCenterArn (string) –

      If you associated your S3 Access Grants instance with an Amazon Web Services IAM Identity Center instance, this field returns the Amazon Resource Name (ARN) of the IAM Identity Center instance application; a subresource of the original Identity Center instance. S3 Access Grants creates this Identity Center application for the specific S3 Access Grants instance.

    • IdentityCenterInstanceArn (string) –

      The Amazon Resource Name (ARN) of the Amazon Web Services IAM Identity Center instance that you are associating with your S3 Access Grants instance. An IAM Identity Center instance is your corporate identity directory that you added to the IAM Identity Center. You can use the ListInstances API operation to retrieve a list of your Identity Center instances and their ARNs.

    • IdentityCenterApplicationArn (string) –

      If you associated your S3 Access Grants instance with an Amazon Web Services IAM Identity Center instance, this field returns the Amazon Resource Name (ARN) of the IAM Identity Center instance application; a subresource of the original Identity Center instance. S3 Access Grants creates this Identity Center application for the specific S3 Access Grants instance.

    • CreatedAt (datetime) –

      The date and time when you created the S3 Access Grants instance.