Class BackupSelection
- java.lang.Object
-
- software.amazon.awssdk.services.backup.model.BackupSelection
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<BackupSelection.Builder,BackupSelection>
@Generated("software.amazon.awssdk:codegen") public final class BackupSelection extends Object implements SdkPojo, Serializable, ToCopyableBuilder<BackupSelection.Builder,BackupSelection>
Used to specify a set of resources to a backup plan.
Specifying your desired
Conditions,ListOfTags,NotResources, and/orResourcesis recommended. If none of these are specified, Backup will attempt to select all supported and opted-in storage resources, which could have unintended cost implications.- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceBackupSelection.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static BackupSelection.Builderbuilder()Conditionsconditions()A list of conditions that you define to assign resources to your backup plans using tags.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()booleanhasListOfTags()For responses, this returns true if the service returned a value for the ListOfTags property.booleanhasNotResources()For responses, this returns true if the service returned a value for the NotResources property.booleanhasResources()For responses, this returns true if the service returned a value for the Resources property.StringiamRoleArn()The ARN of the IAM role that Backup uses to authenticate when backing up the target resource; for example,arn:aws:iam::123456789012:role/S3Access.List<Condition>listOfTags()A list of conditions that you define to assign resources to your backup plans using tags.List<String>notResources()A list of Amazon Resource Names (ARNs) to exclude from a backup plan.List<String>resources()A list of Amazon Resource Names (ARNs) to assign to a backup plan.List<SdkField<?>>sdkFields()StringselectionName()The display name of a resource selection document.static Class<? extends BackupSelection.Builder>serializableBuilderClass()BackupSelection.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
selectionName
public final String selectionName()
The display name of a resource selection document. Must contain 1 to 50 alphanumeric or '-_.' characters.
- Returns:
- The display name of a resource selection document. Must contain 1 to 50 alphanumeric or '-_.' characters.
-
iamRoleArn
public final String iamRoleArn()
The ARN of the IAM role that Backup uses to authenticate when backing up the target resource; for example,
arn:aws:iam::123456789012:role/S3Access.- Returns:
- The ARN of the IAM role that Backup uses to authenticate when backing up the target resource; for
example,
arn:aws:iam::123456789012:role/S3Access.
-
hasResources
public final boolean hasResources()
For responses, this returns true if the service returned a value for the Resources property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
resources
public final List<String> resources()
A list of Amazon Resource Names (ARNs) to assign to a backup plan. The maximum number of ARNs is 500 without wildcards, or 30 ARNs with wildcards.
If you need to assign many resources to a backup plan, consider a different resource selection strategy, such as assigning all resources of a resource type or refining your resource selection using tags.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasResources()method.- Returns:
- A list of Amazon Resource Names (ARNs) to assign to a backup plan. The maximum number of ARNs is 500
without wildcards, or 30 ARNs with wildcards.
If you need to assign many resources to a backup plan, consider a different resource selection strategy, such as assigning all resources of a resource type or refining your resource selection using tags.
-
hasListOfTags
public final boolean hasListOfTags()
For responses, this returns true if the service returned a value for the ListOfTags property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
listOfTags
public final List<Condition> listOfTags()
A list of conditions that you define to assign resources to your backup plans using tags. For example,
"StringEquals": { "Key": "aws:ResourceTag/CreatedByCryo", "Value": "true" },. Condition operators are case sensitive.ListOfTagsdiffers fromConditionsas follows:-
When you specify more than one condition, you assign all resources that match AT LEAST ONE condition (using OR logic).
-
ListOfTagsonly supportsStringEquals.ConditionssupportsStringEquals,StringLike,StringNotEquals, andStringNotLike.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasListOfTags()method.- Returns:
- A list of conditions that you define to assign resources to your backup plans using tags. For example,
"StringEquals": { "Key": "aws:ResourceTag/CreatedByCryo", "Value": "true" },. Condition operators are case sensitive.ListOfTagsdiffers fromConditionsas follows:-
When you specify more than one condition, you assign all resources that match AT LEAST ONE condition (using OR logic).
-
ListOfTagsonly supportsStringEquals.ConditionssupportsStringEquals,StringLike,StringNotEquals, andStringNotLike.
-
-
-
hasNotResources
public final boolean hasNotResources()
For responses, this returns true if the service returned a value for the NotResources property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
notResources
public final List<String> notResources()
A list of Amazon Resource Names (ARNs) to exclude from a backup plan. The maximum number of ARNs is 500 without wildcards, or 30 ARNs with wildcards.
If you need to exclude many resources from a backup plan, consider a different resource selection strategy, such as assigning only one or a few resource types or refining your resource selection using tags.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasNotResources()method.- Returns:
- A list of Amazon Resource Names (ARNs) to exclude from a backup plan. The maximum number of ARNs is 500
without wildcards, or 30 ARNs with wildcards.
If you need to exclude many resources from a backup plan, consider a different resource selection strategy, such as assigning only one or a few resource types or refining your resource selection using tags.
-
conditions
public final Conditions conditions()
A list of conditions that you define to assign resources to your backup plans using tags. For example,
"StringEquals": { "Key": "aws:ResourceTag/CreatedByCryo", "Value": "true" },. Condition operators are case sensitive.Conditionsdiffers fromListOfTagsas follows:-
When you specify more than one condition, you only assign the resources that match ALL conditions (using AND logic).
-
ConditionssupportsStringEquals,StringLike,StringNotEquals, andStringNotLike.ListOfTagsonly supportsStringEquals.
- Returns:
- A list of conditions that you define to assign resources to your backup plans using tags. For example,
"StringEquals": { "Key": "aws:ResourceTag/CreatedByCryo", "Value": "true" },. Condition operators are case sensitive.Conditionsdiffers fromListOfTagsas follows:-
When you specify more than one condition, you only assign the resources that match ALL conditions (using AND logic).
-
ConditionssupportsStringEquals,StringLike,StringNotEquals, andStringNotLike.ListOfTagsonly supportsStringEquals.
-
-
-
toBuilder
public BackupSelection.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<BackupSelection.Builder,BackupSelection>
-
builder
public static BackupSelection.Builder builder()
-
serializableBuilderClass
public static Class<? extends BackupSelection.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
-