APIを使ってIPを許可リストに追加 - Cloud

Talend Cloud Management Console for Pipelinesユーザーガイド

Version
Cloud
Language
日本語 (日本)
Product
Talend Cloud
Module
Talend Management Console
Content
デプロイメント > スケジューリング > タスクのスケジューリング
デプロイメント > デプロイ中 > タスクの実行
管理と監視 > プロジェクトの管理
管理と監視 > ユーザーの管理

IP許可リストにIPを追加する場合は、 /v1/management/ip-allowlist/ipsエンドポイントでPOSTメソッドを使います。

この例では、Talend API Testerを使ってAPIクエリーを発行します。Talend API Testerの詳細は、Talend Cloud API Testerユーザーガイドを参照してください。

始める前に

前提条件: IP許可リストが既に存在すること。存在しない場合は、前のセクションで触れた/v1/management/ip-allowlistエンドポイントでPOSTメソッドを使って作成します。利用できるエンドポイントはすべて次のセクションで説明します。

手順

  1. パーソナルアクセストークンがまだない場合は、[Users] (ユーザー)ページで自分のアカウント用にパーソナルアクセストークンを生成します。
  2. ブラウザーでTalend API Testerを開き、[Method] (メソッド) リストで[POST]を選択します。
  3. [Method] (メソッド)ドロップダウンリストの横にあるフィールドに、使用するIP許可リストのエンドポイントをhttps://api.<your_environment>.cloud.talend.com/v1/management/ip-allowlist/ipsとして入力します。
    <your_environment>の部分には次のいずれかが入ります。
    • ap
    • eu
    • us
    • us-west
    • au
    • at (Early Adopter Programでこの機能を使用している場合)

    利用できる環境の詳細は、Talend CloudのリージョンとURLを参照してください。

  4. [HEADERS] (ヘッダー)エリアで[Add header] (ヘッダーを追加)をクリックし、表示される[name] (名前)フィールドにAuthorizationを、[value] (値)フィールドにBearerとパーソナルアクセストークンをそれぞれ入力します。Bearerとパーソナルアクセストークンは空白で区切ります。
  5. [Body] (ボディ)エリアには以下のIPを入力します:

    例え

    [
      {
        "description": "Data Prep user1",
        "ip": "230.65.223.167"
      },
      {
    	"description": "Data Prep user2",
        "ip": "230.65.223.169"
      }
    ]
  6. [Send] (送信)をクリックしてリクエストを送信します。

タスクの結果

201というステータスコードが返されると、IP許可リストにIPが正しく追加されます。
この操作はコマンドラインツールでcurlコマンドを使って実行することもできます。
curl -X POST "https://api.<your_environment>.cloud.talend.com/v1/management/ip-allowlist/ips" -H "accept: */*" -H "Authorization: Bearer <your_access_token>" -H "Content-Type: application/json" -d "[ { \"description\": \"Data Prep user1\", \"ip\": \"230.65.223.167\" }, {\t\"description\": \"Data Prep user2\", \"ip\": \"230.65.223.169\" }]"