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

詳情請參閱驗證總覽一文。