2.16. 버킷 알림

절차

1. 다음 요청 형식을 사용하여 주제를 생성합니다.

   구문

   POST
   Action=CreateTopic
   &Name=TOPIC_NAME
   [&Attributes.entry.1.key=amqp-exchange&Attributes.entry.1.value=EXCHANGE]
   [&Attributes.entry.2.key=amqp-ack-level&Attributes.entry.2.value=none|broker|routable]
   [&Attributes.entry.3.key=verify-ssl&Attributes.entry.3.value=true|false]
   [&Attributes.entry.4.key=kafka-ack-level&Attributes.entry.4.value=none|broker]
   [&Attributes.entry.5.key=use-ssl&Attributes.entry.5.value=true|false]
   [&Attributes.entry.6.key=ca-location&Attributes.entry.6.value=FILE_PATH]
   [&Attributes.entry.7.key=OpaqueData&Attributes.entry.7.value=OPAQUE_DATA]
   [&Attributes.entry.8.key=push-endpoint&Attributes.entry.8.value=ENDPOINT]
   [&Attributes.entry.9.key=persistent&Attributes.entry.9.value=true|false]

   요청 매개 변수는 다음과 같습니다.

   • endpoint : 알림을 보낼 끝점의 URL입니다.
   • OpaqueData: 불투명 데이터가 주제 구성에 설정되고 해당 주제에서 트리거한 모든 알림에 추가됩니다.
   • persistent: 이 엔드포인트에 대한 알림이 비동기적인지 여부를 나타냅니다. 기본값은 false 입니다.

   • HTTP 끝점:

     • url: https://FQDN:PORT
     • 포트 기본값은 다음과 같습니다 : 그에 따라 HTTP[S]에 80/443을 사용합니다.
     • verify-ssl: 클라이언트에서 서버 인증서를 검증할지 여부를 나타냅니다. 기본값은 true입니다.By default, this is true.

   • AMQP0.9.1 끝점:

     • url: amqp://USER:passwords@FQDN:PORT[/VHOST].
     • 사용자 및 암호의 기본값은 guest 및 guest 입니다.
     • 사용자 및 암호 세부 정보는 HTTPS를 통해 제공해야 합니다. 그렇지 않으면 주제 생성 요청이 거부됩니다.
     • 포트 기본값은: 5672입니다.
     • vhost 기본값은 "/"입니다.
     • AMQP-exchange: 교환이 있어야 하며 주제를 기반으로 메시지를 라우팅할 수 있어야 합니다. AMQP0.9.1의 필수 매개변수입니다. 동일한 엔드포인트를 가리키는 다른 주제는 동일한 교환기를 사용해야 합니다.

     • AMQP-ack-level: 메시지가 최종 목적지로 전달되기 전에 브로커에 보관될 수 있으므로 확인 완료는 필요하지 않습니다. 인증하는 세 가지 방법이 있습니다.

       • None: 브로커에 전송되는 경우 메시지가 배달되는 것으로 간주됩니다.
       • broker: 기본적으로 브로커가 승인한 경우 메시지가 배달되는 것으로 간주됩니다.

       • 라우팅 가능: 브로커가 소비자로 라우팅할 수 있는 경우 전달되는 메시지가 표시됩니다.

         참고

         특정 매개변수의 키와 값은 동일한 줄 또는 특정 순서로 상주할 필요는 없지만 동일한 인덱스를 사용해야 합니다. 특성 인덱싱은 순차적이거나 특정 값에서 시작할 필요가 없습니다.

         참고

         topic-name 은 AMQP 주제를 위해 사용됩니다.

   • Kafka 끝점:

     • URL: kafka://USER: passwords@FQDN:PORT.
     • 기본적으로 use-ssl 이 false 로 설정됩니다. use-ssl 이 true 로 설정되면 브로커 연결에 보안 연결이 사용됩니다.
     • ca-location 이 제공되고 보안 연결이 사용되는 경우 브로커를 인증하는 기본 CA 대신 지정된 CA가 사용됩니다.
     • 사용자 및 암호는 HTTP[S]를 통해서만 제공할 수 있습니다. 그렇지 않으면 주제 생성 요청이 거부됩니다.
     • 사용자 및 암호는 use-ssl 과 함께만 제공될 수 있습니다. 그렇지 않으면 브로커에 대한 연결이 실패합니다.
     • 포트 기본값은: 9092입니다.

     • Kafka-ack-level: 메시지가 최종 목적지로 전달되기 전에 브로커가 지속되기 전에 브로커가 지속할 수 있으므로 필요한 확인 작업을 종료하지 않습니다. 감사하는 두 가지 방법이 있습니다.

       • None: 브로커에 전송되는 경우 메시지가 배달되는 것으로 간주됩니다.
       • broker: 기본적으로 브로커가 승인한 경우 메시지가 배달되는 것으로 간주됩니다.

절차

1. 다음 요청 형식으로 주제 정보를 가져옵니다.

   구문

   POST
   Action=GetTopic
   &TopicArn=TOPIC_ARN

   응답 형식의 예는 다음과 같습니다.Here is an example of the response format:

   <GetTopicResponse>
   <GetTopicRersult>
   <Topic>
   <User></User>
   <Name></Name>
   <EndPoint>
   <EndpointAddress></EndpointAddress>
   <EndpointArgs></EndpointArgs>
   <EndpointTopic></EndpointTopic>
   <HasStoredSecret></HasStoredSecret>
   <Persistent></Persistent>
   </EndPoint>
   <TopicArn></TopicArn>
   <OpaqueData></OpaqueData>
   </Topic>
   </GetTopicResult>
   <ResponseMetadata>
   <RequestId></RequestId>
   </ResponseMetadata>
   </GetTopicResponse>

   태그 및 정의는 다음과 같습니다.

   • User: 주제를 생성한 사용자의 이름입니다.
   • Name: 주제의 이름입니다.

   • JSON 형식의 끝점은 다음과 같습니다.

     • EndpointAddress: 엔드포인트 URL입니다. 엔드포인트 URL에 사용자 및 암호 정보가 포함된 경우 HTTPS를 통해 요청을 수행해야 합니다. otheriwse, 주제 get 요청이 거부됩니다.

       • EndPointArgs: 끝점 인수입니다.
       • EndpointTopic: 엔드포인트로 전송되는 주제 이름은 위의 예제 주제 이름과 다를 수 있습니다.
       • HasStoredSecret: 끝점 URL에 사용자 및 암호 정보가 포함된 경우true 입니다.
       • persistent: 주제가 지속되면true 입니다.
   • TopicArn: 주제입니다.
   • OpaqueData: 항목에 대한 불투명 데이터 집합입니다.

절차

1. 다음 요청 형식으로 주제 정보를 나열합니다.

   구문

   POST
   Action=ListTopics

   응답 형식의 예는 다음과 같습니다.Here is an example of the response format:

   <ListTopicdResponse xmlns="https://sns.amazonaws.com/doc/2020-03-31/">
   <ListTopicsRersult>
   <Topics>
   <member>
   <User></User>
   <Name></Name>
   <EndPoint>
   <EndpointAddress></EndpointAddress>
   <EndpointArgs></EndpointArgs>
   <EndpointTopic></EndpointTopic>
   </EndPoint>
   <TopicArn></TopicArn>
   <OpaqueData></OpaqueData>
   </member>
   </Topics>
   </ListTopicsResult>
   <ResponseMetadata>
   <RequestId></RequestId>
   </ResponseMetadata>
   </ListTopicsResponse>

   참고

   끝점 URL에 사용자 및 암호 정보가 포함된 경우 모든 항목에서 HTTPS를 통해 요청을 수행해야 합니다. 그렇지 않으면 주제 목록 요청이 거부됩니다.

절차

1. 요청 형식을 사용하여 주제를 삭제합니다.

   구문

   POST
   Action=DeleteTopic
   &TopicArn=TOPIC_ARN

   응답 형식의 예는 다음과 같습니다.Here is an example of the response format:

   <DeleteTopicResponse xmlns="https://sns.amazonaws.com/doc/2020-03-31/">
   <ResponseMetadata>
   <RequestId></RequestId>
   </ResponseMetadata>
   </DeleteTopicResponse>