Method: organizations.protectedResources.search

Muestra metadatos sobre los recursos protegidos por el CryptoKey de Cloud KMS determinado en la organización de Cloud determinada.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
scope

string

Obligatorio. Es el nombre del recurso de la organización. Ejemplo: organizations/123

La autorización requiere el siguiente permiso IAM en el recurso especificado scope:

  • cloudkms.protectedResources.search

Parámetros de consulta

Parámetros
cryptoKey

string

Obligatorio. El nombre del recurso de CryptoKey.

La autorización requiere el siguiente permiso IAM en el recurso especificado cryptoKey:

  • cloudkms.cryptoKeys.get
pageSize

integer

La cantidad máxima de recursos que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán 500 recursos como máximo. El valor máximo es 500; los valores superiores a 500 se forzarán a 500.

pageToken

string

Un token de página, recibido desde una llamada KeyTrackingService.SearchProtectedResources anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a KeyTrackingService.SearchProtectedResources deben coincidir con la llamada que proporcionó el token de la página.

resourceTypes[]

string

Opcional. Una lista de los tipos de recursos que busca esta solicitud. Si está vacío, se buscará en todos los tipos de recursos de los que se puede hacer un seguimiento.

También se admiten expresiones regulares. Por ejemplo:

  • compute.googleapis.com.* crea instantáneas de los recursos cuyo tipo comienza con compute.googleapis.com.
  • .*Image crea una instantánea de los recursos cuyo tipo termina con Image.
  • .*Image.* de recursos de instantáneas cuyo tipo contiene Image.

Consulta RE2 para ver todas las sintaxis de expresiones regulares admitidas. Si la expresión regular no coincide con ningún tipo de recurso admitido, se mostrará un error INVALID_ATTRIBUTE.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Mensaje de respuesta para KeyTrackingService.SearchProtectedResources.

Representación JSON
{
  "protectedResources": [
    {
      object (ProtectedResource)
    }
  ],
  "nextPageToken": string
}
Campos
protectedResources[]

object (ProtectedResource)

Recursos protegidos para esta página.

nextPageToken

string

Un token que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.