com.amazonaws.services.outposts

Interface AWSOutposts

All Known Subinterfaces:

AWSOutpostsAsync

All Known Implementing Classes:

AbstractAWSOutposts, AbstractAWSOutpostsAsync, AWSOutpostsAsyncClient, AWSOutpostsClient

@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public interface AWSOutposts

Interface for accessing Outposts.

Note: Do not directly implement this interface, new methods are added to it regularly. Extend from AbstractAWSOutposts instead.

Amazon Web Services Outposts is a fully managed service that extends Amazon Web Services infrastructure, APIs, and tools to customer premises. By providing local access to Amazon Web Services managed infrastructure, Amazon Web Services Outposts enables customers to build and run applications on premises using the same programming interfaces as in Amazon Web Services Regions, while using local compute and storage resources for lower latency and local data processing needs.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ENDPOINT_PREFIX The region metadata service name for computing region endpoints.

Method Summary

Modifier and Type	Method and Description
CancelOrderResult	cancelOrder(CancelOrderRequest cancelOrderRequest) Cancels an order for an Outpost.
CreateOrderResult	createOrder(CreateOrderRequest createOrderRequest) Creates an order for an Outpost.
CreateOutpostResult	createOutpost(CreateOutpostRequest createOutpostRequest) Creates an Outpost.
CreateSiteResult	createSite(CreateSiteRequest createSiteRequest) Creates a site for an Outpost.
DeleteOutpostResult	deleteOutpost(DeleteOutpostRequest deleteOutpostRequest) Deletes the Outpost.
DeleteSiteResult	deleteSite(DeleteSiteRequest deleteSiteRequest) Deletes the site.
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected.
GetCatalogItemResult	getCatalogItem(GetCatalogItemRequest getCatalogItemRequest) Gets information about a catalog item.
GetOrderResult	getOrder(GetOrderRequest getOrderRequest) Gets an order.
GetOutpostResult	getOutpost(GetOutpostRequest getOutpostRequest) Gets information about the specified Outpost.
GetOutpostInstanceTypesResult	getOutpostInstanceTypes(GetOutpostInstanceTypesRequest getOutpostInstanceTypesRequest) Lists the instance types for the specified Outpost.
GetSiteResult	getSite(GetSiteRequest getSiteRequest) Gets information about the specified Outpost site.
GetSiteAddressResult	getSiteAddress(GetSiteAddressRequest getSiteAddressRequest) Gets the site address.
ListCatalogItemsResult	listCatalogItems(ListCatalogItemsRequest listCatalogItemsRequest) Use to create a list of every item in the catalog.
ListOrdersResult	listOrders(ListOrdersRequest listOrdersRequest) Create a list of the Outpost orders for your Amazon Web Services account.
ListOutpostsResult	listOutposts(ListOutpostsRequest listOutpostsRequest) Create a list of the Outposts for your Amazon Web Services account.
ListSitesResult	listSites(ListSitesRequest listSitesRequest) Lists the sites for your Amazon Web Services account.
ListTagsForResourceResult	listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists the tags for the specified resource.
void	shutdown() Shuts down this client object, releasing any resources that might be held open.
TagResourceResult	tagResource(TagResourceRequest tagResourceRequest) Adds tags to the specified resource.
UntagResourceResult	untagResource(UntagResourceRequest untagResourceRequest) Removes tags from the specified resource.
UpdateOutpostResult	updateOutpost(UpdateOutpostRequest updateOutpostRequest) Updates an Outpost.
UpdateSiteResult	updateSite(UpdateSiteRequest updateSiteRequest) Updates the site.
UpdateSiteAddressResult	updateSiteAddress(UpdateSiteAddressRequest updateSiteAddressRequest) Updates the site address.
UpdateSiteRackPhysicalPropertiesResult	updateSiteRackPhysicalProperties(UpdateSiteRackPhysicalPropertiesRequest updateSiteRackPhysicalPropertiesRequest) Update the physical and logistical details for a rack at a site.

Field Detail

ENDPOINT_PREFIX

static final String ENDPOINT_PREFIX

The region metadata service name for computing region endpoints. You can use this value to retrieve metadata (such as supported regions) of the service.

See Also:

RegionUtils.getRegionsForService(String), Constant Field Values

Method Detail

cancelOrder

CancelOrderResult cancelOrder(CancelOrderRequest cancelOrderRequest)

Cancels an order for an Outpost.

Parameters:

cancelOrderRequest -

Returns:

Result of the CancelOrder operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

ConflictException - Updating or deleting this resource can cause an inconsistent state.

AccessDeniedException - You do not have permission to perform this operation.

NotFoundException - The specified request is not valid.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

createOrder

CreateOrderResult createOrder(CreateOrderRequest createOrderRequest)

Creates an order for an Outpost.

Parameters:

createOrderRequest -

Returns:

Result of the CreateOrder operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

ConflictException - Updating or deleting this resource can cause an inconsistent state.

AccessDeniedException - You do not have permission to perform this operation.

NotFoundException - The specified request is not valid.

InternalServerException - An internal error has occurred.

ServiceQuotaExceededException - You have exceeded a service quota.

See Also:

AWS API Documentation

createOutpost

CreateOutpostResult createOutpost(CreateOutpostRequest createOutpostRequest)

Creates an Outpost.

You can specify AvailabilityZone or AvailabilityZoneId.

Parameters:

createOutpostRequest -

Returns:

Result of the CreateOutpost operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

ConflictException - Updating or deleting this resource can cause an inconsistent state.

NotFoundException - The specified request is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

ServiceQuotaExceededException - You have exceeded a service quota.

See Also:

AWS API Documentation

createSite

CreateSiteResult createSite(CreateSiteRequest createSiteRequest)

Creates a site for an Outpost.

Parameters:

createSiteRequest -

Returns:

Result of the CreateSite operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

ConflictException - Updating or deleting this resource can cause an inconsistent state.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

ServiceQuotaExceededException - You have exceeded a service quota.

See Also:

AWS API Documentation

deleteOutpost

DeleteOutpostResult deleteOutpost(DeleteOutpostRequest deleteOutpostRequest)

Deletes the Outpost.

Parameters:

deleteOutpostRequest -

Returns:

Result of the DeleteOutpost operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

ConflictException - Updating or deleting this resource can cause an inconsistent state.

NotFoundException - The specified request is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

deleteSite

DeleteSiteResult deleteSite(DeleteSiteRequest deleteSiteRequest)

Deletes the site.

Parameters:

deleteSiteRequest -

Returns:

Result of the DeleteSite operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

ConflictException - Updating or deleting this resource can cause an inconsistent state.

NotFoundException - The specified request is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

getCatalogItem

GetCatalogItemResult getCatalogItem(GetCatalogItemRequest getCatalogItemRequest)

Gets information about a catalog item.

Parameters:

getCatalogItemRequest -

Returns:

Result of the GetCatalogItem operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

NotFoundException - The specified request is not valid.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

getOrder

GetOrderResult getOrder(GetOrderRequest getOrderRequest)

Gets an order.

Parameters:

getOrderRequest -

Returns:

Result of the GetOrder operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

NotFoundException - The specified request is not valid.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

getOutpost

GetOutpostResult getOutpost(GetOutpostRequest getOutpostRequest)

Gets information about the specified Outpost.

Parameters:

getOutpostRequest -

Returns:

Result of the GetOutpost operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

NotFoundException - The specified request is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

getOutpostInstanceTypes

GetOutpostInstanceTypesResult getOutpostInstanceTypes(GetOutpostInstanceTypesRequest getOutpostInstanceTypesRequest)

Lists the instance types for the specified Outpost.

Parameters:

getOutpostInstanceTypesRequest -

Returns:

Result of the GetOutpostInstanceTypes operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

NotFoundException - The specified request is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

getSite

GetSiteResult getSite(GetSiteRequest getSiteRequest)

Gets information about the specified Outpost site.

Parameters:

getSiteRequest -

Returns:

Result of the GetSite operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

NotFoundException - The specified request is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

getSiteAddress

GetSiteAddressResult getSiteAddress(GetSiteAddressRequest getSiteAddressRequest)

Gets the site address.

Parameters:

getSiteAddressRequest -

Returns:

Result of the GetSiteAddress operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

AccessDeniedException - You do not have permission to perform this operation.

NotFoundException - The specified request is not valid.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

listCatalogItems

ListCatalogItemsResult listCatalogItems(ListCatalogItemsRequest listCatalogItemsRequest)

Use to create a list of every item in the catalog. Add filters to your request to return a more specific list of results. Use filters to match an item class, storage option, or EC2 family.

If you specify multiple filters, the filters are joined with an AND, and the request returns only results that match all of the specified filters.

Parameters:

listCatalogItemsRequest -

Returns:

Result of the ListCatalogItems operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

NotFoundException - The specified request is not valid.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

listOrders

ListOrdersResult listOrders(ListOrdersRequest listOrdersRequest)

Create a list of the Outpost orders for your Amazon Web Services account. You can filter your request by Outpost to return a more specific list of results.

Parameters:

listOrdersRequest -

Returns:

Result of the ListOrders operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

NotFoundException - The specified request is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

listOutposts

ListOutpostsResult listOutposts(ListOutpostsRequest listOutpostsRequest)

Create a list of the Outposts for your Amazon Web Services account. Add filters to your request to return a more specific list of results. Use filters to match an Outpost lifecycle status, Availability Zone ( us-east-1a), and AZ ID (use1-az1).

If you specify multiple filters, the filters are joined with an AND, and the request returns only results that match all of the specified filters.

Parameters:

listOutpostsRequest -

Returns:

Result of the ListOutposts operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

listSites

ListSitesResult listSites(ListSitesRequest listSitesRequest)

Lists the sites for your Amazon Web Services account.

Parameters:

listSitesRequest -

Returns:

Result of the ListSites operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

listTagsForResource

ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)

Lists the tags for the specified resource.

Parameters:

listTagsForResourceRequest -

Returns:

Result of the ListTagsForResource operation returned by the service.

Throws:

InternalServerException - An internal error has occurred.

ValidationException - A parameter is not valid.

NotFoundException - The specified request is not valid.

See Also:

AWS API Documentation

tagResource

TagResourceResult tagResource(TagResourceRequest tagResourceRequest)

Adds tags to the specified resource.

Parameters:

tagResourceRequest -

Returns:

Result of the TagResource operation returned by the service.

Throws:

InternalServerException - An internal error has occurred.

ValidationException - A parameter is not valid.

NotFoundException - The specified request is not valid.

See Also:

AWS API Documentation

untagResource

UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)

Removes tags from the specified resource.

Parameters:

untagResourceRequest -

Returns:

Result of the UntagResource operation returned by the service.

Throws:

InternalServerException - An internal error has occurred.

ValidationException - A parameter is not valid.

NotFoundException - The specified request is not valid.

See Also:

AWS API Documentation

updateOutpost

UpdateOutpostResult updateOutpost(UpdateOutpostRequest updateOutpostRequest)

Updates an Outpost.

Parameters:

updateOutpostRequest -

Returns:

Result of the UpdateOutpost operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

ConflictException - Updating or deleting this resource can cause an inconsistent state.

NotFoundException - The specified request is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

updateSite

UpdateSiteResult updateSite(UpdateSiteRequest updateSiteRequest)

Updates the site.

Parameters:

updateSiteRequest -

Returns:

Result of the UpdateSite operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

ConflictException - Updating or deleting this resource can cause an inconsistent state.

NotFoundException - The specified request is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

updateSiteAddress

UpdateSiteAddressResult updateSiteAddress(UpdateSiteAddressRequest updateSiteAddressRequest)

Updates the site address.

To update a site address with an order IN_PROGRESS, you must wait for the order to complete or cancel the order.

You can update the operating address before you place an order at the site, or after all Outposts that belong to the site have been deactivated.

Parameters:

updateSiteAddressRequest -

Returns:

Result of the UpdateSiteAddress operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

AccessDeniedException - You do not have permission to perform this operation.

NotFoundException - The specified request is not valid.

ConflictException - Updating or deleting this resource can cause an inconsistent state.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

updateSiteRackPhysicalProperties

UpdateSiteRackPhysicalPropertiesResult updateSiteRackPhysicalProperties(UpdateSiteRackPhysicalPropertiesRequest updateSiteRackPhysicalPropertiesRequest)

Update the physical and logistical details for a rack at a site. For more information about hardware requirements for racks, see Network readiness checklist in the Amazon Web Services Outposts User Guide.

To update a rack at a site with an order of IN_PROGRESS, you must wait for the order to complete or cancel the order.

Parameters:

updateSiteRackPhysicalPropertiesRequest -

Returns:

Result of the UpdateSiteRackPhysicalProperties operation returned by the service.

Throws:

ValidationException - A parameter is not valid.

ConflictException - Updating or deleting this resource can cause an inconsistent state.

NotFoundException - The specified request is not valid.

AccessDeniedException - You do not have permission to perform this operation.

InternalServerException - An internal error has occurred.

See Also:

AWS API Documentation

shutdown

void shutdown()

Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.

getCachedResponseMetadata

ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.

Parameters:

request - The originally executed request.

Returns:

The response metadata for the specified request, or null if none is available.