アクセス ポリシーを管理

1 つ以上の接続テストの Identity and Access Management（IAM）（アクセス制御）ポリシーを設定または取得できます。さらに、特定の接続テストに対するユーザーやサービス アカウントの権限を表示できます。

このドキュメントでは、Network Management API を使用するアクセス制御の例を示します。 Google Cloud コンソールまたは gcloud コマンドを使用してこの手順を行うには、IAM 入門ガイドをご覧ください。

以降のコマンドに記載されているポリシー バインディングと ETag については、IAM ポリシーの API リファレンスをご覧ください。

接続テストの実行に必要な IAM のロールと権限については、ロールと権限をご覧ください。

アクセス制御ポリシーを設定する

この手順では、指定された接続テストリソースにアクセス制御ポリシーを設定します。

API

networkmanagement.connectivitytests.setIamPolicy メソッドを使用して、USER、ROLE、TEST_ID のアクセス制御ポリシーを設定します。

次の例では、networkmanagement.admin のロールを mytest-1 の [e-mail] にバインドするポリシーを設定します。

 POST https: //networkmanagement.googleapis.com/v1/{resource=projects/*/locations/global/connectivityTests/TEST_ID}:setIamPolicy
   {
     "version": "VERSION",
     "etag": "ETAG",
     "bindings": [{
       "role": "ROLE",
       "members": [
         "PRINCIPAL"
       ]
     }]
   }

次の値を置き換えます。

• TEST_ID: 実行中の接続テスト オブジェクト（テスト）の ID
• VERSION: ポリシーの形式を指定します。有効な値は、0、1、3 のいずれかです。条件付きロール バインディングに影響するオペレーションにはすべて、バージョン 3 を指定する必要があります。
• ETAG: オプティミスティック同時実行制御でポリシーの同時更新による相互上書きを防ぐために使用されます（ETag は BwWbrqiZFRs= などです）。
• ROLE: プリンシパルに割り当てるロール（roles/networkmanagement.admin など）。
• PRINCIPAL: Google Cloud リソースへのアクセスをリクエストする ID（user:[e-mail] など）を指定します。プリンシパル（メンバー）のタイプのリストについては、IAM ポリシーの API リファレンスをご覧ください。

アクセス制御ポリシーを取得する

この手順では、指定された接続テストリソースのアクセス制御ポリシーを取得します。

API

networkmanagement.connectivitytests.getIamPolicy メソッドを使用して、PRINCIPAL、ROLE、TEST_ID のアクセス制御ポリシーを設定します。

次の例では、networkmanagement.admin のロールをmytest-1 の [e-mail] にバインドするポリシーを取得します。

  GET https: //networkmanagement.googleapis.com/v1/{resource=projects/*/locations/global/connectivityTests/TEST_ID}:getIamPolicy
    {
      "version": "VERSION",
      "etag": "ETAG",
      "bindings": [{
        "role": "ROLE",
        "members": [
          "PRINCIPAL"
        ]
      }]
    }

次の値を置き換えます。

• TEST_ID: 実行中の接続テスト オブジェクト（テスト）の ID
• VERSION: ポリシーの形式を指定します。有効な値は、0、1、3 のいずれかです。条件付きロール バインディングに影響するオペレーションにはすべて、バージョン 3 を指定する必要があります。
• ETAG: オプティミスティック同時実行制御でポリシーの同時更新による相互上書きを防ぐために使用されます（ETag は BwWbrqiZFRs= などです）。
• ROLE: プリンシパルに割り当てるロール（roles/networkmanagement.admin など）。
• PRINCIPAL: Google Cloud リソースへのアクセスをリクエストする ID（user:[e-mail] など）を指定します。プリンシパルのタイプのリストについては、IAM ポリシーの API リファレンスをご覧ください。

IAM 権限をテストする

この手順では、接続テストリソースに対してユーザーまたはサービス アカウントが持つ権限を返します。

API

networkmanagement.connectivitytests.testIamPermissions メソッドを使用して、TEST_ID に割り当てられた権限を返します。

次の例では、[e-mail] に mytest-1 に対する networkmanagement.connectivitytests.get 権限があることを確認します。

  POST https://networkmanagement.googleapis.com/v1/{resource=projects/*/locations/global/connectivityTests/TEST_ID}:testIamPermissions
    {
      "permissions": [
        "networkmanagement.connectivitytests.get"
      ]
    }

TEST_ID を、実行中の接続テスト オブジェクト（テスト）の ID に置き換えます。

次のステップ

• 接続テストに関する理解を深める
• 接続テストのトラブルシューティング