S3Outposts / Client / list_outposts_with_s3

list_outposts_with_s3#

S3Outposts.Client.list_outposts_with_s3(**kwargs)#

Lists the Outposts with S3 on Outposts capacity for your Amazon Web Services account. Includes S3 on Outposts that you have access to as the Outposts owner, or as a shared user from Resource Access Manager (RAM).

See also: AWS API Documentation

Request Syntax

response = client.list_outposts_with_s3(
    NextToken='string',
    MaxResults=123
)
Parameters:

  • NextToken (string) – When you can get additional results from the ListOutpostsWithS3 call, a NextToken parameter is returned in the output. You can then pass in a subsequent command to the NextToken parameter to continue listing additional Outposts.

  • MaxResults (integer) – The maximum number of Outposts to return. The limit is 100.

Return type:

dict

Returns:

Response Syntax

{
    'Outposts': [
        {
            'OutpostArn': 'string',
            'OutpostId': 'string',
            'OwnerId': 'string',
            'CapacityInBytes': 123
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • Outposts (list) –

      Returns the list of Outposts that have the following characteristics:

      • outposts that have S3 provisioned

      • outposts that are Active (not pending any provisioning nor decommissioned)

      • outposts to which the the calling Amazon Web Services account has access

      • (dict) –

        Contains the details for the Outpost object.

        • OutpostArn (string) –

          Specifies the unique Amazon Resource Name (ARN) for the outpost.

        • OutpostId (string) –

          Specifies the unique identifier for the outpost.

        • OwnerId (string) –

          Returns the Amazon Web Services account ID of the outpost owner. Useful for comparing owned versus shared outposts.

        • CapacityInBytes (integer) –

          The Amazon S3 capacity of the outpost in bytes.

    • NextToken (string) –

      Returns a token that you can use to call ListOutpostsWithS3 again and receive additional results, if there are any.

Exceptions

  • S3Outposts.Client.exceptions.InternalServerException

  • S3Outposts.Client.exceptions.AccessDeniedException

  • S3Outposts.Client.exceptions.ValidationException

  • S3Outposts.Client.exceptions.ThrottlingException