/*
* Copyright 2012-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package com.amazonaws.services.rds.model;
import java.io.Serializable;
import javax.annotation.Generated;
import com.amazonaws.AmazonWebServiceRequest;
/**
* <p/>
*
* @see <a href="http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBClusterSnapshot" target="_top">AWS API
* Documentation</a>
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public class CopyDBClusterSnapshotRequest extends com.amazonaws.AmazonWebServiceRequest implements Serializable, Cloneable {
/**
* <p>
* The identifier of the DB cluster snapshot to copy. This parameter is not case-sensitive.
* </p>
* <p>
* You cannot copy an encrypted, shared DB cluster snapshot from one AWS region to another.
* </p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* <li>
* <p>
* Must specify a valid system snapshot in the "available" state.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in the same region as the copy, specify a valid DB snapshot identifier.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in a different region than the copy, specify a valid DB cluster snapshot ARN. For more
* information, go to <a href="http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html">
* Copying a DB Snapshot or DB Cluster Snapshot</a>.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot1</code>
* </p>
*/
private String sourceDBClusterSnapshotIdentifier;
/**
* <p>
* The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This parameter is
* not case-sensitive.
* </p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot2</code>
* </p>
*/
private String targetDBClusterSnapshotIdentifier;
/**
* <p>
* The AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key ID is the Amazon Resource Name (ARN), KMS
* key identifier, or the KMS key alias for the KMS encryption key.
* </p>
* <p>
* If you copy an unencrypted DB cluster snapshot and specify a value for the <code>KmsKeyId</code> parameter,
* Amazon RDS encrypts the target DB cluster snapshot using the specified KMS encryption key.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot from your AWS account, you can specify a value for
* <code>KmsKeyId</code> to encrypt the copy with a new KMS encryption key. If you don't specify a value for
* <code>KmsKeyId</code>, then the copy of the DB cluster snapshot is encrypted with the same KMS key as the source
* DB cluster snapshot.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot that is shared from another AWS account, then you must specify a
* value for <code>KmsKeyId</code>.
* </p>
* <p>
* To copy an encrypted DB cluster snapshot to another region, you must set <code>KmsKeyId</code> to the KMS key ID
* you want to use to encrypt the copy of the DB cluster snapshot in the destination region. KMS encryption keys are
* specific to the region that they are created in, and you cannot use encryption keys from one region in another
* region.
* </p>
*/
private String kmsKeyId;
/**
* <p>
* The URL that contains a Signature Version 4 signed request for the <code>CopyDBClusterSnapshot</code> API action
* in the AWS region that contains the source DB cluster snapshot to copy. The <code>PreSignedUrl</code> parameter
* must be used when copying an encrypted DB cluster snapshot from another AWS region.
* </p>
* <p>
* The pre-signed URL must be a valid request for the <code>CopyDBSClusterSnapshot</code> API action that can be
* executed in the source region that contains the encrypted DB cluster snapshot to be copied. The pre-signed URL
* request must contain the following parameter values:
* </p>
* <ul>
* <li>
* <p>
* <code>KmsKeyId</code> - The KMS key identifier for the key to use to encrypt the copy of the DB cluster snapshot
* in the destination region. This is the same identifier for both the <code>CopyDBClusterSnapshot</code> action
* that is called in the destination region, and the action contained in the pre-signed URL.
* </p>
* </li>
* <li>
* <p>
* <code>DestinationRegion</code> - The name of the region that the DB cluster snapshot will be created in.
* </p>
* </li>
* <li>
* <p>
* <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB cluster
* snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source region.
* For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 region, then your
* <code>SourceDBClusterSnapshotIdentifier</code> looks like the following example:
* <code>arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115</code>.
* </p>
* </li>
* </ul>
* <p>
* To learn how to generate a Signature Version 4 signed request, see <a
* href="http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html"> Authenticating Requests:
* Using Query Parameters (AWS Signature Version 4)</a> and <a
* href="http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html"> Signature Version 4 Signing
* Process</a>.
* </p>
*/
private String preSignedUrl;
/**
* <p>
* True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot; otherwise false. The
* default is false.
* </p>
*/
private Boolean copyTags;
private com.amazonaws.internal.SdkInternalList<Tag> tags;
/** The region where the source cluster snapshot is located. */
private String sourceRegion;
/**
* <p>
* The identifier of the DB cluster snapshot to copy. This parameter is not case-sensitive.
* </p>
* <p>
* You cannot copy an encrypted, shared DB cluster snapshot from one AWS region to another.
* </p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* <li>
* <p>
* Must specify a valid system snapshot in the "available" state.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in the same region as the copy, specify a valid DB snapshot identifier.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in a different region than the copy, specify a valid DB cluster snapshot ARN. For more
* information, go to <a href="http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html">
* Copying a DB Snapshot or DB Cluster Snapshot</a>.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot1</code>
* </p>
*
* @param sourceDBClusterSnapshotIdentifier
* The identifier of the DB cluster snapshot to copy. This parameter is not case-sensitive.</p>
* <p>
* You cannot copy an encrypted, shared DB cluster snapshot from one AWS region to another.
* </p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* <li>
* <p>
* Must specify a valid system snapshot in the "available" state.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in the same region as the copy, specify a valid DB snapshot identifier.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in a different region than the copy, specify a valid DB cluster snapshot ARN.
* For more information, go to <a
* href="http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html"> Copying a DB Snapshot
* or DB Cluster Snapshot</a>.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot1</code>
*/
public void setSourceDBClusterSnapshotIdentifier(String sourceDBClusterSnapshotIdentifier) {
this.sourceDBClusterSnapshotIdentifier = sourceDBClusterSnapshotIdentifier;
}
/**
* <p>
* The identifier of the DB cluster snapshot to copy. This parameter is not case-sensitive.
* </p>
* <p>
* You cannot copy an encrypted, shared DB cluster snapshot from one AWS region to another.
* </p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* <li>
* <p>
* Must specify a valid system snapshot in the "available" state.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in the same region as the copy, specify a valid DB snapshot identifier.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in a different region than the copy, specify a valid DB cluster snapshot ARN. For more
* information, go to <a href="http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html">
* Copying a DB Snapshot or DB Cluster Snapshot</a>.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot1</code>
* </p>
*
* @return The identifier of the DB cluster snapshot to copy. This parameter is not case-sensitive.</p>
* <p>
* You cannot copy an encrypted, shared DB cluster snapshot from one AWS region to another.
* </p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* <li>
* <p>
* Must specify a valid system snapshot in the "available" state.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in the same region as the copy, specify a valid DB snapshot identifier.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in a different region than the copy, specify a valid DB cluster snapshot ARN.
* For more information, go to <a
* href="http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html"> Copying a DB
* Snapshot or DB Cluster Snapshot</a>.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot1</code>
*/
public String getSourceDBClusterSnapshotIdentifier() {
return this.sourceDBClusterSnapshotIdentifier;
}
/**
* <p>
* The identifier of the DB cluster snapshot to copy. This parameter is not case-sensitive.
* </p>
* <p>
* You cannot copy an encrypted, shared DB cluster snapshot from one AWS region to another.
* </p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* <li>
* <p>
* Must specify a valid system snapshot in the "available" state.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in the same region as the copy, specify a valid DB snapshot identifier.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in a different region than the copy, specify a valid DB cluster snapshot ARN. For more
* information, go to <a href="http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html">
* Copying a DB Snapshot or DB Cluster Snapshot</a>.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot1</code>
* </p>
*
* @param sourceDBClusterSnapshotIdentifier
* The identifier of the DB cluster snapshot to copy. This parameter is not case-sensitive.</p>
* <p>
* You cannot copy an encrypted, shared DB cluster snapshot from one AWS region to another.
* </p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* <li>
* <p>
* Must specify a valid system snapshot in the "available" state.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in the same region as the copy, specify a valid DB snapshot identifier.
* </p>
* </li>
* <li>
* <p>
* If the source snapshot is in a different region than the copy, specify a valid DB cluster snapshot ARN.
* For more information, go to <a
* href="http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html"> Copying a DB Snapshot
* or DB Cluster Snapshot</a>.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot1</code>
* @return Returns a reference to this object so that method calls can be chained together.
*/
public CopyDBClusterSnapshotRequest withSourceDBClusterSnapshotIdentifier(String sourceDBClusterSnapshotIdentifier) {
setSourceDBClusterSnapshotIdentifier(sourceDBClusterSnapshotIdentifier);
return this;
}
/**
* <p>
* The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This parameter is
* not case-sensitive.
* </p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot2</code>
* </p>
*
* @param targetDBClusterSnapshotIdentifier
* The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This
* parameter is not case-sensitive.</p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot2</code>
*/
public void setTargetDBClusterSnapshotIdentifier(String targetDBClusterSnapshotIdentifier) {
this.targetDBClusterSnapshotIdentifier = targetDBClusterSnapshotIdentifier;
}
/**
* <p>
* The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This parameter is
* not case-sensitive.
* </p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot2</code>
* </p>
*
* @return The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This
* parameter is not case-sensitive.</p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot2</code>
*/
public String getTargetDBClusterSnapshotIdentifier() {
return this.targetDBClusterSnapshotIdentifier;
}
/**
* <p>
* The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This parameter is
* not case-sensitive.
* </p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot2</code>
* </p>
*
* @param targetDBClusterSnapshotIdentifier
* The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This
* parameter is not case-sensitive.</p>
* <p>
* Constraints:
* </p>
* <ul>
* <li>
* <p>
* Must contain from 1 to 63 alphanumeric characters or hyphens.
* </p>
* </li>
* <li>
* <p>
* First character must be a letter.
* </p>
* </li>
* <li>
* <p>
* Cannot end with a hyphen or contain two consecutive hyphens.
* </p>
* </li>
* </ul>
* <p>
* Example: <code>my-cluster-snapshot2</code>
* @return Returns a reference to this object so that method calls can be chained together.
*/
public CopyDBClusterSnapshotRequest withTargetDBClusterSnapshotIdentifier(String targetDBClusterSnapshotIdentifier) {
setTargetDBClusterSnapshotIdentifier(targetDBClusterSnapshotIdentifier);
return this;
}
/**
* <p>
* The AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key ID is the Amazon Resource Name (ARN), KMS
* key identifier, or the KMS key alias for the KMS encryption key.
* </p>
* <p>
* If you copy an unencrypted DB cluster snapshot and specify a value for the <code>KmsKeyId</code> parameter,
* Amazon RDS encrypts the target DB cluster snapshot using the specified KMS encryption key.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot from your AWS account, you can specify a value for
* <code>KmsKeyId</code> to encrypt the copy with a new KMS encryption key. If you don't specify a value for
* <code>KmsKeyId</code>, then the copy of the DB cluster snapshot is encrypted with the same KMS key as the source
* DB cluster snapshot.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot that is shared from another AWS account, then you must specify a
* value for <code>KmsKeyId</code>.
* </p>
* <p>
* To copy an encrypted DB cluster snapshot to another region, you must set <code>KmsKeyId</code> to the KMS key ID
* you want to use to encrypt the copy of the DB cluster snapshot in the destination region. KMS encryption keys are
* specific to the region that they are created in, and you cannot use encryption keys from one region in another
* region.
* </p>
*
* @param kmsKeyId
* The AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key ID is the Amazon Resource Name (ARN),
* KMS key identifier, or the KMS key alias for the KMS encryption key. </p>
* <p>
* If you copy an unencrypted DB cluster snapshot and specify a value for the <code>KmsKeyId</code>
* parameter, Amazon RDS encrypts the target DB cluster snapshot using the specified KMS encryption key.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot from your AWS account, you can specify a value for
* <code>KmsKeyId</code> to encrypt the copy with a new KMS encryption key. If you don't specify a value for
* <code>KmsKeyId</code>, then the copy of the DB cluster snapshot is encrypted with the same KMS key as the
* source DB cluster snapshot.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot that is shared from another AWS account, then you must
* specify a value for <code>KmsKeyId</code>.
* </p>
* <p>
* To copy an encrypted DB cluster snapshot to another region, you must set <code>KmsKeyId</code> to the KMS
* key ID you want to use to encrypt the copy of the DB cluster snapshot in the destination region. KMS
* encryption keys are specific to the region that they are created in, and you cannot use encryption keys
* from one region in another region.
*/
public void setKmsKeyId(String kmsKeyId) {
this.kmsKeyId = kmsKeyId;
}
/**
* <p>
* The AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key ID is the Amazon Resource Name (ARN), KMS
* key identifier, or the KMS key alias for the KMS encryption key.
* </p>
* <p>
* If you copy an unencrypted DB cluster snapshot and specify a value for the <code>KmsKeyId</code> parameter,
* Amazon RDS encrypts the target DB cluster snapshot using the specified KMS encryption key.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot from your AWS account, you can specify a value for
* <code>KmsKeyId</code> to encrypt the copy with a new KMS encryption key. If you don't specify a value for
* <code>KmsKeyId</code>, then the copy of the DB cluster snapshot is encrypted with the same KMS key as the source
* DB cluster snapshot.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot that is shared from another AWS account, then you must specify a
* value for <code>KmsKeyId</code>.
* </p>
* <p>
* To copy an encrypted DB cluster snapshot to another region, you must set <code>KmsKeyId</code> to the KMS key ID
* you want to use to encrypt the copy of the DB cluster snapshot in the destination region. KMS encryption keys are
* specific to the region that they are created in, and you cannot use encryption keys from one region in another
* region.
* </p>
*
* @return The AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key ID is the Amazon Resource Name
* (ARN), KMS key identifier, or the KMS key alias for the KMS encryption key. </p>
* <p>
* If you copy an unencrypted DB cluster snapshot and specify a value for the <code>KmsKeyId</code>
* parameter, Amazon RDS encrypts the target DB cluster snapshot using the specified KMS encryption key.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot from your AWS account, you can specify a value for
* <code>KmsKeyId</code> to encrypt the copy with a new KMS encryption key. If you don't specify a value for
* <code>KmsKeyId</code>, then the copy of the DB cluster snapshot is encrypted with the same KMS key as the
* source DB cluster snapshot.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot that is shared from another AWS account, then you must
* specify a value for <code>KmsKeyId</code>.
* </p>
* <p>
* To copy an encrypted DB cluster snapshot to another region, you must set <code>KmsKeyId</code> to the KMS
* key ID you want to use to encrypt the copy of the DB cluster snapshot in the destination region. KMS
* encryption keys are specific to the region that they are created in, and you cannot use encryption keys
* from one region in another region.
*/
public String getKmsKeyId() {
return this.kmsKeyId;
}
/**
* <p>
* The AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key ID is the Amazon Resource Name (ARN), KMS
* key identifier, or the KMS key alias for the KMS encryption key.
* </p>
* <p>
* If you copy an unencrypted DB cluster snapshot and specify a value for the <code>KmsKeyId</code> parameter,
* Amazon RDS encrypts the target DB cluster snapshot using the specified KMS encryption key.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot from your AWS account, you can specify a value for
* <code>KmsKeyId</code> to encrypt the copy with a new KMS encryption key. If you don't specify a value for
* <code>KmsKeyId</code>, then the copy of the DB cluster snapshot is encrypted with the same KMS key as the source
* DB cluster snapshot.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot that is shared from another AWS account, then you must specify a
* value for <code>KmsKeyId</code>.
* </p>
* <p>
* To copy an encrypted DB cluster snapshot to another region, you must set <code>KmsKeyId</code> to the KMS key ID
* you want to use to encrypt the copy of the DB cluster snapshot in the destination region. KMS encryption keys are
* specific to the region that they are created in, and you cannot use encryption keys from one region in another
* region.
* </p>
*
* @param kmsKeyId
* The AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key ID is the Amazon Resource Name (ARN),
* KMS key identifier, or the KMS key alias for the KMS encryption key. </p>
* <p>
* If you copy an unencrypted DB cluster snapshot and specify a value for the <code>KmsKeyId</code>
* parameter, Amazon RDS encrypts the target DB cluster snapshot using the specified KMS encryption key.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot from your AWS account, you can specify a value for
* <code>KmsKeyId</code> to encrypt the copy with a new KMS encryption key. If you don't specify a value for
* <code>KmsKeyId</code>, then the copy of the DB cluster snapshot is encrypted with the same KMS key as the
* source DB cluster snapshot.
* </p>
* <p>
* If you copy an encrypted DB cluster snapshot that is shared from another AWS account, then you must
* specify a value for <code>KmsKeyId</code>.
* </p>
* <p>
* To copy an encrypted DB cluster snapshot to another region, you must set <code>KmsKeyId</code> to the KMS
* key ID you want to use to encrypt the copy of the DB cluster snapshot in the destination region. KMS
* encryption keys are specific to the region that they are created in, and you cannot use encryption keys
* from one region in another region.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public CopyDBClusterSnapshotRequest withKmsKeyId(String kmsKeyId) {
setKmsKeyId(kmsKeyId);
return this;
}
/**
* <p>
* The URL that contains a Signature Version 4 signed request for the <code>CopyDBClusterSnapshot</code> API action
* in the AWS region that contains the source DB cluster snapshot to copy. The <code>PreSignedUrl</code> parameter
* must be used when copying an encrypted DB cluster snapshot from another AWS region.
* </p>
* <p>
* The pre-signed URL must be a valid request for the <code>CopyDBSClusterSnapshot</code> API action that can be
* executed in the source region that contains the encrypted DB cluster snapshot to be copied. The pre-signed URL
* request must contain the following parameter values:
* </p>
* <ul>
* <li>
* <p>
* <code>KmsKeyId</code> - The KMS key identifier for the key to use to encrypt the copy of the DB cluster snapshot
* in the destination region. This is the same identifier for both the <code>CopyDBClusterSnapshot</code> action
* that is called in the destination region, and the action contained in the pre-signed URL.
* </p>
* </li>
* <li>
* <p>
* <code>DestinationRegion</code> - The name of the region that the DB cluster snapshot will be created in.
* </p>
* </li>
* <li>
* <p>
* <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB cluster
* snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source region.
* For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 region, then your
* <code>SourceDBClusterSnapshotIdentifier</code> looks like the following example:
* <code>arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115</code>.
* </p>
* </li>
* </ul>
* <p>
* To learn how to generate a Signature Version 4 signed request, see <a
* href="http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html"> Authenticating Requests:
* Using Query Parameters (AWS Signature Version 4)</a> and <a
* href="http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html"> Signature Version 4 Signing
* Process</a>.
* </p>
*
* @param preSignedUrl
* The URL that contains a Signature Version 4 signed request for the <code>CopyDBClusterSnapshot</code> API
* action in the AWS region that contains the source DB cluster snapshot to copy. The
* <code>PreSignedUrl</code> parameter must be used when copying an encrypted DB cluster snapshot from
* another AWS region.</p>
* <p>
* The pre-signed URL must be a valid request for the <code>CopyDBSClusterSnapshot</code> API action that can
* be executed in the source region that contains the encrypted DB cluster snapshot to be copied. The
* pre-signed URL request must contain the following parameter values:
* </p>
* <ul>
* <li>
* <p>
* <code>KmsKeyId</code> - The KMS key identifier for the key to use to encrypt the copy of the DB cluster
* snapshot in the destination region. This is the same identifier for both the
* <code>CopyDBClusterSnapshot</code> action that is called in the destination region, and the action
* contained in the pre-signed URL.
* </p>
* </li>
* <li>
* <p>
* <code>DestinationRegion</code> - The name of the region that the DB cluster snapshot will be created in.
* </p>
* </li>
* <li>
* <p>
* <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB
* cluster snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the
* source region. For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 region,
* then your <code>SourceDBClusterSnapshotIdentifier</code> looks like the following example:
* <code>arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115</code>.
* </p>
* </li>
* </ul>
* <p>
* To learn how to generate a Signature Version 4 signed request, see <a
* href="http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html"> Authenticating
* Requests: Using Query Parameters (AWS Signature Version 4)</a> and <a
* href="http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html"> Signature Version 4 Signing
* Process</a>.
*/
public void setPreSignedUrl(String preSignedUrl) {
this.preSignedUrl = preSignedUrl;
}
/**
* <p>
* The URL that contains a Signature Version 4 signed request for the <code>CopyDBClusterSnapshot</code> API action
* in the AWS region that contains the source DB cluster snapshot to copy. The <code>PreSignedUrl</code> parameter
* must be used when copying an encrypted DB cluster snapshot from another AWS region.
* </p>
* <p>
* The pre-signed URL must be a valid request for the <code>CopyDBSClusterSnapshot</code> API action that can be
* executed in the source region that contains the encrypted DB cluster snapshot to be copied. The pre-signed URL
* request must contain the following parameter values:
* </p>
* <ul>
* <li>
* <p>
* <code>KmsKeyId</code> - The KMS key identifier for the key to use to encrypt the copy of the DB cluster snapshot
* in the destination region. This is the same identifier for both the <code>CopyDBClusterSnapshot</code> action
* that is called in the destination region, and the action contained in the pre-signed URL.
* </p>
* </li>
* <li>
* <p>
* <code>DestinationRegion</code> - The name of the region that the DB cluster snapshot will be created in.
* </p>
* </li>
* <li>
* <p>
* <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB cluster
* snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source region.
* For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 region, then your
* <code>SourceDBClusterSnapshotIdentifier</code> looks like the following example:
* <code>arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115</code>.
* </p>
* </li>
* </ul>
* <p>
* To learn how to generate a Signature Version 4 signed request, see <a
* href="http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html"> Authenticating Requests:
* Using Query Parameters (AWS Signature Version 4)</a> and <a
* href="http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html"> Signature Version 4 Signing
* Process</a>.
* </p>
*
* @return The URL that contains a Signature Version 4 signed request for the <code>CopyDBClusterSnapshot</code> API
* action in the AWS region that contains the source DB cluster snapshot to copy. The
* <code>PreSignedUrl</code> parameter must be used when copying an encrypted DB cluster snapshot from
* another AWS region.</p>
* <p>
* The pre-signed URL must be a valid request for the <code>CopyDBSClusterSnapshot</code> API action that
* can be executed in the source region that contains the encrypted DB cluster snapshot to be copied. The
* pre-signed URL request must contain the following parameter values:
* </p>
* <ul>
* <li>
* <p>
* <code>KmsKeyId</code> - The KMS key identifier for the key to use to encrypt the copy of the DB cluster
* snapshot in the destination region. This is the same identifier for both the
* <code>CopyDBClusterSnapshot</code> action that is called in the destination region, and the action
* contained in the pre-signed URL.
* </p>
* </li>
* <li>
* <p>
* <code>DestinationRegion</code> - The name of the region that the DB cluster snapshot will be created in.
* </p>
* </li>
* <li>
* <p>
* <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB
* cluster snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the
* source region. For example, if you are copying an encrypted DB cluster snapshot from the us-west-2
* region, then your <code>SourceDBClusterSnapshotIdentifier</code> looks like the following example:
* <code>arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115</code>.
* </p>
* </li>
* </ul>
* <p>
* To learn how to generate a Signature Version 4 signed request, see <a
* href="http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html"> Authenticating
* Requests: Using Query Parameters (AWS Signature Version 4)</a> and <a
* href="http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html"> Signature Version 4 Signing
* Process</a>.
*/
public String getPreSignedUrl() {
return this.preSignedUrl;
}
/**
* <p>
* The URL that contains a Signature Version 4 signed request for the <code>CopyDBClusterSnapshot</code> API action
* in the AWS region that contains the source DB cluster snapshot to copy. The <code>PreSignedUrl</code> parameter
* must be used when copying an encrypted DB cluster snapshot from another AWS region.
* </p>
* <p>
* The pre-signed URL must be a valid request for the <code>CopyDBSClusterSnapshot</code> API action that can be
* executed in the source region that contains the encrypted DB cluster snapshot to be copied. The pre-signed URL
* request must contain the following parameter values:
* </p>
* <ul>
* <li>
* <p>
* <code>KmsKeyId</code> - The KMS key identifier for the key to use to encrypt the copy of the DB cluster snapshot
* in the destination region. This is the same identifier for both the <code>CopyDBClusterSnapshot</code> action
* that is called in the destination region, and the action contained in the pre-signed URL.
* </p>
* </li>
* <li>
* <p>
* <code>DestinationRegion</code> - The name of the region that the DB cluster snapshot will be created in.
* </p>
* </li>
* <li>
* <p>
* <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB cluster
* snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source region.
* For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 region, then your
* <code>SourceDBClusterSnapshotIdentifier</code> looks like the following example:
* <code>arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115</code>.
* </p>
* </li>
* </ul>
* <p>
* To learn how to generate a Signature Version 4 signed request, see <a
* href="http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html"> Authenticating Requests:
* Using Query Parameters (AWS Signature Version 4)</a> and <a
* href="http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html"> Signature Version 4 Signing
* Process</a>.
* </p>
*
* @param preSignedUrl
* The URL that contains a Signature Version 4 signed request for the <code>CopyDBClusterSnapshot</code> API
* action in the AWS region that contains the source DB cluster snapshot to copy. The
* <code>PreSignedUrl</code> parameter must be used when copying an encrypted DB cluster snapshot from
* another AWS region.</p>
* <p>
* The pre-signed URL must be a valid request for the <code>CopyDBSClusterSnapshot</code> API action that can
* be executed in the source region that contains the encrypted DB cluster snapshot to be copied. The
* pre-signed URL request must contain the following parameter values:
* </p>
* <ul>
* <li>
* <p>
* <code>KmsKeyId</code> - The KMS key identifier for the key to use to encrypt the copy of the DB cluster
* snapshot in the destination region. This is the same identifier for both the
* <code>CopyDBClusterSnapshot</code> action that is called in the destination region, and the action
* contained in the pre-signed URL.
* </p>
* </li>
* <li>
* <p>
* <code>DestinationRegion</code> - The name of the region that the DB cluster snapshot will be created in.
* </p>
* </li>
* <li>
* <p>
* <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB
* cluster snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the
* source region. For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 region,
* then your <code>SourceDBClusterSnapshotIdentifier</code> looks like the following example:
* <code>arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115</code>.
* </p>
* </li>
* </ul>
* <p>
* To learn how to generate a Signature Version 4 signed request, see <a
* href="http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html"> Authenticating
* Requests: Using Query Parameters (AWS Signature Version 4)</a> and <a
* href="http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html"> Signature Version 4 Signing
* Process</a>.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public CopyDBClusterSnapshotRequest withPreSignedUrl(String preSignedUrl) {
setPreSignedUrl(preSignedUrl);
return this;
}
/**
* <p>
* True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot; otherwise false. The
* default is false.
* </p>
*
* @param copyTags
* True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot; otherwise
* false. The default is false.
*/
public void setCopyTags(Boolean copyTags) {
this.copyTags = copyTags;
}
/**
* <p>
* True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot; otherwise false. The
* default is false.
* </p>
*
* @return True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot; otherwise
* false. The default is false.
*/
public Boolean getCopyTags() {
return this.copyTags;
}
/**
* <p>
* True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot; otherwise false. The
* default is false.
* </p>
*
* @param copyTags
* True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot; otherwise
* false. The default is false.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public CopyDBClusterSnapshotRequest withCopyTags(Boolean copyTags) {
setCopyTags(copyTags);
return this;
}
/**
* <p>
* True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot; otherwise false. The
* default is false.
* </p>
*
* @return True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot; otherwise
* false. The default is false.
*/
public Boolean isCopyTags() {
return this.copyTags;
}
/**
* @return
*/
public java.util.List<Tag> getTags() {
if (tags == null) {
tags = new com.amazonaws.internal.SdkInternalList<Tag>();
}
return tags;
}
/**
* @param tags
*/
public void setTags(java.util.Collection<Tag> tags) {
if (tags == null) {
this.tags = null;
return;
}
this.tags = new com.amazonaws.internal.SdkInternalList<Tag>(tags);
}
/**
* <p>
* <b>NOTE:</b> This method appends the values to the existing list (if any). Use
* {@link #setTags(java.util.Collection)} or {@link #withTags(java.util.Collection)} if you want to override the
* existing values.
* </p>
*
* @param tags
* @return Returns a reference to this object so that method calls can be chained together.
*/
public CopyDBClusterSnapshotRequest withTags(Tag... tags) {
if (this.tags == null) {
setTags(new com.amazonaws.internal.SdkInternalList<Tag>(tags.length));
}
for (Tag ele : tags) {
this.tags.add(ele);
}
return this;
}
/**
* @param tags
* @return Returns a reference to this object so that method calls can be chained together.
*/
public CopyDBClusterSnapshotRequest withTags(java.util.Collection<Tag> tags) {
setTags(tags);
return this;
}
/**
* The region where the source cluster snapshot is located.
*
* @param sourceRegion
* The region where the source cluster snapshot is located.
*/
public void setSourceRegion(String sourceRegion) {
this.sourceRegion = sourceRegion;
}
/**
* The region where the source cluster snapshot is located.
*
* @return The region where the source cluster snapshot is located.
*/
public String getSourceRegion() {
return this.sourceRegion;
}
/**
* The region where the source cluster snapshot is located.
*
* @param sourceRegion
* The region where the source cluster snapshot is located.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public CopyDBClusterSnapshotRequest withSourceRegion(String sourceRegion) {
setSourceRegion(sourceRegion);
return this;
}
/**
* Returns a string representation of this object; useful for testing and debugging.
*
* @return A string representation of this object.
*
* @see java.lang.Object#toString()
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("{");
if (getSourceDBClusterSnapshotIdentifier() != null)
sb.append("SourceDBClusterSnapshotIdentifier: ").append(getSourceDBClusterSnapshotIdentifier()).append(",");
if (getTargetDBClusterSnapshotIdentifier() != null)
sb.append("TargetDBClusterSnapshotIdentifier: ").append(getTargetDBClusterSnapshotIdentifier()).append(",");
if (getKmsKeyId() != null)
sb.append("KmsKeyId: ").append(getKmsKeyId()).append(",");
if (getPreSignedUrl() != null)
sb.append("PreSignedUrl: ").append(getPreSignedUrl()).append(",");
if (getCopyTags() != null)
sb.append("CopyTags: ").append(getCopyTags()).append(",");
if (getTags() != null)
sb.append("Tags: ").append(getTags()).append(",");
if (getSourceRegion() != null)
sb.append("SourceRegion: ").append(getSourceRegion());
sb.append("}");
return sb.toString();
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (obj instanceof CopyDBClusterSnapshotRequest == false)
return false;
CopyDBClusterSnapshotRequest other = (CopyDBClusterSnapshotRequest) obj;
if (other.getSourceDBClusterSnapshotIdentifier() == null ^ this.getSourceDBClusterSnapshotIdentifier() == null)
return false;
if (other.getSourceDBClusterSnapshotIdentifier() != null
&& other.getSourceDBClusterSnapshotIdentifier().equals(this.getSourceDBClusterSnapshotIdentifier()) == false)
return false;
if (other.getTargetDBClusterSnapshotIdentifier() == null ^ this.getTargetDBClusterSnapshotIdentifier() == null)
return false;
if (other.getTargetDBClusterSnapshotIdentifier() != null
&& other.getTargetDBClusterSnapshotIdentifier().equals(this.getTargetDBClusterSnapshotIdentifier()) == false)
return false;
if (other.getKmsKeyId() == null ^ this.getKmsKeyId() == null)
return false;
if (other.getKmsKeyId() != null && other.getKmsKeyId().equals(this.getKmsKeyId()) == false)
return false;
if (other.getPreSignedUrl() == null ^ this.getPreSignedUrl() == null)
return false;
if (other.getPreSignedUrl() != null && other.getPreSignedUrl().equals(this.getPreSignedUrl()) == false)
return false;
if (other.getCopyTags() == null ^ this.getCopyTags() == null)
return false;
if (other.getCopyTags() != null && other.getCopyTags().equals(this.getCopyTags()) == false)
return false;
if (other.getTags() == null ^ this.getTags() == null)
return false;
if (other.getTags() != null && other.getTags().equals(this.getTags()) == false)
return false;
if (other.getSourceRegion() == null ^ this.getSourceRegion() == null)
return false;
if (other.getSourceRegion() != null && other.getSourceRegion().equals(this.getSourceRegion()) == false)
return false;
return true;
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getSourceDBClusterSnapshotIdentifier() == null) ? 0 : getSourceDBClusterSnapshotIdentifier().hashCode());
hashCode = prime * hashCode + ((getTargetDBClusterSnapshotIdentifier() == null) ? 0 : getTargetDBClusterSnapshotIdentifier().hashCode());
hashCode = prime * hashCode + ((getKmsKeyId() == null) ? 0 : getKmsKeyId().hashCode());
hashCode = prime * hashCode + ((getPreSignedUrl() == null) ? 0 : getPreSignedUrl().hashCode());
hashCode = prime * hashCode + ((getCopyTags() == null) ? 0 : getCopyTags().hashCode());
hashCode = prime * hashCode + ((getTags() == null) ? 0 : getTags().hashCode());
hashCode = prime * hashCode + ((getSourceRegion() == null) ? 0 : getSourceRegion().hashCode());
return hashCode;
}
@Override
public CopyDBClusterSnapshotRequest clone() {
return (CopyDBClusterSnapshotRequest) super.clone();
}
}