Cloud Key Management Service dispone sia delle interfacce tradizionali REST/HTTP sia di quelle gRPC. Se non vuoi utilizzare le nostre librerie client per accedere all' API Cloud Key Management Service, hai la possibilità di scrivere le tue librerie client che utilizzano la sua API REST/HTTP o gRPC. Ti consigliamo questo approccio solo se il tuo linguaggio di programmazione o altre esigenze non sono soddisfatte dalle librerie client fornite.
API gRPC
Puoi generare le tue librerie client gRPC in qualsiasi linguaggio supportato da gRPC per l'API Cloud Key Management Service dalla definizione del servizio .proto utilizzando queste risorse:
- Utilizzo di gRPC con Cloud KMS
- Definizione del servizio Cloud KMS
- Documentazione di gRPC: tutto ciò di cui hai bisogno per generare e utilizzare il tuo codice client gRPC.
- Riferimento API RPC: panoramica indipendente dal linguaggio della piattaforma RPC.
API REST/HTTP
Esistono diverse opzioni per interagire con l'interfaccia REST di un servizio. Per creare i tuoi client, utilizza le seguenti risorse:
- Riferimento API REST
- Linee guida per l'utilizzo delle API HTTP di Google
- API Discovery Service: espone metadati leggibili dalla macchina sull'interfaccia API REST/HTTP, utili per creare librerie client, strumenti e plug-in.
- Directory di esempi di client costruiti con API REST/HTTP e il servizio di rilevamento API di Google.
Endpoint di servizio
Cloud KMS dispone di endpoint di servizio globali e regionali. L'endpoint REST/HTTP globale è https://cloudkms.googleapis.com e l'endpoint gRPC globale è cloudkms.googleapis.com. L'endpoint globale inoltra le richieste a un servizio regionale nella
località specificata dal nome della risorsa.
Gli endpoint REST/HTTP regionali sono
https://<region>-cloudkms.googleapis.com e gli
endpoint gRPC regionali sono
<region>-cloudkms.googleapis.com, sostituendo
<region> con una delle località Cloud KMS regionali, con due regioni o più regioni supportate. Questi endpoint sono isolati per località, il che significa che ogni endpoint inoltra le richieste a un servizio regionale nella località specificata dal nome dell'endpoint. Se la posizione specificata dal nome della risorsa non corrisponde a quella specificata dall'endpoint, la richiesta non andrà a buon fine.