서비스 API 개요

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 클라이언트 라이브러리를 생성할 수 있습니다.

REST/HTTP API

서비스의 REST 인터페이스와 상호작용하는 방법은 여러 가지가 있습니다. 자체 클라이언트를 만들려면 다음 리소스를 사용합니다.

서비스 엔드포인트

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 위치로 대체합니다. 이러한 엔드포인트는 위치별로 격리됩니다. 즉, 각 엔드포인트는 엔드포인트 이름으로 지정된 위치의 리전 서비스로 요청을 라우팅합니다. 리소스 이름으로 지정된 위치가 엔드포인트에서 지정된 위치와 일치하지 않으면 요청이 실패합니다.