Cloud Key Management Service dispone di interfacce REST/HTTP tradizionali e gRPC. Se non vuoi utilizzare le nostre librerie client per accedere all'API Cloud Key Management Service, puoi scrivere le tue librerie client che utilizzano la superficie API REST/HTTP o gRPC. Ti consigliamo questo approccio solo se il tuo linguaggio di programmazione o altre esigenze non sono soddisfatti 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 gRPC: tutto ciò che ti serve per generare e utilizzare il tuo codice client gRPC.
- Riferimento API RPC: panoramica indipendente dalla lingua della superficie 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 sulla superficie dell'API REST/HTTP, utili per creare librerie client, strumenti e plug-in.
- Directory di esempi di client creati con API REST/HTTP e il servizio di rilevamento delle API di Google.
Endpoint di servizio
Cloud KMS dispone di endpoint di servizio globali e basati sulla località. L'endpoint
REST/HTTP globale è https://cloudkms.googleapis.com e
l'endpoint gRPC globale è cloudkms.googleapis.com. L'endpoint globale
indirizza le richieste a un servizio basato sulla posizione nella
posizione specificata dal nome della risorsa.
Gli endpoint REST/HTTP basati sulla località sono
https://<region>-cloudkms.googleapis.com e gli
endpoint gRPC basati sulla località sono
<region>-cloudkms.googleapis.com, sostituendo
<region> con una delle località Cloud KMS regionali, dual-region o multiregionali supportate. Questi endpoint sono isolati per località, il che significa che ogni endpoint indirizza le richieste a un servizio basato sulla località specificata dal nome dell'endpoint. Se la località specificata dal
nome della risorsa non corrisponde a quella specificata dall'endpoint, la richiesta
non andrà a buon fine.