Neptune Snapshots API
Structures:
Actions:
DBClusterSnapshot (structure)
Contains the details for an Amazon Neptune DB cluster snapshot
This data type is used as a response element in the DescribeDBClusterSnapshots (action) action.
Fields
-
AllocatedStorage – Number (integer).
Specifies the allocated storage size in gibibytes (GiB).
-
AvailabilityZones – An array of AvailabilityZone— UTF-8 strings.
Provides the list of EC2 Availability Zones that instances in the DB cluster snapshot can be restored in.
-
ClusterCreateTime – Timestamp.
Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).
-
DBClusterIdentifier – UTF-8 string.
Specifies the DB cluster identifier of the DB cluster that this DB cluster snapshot was created from.
-
DBClusterSnapshotArn – UTF-8 string.
The Amazon Resource Name (ARN) for the DB cluster snapshot.
-
DBClusterSnapshotIdentifier – UTF-8 string.
Specifies the identifier for a DB cluster snapshot. Must match the identifier of an existing snapshot.
After you restore a DB cluster using a
DBClusterSnapshotIdentifier
, you must specify the sameDBClusterSnapshotIdentifier
for any future updates to the DB cluster. When you specify this property for an update, the DB cluster is not restored from the snapshot again, and the data in the database is not changed.However, if you don't specify the
DBClusterSnapshotIdentifier
, an empty DB cluster is created, and the original DB cluster is deleted. If you specify a property that is different from the previous snapshot restore property, the DB cluster is restored from the snapshot specified by theDBClusterSnapshotIdentifier
, and the original DB cluster is deleted. -
Specifies the name of the database engine.
-
Provides the version of the database engine for this DB cluster snapshot.
-
IAMDatabaseAuthenticationEnabled – Boolean.
True if mapping of Amazon Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.
-
If
StorageEncrypted
is true, the Amazon KMS key identifier for the encrypted DB cluster snapshot. -
Provides the license model information for this DB cluster snapshot.
-
PercentProgress – Number (integer).
Specifies the percentage of the estimated data that has been transferred.
-
Specifies the port that the DB cluster was listening on at the time of the snapshot.
-
SnapshotCreateTime – Timestamp.
Provides the time when the snapshot was taken, in Universal Coordinated Time (UTC).
-
Provides the type of the DB cluster snapshot.
-
SourceDBClusterSnapshotArn – UTF-8 string.
If the DB cluster snapshot was copied from a source DB cluster snapshot, the Amazon Resource Name (ARN) for the source DB cluster snapshot, otherwise, a null value.
-
Specifies the status of this DB cluster snapshot.
-
Specifies whether the DB cluster snapshot is encrypted.
-
Provides the VPC ID associated with the DB cluster snapshot.
DBClusterSnapshot
is used as the response element for:
DBClusterSnapshotAttribute (structure)
Contains the name and values of a manual DB cluster snapshot attribute.
Manual DB cluster snapshot attributes are used to authorize other Amazon accounts to restore a manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute (action) API action.
Fields
-
The name of the manual DB cluster snapshot attribute.
The attribute named
restore
refers to the list of Amazon accounts that have permission to copy or restore the manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute (action) API action. -
AttributeValues – An array of AttributeValue— UTF-8 strings.
The value(s) for the manual DB cluster snapshot attribute.
If the
AttributeName
field is set torestore
, then this element returns a list of IDs of the Amazon accounts that are authorized to copy or restore the manual DB cluster snapshot. If a value ofall
is in the list, then the manual DB cluster snapshot is public and available for any Amazon account to copy or restore.
DBClusterSnapshotAttributesResult (structure)
Contains the results of a successful call to the DescribeDBClusterSnapshotAttributes (action) API action.
Manual DB cluster snapshot attributes are used to authorize other Amazon accounts to copy or restore a manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute (action) API action.
Fields
-
DBClusterSnapshotAttributes – An array of DBClusterSnapshotAttribute DBClusterSnapshotAttribute objects.
The list of attributes and values for the manual DB cluster snapshot.
-
DBClusterSnapshotIdentifier – UTF-8 string.
The identifier of the manual DB cluster snapshot that the attributes apply to.
DBClusterSnapshotAttributesResult
is used as the response element for:
CreateDBClusterSnapshot (action)
The Amazon CLI name for this API is: create-db-cluster-snapshot
, and the Python name is: create_db_cluster_snapshot
.
Creates a snapshot of a DB cluster.
Request
-
DBClusterIdentifier (in the CLI:
--db-cluster-identifier
, or in Python:db_cluster_identifier
) – Required: UTF-8 string.The identifier of the DB cluster to create a snapshot for. This parameter is not case-sensitive.
Constraints:
-
Must match the identifier of an existing DBCluster.
Example:
my-cluster1
-
-
DBClusterSnapshotIdentifier (in the CLI:
--db-cluster-snapshot-identifier
, or in Python:db_cluster_snapshot_identifier
) – Required: UTF-8 string.The identifier of the DB cluster snapshot. This parameter is stored as a lowercase string.
Constraints:
-
Must contain from 1 to 63 letters, numbers, or hyphens.
-
First character must be a letter.
-
Cannot end with a hyphen or contain two consecutive hyphens.
Example:
my-cluster1-snapshot1
-
-
Tags (in the CLI:
--tags
, or in Python:tags
) – An array of Tag Tag objects.The tags to be assigned to the DB cluster snapshot.
Response
Contains the details for an Amazon Neptune DB cluster snapshot
This data type is used as a response element in the DescribeDBClusterSnapshots (action) action.
-
AllocatedStorage (in the CLI:
--allocated-storage
, or in Python:allocated_storage
) – Number (integer).Specifies the allocated storage size in gibibytes (GiB).
-
AvailabilityZones (in the CLI:
--availability-zones
, or in Python:availability_zones
) – An array of AvailabilityZone— UTF-8 strings.Provides the list of EC2 Availability Zones that instances in the DB cluster snapshot can be restored in.
-
ClusterCreateTime (in the CLI:
--cluster-create-time
, or in Python:cluster_create_time
) – Timestamp.Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).
-
DBClusterIdentifier (in the CLI:
--db-cluster-identifier
, or in Python:db_cluster_identifier
) – UTF-8 string.Specifies the DB cluster identifier of the DB cluster that this DB cluster snapshot was created from.
-
DBClusterSnapshotArn (in the CLI:
--db-cluster-snapshot-arn
, or in Python:db_cluster_snapshot_arn
) – UTF-8 string.The Amazon Resource Name (ARN) for the DB cluster snapshot.
-
DBClusterSnapshotIdentifier (in the CLI:
--db-cluster-snapshot-identifier
, or in Python:db_cluster_snapshot_identifier
) – UTF-8 string.Specifies the identifier for a DB cluster snapshot. Must match the identifier of an existing snapshot.
After you restore a DB cluster using a
DBClusterSnapshotIdentifier
, you must specify the sameDBClusterSnapshotIdentifier
for any future updates to the DB cluster. When you specify this property for an update, the DB cluster is not restored from the snapshot again, and the data in the database is not changed.However, if you don't specify the
DBClusterSnapshotIdentifier
, an empty DB cluster is created, and the original DB cluster is deleted. If you specify a property that is different from the previous snapshot restore property, the DB cluster is restored from the snapshot specified by theDBClusterSnapshotIdentifier
, and the original DB cluster is deleted. -
Engine (in the CLI:
--engine
, or in Python:engine
) – UTF-8 string.Specifies the name of the database engine.
-
EngineVersion (in the CLI:
--engine-version
, or in Python:engine_version
) – UTF-8 string.Provides the version of the database engine for this DB cluster snapshot.
-
IAMDatabaseAuthenticationEnabled (in the CLI:
--iam-database-authentication-enabled
, or in Python:iam_database_authentication_enabled
) – Boolean.True if mapping of Amazon Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.
-
KmsKeyId (in the CLI:
--kms-key-id
, or in Python:kms_key_id
) – UTF-8 string.If
StorageEncrypted
is true, the Amazon KMS key identifier for the encrypted DB cluster snapshot. -
LicenseModel (in the CLI:
--license-model
, or in Python:license_model
) – UTF-8 string.Provides the license model information for this DB cluster snapshot.
-
PercentProgress (in the CLI:
--percent-progress
, or in Python:percent_progress
) – Number (integer).Specifies the percentage of the estimated data that has been transferred.
-
Port (in the CLI:
--port
, or in Python:port
) – Number (integer).Specifies the port that the DB cluster was listening on at the time of the snapshot.
-
SnapshotCreateTime (in the CLI:
--snapshot-create-time
, or in Python:snapshot_create_time
) – Timestamp.Provides the time when the snapshot was taken, in Universal Coordinated Time (UTC).
-
SnapshotType (in the CLI:
--snapshot-type
, or in Python:snapshot_type
) – UTF-8 string.Provides the type of the DB cluster snapshot.
-
SourceDBClusterSnapshotArn (in the CLI:
--source-db-cluster-snapshot-arn
, or in Python:source_db_cluster_snapshot_arn
) – UTF-8 string.If the DB cluster snapshot was copied from a source DB cluster snapshot, the Amazon Resource Name (ARN) for the source DB cluster snapshot, otherwise, a null value.
-
Status (in the CLI:
--status
, or in Python:status
) – UTF-8 string.Specifies the status of this DB cluster snapshot.
-
StorageEncrypted (in the CLI:
--storage-encrypted
, or in Python:storage_encrypted
) – Boolean.Specifies whether the DB cluster snapshot is encrypted.
-
VpcId (in the CLI:
--vpc-id
, or in Python:vpc_id
) – UTF-8 string.Provides the VPC ID associated with the DB cluster snapshot.
Errors
DeleteDBClusterSnapshot (action)
The Amazon CLI name for this API is: delete-db-cluster-snapshot
, and the Python name is: delete_db_cluster_snapshot
.
Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.
Note
The DB cluster snapshot must be in the available
state to
be deleted.
Request
Response
Contains the details for an Amazon Neptune DB cluster snapshot
This data type is used as a response element in the DescribeDBClusterSnapshots (action) action.
-
AllocatedStorage (in the CLI:
--allocated-storage
, or in Python:allocated_storage
) – Number (integer).Specifies the allocated storage size in gibibytes (GiB).
-
AvailabilityZones (in the CLI:
--availability-zones
, or in Python:availability_zones
) – An array of AvailabilityZone— UTF-8 strings.Provides the list of EC2 Availability Zones that instances in the DB cluster snapshot can be restored in.
-
ClusterCreateTime (in the CLI:
--cluster-create-time
, or in Python:cluster_create_time
) – Timestamp.Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).
-
DBClusterIdentifier (in the CLI:
--db-cluster-identifier
, or in Python:db_cluster_identifier
) – UTF-8 string.Specifies the DB cluster identifier of the DB cluster that this DB cluster snapshot was created from.
-
DBClusterSnapshotArn (in the CLI:
--db-cluster-snapshot-arn
, or in Python:db_cluster_snapshot_arn
) – UTF-8 string.The Amazon Resource Name (ARN) for the DB cluster snapshot.
-
DBClusterSnapshotIdentifier (in the CLI:
--db-cluster-snapshot-identifier
, or in Python:db_cluster_snapshot_identifier
) – UTF-8 string.Specifies the identifier for a DB cluster snapshot. Must match the identifier of an existing snapshot.
After you restore a DB cluster using a
DBClusterSnapshotIdentifier
, you must specify the sameDBClusterSnapshotIdentifier
for any future updates to the DB cluster. When you specify this property for an update, the DB cluster is not restored from the snapshot again, and the data in the database is not changed.However, if you don't specify the
DBClusterSnapshotIdentifier
, an empty DB cluster is created, and the original DB cluster is deleted. If you specify a property that is different from the previous snapshot restore property, the DB cluster is restored from the snapshot specified by theDBClusterSnapshotIdentifier
, and the original DB cluster is deleted. -
Engine (in the CLI:
--engine
, or in Python:engine
) – UTF-8 string.Specifies the name of the database engine.
-
EngineVersion (in the CLI:
--engine-version
, or in Python:engine_version
) – UTF-8 string.Provides the version of the database engine for this DB cluster snapshot.
-
IAMDatabaseAuthenticationEnabled (in the CLI:
--iam-database-authentication-enabled
, or in Python:iam_database_authentication_enabled
) – Boolean.True if mapping of Amazon Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.
-
KmsKeyId (in the CLI:
--kms-key-id
, or in Python:kms_key_id
) – UTF-8 string.If
StorageEncrypted
is true, the Amazon KMS key identifier for the encrypted DB cluster snapshot. -
LicenseModel (in the CLI:
--license-model
, or in Python:license_model
) – UTF-8 string.Provides the license model information for this DB cluster snapshot.
-
PercentProgress (in the CLI:
--percent-progress
, or in Python:percent_progress
) – Number (integer).Specifies the percentage of the estimated data that has been transferred.
-
Port (in the CLI:
--port
, or in Python:port
) – Number (integer).Specifies the port that the DB cluster was listening on at the time of the snapshot.
-
SnapshotCreateTime (in the CLI:
--snapshot-create-time
, or in Python:snapshot_create_time
) – Timestamp.Provides the time when the snapshot was taken, in Universal Coordinated Time (UTC).
-
SnapshotType (in the CLI:
--snapshot-type
, or in Python:snapshot_type
) – UTF-8 string.Provides the type of the DB cluster snapshot.
-
SourceDBClusterSnapshotArn (in the CLI:
--source-db-cluster-snapshot-arn
, or in Python:source_db_cluster_snapshot_arn
) – UTF-8 string.If the DB cluster snapshot was copied from a source DB cluster snapshot, the Amazon Resource Name (ARN) for the source DB cluster snapshot, otherwise, a null value.
-
Status (in the CLI:
--status
, or in Python:status
) – UTF-8 string.Specifies the status of this DB cluster snapshot.
-
StorageEncrypted (in the CLI:
--storage-encrypted
, or in Python:storage_encrypted
) – Boolean.Specifies whether the DB cluster snapshot is encrypted.
-
VpcId (in the CLI:
--vpc-id
, or in Python:vpc_id
) – UTF-8 string.Provides the VPC ID associated with the DB cluster snapshot.
CopyDBClusterSnapshot (action)
The Amazon CLI name for this API is: copy-db-cluster-snapshot
, and the Python name is: copy_db_cluster_snapshot
.
Copies a snapshot of a DB cluster.
To copy a DB cluster snapshot from a shared manual DB cluster snapshot,
SourceDBClusterSnapshotIdentifier
must be the Amazon Resource
Name (ARN) of the shared DB cluster snapshot.
Request
-
CopyTags (in the CLI:
--copy-tags
, or in Python:copy_tags
) – Boolean.True to copy all tags from the source DB cluster snapshot to the target DB cluster snapshot, and otherwise false. The default is false.
-
KmsKeyId (in the CLI:
--kms-key-id
, or in Python:kms_key_id
) – UTF-8 string.The Amazon Amazon 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.
If you copy an encrypted DB cluster snapshot from your Amazon account, you can specify a value for
KmsKeyId
to encrypt the copy with a new KMS encryption key. If you don't specify a value forKmsKeyId
, then the copy of the DB cluster snapshot is encrypted with the same KMS key as the source DB cluster snapshot.If you copy an encrypted DB cluster snapshot that is shared from another Amazon account, then you must specify a value for
KmsKeyId
.KMS encryption keys are specific to the Amazon Region that they are created in, and you can't use encryption keys from one Amazon Region in another Amazon Region.
You cannot encrypt an unencrypted DB cluster snapshot when you copy it. If you try to copy an unencrypted DB cluster snapshot and specify a value for the KmsKeyId parameter, an error is returned.
-
PreSignedUrl (in the CLI:
--pre-signed-url
, or in Python:pre_signed_url
) – UTF-8 string.Not currently supported.
-
SourceDBClusterSnapshotIdentifier (in the CLI:
--source-db-cluster-snapshot-identifier
, or in Python:source_db_cluster_snapshot_identifier
) – Required: UTF-8 string.The identifier of the DB cluster snapshot to copy. This parameter is not case-sensitive.
Constraints:
-
Must specify a valid system snapshot in the "available" state.
-
Specify a valid DB snapshot identifier.
Example:
my-cluster-snapshot1
-
-
Tags (in the CLI:
--tags
, or in Python:tags
) – An array of Tag Tag objects.The tags to assign to the new DB cluster snapshot copy.
-
TargetDBClusterSnapshotIdentifier (in the CLI:
--target-db-cluster-snapshot-identifier
, or in Python:target_db_cluster_snapshot_identifier
) – Required: UTF-8 string.The identifier of the new DB cluster snapshot to create from the source DB cluster snapshot. This parameter is not case-sensitive.
Constraints:
-
Must contain from 1 to 63 letters, numbers, or hyphens.
-
First character must be a letter.
-
Cannot end with a hyphen or contain two consecutive hyphens.
Example:
my-cluster-snapshot2
-
Response
Contains the details for an Amazon Neptune DB cluster snapshot
This data type is used as a response element in the DescribeDBClusterSnapshots (action) action.
-
AllocatedStorage (in the CLI:
--allocated-storage
, or in Python:allocated_storage
) – Number (integer).Specifies the allocated storage size in gibibytes (GiB).
-
AvailabilityZones (in the CLI:
--availability-zones
, or in Python:availability_zones
) – An array of AvailabilityZone— UTF-8 strings.Provides the list of EC2 Availability Zones that instances in the DB cluster snapshot can be restored in.
-
ClusterCreateTime (in the CLI:
--cluster-create-time
, or in Python:cluster_create_time
) – Timestamp.Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).
-
DBClusterIdentifier (in the CLI:
--db-cluster-identifier
, or in Python:db_cluster_identifier
) – UTF-8 string.Specifies the DB cluster identifier of the DB cluster that this DB cluster snapshot was created from.
-
DBClusterSnapshotArn (in the CLI:
--db-cluster-snapshot-arn
, or in Python:db_cluster_snapshot_arn
) – UTF-8 string.The Amazon Resource Name (ARN) for the DB cluster snapshot.
-
DBClusterSnapshotIdentifier (in the CLI:
--db-cluster-snapshot-identifier
, or in Python:db_cluster_snapshot_identifier
) – UTF-8 string.Specifies the identifier for a DB cluster snapshot. Must match the identifier of an existing snapshot.
After you restore a DB cluster using a
DBClusterSnapshotIdentifier
, you must specify the sameDBClusterSnapshotIdentifier
for any future updates to the DB cluster. When you specify this property for an update, the DB cluster is not restored from the snapshot again, and the data in the database is not changed.However, if you don't specify the
DBClusterSnapshotIdentifier
, an empty DB cluster is created, and the original DB cluster is deleted. If you specify a property that is different from the previous snapshot restore property, the DB cluster is restored from the snapshot specified by theDBClusterSnapshotIdentifier
, and the original DB cluster is deleted. -
Engine (in the CLI:
--engine
, or in Python:engine
) – UTF-8 string.Specifies the name of the database engine.
-
EngineVersion (in the CLI:
--engine-version
, or in Python:engine_version
) – UTF-8 string.Provides the version of the database engine for this DB cluster snapshot.
-
IAMDatabaseAuthenticationEnabled (in the CLI:
--iam-database-authentication-enabled
, or in Python:iam_database_authentication_enabled
) – Boolean.True if mapping of Amazon Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.
-
KmsKeyId (in the CLI:
--kms-key-id
, or in Python:kms_key_id
) – UTF-8 string.If
StorageEncrypted
is true, the Amazon KMS key identifier for the encrypted DB cluster snapshot. -
LicenseModel (in the CLI:
--license-model
, or in Python:license_model
) – UTF-8 string.Provides the license model information for this DB cluster snapshot.
-
PercentProgress (in the CLI:
--percent-progress
, or in Python:percent_progress
) – Number (integer).Specifies the percentage of the estimated data that has been transferred.
-
Port (in the CLI:
--port
, or in Python:port
) – Number (integer).Specifies the port that the DB cluster was listening on at the time of the snapshot.
-
SnapshotCreateTime (in the CLI:
--snapshot-create-time
, or in Python:snapshot_create_time
) – Timestamp.Provides the time when the snapshot was taken, in Universal Coordinated Time (UTC).
-
SnapshotType (in the CLI:
--snapshot-type
, or in Python:snapshot_type
) – UTF-8 string.Provides the type of the DB cluster snapshot.
-
SourceDBClusterSnapshotArn (in the CLI:
--source-db-cluster-snapshot-arn
, or in Python:source_db_cluster_snapshot_arn
) – UTF-8 string.If the DB cluster snapshot was copied from a source DB cluster snapshot, the Amazon Resource Name (ARN) for the source DB cluster snapshot, otherwise, a null value.
-
Status (in the CLI:
--status
, or in Python:status
) – UTF-8 string.Specifies the status of this DB cluster snapshot.
-
StorageEncrypted (in the CLI:
--storage-encrypted
, or in Python:storage_encrypted
) – Boolean.Specifies whether the DB cluster snapshot is encrypted.
-
VpcId (in the CLI:
--vpc-id
, or in Python:vpc_id
) – UTF-8 string.Provides the VPC ID associated with the DB cluster snapshot.
Errors
ModifyDBClusterSnapshotAttribute (action)
The Amazon CLI name for this API is: modify-db-cluster-snapshot-attribute
, and the Python name is: modify_db_cluster_snapshot_attribute
.
Adds an attribute and values to, or removes an attribute and values from, a manual DB cluster snapshot.
To share a manual DB cluster snapshot with other Amazon accounts, specify
restore
as the AttributeName
and use the ValuesToAdd
parameter to add a list of IDs of the Amazon accounts that are authorized to restore
the manual DB cluster snapshot. Use the value all
to make the manual
DB cluster snapshot public, which means that it can be copied or restored by all
Amazon accounts. Do not add the all
value for any manual DB cluster
snapshots that contain private information that you don't want available to
all Amazon accounts. If a manual DB cluster snapshot is encrypted, it can be shared,
but only by specifying a list of authorized Amazon account IDs for the ValuesToAdd
parameter. You can't use all
as a value for that parameter in this
case.
To view which Amazon accounts have access to copy or restore a manual DB cluster snapshot, or whether a manual DB cluster snapshot public or private, use the DescribeDBClusterSnapshotAttributes (action) API action.
Request
-
AttributeName (in the CLI:
--attribute-name
, or in Python:attribute_name
) – Required: UTF-8 string.The name of the DB cluster snapshot attribute to modify.
To manage authorization for other Amazon accounts to copy or restore a manual DB cluster snapshot, set this value to
restore
. -
DBClusterSnapshotIdentifier (in the CLI:
--db-cluster-snapshot-identifier
, or in Python:db_cluster_snapshot_identifier
) – Required: UTF-8 string.The identifier for the DB cluster snapshot to modify the attributes for.
-
ValuesToAdd (in the CLI:
--values-to-add
, or in Python:values_to_add
) – An array of AttributeValue— UTF-8 strings.A list of DB cluster snapshot attributes to add to the attribute specified by
AttributeName
.To authorize other Amazon accounts to copy or restore a manual DB cluster snapshot, set this list to include one or more Amazon account IDs, or
all
to make the manual DB cluster snapshot restorable by any Amazon account. Do not add theall
value for any manual DB cluster snapshots that contain private information that you don't want available to all Amazon accounts. -
ValuesToRemove (in the CLI:
--values-to-remove
, or in Python:values_to_remove
) – An array of AttributeValue— UTF-8 strings.A list of DB cluster snapshot attributes to remove from the attribute specified by
AttributeName
.To remove authorization for other Amazon accounts to copy or restore a manual DB cluster snapshot, set this list to include one or more Amazon account identifiers, or
all
to remove authorization for any Amazon account to copy or restore the DB cluster snapshot. If you specifyall
, an Amazon account whose account ID is explicitly added to therestore
attribute can still copy or restore a manual DB cluster snapshot.
Response
Contains the results of a successful call to the DescribeDBClusterSnapshotAttributes (action) API action.
Manual DB cluster snapshot attributes are used to authorize other Amazon accounts to copy or restore a manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute (action) API action.
-
DBClusterSnapshotAttributes (in the CLI:
--db-cluster-snapshot-attributes
, or in Python:db_cluster_snapshot_attributes
) – An array of DBClusterSnapshotAttribute DBClusterSnapshotAttribute objects.The list of attributes and values for the manual DB cluster snapshot.
-
DBClusterSnapshotIdentifier (in the CLI:
--db-cluster-snapshot-identifier
, or in Python:db_cluster_snapshot_identifier
) – UTF-8 string.The identifier of the manual DB cluster snapshot that the attributes apply to.
Errors
RestoreDBClusterFromSnapshot (action)
The Amazon CLI name for this API is: restore-db-cluster-from-snapshot
, and the Python name is: restore_db_cluster_from_snapshot
.
Creates a new DB cluster from a DB snapshot or DB cluster snapshot.
If a DB snapshot is specified, the target DB cluster is created from the source DB snapshot with a default configuration and default security group.
If a DB cluster snapshot is specified, the target DB cluster is created from the source DB cluster restore point with the same configuration as the original source DB cluster, except that the new DB cluster is created with the default security group.
Request
-
AvailabilityZones (in the CLI:
--availability-zones
, or in Python:availability_zones
) – An array of AvailabilityZone— UTF-8 strings.Provides the list of EC2 Availability Zones that instances in the restored DB cluster can be created in.
-
CopyTagsToSnapshot (in the CLI:
--copy-tags-to-snapshot
, or in Python:copy_tags_to_snapshot
) – Boolean.If set to
true
, tags are copied to any snapshot of the restored DB cluster that is created. -
DatabaseName (in the CLI:
--database-name
, or in Python:database_name
) – UTF-8 string.Not supported.
-
DBClusterIdentifier (in the CLI:
--db-cluster-identifier
, or in Python:db_cluster_identifier
) – Required: UTF-8 string.The name of the DB cluster to create from the DB snapshot or DB cluster snapshot. This parameter isn't case-sensitive.
Constraints:
-
Must contain from 1 to 63 letters, numbers, or hyphens
-
First character must be a letter
-
Cannot end with a hyphen or contain two consecutive hyphens
Example:
my-snapshot-id
-
-
DBClusterParameterGroupName (in the CLI:
--db-cluster-parameter-group-name
, or in Python:db_cluster_parameter_group_name
) – UTF-8 string.The name of the DB cluster parameter group to associate with the new DB cluster.
Constraints:
-
If supplied, must match the name of an existing DBClusterParameterGroup.
-
-
DBSubnetGroupName (in the CLI:
--db-subnet-group-name
, or in Python:db_subnet_group_name
) – UTF-8 string.The name of the DB subnet group to use for the new DB cluster.
Constraints: If supplied, must match the name of an existing DBSubnetGroup.
Example:
mySubnetgroup
-
DeletionProtection (in the CLI:
--deletion-protection
, or in Python:deletion_protection
) – Boolean.A value that indicates whether the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection is disabled.
-
EnableCloudwatchLogsExports (in the CLI:
--enable-cloudwatch-logs-exports
, or in Python:enable_cloudwatch_logs_exports
) – An array of UTF-8 strings.The list of logs that the restored DB cluster is to export to Amazon CloudWatch Logs.
-
EnableIAMDatabaseAuthentication (in the CLI:
--enable-iam-database-authentication
, or in Python:enable_iam_database_authentication
) – Boolean.True to enable mapping of Amazon Identity and Access Management (IAM) accounts to database accounts, and otherwise false.
Default:
false
-
Engine (in the CLI:
--engine
, or in Python:engine
) – Required: UTF-8 string.The database engine to use for the new DB cluster.
Default: The same as source
Constraint: Must be compatible with the engine of the source
-
EngineVersion (in the CLI:
--engine-version
, or in Python:engine_version
) – UTF-8 string.The version of the database engine to use for the new DB cluster.
-
KmsKeyId (in the CLI:
--kms-key-id
, or in Python:kms_key_id
) – UTF-8 string.The Amazon KMS key identifier to use when restoring an encrypted DB cluster from a DB snapshot or DB cluster snapshot.
The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a DB cluster with the same Amazon account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.
If you do not specify a value for the
KmsKeyId
parameter, then the following will occur:-
If the DB snapshot or DB cluster snapshot in
SnapshotIdentifier
is encrypted, then the restored DB cluster is encrypted using the KMS key that was used to encrypt the DB snapshot or DB cluster snapshot. -
If the DB snapshot or DB cluster snapshot in
SnapshotIdentifier
is not encrypted, then the restored DB cluster is not encrypted.
-
-
Port (in the CLI:
--port
, or in Python:port
) – Number (integer).The port number on which the new DB cluster accepts connections.
Constraints: Value must be
1150-65535
Default: The same port as the original DB cluster.
-
ServerlessV2ScalingConfiguration (in the CLI:
--serverless-v2-scaling-configuration
, or in Python:serverless_v2_scaling_configuration
) – A ServerlessV2ScalingConfiguration object.Contains the scaling configuration of a Neptune Serverless DB cluster.
For more information, see Using Amazon Neptune Serverless in the Amazon Neptune User Guide.
-
SnapshotIdentifier (in the CLI:
--snapshot-identifier
, or in Python:snapshot_identifier
) – Required: UTF-8 string.The identifier for the DB snapshot or DB cluster snapshot to restore from.
You can use either the name or the Amazon Resource Name (ARN) to specify a DB cluster snapshot. However, you can use only the ARN to specify a DB snapshot.
Constraints:
-
Must match the identifier of an existing Snapshot.
-
-
Tags (in the CLI:
--tags
, or in Python:tags
) – An array of Tag Tag objects.The tags to be assigned to the restored DB cluster.
-
VpcSecurityGroupIds (in the CLI:
--vpc-security-group-ids
, or in Python:vpc_security_group_ids
) – An array of VpcSecurityGroupId— UTF-8 strings.A list of VPC security groups that the new DB cluster will belong to.
Response
Contains the details of an Amazon Neptune DB cluster.
This data type is used as a response element in the DescribeDBClusters (action).
-
AllocatedStorage (in the CLI:
--allocated-storage
, or in Python:allocated_storage
) – Number (integer).AllocatedStorage
always returns 1, because Neptune DB cluster storage size is not fixed, but instead automatically adjusts as needed. -
AssociatedRoles (in the CLI:
--associated-roles
, or in Python:associated_roles
) – An array of DBClusterRole DBClusterRole objects.Provides a list of the Amazon Identity and Access Management (IAM) roles that are associated with the DB cluster. IAM roles that are associated with a DB cluster grant permission for the DB cluster to access other Amazon services on your behalf.
-
AutomaticRestartTime (in the CLI:
--automatic-restart-time
, or in Python:automatic_restart_time
) – Timestamp.Time at which the DB cluster will be automatically restarted.
-
AvailabilityZones (in the CLI:
--availability-zones
, or in Python:availability_zones
) – An array of AvailabilityZone— UTF-8 strings.Provides the list of EC2 Availability Zones that instances in the DB cluster can be created in.
-
BacktrackConsumedChangeRecords (in the CLI:
--backtrack-consumed-change-records
, or in Python:backtrack_consumed_change_records
) – Number (long).Not supported by Neptune.
-
BacktrackWindow (in the CLI:
--backtrack-window
, or in Python:backtrack_window
) – Number (long).Not supported by Neptune.
-
BackupRetentionPeriod (in the CLI:
--backup-retention-period
, or in Python:backup_retention_period
) – Number (integer).Specifies the number of days for which automatic DB snapshots are retained.
-
Capacity (in the CLI:
--capacity
, or in Python:capacity
) – Number (integer).Not supported by Neptune.
-
CloneGroupId (in the CLI:
--clone-group-id
, or in Python:clone_group_id
) – UTF-8 string.Identifies the clone group to which the DB cluster is associated.
-
ClusterCreateTime (in the CLI:
--cluster-create-time
, or in Python:cluster_create_time
) – Timestamp.Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).
-
CopyTagsToSnapshot (in the CLI:
--copy-tags-to-snapshot
, or in Python:copy_tags_to_snapshot
) – Boolean.If set to
true
, tags are copied to any snapshot of the DB cluster that is created. -
CrossAccountClone (in the CLI:
--cross-account-clone
, or in Python:cross_account_clone
) – Boolean.If set to
true
, the DB cluster can be cloned across accounts. -
DatabaseName (in the CLI:
--database-name
, or in Python:database_name
) – UTF-8 string.Contains the name of the initial database of this DB cluster that was provided at create time, if one was specified when the DB cluster was created. This same name is returned for the life of the DB cluster.
-
DBClusterArn (in the CLI:
--db-cluster-arn
, or in Python:db_cluster_arn
) – UTF-8 string.The Amazon Resource Name (ARN) for the DB cluster.
-
DBClusterIdentifier (in the CLI:
--db-cluster-identifier
, or in Python:db_cluster_identifier
) – UTF-8 string.Contains a user-supplied DB cluster identifier. This identifier is the unique key that identifies a DB cluster.
-
DBClusterMembers (in the CLI:
--db-cluster-members
, or in Python:db_cluster_members
) – An array of DBClusterMember DBClusterMember objects.Provides the list of instances that make up the DB cluster.
-
DBClusterParameterGroup (in the CLI:
--db-cluster-parameter-group
, or in Python:db_cluster_parameter_group
) – UTF-8 string.Specifies the name of the DB cluster parameter group for the DB cluster.
-
DbClusterResourceId (in the CLI:
--db-cluster-resource-id
, or in Python:db_cluster_resource_id
) – UTF-8 string.The Amazon Region-unique, immutable identifier for the DB cluster. This identifier is found in Amazon CloudTrail log entries whenever the Amazon KMS key for the DB cluster is accessed.
-
DBSubnetGroup (in the CLI:
--db-subnet-group
, or in Python:db_subnet_group
) – UTF-8 string.Specifies information on the subnet group associated with the DB cluster, including the name, description, and subnets in the subnet group.
-
DeletionProtection (in the CLI:
--deletion-protection
, or in Python:deletion_protection
) – Boolean.Indicates whether or not the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled.
-
EarliestBacktrackTime (in the CLI:
--earliest-backtrack-time
, or in Python:earliest_backtrack_time
) – Timestamp.Not supported by Neptune.
-
EarliestRestorableTime (in the CLI:
--earliest-restorable-time
, or in Python:earliest_restorable_time
) – Timestamp.Specifies the earliest time to which a database can be restored with point-in-time restore.
-
EnabledCloudwatchLogsExports (in the CLI:
--enabled-cloudwatch-logs-exports
, or in Python:enabled_cloudwatch_logs_exports
) – An array of UTF-8 strings.A list of log types that this DB cluster is configured to export to CloudWatch Logs.
-
Endpoint (in the CLI:
--endpoint
, or in Python:endpoint
) – UTF-8 string.Specifies the connection endpoint for the primary instance of the DB cluster.
-
Engine (in the CLI:
--engine
, or in Python:engine
) – UTF-8 string.Provides the name of the database engine to be used for this DB cluster.
-
EngineVersion (in the CLI:
--engine-version
, or in Python:engine_version
) – UTF-8 string.Indicates the database engine version.
-
GlobalClusterIdentifier (in the CLI:
--global-cluster-identifier
, or in Python:global_cluster_identifier
) – UTF-8 string, not less than 1 or more than 255 bytes long, matching the regular expression: '[A-Za-z][0-9A-Za-z-:._]*'.Contains a user-supplied global database cluster identifier. This identifier is the unique key that identifies a global database.
-
HostedZoneId (in the CLI:
--hosted-zone-id
, or in Python:hosted_zone_id
) – UTF-8 string.Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.
-
IAMDatabaseAuthenticationEnabled (in the CLI:
--iam-database-authentication-enabled
, or in Python:iam_database_authentication_enabled
) – Boolean.True if mapping of Amazon Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.
-
KmsKeyId (in the CLI:
--kms-key-id
, or in Python:kms_key_id
) – UTF-8 string.If
StorageEncrypted
is true, the Amazon KMS key identifier for the encrypted DB cluster. -
LatestRestorableTime (in the CLI:
--latest-restorable-time
, or in Python:latest_restorable_time
) – Timestamp.Specifies the latest time to which a database can be restored with point-in-time restore.
-
MultiAZ (in the CLI:
--multi-az
, or in Python:multi_az
) – Boolean.Specifies whether the DB cluster has instances in multiple Availability Zones.
-
PendingModifiedValues (in the CLI:
--pending-modified-values
, or in Python:pending_modified_values
) – A ClusterPendingModifiedValues object.This data type is used as a response element in the
ModifyDBCluster
operation and contains changes that will be applied during the next maintenance window. -
PercentProgress (in the CLI:
--percent-progress
, or in Python:percent_progress
) – UTF-8 string.Specifies the progress of the operation as a percentage.
-
Port (in the CLI:
--port
, or in Python:port
) – Number (integer).Specifies the port that the database engine is listening on.
-
PreferredBackupWindow (in the CLI:
--preferred-backup-window
, or in Python:preferred_backup_window
) – UTF-8 string.Specifies the daily time range during which automated backups are created if automated backups are enabled, as determined by the
BackupRetentionPeriod
. -
PreferredMaintenanceWindow (in the CLI:
--preferred-maintenance-window
, or in Python:preferred_maintenance_window
) – UTF-8 string.Specifies the weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
-
ReaderEndpoint (in the CLI:
--reader-endpoint
, or in Python:reader_endpoint
) – UTF-8 string.The reader endpoint for the DB cluster. The reader endpoint for a DB cluster load-balances connections across the Read Replicas that are available in a DB cluster. As clients request new connections to the reader endpoint, Neptune distributes the connection requests among the Read Replicas in the DB cluster. This functionality can help balance your read workload across multiple Read Replicas in your DB cluster.
If a failover occurs, and the Read Replica that you are connected to is promoted to be the primary instance, your connection is dropped. To continue sending your read workload to other Read Replicas in the cluster, you can then reconnect to the reader endpoint.
-
ReadReplicaIdentifiers (in the CLI:
--read-replica-identifiers
, or in Python:read_replica_identifiers
) – An array of ReadReplicaIdentifier— UTF-8 strings.Contains one or more identifiers of the Read Replicas associated with this DB cluster.
-
ReplicationSourceIdentifier (in the CLI:
--replication-source-identifier
, or in Python:replication_source_identifier
) – UTF-8 string.Not supported by Neptune.
-
ReplicationType (in the CLI:
--replication-type
, or in Python:replication_type
) – UTF-8 string.Not supported by Neptune.
-
ServerlessV2ScalingConfiguration (in the CLI:
--serverless-v2-scaling-configuration
, or in Python:serverless_v2_scaling_configuration
) – A ServerlessV2ScalingConfigurationInfo object.Shows the scaling configuration for a Neptune Serverless DB cluster.
For more information, see Using Amazon Neptune Serverless in the Amazon Neptune User Guide.
-
Status (in the CLI:
--status
, or in Python:status
) – UTF-8 string.Specifies the current state of this DB cluster.
-
StorageEncrypted (in the CLI:
--storage-encrypted
, or in Python:storage_encrypted
) – Boolean.Specifies whether the DB cluster is encrypted.
-
VpcSecurityGroups (in the CLI:
--vpc-security-groups
, or in Python:vpc_security_groups
) – An array of VpcSecurityGroupMembership VpcSecurityGroupMembership objects.Provides a list of VPC security groups that the DB cluster belongs to.
Errors
RestoreDBClusterToPointInTime (action)
The Amazon CLI name for this API is: restore-db-cluster-to-point-in-time
, and the Python name is: restore_db_cluster_to_point_in_time
.
Restores a DB cluster to an arbitrary point in time. Users can restore to
any point in time before LatestRestorableTime
for up to BackupRetentionPeriod
days. The target DB cluster is created from the source DB cluster with the same
configuration as the original DB cluster, except that the new DB cluster is created
with the default DB security group.
Note
This action only restores the DB cluster, not the DB instances for that
DB cluster. You must invoke the CreateDBInstance (action) action
to create DB instances for the restored DB cluster, specifying the identifier
of the restored DB cluster in DBClusterIdentifier
. You can create
DB instances only after the RestoreDBClusterToPointInTime
action has completed and the DB cluster is available.
Request
-
DBClusterIdentifier (in the CLI:
--db-cluster-identifier
, or in Python:db_cluster_identifier
) – Required: UTF-8 string.The name of the new DB cluster to be created.
Constraints:
-
Must contain from 1 to 63 letters, numbers, or hyphens
-
First character must be a letter
-
Cannot end with a hyphen or contain two consecutive hyphens
-
-
DBClusterParameterGroupName (in the CLI:
--db-cluster-parameter-group-name
, or in Python:db_cluster_parameter_group_name
) – UTF-8 string.The name of the DB cluster parameter group to associate with the new DB cluster.
Constraints:
-
If supplied, must match the name of an existing DBClusterParameterGroup.
-
-
DBSubnetGroupName (in the CLI:
--db-subnet-group-name
, or in Python:db_subnet_group_name
) – UTF-8 string.The DB subnet group name to use for the new DB cluster.
Constraints: If supplied, must match the name of an existing DBSubnetGroup.
Example:
mySubnetgroup
-
DeletionProtection (in the CLI:
--deletion-protection
, or in Python:deletion_protection
) – Boolean.A value that indicates whether the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection is disabled.
-
EnableCloudwatchLogsExports (in the CLI:
--enable-cloudwatch-logs-exports
, or in Python:enable_cloudwatch_logs_exports
) – An array of UTF-8 strings.The list of logs that the restored DB cluster is to export to CloudWatch Logs.
-
EnableIAMDatabaseAuthentication (in the CLI:
--enable-iam-database-authentication
, or in Python:enable_iam_database_authentication
) – Boolean.True to enable mapping of Amazon Identity and Access Management (IAM) accounts to database accounts, and otherwise false.
Default:
false
-
KmsKeyId (in the CLI:
--kms-key-id
, or in Python:kms_key_id
) – UTF-8 string.The Amazon KMS key identifier to use when restoring an encrypted DB cluster from an encrypted DB cluster.
The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a DB cluster with the same Amazon account that owns the KMS encryption key used to encrypt the new DB cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.
You can restore to a new DB cluster and encrypt the new DB cluster with a KMS key that is different than the KMS key used to encrypt the source DB cluster. The new DB cluster is encrypted with the KMS key identified by the
KmsKeyId
parameter.If you do not specify a value for the
KmsKeyId
parameter, then the following will occur:-
If the DB cluster is encrypted, then the restored DB cluster is encrypted using the KMS key that was used to encrypt the source DB cluster.
-
If the DB cluster is not encrypted, then the restored DB cluster is not encrypted.
If
DBClusterIdentifier
refers to a DB cluster that is not encrypted, then the restore request is rejected. -
-
Port (in the CLI:
--port
, or in Python:port
) – Number (integer).The port number on which the new DB cluster accepts connections.
Constraints: Value must be
1150-65535
Default: The same port as the original DB cluster.
-
RestoreToTime (in the CLI:
--restore-to-time
, or in Python:restore_to_time
) – Timestamp.The date and time to restore the DB cluster to.
Valid Values: Value must be a time in Universal Coordinated Time (UTC) format
Constraints:
-
Must be before the latest restorable time for the DB instance
-
Must be specified if
UseLatestRestorableTime
parameter is not provided -
Cannot be specified if
UseLatestRestorableTime
parameter is true -
Cannot be specified if
RestoreType
parameter iscopy-on-write
Example:
2015-03-07T23:45:00Z
-
-
RestoreType (in the CLI:
--restore-type
, or in Python:restore_type
) – UTF-8 string.The type of restore to be performed. You can specify one of the following values:
-
full-copy
- The new DB cluster is restored as a full copy of the source DB cluster. -
copy-on-write
- The new DB cluster is restored as a clone of the source DB cluster.
If you don't specify a
RestoreType
value, then the new DB cluster is restored as a full copy of the source DB cluster. -
-
ServerlessV2ScalingConfiguration (in the CLI:
--serverless-v2-scaling-configuration
, or in Python:serverless_v2_scaling_configuration
) – A ServerlessV2ScalingConfiguration object.Contains the scaling configuration of a Neptune Serverless DB cluster.
For more information, see Using Amazon Neptune Serverless in the Amazon Neptune User Guide.
-
SourceDBClusterIdentifier (in the CLI:
--source-db-cluster-identifier
, or in Python:source_db_cluster_identifier
) – Required: UTF-8 string.The identifier of the source DB cluster from which to restore.
Constraints:
-
Must match the identifier of an existing DBCluster.
-
-
Tags (in the CLI:
--tags
, or in Python:tags
) – An array of Tag Tag objects.The tags to be applied to the restored DB cluster.
-
UseLatestRestorableTime (in the CLI:
--use-latest-restorable-time
, or in Python:use_latest_restorable_time
) – Boolean.A value that is set to
true
to restore the DB cluster to the latest restorable backup time, andfalse
otherwise.Default:
false
Constraints: Cannot be specified if
RestoreToTime
parameter is provided. -
VpcSecurityGroupIds (in the CLI:
--vpc-security-group-ids
, or in Python:vpc_security_group_ids
) – An array of VpcSecurityGroupId— UTF-8 strings.A list of VPC security groups that the new DB cluster belongs to.
Response
Contains the details of an Amazon Neptune DB cluster.
This data type is used as a response element in the DescribeDBClusters (action).
-
AllocatedStorage (in the CLI:
--allocated-storage
, or in Python:allocated_storage
) – Number (integer).AllocatedStorage
always returns 1, because Neptune DB cluster storage size is not fixed, but instead automatically adjusts as needed. -
AssociatedRoles (in the CLI:
--associated-roles
, or in Python:associated_roles
) – An array of DBClusterRole DBClusterRole objects.Provides a list of the Amazon Identity and Access Management (IAM) roles that are associated with the DB cluster. IAM roles that are associated with a DB cluster grant permission for the DB cluster to access other Amazon services on your behalf.
-
AutomaticRestartTime (in the CLI:
--automatic-restart-time
, or in Python:automatic_restart_time
) – Timestamp.Time at which the DB cluster will be automatically restarted.
-
AvailabilityZones (in the CLI:
--availability-zones
, or in Python:availability_zones
) – An array of AvailabilityZone— UTF-8 strings.Provides the list of EC2 Availability Zones that instances in the DB cluster can be created in.
-
BacktrackConsumedChangeRecords (in the CLI:
--backtrack-consumed-change-records
, or in Python:backtrack_consumed_change_records
) – Number (long).Not supported by Neptune.
-
BacktrackWindow (in the CLI:
--backtrack-window
, or in Python:backtrack_window
) – Number (long).Not supported by Neptune.
-
BackupRetentionPeriod (in the CLI:
--backup-retention-period
, or in Python:backup_retention_period
) – Number (integer).Specifies the number of days for which automatic DB snapshots are retained.
-
Capacity (in the CLI:
--capacity
, or in Python:capacity
) – Number (integer).Not supported by Neptune.
-
CloneGroupId (in the CLI:
--clone-group-id
, or in Python:clone_group_id
) – UTF-8 string.Identifies the clone group to which the DB cluster is associated.
-
ClusterCreateTime (in the CLI:
--cluster-create-time
, or in Python:cluster_create_time
) – Timestamp.Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).
-
CopyTagsToSnapshot (in the CLI:
--copy-tags-to-snapshot
, or in Python:copy_tags_to_snapshot
) – Boolean.If set to
true
, tags are copied to any snapshot of the DB cluster that is created. -
CrossAccountClone (in the CLI:
--cross-account-clone
, or in Python:cross_account_clone
) – Boolean.If set to
true
, the DB cluster can be cloned across accounts. -
DatabaseName (in the CLI:
--database-name
, or in Python:database_name
) – UTF-8 string.Contains the name of the initial database of this DB cluster that was provided at create time, if one was specified when the DB cluster was created. This same name is returned for the life of the DB cluster.
-
DBClusterArn (in the CLI:
--db-cluster-arn
, or in Python:db_cluster_arn
) – UTF-8 string.The Amazon Resource Name (ARN) for the DB cluster.
-
DBClusterIdentifier (in the CLI:
--db-cluster-identifier
, or in Python:db_cluster_identifier
) – UTF-8 string.Contains a user-supplied DB cluster identifier. This identifier is the unique key that identifies a DB cluster.
-
DBClusterMembers (in the CLI:
--db-cluster-members
, or in Python:db_cluster_members
) – An array of DBClusterMember DBClusterMember objects.Provides the list of instances that make up the DB cluster.
-
DBClusterParameterGroup (in the CLI:
--db-cluster-parameter-group
, or in Python:db_cluster_parameter_group
) – UTF-8 string.Specifies the name of the DB cluster parameter group for the DB cluster.
-
DbClusterResourceId (in the CLI:
--db-cluster-resource-id
, or in Python:db_cluster_resource_id
) – UTF-8 string.The Amazon Region-unique, immutable identifier for the DB cluster. This identifier is found in Amazon CloudTrail log entries whenever the Amazon KMS key for the DB cluster is accessed.
-
DBSubnetGroup (in the CLI:
--db-subnet-group
, or in Python:db_subnet_group
) – UTF-8 string.Specifies information on the subnet group associated with the DB cluster, including the name, description, and subnets in the subnet group.
-
DeletionProtection (in the CLI:
--deletion-protection
, or in Python:deletion_protection
) – Boolean.Indicates whether or not the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled.
-
EarliestBacktrackTime (in the CLI:
--earliest-backtrack-time
, or in Python:earliest_backtrack_time
) – Timestamp.Not supported by Neptune.
-
EarliestRestorableTime (in the CLI:
--earliest-restorable-time
, or in Python:earliest_restorable_time
) – Timestamp.Specifies the earliest time to which a database can be restored with point-in-time restore.
-
EnabledCloudwatchLogsExports (in the CLI:
--enabled-cloudwatch-logs-exports
, or in Python:enabled_cloudwatch_logs_exports
) – An array of UTF-8 strings.A list of log types that this DB cluster is configured to export to CloudWatch Logs.
-
Endpoint (in the CLI:
--endpoint
, or in Python:endpoint
) – UTF-8 string.Specifies the connection endpoint for the primary instance of the DB cluster.
-
Engine (in the CLI:
--engine
, or in Python:engine
) – UTF-8 string.Provides the name of the database engine to be used for this DB cluster.
-
EngineVersion (in the CLI:
--engine-version
, or in Python:engine_version
) – UTF-8 string.Indicates the database engine version.
-
GlobalClusterIdentifier (in the CLI:
--global-cluster-identifier
, or in Python:global_cluster_identifier
) – UTF-8 string, not less than 1 or more than 255 bytes long, matching the regular expression: '[A-Za-z][0-9A-Za-z-:._]*'.Contains a user-supplied global database cluster identifier. This identifier is the unique key that identifies a global database.
-
HostedZoneId (in the CLI:
--hosted-zone-id
, or in Python:hosted_zone_id
) – UTF-8 string.Specifies the ID that Amazon Route 53 assigns when you create a hosted zone.
-
IAMDatabaseAuthenticationEnabled (in the CLI:
--iam-database-authentication-enabled
, or in Python:iam_database_authentication_enabled
) – Boolean.True if mapping of Amazon Identity and Access Management (IAM) accounts to database accounts is enabled, and otherwise false.
-
KmsKeyId (in the CLI:
--kms-key-id
, or in Python:kms_key_id
) – UTF-8 string.If
StorageEncrypted
is true, the Amazon KMS key identifier for the encrypted DB cluster. -
LatestRestorableTime (in the CLI:
--latest-restorable-time
, or in Python:latest_restorable_time
) – Timestamp.Specifies the latest time to which a database can be restored with point-in-time restore.
-
MultiAZ (in the CLI:
--multi-az
, or in Python:multi_az
) – Boolean.Specifies whether the DB cluster has instances in multiple Availability Zones.
-
PendingModifiedValues (in the CLI:
--pending-modified-values
, or in Python:pending_modified_values
) – A ClusterPendingModifiedValues object.This data type is used as a response element in the
ModifyDBCluster
operation and contains changes that will be applied during the next maintenance window. -
PercentProgress (in the CLI:
--percent-progress
, or in Python:percent_progress
) – UTF-8 string.Specifies the progress of the operation as a percentage.
-
Port (in the CLI:
--port
, or in Python:port
) – Number (integer).Specifies the port that the database engine is listening on.
-
PreferredBackupWindow (in the CLI:
--preferred-backup-window
, or in Python:preferred_backup_window
) – UTF-8 string.Specifies the daily time range during which automated backups are created if automated backups are enabled, as determined by the
BackupRetentionPeriod
. -
PreferredMaintenanceWindow (in the CLI:
--preferred-maintenance-window
, or in Python:preferred_maintenance_window
) – UTF-8 string.Specifies the weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
-
ReaderEndpoint (in the CLI:
--reader-endpoint
, or in Python:reader_endpoint
) – UTF-8 string.The reader endpoint for the DB cluster. The reader endpoint for a DB cluster load-balances connections across the Read Replicas that are available in a DB cluster. As clients request new connections to the reader endpoint, Neptune distributes the connection requests among the Read Replicas in the DB cluster. This functionality can help balance your read workload across multiple Read Replicas in your DB cluster.
If a failover occurs, and the Read Replica that you are connected to is promoted to be the primary instance, your connection is dropped. To continue sending your read workload to other Read Replicas in the cluster, you can then reconnect to the reader endpoint.
-
ReadReplicaIdentifiers (in the CLI:
--read-replica-identifiers
, or in Python:read_replica_identifiers
) – An array of ReadReplicaIdentifier— UTF-8 strings.Contains one or more identifiers of the Read Replicas associated with this DB cluster.
-
ReplicationSourceIdentifier (in the CLI:
--replication-source-identifier
, or in Python:replication_source_identifier
) – UTF-8 string.Not supported by Neptune.
-
ReplicationType (in the CLI:
--replication-type
, or in Python:replication_type
) – UTF-8 string.Not supported by Neptune.
-
ServerlessV2ScalingConfiguration (in the CLI:
--serverless-v2-scaling-configuration
, or in Python:serverless_v2_scaling_configuration
) – A ServerlessV2ScalingConfigurationInfo object.Shows the scaling configuration for a Neptune Serverless DB cluster.
For more information, see Using Amazon Neptune Serverless in the Amazon Neptune User Guide.
-
Status (in the CLI:
--status
, or in Python:status
) – UTF-8 string.Specifies the current state of this DB cluster.
-
StorageEncrypted (in the CLI:
--storage-encrypted
, or in Python:storage_encrypted
) – Boolean.Specifies whether the DB cluster is encrypted.
-
VpcSecurityGroups (in the CLI:
--vpc-security-groups
, or in Python:vpc_security_groups
) – An array of VpcSecurityGroupMembership VpcSecurityGroupMembership objects.Provides a list of VPC security groups that the DB cluster belongs to.
Errors
DescribeDBClusterSnapshots (action)
The Amazon CLI name for this API is: describe-db-cluster-snapshots
, and the Python name is: describe_db_cluster_snapshots
.
Returns information about DB cluster snapshots. This API action supports pagination.
Request
-
DBClusterIdentifier (in the CLI:
--db-cluster-identifier
, or in Python:db_cluster_identifier
) – UTF-8 string.The ID of the DB cluster to retrieve the list of DB cluster snapshots for. This parameter can't be used in conjunction with the
DBClusterSnapshotIdentifier
parameter. This parameter is not case-sensitive.Constraints:
-
If supplied, must match the identifier of an existing DBCluster.
-
-
DBClusterSnapshotIdentifier (in the CLI:
--db-cluster-snapshot-identifier
, or in Python:db_cluster_snapshot_identifier
) – UTF-8 string.A specific DB cluster snapshot identifier to describe. This parameter can't be used in conjunction with the
DBClusterIdentifier
parameter. This value is stored as a lowercase string.Constraints:
-
If supplied, must match the identifier of an existing DBClusterSnapshot.
-
If this identifier is for an automated snapshot, the
SnapshotType
parameter must also be specified.
-
-
Filters (in the CLI:
--filters
, or in Python:filters
) – An array of Filter Filter objects.This parameter is not currently supported.
-
IncludePublic (in the CLI:
--include-public
, or in Python:include_public
) – Boolean.True to include manual DB cluster snapshots that are public and can be copied or restored by any Amazon account, and otherwise false. The default is
false
. The default is false.You can share a manual DB cluster snapshot as public by using the ModifyDBClusterSnapshotAttribute (action) API action.
-
IncludeShared (in the CLI:
--include-shared
, or in Python:include_shared
) – Boolean.True to include shared manual DB cluster snapshots from other Amazon accounts that this Amazon account has been given permission to copy or restore, and otherwise false. The default is
false
.You can give an Amazon account permission to restore a manual DB cluster snapshot from another Amazon account by the ModifyDBClusterSnapshotAttribute (action) API action.
-
Marker (in the CLI:
--marker
, or in Python:marker
) – UTF-8 string.An optional pagination token provided by a previous
DescribeDBClusterSnapshots
request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified byMaxRecords
. -
MaxRecords (in the CLI:
--max-records
, or in Python:max_records
) – Number (integer).The maximum number of records to include in the response. If more records exist than the specified
MaxRecords
value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.Default: 100
Constraints: Minimum 20, maximum 100.
-
SnapshotType (in the CLI:
--snapshot-type
, or in Python:snapshot_type
) – UTF-8 string.The type of DB cluster snapshots to be returned. You can specify one of the following values:
-
automated
- Return all DB cluster snapshots that have been automatically taken by Amazon Neptune for my Amazon account. -
manual
- Return all DB cluster snapshots that have been taken by my Amazon account. -
shared
- Return all manual DB cluster snapshots that have been shared to my Amazon account. -
public
- Return all DB cluster snapshots that have been marked as public.
If you don't specify a
SnapshotType
value, then both automated and manual DB cluster snapshots are returned. You can include shared DB cluster snapshots with these results by setting theIncludeShared
parameter totrue
. You can include public DB cluster snapshots with these results by setting theIncludePublic
parameter totrue
.The
IncludeShared
andIncludePublic
parameters don't apply forSnapshotType
values ofmanual
orautomated
. TheIncludePublic
parameter doesn't apply whenSnapshotType
is set toshared
. TheIncludeShared
parameter doesn't apply whenSnapshotType
is set topublic
. -
Response
-
DBClusterSnapshots (in the CLI:
--db-cluster-snapshots
, or in Python:db_cluster_snapshots
) – An array of DBClusterSnapshot DBClusterSnapshot objects.Provides a list of DB cluster snapshots for the user.
-
Marker (in the CLI:
--marker
, or in Python:marker
) – UTF-8 string.An optional pagination token provided by a previous DescribeDBClusterSnapshots (action) request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by
MaxRecords
.
DescribeDBClusterSnapshotAttributes (action)
The Amazon CLI name for this API is: describe-db-cluster-snapshot-attributes
, and the Python name is: describe_db_cluster_snapshot_attributes
.
Returns a list of DB cluster snapshot attribute names and values for a manual DB cluster snapshot.
When sharing snapshots with other Amazon accounts, DescribeDBClusterSnapshotAttributes
returns the restore
attribute and a list of IDs for the Amazon accounts
that are authorized to copy or restore the manual DB cluster snapshot. If all
is included in the list of values for the restore
attribute, then
the manual DB cluster snapshot is public and can be copied or restored by all Amazon
accounts.
To add or remove access for an Amazon account to copy or restore a manual DB cluster snapshot, or to make the manual DB cluster snapshot public or private, use the ModifyDBClusterSnapshotAttribute (action) API action.
Request
Response
Contains the results of a successful call to the DescribeDBClusterSnapshotAttributes (action) API action.
Manual DB cluster snapshot attributes are used to authorize other Amazon accounts to copy or restore a manual DB cluster snapshot. For more information, see the ModifyDBClusterSnapshotAttribute (action) API action.
-
DBClusterSnapshotAttributes (in the CLI:
--db-cluster-snapshot-attributes
, or in Python:db_cluster_snapshot_attributes
) – An array of DBClusterSnapshotAttribute DBClusterSnapshotAttribute objects.The list of attributes and values for the manual DB cluster snapshot.
-
DBClusterSnapshotIdentifier (in the CLI:
--db-cluster-snapshot-identifier
, or in Python:db_cluster_snapshot_identifier
) – UTF-8 string.The identifier of the manual DB cluster snapshot that the attributes apply to.