本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# BackupSelection
<a name="API_BackupSelection"></a>

用於將一組資源指派給備份計劃。

我們建議您指定要包含或排除的條件、標籤或資源。否則， Backup 會嘗試選取所有支援和選擇加入的儲存資源，這可能會對成本產生意外影響。

如需詳細資訊，請參閱[以程式設計方式指派資源](https://docs.aws.amazon.com/aws-backup/latest/devguide/assigning-resources.html#assigning-resources-json)。

## 目錄
<a name="API_BackupSelection_Contents"></a>

 ** IamRoleArn **   <a name="Backup-Type-BackupSelection-IamRoleArn"></a>
備份目標資源時， AWS Backup 用來進行身分驗證的 IAM 角色 ARN；例如 `arn:aws:iam::123456789012:role/S3Access`。  
類型：字串  
必要：是

 ** SelectionName **   <a name="Backup-Type-BackupSelection-SelectionName"></a>
所選資源文件的顯示名稱。必須包含 1 到 50 個英數字元或 '-\$1'。字元。  
類型：字串  
模式：`^[a-zA-Z0-9\-\_\.]{1,50}$`  
必要：是

 ** Conditions **   <a name="Backup-Type-BackupSelection-Conditions"></a>
您定義使用標籤將資源指派給備份計劃的條件。例如 `"StringEquals": { "ConditionKey": "aws:ResourceTag/backup", "ConditionValue": "daily" }`。  
 `Conditions` 支援 `StringEquals`、`StringNotEquals`、 `StringLike`和 `StringNotLike`。條件運算子名稱區分大小寫。  
如果您指定多個條件，資源會非常符合所有條件 (AND 邏輯）。  
類型：[Conditions](API_Conditions.md) 物件  
必要：否

 ** ListOfTags **   <a name="Backup-Type-BackupSelection-ListOfTags"></a>
建議您使用 `Conditions` 參數，而非此參數。  
您定義使用標籤將資源指派給備份計劃的條件。例如 `"StringEquals": { "ConditionKey": "backup", "ConditionValue": "daily"}`。  
 `ListOfTags` 僅支援 `StringEquals`。條件運算子名稱區分大小寫。  
如果您指定多個條件，資源會大致符合任何條件 (OR 邏輯）。  
類型：[Condition](API_Condition.md) 物件陣列  
必要：否

 ** NotResources **   <a name="Backup-Type-BackupSelection-NotResources"></a>
要從備份計劃中排除的資源的 Amazon Resource Name (ARNs)。ARN 的數目上限為 500 個 (不含萬用字元)，或 30 個含萬用字元的 ARN。  
若您需要從備份計劃中排除眾多資源，請考慮使用不同的資源選擇策略，例如僅指派一或數個資源類型，或使用標籤精簡您的資源選擇。  
類型：字串陣列  
必要：否

 ** Resources **   <a name="Backup-Type-BackupSelection-Resources"></a>
要指派給備份計劃之資源的 Amazon Resource Name (ARNs)。ARN 的數目上限為 500 個 (不含萬用字元)，或 30 個含萬用字元的 ARN。  
若您需要將眾多資源指派至備份計劃，請考慮使用不同的資源選擇策略，例如僅指派一個資源類型的所有資源，或使用標籤精簡您的資源選擇。  
如果您指定多個 ARNs，資源會非常符合任何 ARNs(OR 邏輯）。  
在 ARN 模式中使用萬用字元進行備份選擇時，星號 (\$1) 必須出現在 ARN 字串的結尾 （字首模式）。例如， `arn:aws:s3:::my-bucket-*` 有效，但`arn:aws:s3:::*-logs`不支援。
類型：字串陣列  
必要：否

## 另請參閱
<a name="API_BackupSelection_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/BackupSelection) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/BackupSelection) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/BackupSelection)