이 문서에서는 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 클라이언트 라이브러리를 사용하여 스키마 세부정보를 가져올 수 있습니다. 결과에는 최신 버전 ID의 세부정보가 반환됩니다.
콘솔
Google Cloud 콘솔에서 Pub/Sub 스키마 페이지로 이동합니다.
확인할 스키마의 이름을 클릭합니다.
스키마의 스키마 세부정보 페이지가 열립니다.
gcloud
스키마의 최신 버전을 보려면 다음 안내를 따르세요.
gcloud pubsub schemas describe SCHEMA_NAME
스키마의 특정 버전을 보려면 다음 안내를 따르세요.
gcloud pubsub schemas describe SCHEMA_ID@REVISION_ID
각 항목의 의미는 다음과 같습니다.
- REVISION_ID는 롤백할 버전입니다.
REST
스키마의 최신 버전 세부정보를 가져오려면 다음과 같이 GET 요청을 보냅니다.
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID
예를 들어 스키마 ID가 schema-inventory
인 스키마의 경우 https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/schema-inventory
요청을 보냅니다.
스키마의 특정 버전 세부정보를 가져오려면 다음과 같이 GET 요청을 보냅니다.
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID@REVISION_ID
예를 들어 스키마 ID가 schema-inventory
이고 버전 ID가 fa567a3e
인 스키마의 경우 https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/schema-inventory@fa567a3e
요청을 보냅니다.
각 항목의 의미는 다음과 같습니다.
- PROJECT_ID는 프로젝트 ID입니다.
- SCHEMA_ID는 스키마 ID입니다.
- REVISION_ID는 특정 스키마 버전의 ID입니다.
성공하면 응답 본문에 스키마 클래스의 인스턴스가 포함됩니다.
C++
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 C++ 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C++ API 참고 문서를 확인하세요.
C#
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Pub/Sub C# API 참조 문서를 확인하세요.
Go
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Go API 참고 문서를 참조하세요.
자바
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Pub/Sub 자바 API 참조 문서를 참조하세요.
Node.js
이 샘플을 시도하기 전에 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Pub/Sub Node.js 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 참고 문서를 참조하세요.