Method: organizations.protectedResources.search

Retorna metadados sobre os recursos protegidos pelo CryptoKey do Cloud KMS especificado na organização do Cloud especificada.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
scope

string

Obrigatório. Nome do recurso da organização. Exemplo: organizações/123

A autorização requer a seguinte permissão do IAM no recurso especificado scope:

  • cloudkms.protectedResources.search

Parâmetros de consulta

Parâmetros
cryptoKey

string

Obrigatório. O nome do recurso de CryptoKey.

A autorização requer a seguinte permissão do IAM no recurso especificado cryptoKey:

  • cloudkms.cryptoKeys.get
pageSize

integer

O número máximo de recursos a serem retornados. O serviço pode retornar menos que esse valor. Se não for especificado, no máximo 500 recursos serão retornados. O valor máximo é 500. Valores maiores serão convertidos para 500.

pageToken

string

Um token de página recebido de uma chamada KeyTrackingService.SearchProtectedResources anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para KeyTrackingService.SearchProtectedResources precisam corresponder à chamada que forneceu o token da página.

resourceTypes[]

string

Opcional. Uma lista de tipos de recurso pesquisados por esta solicitação. Se estiver vazio, ela vai pesquisar todos os tipos de recursos rastreáveis.

Expressões regulares também são aceitas. Exemplo:

  • compute.googleapis.com.* recursos de snapshots com tipo que começa com compute.googleapis.com.
  • .*Image de recursos de snapshots com tipo termina em Image.
  • .*Image.* recursos de snapshots com o tipo Image.

Consulte RE2 para ver todas as sintaxes de expressão regular compatíveis. Se a expressão regular não corresponder a nenhum tipo de recurso compatível, um erro INVALID_ARGUMENT será retornado.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Mensagem de resposta para KeyTrackingService.SearchProtectedResources.

Representação JSON
{
  "protectedResources": [
    {
      object (ProtectedResource)
    }
  ],
  "nextPageToken": string
}
Campos
protectedResources[]

object (ProtectedResource)

Recursos protegidos para esta página.

nextPageToken

string

Um token que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.