Method: projects.locations.privateClouds.upgrades.list

Lista os Upgrades passados, em andamento e futuros da nuvem privada especificada.

Solicitação HTTP

GET https://vmwareengine.googleapis.com/v1/{parent=projects/*/locations/*/privateClouds/*}/upgrades

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Consulte uma lista de Upgrades para o nome de recurso da nuvem privada especificada. Os nomes de recursos são URIs sem esquema que seguem as convenções em https://cloud.google.com/apis/design/resource_names. Por exemplo: projects/my-project/locations/us-west1-a/privateClouds/my-cloud

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

  • vmwareengine.upgrades.list

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de Upgrades a serem retornados em uma página. O serviço pode retornar menos recursos do que esse valor. O valor máximo é convertido para 1.000. O valor padrão desse campo é 500.
pageToken

string

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

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

string

Uma expressão de filtro que corresponde aos recursos retornados 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 uma lista de upgrades, poderá excluir aqueles chamados example-upgrade1 especificando name != "example-upgrade1".

Também é possível filtrar campos aninhados.

Para filtrar várias expressões, coloque cada uma entre parênteses. Exemplo:

(name = "example-upgrade")
(createTime > "2021-04-12T08:15:10.40Z")

Por padrão, cada expressão é uma expressão AND. No entanto, é possível incluir expressões AND e OR explicitamente. Exemplo:

(name = "upgrade-1") AND
(createTime > "2021-04-12T08:15:10.40Z") OR
(name = "upgrade-2")
orderBy

string

Classifica os resultados da lista em uma determinada ordem. Por padrão, os resultados retornados são ordenados por name em ordem crescente. Também é possível classificar os resultados em ordem decrescente com base no valor name usando orderBy="name desc". No momento, só é possível ordenar por name.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para VmwareEngine.ListUpgrades.

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

Representação JSON 
{
  "upgrades": [
    {
      object (Upgrade)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
upgrades[]

object (Upgrade)

Uma lista de Upgrades.
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.
unreachable[]

string

Lista de recursos inacessíveis.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.