Implantações: lista

Requer autorização

Lista todas as implantações de um determinado projeto.

  •  
  •  

Solicitação

Solicitação HTTP

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

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
project string Código de projeto da solicitação.
Parâmetros de consulta opcionais
filter string Define uma expressão para filtrar os recursos listados no formato filter={expression}. A {expression} precisa estar no formato field_name comparison_string literal_string.

field_name é o nome do campo que você quer comparar. Apenas os tipos atômicos de campo são aceitos (string, número, booleano). A comparison_string precisa ser eq (igual) ou ne (diferente). A literal_string é o valor de string do filtro. O valor literal precisa ser válido para o tipo de campo que você está filtrando (string, número, booleano). Para os campos de string, esse valor é interpretado como uma expressão regular com a sintaxe RE2. Ele precisa corresponder ao campo inteiro.

Por exemplo, para filtrar instâncias que não tenham o nome example-instance, use filter=name ne example-instance.

É possível filtrar campos aninhados. Por exemplo, filtre instâncias que tenham o campo scheduling.automaticRestart definido como true. Use a filtragem nos campos aninhados e aproveite os marcadores para organizar e fazer a pesquisa com base nos valores desses marcadores.

Para filtrar usando várias expressões, forneça cada expressão separada entre parênteses. Por exemplo, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Elas são tratadas como expressões AND, o que significa que os recursos precisam corresponder a todas elas para passar pelos filtros.
maxResults unsigned integer O número máximo de resultados por página que é retornado. Quando esse número é maior que maxResults, um nextPageToken é retornado no Compute Engine para acessar a próxima página nas solicitações de lista seguintes. Os valores aceitáveis são de 0 a 500, inclusive. (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 timestamp de criação usando orderBy="creationTimestamp desc". Isso classifica os resultados com base no campo creationTimestamp em ordem cronológica inversa, ou seja, o mais recente é listado primeiro. Use esse procedimento para classificar recursos como operações para que a mais recente seja retornada primeiro.

Atualmente, 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 acessar 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:

{
  "deployments": [
    deployments Resource
  ],
  "nextPageToken": string
}
Nome da propriedade Valor Descrição Observações
deployments[] list [Saída somente] As implantações contidas nesta resposta.
nextPageToken string [Saída somente] Um token usado para continuar uma solicitação de lista truncada.