Method: projects.locations.instances.list

列出指定位置的執行個體。

HTTP 要求

GET https://memcache.googleapis.com/v1beta2/{parent=projects/*/locations/*}/instances

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

這是必要旗標，執行個體位置的資源名稱，格式為：projects/{projectId}/locations/{locationId}，其中 locationId 是指 GCP 區域

查詢參數

參數
pageSize

integer

傳回的項目數量上限。

如未指定，服務會使用預設值 1000。無論 pageSize 值為何，回應都可能包含部分清單，呼叫端應只依據回應的 nextPageToken 判斷是否還有更多執行個體可供查詢。
pageToken

string

先前的 List 要求 (如果有的話) 傳回的 nextPageToken 值。
filter

string

清單篩選器。舉例來說，您可以指定 "name != my-instance"，排除名稱為 my-instance 的所有 Memcached 執行個體。
orderBy

string

將結果排序。支援的值為「name」、「name desc」或「」(未排序)。

要求主體

要求主體必須為空白。

回應主體

對 instances.list 的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "resources": [
    {
      object (Instance)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
欄位
resources[]

object (Instance)

指定位置或所有位置中專案的 Memcached 執行個體清單。

如果要求父項欄位中的 locationId 為「-」，系統會查詢專案可用的所有區域，並彙整結果。
nextPageToken

string

用來擷取下一頁結果的符記；如果清單中沒有其他結果，這個欄位會留空。
unreachable[]

string

無法抵達的地點。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。