Method: organizations.protectedResources.search

Gibt Metadaten zu den Ressourcen zurück, die durch das angegebene Cloud KMS-CryptoKey in der angegebenen Cloud-Organisation geschützt sind.

HTTP-Anfrage

GET https://kmsinventory.googleapis.com/v1/{scope=organizations/*}/protectedResources:search

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
scope

string

Erforderlich. Ressourcenname der Organisation. Beispiel: organizations/123

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource scope erforderlich:

  • cloudkms.protectedResources.search

Suchparameter

Parameter
cryptoKey

string

Erforderlich. Der Ressourcenname von CryptoKey.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource cryptoKey erforderlich:

  • cloudkms.cryptoKeys.get
pageSize

integer

Die maximale Anzahl von Ressourcen, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn keine Vorgabe erfolgt, werden maximal 500 Ressourcen zurückgegeben. Der Maximalwert beträgt 500. Für Werte über 500 wird eine Umwandlung von 500 auf 500 vorgenommen.
pageToken

string

Ein Seitentoken, das von einem vorherigen KeyTrackingService.SearchProtectedResources-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für KeyTrackingService.SearchProtectedResources bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
resourceTypes[]

string

Optional. Eine Liste der Ressourcentypen, nach denen diese Anfrage sucht. Wenn das Feld leer ist, wird in allen verfolgbaren Ressourcentypen gesucht.

Reguläre Ausdrücke werden ebenfalls unterstützt. Beispiel:

  • compute.googleapis.com.* erstellt Snapshots von Ressourcen, deren Typ mit compute.googleapis.com beginnt.
  • .*Image Snapshot-Ressourcen, deren Typ mit Image endet.
  • .*Image.* Snapshot-Ressourcen, deren Typ Image enthält.

Unter RE2 finden Sie die gesamte unterstützte Syntax für reguläre Ausdrücke. Wenn der reguläre Ausdruck mit keinem unterstützten Ressourcentyp übereinstimmt, wird der Fehler INVALID_ ARGUMENT zurückgegeben.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwortnachricht für KeyTrackingService.SearchProtectedResources.

JSON-Darstellung 
{
  "protectedResources": [
    {
      object (ProtectedResource)
    }
  ],
  "nextPageToken": string
}
Felder
protectedResources[]

object (ProtectedResource)

Geschützte Ressourcen für diese Seite.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie in der Authentifizierungsübersicht.