לשירות Cloud Key Management Service יש ממשקי gRPC וגם ממשקי REST/HTTP מסורתיים. אם אתם לא רוצים להשתמש בספריות הלקוח שלנו כדי לגשת ל-Cloud Key Management Service API, אתם יכולים לכתוב ספריות לקוח משלכם שמשתמשות בממשק ה-API ל-REST/HTTP או ל-gRPC. אנחנו ממליצים על הגישה הזו רק אם שפת התכנות שלכם או צרכים אחרים לא נתמכים על ידי ספריות הלקוח שסיפקנו.
gRPC API
אפשר ליצור ספריות לקוח משלכם ל-gRPC בכל שפה שנתמכת על ידי gRPC עבור Cloud Key Management Service API מתוך הגדרת השירות .proto שלו באמצעות המשאבים הבאים:
- שימוש ב-gRPC עם Cloud KMS
- הגדרת השירות Cloud KMS
- מסמכי gRPC: כל מה שצריך כדי ליצור ולהשתמש בקוד לקוח gRPC משלכם.
- חומר עזר של RPC API: סקירה כללית של ממשק ה-RPC שלא תלויה בשפה.
REST/HTTP API
יש כמה אפשרויות לאינטראקציה עם ממשק REST של שירות. כדי ליצור לקוחות משלכם, אפשר להשתמש במקורות המידע הבאים:
- הפניית API בארכיטקטורת REST
- הנחיות לעבודה עם ממשקי Google HTTP API
- API Discovery Service: חושף מטא-נתונים שניתנים לקריאה על ידי מכונה לגבי ממשק ה-API ל-REST/HTTP, ושימושי ליצירת ספריות לקוח, כלים ותוספים.
- ספרייה של דוגמאות ללקוחות שנבנו באמצעות ממשקי API ל-REST/HTTP ושירות גילוי ה-API של Google.
נקודות קצה של שירותים
ל-Cloud KMS יש נקודות קצה (Endpoint) גלובליות ואזוריות. נקודת הקצה הגלובלית של REST/HTTP היא https://cloudkms.googleapis.com ונקודת הקצה הגלובלית של gRPC היא cloudkms.googleapis.com. נקודת הקצה הגלובלית מעבירה בקשות לשירות מבוסס-מיקום במיקום שצוין בשם המשאב.
נקודות הקצה מבוססות-המיקום של REST/HTTP הן https://<region>-cloudkms.googleapis.com ונקודות הקצה מבוססות-המיקום של gRPC הן <region>-cloudkms.googleapis.com. במקומות האלה צריך להזין את <region> במקום כל אחד מהמיקומים הנתמכים ב-Cloud KMS: אזור יחיד, שני אזורים או מספר אזורים. נקודות הקצה האלה מבודדות לפי מיקום, כלומר כל נקודת קצה מעבירה בקשות לשירות מבוסס-מיקום במיקום שצוין בשם נקודת הקצה. אם המיקום שצוין בשם המשאב לא תואם למיקום שצוין בנקודת הקצה, הבקשה תיכשל.