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 = [] )
Amazon S3 on Outposts Access Points simplify managing data access at scale for shared datasets in S3 on Outposts.
- DeleteEndpoint ( array $params = [] )
Amazon S3 on Outposts Access Points simplify managing data access at scale for shared datasets in S3 on Outposts.
- ListEndpoints ( array $params = [] )
Amazon S3 on Outposts Access Points simplify managing data access at scale for shared datasets in 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([/* ... */]);
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.
This action creates an endpoint and associates it with the specified Outposts.
It can take up to 5 minutes for this action to complete.
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 on-premise network connectivity for the Outpost endpoint. To access the endpoint from an on-premises network, you must specify the access type and provide the customer owned IPv4 pool.
- CustomerOwnedIpv4Pool
-
- Type: string
The ID of the customer-owned IPv4 pool for the endpoint. IP addresses will be allocated from this pool for the endpoint.
- OutpostId
-
- Required: Yes
- Type: string
The ID of the AWS 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 the 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([/* ... */]);
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.
This action deletes an endpoint.
It can take up to 5 minutes for this action to complete.
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([/* ... */]);
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.
This action lists endpoints associated with the Outposts.
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
Returns an array of endpoints associated with AWS Outposts.
- 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
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.
Members
- AccessType
-
- Type: string
- 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 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 AWS 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.