Amazon S3 on Outposts 2017-07-25
- Client: Aws\S3Outposts\S3OutpostsClient
- Service ID: s3outposts
- Version: 2017-07-25
This page describes the parameters and results for the operations of the Amazon S3 on Outposts (2017-07-25), and shows how to use the Aws\S3Outposts\S3OutpostsClient object to call the described operations. This documentation is specific to the 2017-07-25 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName')
, where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */)
.
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */)
.
- CreateEndpoint ( array $params = [] )
Creates an endpoint and associates it with the specified Outpost.
- DeleteEndpoint ( array $params = [] )
Deletes an endpoint.
- ListEndpoints ( array $params = [] )
Lists endpoints associated with the specified Outpost.
- ListSharedEndpoints ( array $params = [] )
Lists all endpoints associated with an Outpost that has been shared by Amazon Web Services Resource Access Manager (RAM).
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
Operations
CreateEndpoint
$result = $client->createEndpoint
([/* ... */]); $promise = $client->createEndpointAsync
([/* ... */]);
Creates an endpoint and associates it with the specified Outpost.
It can take up to 5 minutes for this action to finish.
Related actions include:
Parameter Syntax
$result = $client->createEndpoint([ 'AccessType' => 'Private|CustomerOwnedIp', 'CustomerOwnedIpv4Pool' => '<string>', 'OutpostId' => '<string>', // REQUIRED 'SecurityGroupId' => '<string>', // REQUIRED 'SubnetId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- AccessType
-
- Type: string
The type of access for the network connectivity for the Amazon S3 on Outposts endpoint. To use the Amazon Web Services VPC, choose
Private
. To use the endpoint with an on-premises network, chooseCustomerOwnedIp
. If you chooseCustomerOwnedIp
, you must also provide the customer-owned IP address pool (CoIP pool).Private
is the default access type value. - CustomerOwnedIpv4Pool
-
- Type: string
The ID of the customer-owned IPv4 address pool (CoIP pool) for the endpoint. IP addresses are allocated from this pool for the endpoint.
- OutpostId
-
- Required: Yes
- Type: string
The ID of the Outposts.
- SecurityGroupId
-
- Required: Yes
- Type: string
The ID of the security group to use with the endpoint.
- SubnetId
-
- Required: Yes
- Type: string
The ID of the subnet in the selected VPC. The endpoint subnet must belong to the Outpost that has Amazon S3 on Outposts provisioned.
Result Syntax
[ 'EndpointArn' => '<string>', ]
Result Details
Errors
-
There was an exception with the internal server.
-
There was an exception validating this data.
-
Access was denied for this action.
-
The requested resource was not found.
-
There was a conflict with this action, and it could not be completed.
DeleteEndpoint
$result = $client->deleteEndpoint
([/* ... */]); $promise = $client->deleteEndpointAsync
([/* ... */]);
Deletes an endpoint.
It can take up to 5 minutes for this action to finish.
Related actions include:
Parameter Syntax
$result = $client->deleteEndpoint([ 'EndpointId' => '<string>', // REQUIRED 'OutpostId' => '<string>', // REQUIRED ]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
There was an exception with the internal server.
-
Access was denied for this action.
-
The requested resource was not found.
-
There was an exception validating this data.
ListEndpoints
$result = $client->listEndpoints
([/* ... */]); $promise = $client->listEndpointsAsync
([/* ... */]);
Lists endpoints associated with the specified Outpost.
Related actions include:
Parameter Syntax
$result = $client->listEndpoints([ 'MaxResults' => <integer>, 'NextToken' => '<string>', ]);
Parameter Details
Members
Result Syntax
[ 'Endpoints' => [ [ 'AccessType' => 'Private|CustomerOwnedIp', 'CidrBlock' => '<string>', 'CreationTime' => <DateTime>, 'CustomerOwnedIpv4Pool' => '<string>', 'EndpointArn' => '<string>', 'NetworkInterfaces' => [ [ 'NetworkInterfaceId' => '<string>', ], // ... ], 'OutpostsId' => '<string>', 'SecurityGroupId' => '<string>', 'Status' => 'Pending|Available|Deleting', 'SubnetId' => '<string>', 'VpcId' => '<string>', ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Endpoints
-
- Type: Array of Endpoint structures
The list of endpoints associated with the specified Outpost.
- NextToken
-
- Type: 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.
Errors
-
There was an exception with the internal server.
-
The requested resource was not found.
-
Access was denied for this action.
-
There was an exception validating this data.
ListSharedEndpoints
$result = $client->listSharedEndpoints
([/* ... */]); $promise = $client->listSharedEndpointsAsync
([/* ... */]);
Lists all endpoints associated with an Outpost that has been shared by Amazon Web Services Resource Access Manager (RAM).
Related actions include:
Parameter Syntax
$result = $client->listSharedEndpoints([ 'MaxResults' => <integer>, 'NextToken' => '<string>', 'OutpostId' => '<string>', // REQUIRED ]);
Parameter Details
Members
- MaxResults
-
- Type: int
The maximum number of endpoints that will be returned in the response.
- NextToken
-
- Type: string
If a previous response from this operation included a
NextToken
value, you can provide that value here to retrieve the next page of results. - OutpostId
-
- Required: Yes
- Type: string
The ID of the Amazon Web Services Outpost.
Result Syntax
[ 'Endpoints' => [ [ 'AccessType' => 'Private|CustomerOwnedIp', 'CidrBlock' => '<string>', 'CreationTime' => <DateTime>, 'CustomerOwnedIpv4Pool' => '<string>', 'EndpointArn' => '<string>', 'NetworkInterfaces' => [ [ 'NetworkInterfaceId' => '<string>', ], // ... ], 'OutpostsId' => '<string>', 'SecurityGroupId' => '<string>', 'Status' => 'Pending|Available|Deleting', 'SubnetId' => '<string>', 'VpcId' => '<string>', ], // ... ], 'NextToken' => '<string>', ]
Result Details
Members
- Endpoints
-
- Type: Array of Endpoint structures
The list of endpoints associated with the specified Outpost that have been shared by Amazon Web Services Resource Access Manager (RAM).
- NextToken
-
- Type: 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.
Errors
-
There was an exception with the internal server.
-
The requested resource was not found.
-
Access was denied for this action.
-
There was an exception validating this data.
Shapes
AccessDeniedException
ConflictException
Description
There was a conflict with this action, and it could not be completed.
Members
Endpoint
Description
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.
Members
- AccessType
-
- Type: string
The type of connectivity used to access the Amazon S3 on Outposts endpoint.
- CidrBlock
-
- Type: string
The VPC CIDR committed by this endpoint.
- CreationTime
-
- Type: timestamp (string|DateTime or anything parsable by strtotime)
The time the endpoint was created.
- CustomerOwnedIpv4Pool
-
- Type: string
The ID of the customer-owned IPv4 address pool used for the endpoint.
- EndpointArn
-
- Type: string
The Amazon Resource Name (ARN) of the endpoint.
- NetworkInterfaces
-
- Type: Array of NetworkInterface structures
The network interface of the endpoint.
- OutpostsId
-
- Type: string
The ID of the Outposts.
- SecurityGroupId
-
- Type: string
The ID of the security group used for the endpoint.
- Status
-
- Type: string
The status of the endpoint.
- SubnetId
-
- Type: string
The ID of the subnet used for the endpoint.
- VpcId
-
- Type: string
The ID of the VPC used for the endpoint.
InternalServerException
NetworkInterface
Description
The container for the network interface.