list_endpoints

S3Outposts.Client.list_endpoints(**kwargs)

Lists endpoints associated with the specified Outpost.

Related actions include:

• CreateEndpoint
• DeleteEndpoint

See also: AWS API Documentation

Request Syntax

response = client.list_endpoints(
    NextToken='string',
    MaxResults=123
)

Parameters

• NextToken (string) -- If a previous response from this operation included a NextToken value, provide that value here to retrieve the next page of results.
• MaxResults (integer) -- The maximum number of endpoints that will be returned in the response.

Return type

dict

Returns

Response Syntax

{
    'Endpoints': [
        {
            'EndpointArn': 'string',
            'OutpostsId': 'string',
            'CidrBlock': 'string',
            'Status': 'Pending'|'Available'|'Deleting',
            'CreationTime': datetime(2015, 1, 1),
            'NetworkInterfaces': [
                {
                    'NetworkInterfaceId': 'string'
                },
            ],
            'VpcId': 'string',
            'SubnetId': 'string',
            'SecurityGroupId': 'string',
            'AccessType': 'Private'|'CustomerOwnedIp',
            'CustomerOwnedIpv4Pool': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) --

  • Endpoints (list) --

    The list of endpoints associated with the specified Outpost.

    • (dict) --

      Amazon S3 on Outposts Access Points simplify managing data access at scale for shared datasets in S3 on Outposts. S3 on Outposts uses endpoints to connect to Outposts buckets so that you can perform actions within your virtual private cloud (VPC). For more information, see Accessing S3 on Outposts using VPC-only access points in the Amazon Simple Storage Service User Guide .

      • EndpointArn (string) --

        The Amazon Resource Name (ARN) of the endpoint.

      • OutpostsId (string) --

        The ID of the Outposts.

      • CidrBlock (string) --

        The VPC CIDR committed by this endpoint.

      • Status (string) --

        The status of the endpoint.

      • CreationTime (datetime) --

        The time the endpoint was created.

      • NetworkInterfaces (list) --

        The network interface of the endpoint.

        • (dict) --

          The container for the network interface.

          • NetworkInterfaceId (string) --

            The ID for the network interface.

      • VpcId (string) --

        The ID of the VPC used for the endpoint.

      • SubnetId (string) --

        The ID of the subnet used for the endpoint.

      • SecurityGroupId (string) --

        The ID of the security group used for the endpoint.

      • AccessType (string) --

        The type of connectivity used to access the Amazon S3 on Outposts endpoint.

      • CustomerOwnedIpv4Pool (string) --

        The ID of the customer-owned IPv4 address pool used for the endpoint.

  • NextToken (string) --

    If the number of endpoints associated with the specified Outpost exceeds MaxResults , you can include this value in subsequent calls to this operation to retrieve more results.

Exceptions

• S3Outposts.Client.exceptions.InternalServerException
• S3Outposts.Client.exceptions.ResourceNotFoundException
• S3Outposts.Client.exceptions.AccessDeniedException
• S3Outposts.Client.exceptions.ValidationException
• S3Outposts.Client.exceptions.ThrottlingException