メソッド: projects.locations.global.connectivityTests.create

新しい接続テストを作成します。テストを作成すると、ネットワーク到達性の分析が長時間実行オペレーションの一部として実行され、分析が終わると完了します。

ConnectivityTest のエンドポイントの仕様が無効(ネットワークに存在しないリソースが含まれているか、記載されているプロジェクトのネットワーク構成に対する読み取り権限がないなど)の場合、ネットワーク到達性の結果は値 UNKNOWN を返します。

ConnectivityTest のエンドポイント仕様が不完全な場合、ネットワーク到達性の結果は次の値を返します。

AMBIGUOUS

詳細については、接続テストのドキュメントをご覧ください。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
parent

string

必須。作成する接続テストの親リソース: projects/{projectId}/locations/global

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

  • networkmanagement.connectivitytests.create

クエリ パラメータ

パラメータ
testId

string

必須。プロジェクト内の接続テストの論理名。次の制限があります。

  • 使用できるのは小文字、数字、ハイフンのみです。
  • 先頭は英文字でなければなりません。
  • 1〜40 文字でなければなりません。
  • 末尾が数字または英字でなければなりません。
  • プロジェクト内で一意である必要があります

リクエストの本文

リクエストの本文には ConnectivityTest のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Operation のインスタンスが含まれます。

承認スコープ

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

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

詳細については、認証の概要をご覧ください。

試してみる