Ordner erstellen

MitGoogle Cloud -Ordnern können Sie Projekte in einer Ressourcenhierarchie gruppieren und organisieren. Mit Ordnern können Sie administrative Aufgaben delegieren, umgebungsspezifische Organisationsrichtlinien erzwingen und die Kostenverwaltung abteilungsübergreifend optimieren.

Als Knoten in der Google Cloud -Ressourcenhierarchie können Ordner Projekte, andere Ordner oder eine Kombination aus beiden unter einer Organisationsressource enthalten. Außerdem können Sie damit Ressourcen gruppieren, die gemeinsame IAM-Rollen (Identity and Access Management), Ablehnungsrichtlinien oder Organisationsrichtlinien haben. Ein Ordner kann zwar mehrere untergeordnete Ordner oder Ressourcen enthalten, aber jeder Ordner oder jede Ressource kann nur ein übergeordnetes Element haben.

Beispiel für eine Ordnerhierarchie

Im folgenden Diagramm enthält die Organisationsressource „Company“ Ordner für „Standard Workloads“, „Regulated Workloads“ und „Shared infrastructure“. Unter „Regulierte Arbeitslasten“ sind die Ordner nach Umgebung in „Nicht-Produktionsumgebung“ und „Produktionsumgebung“ unterteilt. Der Ordner „Produktionsumgebung“ ist weiter in die Ordner „Customer-Facing (Restricted)“ und „Internal-Only (Standard)“ unterteilt, um richtlinienorientierte Zugriffssteuerungen zu erzwingen. Projekte wie „Testprojekt“, „Entwicklungsprojekt“ und „Produktionsprojekt“ enthalten die für das Projekt erforderlichen Ressourcen. Dies bietet ein hohes Maß an Flexibilität beim Zuweisen von Zulassungs-, Ablehnungs- oder Organisationsrichtlinien mit der richtigen Granularität.

Mit Zulassungs- und Ablehnungsrichtlinien auf Ordnerebene können Sie den Zugriff auf die im Ordner enthaltenen Ressourcen steuern. Wenn einem Nutzer beispielsweise die Rolle Compute-Instanzadministrator für einen Ordner zugewiesen wird, hat er die Rolle Compute-Instanzadministrator für alle Projekte im Ordner.

Hinweis

Ordnerfunktionen sind nur für Kunden von Google Workspace und Cloud Identity verfügbar, die eine Organisationsressource haben. Weitere Informationen zum Abrufen einer Organisationsressource finden Sie unter Organisationsressource abrufen.

Wenn Sie ermitteln möchten, wie Sie Ordner optimal nutzen, empfehlen wir folgende Vorgehensweisen:

1. Lesen Sie den Abschnitt Zugriffssteuerung für Ordner mit IAM. In diesem Thema wird beschrieben, wie Sie steuern können, wer welchen Zugriff auf Ordner und die darin enthaltenen Ressourcen hat.
2. Machen Sie sich damit vertraut, wie Ordnerberechtigungen festgelegt werden. Ordner unterstützen unterschiedliche IAM-Rollen. Wenn Sie Berechtigungen so einrichten möchten, dass Nutzer die Struktur ihrer Projekte sehen können, weisen Sie der gesamten Domain die Rollen Organization Viewer und Folder Viewer auf der Ebene der Organisationsressource zu. Wenn Sie die Sichtbarkeit auf Zweige Ihrer Ordnerhierarchie beschränken möchten, weisen Sie die Rolle Ordnerbetrachter für den Ordner oder die Ordner zu, die Nutzer sehen sollen.
3. Erstellen Sie Ordner. Wenn Sie die Organisation Ihrer Cloud-Ressourcen planen, empfehlen wir, mit einem einzelnen Ordner als Sandbox zu beginnen. Dort können Sie ausprobieren, welche Hierarchie für Ihre Organisationsressource am sinnvollsten ist. Stellen Sie sich Ordner als getrennte Einheiten für Ressourcen vor, denen Sie Anknüpfungspunkte und Konfigurationsrichtlinien zuweisen. Sie können Ordner erstellen, deren Ressourcen zu unterschiedlichen Abteilungen gehören. Diesen Ordnern weisen Sie Administratorrollen zu, um Administratorrechte zu delegieren. Mit Ordnern lassen sich auch Ressourcen gruppieren, die zu Anwendungen oder anderen Umgebungen, beispielsweise für Entwicklung, Produktion oder Testzwecke, gehören. Sie können diese unterschiedlichen Szenarien mit verschachtelten Ordnern umsetzen.

Eine gängige Situation ist das Erstellen von Ordnern, die wiederum zusätzliche Ordner oder Projekte enthalten, wie oben in der Ressourcenhierarchie gezeigt. Diese Struktur wird als Ordnerhierarchie bezeichnet. Beachten Sie beim Erstellen einer Ordnerhierarchie Folgendes:

• Sie können Ordner bis zu 10 Ebenen (zehn) tief verschachteln.
• Ein übergeordneter Ordner kann maximal 300 Ordner enthalten. Dies bezieht sich nur auf direkt untergeordnete Ordner. Diese untergeordneten Ordner können wiederum weitere Ordner oder Projekte enthalten.
• Der Anzeigename jedes Ordners muss innerhalb einer Hierarchieebene eindeutig sein.

Berechtigungen zum Verwalten von Ordnern einrichten

Wenn Sie auf Ordner zugreifen und diese verwalten möchten, weisen Sie bestimmten Nutzergruppen ordnerspezifische IAM-Rollen zu. Weitere Informationen zu diesen Rollen finden Sie unter Zugriffssteuerung für Ordner mit IAM. In unseren Best Practices finden Sie außerdem nützliche Tipps, um die optimale Konfiguration für Ihre Ordnerberechtigungen zu ermitteln.

Zum Verwalten von Ordnern für Ihre gesamte Organisationsressource benötigen Sie die Rolle Folder Admin. Ein Nutzer mit dieser Rolle kann IAM-Berechtigungen für Ordner erstellen, bearbeiten, löschen, verschieben und ändern. Außerdem hat er die Möglichkeit, Projekte zwischen Ordnern zu verschieben.

Anfänglich kann nur der Organisationsadministrator die Rolle Ordneradministrator“ für die Organisationsressource zuweisen. Nachfolgende Konten, denen diese Rolle zugewiesen wird, können sie anderen Konten zuweisen.

So richten Sie Ordnerberechtigungen ein:

Console

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

   Zur Seite „Ressourcen verwalten“

2. Wenn das Infofeld nicht geöffnet ist, klicken Sie auf Infofeld ansehen.
3. Maximieren Sie in der Tabelle Ressourcen die Organisation, die den Ordner enthält.
4. Wählen Sie in der Liste der Ressourcen unter der Organisation den Ordner aus, den Sie verwalten möchten.
5. Klicken Sie im Infofeld auf Hauptkonto hinzufügen.
6. Geben Sie im Feld Hauptkonten hinzufügen die E-Mail-Adresse ein, der Sie Berechtigungen gewähren möchten.
7. Wählen Sie im Menü Rolle auswählen die Kategorie Resource Manager und dann die Rolle aus, die Sie zuweisen möchten, z. B. Folder Admin.
8. Klicken Sie auf Speichern, um die neue Rolle zuzuweisen.

gcloud

Führen Sie den folgenden Befehl aus, um einem Hauptkonto die Rolle Ordneradministrator mit der Google Cloud CLI zuzuweisen:

    gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
    --member=user:USER_ID \
    --role=roles/resourcemanager.folderAdmin

REST

Die JSON-Anfrage:

request_json= '{ policy: { version: "1", bindings: [ { role: "roles/folderAdmin",
members: [ "user:[e-mail]", ] }, { role: "roles/folderCreator",
members: [ "user:[e-mail]", ] } , { role: "roles/folderMover",
members: [ "user:[e-mail]", ] } , ] } }'

Die curl-Anfrage:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/ORGANIZATION_NAME:setIamPolicy

Ersetzen Sie ORGANIZATION_NAME durch den Namen der Organisation, deren Zulassungsrichtlinie festgelegt wird, z. B. organizations/123.

Ordner erstellen

Für das Erstellen von Ordnern benötigen Sie auf der übergeordneten Ebene die Rolle Ordneradministrator oder Ordnerersteller. Wenn Sie beispielsweise Ordner auf Organisationsebene erstellen möchten, benötigen Sie eine dieser Rollen auf Organisationsebene.

Einem neu erstellten Ordner muss ein Name zugewiesen werden. Für Ordnernamen gelten die folgenden Kriterien:

• Der Name kann Buchstaben, Zahlen, Leerzeichen, Bindestriche und Unterstriche enthalten.
• Der Anzeigename des Ordners muss mit einem Buchstaben oder einer Zahl beginnen und enden.
• Der Name muss zwischen 3 und 30 Zeichen lang sein.
• Der Name muss innerhalb einer Hierarchieebene eindeutig sein.

So erstellen Sie einen Ordner:

Console

So erstellen Sie Ordner:

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

   Zur Seite "Ressourcen verwalten"

2. Klicken Sie auf Ordner erstellen und wählen Sie eine der folgenden Optionen aus:

   • Google Cloud-Standardordner: Eine Standard-Ordnerressource.
   • Konformer Ordner: Ein Assured Workloads-Ordner, der zusätzliche regulatorische, regionale oder hoheitliche Kontrollen für Google Cloud -Ressourcen bietet. Wenn Sie diese Option auswählen, werden Sie zu Assured Workloads weitergeleitet, um einen Ordner zu erstellen.

3. Geben Sie im Feld Ordnername den Namen Ihres neuen Ordners ein.

4. Klicken Sie unter Übergeordnete Ressource auf Durchsuchen und wählen Sie die Organisationsressource oder den Ordner aus, in dem Sie den neuen Ordner erstellen möchten.

   1. Klicken Sie auf Erstellen.

gcloud

Ordner können programmatisch mit der Google Cloud CLI erstellt werden.

Führen Sie den folgenden Befehl aus, um mit dem gcloud-Befehlszeilentool einen Ordner unter der Organisationsressource zu erstellen.

gcloud resource-manager folders create \
   --display-name=DISPLAY_NAME \
   --organization=ORGANIZATION_ID

Mit dem folgenden Befehl erstellen Sie einen Ordner unter einem anderen Ordner:

gcloud resource-manager folders create \
   --display-name=DISPLAY_NAME \
   --folder=FOLDER_ID

Ersetzen Sie Folgendes:

• DISPLAY_NAME: der Anzeigename des Ordners. Zwei Ordner mit demselben übergeordneten Element können nicht denselben Anzeigenamen haben. Der Anzeigename muss mit einem Buchstaben oder einer Ziffer beginnen und enden. Er kann Buchstaben, Ziffern, Leerzeichen, Binde- und Unterstriche enthalten und darf nicht mehr als 30 Zeichen umfassen.
• ORGANIZATION_ID: die ID der übergeordneten Organisationsressource, wenn das übergeordnete Element eine Organisationsressource ist.
• FOLDER_ID: die ID des übergeordneten Ordners, wenn das übergeordnete Element ein Ordner ist.

API

Ordner können mit einer API-Anfrage erstellt werden.

Die JSON-Anfrage:

request_json= '{
  display_name: DISPLAY_NAME,
  parent: ORGANIZATION_NAME
}'

Die curl-Anfrage für die Ordnererstellung:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/folders

Wobei:

• DISPLAY_NAME: Der Anzeigename des neuen Ordners, z. B. „Mein toller Ordner“.
• ORGANIZATION_NAME: der Name der Organisationsressource, unter der Sie den Ordner erstellen, z. B. organizations/123.

Die Antwort auf die Ordnererstellung:

Wenn ein Aufruf einen Vorgang erfolgreich registriert, enthält der Antworttext eine Instanz von „Operation“.

{
  "name": "operations/fc.123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "CREATE"
  }
}

Die curl-Anfrage zum Abrufen des Vorgangs:

curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fc.123456789

Die Antwort auf das Abrufen des Vorgangs:

{
  "name": "operations/fc.123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "CREATE"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
    "name": "folders/12345",
    "parent": "organizations/123",
    "displayName": "DISPLAY_NAME",
    "lifecycleState": "ACTIVE",
    "createTime": "2017-07-19T23:29:26.018Z",
    "updateTime": "2017-07-19T23:29:26.046Z"
  }
}

Tags beim Erstellen von Ordnern hinzufügen

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Mit Tags können Sie Annotationen für Ressourcen erstellen. Sie können Tags beim Erstellen von Ordnern hinzufügen. Dazu müssen Sie die Rolle Tag-Nutzer zuweisen. Weitere Informationen zu den in dieser Rolle enthaltenen Berechtigungen finden Sie unter Tags erstellen und verwalten. Sie können den Namespace für die Tag-Schlüssel/Wert-Paare nur auf eine der folgenden Arten hinzufügen:

gcloud

Führen Sie den folgenden Befehl aus, um Tags beim Erstellen eines Ordners hinzuzufügen:

  gcloud resource-manager folders create \
      --display-name=DISPLAY_NAME \
      --organization=ORGANIZATION_ID\
      --tags=KEY_VALUE_PAIRS

Ersetzen Sie Folgendes:

• DISPLAY_NAME: der Anzeigename des Ordners.
• ORGANIZATION_ID: die eindeutige Kennung der übergeordneten Organisationsressource.
• KEY_VALUE_PAIRS: eine durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die Sie Ihrer Ressource zuweisen können. Ein Beispiel für kommagetrennte Schlüssel/Wert-Paare ist 123/environment=production, 456/create=testresource.

REST

Das folgende Snippet ist eine JSON-Anfrage, mit der ein Ordner erstellt und Tags hinzugefügt werden.

  POST https://cloudresourcemanager.googleapis.com/v3/folders/
  Authorization: *************
  Content-Type: application/json

  {
    "display_name": "our-folder-456",
    "parent": "organizations/123",
    "tags": {
      "123/environment": "production",
      "123/costCenter": "marketing"
    }
  }

Ordner-ID abrufen

Sie können die ID eines Ordners über die Google Cloud Console oder die Google Cloud CLI abrufen.

Console

1. Öffnen Sie in der Google Cloud Console die Seite Ressourcen verwalten.
2. Suchen Sie den Ordner in der Ressourcenliste. Die Ordner-ID wird in der Spalte ID neben dem Anzeigenamen des Ordners angezeigt.

gcloud

Führen Sie den folgenden Befehl aus, um die Ordner-ID zu ermitteln:

gcloud resource-manager folders list --organization=ORGANIZATION_ID

Weitergabeverzögerung

Wenn Sie einen neuen Ordner erstellen, kann es einige Zeit dauern, bis er in unseren globalen Systemen verteilt und in der Google Cloud Console sichtbar wird. Diese Verzögerung wird in der Regel innerhalb weniger Minuten behoben, kann aber in seltenen Fällen länger dauern. Sie können die Erstellung des Ordners sofort mit dem gcloud-Befehlszeilentool oder der API prüfen.

Ordner löschen

Zum Löschen eines Ordners benötigen Sie die Rolle „Ordneradministrator“ (roles/resourcemanager.folderAdmin) oder „Folder Editor“ (roles/resourcemanager.folderEditor). Der Ordner muss leer sein, bevor Sie ihn löschen können. Eine ausführliche Anleitung finden Sie unter Ordner löschen.

Zugriff auf Ordner konfigurieren

Wenn Sie den Zugriff auf Ordner konfigurieren möchten, benötigen Sie die Rolle Folder IAM Administrator oder Folder Admin auf der übergeordneten Ebene.

Console

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

   Zur Seite "Ressourcen verwalten"

2. Klicken Sie links oben auf die Drop-down-Liste Organisation und wählen Sie Ihre Organisationsressource aus.

3. Klicken Sie das Kästchen neben dem Projekt an, für das Sie die Berechtigungen ändern möchten.

   1. Geben Sie auf der rechten Seite im Bereich Infofeld unter Berechtigungen die E-Mail-Adressen der Mitglieder ein, die Sie hinzufügen möchten.

   2. Wählen Sie in der Drop-down-Liste Rolle auswählen die Rolle aus, die Sie diesen Mitgliedern zuweisen möchten.

   3. Klicken Sie auf Hinzufügen. Es wird eine Benachrichtigung angezeigt, die das Hinzufügen oder Aktualisieren der neuen Rolle der Mitglieder bestätigt.

gcloud

Sie können den Zugriff auf Ordner programmatisch über die Google Cloud CLI oder die REST API konfigurieren.

gcloud resource-manager folders \
    add-iam-policy-binding FOLDER_ID \
    --member=user:[e-mail] \
    --role=roles/resourcemanager.folderEditor

gcloud resource-manager folders \
    add-iam-policy-binding FOLDER_ID \
    --member=user:[e-mail] \
    --role=roles/resourcemanager.folderViewer

Alternativ:

gcloud resource-manager folders \
    set-iam-policy FOLDER_ID POLICY_FILE

Ersetzen Sie Folgendes:

• FOLDER_ID: die ID des neuen Ordners
• POLICY_FILE: der Pfad zu einer Richtliniendatei für den Ordner

API

Mit der Methode setIamPolicy wird die Zugriffssteuerungsrichtlinie für einen Ordner festgelegt und alle vorhandenen Richtlinien werden ersetzt. Das Feld resource sollte der Ressourcenname des Ordners sein, z. B. folders/1234.

 request_json= '{
   policy: {
     version: "1",
     bindings: [
       {
         role: "roles/resourcemanager.folderEditor",
         members: [
           "user:[e-mail]",
           "user:[e-mail]",
         ]
       }
     ]
   }
 }'

Die curl-Anfrage:

   curl -X POST -H "Content-Type: application/json" \
   -H "Authorization: Bearer ${bearer_token}" \
   -d "$request_json" \
   https://cloudresourcemanager.googleapis.com/v3/FOLDER_ID:setIamPolicy

Ersetzen Sie FOLDER_ID durch den Namen des Ordners, dessen IAM-Richtlinie festgelegt wird, z. B. folders/123.

Vorgänge mit langer Ausführungszeit verarbeiten

Bestimmte Ordnervorgänge wie das Erstellen oder Migrieren werden von Google Cloud asynchron verarbeitet, da sie global weitergegeben werden müssen. Mit dem Flag --async können Sie verhindern, dass Ihr Terminal oder Ihre Automatisierungsskripts blockiert werden.

Wenn dieses Flag verwendet wird, gibt der Befehl sofort ein Objekt für Vorgänge mit langer Ausführungszeit (LRO) zurück. Sie können dann den operation_id verwenden, um den Abschluss nach Bedarf abzufragen. Das Flag --async wird nur für die Befehle folders create und folders move unterstützt.

So verwenden Sie das Flag:

1. Starten Sie eine asynchrone Aufgabe. Beispielbefehl:

   gcloud resource-manager folders create \
       --display-name="Test Async Folder" \
       --organization=2518 \
       --async
   

   Die Ausgabe enthält einen Vorgangsnamen (z.B. fc.8572) und zeigt done: false an.

   Beispielantwort:

   name: operations/fc.8572
   metadata:
   operation_type: CREATE
   display_name: Awe-Inspiring Async Folder
   destination_parent: organizations/2518
   done: false
   

2. Vorgangsstatus prüfen. Prüfen Sie mit dem Befehl operations describe und der im vorherigen Schritt angegebenen ID, ob die Aufgabe abgeschlossen ist.

   gcloud beta resource-manager operations describe fc.8572
   

   Sobald done „true“ ist, enthält der Antwortblock die vollständigen Details der neu erstellten Ressource.

   name: operations/fc.8572
   done: true
   response:
     name: folders/6428
     display_name: Awe-Inspiring Async Folder
     lifecycle_state: ACTIVE
     create_time: '2024-03-20T10:00:00Z'
   

Nächste Schritte

• Informationen zum Aufrufen und Aktualisieren von Ordnern
• Projekte in Ordnern verwalten
• Weitere Informationen zu Rollen und Berechtigungen für Ordner
• Alle Ordner und Projekte in Ihrer Ressourcenhierarchie auflisten