Method: projects.locations.datastores.list

指定されたプロジェクトとロケーションの Datastore リソースの一覧を取得します。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
parent

string

必須。Datastore をクエリするビジネスのリソース名。リソース名は、https://cloud.google.com/apis/design/resource_names の規則に従ったスキームレス URI です。例: projects/my-project/locations/us-central1

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

  • vmwareengine.datastores.list

クエリ パラメータ

パラメータ
pageSize

integer

省略可。1 ページで返される結果の最大件数。最大値は 1,000 に強制変換されます。このフィールドのデフォルト値は 500 です。

pageToken

string

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

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

filter

string

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

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

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

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

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

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

string

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

requestId

string

省略可。リクエスト ID は有効な UUID でなければなりません。ただし、ゼロ UUID(00000000-0000-0000-0000-000000000000)はサポートされていません。

リクエストの本文

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

レスポンスの本文

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

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

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

object (Datastore)

Datastore のリスト。

nextPageToken

string

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

unreachable[]

string

到達できないリソース。

認可スコープ

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

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

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