PutBackupVaultNotifications - AWS Backup
Request SyntaxURI 요청 파라미터요청 본문응답 구문Response ElementsErrors참고

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

PutBackupVaultNotifications

지정된 주제 및 이벤트에 대한 알림을 백업 저장소에서 켭니다.

Request Syntax

PUT /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
Content-type: application/json

{
   "BackupVaultEvents": [ "string" ],
   "SNSTopicArn": "string"
}

URI 요청 파라미터

요청은 다음 URI 파라미터를 사용합니다.

backupVaultName

백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.

패턴: ^[a-zA-Z0-9\-\_]{2,50}$

필수 사항 여부: Yes

요청 본문

요청은 JSON 형식으로 다음 데이터를 받습니다.

BackupVaultEvents

백업 저장소에 리소스를 백업할 작업의 상태를 나타내는 이벤트 어레이입니다.

일반적인 사용 사례 및 코드 샘플은 Amazon SNS를 사용하여 AWS Backup 이벤트 추적을 참조하십시오.

지원되는 이벤트는 다음과 같습니다.

  • BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED

  • COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED

  • RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RECOVERY_POINT_MODIFIED

  • S3_BACKUP_OBJECT_FAILED | S3_RESTORE_OBJECT_FAILED

참고

아래 목록에는 지원되는 이벤트와 더 이상 사용되지 않는 (참조용) 더 이상 사용되지 않는 이벤트가 모두 포함되어 있습니다. 지원 중단된 이벤트는 상태나 알림을 반환하지 않습니다. 지원되는 이벤트는 위 목록을 참조하십시오.

유형: 문자열 어레이

유효 값: BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED | BACKUP_JOB_SUCCESSFUL | BACKUP_JOB_FAILED | BACKUP_JOB_EXPIRED | RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RESTORE_JOB_SUCCESSFUL | RESTORE_JOB_FAILED | COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED | RECOVERY_POINT_MODIFIED | BACKUP_PLAN_CREATED | BACKUP_PLAN_MODIFIED | S3_BACKUP_OBJECT_FAILED | S3_RESTORE_OBJECT_FAILED

필수 사항 여부: 예

SNSTopicArn

백업 저장소의 이벤트 주제를 지정하는 Amazon 리소스 이름(ARN)입니다(예: arn:aws:sns:us-west-2:111122223333:MyVaultTopic).

타입: 문자열

필수 여부: 예

응답 구문

HTTP/1.1 200

Response Elements

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 반송합니다.

Errors

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.

InvalidParameterValueException

파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.

HTTP 상태 코드: 400

MissingParameterValueException

필수 파라미터가 누락되었음을 나타냅니다.

HTTP 상태 코드: 400

ResourceNotFoundException

작업에 필요한 리소스가 존재하지 않습니다.

HTTP 상태 코드: 400

ServiceUnavailableException

요청이 서버의 일시적 장애 때문에 실패했습니다.

HTTP 상태 코드: 500

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.