@Generated(value="software.amazon.awssdk:codegen") public final class DescribeDbSnapshotsRequest extends RdsRequest implements ToCopyableBuilder<DescribeDbSnapshotsRequest.Builder,DescribeDbSnapshotsRequest>
Modifier and Type | Class and Description |
---|---|
static interface |
DescribeDbSnapshotsRequest.Builder |
Modifier and Type | Method and Description |
---|---|
static DescribeDbSnapshotsRequest.Builder |
builder() |
String |
dbInstanceIdentifier()
The ID of the DB instance to retrieve the list of DB snapshots for.
|
String |
dbiResourceId()
A specific DB resource ID to describe.
|
String |
dbSnapshotIdentifier()
A specific DB snapshot identifier to describe.
|
boolean |
equals(Object obj) |
boolean |
equalsBySdkFields(Object obj) |
List<Filter> |
filters()
A filter that specifies one or more DB snapshots to describe.
|
<T> Optional<T> |
getValueForField(String fieldName,
Class<T> clazz) |
boolean |
hasFilters()
Returns true if the Filters property was specified by the sender (it may be empty), or false if the sender did
not specify the value (it will be empty).
|
int |
hashCode() |
Boolean |
includePublic()
A value that indicates whether to include manual DB cluster snapshots that are public and can be copied or
restored by any AWS account.
|
Boolean |
includeShared()
A value that indicates whether to include shared manual DB cluster snapshots from other AWS accounts that this
AWS account has been given permission to copy or restore.
|
String |
marker()
An optional pagination token provided by a previous
DescribeDBSnapshots request. |
Integer |
maxRecords()
The maximum number of records to include in the response.
|
List<SdkField<?>> |
sdkFields() |
static Class<? extends DescribeDbSnapshotsRequest.Builder> |
serializableBuilderClass() |
String |
snapshotType()
The type of snapshots to be returned.
|
DescribeDbSnapshotsRequest.Builder |
toBuilder() |
String |
toString()
Returns a string representation of this object.
|
overrideConfiguration
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
copy
public String dbInstanceIdentifier()
The ID of the DB instance to retrieve the list of DB snapshots for. This parameter can't be used in conjunction
with DBSnapshotIdentifier
. This parameter isn't case-sensitive.
Constraints:
If supplied, must match the identifier of an existing DBInstance.
DBSnapshotIdentifier
. This parameter isn't case-sensitive.
Constraints:
If supplied, must match the identifier of an existing DBInstance.
public String dbSnapshotIdentifier()
A specific DB snapshot identifier to describe. This parameter can't be used in conjunction with
DBInstanceIdentifier
. This value is stored as a lowercase string.
Constraints:
If supplied, must match the identifier of an existing DBSnapshot.
If this identifier is for an automated snapshot, the SnapshotType
parameter must also be specified.
DBInstanceIdentifier
. This value is stored as a lowercase string.
Constraints:
If supplied, must match the identifier of an existing DBSnapshot.
If this identifier is for an automated snapshot, the SnapshotType
parameter must also be
specified.
public String snapshotType()
The type of snapshots to be returned. You can specify one of the following values:
automated
- Return all DB snapshots that have been automatically taken by Amazon RDS for my AWS
account.
manual
- Return all DB snapshots that have been taken by my AWS account.
shared
- Return all manual DB snapshots that have been shared to my AWS account.
public
- Return all DB snapshots that have been marked as public.
awsbackup
- Return the DB snapshots managed by the AWS Backup service.
For information about AWS Backup, see the AWS Backup Developer Guide.
The awsbackup
type does not apply to Aurora.
If you don't specify a SnapshotType
value, then both automated and manual snapshots are returned.
Shared and public DB snapshots are not included in the returned results by default. You can include shared
snapshots with these results by enabling the IncludeShared
parameter. You can include public
snapshots with these results by enabling the IncludePublic
parameter.
The IncludeShared
and IncludePublic
parameters don't apply for
SnapshotType
values of manual
or automated
. The IncludePublic
parameter doesn't apply when SnapshotType
is set to shared
. The
IncludeShared
parameter doesn't apply when SnapshotType
is set to public
.
automated
- Return all DB snapshots that have been automatically taken by Amazon RDS for my
AWS account.
manual
- Return all DB snapshots that have been taken by my AWS account.
shared
- Return all manual DB snapshots that have been shared to my AWS account.
public
- Return all DB snapshots that have been marked as public.
awsbackup
- Return the DB snapshots managed by the AWS Backup service.
For information about AWS Backup, see the AWS Backup Developer Guide.
The awsbackup
type does not apply to Aurora.
If you don't specify a SnapshotType
value, then both automated and manual snapshots are
returned. Shared and public DB snapshots are not included in the returned results by default. You can
include shared snapshots with these results by enabling the IncludeShared
parameter. You can
include public snapshots with these results by enabling the IncludePublic
parameter.
The IncludeShared
and IncludePublic
parameters don't apply for
SnapshotType
values of manual
or automated
. The
IncludePublic
parameter doesn't apply when SnapshotType
is set to
shared
. The IncludeShared
parameter doesn't apply when
SnapshotType
is set to public
.
public boolean hasFilters()
public List<Filter> filters()
A filter that specifies one or more DB snapshots to describe.
Supported filters:
db-instance-id
- Accepts DB instance identifiers and DB instance Amazon Resource Names (ARNs).
db-snapshot-id
- Accepts DB snapshot identifiers.
dbi-resource-id
- Accepts identifiers of source DB instances.
snapshot-type
- Accepts types of DB snapshots.
engine
- Accepts names of database engines.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
You can use hasFilters()
to see if a value was sent in this field.
Supported filters:
db-instance-id
- Accepts DB instance identifiers and DB instance Amazon Resource Names
(ARNs).
db-snapshot-id
- Accepts DB snapshot identifiers.
dbi-resource-id
- Accepts identifiers of source DB instances.
snapshot-type
- Accepts types of DB snapshots.
engine
- Accepts names of database engines.
public Integer maxRecords()
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 you can
retrieve the remaining results.
Default: 100
Constraints: Minimum 20, maximum 100.
MaxRecords
value, a pagination token called a marker is included in the response so that you
can retrieve the remaining results.
Default: 100
Constraints: Minimum 20, maximum 100.
public String marker()
An optional pagination token provided by a previous DescribeDBSnapshots
request. If this parameter
is specified, the response includes only records beyond the marker, up to the value specified by
MaxRecords
.
DescribeDBSnapshots
request. If this
parameter is specified, the response includes only records beyond the marker, up to the value specified
by MaxRecords
.public Boolean includeShared()
A value that indicates whether to include shared manual DB cluster snapshots from other AWS accounts that this AWS account has been given permission to copy or restore. By default, these snapshots are not included.
You can give an AWS account permission to restore a manual DB snapshot from another AWS account by using the
ModifyDBSnapshotAttribute
API action.
You can give an AWS account permission to restore a manual DB snapshot from another AWS account by using
the ModifyDBSnapshotAttribute
API action.
public Boolean includePublic()
A value that indicates whether to include manual DB cluster snapshots that are public and can be copied or restored by any AWS account. By default, the public snapshots are not included.
You can share a manual DB snapshot as public by using the ModifyDBSnapshotAttribute API.
You can share a manual DB snapshot as public by using the ModifyDBSnapshotAttribute API.
public String dbiResourceId()
A specific DB resource ID to describe.
public DescribeDbSnapshotsRequest.Builder toBuilder()
toBuilder
in interface ToCopyableBuilder<DescribeDbSnapshotsRequest.Builder,DescribeDbSnapshotsRequest>
toBuilder
in class RdsRequest
public static DescribeDbSnapshotsRequest.Builder builder()
public static Class<? extends DescribeDbSnapshotsRequest.Builder> serializableBuilderClass()
public int hashCode()
hashCode
in class AwsRequest
public boolean equals(Object obj)
equals
in class AwsRequest
public boolean equalsBySdkFields(Object obj)
equalsBySdkFields
in interface SdkPojo
public String toString()
public <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
getValueForField
in class SdkRequest
Copyright © 2020. All rights reserved.