Workflows erstellen und verwalten

Console

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

   Zur Projektauswahl

2. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

3. Workflows API aktivieren

   Aktivieren Sie die API

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

3. Workflows API aktivieren

   gcloud services enable workflows.googleapis.com
   

REST

Zum Verwalten von Workflows mit der Workflows API empfehlen wir die Verwendung der von Google bereitgestellten Clientbibliotheken zum Aufrufen des Dienstes workflows.googleapis.com. Weitere Informationen finden Sie unter Workflows API.

Console

1. Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf:

   Zur Seite „Dienstkonten“

2. Wählen Sie ein Projekt aus und klicken Sie auf Dienstkonto erstellen.

3. Geben Sie im Feld Dienstkontoname einen Namen ein.

   Der Name muss zwischen 6 und 30 Zeichen lang sein und alphanumerische Zeichen in Kleinschreibung sowie Bindestriche enthalten. Nachdem Sie ein Dienstkonto erstellt haben, können Sie seinen Namen nicht mehr ändern.

4. Klicken Sie auf Erstellen und fortfahren.

5. Klicken Sie auf Rolle auswählen.

6. Wählen Sie die folgenden Rollen aus und klicken Sie bei Bedarf auf Weitere Rolle hinzufügen:

   1. Wählen Sie zum Erstellen, Aktualisieren und Ausführen von Workflows Workflows > Workflow-Editor aus.
   2. Wählen Sie zum Senden von Logs an Cloud Logging Logging > Log-Autor aus.

7. Klicken Sie auf Fertig, um das Erstellen des Dienstkontos abzuschließen.

gcloud

1. Erstellen Sie das Dienstkonto.

   gcloud iam service-accounts create SERVICE_ACCOUNT

2. Gewähren Sie dem Dienstkonto Berechtigungen, indem Sie Rollen zuweisen.

   1. Weisen Sie zum Erstellen, Aktualisieren und Ausführen von Workflows die Rolle roles/workflows.editor zu:

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member "serviceAccount:SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com" \
          --role "roles/workflows.editor"
      

   2. Weisen Sie zum Senden von Logs an Cloud Logging die Rolle roles/logging.logWriter zu:

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member "serviceAccount:SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com" \
          --role "roles/logging.logWriter"
      

   Ersetzen Sie Folgendes:

   • SERVICE_ACCOUNT: der Name des Dienstkontos. Der Name des Dienstkontos muss zwischen 6 und 30 Zeichen lang sein und darf alphanumerische Zeichen in Kleinschreibung sowie Bindestriche enthalten. Nachdem Sie ein Dienstkonto erstellt haben, können Sie seinen Namen nicht mehr ändern.

   • PROJECT_ID ist die ID Ihres Projekts.

REST

Sie können die Methode serviceAccounts.create verwenden, um ein Dienstkonto zu erstellen. Weitere Informationen finden Sie unter Dienstkonten erstellen.

Sie können programmatisch mehrere Rollen zuweisen, indem Sie die Zulassungsrichtlinie für eine Ressource mit der Methode setIamPolicy ändern und festlegen. Weitere Informationen finden Sie unter Mehrere Rollen programmatisch gewähren oder widerrufen.

Console

1. Öffnen Sie in der Google Cloud Console die Seite Workflows.

   Zur Seite "Workflows"

2. Klicken Sie auf add Erstellen.

3. Geben Sie einen Namen für den Workflow ein, z. B. myFirstWorkflow. Der Name kann Buchstaben, Zahlen, Unterstriche und Bindestriche enthalten. Muss mit einem Buchstaben beginnen und mit einer Zahl oder einem Buchstaben enden.

4. Fügen Sie optional eine Beschreibung des Workflows hinzu.

5. Wählen Sie in der Liste Region einen geeigneten Standort für die Bereitstellung des Workflows aus, z. B. us-central1.

6. Wählen Sie in der Liste Dienstkonto ein Dienstkonto aus, das Ihr Workflow für den Zugriff auf andere Google Cloud-Dienste verwenden soll. Weitere Informationen finden Sie in diesem Dokument unter Dienstkonto erstellen.

7. Führen Sie optional die folgenden Schritte aus:

   1. Geben Sie die Ebene des Aufruf-Logging an, die Sie auf die Workflow-Definition anwenden möchten. Wählen Sie in der Liste Anrufprotokollebene eine der folgenden Optionen aus:

      • Nicht angegeben: Es wird keine Logging-Ebene angegeben. Das ist die Standardeinstellung. Eine Ausführungslogebene hat Vorrang vor einer Workflow-Logebene, sofern keine Ausführungslogebene angegeben ist (Standardeinstellung); In diesem Fall wird die Workflow-Logebene genutzt.
      • Nur Fehler: Alle erfassten Ausnahmen sowie das Beenden eines Aufrufs aufgrund einer Ausnahme werden protokolliert.
      • Alle Aufrufe: Alle Aufrufe von untergeordneten Workflows oder Bibliotheksfunktionen und deren Ergebnisse werden protokolliert.
      • Keine Protokolle: keine Anrufprotokollierung.

   2. Geben Sie den Cloud Key Management Service-Schlüssel an, den der Workflow für die Datenverschlüsselung verwenden soll: Wählen Sie Vom Kunden verwalteter Verschlüsselungsschlüssel (CMEK). Weitere Informationen finden Sie unter vom Kunden verwaltete Verschlüsselungsschlüssel verwenden.

   3. Geben Sie eine Umgebungsvariable an, auf die der Workflow zur Laufzeit zugreifen kann. Weitere Informationen finden Sie unter Umgebungsvariablen verwenden.

   4. Label hinzufügen: Labels sind Schlüssel/Wert-Paare, mit denen Sie Ihre Google Cloud-Instanzen organisieren können. Weitere Informationen finden Sie unter Was sind Labels? Workflowlabels werden bei Ausführungen des Workflows übernommen. Mit der Methode workflows.executions.list können Sie Workflowausführungen auflisten und filtern, um Ausführungslabels anzusehen.

   5. Workflow planen: Wählen Sie Neuen Trigger hinzufügen > Cloud Scheduler aus. Weitere Informationen finden Sie unter Workflow mit Cloud Scheduler planen.

   6. Workflow über ein Ereignis oder eine Pub/Sub-Nachricht auslösen: Wählen Sie Neuen Trigger hinzufügen > Eventarc aus. Weitere Informationen finden Sie unter Workflow mit Ereignissen oder Pub/Sub-Nachrichten auslösen.

8. Klicken Sie auf Weiter.

9. Geben Sie im Workflow-Editor die Definition für Ihren Workflow ein. Beispiel-Workflow ansehen

10. Klicken Sie auf Bereitstellen.

gcloud

1. Achten Sie darauf, dass der Quellcode Ihres Workflows in einer YAML- oder JSON-Datei gespeichert ist, z. B. MY_WORKFLOW.YAML oder MY_WORKFLOW.JSON. Sehen Sie sich einen Beispielworkflow an.

2. Öffnen Sie ein Terminalfenster.

3. Sie können einen Workflow mit dem Befehl gcloud workflows deploy erstellen und bereitstellen:

   gcloud workflows deploy WORKFLOW_NAME \
       --location=LOCATION \
       --call-log-level=CALL_LOGGING_LEVEL \
       --description="DESCRIPTION" \
       --labels="LABEL_KEY=LABEL_VALUE" \
       --set-env-vars="ENV_KEY=ENV_VALUE" \
       --kms-key=ENCRYPT_KEY \
       --service-account=SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com \
       --source=YAML_OR_JSON_SOURCE_FILE
   

   Ersetzen Sie Folgendes:

   • WORKFLOW_NAME: der Name Ihres Workflows, z. B. myFirstWorkflow Der Name kann Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten. Er muss mit einem Buchstaben beginnen und mit einer Ziffer oder einem Buchstaben enden.

   • LOCATION: Die Region, in der der Workflow bereitgestellt werden soll, z. B. us-central1.

   • CALL_LOGGING_LEVEL: Optional. Ebene des Aufruf-Logging, die während der Ausführung angewendet werden soll. Kann einer der folgenden Werte sein:

     • none: Es wurde keine Logging-Ebene angegeben. Das ist die Standardeinstellung. Eine Ausführungslogebene hat Vorrang vor einer Workflow-Logebene, sofern keine Ausführungslogebene angegeben ist (Standardeinstellung); In diesem Fall wird die Workflow-Logebene genutzt.
     • log-errors-only: Es werden alle erfassten Ausnahmen sowie das Beenden eines Aufrufs aufgrund einer Ausnahme protokolliert
     • log-all-calls: Alle Aufrufe von untergeordneten Workflows oder Bibliotheksfunktionen und deren Ergebnisse werden protokolliert.
     • log-none: Kein Aufruf-Logging.

   • DESCRIPTION: Optional. Eine Beschreibung des Workflows.

   • LABEL_KEY=LABEL_VALUE: Optional. Liste der Label-Schlüssel/Wert-Paare, mit denen Sie Ihre Google Cloud-Instanzen organisieren können, z. B. name=wrench. Weitere Informationen finden Sie unter Was sind Labels? Workflowlabels werden bei Ausführungen des Workflows übernommen. Mit der Methode workflows.executions.list können Sie Workflowausführungen auflisten und filtern, um Ausführungslabels anzusehen.

   • ENV_KEY=ENV_VALUE: Optional. Liste der Schlüssel/Wert-Paare der Umgebungsvariablen, z. B. MONTH=January. Weitere Informationen finden Sie unter Umgebungsvariablen verwenden.

   • ENCRYPT_KEY: Optional. Ein Cloud KMS-Schlüssel im Format projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME, den der Workflow für die Datenverschlüsselung verwenden soll. Weitere Informationen finden Sie unter vom Kunden verwaltete Verschlüsselungsschlüssel verwenden.

   • SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com: Optional. Das Dienstkonto, mit dem Ihr Workflow auf andere Google Cloud-Dienste zugreift. Weitere Informationen finden Sie in diesem Dokument unter Dienstkonto erstellen.

   • YAML_OR_JSON_SOURCE_FILE: Die Quelldatei für die Workflowdefinition. Beispiel: myFirstWorkflow.yaml

REST

Verwenden Sie zum Erstellen eines neuen Workflows mit einem bestimmten Namen die Methode projects.locations.workflows.create und den Abfrageparameter workflowId, um eine ID für den Workflow anzugeben.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

• WORKFLOW_NAME: der Name des Workflows, z. B. myFirstWorkflow Der Name kann Buchstaben, Ziffern, Unterstriche und Bindestriche enthalten. Er muss mit einem Buchstaben beginnen und mit einer Ziffer oder einem Buchstaben enden.
• DESCRIPTION: Optional. Eine Beschreibung Ihres Workflows. Darf nicht länger als 1.000 Unicode-Zeichen sein.
• LABEL_KEY und LABEL_VALUE: optional. Eine Zuordnung von Labelschlüssel-/Wert-Paaren, mit denen Sie Ihre Google Cloud-Instanzen organisieren können. Beispiel: {"name": "wrench", "mass": "1kg", "count": "3"}. Weitere Informationen finden Sie unter Was sind Labels?. Workflowlabels werden bei Ausführungen des Workflows übernommen. Mit der Methode workflows.executions.list können Sie Workflowausführungen auflisten und filtern, um Ausführungslabels anzusehen.
• SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com: optional. Das Dienstkonto, mit dem Ihr Workflow auf andere Google Cloud-Dienste zugreift. Die Projekt-ID ist Ihre Google Cloud-Projekt-ID. Weitere Informationen finden Sie in diesem Dokument unter Dienstkonto erstellen.
• ENCRYPT_KEY: Optional. Ein Cloud KMS-Schlüssel im Format projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME, den der Workflow für die Datenverschlüsselung verwenden soll. Weitere Informationen finden Sie unter Vom Kunden verwaltete Verschlüsselungsschlüssel verwenden.
• CALL_LOGGING_LEVEL: Optional. Die Protokollebene des Aufrufs, die während der Ausführung angewendet werden soll. Standardmäßig ist keine Logging-Ebene angegeben. Stattdessen gilt die Workflow-Logebene. Weitere Informationen finden Sie unter Logs an Logging senden. Eine der folgenden Optionen:
  • CALL_LOG_LEVEL_UNSPECIFIED: Es ist keine Logging-Ebene angegeben. Stattdessen wird die Workflow-Logebene angewendet. Das ist die Standardeinstellung. Andernfalls gilt die Ebene des Ausführungslogs und hat Vorrang vor der Workflowlogebene.
  • LOG_ERRORS_ONLY: Protokolliert alle erfassten Ausnahmen oder wenn ein Aufruf aufgrund einer Ausnahme beendet wird.
  • LOG_ALL_CALLS: Protokolliert alle Aufrufe von untergeordneten Workflows oder Bibliotheksfunktionen und deren Ergebnisse.
  • LOG_NONE: Kein Aufruf-Logging.
• ENV_KEY und ENV_VALUE: optional. Eine Zuordnung von Schlüssel/Wert-Paaren von Umgebungsvariablen, z. B. { "month": "January", "day": "Monday"}. Weitere Informationen finden Sie unter Umgebungsvariablen verwenden.
• SOURCE_CODE: die Workflowdefinition. Neue Zeilen müssen in YAML mit Escapezeichen versehen werden. Beispiel: main:\n params:\n - input\n steps:\n - returnOutput:\n return: Hello.

  In JSON müssen Sie Anführungszeichen mit Escapezeichen versehen. Beispiel: {\"main\":{\"params\":[\"input\"],\"steps\":[{\"returnOutput\":{\"return\":\"Hello\"}}]}}

• LOCATION: die Region, in der der Workflow bereitgestellt werden soll, z. B. us-central1.

JSON-Text anfordern:

{
  "name": "WORKFLOW_NAME",
  "description": "DESCRIPTION",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "serviceAccount": "SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com",
  "cryptoKeyName": "ENCRYPT_KEY",
  "callLogLevel": "CALL_LOGGING_LEVEL",
  "userEnvVars": {"ENV_KEY":"ENV_VALUE"},
  "sourceContents": "SOURCE_CODE"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

cat > request.json << 'EOF'
{
  "name": "WORKFLOW_NAME",
  "description": "DESCRIPTION",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "serviceAccount": "SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com",
  "cryptoKeyName": "ENCRYPT_KEY",
  "callLogLevel": "CALL_LOGGING_LEVEL",
  "userEnvVars": {"ENV_KEY":"ENV_VALUE"},
  "sourceContents": "SOURCE_CODE"
}
EOF

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://workflows.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/workflows?workflowId=WORKFLOW_NAME"

@'
{
  "name": "WORKFLOW_NAME",
  "description": "DESCRIPTION",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "serviceAccount": "SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com",
  "cryptoKeyName": "ENCRYPT_KEY",
  "callLogLevel": "CALL_LOGGING_LEVEL",
  "userEnvVars": {"ENV_KEY":"ENV_VALUE"},
  "sourceContents": "SOURCE_CODE"
}
'@  | Out-File -FilePath request.json -Encoding utf8

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://workflows.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/workflows?workflowId=WORKFLOW_NAME" | Select-Object -Expand Content

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation.

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.workflows.v1.OperationMetadata",
    "createTime": "2023-12-05T14:06:06.338390918Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME",
    "verb": "create",
    "apiVersion": "v1"
  },
  "done": false
}

Wenn der Wert von "done" false ist, ist der Vorgang noch aktiv.

Console

1. Öffnen Sie in der Google Cloud Console die Seite Workflows.

   Zur Seite "Workflows"

   Auf dieser Seite sind Ihre Workflows an allen Standorten aufgelistet. Sie enthält auch Details wie Namen, Regionen, neueste Überarbeitungen und mehr.

2. So filtern Sie Ihre Workflows:

   1. Klicken Sie auf filter_list Filter oder das Feld Workflows filtern.
   2. Wählen Sie in der Liste Eigenschaften eine Option aus, nach der die Workflows gefiltert werden sollen.

   Sie können ein einzelnes Attribut auswählen oder den logischen Operator OR verwenden, um weitere Attribute hinzuzufügen.

3. Klicken Sie zum Sortieren Ihrer Workflows neben jeder unterstützten Spaltenüberschrift auf arrow_upward Sortieren.

gcloud

Listen Sie Workflows mit dem Befehl gcloud workflows list auf:

gcloud workflows list --location=LOCATION

Ersetzen Sie LOCATION durch die ID oder die voll qualifizierte Kennung des Speicherorts Ihres Workflows.

Dieser Befehl listet Ihre Workflows am angegebenen Speicherort auf und enthält Details wie NAME, STATE, REVISION_ID und UPDATE_TIME des Workflows.

REST

Verwenden Sie die Methode projects.locations.workflows.list, um Workflows in einem bestimmten Projekt und an einem bestimmten Standort aufzulisten.

Alternativ können Sie die Details eines einzelnen Workflows mit der Methode projects.locations.workflows.get abrufen.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

• PROJECT_ID: Ihre Google Cloud-Projekt-ID.
• LOCATION: Die Region, in der die Workflows bereitgestellt werden, z. B. us-central1.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://workflows.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/workflows"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://workflows.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/workflows" | Select-Object -Expand Content

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Instanzen von Workflow und die Antwort sollte in etwa so aussehen:

{
  "workflows": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME",
      "state": "ACTIVE",
      "revisionId": "000001-0ce",
      "createTime": "2023-12-08T13:56:59.306770745Z",
      "updateTime": "2023-12-08T13:56:59.547021939Z",
      "revisionCreateTime": "2023-12-08T13:56:59.340161044Z",
      "serviceAccount": "projects/PROJECT_ID/serviceAccounts/PROJECT_NUMBER-compute@developer.gserviceaccount.com",
      "sourceContents": "main:\n    params: [input]\n [...] return: '${wikiResult.body[1]}'\n"
    },
    {
      object (Workflow)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}

Console

1. Öffnen Sie in der Google Cloud Console die Seite Workflows.

   Zur Seite "Workflows"

2. Klicken Sie auf den Namen des Workflows, den Sie aktualisieren möchten. Sie können den Namen des Workflows nicht ändern.

   Die Seite Workflowdetails wird angezeigt.

3. Sie können den Workflow so bearbeiten:

   • So bearbeiten Sie die Quelle:

     1. Klicken Sie auf den Tab Quelle.
     2. Klicken Sie auf Bearbeiten.
     3. Um die Änderungen zu speichern, klicken Sie auf Speichern. Der aktualisierte Workflow wird bereitgestellt.

   • Zum Aktualisieren der Beschreibung das Dienstkonto, das der Workflow für die Authentifizierung verwendet, die Aufruflogebene, Umgebungsvariablen, Labels oder der Verschlüsselungsschlüssel:

     1. Klicken Sie auf den Tab Details.
     2. Klicken Sie auf das entsprechende Symbol edit.
     3. Wenn Sie die Anruflogebene aktualisieren, wählen Sie eine der folgenden Optionen aus:
        • Nicht angegeben: Es wird keine Logging-Ebene angegeben. Das ist die Standardeinstellung. Eine Ausführungslogebene hat Vorrang vor einer Workflow-Logebene, sofern keine Ausführungslogebene angegeben ist (Standardeinstellung); In diesem Fall wird die Workflow-Logebene genutzt.
        • Nur Fehler: Alle erfassten Ausnahmen sowie das Beenden eines Aufrufs aufgrund einer Ausnahme werden protokolliert.
        • Alle Aufrufe: Alle Aufrufe von untergeordneten Workflows oder Bibliotheksfunktionen und deren Ergebnisse werden protokolliert.
        • Keine Protokolle: keine Anrufprotokollierung.
     4. Wenn Sie ein vorhandenes Label aktualisieren oder ein neues hinzufügen, kann es bis zu 10 Minuten dauern, bis das neue Label wirksam wird. Workflowlabels werden bei Ausführungen des Workflows übernommen. Mit der Methode workflows.executions.list können Sie Workflowausführungen auflisten und filtern, um Ausführungslabels anzusehen.
     5. Um die Änderungen zu speichern, klicken Sie auf Speichern. Der aktualisierte Workflow wird bereitgestellt.

   • So bearbeiten Sie die vorherigen Felder gleichzeitig oder fügen einen Trigger hinzu oder aktualisieren einen Trigger:

     1. Klicken Sie auf edit Bearbeiten.
     2. Klicken Sie auf Weiter, um die Quelle zu bearbeiten.
     3. Klicken Sie auf Bereitstellen, um die Änderungen zu speichern und den aktualisierten Workflow bereitzustellen.

4. Wenn Sie die Rollen für Ihr Dienstkonto aktualisieren möchten, klicken Sie auf den Tab Berechtigungen.

   1. Hauptkonten sind Nutzer, Gruppen, Domains oder Dienstkonten. So aktualisieren Sie ein vorhandenes Hauptkonto:

      1. Suchen Sie eine Zeile mit dem Hauptkonto.
      2. Klicken Sie in dieser Zeile auf edit Hauptkonto bearbeiten.
      3. Klicken Sie auf add Weitere Rolle hinzufügen oder delete Rolle löschen.

   2. Wenn Sie eine Rolle hinzufügen, wählen Sie in der Liste Rolle auswählen die entsprechende Rolle aus.

   3. Wenn Sie eine weitere Rolle hinzufügen möchten, klicken Sie auf Weitere Rolle hinzufügen.

   4. Klicken Sie auf Speichern.

gcloud

1. Öffnen Sie ein Terminalfenster.

2. Suchen Sie den Namen des Workflows, den Sie aktualisieren möchten. Wenn Sie den Namen des Workflows nicht kennen, können Sie den folgenden Befehl eingeben, um alle Workflows aufzulisten:

   gcloud workflows list
   

3. Suchen Sie die YAML- oder JSON-Datei, in der die Workflowquelle gespeichert ist, z. B. WORKFLOW_NAME.YAML oder WORKFLOW_NAME.JSON.

4. Mit dem Befehl gcloud workflows deploy können Sie einen vorhandenen Workflow aktualisieren, um die Quelle, die Beschreibung, Labels, Umgebungsvariablen, die Aufruflogebene, den Verschlüsselungsschlüssel oder das zugehörige Dienstkonto zu ändern.

   Sie müssen den Namen des zu aktualisierenden Workflows und dessen Quelle angeben. Die übrigen Flags sind jedoch optional. Verwenden Sie das Flag --clear-kms-key, um einen vom Kunden verwalteten Verschlüsselungsschlüssel zu entfernen.

   gcloud workflows deploy WORKFLOW_NAME \
       --call-log-level=CALL_LOGGING_LEVEL \
       --description="DESCRIPTION" \
       --labels="LABEL_KEY=LABEL_VALUE" \
       --set-env-vars="ENV_KEY=ENV_VALUE" \
       --kms-key=ENCRYPT_KEY \
       --service-account=SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com \
       --source=YAML_OR_JSON_SOURCE_FILE
   

   Ersetzen Sie Folgendes:

   • WORKFLOW_NAME: erforderlich. Der Name Ihres Workflows.

   • CALL_LOGGING_LEVEL: Optional. Ebene des Anruf-Loggings, die auf den Workflow angewendet werden sollen. Kann einer der folgenden Werte sein:

     • none: Es wurde keine Logging-Ebene angegeben. Das ist die Standardeinstellung. Eine Ausführungslogebene hat Vorrang vor einer Workflow-Logebene, sofern keine Ausführungslogebene angegeben ist (Standardeinstellung); In diesem Fall wird die Workflow-Logebene genutzt.
     • log-errors-only: Es werden alle erfassten Ausnahmen sowie das Beenden eines Aufrufs aufgrund einer Ausnahme protokolliert
     • log-all-calls: Alle Aufrufe von untergeordneten Workflows oder Bibliotheksfunktionen und deren Ergebnisse werden protokolliert.
     • log-none: Kein Aufruf-Logging.

   • DESCRIPTION: Optional. Eine Beschreibung des Workflows.

   • LABEL_KEY=LABEL_VALUE: Optional. Liste der Label-Schlüssel/Wert-Paare, mit denen Sie Ihre Google Cloud-Instanzen organisieren können, z. B. name=wrench. Weitere Informationen finden Sie unter Was sind Labels? Workflowlabels werden bei Ausführungen des Workflows übernommen. Mit der Methode workflows.executions.list können Sie Workflowausführungen auflisten und filtern, um Ausführungslabels anzusehen.

   • ENV_KEY=ENV_VALUE: Optional. Liste der Schlüssel/Wert-Paare der Umgebungsvariablen, z. B. MONTH=January. Weitere Informationen finden Sie unter Umgebungsvariablen verwenden.

   • ENCRYPT_KEY: Optional. Ein Cloud KMS-Schlüssel im Format projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME, den der Workflow für die Datenverschlüsselung verwenden soll. Weitere Informationen finden Sie unter vom Kunden verwaltete Verschlüsselungsschlüssel verwenden.

   • SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com: Optional. Das Dienstkonto, mit dem Ihr Workflow auf andere Google Cloud-Dienste zugreift. Informationen zum Aktualisieren der Rollen für Ihr Dienstkonto finden Sie unter Workflowberechtigungen für den Zugriff auf Google Cloud-Ressourcen gewähren und Zugriff auf Projekte, Ordner und Organisationen verwalten.

   • YAML_OR_JSON_SOURCE_FILE: erforderlich. Die Quelldatei für den Workflow im YAML- oder JSON-Format. Beispiel: myFirstWorkflow.yaml.

REST

Verwenden Sie zum Aktualisieren eines vorhandenen Workflows die Methode projects.locations.workflows.patch und optional den Abfrageparameter updateMask, um eine Liste der Felder anzugeben, die aktualisiert werden sollen.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

• WORKFLOW_NAME: der Name des Workflows, z. B. myFirstWorkflow
• DESCRIPTION: Optional. Eine Beschreibung Ihres Workflows. Darf nicht länger als 1.000 Unicode-Zeichen sein.
• LABEL_KEY und LABEL_VALUE: optional. Eine Zuordnung von Labelschlüssel-/Wert-Paaren, mit denen Sie Ihre Google Cloud-Instanzen organisieren können. Beispiel: {"name": "wrench", "mass": "1kg", "count": "3"}. Weitere Informationen finden Sie unter Was sind Labels?. Workflowlabels werden bei Ausführungen des Workflows übernommen. Mit der Methode workflows.executions.list können Sie Workflowausführungen auflisten und filtern, um Ausführungslabels anzusehen.
• SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com: optional. Das Dienstkonto, mit dem Ihr Workflow auf andere Google Cloud-Dienste zugreift. Die Projekt-ID ist Ihre Google Cloud-Projekt-ID. Weitere Informationen finden Sie in diesem Dokument unter Dienstkonto erstellen.
• ENCRYPT_KEY: Optional. Ein Cloud KMS-Schlüssel im Format projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME, den der Workflow für die Datenverschlüsselung verwenden soll. Weitere Informationen finden Sie unter Vom Kunden verwaltete Verschlüsselungsschlüssel verwenden.
• CALL_LOGGING_LEVEL: Optional. Die Protokollebene des Aufrufs, die während der Ausführung angewendet werden soll. Standardmäßig ist keine Logging-Ebene angegeben. Stattdessen gilt die Workflow-Logebene. Weitere Informationen finden Sie unter Logs an Logging senden. Eine der folgenden Optionen:
  • CALL_LOG_LEVEL_UNSPECIFIED: Es ist keine Logging-Ebene angegeben. Stattdessen wird die Workflow-Logebene angewendet. Das ist die Standardeinstellung. Andernfalls gilt die Ebene des Ausführungslogs und hat Vorrang vor der Workflowlogebene.
  • LOG_ERRORS_ONLY: Protokolliert alle erfassten Ausnahmen oder wenn ein Aufruf aufgrund einer Ausnahme beendet wird.
  • LOG_ALL_CALLS: Protokolliert alle Aufrufe von untergeordneten Workflows oder Bibliotheksfunktionen und deren Ergebnisse.
  • LOG_NONE: Kein Aufruf-Logging.
• ENV_KEY und ENV_VALUE: optional. Eine Zuordnung von Schlüssel/Wert-Paaren von Umgebungsvariablen, z. B. { "month": "January", "day": "Monday"}. Weitere Informationen finden Sie unter Umgebungsvariablen verwenden.
• SOURCE_CODE: die Definition des minimierten Workflows. Beispiel: {\"main\":{\"params\":[\"input\"],\"steps\":[{\"returnOutput\":{\"return\":\"Hello\"}}]}}.
• LOCATION: die Region, in der der Workflow bereitgestellt wird, z. B. us-central1.
• UPDATE_FIELDS: Optional. Eine durch Kommas getrennte Liste von Feldern, die aktualisiert werden sollen. Wenn nicht angegeben, wird der gesamte Workflow aktualisiert. Beispiel: description,callLogLevel.

JSON-Text anfordern:

{
  "name": "WORKFLOW_NAME",
  "description": "DESCRIPTION",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "serviceAccount": "SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com",
  "cryptoKeyName": "ENCRYPT_KEY",
  "callLogLevel": "CALL_LOGGING_LEVEL",
  "userEnvVars": {"ENV_KEY":"ENV_VALUE"},
  "sourceContents": "SOURCE_CODE"
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

cat > request.json << 'EOF'
{
  "name": "WORKFLOW_NAME",
  "description": "DESCRIPTION",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "serviceAccount": "SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com",
  "cryptoKeyName": "ENCRYPT_KEY",
  "callLogLevel": "CALL_LOGGING_LEVEL",
  "userEnvVars": {"ENV_KEY":"ENV_VALUE"},
  "sourceContents": "SOURCE_CODE"
}
EOF

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://workflows.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME?updateMask="UPDATE_FIELDS""

@'
{
  "name": "WORKFLOW_NAME",
  "description": "DESCRIPTION",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "serviceAccount": "SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com",
  "cryptoKeyName": "ENCRYPT_KEY",
  "callLogLevel": "CALL_LOGGING_LEVEL",
  "userEnvVars": {"ENV_KEY":"ENV_VALUE"},
  "sourceContents": "SOURCE_CODE"
}
'@  | Out-File -FilePath request.json -Encoding utf8

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://workflows.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME?updateMask="UPDATE_FIELDS"" | Select-Object -Expand Content

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation.

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.workflows.v1.OperationMetadata",
    "createTime": "2023-12-05T14:06:06.338390918Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME",
    "verb": "update",
    "apiVersion": "v1"
  },
  "done": false
}

Wenn der Wert von "done" false ist, ist der Vorgang noch aktiv.

Console

1. Öffnen Sie in der Google Cloud Console die Seite Workflows.

   Zur Seite "Workflows"

2. Klicken Sie auf den Namen des Workflows, den Sie löschen möchten, und dann auf delete Löschen.

3. Geben Sie den Namen des Workflows ein, wenn Sie aufgefordert werden, das Löschen zu bestätigen.

4. Klicken Sie auf Bestätigen.

gcloud

1. Öffnen Sie ein Terminalfenster.

2. Suchen Sie den Namen des Workflows, den Sie löschen möchten. Wenn Sie den Namen des Workflows nicht kennen, können Sie den folgenden Befehl eingeben, um alle Workflows aufzulisten:

   gcloud workflows list
   

3. Löschen Sie einen Workflow mit dem Befehl gcloud workflows delete:

   gcloud workflows delete WORKFLOW_NAME
   

   Ersetzen Sie WORKFLOW_NAME durch den Namen Ihres Workflows.

REST

Verwenden Sie die Methode projects.locations.workflows.delete, um einen Workflow mit einem angegebenen Namen zu löschen.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

• WORKFLOW_NAME: der Name des Workflows, den Sie löschen möchten.
• PROJECT_ID: Ihre Google Cloud-Projekt-ID.
• LOCATION: die Region, in der der Workflow bereitgestellt wird, z. B. us-central1.

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://workflows.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://workflows.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME" | Select-Object -Expand Content

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.workflows.v1.OperationMetadata",
    "createTime": "2023-12-05T14:06:06.338390918Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME",
    "verb": "delete",
    "apiVersion": "v1"
  },
  "done": false
}

Wenn der Wert von "done" false ist, ist der Vorgang noch aktiv.