Cloud Key Management Service에는 기존 REST/HTTP 및 gRPC 인터페이스가 모두 있습니다. Cloud Key Management Service API에 액세스하기 위해 Google의 클라이언트 라이브러리를 사용하지 않으려면 REST/HTTP 또는 gRPC API 표면을 사용하는 자체 클라이언트 라이브러리를 작성할 수도 있습니다. 제공된 클라이언트 라이브러리에서 프로그래밍 언어 또는 기타 요구사항이 충족되지 않는 경우에만 이 방법을 사용하는 것이 좋습니다.
gRPC API
다음 리소스를 사용하여 .proto 서비스 정의에서 Cloud Key Management Service API의 모든 gRPC 지원 언어로 고유 gRPC 클라이언트 라이브러리를 생성할 수 있습니다.
- Cloud KMS에서 gRPC 사용
- Cloud KMS 서비스 정의
- gRPC 문서: 자체 gRPC 클라이언트 코드를 생성 및 사용하는 데 필요한 모든 정보를 제공합니다.
- RPC API 참조: RPC 표면의 언어 독립적 개요입니다.
REST/HTTP API
서비스의 REST 인터페이스와 상호작용하는 방법은 여러 가지가 있습니다. 자체 클라이언트를 만들려면 다음 리소스를 사용합니다.
- REST API 참조
- Google HTTP API 작업 가이드라인
- API 검색 서비스: REST/HTTP API 표면에 대한 머신이 읽을 수 있는 메타데이터를 노출합니다. 이는 클라이언트 라이브러리, 도구, 플러그인을 만드는 데 유용합니다.
- REST/HTTP API 및 Google API 검색 서비스로 빌드한 클라이언트 샘플 디렉터리
서비스 엔드포인트
Cloud KMS에는 전역 및 리전 서비스 엔드포인트가 있습니다. 전역 REST/HTTP 엔드포인트는 https://cloudkms.googleapis.com
이고, 전역 gRPC 엔드포인트는 cloudkms.googleapis.com
입니다. 전역 엔드포인트는 리소스 이름으로 지정된 위치의 리전 서비스로 요청을 라우팅합니다.
리전 REST/HTTP 엔드포인트는 https://<region>-cloudkms.googleapis.com
이고 리전 gRPC 엔드포인트는 <region>-cloudkms.googleapis.com
이며, <region>
을 지원되는 리전, 이중 리전 또는 멀티 리전 Cloud KMS 위치로 대체합니다. 이러한 엔드포인트는 위치별로 격리됩니다. 즉, 각 엔드포인트는 엔드포인트 이름으로 지정된 위치의 리전 서비스로 요청을 라우팅합니다. 리소스 이름으로 지정된 위치가 엔드포인트에서 지정된 위치와 일치하지 않으면 요청이 실패합니다.