Method: projects.locations.global.connectivityTests.create

建立新的連線測試。建立測試後，系統會在長時間執行的作業中執行可及性分析，並在分析完成時結束作業。

如果 ConnectivityTest 中的端點規格無效 (例如，包含網路中不存在的資源，或是您沒有所列專案的網路設定讀取權限)，則可達性結果會傳回 UNKNOWN 值。

如果 ConnectivityTest 中的端點規格不完整，可達性結果會傳回以下值：

AMBIGUOUS

詳情請參閱「連線能力測試」說明文件。

HTTP 要求

POST https://networkmanagement.googleapis.com/v1/{parent=projects/*/locations/global}/connectivityTests

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

路徑參數

參數
parent

string

這是必要旗標，要建立的連線能力測試的父項資源：projects/{projectId}/locations/global

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

  • networkmanagement.connectivitytests.create

查詢參數

參數
testId

string

這是必要旗標，專案中 Connectivity Test 的邏輯名稱，並符合下列限制：

  • 只能使用小寫英文字母、數字和連字號。
  • 開頭必須是英文字母。
  • 長度必須介於 1 至 40 個字元之間。
  • 結尾必須是數字或英文字母。
  • 在客戶專案中不得重複

要求主體

要求主體包含 ConnectivityTest 的執行個體。

回應主體

如果成功，回應主體會包含新建立的 Operation 執行個體。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 Authentication Overview。