Cloud Key Management Service dispose d'interfaces traditionnelles REST/HTTP et gRPC. Si vous ne souhaitez pas utiliser nos bibliothèques clientes pour accéder à l'API Cloud Key Management Service, vous avez la possibilité d'écrire vos propres bibliothèques clientes utilisant la surface des API REST/HTTP ou gRPC. Nous ne recommandons cette approche que si les bibliothèques clientes fournies ne répondent pas à vos exigences de langage de programmation ou à d'autres besoins.
API gRPC
Vous pouvez tirer parti des ressources suivantes pour générer vos propres bibliothèques clientes gRPC dans n'importe quel langage compatible avec gRPC pour l'API Cloud Key Management Service à partir de sa définition de service .proto :
- Utiliser gRPC avec Cloud KMS
- Définition du service Cloud KMS
- Documentation gRPC : tout ce dont vous avez besoin pour générer et utiliser votre propre code client gRPC.
- Documentation de référence sur l'API RPC : présentation de la surface RPC indépendante du langage.
API REST/HTTP
Il existe plusieurs options pour interagir avec l'interface REST d'un service. Pour créer vos propres clients, utilisez les ressources suivantes :
- Documentation de référence sur l'API REST
- Consignes pour l'utilisation des API HTTP de Google
- Service de découverte d'API : celui-ci fournit des métadonnées lisibles par un ordinateur concernant la surface de l'API REST/HTTP, ce qui s'avère utile pour créer des bibliothèques clientes, des outils et des plug-ins.
- Annuaire d'exemples de clients créés à l'aide d'API REST/HTTP et du service de découverte d'API Google.
Points de terminaison du service
Cloud KMS dispose de points de terminaison de service globaux et régionaux. Le point de terminaison global REST/HTTP est https://cloudkms.googleapis.com
et le point de terminaison gRPC global est cloudkms.googleapis.com
. Le point de terminaison global achemine les requêtes vers un service régional dans l'emplacement spécifié par le nom de la ressource.
Les points de terminaison REST/HTTP régionaux sont https://<region>-cloudkms.googleapis.com
et les points de terminaison gRPC régionaux sont <region>-cloudkms.googleapis.com
, en remplaçant <region>
par l'un des emplacements Cloud KMS régionaux, birégionaux ou multirégionaux compatibles. Ces points de terminaison sont isolés par emplacement, ce qui signifie que chaque point de terminaison achemine les requêtes vers un service régional situé à l'emplacement spécifié par le nom du point de terminaison. Si l'emplacement spécifié par le nom de la ressource ne correspond pas à celui du point de terminaison, la requête échoue.