이 문서에서는 Pub/Sub 주제의 스키마 버전을 나열하는 방법을 보여줍니다.
시작하기 전에
- Pub/Sub 스키마의 작동 방식을 이해합니다.
- 스키마를 만듭니다.
필수 역할 및 권한
스키마 버전을 나열하고 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Pub/Sub 편집자(roles/pubsub.editor
) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 스키마 버전을 나열하고 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.
필수 권한
스키마 버전을 나열하고 관리하려면 다음 권한이 필요합니다.
- 스키마 만들기:
pubsub.schemas.create
-
주제에 스키마 연결:
pubsub.schemas.attach
-
스키마 버전 커밋:
pubsub.schemas.commit
-
스키마 또는 스키마 버전 삭제:
pubsub.schemas.delete
-
스키마 또는 스키마 버전 가져오기:
pubsub.schemas.get
- 스키마 나열:
pubsub.schemas.list
-
스키마 버전 나열:
pubsub.schemas.listRevisions
-
스키마 롤백:
pubsub.schemas.rollback
-
메시지 유효성 검사:
pubsub.schemas.validate
- 스키마의 IAM 정책 가져오기:
pubsub.schemas.getIamPolicy
-
스키마의 IAM 정책 구성:
pubsub.schemas.setIamPolicy
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
사용자, 그룹, 도메인, 서비스 계정과 같은 주 구성원에 역할 및 권한을 부여할 수 있습니다. 한 프로젝트에서 스키마를 만들고 이를 다른 프로젝트에 있는 주제에 연결할 수 있습니다. 각 프로젝트에 필요한 권한이 있는지 확인합니다.
스키마 버전 나열
Google Cloud 콘솔, gcloud CLI, Pub/Sub API, Cloud 클라이언트 라이브러리를 사용하여 Google Cloud 프로젝트의 스키마 버전을 나열할 수 있습니다.
콘솔
Google Cloud 콘솔에서 Pub/Sub 스키마 페이지로 이동합니다.
스키마 목록이 표시됩니다.
확인할 스키마의 이름을 클릭합니다.
스키마의 스키마 세부정보 페이지가 열립니다.
버전 섹션에서 스키마에 사용 가능한 버전 목록을 볼 수 있습니다.
gcloud
스키마의 최신 버전을 보려면 다음 안내를 따르세요.
gcloud pubsub schemas list-revisions SCHEMA_ID
gcloud pubsub schemas list-revisions <var>SCHEMA_ID</var> --view=FULL
명령어를 사용하여 스키마 버전에 대한 정의를 확인합니다.
REST
스키마의 스키마 버전을 나열하려면 다음과 같이 GET 요청을 보냅니다.
GET https://pubsub.googleapis.com/v1/projects/SCHEMA_NAME:listRevisions
성공하면 응답 본문에 스키마의 모든 스키마 버전이 있는 JSON 객체가 포함됩니다.
C++
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 C++ 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C++ API 참고 문서를 확인하세요.
Go
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Go API 참고 문서를 참조하세요.
Java
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 자바 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Java API 참고 문서를 참조하세요.
Python
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Python API 참고 문서를 참조하세요.
Node.js
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Node.js API 참고 문서를 참조하세요.
Node.js
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Node.js API 참고 문서를 참조하세요.
다음 단계
스키마로 구성된 주제에 구독할 때 메시지를 처리하기