객체 변경사항 등록

이 페이지에서는 Cloud Storage용 Cloud Pub/Sub 알림을 설정하고 사용하는 방법을 설명합니다. Cloud Pub/Sub 알림으로 Cloud Storage 객체의 변경사항을 추적할 수 있습니다. Cloud Storage용 Cloud Pub/Sub에 대해 자세히 알아보려면 알림 개념 페이지를 참조하세요.

기본 요건

이 기능을 사용하려면 다음 요건을 충족해야 합니다.

  1. 알림을 수신할 프로젝트에서 Cloud Pub/Sub API를 사용 설정해야 합니다.

    API 사용 설정

  2. 모니터링하려는 버킷에 대한 충분한 권한이 있어야 합니다.

  3. 알림을 수신할 프로젝트에 대한 충분한 권한이 있어야 합니다.

    • 알림을 수신할 프로젝트를 소유하고 있다면 필요한 권한을 가지고 있을 가능성이 높습니다.

    • 알림을 수신할 주제를 만들려면 pubsub.topics.create 권한이 있어야 합니다.

    • 새 주제 또는 기존 주제 사용 여부에 관계없이 pubsub.topics.setIamPolicy 권한이 있어야 합니다. 주제를 만드는 경우 대개 주제에 대한 pubsub.topics.setIamPolicy 권한이 있습니다.

      이러한 Cloud Pub/Sub 권한을 얻는 방법은 Cloud Pub/Sub 액세스 제어를 참조하세요.

  4. 알림을 전송하려는 기존 Cloud Pub/Sub 주제가 있어야 합니다.

  5. Cloud Storage 버킷이 있는 프로젝트와 연결된 서비스 계정의 이메일 주소를 가져옵니다.

  6. 이전 단계에서 가져온 이메일 주소를 사용하여 원하는 Cloud Pub/Sub 주제의 pubsub.publisher IAM 역할을 서비스 계정에 부여합니다.

알림 구성 적용하기

다음 단계에서는 모든 지원되는 이벤트의 알림을 보내는 알림 구성을 버킷에 추가합니다. 일부 이벤트에 대한 알림을 보내려면 gsutil 명령어와 함께 -e 플래그를 포함하거나 JSON 요청 본문에 event_types 키를 포함하세요.

gsutil

gsutil notification create 명령어를 사용합니다. 여기서 [VALUES_IN_BRACKETS]를 적절한 값으로 바꿉니다.

gsutil notification create -t [TOPIC_NAME] -f json gs://[BUCKET_NAME]

프로젝트에 없는 [TOPIC_NAME]을 사용하면 gsutil에서 자동으로 생성합니다.

JSON API

  1. OAuth 2.0 Playground에서 승인 액세스 토큰을 가져옵니다. OAuth 사용자 인증 정보를 사용하도록 Playground를 구성합니다.
  2. 다음 정보를 포함하는 .json 파일을 만듭니다. 여기서 [VALUES_IN_BRACKETS]를 적절한 값으로 바꿉니다.

    {
    "topic": "projects/[PROJECT_ID]/topics/[TOPIC_NAME]",
    "payload_format": "JSON_API_V1"
    }

  3. cURL을 사용하여 POST notificationConfigs 요청으로 JSON API를 호출합니다. 여기서 [VALUES_IN_BRACKETS]를 적절한 값으로 바꿉니다.

    curl -X POST --data-binary @[JSON_FILE_NAME].json 
    -H "Authorization: Bearer [OAUTH2_TOKEN]"
    -H "Content-Type: application/json"
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/notificationConfigs"

버킷의 알림 구성 나열

특정 버킷과 연결된 알림 구성을 나열하려면 다음 안내를 따르세요.

gsutil

gsutil notification list 명령어를 사용합니다. 여기서 [VALUES_IN_BRACKETS]를 적절한 값으로 바꿉니다.

gsutil notification list gs://[BUCKET_NAME]

JSON API

  1. OAuth 2.0 Playground에서 승인 액세스 토큰을 가져옵니다. OAuth 사용자 인증 정보를 사용할 수 있도록 플레이그라운드를 구성합니다.
  2. cURL을 사용하여 GET notificationConfigs 요청으로 JSON API를 호출합니다. 여기서 [VALUES_IN_BRACKETS]를 적절한 값으로 바꿉니다.

    curl -X GET 
    -H "Authorization: Bearer [OAUTH2_TOKEN]"
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/notificationConfigs"

알림 구성 삭제

버킷에서 기존 알림 구성을 삭제하려면 다음 안내를 따르세요.

gsutil

gsutil notification delete 명령어를 사용합니다. 여기서 [VALUES_IN_BRACKETS]를 적절한 값으로 바꿉니다.

gsutil notification delete projects/_/buckets/[BUCKET_NAME]/notificationConfigs/[CONFIGURATION_NAME]

전송 후 알림 구성에 의해 트리거된 모든 알림이 중지하는 데 최대 30초까지 걸릴 수 있습니다.

JSON API

  1. OAuth 2.0 Playground에서 승인 액세스 토큰을 가져옵니다. OAuth 사용자 인증 정보를 사용할 수 있도록 플레이그라운드를 구성합니다.
  2. cURL을 사용하여 DELETE notificationConfigs 요청으로 JSON API를 호출합니다. 여기서 [VALUES_IN_BRACKETS]를 적절한 값으로 바꿉니다.

    curl -X DELETE 
    -H "Authorization: Bearer [OAUTH2_TOKEN]"
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/notificationConfigs/[CONFIGURATION_NAME]"

전송 후 알림 구성에 의해 트리거된 모든 알림이 중지하는 데 최대 30초까지 걸릴 수 있습니다.

다음 단계

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.