Interface DlmClient
- All Superinterfaces:
AutoCloseable
,AwsClient
,SdkAutoCloseable
,SdkClient
builder()
method.
With Amazon Data Lifecycle Manager, you can manage the lifecycle of your Amazon Web Services resources. You create lifecycle policies, which are used to automate operations on the specified resources.
Amazon Data Lifecycle Manager supports Amazon EBS volumes and snapshots. For information about using Amazon Data Lifecycle Manager with Amazon EBS, see Amazon Data Lifecycle Manager in the Amazon EC2 User Guide.
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Value for looking up the service's metadata from theServiceMetadataProvider
.static final String
-
Method Summary
Modifier and TypeMethodDescriptionstatic DlmClientBuilder
builder()
Create a builder that can be used to configure and create aDlmClient
.static DlmClient
create()
Create aDlmClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
.default CreateLifecyclePolicyResponse
createLifecyclePolicy
(Consumer<CreateLifecyclePolicyRequest.Builder> createLifecyclePolicyRequest) Creates an Amazon Data Lifecycle Manager lifecycle policy.default CreateLifecyclePolicyResponse
createLifecyclePolicy
(CreateLifecyclePolicyRequest createLifecyclePolicyRequest) Creates an Amazon Data Lifecycle Manager lifecycle policy.default DeleteLifecyclePolicyResponse
deleteLifecyclePolicy
(Consumer<DeleteLifecyclePolicyRequest.Builder> deleteLifecyclePolicyRequest) Deletes the specified lifecycle policy and halts the automated operations that the policy specified.default DeleteLifecyclePolicyResponse
deleteLifecyclePolicy
(DeleteLifecyclePolicyRequest deleteLifecyclePolicyRequest) Deletes the specified lifecycle policy and halts the automated operations that the policy specified.default GetLifecyclePoliciesResponse
Gets summary information about all or the specified data lifecycle policies.default GetLifecyclePoliciesResponse
getLifecyclePolicies
(Consumer<GetLifecyclePoliciesRequest.Builder> getLifecyclePoliciesRequest) Gets summary information about all or the specified data lifecycle policies.default GetLifecyclePoliciesResponse
getLifecyclePolicies
(GetLifecyclePoliciesRequest getLifecyclePoliciesRequest) Gets summary information about all or the specified data lifecycle policies.default GetLifecyclePolicyResponse
getLifecyclePolicy
(Consumer<GetLifecyclePolicyRequest.Builder> getLifecyclePolicyRequest) Gets detailed information about the specified lifecycle policy.default GetLifecyclePolicyResponse
getLifecyclePolicy
(GetLifecyclePolicyRequest getLifecyclePolicyRequest) Gets detailed information about the specified lifecycle policy.default ListTagsForResourceResponse
listTagsForResource
(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists the tags for the specified resource.default ListTagsForResourceResponse
listTagsForResource
(ListTagsForResourceRequest listTagsForResourceRequest) Lists the tags for the specified resource.default DlmServiceClientConfiguration
The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationstatic ServiceMetadata
default TagResourceResponse
tagResource
(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds the specified tags to the specified resource.default TagResourceResponse
tagResource
(TagResourceRequest tagResourceRequest) Adds the specified tags to the specified resource.default UntagResourceResponse
untagResource
(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes the specified tags from the specified resource.default UntagResourceResponse
untagResource
(UntagResourceRequest untagResourceRequest) Removes the specified tags from the specified resource.default UpdateLifecyclePolicyResponse
updateLifecyclePolicy
(Consumer<UpdateLifecyclePolicyRequest.Builder> updateLifecyclePolicyRequest) Updates the specified lifecycle policy.default UpdateLifecyclePolicyResponse
updateLifecyclePolicy
(UpdateLifecyclePolicyRequest updateLifecyclePolicyRequest) Updates the specified lifecycle policy.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close
Methods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider
.- See Also:
-
-
Method Details
-
createLifecyclePolicy
default CreateLifecyclePolicyResponse createLifecyclePolicy(CreateLifecyclePolicyRequest createLifecyclePolicyRequest) throws InvalidRequestException, LimitExceededException, InternalServerException, AwsServiceException, SdkClientException, DlmException Creates an Amazon Data Lifecycle Manager lifecycle policy. Amazon Data Lifecycle Manager supports the following policy types:
-
Custom EBS snapshot policy
-
Custom EBS-backed AMI policy
-
Cross-account copy event policy
-
Default policy for EBS snapshots
-
Default policy for EBS-backed AMIs
For more information, see Default policies vs custom policies.
If you create a default policy, you can specify the request parameters either in the request body, or in the PolicyDetails request structure, but not both.
- Parameters:
createLifecyclePolicyRequest
-- Returns:
- Result of the CreateLifecyclePolicy operation returned by the service.
- See Also:
-
-
createLifecyclePolicy
default CreateLifecyclePolicyResponse createLifecyclePolicy(Consumer<CreateLifecyclePolicyRequest.Builder> createLifecyclePolicyRequest) throws InvalidRequestException, LimitExceededException, InternalServerException, AwsServiceException, SdkClientException, DlmException Creates an Amazon Data Lifecycle Manager lifecycle policy. Amazon Data Lifecycle Manager supports the following policy types:
-
Custom EBS snapshot policy
-
Custom EBS-backed AMI policy
-
Cross-account copy event policy
-
Default policy for EBS snapshots
-
Default policy for EBS-backed AMIs
For more information, see Default policies vs custom policies.
If you create a default policy, you can specify the request parameters either in the request body, or in the PolicyDetails request structure, but not both.
This is a convenience which creates an instance of the
CreateLifecyclePolicyRequest.Builder
avoiding the need to create one manually viaCreateLifecyclePolicyRequest.builder()
- Parameters:
createLifecyclePolicyRequest
- AConsumer
that will call methods onCreateLifecyclePolicyRequest.Builder
to create a request.- Returns:
- Result of the CreateLifecyclePolicy operation returned by the service.
- See Also:
-
-
deleteLifecyclePolicy
default DeleteLifecyclePolicyResponse deleteLifecyclePolicy(DeleteLifecyclePolicyRequest deleteLifecyclePolicyRequest) throws ResourceNotFoundException, InternalServerException, LimitExceededException, AwsServiceException, SdkClientException, DlmException Deletes the specified lifecycle policy and halts the automated operations that the policy specified.
For more information about deleting a policy, see Delete lifecycle policies.
- Parameters:
deleteLifecyclePolicyRequest
-- Returns:
- Result of the DeleteLifecyclePolicy operation returned by the service.
- See Also:
-
deleteLifecyclePolicy
default DeleteLifecyclePolicyResponse deleteLifecyclePolicy(Consumer<DeleteLifecyclePolicyRequest.Builder> deleteLifecyclePolicyRequest) throws ResourceNotFoundException, InternalServerException, LimitExceededException, AwsServiceException, SdkClientException, DlmException Deletes the specified lifecycle policy and halts the automated operations that the policy specified.
For more information about deleting a policy, see Delete lifecycle policies.
This is a convenience which creates an instance of the
DeleteLifecyclePolicyRequest.Builder
avoiding the need to create one manually viaDeleteLifecyclePolicyRequest.builder()
- Parameters:
deleteLifecyclePolicyRequest
- AConsumer
that will call methods onDeleteLifecyclePolicyRequest.Builder
to create a request.- Returns:
- Result of the DeleteLifecyclePolicy operation returned by the service.
- See Also:
-
getLifecyclePolicies
default GetLifecyclePoliciesResponse getLifecyclePolicies(GetLifecyclePoliciesRequest getLifecyclePoliciesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServerException, LimitExceededException, AwsServiceException, SdkClientException, DlmException Gets summary information about all or the specified data lifecycle policies.
To get complete information about a policy, use GetLifecyclePolicy.
- Parameters:
getLifecyclePoliciesRequest
-- Returns:
- Result of the GetLifecyclePolicies operation returned by the service.
- See Also:
-
getLifecyclePolicies
default GetLifecyclePoliciesResponse getLifecyclePolicies(Consumer<GetLifecyclePoliciesRequest.Builder> getLifecyclePoliciesRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServerException, LimitExceededException, AwsServiceException, SdkClientException, DlmException Gets summary information about all or the specified data lifecycle policies.
To get complete information about a policy, use GetLifecyclePolicy.
This is a convenience which creates an instance of the
GetLifecyclePoliciesRequest.Builder
avoiding the need to create one manually viaGetLifecyclePoliciesRequest.builder()
- Parameters:
getLifecyclePoliciesRequest
- AConsumer
that will call methods onGetLifecyclePoliciesRequest.Builder
to create a request.- Returns:
- Result of the GetLifecyclePolicies operation returned by the service.
- See Also:
-
getLifecyclePolicies
default GetLifecyclePoliciesResponse getLifecyclePolicies() throws ResourceNotFoundException, InvalidRequestException, InternalServerException, LimitExceededException, AwsServiceException, SdkClientException, DlmExceptionGets summary information about all or the specified data lifecycle policies.
To get complete information about a policy, use GetLifecyclePolicy.
- Returns:
- Result of the GetLifecyclePolicies operation returned by the service.
- See Also:
-
getLifecyclePolicy
default GetLifecyclePolicyResponse getLifecyclePolicy(GetLifecyclePolicyRequest getLifecyclePolicyRequest) throws ResourceNotFoundException, InternalServerException, LimitExceededException, AwsServiceException, SdkClientException, DlmException Gets detailed information about the specified lifecycle policy.
- Parameters:
getLifecyclePolicyRequest
-- Returns:
- Result of the GetLifecyclePolicy operation returned by the service.
- See Also:
-
getLifecyclePolicy
default GetLifecyclePolicyResponse getLifecyclePolicy(Consumer<GetLifecyclePolicyRequest.Builder> getLifecyclePolicyRequest) throws ResourceNotFoundException, InternalServerException, LimitExceededException, AwsServiceException, SdkClientException, DlmException Gets detailed information about the specified lifecycle policy.
This is a convenience which creates an instance of the
GetLifecyclePolicyRequest.Builder
avoiding the need to create one manually viaGetLifecyclePolicyRequest.builder()
- Parameters:
getLifecyclePolicyRequest
- AConsumer
that will call methods onGetLifecyclePolicyRequest.Builder
to create a request.- Returns:
- Result of the GetLifecyclePolicy operation returned by the service.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws InternalServerException, InvalidRequestException, ResourceNotFoundException, AwsServiceException, SdkClientException, DlmException Lists the tags for the specified resource.
- Parameters:
listTagsForResourceRequest
-- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws InternalServerException, InvalidRequestException, ResourceNotFoundException, AwsServiceException, SdkClientException, DlmException Lists the tags for the specified resource.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builder
avoiding the need to create one manually viaListTagsForResourceRequest.builder()
- Parameters:
listTagsForResourceRequest
- AConsumer
that will call methods onListTagsForResourceRequest.Builder
to create a request.- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws InternalServerException, InvalidRequestException, ResourceNotFoundException, AwsServiceException, SdkClientException, DlmException Adds the specified tags to the specified resource.
- Parameters:
tagResourceRequest
-- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws InternalServerException, InvalidRequestException, ResourceNotFoundException, AwsServiceException, SdkClientException, DlmException Adds the specified tags to the specified resource.
This is a convenience which creates an instance of the
TagResourceRequest.Builder
avoiding the need to create one manually viaTagResourceRequest.builder()
- Parameters:
tagResourceRequest
- AConsumer
that will call methods onTagResourceRequest.Builder
to create a request.- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws InternalServerException, InvalidRequestException, ResourceNotFoundException, AwsServiceException, SdkClientException, DlmException Removes the specified tags from the specified resource.
- Parameters:
untagResourceRequest
-- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws InternalServerException, InvalidRequestException, ResourceNotFoundException, AwsServiceException, SdkClientException, DlmException Removes the specified tags from the specified resource.
This is a convenience which creates an instance of the
UntagResourceRequest.Builder
avoiding the need to create one manually viaUntagResourceRequest.builder()
- Parameters:
untagResourceRequest
- AConsumer
that will call methods onUntagResourceRequest.Builder
to create a request.- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
updateLifecyclePolicy
default UpdateLifecyclePolicyResponse updateLifecyclePolicy(UpdateLifecyclePolicyRequest updateLifecyclePolicyRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServerException, LimitExceededException, AwsServiceException, SdkClientException, DlmException Updates the specified lifecycle policy.
For more information about updating a policy, see Modify lifecycle policies.
- Parameters:
updateLifecyclePolicyRequest
-- Returns:
- Result of the UpdateLifecyclePolicy operation returned by the service.
- See Also:
-
updateLifecyclePolicy
default UpdateLifecyclePolicyResponse updateLifecyclePolicy(Consumer<UpdateLifecyclePolicyRequest.Builder> updateLifecyclePolicyRequest) throws ResourceNotFoundException, InvalidRequestException, InternalServerException, LimitExceededException, AwsServiceException, SdkClientException, DlmException Updates the specified lifecycle policy.
For more information about updating a policy, see Modify lifecycle policies.
This is a convenience which creates an instance of the
UpdateLifecyclePolicyRequest.Builder
avoiding the need to create one manually viaUpdateLifecyclePolicyRequest.builder()
- Parameters:
updateLifecyclePolicyRequest
- AConsumer
that will call methods onUpdateLifecyclePolicyRequest.Builder
to create a request.- Returns:
- Result of the UpdateLifecyclePolicy operation returned by the service.
- See Also:
-
create
Create aDlmClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
. -
builder
Create a builder that can be used to configure and create aDlmClient
. -
serviceMetadata
-
serviceClientConfiguration
Description copied from interface:SdkClient
The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfiguration
in interfaceAwsClient
- Specified by:
serviceClientConfiguration
in interfaceSdkClient
- Returns:
- SdkServiceClientConfiguration
-