서비스 API 개요

Cloud Key Management Service에는 기존 REST/HTTP 및 gRPC 인터페이스가 모두 있습니다. 클라이언트 라이브러리를 사용하여 Cloud Key Management Service API에 액세스하지 않으려면 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 위치로 대체합니다. 이러한 엔드포인트는 위치별로 격리됩니다. 즉, 각 엔드포인트는 엔드포인트 이름으로 지정된 위치의 리전 서비스로 요청을 라우팅하게 됩니다. 리소스 이름으로 지정된 위치가 엔드포인트에서 지정된 위치와 일치하지 않으면 요청이 실패합니다.