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

Talend Management Consoleユーザーガイド
Version
Cloud
Language
日本語
Product
Talend Cloud
Module
Talend Management Console
Content
デプロイメント > スケジューリング > タスクのスケジューリング
デプロイメント > デプロイ中 > タスクの実行
デプロイメント > デプロイ中 > パイプラインの実行
管理と監視 > プロジェクトの管理
管理と監視 > ユーザーの管理
Last publication date
2024-04-15

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] (ユーザー)タブで自分のアカウント用にパーソナルアクセストークンを生成します。
    1. 右上にある自分のユーザー名をクリックします。
    2. [Profile preferences] (プロファイル環境設定) > [Personal acess tokens] (パーソナルアクセストークン) > [Add token] (トークンを追加)をクリックします。
    3. トークン名を付けて[Generate] (生成)をクリックします。
  2. [Method] (メソッド)ドロップダウンリストの横にあるフィールドに、使用するIP許可リストのエンドポイントをhttps://api.<your_environment>.cloud.talend.com/v1/management/ip-allowlist/ipsとして入力します。
    <your_environment>の部分には次のいずれかが入ります。
    • ap
    • eu
    • us
    • us-west
    • au

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

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

    例

    [
  {
    "description": "Data Prep user1",
    "ip": "230.65.223.167"
  },
  {
	"description": "Data Prep user2",
    "ip": "230.65.223.169"
  }
]
  5. [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\" }]"