O Cloud Key Management Service tem as interfaces tradicionais tanto REST/HTTP quanto gRPC. Se você não quiser usar nossas bibliotecas de cliente para acessar a API Cloud Key Management Service, poderá escrever as próprias bibliotecas que usam a plataforma da API REST/HTTP ou gRPC. Recomendamos essa abordagem somente se nossas bibliotecas de cliente incluídas não atenderem à sua linguagem de programação ou outras necessidades.
API gRPC
É possível gerar as próprias bibliotecas de cliente gRPC em qualquer linguagem compatível com gRPC para a API Cloud Key Management Service com base na definição de serviço .proto usando estes recursos:
- Como usar o gRPC com o Cloud KMS
- Definição de do serviço Cloud KMS
- Documentação do gRPC: tudo o que você precisa para gerar e usar seu próprio código do cliente gRPC.
- Referência da API RPC: visão geral independente de linguagem da plataforma RPC.
API REST/HTTP
Há várias opções para interagir com a interface REST de um serviço. Para criar os próprios clientes, use os seguintes recursos:
- Referência da API REST
- Diretrizes para trabalhar com as APIs HTTP do Google
- Serviço de descoberta de API: expõe metadados legíveis por máquina sobre a plataforma da API REST/HTTP, útil para criar bibliotecas de cliente, ferramentas e plug-ins.
- Diretório de amostras de clientes criadas com as APIs REST/HTTP e o serviço de descoberta de API do Google.
Pontos de extremidade de serviço
O Cloud KMS tem endpoints de serviço globais e regionais. O endpoint
global REST/HTTP é https://cloudkms.googleapis.com
e o
endpoint global gRPC é cloudkms.googleapis.com
. O endpoint
global encaminha as solicitações para um serviço regional no
local especificado pelo nome do recurso.
Os endpoints regionais REST/HTTP são
https://<region>-cloudkms.googleapis.com
e os
endpoints regionais gRPC são
<region>-cloudkms.googleapis.com
, substituindo
<region>
por qualquer um dos locais do
Cloud KMS regionais, multirregionais
ou de duas regiões. Esses endpoints são isolados por
local, o que significa que cada endpoint encaminha solicitações para um serviço regional no
local especificado pelo nome do endpoint. Se o local especificado pelo
nome do recurso não corresponder ao local especificado pelo endpoint, a solicitação
falhará.