Method: projects.locations.privateClouds.upgrades.list

指定されたプライベート クラウドの過去、進行中、今後の Upgrades を一覧表示します。

HTTP リクエスト

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

この URL では gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。指定されたプライベート クラウド リソース名の Upgrades のリストをクエリします。リソース名は、https://cloud.google.com/apis/design/resource_names の規則に従ったスキームレス URI です。（例: projects/my-project/locations/us-west1-a/privateClouds/my-cloud）。

認可には、指定されたリソース parent に対する次の IAM の権限が必要です。

  • vmwareengine.upgrades.list

クエリ パラメータ

パラメータ
pageSize

integer

1 ページで返される Upgrades の最大数。サービスが返すリソースの数は、この値よりも少ないことがあります。最大値は 1,000 に強制変換されます。このフィールドのデフォルト値は 500 です。
pageToken

string

前回の upgrades.list 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページ分割を行う場合、upgrades.list に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。
filter

string

レスポンスで返されるリソースに一致するフィルタ式。式では、フィールド名、比較演算子、フィルタリングに使用する値を指定する必要があります。値は文字列、数値、またはブール値にする必要があります。比較演算子は、=、!=、>、< のいずれかである必要があります。

たとえば、アップグレードのリストをフィルタリングする場合、name != "example-upgrade1" を指定して example-upgrade1 という名前のアップグレードを除外できます。

ネストされたフィールドをフィルタすることもできます。

複数の式でフィルタするには、各式を個別に括弧で囲みます。次に例を示します。

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

デフォルトでは、各式は AND 式です。ただし、AND 式と OR 式は明示的に含めることができます。次に例を示します。

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

string

リストの結果を特定の順序で並べ替えます。デフォルトでは、返される結果は name の昇順で並べ替えられます。orderBy="name desc" を使用して、name 値に基づいて結果を降順に並べ替えることもできます。現在、name による並べ替えのみがサポートされています。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

VmwareEngine.ListUpgrades に対するレスポンス メッセージです。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "upgrades": [
    {
      object (Upgrade)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
フィールド
upgrades[]

object (Upgrade)

Upgrades のリスト。
nextPageToken

string

次のページを取得するために pageToken として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。
unreachable[]

string

到達できないリソースのリスト。

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、Authentication Overview をご覧ください。