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.resourceLocationsgcp.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
- Ermitteln Sie die Ressourcen-IDs für die Assured Workloads-Ordner, für die Sie Updates aktivieren möchten.
- Weisen Sie IAM-Berechtigungen für die Zielordner und -arbeitslasten von Assured Workloads zu oder prüfen Sie sie.
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:
assuredworkloads.workload.updatefür die Zielarbeitslast, um Updates zu aktivieren. Diese Berechtigung ist in den vordefinierten Rollen Assured Workloads-Bearbeiter (roles/assuredworkloads.editor) und Assured Workloads-Administrator (roles/assuredworkloads.admin) enthalten.assuredworkloads.updates.listfür die Zielarbeitslast, um verfügbare Updates aufzurufen. Diese Berechtigung ist in den vordefinierten Rollen Assured Workloads-Leser (roles/assuredworkloads.reader), Assured Workloads-Bearbeiter (roles/assuredworkloads.editor) und Assured Workloads-Administrator (roles/assuredworkloads.admin) enthalten.assuredworkloads.updates.updatefür die Zielarbeitslast, um verfügbare Updates anzuwenden. Diese Berechtigung ist in den vordefinierten Rollen Assured Workloads-Bearbeiter (roles/assuredworkloads.editor) und Assured Workloads-Administrator (roles/assuredworkloads.admin) enthalten.assuredworkloads.operations.getfür die Zielarbeitslast, um den Status und die Ergebnisse eines Aktualisierungsvorgangs abzurufen. Diese Berechtigung ist in den vordefinierten Rollen Assured Workloads-Leser (roles/assuredworkloads.reader), Assured Workloads-Bearbeiter (roles/assuredworkloads.editor) und Assured Workloads-Administrator (roles/assuredworkloads.admin) enthalten.orgpolicy.policy.getfür den Zielordner, um verfügbare Updates anzuwenden. Diese Berechtigung ist in den vordefinierten Rollen Organization Policy Viewer (roles/orgpolicy.policyViewer) und Organization Policy Administrator (roles/orgpolicy.policyAdmin) enthalten.orgpolicy.policy.setfür den Zielordner, um verfügbare Updates anzuwenden. Diese Berechtigung wird in benutzerdefinierten Rollen nicht unterstützt, ist aber in der vordefinierten Rolle Organization Policy Administrator (roles/orgpolicy.policyAdmin) enthalten.resourcemanager.folders.getIamPolicyundresourcemanager.folders.setIamPolicyfür den Zielordner, um Aktualisierungen zu aktivieren. Diese Berechtigungen sind in der Rolle Folder IAM Admin (roles/resourcemanager.folderIamAdmin) und anderen vordefinierten Rollen mit weitreichenden Berechtigungen enthalten.
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
Rufen Sie in der Google Cloud Console die Seite Assured Workloads auf.
Klicken Sie oben auf der Seite im Bereich Compliance-Updates auf Compliance-Updates aktivieren.
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.comfür eine regionalisierte Arbeitslast in der Regionus-west1undhttps://us-assuredworkloads.googleapis.comfü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-west1oderus. Er entspricht demdata 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:enableComplianceUpdatesArbeitslastupdates ansehen
So rufen Sie Aktualisierungen für Arbeitslasten auf:
Console
Rufen Sie in der Google Cloud Console die Seite Assured Workloads auf.
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.
Klicken Sie unter Verfügbare Updates auf Verfügbare Updates prüfen.
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.comfür eine regionalisierte Arbeitslast in der Regionus-central1undhttps://us-assuredworkloads.googleapis.comfü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-central1oderus. Er entspricht demdata 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
20gesetzt. Der Höchstwert ist100. - 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/updatesWenn 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
Rufen Sie in der Google Cloud Console die Seite Assured Workloads auf.
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.
Klicken Sie unter Verfügbare Updates auf Verfügbare Updates prüfen.
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.
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.comfür eine regionalisierte Arbeitslast in der Regionus-central1undhttps://us-assuredworkloads.googleapis.comfü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-central1oderus. Er entspricht demdata 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.listzurü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-70a1e867fe5bWenn 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 } } } } } } }