Assets auflisten

Auf dieser Seite erfahren Sie, wie Sie den Dienst von Cloud Asset Inventory zur Auflistung von Assets verwenden. Mit der Cloud Asset Inventory API können Sie eine paginierte Liste der Assets zu einem bestimmten Zeitstempel abrufen.

Hinweise

Aktivieren Sie die Cloud Asset API, damit Sie über die Google Cloud CLI auf Cloud Asset Inventory zugreifen können. Die API muss nur für das Projekt aktiviert werden, über das Sie Cloud Asset API-Befehle ausführen.

Cloud Asset Inventory API aktivieren
Installieren Sie die Google Cloud CLI auf Ihrem lokalen Client.
Prüfen Sie, ob Ihr Konto eine der folgenden Rollen für das Projekt oder die Organisation hat, für das bzw. die Sie Assets auflisten möchten.
- roles/cloudasset.viewer
- roles/cloudasset.owner

Konto konfigurieren

Zum Aufrufen der Cloud Asset API muss Ihrem Konto die entsprechende Berechtigung für die (übergeordnete) Stammressource sein. Das ist ein Projekt oder eine Organisation mit den Assets, die Sie auflisten möchten. Für jeden ContentType in der Anfrage ist die folgende Berechtigung erforderlich:

Inhaltstyp		Berechtigung
gcloud-Name	REST-Name
`access-policy`	`ACCESS_POLICY`	`cloudasset.assets.listAccessPolicy`
`content-type-unspecified`	`CONTENT_TYPE_UNSPECIFIED`	`cloudasset.assets.listResource`
`iam-policy`	`IAM_POLICY`	`cloudasset.assets.listIamPolicy`
`org-policy`	`ORG_POLICY`	`cloudasset.assets.listOrgPolicy`
`os-inventory`	`OS_INVENTORY`	`cloudasset.assets.listOSInventories`
`relationship`	`RELATIONSHIP`	`cloudasset.assets.listResource`
`resource`	`RESOURCE`	`cloudasset.assets.listResource`

Wenn Ihrem Konto die Rolle Cloud Asset Viewer (roles/cloudasset.viewer), oder die Rolle Cloud Asset Owner (roles/cloudasset.owner) oder die Basisrolle Owner (roles/owner) auf dem Ressourcenstamm zugewiesen wurde, verfügt es bereits über ausreichende Berechtigungen zum Aufrufen der Cloud Asset API. Andernfalls führen Sie die Schritte auf der Seite Berechtigungen konfigurieren aus.

Assets auflisten

Stellen Sie eine der folgenden Anfragen, um mit der Cloud Asset API Assets und ihre Beziehungen zu einem bestimmten Zeitpunkt in einem Projekt, einem Ordner oder einer Organisation aufzulisten.

Assets in einem Projekt, einem Ordner oder einer Organisation einschließlich aller Ressourcenmetadaten auflisten

gcloud

Projekte

gcloud asset list \
    --project=PROJECT_ID \
    --asset-types=ASSET_TYPE_1,ASSET_TYPE_2,... \
    --content-type=resource \
    --snapshot-time="SNAPSHOT_TIME"

Geben Sie folgende Werte an:

PROJECT_ID: Die ID des Projekts, dessen Assets Sie auflisten möchten.
ASSET_TYPE: Optional. Eine durch Kommas getrennte Liste der suchbaren Asset-Typen. RE2-kompatible reguläre Ausdrücke werden unterstützt. Wenn der reguläre Ausdruck mit keinem unterstützten Asset-Typ übereinstimmt, wird der Fehler INVALID_ARGUMENT zurückgegeben.
SNAPSHOT_TIME: Optional. Der Zeitpunkt, zu dem Sie einen Snapshot Ihrer Assets erstellen möchten. Der Wert muss die aktuelle Zeit oder ein Zeitpunkt sein, der nicht mehr als 35 Tage in der Vergangenheit liegt. Wenn nicht angegeben, wird ein Snapshot zum aktuellen Zeitpunkt erstellt. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes.

Entfernen Sie das Flag --content-type, um Ressourcenmetadaten auszuschließen.

Ordner

Assets in einem Ordner auflisten, einschließlich aller Ressourcenmetadaten:

gcloud asset list \
    --folder=FOLDER_ID \
    --asset-types=ASSET_TYPE_1,ASSET_TYPE_2,... \
    --content-type=resource \
    --snapshot-time="SNAPSHOT_TIME"

Geben Sie folgende Werte an:

FOLDER_ID: Die ID des Ordners, dessen Assets Sie auflisten möchten.
Google Cloud-Ordner-ID ermitteln
Console

Führen Sie die folgenden Schritte aus, um eine Google Cloud-Ordner-ID zu ermitteln:

Öffnen Sie die Google Cloud Console.

Zur Google Cloud Console

Klicken Sie in der Menüleiste auf das Wechsler-Feld.

Klicken Sie auf das Feld Auswählen aus und wählen Sie Ihre Organisation aus.

Suchen Sie nach dem Namen Ihres Ordners. Die Ordner-ID wird neben dem Ordnernamen angezeigt.
gcloud-CLI

Mit dem folgenden Befehl können Sie eine Google Cloud-Ordner-ID auf Organisationsebene abrufen:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dabei kann TOP_LEVEL_FOLDER_NAME eine vollständige oder teilweise Stringübereinstimmung sein. Entfernen Sie die Option --format, um weitere Informationen zu den gefundenen Ordnern zu sehen.

Um die ID eines Ordners in einem anderen Ordner abzurufen, listen Sie die Unterordner auf:

gcloud resource-manager folders list --folder=FOLDER_ID
ASSET_TYPE: Optional. Eine durch Kommas getrennte Liste der suchbaren Asset-Typen. Reguläre Ausdrücke werden unterstützt. Wenn der reguläre Ausdruck mit keinem unterstützten Asset-Typ übereinstimmt, wird der Fehler INVALID_ARGUMENT zurückgegeben.
SNAPSHOT_TIME: Optional. Der Zeitpunkt, zu dem Sie einen Snapshot Ihrer Assets erstellen möchten. Der Wert muss die aktuelle Zeit oder ein Zeitpunkt sein, der nicht mehr als 35 Tage in der Vergangenheit liegt. Wenn nicht angegeben, wird ein Snapshot zum aktuellen Zeitpunkt erstellt. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes.

Entfernen Sie das Flag --content-type, um Ressourcenmetadaten auszuschließen.

Organisationen

Assets in einer Organisation auflisten, einschließlich aller Ressourcenmetadaten:

gcloud asset list \
    --organization=ORGANIZATION_ID \
    --asset-types=ASSET_TYPE_1,ASSET_TYPE_2,... \
    --content-type=resource \
    --snapshot-time="SNAPSHOT_TIME"

Geben Sie folgende Werte an:

ORGANIZATION_ID: Die ID der Organisation, deren Assets Sie auflisten möchten.
Google Cloud-Organisations-ID ermitteln
Console

Führen Sie die folgenden Schritte aus, um eine Google Cloud-Organisations-ID zu ermitteln:

Öffnen Sie die Google Cloud Console.

Zur Google Cloud Console

Klicken Sie in der Menüleiste auf das Wechsler-Feld.

Klicken Sie auf das Feld Auswählen aus und wählen Sie Ihre Organisation aus.

Klicken Sie auf den Tab Alle. Die Organisations-ID wird neben dem Namen der Organisation angezeigt.
gcloud-CLI

Mit dem folgenden Befehl können Sie eine Google Cloud-Organisations-ID abrufen:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
ASSET_TYPE: Optional. Eine durch Kommas getrennte Liste der suchbaren Asset-Typen. Reguläre Ausdrücke werden unterstützt. Wenn der reguläre Ausdruck mit keinem unterstützten Asset-Typ übereinstimmt, wird der Fehler INVALID_ARGUMENT zurückgegeben.
SNAPSHOT_TIME: Optional. Der Zeitpunkt, zu dem Sie einen Snapshot Ihrer Assets erstellen möchten. Der Wert muss die aktuelle Zeit oder ein Zeitpunkt sein, der nicht mehr als 35 Tage in der Vergangenheit liegt. Wenn nicht angegeben, wird ein Snapshot zum aktuellen Zeitpunkt erstellt. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes.

Entfernen Sie das Flag --content-type, um Ressourcenmetadaten auszuschließen.

REST

curl -X POST \
     -H "X-HTTP-Method-Override: GET" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "contentType": "RESOURCE",
          "assetTypes": [
            "ASSET_TYPE_1",
            "ASSET_TYPE_2",
            "..."
          ],
          "readTime": "SNAPSHOT_TIME",
          "pageToken": "PAGE_TOKEN"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE/assets

Hinweis: Dies ist eine GET-Methode. Der Server akzeptiert jedoch keinen Textkörper für GET-Methoden und die Anfrage-URL ist ebenfalls längenbegrenzt. Verwenden Sie stattdessen POST und legen Sie als Header X-HTTP-Method-Override: GET fest, um Fehler zu vermeiden.

Geben Sie folgende Werte an:

ASSET_TYPE: Optional. Ein Array mit suchbaren Asset-Typen. Reguläre Ausdrücke werden unterstützt. Wenn der reguläre Ausdruck mit keinem unterstützten Asset-Typ übereinstimmt, wird der Fehler INVALID_ARGUMENT zurückgegeben.
SNAPSHOT_TIME: Optional. Der Zeitpunkt, zu dem Sie einen Snapshot Ihrer Assets erstellen möchten. Die Angabe erfolgt im RFC 3339-Format. Der Wert muss die aktuelle Zeit oder ein Zeitpunkt sein, der nicht mehr als 35 Tage zurückliegt. Wenn nicht angegeben, wird ein Snapshot zum aktuellen Zeitpunkt erstellt.
PAGE_TOKEN: Optional. Lange Anfrageantworten werden über mehrere Seiten getrennt. Dieses Schlüssel/Wert-Paar ist für die erste Seite nicht erforderlich. Nachfolgende Seiten können jedoch mit dem nextPageToken der vorherigen Antwort aufgerufen werden.
SCOPE: Ein Bereich kann ein Projekt, ein Ordner oder eine Organisation sein.

Zulässige Werte:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Google Cloud-Projektnummer ermitteln
  Console
  
  Führen Sie die folgenden Schritte aus, um eine Google Cloud-Projektnummer zu ermitteln:
  
  Rufen Sie in der Google Cloud Console die Seite Dashboard auf.
  
  Zu Google Dashboard
  
  Klicken Sie in der Menüleiste auf das Wechsler-Feld.
  
  Wählen Sie Ihre Organisation im Feld Auswählen aus aus und suchen Sie dann nach dem Namen Ihres Projekts.
  
  Klicken Sie auf den Projektnamen, um zu diesem Projekt zu wechseln. Die Projektnummer wird auf der Karte Projektinformationen angezeigt.
  
  gcloud-CLI
  
  Mit dem folgenden Befehl können Sie eine Google Cloud-Projektnummer abrufen:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Google Cloud-Ordner-ID ermitteln
  Console
  
  Führen Sie die folgenden Schritte aus, um eine Google Cloud-Ordner-ID zu ermitteln:
  
  Öffnen Sie die Google Cloud Console.
  
  Zur Google Cloud Console
  
  Klicken Sie in der Menüleiste auf das Wechsler-Feld.
  
  Klicken Sie auf das Feld Auswählen aus und wählen Sie Ihre Organisation aus.
  
  Suchen Sie nach dem Namen Ihres Ordners. Die Ordner-ID wird neben dem Ordnernamen angezeigt.
  
  gcloud-CLI
  
  Mit dem folgenden Befehl können Sie eine Google Cloud-Ordner-ID auf Organisationsebene abrufen:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dabei kann TOP_LEVEL_FOLDER_NAME eine vollständige oder teilweise Stringübereinstimmung sein. Entfernen Sie die Option --format, um weitere Informationen zu den gefundenen Ordnern zu sehen.
  
  Um die ID eines Ordners in einem anderen Ordner abzurufen, listen Sie die Unterordner auf:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Google Cloud-Organisations-ID ermitteln
  Console
  
  Führen Sie die folgenden Schritte aus, um eine Google Cloud-Organisations-ID zu ermitteln:
  
  Öffnen Sie die Google Cloud Console.
  
  Zur Google Cloud Console
  
  Klicken Sie in der Menüleiste auf das Wechsler-Feld.
  
  Klicken Sie auf das Feld Auswählen aus und wählen Sie Ihre Organisation aus.
  
  Klicken Sie auf den Tab Alle. Die Organisations-ID wird neben dem Namen der Organisation angezeigt.
  
  gcloud-CLI
  
  Mit dem folgenden Befehl können Sie eine Google Cloud-Organisations-ID abrufen:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Entfernen Sie das Schlüssel/Wert-Paar contentType, um Ressourcenmetadaten auszuschließen.

Bestimmte Beziehungen in einem Projekt, einem Ordner oder einer Organisation auflisten

gcloud

Projekte

gcloud asset list \
    --project=PROJECT_ID \
    --content-type=relationship \
    --relationship-types=INSTANCE_TO_INSTANCEGROUP \
    --snapshot-time="SNAPSHOT_TIME"

Geben Sie folgende Werte an:

PROJECT_ID: Die ID des Projekts, dessen Assets Sie auflisten möchten.
SNAPSHOT_TIME: Optional. Der Zeitpunkt, zu dem Sie einen Snapshot Ihrer Assets erstellen möchten. Der Wert muss die aktuelle Zeit oder ein Zeitpunkt sein, der nicht mehr als 35 Tage in der Vergangenheit liegt. Wenn nicht angegeben, wird ein Snapshot zum aktuellen Zeitpunkt erstellt. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes.

Entfernen Sie das Flag --relationship-types, um alle Beziehungen in einem Projekt aufzulisten.

Ordner

gcloud asset list \
    --folder=FOLDER_ID \
    --content-type=relationship \
    --relationship-types=INSTANCE_TO_INSTANCEGROUP \
    --snapshot-time="SNAPSHOT_TIME"

Geben Sie folgende Werte an:

FOLDER_ID: Die ID des Ordners, dessen Assets Sie auflisten möchten.
Google Cloud-Ordner-ID ermitteln
Console

Führen Sie die folgenden Schritte aus, um eine Google Cloud-Ordner-ID zu ermitteln:

Öffnen Sie die Google Cloud Console.

Zur Google Cloud Console

Klicken Sie in der Menüleiste auf das Wechsler-Feld.

Klicken Sie auf das Feld Auswählen aus und wählen Sie Ihre Organisation aus.

Suchen Sie nach dem Namen Ihres Ordners. Die Ordner-ID wird neben dem Ordnernamen angezeigt.
gcloud-CLI

Mit dem folgenden Befehl können Sie eine Google Cloud-Ordner-ID auf Organisationsebene abrufen:

gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"

Dabei kann TOP_LEVEL_FOLDER_NAME eine vollständige oder teilweise Stringübereinstimmung sein. Entfernen Sie die Option --format, um weitere Informationen zu den gefundenen Ordnern zu sehen.

Um die ID eines Ordners in einem anderen Ordner abzurufen, listen Sie die Unterordner auf:

gcloud resource-manager folders list --folder=FOLDER_ID
SNAPSHOT_TIME: Optional. Der Zeitpunkt, zu dem Sie einen Snapshot Ihrer Assets erstellen möchten. Der Wert muss die aktuelle Zeit oder ein Zeitpunkt sein, der nicht mehr als 35 Tage in der Vergangenheit liegt. Wenn nicht angegeben, wird ein Snapshot zum aktuellen Zeitpunkt erstellt. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes.

Entfernen Sie das Flag --relationship-types, um alle Beziehungen in einem Ordner aufzulisten.

Organisationen

gcloud asset list \
    --organization=ORGANIZATION_ID \
    --content-type=relationship \
    --relationship-types=INSTANCE_TO_INSTANCEGROUP \
    --snapshot-time="SNAPSHOT_TIME"

Geben Sie folgende Werte an:

ORGANIZATION_ID: Die ID der Organisation, deren Assets Sie auflisten möchten.
Google Cloud-Organisations-ID ermitteln
Console

Führen Sie die folgenden Schritte aus, um eine Google Cloud-Organisations-ID zu ermitteln:

Öffnen Sie die Google Cloud Console.

Zur Google Cloud Console

Klicken Sie in der Menüleiste auf das Wechsler-Feld.

Klicken Sie auf das Feld Auswählen aus und wählen Sie Ihre Organisation aus.

Klicken Sie auf den Tab Alle. Die Organisations-ID wird neben dem Namen der Organisation angezeigt.
gcloud-CLI

Mit dem folgenden Befehl können Sie eine Google Cloud-Organisations-ID abrufen:

gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
SNAPSHOT_TIME: Optional. Der Zeitpunkt, zu dem Sie einen Snapshot Ihrer Assets erstellen möchten. Der Wert muss die aktuelle Zeit oder ein Zeitpunkt sein, der nicht mehr als 35 Tage in der Vergangenheit liegt. Wenn nicht angegeben, wird ein Snapshot zum aktuellen Zeitpunkt erstellt. Informationen zu Zeitformaten finden Sie unter gcloud topic datetimes.

Entfernen Sie das Flag --relationship-types, um alle Beziehungen in einer Organisation aufzulisten.

REST

curl -X POST \
     -H "X-HTTP-Method-Override: GET" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
          "contentType": "RELATIONSHIP",
          "relationshipTypes": "INSTANCE_TO_INSTANCEGROUP",
          "readTime": "SNAPSHOT_TIME",
          "pageToken": "PAGE_TOKEN"
         }' \
     https://cloudasset.googleapis.com/v1/SCOPE/assets

Geben Sie folgende Werte an:

SNAPSHOT_TIME: Optional. Der Zeitpunkt, zu dem Sie einen Snapshot Ihrer Assets erstellen möchten. Die Angabe erfolgt im RFC 3339-Format. Der Wert muss die aktuelle Zeit oder ein Zeitpunkt sein, der nicht mehr als 35 Tage zurückliegt. Wenn nicht angegeben, wird ein Snapshot zum aktuellen Zeitpunkt erstellt.
PAGE_TOKEN: Optional. Lange Anfrageantworten werden über mehrere Seiten getrennt. Dieses Schlüssel/Wert-Paar ist für die erste Seite nicht erforderlich. Nachfolgende Seiten können jedoch mit dem nextPageToken der vorherigen Antwort aufgerufen werden.
SCOPE: Ein Bereich kann ein Projekt, ein Ordner oder eine Organisation sein.

Zulässige Werte:
- projects/PROJECT_ID
- projects/PROJECT_NUMBER
  Google Cloud-Projektnummer ermitteln
  Console
  
  Führen Sie die folgenden Schritte aus, um eine Google Cloud-Projektnummer zu ermitteln:
  
  Rufen Sie in der Google Cloud Console die Seite Dashboard auf.
  
  Zu Google Dashboard
  
  Klicken Sie in der Menüleiste auf das Wechsler-Feld.
  
  Wählen Sie Ihre Organisation im Feld Auswählen aus aus und suchen Sie dann nach dem Namen Ihres Projekts.
  
  Klicken Sie auf den Projektnamen, um zu diesem Projekt zu wechseln. Die Projektnummer wird auf der Karte Projektinformationen angezeigt.
  
  gcloud-CLI
  
  Mit dem folgenden Befehl können Sie eine Google Cloud-Projektnummer abrufen:
  
  gcloud projects describe PROJECT_ID --format="value(projectNumber)"
- folders/FOLDER_ID
  Google Cloud-Ordner-ID ermitteln
  Console
  
  Führen Sie die folgenden Schritte aus, um eine Google Cloud-Ordner-ID zu ermitteln:
  
  Öffnen Sie die Google Cloud Console.
  
  Zur Google Cloud Console
  
  Klicken Sie in der Menüleiste auf das Wechsler-Feld.
  
  Klicken Sie auf das Feld Auswählen aus und wählen Sie Ihre Organisation aus.
  
  Suchen Sie nach dem Namen Ihres Ordners. Die Ordner-ID wird neben dem Ordnernamen angezeigt.
  
  gcloud-CLI
  
  Mit dem folgenden Befehl können Sie eine Google Cloud-Ordner-ID auf Organisationsebene abrufen:
  
  gcloud resource-manager folders list \ --organization=$(gcloud organizations describe ORGANIZATION_NAME \ --format="value(name.segment(1))") \ --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \ --format="value(ID)"
  
  Dabei kann TOP_LEVEL_FOLDER_NAME eine vollständige oder teilweise Stringübereinstimmung sein. Entfernen Sie die Option --format, um weitere Informationen zu den gefundenen Ordnern zu sehen.
  
  Um die ID eines Ordners in einem anderen Ordner abzurufen, listen Sie die Unterordner auf:
  
  gcloud resource-manager folders list --folder=FOLDER_ID
- organizations/ORGANIZATION_ID
  Google Cloud-Organisations-ID ermitteln
  Console
  
  Führen Sie die folgenden Schritte aus, um eine Google Cloud-Organisations-ID zu ermitteln:
  
  Öffnen Sie die Google Cloud Console.
  
  Zur Google Cloud Console
  
  Klicken Sie in der Menüleiste auf das Wechsler-Feld.
  
  Klicken Sie auf das Feld Auswählen aus und wählen Sie Ihre Organisation aus.
  
  Klicken Sie auf den Tab Alle. Die Organisations-ID wird neben dem Namen der Organisation angezeigt.
  
  gcloud-CLI
  
  Mit dem folgenden Befehl können Sie eine Google Cloud-Organisations-ID abrufen:
  
  gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"

Entfernen Sie das Schlüssel/Wert-Paar relationshipTypes, um alle Beziehungen in einem Projekt aufzulisten.

Assets auflisten

Hinweise

Konto konfigurieren

Assets auflisten

Assets in einem Projekt, einem Ordner oder einer Organisation einschließlich aller Ressourcenmetadaten auflisten

gcloud

Projekte

Ordner

Assets in einem Ordner auflisten, einschließlich aller Ressourcenmetadaten:

Console

gcloud-CLI

Organisationen

Assets in einer Organisation auflisten, einschließlich aller Ressourcenmetadaten:

Console

gcloud-CLI

REST

Console

gcloud-CLI

Console

gcloud-CLI

Console

gcloud-CLI

Bestimmte Beziehungen in einem Projekt, einem Ordner oder einer Organisation auflisten

gcloud

Projekte

Ordner

Console

gcloud-CLI

Organisationen

Console

gcloud-CLI

REST

Console

gcloud-CLI

Console

gcloud-CLI

Console

gcloud-CLI