2.4.2. S3 버킷 알림 생성
버킷 수준에서 버킷 알림을 생성합니다. 알림 구성에는 Red Hat Ceph Storage Object Gateway S3 이벤트, ObjectCreated 및 ObjectRemoved 가 있습니다. 이를 게시해야 하며 버킷 알림을 보낼 대상입니다. 버킷 알림은 S3 작업입니다.
s3:objectCreate 및 s3:objectRemove 이벤트에 대한 버킷 알림을 생성하려면 PUT을 사용합니다.
예제
client.put_bucket_notification_configuration(
Bucket=bucket_name,
NotificationConfiguration={
'TopicConfigurations': [
{
'Id': notification_name,
'TopicArn': topic_arn,
'Events': ['s3:ObjectCreated:*', 's3:ObjectRemoved:*']
}]})
중요
Red Hat은 다음과 같은 ObjectCreate 이벤트(예: put,post,multipartUpload, copy )를 지원합니다. Red Hat은 object_delete 및 s3_multi_object_delete 와 같은 ObjectRemove 이벤트도 지원합니다.
요청 엔티티
NotificationConfiguration- 설명
-
TopicConfiguration엔터티 목록. - 유형
- 컨테이너
- 필수 항목
- 있음
TopicConfiguration- 설명
-
ID,
항목목록입니다. - 유형
- 컨테이너
- 필수 항목
- 있음
id- 설명
- 알림의 이름입니다.
- 유형
- 문자열
- 필수 항목
- 있음
주제- 설명
주제 Amazon 리소스 이름(ARN)
참고주제를 사전에 작성해야합니다.
- 유형
- 문자열
- 필수 항목
- 있음
이벤트- 설명
- 지원되는 이벤트 목록입니다. 여러 이벤트 엔티티를 사용할 수 있습니다. 생략하면 모든 이벤트가 처리됩니다.
- 유형
- 문자열
- 필수 항목
- 없음
filter- 설명
-
S3Key,S3Metadata및S3Tags엔티티입니다. - 유형
- 컨테이너
- 필수 항목
- 없음
S3Key- 설명
-
개체 키를 기반으로 필터링하기 위한
FilterRule엔터티 목록입니다. 대부분의 경우 3개 엔터티가 목록에 있을 수 있습니다. 예를 들어 이름은접두사,접미사또는regex입니다.목록의 모든 필터 규칙이 필터가 일치해야 합니다. - 유형
- 컨테이너
- 필수 항목
- 없음
S3Metadata- 설명
-
개체 메타데이터를 기반으로 필터링하기 위한
FilterRule엔터티 목록입니다. 목록의 모든 필터 규칙이 오브젝트에 정의된 메타데이터와 일치해야 합니다. 그러나 필터에 나열되지 않은 다른 메타데이터 항목이 있는 경우에도 오브젝트가 계속 일치합니다. - 유형
- 컨테이너
- 필수 항목
- 없음
S3Tags- 설명
-
오브젝트 태그를 기반으로 필터링하기 위한
FilterRule엔터티 목록입니다. 목록의 모든 필터 규칙이 오브젝트에 정의된 태그와 일치해야 합니다. 그러나 필터에 나열되지 않은 다른 태그가 있는 경우에도 오브젝트가 계속 일치합니다. - 유형
- 컨테이너
- 필수 항목
- 없음
S3Key.FilterRule- 설명
-
이름및값엔터티. name은접두사,접미사또는regex입니다.Value에는 키 접두사, 키 접미사 또는 키와 일치하는 정규식이 포함됩니다. - 유형
- 컨테이너
- 필수 항목
- 있음
S3Metadata.FilterRule- 설명
-
이름및값엔터티. name은 메타데이터 속성의 이름입니다(예:x-amz-meta-xxx). 값은 이 속성에 필요한 값입니다. - 유형
- 컨테이너
- 필수 항목
- 있음
S3Tags.FilterRule- 설명
-
이름및값엔터티. name은 태그 키이며 값은 태그 값입니다. - 유형
- 컨테이너
- 필수 항목
- 있음
HTTP 응답
400- 상태 코드
-
MalformedXML - 설명
- XML이 제대로 포맷되지 않았습니다.
400- 상태 코드
-
InvalidArgument - 설명
- 누락된 Id 또는 누락된 주제 ARN 또는 유효하지 않은 이벤트입니다.
404- 상태 코드
-
NoSuchBucket - 설명
- 버킷이 존재하지 않습니다.
404- 상태 코드
-
NoSuchKey - 설명
- 주제가 존재하지 않습니다.
id="s3-get-bucket-notifications_dev"]
