Method: projects.locations.keyRings.cryptoKeys.getProtectedResourcesSummary

Gibt aggregierte Informationen zu den Ressourcen zurück, die durch den angegebenen Cloud KMS-CryptoKey geschützt werden. Es werden nur Ressourcen zurückgegeben, die zur selben Cloud-Organisation wie der Schlüssel gehören. Das Projekt mit dem Schlüssel muss zu einer Organisation gehören, damit dieser Aufruf erfolgreich ist.

HTTP-Anfrage

GET https://kmsinventory.googleapis.com/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/**}/protectedResourcesSummary

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname von CryptoKey.

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

  • cloudkms.cryptoKeys.get

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

Informationen zu den Ressourcen aggregieren, die durch einen Cloud KMS-Schlüssel in derselben Cloud-Organisation wie der Schlüssel geschützt werden.

JSON-Darstellung 
{
  "name": string,
  "resourceCount": string,
  "projectCount": integer,
  "resourceTypes": {
    string: string,
    ...
  },
  "cloudProducts": {
    string: string,
    ...
  },
  "locations": {
    string: string,
    ...
  }
}
Felder
name

string

Der vollständige Name der ProtectedResourcesSummary-Ressource. Beispiel: projects/test-project/locations/us/keyRings/test-keyring/cryptoKeys/test-key/protectResourcesSummary
resourceCount

string (int64 format)

Die Gesamtzahl der geschützten Ressourcen in derselben Cloud-Organisation wie der Schlüssel.
projectCount

integer

Die Anzahl der einzelnen Cloud-Projekte in derselben Cloud-Organisation wie der Schlüssel, deren Ressourcen durch den Schlüssel geschützt sind.
resourceTypes

map (key: string, value: string (int64 format))

Die Anzahl der Ressourcen, die durch den Schlüssel geschützt sind, gruppiert nach Ressourcentyp.
cloudProducts

map (key: string, value: string (int64 format))

Die Anzahl der Ressourcen, die durch den Schlüssel geschützt werden, gruppiert nach Cloud-Produkt.
locations

map (key: string, value: string (int64 format))

Die Anzahl der Ressourcen, die durch den Schlüssel geschützt werden, gruppiert nach Region.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.