PutBackupVaultNotifications - AWS Backup
Request SyntaxURI 요청 파라미터Request Body응답 구문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 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.

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

필수 여부: 예

Request Body

요청은 JSON 형식의 다음 데이터를 수락합니다.

BackupVaultEvents

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

일반적인 사용 사례 및 코드 샘플은 AmazonSNS을 사용하여 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

참고

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