# AWS Backup를 사용한 예시AWS CLI
<a name="cli_backup_code_examples"></a>

다음 코드 예시에서는 AWS Backup에서 AWS Command Line Interface를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.

**Topics**
+ [작업](#actions)

## 작업
<a name="actions"></a>

### `create-backup-plan`
<a name="backup_CreateBackupPlan_cli_topic"></a>

다음 코드 예시는 `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 백업 개발자 안내서*의 [백업 계획 생성](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`
<a name="backup_CreateBackupVault_cli_topic"></a>

다음 코드 예시는 `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 백업 개발자 안내서*의 [백업 볼트 생성](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`
<a name="backup_GetBackupPlanFromTemplate_cli_topic"></a>

다음 코드 예시는 `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 백업 개발자 안내서*의 [백업 계획 생성](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`
<a name="backup_GetBackupPlan_cli_topic"></a>

다음 코드 예시는 `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 백업 개발자 안내서*의 [백업 계획 생성](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`
<a name="backup_ListBackupJobs_cli_topic"></a>

다음 코드 예시는 `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 백업 개발자 안내서*의 [백업 생성](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 백업 개발자 안내서*의 [백업 생성](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)를 참조하세요.