com.amazonaws.services.recyclebin

Interface AmazonRecycleBin

All Known Subinterfaces:

AmazonRecycleBinAsync

All Known Implementing Classes:

AbstractAmazonRecycleBin, AbstractAmazonRecycleBinAsync, AmazonRecycleBinAsyncClient, AmazonRecycleBinClient

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

Interface for accessing Amazon Recycle Bin.

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

This is the Recycle Bin API Reference. This documentation provides descriptions and syntax for each of the actions and data types in Recycle Bin.

Recycle Bin is a snapshot recovery feature that enables you to restore accidentally deleted snapshots. When using Recycle Bin, if your snapshots are deleted, they are retained in the Recycle Bin for a time period that you specify.

You can restore a snapshot from the Recycle Bin at any time before its retention period expires. After you restore a snapshot from the Recycle Bin, the snapshot is removed from the Recycle Bin, and you can then use it in the same way you use any other snapshot in your account. If the retention period expires and the snapshot is not restored, the snapshot is permanently deleted from the Recycle Bin and is no longer available for recovery. For more information about Recycle Bin, see Recycle Bin in the Amazon EC2 User Guide.

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
CreateRuleResult	createRule(CreateRuleRequest createRuleRequest) Creates a Recycle Bin retention rule.
DeleteRuleResult	deleteRule(DeleteRuleRequest deleteRuleRequest) Deletes a Recycle Bin retention rule.
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.
GetRuleResult	getRule(GetRuleRequest getRuleRequest) Gets information about a Recycle Bin retention rule.
ListRulesResult	listRules(ListRulesRequest listRulesRequest) Lists the Recycle Bin retention rules in the Region.
ListTagsForResourceResult	listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists the tags assigned a specific resource.
void	shutdown() Shuts down this client object, releasing any resources that might be held open.
TagResourceResult	tagResource(TagResourceRequest tagResourceRequest) Assigns tags to the specified resource.
UntagResourceResult	untagResource(UntagResourceRequest untagResourceRequest) Unassigns a tag from a resource.
UpdateRuleResult	updateRule(UpdateRuleRequest updateRuleRequest) Updates an existing Recycle Bin retention rule.

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

createRule

CreateRuleResult createRule(CreateRuleRequest createRuleRequest)

Creates a Recycle Bin retention rule. For more information, see Create Recycle Bin retention rules in the Amazon EC2 User Guide.

Parameters:

createRuleRequest -

Returns:

Result of the CreateRule operation returned by the service.

Throws:

ValidationException - One or more of the parameters in the request is not valid.

ServiceQuotaExceededException - The request would cause a service quota for the number of tags per resource to be exceeded.

InternalServerException - The service could not respond to the request due to an internal problem.

See Also:

AWS API Documentation

deleteRule

DeleteRuleResult deleteRule(DeleteRuleRequest deleteRuleRequest)

Deletes a Recycle Bin retention rule. For more information, see Delete Recycle Bin retention rules in the Amazon EC2 User Guide.

Parameters:

deleteRuleRequest -

Returns:

Result of the DeleteRule operation returned by the service.

Throws:

InternalServerException - The service could not respond to the request due to an internal problem.

ResourceNotFoundException - The specified resource was not found.

ValidationException - One or more of the parameters in the request is not valid.

See Also:

AWS API Documentation

getRule

GetRuleResult getRule(GetRuleRequest getRuleRequest)

Gets information about a Recycle Bin retention rule.

Parameters:

getRuleRequest -

Returns:

Result of the GetRule operation returned by the service.

Throws:

ValidationException - One or more of the parameters in the request is not valid.

InternalServerException - The service could not respond to the request due to an internal problem.

ResourceNotFoundException - The specified resource was not found.

See Also:

AWS API Documentation

listRules

ListRulesResult listRules(ListRulesRequest listRulesRequest)

Lists the Recycle Bin retention rules in the Region.

Parameters:

listRulesRequest -

Returns:

Result of the ListRules operation returned by the service.

Throws:

ValidationException - One or more of the parameters in the request is not valid.

InternalServerException - The service could not respond to the request due to an internal problem.

See Also:

AWS API Documentation

listTagsForResource

ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)

Lists the tags assigned a specific resource.

Parameters:

listTagsForResourceRequest -

Returns:

Result of the ListTagsForResource operation returned by the service.

Throws:

ValidationException - One or more of the parameters in the request is not valid.

InternalServerException - The service could not respond to the request due to an internal problem.

ResourceNotFoundException - The specified resource was not found.

See Also:

AWS API Documentation

tagResource

TagResourceResult tagResource(TagResourceRequest tagResourceRequest)

Assigns tags to the specified resource.

Parameters:

tagResourceRequest -

Returns:

Result of the TagResource operation returned by the service.

Throws:

ValidationException - One or more of the parameters in the request is not valid.

InternalServerException - The service could not respond to the request due to an internal problem.

ResourceNotFoundException - The specified resource was not found.

ServiceQuotaExceededException - The request would cause a service quota for the number of tags per resource to be exceeded.

See Also:

AWS API Documentation

untagResource

UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)

Unassigns a tag from a resource.

Parameters:

untagResourceRequest -

Returns:

Result of the UntagResource operation returned by the service.

Throws:

ValidationException - One or more of the parameters in the request is not valid.

InternalServerException - The service could not respond to the request due to an internal problem.

ResourceNotFoundException - The specified resource was not found.

See Also:

AWS API Documentation

updateRule

UpdateRuleResult updateRule(UpdateRuleRequest updateRuleRequest)

Updates an existing Recycle Bin retention rule. For more information, see Update Recycle Bin retention rules in the Amazon EC2 User Guide.

Parameters:

updateRuleRequest -

Returns:

Result of the UpdateRule operation returned by the service.

Throws:

ValidationException - One or more of the parameters in the request is not valid.

InternalServerException - The service could not respond to the request due to an internal problem.

ResourceNotFoundException - The specified resource was not found.

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.