이 문서에서는 Pub/Sub 주제를 생성, 업데이트, 보기, 삭제하는 방법을 설명합니다. 이 문서에서는 주제와 구독의 이름을 지정하는 방법도 설명합니다.
주제의 데이터 복제
Pub/Sub 주제는 영역 3개를 사용하여 데이터를 저장합니다. 이 서비스는 최소 2개 이상의 영역에 대한 동기식 복제와 추가적인 세 번째 영역에 대한 최선의 복제를 보장합니다. Pub/Sub 복제는 리전 하나 내에만 있습니다.
주제 속성
주제를 만들거나 업데이트할 때 해당 속성을 지정해야 합니다.
기본 구독을 추가합니다. Pub/Sub 주제에 기본 구독을 추가합니다. 주제가 생성된 후에 주제의 다른 구독을 만들 수 있습니다. 기본 구독에는 다음과 같은 속성이 있습니다.
-sub
의 구독 ID- 가져오기 전송 유형
- 메시지 보관 기간 7일
- 31일 동안 활동이 없으면 만료됨
- 확인 기한 10초
- 즉시 재시도 정책
스키마. 스키마는 메시지 데이터 필드가 따라야 하는 형식입니다. 스키마는 Pub/Sub가 적용하는 게시자와 구독자 간의 계약입니다. 주제 스키마는 메시지 유형 및 권한을 표준화하여 조직의 여러 팀에서 사용할 수 있도록 합니다. Pub/Sub는 메시지 유형 및 권한을 위한 중앙 권한을 만듭니다. 스키마가 포함된 주제를 만들려면 스키마 만들기 및 관리를 참조하세요.
메시지 보관 기간. 게시 후 Pub/Sub 주제에서 메시지를 보관하는 기간을 지정합니다. 메시지 보관 기간이 끝나면 Pub/Sub는 확인 상태에 관계없이 메시지를 삭제할 수 있습니다. 주제에 게시된 모든 메시지를 저장할 때 메시지 스토리지 요금이 청구됩니다.
- 기본값 = 사용 설정되지 않음
- 최솟값 = 10분
- 최댓값 = 31일
고객 관리 암호화 키(CMEK)를 사용합니다. 주제가 CMEK로 암호화되는지 여부를 지정합니다. Pub/Sub는 기본적으로 메시지를 Google 관리 키로 암호화합니다. 이 옵션을 지정하면 Pub/Sub에서 CMEK와 함께 봉투 암호화 패턴을 사용합니다. 이 방식에서 Cloud KMS는 메시지를 암호화하지 않습니다. 대신 Cloud KMS는 Pub/Sub에서 각 주제에 만드는 데이터 암호화 키(DEK)를 암호화합니다. Pub/Sub는 주제에 생성된 최신 DEK를 사용하여 메시지를 암호화합니다. Pub/Sub는 메시지가 구독자에게 전달되기 직전에 메시지를 복호화합니다. 키 만들기에 대한 자세한 내용은 메시지 암호화 구성을 참조하세요.
주제, 구독 또는 스냅샷 이름 지정 가이드라인
Pub/Sub 리소스 이름은 주제, 구독 또는 스냅샷과 같은 Pub/Sub 리소스를 고유하게 식별합니다. 리소스 이름은 다음 형식이어야 합니다.
projects/project-identifier/collection/ID
project-identifier
: Google Cloud 콘솔에서 사용할 수 있는 프로젝트 ID여야 합니다. 예를 들면my-cool-project
입니다.collection
:topics
,subscriptions
,snapshots
중 하나여야 합니다.ID
: 다음 가이드라인을 준수하세요.goog
문자열로 시작하지 않도록 합니다.- 문자로 시작합니다.
- 3~255자여야 합니다.
- 다음 문자(글자
[A-Za-z]
, 숫자[0-9]
, 대시-
, 밑줄_
, 마침표.
, 물결표~
, 더하기 기호%
)만 포함해야 합니다.
URL로 인코딩하지 않고 리소스 이름에 이전 목록의 특수문자를 사용할 수 있습니다. 하지만 다른 특수문자를 URL에 사용하는 경우 올바르게 암호화되거나 디코딩되었는지 확인해야 합니다. 예를 들어
mi-tópico
는 잘못된 ID입니다. 그러나mi-tópico
는 유효합니다. 이 형식은 REST를 호출할 때 중요합니다.
주제 만들기
주제를 게시하거나 구독하려면 먼저 주제를 만들어야 합니다.
콘솔
주제를 만들려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Pub/Sub 주제 페이지로 이동합니다.
주제 만들기를 클릭합니다.
주제 ID 필드에 주제의 ID를 입력합니다.
기본 구독 추가 옵션을 유지합니다.
다른 옵션을 선택하지 마세요.
주제 만들기를 클릭합니다.
gcloud CLI
주제를 만들려면 gcloud pubsub topics create
명령어를 실행합니다.
gcloud pubsub topics create TOPIC_ID
REST
주제를 만들려면 projects.topics.create
메서드를 사용합니다.
요청은 Authorization
헤더의 액세스 토큰으로 인증해야 합니다. 현재 애플리케이션 기본 사용자 인증 정보의 액세스 토큰을 얻으려면 gcloud auth application-default print-access-token
을 실행합니다.
PUT https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics/TOPIC_ID Authorization: Bearer ACCESS_TOKEN
각 항목의 의미는 다음과 같습니다.
응답:
{ "name": "projects/PROJECT_ID/topics/TOPIC_ID" }
C
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 C 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C API 참조 문서를 확인하세요.
C#
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C# API 참조 문서를 확인하세요.
Go
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Go API 참조 문서를 확인하세요.
Java
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Java API 참조 문서를 확인하세요.
Node.js
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Node.js API 참조 문서를 확인하세요.
PHP
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 PHP 설정 안내를 따르세요. 자세한 내용은 Pub/Sub PHP API 참조 문서를 확인하세요.
Python
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Python API 참조 문서를 확인하세요.
Ruby
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Ruby API 참조 문서를 확인하세요.
조직 정책 제약조건
조직 정책은 주제 생성을 제한할 수 있습니다. 예를 들어 정책이 Compute Engine 리전의 메시지 스토리지를 제한할 수 있습니다. 주제 생성 오류를 방지하려면 주제를 만들기 전에 필요에 따라 조직 정책을 검사하고 업데이트합니다.
프로젝트가 새로 생성되면 조직 정책이 초기화될 때까지 몇 분 정도 기다린 후 주제를 만듭니다.
스키마로 주제 만들기
주제를 만드는 동안 스키마를 할당할 수 있습니다.
다음은 스키마 사용에 대한 몇 가지 가이드라인입니다.
- 기존 주제에 스키마를 추가할 수 없습니다.
- 주제를 만드는 경우에만 스키마를 지정할 수 있습니다.
- 스키마가 주제와 연결되면 스키마를 업데이트하거나 해당 주제와의 연결을 삭제할 수 없습니다.
- 다른 새 주제에 동일한 스키마를 적용할 수 있습니다.
- 스키마를 삭제하면 연결된 모든 주제에 대한 게시가 실패합니다.
스키마에 대한 상세 설명은 스키마 만들기 및 관리를 참조하세요.
콘솔
주제를 만들고 스키마를 할당하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Pub/Sub 주제 페이지로 이동합니다.
주제 만들기를 클릭합니다.
주제 ID 필드에 주제의 ID를 입력합니다.
스키마 사용 체크박스를 선택합니다. 다른 옵션은 기본 설정에서 그대로 둡니다.
Pub/Sub 스키마 선택을 클릭하고 새 스키마 만들기를 선택합니다. 기존 스키마를 사용하려면 7단계로 가세요.
스키마 ID 필드에 스키마 ID를 입력합니다.
스키마 유형에 Avro 또는 프로토콜 버퍼를 선택합니다.
스키마 정의 필드에 스키마에 대한 프로토콜 버퍼 정의의 Avro를 입력합니다.
만들기를 클릭하여 스키마를 저장합니다.
주제 만들기 대화상자 창의 Pub/Sub 스키마 선택 필드에서 스키마를 검색합니다.
만들기를 클릭하여 주제를 저장하고 선택한 스키마에 할당합니다.
gcloud
이전에 만든 스키마로 할당된 주제를 만들려면 gcloud pubsub topics create
명령어를 실행합니다.
gcloud pubsub topics create TOPIC_ID \ --message-encoding=ENCODING_TYPE \ --schema=SCHEMA_ID
각 항목의 의미는 다음과 같습니다.
- TOPIC_ID는 만들려는 주제의 ID입니다.
- ENCODING_TYPE은 스키마에 대해 검증된 메시지의 인코딩 유형입니다. 이 값은
JSON
또는BINARY
로 설정해야 합니다. - SCHEMA_ID는 기존 스키마의 ID입니다.
다른 Google Cloud 프로젝트의 스키마를 할당할 수도 있습니다.
gcloud pubsub topics create TOPIC_ID \ --message-encoding=ENCODING_TYPE \ --schema=SCHEMA_ID \ --schema-project=SCHEMA_PROJECT \ --project=TOPIC_PROJECT
각 항목의 의미는 다음과 같습니다.
- SCHEMA_PROJECT는 스키마에 대한 Google Cloud 프로젝트의 프로젝트 ID입니다.
- TOPIC_PROJECT는 주제에 대한 Google Cloud 프로젝트의 프로젝트 ID입니다.
REST
주제를 만들려면 projects.topics.create
메서드를 사용합니다.
요청:
요청은 Authorization
헤더의 액세스 토큰으로 인증해야 합니다. 현재 애플리케이션 기본 사용자 인증 정보에 대한 액세스 토큰을 얻는 방법은 다음과 같습니다. gcloud auth application-default print-access-token
.
PUT https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics/TOPIC_ID Authorization: Bearer ACCESS_TOKEN
요청 본문:
{ "schemaSettings": { "schema": "SCHEMA_NAME", "encoding": "ENCODING_TYPE" } }
각 항목의 의미는 다음과 같습니다.
- PROJECT_ID는 프로젝트 ID입니다.
- TOPIC_ID는 주제 ID입니다.
- SCHEMA_NAME은 게시된 메시지를 검증할 대상인 스키마의 이름입니다. 형식은
projects/PROJECT_ID/schemas/SCHEMA_ID
입니다. - ENCODING_TYPE은 스키마에 대해 검증된 메시지의 인코딩 유형입니다.
JSON
또는BINARY
로 설정되어야 합니다.
응답:
{ "name": "projects/PROJECT_ID/topics/TOPIC_ID", "schemaSettings": { "schema": "SCHEMA_NAME", "encoding": "ENCODING_TYPE" } }
C
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 C 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C API 참조 문서를 확인하세요.
C#
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C# API 참조 문서를 확인하세요.
Go
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Go API 참조 문서를 참조하세요.
자바
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 자바 설정 안내를 따르세요. 자세한 내용은 Pub/Sub 자바 API 참조 문서를 참조하세요.
Node.js
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Node.js API 참조 문서를 참조하세요.
PHP
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 PHP 설정 안내를 따르세요. 자세한 내용은 Pub/Sub PHP API 참조 문서를 참조하세요.
Python
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Python API 참조 문서를 참조하세요.
Ruby
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Ruby API 참조 문서를 참조하세요.
주제 삭제
주제를 삭제해도 구독은 삭제되지 않습니다. 구독의 메시지 백로그는 구독자가 사용할 수 있습니다. 주제를 삭제하면 해당 구독에 주제 이름 _deleted-topic_
이 지정됩니다. 방금 삭제한 주제와 이름이 같은 주제를 만들려고 하면 잠시 동안 오류가 발생할 수 있습니다.
콘솔
Google Cloud 콘솔에서 Pub/Sub 주제 페이지로 이동합니다.
주제를 선택하고
작업 더보기를 클릭합니다.삭제를 클릭합니다.
주제 삭제 창이 나타납니다.
delete
를 입력한 후 삭제를 클릭합니다.
gcloud CLI
데이터 세트를 삭제하려면 gcloud pubsub topics delete
명령어를 사용합니다.
gcloud pubsub topics delete TOPIC_ID
REST
주제를 삭제하려면 projects.topics.delete
메서드를 사용합니다.
요청:
요청은 Authorization
헤더의 액세스 토큰으로 인증해야 합니다. 현재 애플리케이션 기본 사용자 인증 정보의 액세스 토큰을 얻으려면 gcloud auth application-default print-access-token
을 실행합니다.
DELETE https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics/TOPIC_ID Authorization: Bearer ACCESS_TOKEN
각 항목의 의미는 다음과 같습니다.
응답:
요청이 성공하면 응답은 빈 JSON 객체입니다.
C
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 C 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C API 참조 문서를 확인하세요.
C#
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C# API 참조 문서를 확인하세요.
Go
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Go API 참조 문서를 확인하세요.
Java
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Java API 참조 문서를 확인하세요.
Node.js
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Node.js API 참조 문서를 확인하세요.
PHP
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 PHP 설정 안내를 따르세요. 자세한 내용은 Pub/Sub PHP API 참조 문서를 확인하세요.
Python
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Python API 참조 문서를 확인하세요.
Ruby
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Ruby API 참조 문서를 확인하세요.
주제 나열
콘솔
Google Cloud 콘솔에서 Pub/Sub 주제 페이지로 이동합니다.
주제 페이지에는 사용 가능한 모든 주제가 나열됩니다.
gcloud CLI
주제를 나열하려면 gcloud pubsub topics list
명령어를 사용합니다.
gcloud pubsub topics list
REST
주제를 나열하려면 projects.topics.list
메서드를 사용합니다.
요청:
요청은 Authorization
헤더의 액세스 토큰으로 인증해야 합니다. 현재 애플리케이션 기본 사용자 인증 정보의 액세스 토큰을 얻으려면 gcloud auth application-default print-access-token
을 실행합니다.
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics Authorization: Bearer ACCESS_TOKEN
각 항목의 의미는 다음과 같습니다.
응답:
{ "topics": [ { "name": "projects/PROJECT_ID/topics/mytopic1", ... }, { "name": "projects/PROJECT_ID/topics/mytopic2", ... } ] }
C
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 C 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C API 참조 문서를 확인하세요.
C#
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C# API 참조 문서를 확인하세요.
Go
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Go API 참조 문서를 확인하세요.
Java
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Java API 참조 문서를 확인하세요.
Node.js
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Node.js API 참조 문서를 확인하세요.
PHP
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 PHP 설정 안내를 따르세요. 자세한 내용은 Pub/Sub PHP API 참조 문서를 확인하세요.
Python
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Python API 참조 문서를 확인하세요.
Ruby
이 샘플을 사용해 보기 전에 Pub/Sub 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Ruby API 참조 문서를 확인하세요.
기본적으로 쿼리당 최대 100개의 결과가 반환됩니다. 페이지 크기 매개변수를 사용하여 최대 1,000개의 대체 값을 지정할 수 있습니다.
주제 모니터링
Pub/Sub 내에서 주제를 모니터링할 수 있습니다.
다음 단계
주제의 구독 유형을 선택합니다.
주제의 구독을 만듭니다.
gcloud CLI로 주제를 만들거나 수정합니다.
REST API로 주제를 만들거나 수정하세요.