Method: projects.locations.serverTlsPolicies.list

列出指定專案和位置中的 ServerTlsPolicies。

HTTP 要求

GET https://networksecurity.googleapis.com/v1beta1/{parent=projects/*/locations/*}/serverTlsPolicies

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

路徑參數

參數
parent

string

這是必要旗標，專案和位置 (應列出 ServerTlsPolicies)，格式為 projects/*/locations/{location}。

授權需要指定資源 parent 的下列 IAM 權限：

  • networksecurity.serverTlsPolicies.list

查詢參數

參數
pageSize

integer

每次呼叫要傳回的 ServerTlsPolicy 數量上限。
pageToken

string

最後一個 ListServerTlsPoliciesResponse 傳回的值表示這是先前 serverTlsPolicies.list 呼叫的延續，且系統應傳回下一頁資料。
returnPartialSuccess

boolean

(選用步驟) 將這個欄位設為 true，要求就會選擇傳回可連線的資源，並在 [ListServerTlsPoliciesResponse.unreachable] 欄位中加入無法連線的資源名稱。只有在跨集合讀取時 (例如 parent 設為 "projects/example/locations/-" 時)，才能使用 true。

要求主體

要求主體必須為空白。

回應主體

伺服器 TlsPolicies.list 方法傳回的回應。

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

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

object (ServerTlsPolicy)

ServerTlsPolicy 資源清單。
nextPageToken

string

如果可能還有其他結果，則會納入 nextPageToken。如要取得下一組結果，請再次呼叫這個方法，並將 nextPageToken 的值做為 pageToken。
unreachable[]

string

無法連線的資源。當要求選擇加入 returnPartialSuccess 並跨集合讀取時 (例如嘗試列出所有支援地點的所有資源)，系統會填入這個欄位。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。