Ordner ansehen, aktualisieren und löschen

Mit der Google Cloud Console, der Google Cloud CLI oder der Cloud Resource Manager API können Sie Ordnerdetails aufrufen, Anzeigenamen aktualisieren, Ordner verschieben und nicht benötigte Ordner löschen. Durch die Verwaltung von Ordnern können Sie Ihre Ressourcen organisieren und Ihre Google Cloud -Ressourcenhierarchie beibehalten, wenn sich Projekte und Teams weiterentwickeln.

Ordner auflisten und Ordnerdetails ansehen

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 die Rolle „Organisationsbetrachter“ (roles/resourcemanager.organizationViewer).

Console

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

    Zur Seite „Ressourcen verwalten“

  2. In der Ressourcenliste wird Ihre Hierarchie als Tabelle angezeigt. Wählen Sie Ihre Organisationsressource aus.

  3. Klicken Sie auf den Pfeil neben dem Namen der Organisation, um die Strukturansicht zu maximieren und die untergeordneten Ordner aufzurufen.

  4. Wenn Sie Aktionen wie das Verschieben, Löschen oder Aufrufen von Einstellungen ausführen möchten, klicken Sie am Ende der Zeile für die entsprechende Ressource auf Aktionen.

  5. Verwenden Sie die Leiste Filter oben in der Ressourcenliste, um nach Ressourcen anhand des Namens, der ID oder des Labels zu suchen.

Informationen dazu, wie auf der Seite Ressourcen verwalten der Zeitstempel Letzter Zugriff für Ordner und Projekte berechnet wird, finden Sie unter Zeitstempel „Letzter Zugriff“.

Projektauswahl verwenden

Die Projektauswahl befindet sich in der Navigationsleiste und ist nicht Teil der Hauptseite von Resource Manager. Damit können Sie den aktiven globalen Kontext zu einem bestimmten Projekt oder Ordner wechseln.

  1. Klicken Sie auf die Projektauswahl. Wählen Sie im angezeigten Dialogfeld Ihre Organisation aus dem Drop-down-Menü aus, um die Ergebnisse zu filtern.

  2. 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.

gcloud

Mit dem Befehl gcloud 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 sich ansehen möchten.

Verwenden Sie den Befehl gcloud 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 gcloud 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 gcloud projects list mit dem Flag --filter, um die Projekte unter einer Organisations- oder Ordnerressource aufzulisten:

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

Ersetzen Sie RESOURCE_ID durch die ID der Organisations- 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

Zum Aktualisieren des Anzeigenamens eines Ordners benötigen Sie die Rolle „Folder Editor“ (roles/resourcemanager.folderEditor) oder „Ordneradministrator“ (roles/resourcemanager.folderAdmin) für den Ordner.

Console

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

    Zur Seite „Ressourcen verwalten“

  2. Klicken Sie auf den Pfeil neben dem Namen der Organisation, um die Strukturansicht zu maximieren und die untergeordneten Ordner aufzurufen.

  3. Klicken Sie in der Zeile des Ordners, den Sie aktualisieren möchten, am Ende der Zeile auf das Menü Aktionen und dann auf Einstellungen.

  4. Geben Sie den neuen Ordnernamen ein und klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud resource-manager folders update, um den Anzeigenamen eines Ordners zu aktualisieren:

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

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

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.

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

    Öffnen Sie die Google Cloud Console.

  2. Wählen Sie oben links auf der Seite im Drop-down-Menü Organisation Ihre Organisationsressource aus.
  3. Klicken Sie auf die Zeile des Ordners, um ihn aus der Liste der Projekte und Ordner auszuwählen.
  4. Klicken Sie in der Zeile auf das Optionsmenü (die vertikalen Auslassungspunkte) und dann auf Verschieben.
  5. Klicken Sie auf Durchsuchen, um den Ordner auszuwählen, in den dieser Ordner verschoben werden soll.
  6. 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 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 Ordners, der verschoben wird, z. B. „Mein toller 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

Zum Löschen eines Ordners benötigen Sie die Rolle „Folder Editor“ (roles/resourcemanager.folderEditor) oder „Ordneradministrator“ (roles/resourcemanager.folderAdmin) für den Ordner.

Console

  1. Ö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“.

  2. Klicken Sie auf den Pfeil neben dem Namen der Organisation, um die Strukturansicht zu maximieren und die untergeordneten Ordner aufzurufen.

  3. Klicken Sie in der Zeile des Ordners, den Sie löschen möchten, am Ende der Zeile auf das Menü Aktionen und dann auf Löschen.

  4. Geben Sie im Bestätigungsdialogfeld die Ordner-ID oder den Ordnernamen ein 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

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 eine Aufbewahrungsdauer von 30 Tagen vorläufig gelöscht, bevor er endgültig gelöscht wird.

Vorläufig gelöscht: Während der 30-tägigen Aufbewahrungsdauer ist der Ordner zum Löschen markiert und nicht mehr aktiv. In einem vorläufig gelöschten Ordner können Sie keine neuen Projekte oder Unterordner erstellen.

Status „Dauerhaft gelöscht“: Nach 30 Tagen entfernt Google Cloud den Ordner und die zugehörigen Metadaten endgültig. 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 Befehl gcloud resource-manager folders undelete oder der API wiederherstellen.

Voraussetzungen und Einschränkungen

  • Der 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: Zum Löschen oder Wiederherstellen eines Ordners benötigen Sie die Rolle „Folder Editor“ (roles/resourcemanager.folderEditor) oder Ordneradministrator“ (roles/resourcemanager.folderAdmin).

Suchen

Wenn Sie nach Ordnern suchen möchten, die einer bestimmten Abfrage entsprechen, verwenden Sie den Befehl gcloud alpha resource-manager folders search und übergeben Sie Ihre Suchbedingung im Flag --query. Der Suchbereich umfasst alle Ordner, für die Sie eine Leseberechtigung haben.

Wenn Sie beispielsweise nach Ordnern mit Anzeigenamen suchen möchten, die mit vij beginnen, z. B. vijeta oder vijay-folder, führen Sie den folgenden Befehl aus:

gcloud alpha resource-manager folders search --query="displayName:vij*"

Führen Sie den folgenden Befehl aus, um nach Ordnern zu suchen, die zum Löschen vorgemerkt sind:

gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"

Führen Sie den Befehl gcloud alpha resource-manager folders search ohne das Flag --query aus, um alle Ordner zurückzugeben, die Sie aufrufen dürfen:

gcloud alpha resource-manager folders search

Nächste Schritte