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 = [] )
S3 on Outposts access points simplify managing data access at scale for shared datasets in Amazon S3 on Outposts.
- DeleteEndpoint ( array $params = [] )
S3 on Outposts access points simplify managing data access at scale for shared datasets in Amazon S3 on Outposts.
- ListEndpoints ( array $params = [] )
S3 on Outposts access points simplify managing data access at scale for shared datasets in Amazon S3 on Outposts.
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([/* ... */]);
S3 on Outposts access points simplify managing data access at scale for shared datasets in Amazon 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).
This action creates an endpoint and associates it with the specified Outpost.
Related actions include:
Parameter Syntax
$result = $client->createEndpoint([
'OutpostId' => '<string>', // REQUIRED
'SecurityGroupId' => '<string>', // REQUIRED
'SubnetId' => '<string>', // REQUIRED
]);
Parameter Details
Members
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([/* ... */]);
S3 on Outposts access points simplify managing data access at scale for shared datasets in Amazon 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).
This action deletes an endpoint.
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([/* ... */]);
S3 on Outposts access points simplify managing data access at scale for shared datasets in Amazon 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).
This action lists endpoints associated with the Outpost.
Related actions include:
Parameter Syntax
$result = $client->listEndpoints([
'MaxResults' => <integer>,
'NextToken' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'Endpoints' => [
[
'CidrBlock' => '<string>',
'CreationTime' => <DateTime>,
'EndpointArn' => '<string>',
'NetworkInterfaces' => [
[
'NetworkInterfaceId' => '<string>',
],
// ...
],
'OutpostsId' => '<string>',
'Status' => 'PENDING|AVAILABLE',
],
// ...
],
'NextToken' => '<string>',
]
Result Details
Members
- Endpoints
-
- Type: Array of Endpoint structures
Returns an array of endpoints associated with AWS Outpost.
- NextToken
-
- Type: string
The next endpoint returned in the list.
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
S3 on Outposts access points simplify managing data access at scale for shared datasets in Amazon 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).
Members
- 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.
- 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 AWS Outpost.
- Status
-
- Type: string
The status of the endpoint.
InternalServerException
NetworkInterface
Description
The container for the network interface.