Method: organizations.protectedResources.search

Restituisce i metadati sulle risorse protette dall'elemento CryptoKey di Cloud KMS specificato nell'organizzazione Cloud specificata.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
scope

string

Obbligatorio. Nome della risorsa dell'organizzazione. Esempio: organizzazioni/123

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata scope:

  • cloudkms.protectedResources.search

I parametri di ricerca

Parametri
cryptoKey

string

Obbligatorio. Il nome della risorsa di CryptoKey.

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata cryptoKey:

  • cloudkms.cryptoKeys.get
pageSize

integer

Il numero massimo di risorse da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificati, verranno restituite al massimo 500 risorse. Il valore massimo è 500; i valori superiori a 500 verranno forzati a 500.
pageToken

string

Un token di pagina, ricevuto da una chiamata KeyTrackingService.SearchProtectedResources precedente. Specifica questo valore per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a KeyTrackingService.SearchProtectedResources devono corrispondere alla chiamata che ha fornito il token della pagina.
resourceTypes[]

string

Facoltativo. Un elenco dei tipi di risorse cercati da questa richiesta. Se vuoto, la ricerca verrà eseguita in tutti i tipi di risorse tracciabili.

Sono supportate anche le espressioni regolari. Ad esempio:

  • compute.googleapis.com.* risorse snapshot il cui tipo inizia con compute.googleapis.com.
  • .*Image di risorse snapshot il cui tipo termina con Image.
  • .*Image.* risorse snapshot il cui tipo contiene Image.

Consulta RE2 per informazioni sulla sintassi delle espressioni regolari supportate. Se l'espressione regolare non corrisponde ad alcun tipo di risorsa supportato, verrà restituito un errore INVALID_ARGUMENT.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Messaggio di risposta per KeyTrackingService.SearchProtectedResources.

Rappresentazione JSON 
{
  "protectedResources": [
    {
      object (ProtectedResource)
    }
  ],
  "nextPageToken": string
}
Campi
protectedResources[]

object (ProtectedResource)

Risorse protette per questa pagina.
nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.