Ordner ansehen, aktualisieren und löschen

Auf dieser Seite wird beschrieben, wie Sie Ordnerdetails aufrufen, Ordner-einstellungen aktualisieren und Ordner mit der Google Cloud Console, der Google Cloud CLI oder der API löschen. Hier erfahren Sie, wie Sie Anzeigenamen von Ordnern ändern und die Platzierung von Ordnern in der Hierarchie Ihrer Organisation verwalten.

Ordner auflisten und Ordnerdetails aufrufen

Wenn Sie Ordner auflisten oder Metadaten für einen bestimmten Ordner aufrufen möchten, z. B. den Anzeigenamen, die übergeordnete ID und den Lebenszyklusstatus, benötigen Sie die Rolle „Ordnerbetrachter“ (roles/resourcemanager.folderViewer) oder „Organisationsbetrachter“ (roles/resourcemanager.organizationViewer).

Console

Öffnen Sie in der Google Cloud -Console die Seite Ressourcen verwalten.
Zur Seite „Ressourcen verwalten“
In der Ressourcenliste wird Ihre Hierarchie als Tabelle angezeigt. Wählen Sie Ihre Organisationsressource aus.
Klicken Sie auf den Pfeil neben dem Namen der Organisation, um die Baumansicht zu maximieren und die untergeordneten Ordner aufzurufen.
Wenn Sie Aktionen ausführen möchten, z. B. Einstellungen verschieben, löschen oder aufrufen, klicken Sie am Ende der Zeile für die jeweilige Ressource auf das Aktionen.
Über die Leiste Filter oben in der Ressourcenliste können Sie nach Ressourcen anhand von Name, ID oder Label suchen.

Projektauswahl verwenden

Mit der Projektauswahl in der oberen Navigationsleiste können Sie den aktiven Kontext zu einem bestimmten Projekt oder Ordner wechseln.

Klicken Sie in der oberen Navigationsleiste der Google Cloud Console auf die Projektauswahl. Dies ist das Drop-down-Menü neben dem Google Cloud-Logo.
Wählen Sie im angezeigten Dialogfeld Ihre Organisation aus dem Drop-down-Menü aus, um die Ergebnisse zu filtern.
Suchen Sie in der Hierarchie nach dem Projekt oder Ordner, zu dem Sie wechseln möchten. Wenn Sie in dieser Auswahl auf eine Ressource klicken, ändert sich der globale Kontext. Dies wirkt sich darauf aus, welche Ressourcen auf anderen Dienstseiten (z. B. Compute Engine oder Cloud Storage) sichtbar sind.

Hinweis: In der Projektauswahl können bis zu 4.000 Ressourcen angezeigt werden. Wenn eine Ressource nicht angezeigt wird, obwohl sie angezeigt werden sollte, rufen Sie die Seite Ressourcen verwalten auf und filtern Sie die Liste nach dem Namen dieser Ressource.

gcloud

Mit dem Befehl resource-manager folders describe können Sie Details zu einem Ordner abrufen.

gcloud resource-manager folders describe FOLDER_ID

Ersetzen Sie FOLDER_ID durch die ID des Ordners, den Sie aufrufen möchten.

Verwenden Sie den Befehl resource-manager folders list, um die untergeordneten Ordner einer Organisationsressource aufzulisten.

gcloud resource-manager folders list \
    --organization ORGANIZATION_ID

Ersetzen Sie ORGANIZATION_ID durch die ID der Organisationsressource, für die Sie eine Liste der untergeordneten Ordner aufrufen möchten.

Verwenden Sie den Befehl resource-manager folders list, um die untergeordneten Ordner einer Ordnerressource aufzulisten.

gcloud resource-manager folders list \
    --folder FOLDER_ID

Ersetzen Sie FOLDER_ID durch die ID der Ordnerressource, für die Sie eine Liste der untergeordneten Ordner aufrufen möchten.

Verwenden Sie den Befehl projects list mit dem Argument filter, um die Projekte unter einer Organisationsressource, einer Ordnerressource oder einem Ordner aufzulisten.

gcloud projects list \
    --filter=" parent.id: 'RESOURCE_ID' "

Ersetzen Sie RESOURCE_ID durch die ID der Organisationsressource oder Ordnerressource, für die Sie eine Liste der untergeordneten Projekte aufrufen möchten.

REST

Die curl-Anfrage zum Abrufen von Ordnern:

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

Ersetzen Sie FOLDER_NAME durch den Namen des Ordners, z. B. folders/123.

Die curl-Anfrage zum Auflisten der Ordner:

curl -X GET -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${bearer_token}" \
  https://cloudresourcemanager.googleapis.com/v3/folders?parent=PARENT_NAME

Ersetzen Sie PARENT_NAME durch den Namen der übergeordneten Ressource, unter der Sie den Ordner erstellen, z. B. organizations/123 oder folders/123.

Ordner aktualisieren

Wenn Sie den Anzeigenamen eines Ordners aktualisieren möchten, benötigen Sie für den Ordner die Rolle „Ordnerbearbeiter“ (roles/resourcemanager.folderEditor) oder „Ordneradministrator“ (roles/resourcemanager.folderAdmin).

Console

Öffnen Sie in der Google Cloud -Console die Seite Ressourcen verwalten.
Zur Seite „Ressourcen verwalten“
Klicken Sie auf den Pfeil neben dem Namen der Organisation, um die Baumansicht zu maximieren und die untergeordneten Ordner aufzurufen.
Klicken Sie in der Zeile des Ordners, den Sie aktualisieren möchten, am Ende der Zeile auf das Aktionen-Menü und dann auf Einstellungen.
Geben Sie den neuen Ordnernamen ein und klicken Sie auf Speichern.

gcloud

So aktualisieren Sie den Anzeigenamen eines Ordners:

gcloud resource-manager folders update FOLDER_ID --display-name="NEW_DISPLAY_NAME"

Ersetzen Sie Folgendes:

FOLDER_ID: die ID des Ordners, den Sie aktualisieren möchten.
NEW_DISPLAY_NAME: der neue Anzeigename für den Ordner.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

FOLDER_ID: die Google Cloud Ordner-ID
NEW_DISPLAY_NAME: der neue Anzeigename für den Ordner

HTTP-Methode und URL:

PATCH https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName

JSON-Text der Anfrage:

{
  "displayName": "NEW_DISPLAY_NAME"
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "operations/fc.1234567890abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
    "displayName": "NEW_DISPLAY_NAME",
    "operationType": "UPDATE",
    "resourceName": "folders/FOLDER_ID"
  },
  "done": false
}

Ordner in einen anderen Ordner verschieben

Zum Verschieben eines Ordners in einen anderen Ordner benötigen Sie für beide Ordner die Berechtigung resourcemanager.folders.move.

Console

Das Verschieben von Ordnern in andere Ordner über die Console ähnelt dem Verschieben von Projekten.

Öffnen Sie in der Google Cloud -Console die Seite „Ressourcen verwalten“.
Öffnen Sie die Google Cloud Console
Wählen Sie links oben auf der Seite im Drop-down-Menü Organisation Ihre Organisationsressource aus.
Klicken Sie auf die Zeile Ihres Ordners, um den Ordner aus der Liste der Projekte und Ordner auszuwählen.
Klicken Sie in der Zeile auf das Dreipunkt-Menü (vertikale Ellipsen) und dann auf Verschieben.
Klicken Sie auf Durchsuchen , um den Ordner auszuwählen, in den dieser Ordner verschoben werden soll.
Klicken Sie auf Verschieben.

gcloud

Führen Sie den folgenden Befehl in der Google Cloud CLI aus, um einen Ordner unter die Organisationsressource zu verschieben:

gcloud resource-manager folders move FOLDER_ID \
    --organization=PARENT_ID

Ersetzen Sie Folgendes:

FOLDER_ID: die ID des Ordners, den Sie verschieben möchten.
PARENT_ID: die ID der übergeordneten Organisationsressource.

Mit dem folgenden Befehl verschieben Sie einen Ordner unter einen anderen Ordner:

gcloud resource-manager folders move FOLDER_ID \
    --folder=PARENT_ID

Ersetzen Sie Folgendes:

FOLDER_ID: die ID des Ordners, den Sie verschieben möchten.
PARENT_ID: die ID der übergeordneten Organisationsressource oder des übergeordneten Ordners.

REST

Die JSON-Anfrage:

request_json= '{
   destinationParent: "folders/DESTINATION_FOLDER_ID"
}'

Die curl-Anfrage zum Verschieben des Ordners:

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

Ersetzen Sie Folgendes:

DESTINATION_FOLDER_ID: die ID des Ordners, in den Sie einen anderen Ordner verschieben , z. B. 98765.
DISPLAY_NAME: der Anzeigename des zu verschiebenden Ordners, z. B. „Mein Ordner“.

Die Antwort auf die Ordnerverschiebung:

{
  "name": "operations/fm.1234567890",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "MOVE"
  }
}

Die curl-Anfrage zum Abrufen des Vorgangs:

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

Die Antwort auf das Abrufen des Vorgangs:

{
  "name": "operations/fm.1234567890",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "MOVE"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
    "name": "folders/12345",
    "parent": "folders/98765",
    "displayName": "DISPLAY_NAME",
    "lifecycleState": "ACTIVE",
    "createTime": "2017-07-19T23:29:26.018Z",
    "updateTime": "2017-07-20T00:54:44.295Z"
  }
}

Ordner löschen

Wenn Sie einen Ordner löschen möchten, benötigen Sie für den Ordner die Rolle „Ordnerbearbeiter“ (roles/resourcemanager.folderEditor) oder „Ordneradministrator“ (roles/resourcemanager.folderAdmin).

Console

Öffnen Sie in der Google Cloud -Console die Seite Ressourcen verwalten.
Zur Seite „Ressourcen verwalten“
Wechseln Sie in der Google Cloud -Console zur Seite „Ressourcen verwalten“.
Klicken Sie auf den Pfeil neben dem Namen der Organisation, um die Baumansicht zu maximieren und die untergeordneten Ordner aufzurufen.
Klicken Sie in der Zeile des Ordners, den Sie löschen möchten, am Ende der Zeile auf das Aktionen-Menü und dann auf Löschen.
Geben Sie im Bestätigungsdialogfeld die Ordner-ID oder den Ordnernamen ein, um die Aktion zu bestätigen, und klicken Sie auf Löschen.

gcloud

Führen Sie den folgenden Befehl aus, um einen Ordner zu löschen:

gcloud resource-manager folders delete FOLDER_ID

Ersetzen Sie Folgendes:

FOLDER_ID: die ID des Ordners, den Sie löschen möchten.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

FOLDER_ID: die Google Cloud Ordner-ID

HTTP-Methode und URL:

DELETE https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "operations/fc.1234567890abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
    "operationType": "DELETE",
    "resourceName": "folders/FOLDER_ID"
  },
  "done": false
}

Weitere Informationen

Wenn Sie einen Ordner löschen, wird er für einen Aufbewahrungszeitraum von 30 Tagen vorläufig gelöscht, bevor er endgültig gelöscht wird.

Vorläufig gelöscht: Während des 30-tägigen Aufbewahrungszeitraums ist der Ordner als zu löschen markiert und ist nicht mehr aktiv. Sie können in einem vorläufig gelöschten Ordner keine neuen Projekte oder Unterordner erstellen.

Endgültig gelöscht: Nach 30 Tagen werden der Google Cloud Ordner und seine Metadaten endgültig gelöscht. Diese Aktion kann nicht rückgängig gemacht werden.

Wiederherstellen: Wenn Sie einen Ordner versehentlich löschen, können Sie ihn innerhalb von 30 Tagen mit dem gcloud resource-manager folders undelete Befehl oder der API wiederherstellen.

Voraussetzungen und Einschränkungen

Ordner muss leer sein: Sie können keinen Ordner löschen, der noch aktive Projekte oder Unterordner enthält. Sie müssen zuerst alle untergeordneten Ressourcen verschieben oder löschen.
Erforderliche Berechtigungen: Wenn Sie einen Ordner löschen oder wiederherstellen möchten, benötigen Sie die Rolle „Ordnerbearbeiter“ (roles/resourcemanager.folderEditor) oder „Ordneradministrator“ (roles/resourcemanager.folderAdmin).

Suchen

Verwenden Sie gcloud alpha resource-manager folders search und übergeben Sie die Bedingung im Flag --query, um nach Ordnern zu suchen, die der angegebenen Abfrage entsprechen. Der Suchbereich umfasst alle Ordner, für die der Nutzer die Berechtigung zum Aufrufen hat.

gcloud alpha resource-manager folders search --query="name:vij*"
<table output showing the folders with names starting from vij eg. vijeta, vijay-folder>

gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"
<table output showing folders for which delete has been requested>

Alle Ordner, für die der Nutzer die Berechtigung zum Aufrufen hat, können mit dem Befehl gcloud folders search angezeigt werden.

gcloud folders search
<table output showing all viewable folders>

Nächste Schritte

Informationen zum Verwalten von Projekten in Ordnern
Informationen zu Rollen und Berechtigungen für Ordner

Ordner ansehen, aktualisieren und löschen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Ordner auflisten und Ordnerdetails aufrufen

Console

gcloud

REST

Ordner aktualisieren

Console

gcloud

REST

curl

PowerShell

Ordner in einen anderen Ordner verschieben

Console

gcloud

REST

Ordner löschen

Console

gcloud

REST

curl

PowerShell

Weitere Informationen

Suchen

Nächste Schritte

Ordner ansehen, aktualisieren und löschen