Erste Schritte mit der Service Management API

Auf dieser Seite wird beschrieben, wie Sie Ihre Entwicklungsumgebung für die Arbeit mit der Service Management API einrichten. Die einfachste Methode zur Verwendung der Service Management API (abgesehen von der Web-UI der Google Cloud Console) ist die Verwendung der gcloud Befehlszeile. Unsere Empfehlung für die meisten Anwendungsfälle für den Betrieb ist der einfachste Ansatz. Für eine Programmierung unter Einbindung der Service Management API empfehlen wir eine unserer verfügbaren Clientbibliotheken. Sie können die unten stehende alternative Anleitung sowie den Befehl curl verwenden, um die API zu testen, ohne eine komplette Anwendungsentwicklungsumgebung einzurichten.

Hinweis: Wenn Sie einen Dienst mit Cloud Endpoints erstellen, sollten Sie der entsprechenden Cloud Endpoints-Kurzanleitung folgen, um Informationen zur Einrichtung und zu den ersten Schritten mit der Service Management API für Cloud Endpoints zu erhalten.

Mit gcloud einrichten

1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

3. Service Management API aktivieren.

   Aktivieren Sie die API

4. Installieren Sie die Google Cloud CLI.

5. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

   gcloud init

6. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

7. Service Management API aktivieren.

   Aktivieren Sie die API

8. Installieren Sie die Google Cloud CLI.

9. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

   gcloud init

Direkten API-Aufruf einrichten

In diesem Abschnitt werden die grundlegenden Schritte zum Einrichten Ihrer lokalen Umgebung und zum Testen der Service Management API mit dem curl-Befehl beschrieben. Diese Schritte richten sich an Entwickler, die unter Einbindung der Service Management API programmieren.

Ersteinrichtung

1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
2. Installieren Sie die Google Cloud CLI.

3. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

   gcloud init

4. Google Cloud-Projekt erstellen oder auswählen.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   • Erstellen Sie ein Google Cloud-Projekt:

     gcloud projects create PROJECT_ID

     Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud-Projekt, das Sie erstellen.

   • Wählen Sie das von Ihnen erstellte Google Cloud-Projekt aus:

     gcloud config set project PROJECT_ID

     Ersetzen Sie PROJECT_ID durch den Namen Ihres Google Cloud-Projekts.

5. Aktivieren Sie die Service Management API:

   gcloud services enable servicemanagement.googleapis.com

6. Gewähren Sie Ihrem Google-Konto Rollen. Führen Sie den folgenden Befehl für jede der folgenden IAM-Rollen einmal aus: roles/servicemanagement.admin

   gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE

   • Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.
   • Ersetzen Sie EMAIL_ADDRESS durch Ihre E-Mail-Adresse.
   • Ersetzen Sie ROLE durch jede einzelne Rolle.
7. Installieren Sie die Google Cloud CLI.

8. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

   gcloud init

9. Google Cloud-Projekt erstellen oder auswählen.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   • Erstellen Sie ein Google Cloud-Projekt:

     gcloud projects create PROJECT_ID

     Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud-Projekt, das Sie erstellen.

   • Wählen Sie das von Ihnen erstellte Google Cloud-Projekt aus:

     gcloud config set project PROJECT_ID

     Ersetzen Sie PROJECT_ID durch den Namen Ihres Google Cloud-Projekts.

10. Aktivieren Sie die Service Management API:

    gcloud services enable servicemanagement.googleapis.com

11. Gewähren Sie Ihrem Google-Konto Rollen. Führen Sie den folgenden Befehl für jede der folgenden IAM-Rollen einmal aus: roles/servicemanagement.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE

    • Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.
    • Ersetzen Sie EMAIL_ADDRESS durch Ihre E-Mail-Adresse.
    • Ersetzen Sie ROLE durch jede einzelne Rolle.

Mit "curl" testen

1. Definieren Sie ein geeignetes Shell-Alias zum Aufrufen der Google REST APIs:

   $ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   

2. Versuchen Sie, öffentlich zugängliche Dienste aufzulisten:

   $ gcurl https://servicemanagement.googleapis.com/v1/services
   

   Wenn eine Liste der Dienste angezeigt wird, war die Einrichtung erfolgreich.

Nächste Schritte

Wenn Sie Cloud Endpoints nicht zum Erstellen eines verwalteten Dienstes verwenden, gehen Sie so vor:

1. Folgen Sie den Schritten in Dienste erstellen und löschen, um eine Ressource für verwaltete Dienste auf oberster Ebene zu erstellen.

2. Folgen Sie den Schritten unter Dienstkonfigurationen verwalten, um Dienstkonfigurationen zu senden, die vom Dienst verwendete Funktionen beschreiben.

   Hinweis: Die Dienstkonfiguration wird nach dem Senden nicht wirksam. Sie müssen Schritt 3 ausführen, um Konfigurationen einzuführen.

3. Informationen zum Bereitstellen Ihrer Dienstkonfigurationen finden Sie unter Dienstkonfigurationen bereitstellen.