Cloud Key Management Service dispone di interfacce REST/HTTP e gRPC tradizionali. Se non vuoi utilizzare le nostre librerie client per accedere all'API Cloud Key Management Service, puoi scrivere le tue librerie client che utilizzino la relativa piattaforma API REST/HTTP o gRPC. Consigliamo questo approccio solo se il linguaggio di programmazione o altre esigenze non vengono 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 relativa 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 dalla lingua 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: mostra metadati leggibili dalla macchina relativi alla piattaforma API REST/HTTP, utili per la creazione di librerie client, strumenti e plug-in.
- Directory di esempi di client creata con API REST/HTTP e Google API Discovery Service.
Endpoint di servizio
Cloud KMS dispone di endpoint di servizio globali e a livello di regione. L'endpoint
REST/HTTP globale è https://cloudkms.googleapis.com, mentre
l'endpoint gRPC globale è cloudkms.googleapis.com. L'endpoint globale instrada le richieste a un servizio regionale nella località specificata dal nome della risorsa.
Gli endpoint REST/HTTP a livello di regione sono https://<region>-cloudkms.googleapis.com, mentre gli endpoint gRPC a livello di regione sono <region>-cloudkms.googleapis.com, che sostituiscono <region> con una qualsiasi delle località Cloud KMS supportate a livello di regione, a due regioni o a più regioni. Questi endpoint sono isolati in base alla località, il che significa che ogni endpoint instrada le richieste a un servizio a livello di regione nella località specificata dal nome dell'endpoint. Se la località specificata dal nome della risorsa non corrisponde a quella specificata dall'endpoint, la richiesta avrà esito negativo.