Resources: list

Requer autorização

Lista todos os recursos em uma determinada implantação. Faça o teste agora.

Solicitação

Solicitação HTTP

GET https://www.googleapis.com/deploymentmanager/v2/projects/project/global/deployments/deployment/resources

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
deployment string O nome da implantação dessa solicitação.
project string O código do projeto dessa solicitação.
Parâmetros de consulta opcionais
filter string Uma expressão de filtro que filtra os recursos listados na resposta. A expressão precisa especificar o nome do campo, um operador de comparação e o valor que você quer usar para filtrar. O valor precisa ser uma string, um número ou um booleano. O operador de comparação precisa ser =, !=, > ou <.

Por exemplo, se você estiver filtrando instâncias do Compute Engine, poderá excluir instâncias com o nome example-instance especificando name != example-instance.

Também é possível filtrar campos aninhados. Por exemplo, é possível especificar scheduling.automaticRestart = false para incluir instâncias apenas se elas não estiverem programadas para reinicializações automáticas. É possível usar a filtragem em campos aninhados para filtrar com base em rótulos de recursos.

Para filtrar várias expressões, forneça cada uma delas separadamente entre parênteses. Por exemplo, (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake"). Por padrão, cada expressão é uma expressão AND. No entanto, você pode incluir expressões AND e OR explicitamente. Por exemplo, (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true).
maxResults unsigned integer O número máximo de resultados por página que é retornado. Se o número de resultados disponíveis for maior que maxResults, o Compute Engine vai retornar um nextPageToken que pode ser usado para acessar a próxima página de resultados em solicitações de lista subsequentes. Os valores aceitos vão de 0 a 500. (Padrão: 500)
orderBy string Classifica os resultados da lista em uma determinada ordem. Por padrão, eles são retornados em ordem alfanumérica, com base no nome do recurso.

Também é possível classificar os resultados em ordem decrescente com base no carimbo de data/hora de criação usando orderBy="creationTimestamp desc". Isso classifica os resultados com base no campo creationTimestamp em ordem cronológica inversa (o resultado mais recente primeiro). Use isso para classificar recursos como operações para que a operação mais recente seja retornada primeiro.

No momento, só é possível classificar por name ou creationTimestamp desc.
pageToken string Especifica um token de página a ser usado. Defina pageToken como o nextPageToken retornado por uma solicitação de lista anterior para receber a próxima página de resultados.

Autorização

Esta solicitação requer autorização com pelo menos um dos seguintes escopos (leia mais sobre autenticação e autorização).

Escopo
https://www.googleapis.com/auth/ndev.cloudman.readonly
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/ndev.cloudman
https://www.googleapis.com/auth/cloud-platform.read-only

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

Se bem-sucedido, este método retornará um corpo de resposta com a seguinte estrutura:

{
  "resources": [
    resources Resource
  ],
  "nextPageToken": string
}
Nome da propriedade Valor Descrição Observações
resources[] list Os recursos contidos na resposta dessa lista.
nextPageToken string Um token usado para continuar uma solicitação de lista truncada.

Testar

Use o Explorador de APIs a seguir para chamar este método em dados reais e veja a resposta. Se você preferir, teste o Explorador independente.