本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# AWS Backup 使用 的範例 AWS CLI
下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 來執行動作和實作常見案例 AWS Backup。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。
**Topics**
+ [動作](#actions)
## 動作
### `create-backup-plan`
以下程式碼範例顯示如何使用 `create-backup-plan`。
**AWS CLI**
**建立備份計畫**
下列 `create-backup-plan` 範例會建立保留 35 天的指定備份計畫。
```
aws backup create-backup-plan \
--backup-plan "{\"BackupPlanName\":\"Example-Backup-Plan\",\"Rules\":[{\"RuleName\":\"DailyBackups\",\"ScheduleExpression\":\"cron(0 5 ? * * *)\",\"StartWindowMinutes\":480,\"TargetBackupVaultName\":\"Default\",\"Lifecycle\":{\"DeleteAfterDays\":35}}]}"
```
輸出：
```
{
"BackupPlanId": "1fa3895c-a7f5-484a-a371-2dd6a1a9f729",
"BackupPlanArn": "arn:aws:backup:us-west-2:123456789012:backup-plan:1fa3895c-a7f5-484a-a371-2dd6a1a9f729",
"CreationDate": 1568928754.747,
"VersionId": "ZjQ2ZTI5YWQtZDg5Yi00MzYzLWJmZTAtMDI1MzhlMDhjYjEz"
}
```
如需詳細資訊，請參閱《AWS Backup 開發人員指南》**中的[備份計畫](https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-backup-plan.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateBackupPlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/create-backup-plan.html)。
### `create-backup-vault`
以下程式碼範例顯示如何使用 `create-backup-vault`。
**AWS CLI**
**建立備份保存庫**
下列 `create-backup-vault` 範例會建立具指定名稱的備份保存庫。
```
aws backup create-backup-vault
--backup-vault-name sample-vault
```
此命令不會產生輸出。輸出：
```
{
"BackupVaultName": "sample-vault",
"BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:sample-vault",
"CreationDate": 1568928338.385
}
```
如需詳細資訊，請參閱《AWS Backup 開發人員指南》**中的[建立備份保存庫](https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-vault.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateBackupVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/create-backup-vault.html)。
### `get-backup-plan-from-template`
以下程式碼範例顯示如何使用 `get-backup-plan-from-template`。
**AWS CLI**
**從範本取得現有的備份計畫**
下列 `get-backup-plan-from-template` 範例從範本取得現有的備份計畫，該範本會指定保留 35 天的每日備份。
```
aws backup get-backup-plan-from-template \
--backup-plan-template-id "87c0c1ef-254d-4180-8fef-2e76a2c38aaa"
```
輸出：
```
{
"BackupPlanDocument": {
"Rules": [
{
"RuleName": "DailyBackups",
"ScheduleExpression": "cron(0 5 ? * * *)",
"StartWindowMinutes": 480,
"Lifecycle": {
"DeleteAfterDays": 35
}
}
]
}
}
```
如需詳細資訊，請參閱《AWS Backup 開發人員指南》**中的[備份計畫](https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-backup-plan.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetBackupPlanFromTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/get-backup-plan-from-template.html)。
### `get-backup-plan`
以下程式碼範例顯示如何使用 `get-backup-plan`。
**AWS CLI**
**取得備份計畫的詳細資訊**
以下 `get-backup-plan` 範例顯示指定之備份計畫的詳細資訊。
```
aws backup get-backup-plan \
--backup-plan-id "fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5"
```
輸出：
```
{
"BackupPlan": {
"BackupPlanName": "Example-Backup-Plan",
"Rules": [
{
"RuleName": "DailyBackups",
"TargetBackupVaultName": "Default",
"ScheduleExpression": "cron(0 5 ? * * *)",
"StartWindowMinutes": 480,
"CompletionWindowMinutes": 10080,
"Lifecycle": {
"DeleteAfterDays": 35
},
"RuleId": "70e0ccdc-e9df-4e83-82ad-c1e5a9471cc3"
}
]
},
"BackupPlanId": "fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5",
"BackupPlanArn": "arn:aws:backup:us-west-2:123456789012:backup-plan:fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5",
"VersionId": "NjQ2ZTZkODktMGVhNy00MmQ0LWE4YjktZTkwNTQ3OTkyYTcw",
"CreationDate": 1568926091.57
}
```
如需詳細資訊，請參閱《AWS Backup 開發人員指南》**中的[備份計畫](https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-backup-plan.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetBackupPlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/get-backup-plan.html)。
### `list-backup-jobs`
以下程式碼範例顯示如何使用 `list-backup-jobs`。
**AWS CLI**
**範例 1：列出所有備份任務**
下列`list-backup-jobs`範例會傳回您 AWS 帳戶中備份任務的相關中繼資料。
```
aws backup list-backup-jobs
```
輸出：
```
{
"BackupJobs": [
{
"BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"BackupVaultName": "Default",
"BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default",
"ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-12345678901234567",
"CreationDate": 1600721892.929,
"State": "CREATED",
"PercentDone": "0.0",
"IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole",
"StartBy": 1600725492.929,
"ResourceType": "EC2"
},
{
"BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"BackupVaultName": "Default",
"BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default",
"RecoveryPointArn": "arn:aws:backup:us-west-2:123456789012:recovery-point:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
"ResourceArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-12345678",
"CreationDate": 1600721724.77,
"CompletionDate": 1600721744.488,
"State": "COMPLETED",
"PercentDone": "100.0",
"BackupSizeInBytes": 71,
"IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole",
"StartBy": 1600725324.77,
"ResourceType": "EFS"
}
]
}
```
如需詳細資訊，請參閱《AWS Backup 開發人員指南》**中的[建立備份](https://https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-backup.html)。
**範例 2：列出完成的備份任務**
下列`list-backup-jobs`範例會傳回您 AWS 帳戶中已完成備份任務的中繼資料。
```
aws backup list-backup-jobs \
--by-state COMPLETED
```
輸出：
```
{
"BackupJobs": [
{
"BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"BackupVaultName": "Default",
"BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default",
"RecoveryPointArn": "arn:aws:backup:us-west-2:123456789012:recovery-point:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
"ResourceArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-12345678",
"CreationDate": 1600721724.77,
"CompletionDate": 1600721744.488,
"State": "COMPLETED",
"PercentDone": "100.0",
"BackupSizeInBytes": 71,
"IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole",
"StartBy": 1600725324.77,
"ResourceType": "EFS"
}
]
}
```
如需詳細資訊，請參閱《AWS Backup 開發人員指南》**中的[建立備份](https://https://docs.aws.amazon.com/aws-backup/latest/devguide/creating-a-backup.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListBackupJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/list-backup-jobs.html)。