API verwenden – Empfehlungen

Auf dieser Seite erfahren Sie, wie Sie Empfehlungen in Recommender mit gcloud Befehlen oder der REST API anzeigen und verwalten.

Eine typische empfohlene Interaktion mit der Recommender API ist:

1. Listen Sie die Empfehlungen auf für ein bestimmtes Projekt.

2. Markieren Sie eine Empfehlung, die Sie anwenden möchten, als claimed, oder markieren Sie eine Empfehlung, die Sie nicht anwenden möchten, als dismissed.

3. Wenden Sie die Empfehlung an. Sie können dies automatisch mit Active Assist in der Google Cloud Console oder manuell mit den Google Cloud CLI-Befehlen, REST API-Aufrufen oder anderen Tools tun.

   Wenn Sie die Empfehlung manuell anwenden, sind die verwendeten Befehle oder Aufrufe für den Ressourcentyp spezifisch. Wenn Sie beispielsweise die Größe einer VM-Instanz als Reaktion auf eine Empfehlung des Größen-Recommenders für die VM-Instanz ändern möchten, verwenden Sie Compute Engine gcloud Befehle oder Aufrufe der Compute Engine REST API.

   Wenn Sie diese Vorgänge ausführen, identifizieren Sie die Zielressource mithilfe von dem Wert des Feldes resource im Array OperationsGroup in der zurückgegebenen Recommendation Entität. Dieses Feld hat folgendes Format:

   //API_NAME/RESOURCE_PATH

   Beispiel:

   //compute.googleapis.com/projects/example-project/zones/us-central1-a/instances/instance-1

4. Markieren Sie die Empfehlung als succeeded oder failed.

Beachten Sie, dass nur Empfehlungen, die über die API abgerufen wurden, über die API oder BigQuery-Exportbearbeitet werden können.

Informationen zum Ändern des Status von Empfehlungen in der Google Cloud Console finden Sie in der Dokumentation zu Active Assist oder für den entsprechenden Recommender.

Standardprojekt festlegen

Legen Sie das Standardprojekt fest, falls Sie dies noch nicht getan haben:

gcloud config set project PROJECT_ID

Dabei entspricht PROJECT_ID der ID des Projekts.

Umgebungsvariablen festlegen

Legen Sie Umgebungsvariablen für Recommender-Interaktionen fest:

PROJECT=TARGET_PROJECT_ID
LOCATION=LOCATION_ID
RECOMMENDER=RECOMMENDER_ID

Dabei gilt:

• TARGET_PROJECT_ID ist das Projekt, dessen Empfehlungen Sie auflisten möchten. Dies kann ein anderes Projekt als Ihr aktuelles Projekt sein.

  • Für gcloud-Befehle müssen Sie die Projekt-ID verwenden
  • Für API-Anfragen können Sie die Projektnummer oder Projekt-ID verwenden. Projektnummer wird empfohlen.

  Die Projektnummer wird in Antworten der API und der gcloud-Befehle zurückgegeben.

• LOCATION_ID ist der Google Cloud Standort, an dem sich die mit den Empfehlungen verknüpften Ressourcen befinden (z. B. global oder us-central1-a).

• RECOMMENDER_ID ist die vollständig qualifizierte Empfehlungs-ID (z. B. google.compute.instance.MachineTypeRecommender).

Unter Recommender finden Sie eine Tabelle mit verlinkten Informationen zu den einzelnen Recommendern, einschließlich unterstützter Standorte und Recommender-IDs.

Berechtigungen festlegen

Sie müssen über die erforderlichen Berechtigungen verfügen, um auf Empfehlungen im Zielprojekt zuzugreifen.

• Anfragesteller, die ihrer Anfrage ein Abrechnungsprojekt hinzufügen. Das in der Anfrage verwendete Projekt muss einwandfrei sein. Außerdem muss der Nutzer im Projekt eine Rolle mit der Berechtigung serviceusage.services.use haben. Die Rolle Dienstnutzungsnutzer enthält die erforderliche Berechtigung.
• Jeder Recommender erfordert bestimmte Berechtigungen. Unter Recommender finden Sie eine Tabelle mit verlinkten Informationen über die einzelnen Recommender, einschließlich der erforderlichen Berechtigungen.

Empfehlungen auflisten

Wie auf dem Tab gcloud Beta zu sehen ist, können Sie alle Empfehlungen Ihres Projekts auflisten, ohne einen Ort und einen Recommender angeben zu müssen. Dieses Feature befindet sich im Vorschaumodus.

Für die Google Analytics-Funktion müssen Sie ein Projekt, einen Standort und einen Recommender angeben. Weitere Informationen finden Sie auf dem Tab gcloud.

gcloud beta recommender recommendations list \
    --project=${PROJECT} \
    --format=FORMAT