Deployments: list

特定のプロジェクトのすべてのデプロイメントを一覧表示します。こちらから今すぐお試しいただけます。

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名 値 説明
パスパラメータ
project string このリクエストのプロジェクト ID。
省略可能なクエリ パラメータ
filter string レスポンスに含まれるリソースをフィルタリングするフィルタ式。式には、フィールド名、比較演算子、フィルタに使用する値を指定する必要があります。値は文字列、数値、またはブール値にする必要があります。比較演算子は「=」、「! =」、「>」、「<」のいずれかです。

たとえば、Compute Engine インスタンスをフィルタする場合は、「name != example-instance」を指定して、「example-instance」という名前のインスタンスを除外できます。

ネストされたフィールドをフィルタすることもできます。たとえば、自動再起動のスケジュールが設定されていないインスタンスのみを含めるように、scheduling.automaticRestart = false を指定できます。ネストされたフィールドのフィルタリングを使用して、リソースラベルに基づいてフィルタリングできます。

複数の式でフィルタするには、式をそれぞれかっこで囲んで指定します。たとえば、次のようにします。 ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` デフォルトでは、各式は「AND」式です。ただし、「AND」式と「OR」式は明示的に含めることができます。例: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
maxResults unsigned integer ページごとに返される結果の最大数。使用可能な結果数が maxResults より大きい場合、Compute Engine は、後続のリスト リクエストで結果の次のページを取得するために使用できる nextPageToken を返します。有効な値は 0 ～ 500 です。（デフォルト: 500）
orderBy string リストの結果を特定の順序で並べ替えます。デフォルトでは、結果はリソース名に基づいて英数字順に返されます。

「orderBy="creationTimestamp desc"」を使用して、作成タイムスタンプに基づいて結果を降順に並べ替えることもできます。これにより、creationTimestamp フィールドに基づいて結果が時系列の逆順（最新の結果が最初）に並べ替えられます。これを使用して、オペレーションなどのリソースを並べ替え、最新のオペレーションが最初に返されるようにします。

現在、サポートされているのは「name」または「creationTimestamp desc」による並べ替えのみです。
pageToken string 使用するページトークンを指定します。前のリスト リクエストから返された nextPageToken に pageToken を設定して、次のページの結果を取得します。

承認

このリクエストは、少なくとも次のうち 1 つのスコープによる承認が必要です。

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

リクエストの本文

このメソッドにはリクエストの本文を指定しないでください。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "deployments": [
    deployments Resource
  ],
  "nextPageToken": string
}
プロパティ名 値 説明 メモ
deployments[] list 出力専用。このレスポンスに含まれるデプロイメント。
nextPageToken string 出力専用。長すぎるため切り捨てられたリスト リクエストを続けて取得するために使用されるトークン。