Arbeitslastupdates anwenden

Auf dieser Seite wird beschrieben, wie Sie Arbeitslastupdates für Assured Workloads-Ordner aktivieren, ansehen und anwenden. Assured Workloads aktualisiert regelmäßig seine Datengrenzen mit neuen Einstellungen und allgemeinen Verbesserungen, z. B. aktualisierten Einschränkungswerten für Organisationsrichtlinien. Mit dieser Funktion können Sie die aktuelle Konfiguration Ihrer Assured Workloads-Ordner mit der neuesten verfügbaren Konfiguration vergleichen und vorgeschlagene Updates anwenden.

Dieses Feature ist standardmäßig für neue Assured Workloads-Ordner aktiviert. Für vorhandene Assured Workloads-Ordner empfehlen wir dringend, die Schritte zum Aktivieren von Arbeitslastupdates auszuführen.

Für diese Funktion fallen keine zusätzlichen Gebühren an und sie hat auch keine Auswirkungen auf das Verhalten des Assured Workloads-Monitorings. Sie werden weiterhin benachrichtigt, wenn Ihr Ordner nicht mehr der aktuellen Konfiguration entspricht, unabhängig davon, ob Updates für die Konfiguration verfügbar sind.

Arbeitslastupdates – Übersicht

Wenn Sie einen neuen Assured Workloads-Ordner erstellen, bestimmt der von Ihnen ausgewählte Datengrenzentyp (z. B. FedRAMP Moderate) die verschiedenen Konfigurationseinstellungen, die auf Ihre Arbeitslast angewendet werden. Einige dieser Einstellungen sind extern in Form von Einschränkungen für Organisationsrichtlinien sichtbar, andere gelten nur für die internen Systeme von Google. Assured Workloads verwendet ein internes Versionsverwaltungssystem für Konfigurationen, um Änderungen für jeden Datengrenzentyp zu verwalten.

Wenn eine neue interne Konfigurationsversion verfügbar ist, vergleicht Assured Workloads die Konfiguration Ihrer Arbeitslast mit der neuen internen Version. Alle Unterschiede werden analysiert und die resultierenden Verbesserungen werden als Update verfügbar, das Sie auf die Konfiguration Ihrer Arbeitslast anwenden können. Wenn solche Verbesserungen die Unterstützung eines neuen Dienstes umfassen, werden möglicherweise auch alle für diesen Dienst erforderlichen Einschränkungen der Organisationsrichtlinie auf Ihre Arbeitslast angewendet.

Verfügbare Assured Workloads-Updates wurden von Google auf die Einhaltung der Anforderungen der Datengrenze Ihrer Arbeitslast überprüft. Es liegt jedoch weiterhin in Ihrer Verantwortung, jedes verfügbare Update zu prüfen, um sicherzustellen, dass es den regulatorischen oder Compliance-Anforderungen Ihrer Organisation entspricht. Weitere Informationen finden Sie unter Gemeinsame Verantwortung in Assured Workloads.

Unterstützte Aktualisierungstypen

Diese Funktion unterstützt das Ansehen und Anwenden der folgenden Arten von Aktualisierungen für einen Assured Workloads-Ordner:

  • Einschränkungen für Organisationsrichtlinien: Alle Einschränkungen für Organisationsrichtlinien, die für Ihre Arbeitslast gelten und von Assured Workloads erzwungen werden, können in ein Arbeitslastupdate aufgenommen werden. Es gelten jedoch die folgenden Ausnahmen:

    • gcp.resourceLocations
    • gcp.restrictCmekCryptoKeyProjects
  • Einführungsphasen für Datengrenzen: Mit dieser Funktion können Sie nur dann Updates ansehen und anwenden, wenn sich eine bestimmte Datengrenze in derselben Einführungsphase befindet wie bei der ersten Bereitstellung. Wenn Sie beispielsweise eine Arbeitslast für eine Datengrenze bereitstellen, während sie sich in der Vorschauphase befindet, und diese Datengrenze später allgemein verfügbar wird, müssen Sie Ihre Arbeitslast zuerst mit der GA-Version neu bereitstellen, bevor Sie Updates anwenden können. Wenn Sie Ihre Arbeitslast nicht noch einmal bereitstellen, können nach dem Versuch, Updates anzuwenden, Fehler oder Compliance-Verstöße auftreten.

Hinweis

Erforderliche IAM-Berechtigungen

Zum Aktivieren, Aufrufen oder Anwenden von Arbeitslastupdates benötigt der Aufrufer IAM-Berechtigungen, entweder mit einer vordefinierten Rolle, die mehr Berechtigungen umfasst, oder einer benutzerdefinierten Rolle, die auf die minimal erforderlichen Berechtigungen beschränkt ist. Die erforderliche Berechtigung orgpolicy.policy.set ist für benutzerdefinierte Rollen nicht verfügbar.

Folgende Berechtigungen sind erforderlich:

Arbeitslastupdates aktivieren

Wenn Sie Arbeitslastupdates aktivieren, wird der Assured Workloads-Dienst-Agent erstellt. Diesem Dienst-Agent wird dann die Rolle Assured Workloads-Dienst-Agent (roles/assuredworkloads.serviceAgent) für den Assured Workloads-Zielordner zugewiesen. Mit dieser Rolle kann der Dienst-Agent nach verfügbaren Updates für den Ordner suchen.

Führen Sie die folgenden Schritte aus, um Arbeitslastupdates zu aktivieren:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Assured Workloads auf.

    Zu „Assured Workloads“

  2. Klicken Sie oben auf der Seite im Bereich Compliance-Updates auf Compliance-Updates aktivieren.

  3. Wenn Sie gefragt werden, ob Sie Compliance-Updates aktivieren möchten, klicken Sie auf Aktivieren.

Arbeitslastupdates sind jetzt für alle Assured Workloads-Ordner in Ihrer Organisation aktiviert.

REST

Mit der Methode enableComplianceUpdates kann Assured Workloads Sie über Aktualisierungen für einen einzelnen Assured Workloads-Ordner benachrichtigen.

HTTP-Methode, URL und Suchparameter:

PUT https://[ENDPOINT_URI]/v1/organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/workloads/[WORKLOAD_ID]:enableComplianceUpdates

Ersetzen Sie die folgenden Platzhalterwerte durch Ihre eigenen:

  • ENDPOINT_URI: Der Dienstendpunkt-URI für Assured Workloads. Dieser URI muss der Endpunkt sein, der dem Standort der Zielarbeitslast entspricht, z. B. https://us-west1-assuredworkloads.googleapis.com für eine regionalisierte Arbeitslast in der Region us-west1 und https://us-assuredworkloads.googleapis.com für eine multiregionale Arbeitslast in den USA.
  • ORGANIZATION_ID: Die Organisations-ID für den Assured Workloads-Ordner, z. B. 919698201234.
  • LOCATION_ID: Der Speicherort des Assured Workloads-Ordners, z. B. us-west1 oder us. Er entspricht dem data region-Wert der Arbeitslast.
  • WORKLOAD_ID: Die ID der Assured Workloads-Arbeitslast, für die Updates aktiviert werden sollen, z. B. 00-701ea036-7152-4780-a867-9f5.

Beispiel:

PUT https://us-west1-assuredworkloads.googleapis.com/v1/organizations/919698298765/locations/us-west1/workloads/00-701ea036-7152-4781-a867-9f5:enableComplianceUpdates

Arbeitslastupdates ansehen

So rufen Sie Aktualisierungen für Arbeitslasten auf:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Assured Workloads auf.

    Zu „Assured Workloads“

  2. Klicken Sie in der Spalte Name auf den Namen des Assured Workloads-Ordners, für den Sie Aktualisierungen aufrufen möchten. Wenn für den Ordner Updates verfügbar sind, können Sie auch auf den Link in der Spalte Updates klicken.

  3. Klicken Sie unter Verfügbare Updates auf Verfügbare Updates prüfen.

  4. Falls verfügbar, werden Updates der Organisationsrichtlinie auf dem Tab Organisationsrichtlinie angezeigt. Prüfen Sie die betroffene Einschränkung der Organisationsrichtlinie und klicken Sie auf Update ansehen, um eine Vorschau der Einschränkungseinstellungen zu sehen, die durch das Update angewendet werden.

REST

Die Methode organizations.locations.workloads.updates.list listet verfügbare Updates für eine Assured Workloads-Arbeitslast auf.

HTTP-Methode, URL und Suchparameter:

GET https://[ENDPOINT_URI]/v1/organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/workloads/[WORKLOAD_ID]/updates?page_size=[PAGE_SIZE]&page_token=[PAGE_TOKEN]

Ersetzen Sie die folgenden Platzhalterwerte durch Ihre eigenen:

  • ENDPOINT_URI: Der Dienstendpunkt-URI für Assured Workloads. Dieser URI muss der Endpunkt sein, der dem Standort der Zielarbeitslast entspricht, z. B. https://us-central1-assuredworkloads.googleapis.com für eine regionalisierte Arbeitslast in der Region us-central1 und https://us-assuredworkloads.googleapis.com für eine multiregionale Arbeitslast in den USA.
  • ORGANIZATION_ID: Die Organisations-ID für den Assured Workloads-Ordner, z. B. 919698201234.
  • LOCATION_ID: Der Speicherort des Assured Workloads-Ordners, z. B. us-central1 oder us. Er entspricht dem data region-Wert der Arbeitslast.
  • WORKLOAD_ID: Die ID der Assured Workloads-Arbeitslast, für die verfügbare Updates aufgelistet werden sollen, z. B. 00-701ea036-7152-4780-a867-9f5.
  • PAGE_SIZE (optional): Begrenzt die Anzahl der Updates, die in der Antwort zurückgegeben werden. Wenn nicht angegeben, wird der Standardwert auf 20 gesetzt. Der Höchstwert ist 100.
  • PAGE_TOKEN (optional): Wenn eine oder mehrere Seiten verfügbar sind, wird in der JSON-Antwort ein Token für die nächste Seite zurückgegeben, z. B. nextPageToken": "chEKD4IBDAid1e-3BhCo68f6AQ. Wenn nicht angegeben, werden keine nachfolgenden Seiten zurückgegeben.

Beispiel:

GET https://us-central1-assuredworkloads.googleapis.com/v1/organizations/919698298765/locations/us-west1/workloads/00-701ea036-7152-4781-a867-9f5/updates

Wenn der Vorgang erfolgreich war, erhalten Sie eine JSON-Antwort ähnlich der folgenden:

{
  "workloadUpdates": [
    {
      "name": "organizations/919698298765/locations/us-central1/workloads/00-701ea036-7152-4781-a867-9f5/updates/5320de45-6c98-41af-b4a0-2ef930b124c3",
      "state": "AVAILABLE",
      "createTime": "2024-10-01T16:33:10.154368Z",
      "updateTime": "2024-10-01T16:33:10.154368Z",
      "details": {
        "orgPolicyUpdate": {
          "appliedPolicy": {
            "resource": "folders/376585579673",
            "constraint": "constraints/gcp.resourceLocations",
            "rule": {
              "values": {
                "allowedValues": [
                  "us-central1",
                ]
              }
            }
          },
          "suggestedPolicy": {
            "resource": "folders/376585579673",
            "constraint": "constraints/gcp.resourceLocations",
            "rule": {
              "values": {
                "allowedValues": [
                  "us-central1",
                  "us-central2",
                  "us-west1",
                ]
              }
            }
          }
        }
      }
    }
  ],
  "nextPageToken": "chEKD4IBDAid1e-3BhCo68f6AQ"
}

Arbeitslastupdates anwenden

Das Anwenden eines Arbeitslastupdates auf eine Arbeitslast ist ein Vorgang mit langer Ausführungszeit. Wenn sich die Arbeitslastkonfiguration nach dem Start des Vorgangs und vor dessen Abschluss ändert, kann ein Fehler auftreten.

Außerdem werden Arbeitslastaktualisierungen regelmäßig anhand der neuesten verfügbaren Konfiguration neu bewertet. In diesem Fall sind möglicherweise sofort nach dem Anwenden eines Updates weitere Updates verfügbar.

So wenden Sie Arbeitslastupdates an:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Assured Workloads auf.

    Zu „Assured Workloads“

  2. Klicken Sie in der Spalte Name auf den Namen des Assured Workloads-Ordners, für den Sie Aktualisierungen aufrufen möchten. Wenn für den Ordner Updates verfügbar sind, können Sie auch auf den Link in der Spalte Updates klicken.

  3. Klicken Sie unter Verfügbare Updates auf Verfügbare Updates prüfen.

  4. Falls verfügbar, werden Updates der Organisationsrichtlinie auf dem Tab Organisationsrichtlinie angezeigt. Prüfen Sie die betroffene Einschränkung der Organisationsrichtlinie und klicken Sie auf Update ansehen, um eine Vorschau der aktualisierten Einschränkungseinstellungen aufzurufen.

  5. Klicken Sie auf Organisationsrichtlinie aktualisieren, um die Aktualisierung anzuwenden.

Der lang andauernde Aktualisierungsvorgang wird gestartet und die neuen Einstellungen für die Organisationsrichtlinie des Ordners werden angewendet.

REST

Die Methode organizations.locations.workloads.updates.apply wendet das angegebene Update für eine Assured Workloads-Arbeitslast an.

HTTP-Methode, URL und Suchparameter:

POST https://[ENDPOINT_URI]/v1/organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/workloads/[WORKLOAD_ID]/updates/[UPDATE_ID]:apply

Ersetzen Sie die folgenden Platzhalterwerte durch Ihre eigenen:

  • ENDPOINT_URI: Der Dienstendpunkt-URI für Assured Workloads. Dieser URI muss der Endpunkt sein, der dem Standort der Zielarbeitslast entspricht, z. B. https://us-central1-assuredworkloads.googleapis.com für eine regionalisierte Arbeitslast in der Region us-central1 und https://us-assuredworkloads.googleapis.com für eine multiregionale Arbeitslast in den USA.
  • ORGANIZATION_ID: Die Organisations-ID für den Assured Workloads-Ordner, z. B. 919698201234.
  • LOCATION_ID: Der Speicherort des Assured Workloads-Ordners, z. B. us-central1 oder us. Er entspricht dem data region-Wert der Arbeitslast.
  • WORKLOAD_ID: Die ID der Assured Workloads-Arbeitslast, für die verfügbare Updates aufgelistet werden sollen, z. B. 00-701ea036-7152-4780-a867-9f5.
  • UPDATE_ID: Die ID des anzuwendenden Updates, ausgewählt aus der Liste der verfügbaren Updates, die von der Methode organizations.locations.workloads.updates.list zurückgegeben wird, z. B. edb84871-833b-45ec-9c00-c9b5c19d2d87.

Anfragetext:

{
  "name":"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/workloads/[WORKLOAD_ID]/updates/[UPDATE_ID]",
  "action": "APPLY"
}

Beispiel:

POST https://us-central1-assuredworkloads.googleapis.com/v1/organizations/919698298765/locations/us-central1/workloads/00-701ea036-7152-4781-a867-9f5/updates/edb84871-833b-45ec-9c00-c9b5c19d2d87:apply

{
  "name": "organizations/919698298765/locations/us-central1/workloads/00-701ea036-7152-4781-a867-9f5/updates/edb84871-833b-45ec-9c00-c9b5c19d2d87",
  "action": "APPLY"
}

Wenn der Vorgang erfolgreich war, erhalten Sie eine JSON-Antwort ähnlich der folgenden:

{
  "name": "organizations/919698298765/locations/us-central1/operations/647b1c77-b9a5-45d2-965e-70a1e867fe5b",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.assuredworkloads.v1.ApplyWorkloadUpdateOperationMetadata",
    "update_name": "organizations/919698298765/locations/us-central1/workloads/00-701ea036-7152-4781-a867-9f5/updates/edb84871-833b-45ec-9c00-c9b5c19d2d87",
    "create_time": "2024-10-01T14:34:30.290896Z",
    "action": "APPLY"
  }
}

Wenn Sie den Status eines lange laufenden Aktualisierungsvorgangs abrufen möchten, verwenden Sie die Vorgangs-ID im Wert name aus der JSON-Antwort. Im vorherigen Beispiel lautet die Vorgangs-ID 647b1c77-b9a5-45d2-965e-70a1e867fe5b. Stellen Sie dann die folgende Anfrage und ersetzen Sie die Platzhalterwerte durch Ihre eigenen:

GET https://[ENDPOINT_URI]/v1/organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/operations/[OPERATION_ID]

Beispiel:

GET https://us-central1-assuredworkloads.googleapis.com/v1/organizations/919698298765/locations/us-central1/operations/647b1c77-b9a5-45d2-965e-70a1e867fe5b

Wenn der Vorgang erfolgreich war, erhalten Sie eine JSON-Antwort ähnlich der folgenden:

{
  "name": "organizations/919698298765/locations/us-central1/operations/647b1c77-b9a5-45d2-965e-70a1e867fe5b",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.assuredworkloads.v1.ApplyWorkloadUpdateOperationMetadata",
    "updateName": "organizations/919698298765/locations/us-central1/workloads/00-701ea036-7152-4781-a867-9f5/updates/edb84871-833b-45ec-9c00-c9b5c19d2d87",
    "createTime": "2024-10-01T13:33:09Z"
    "action": "APPLY"
  },
  "done": true
  "response": {
    "@type": "type.googleapis.com/google.cloud.assuredworkloads.v1.ApplyWorkloadUpdateResponse",
    "appliedUpdate": {
      "name": "organizations/531459884741/locations/us-central1/workloads/00-0b328e90-da70-431e-befc-a4a/updates/db556beb-ce66-4260-bd3b-28115f1ec300",
      "state": "APPLIED",
      "createTime": "2024-10-01T14:31:24.310323Z",
      "updateTime": "2024-10-01T14:34:30.855792Z",
      "details": {
        "orgPolicyUpdate": {
          "appliedPolicy": {
            "resource": "folders/196232301850",
            "constraint": "constraints/compute.disableInstanceDataAccessApis",
            "rule": {
              "enforce": true
            }
          },
          "suggestedPolicy": {
            "resource": "folders/196232301850",
            "constraint": "constraints/compute.disableInstanceDataAccessApis",
            "rule": {
              "enforce": false
            }
          }
        }
      }
    }
  }
}