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

利用対象...

* Cloud API Services Platform
* Cloud Big Data
* Cloud Big Data Platform
* Cloud Data Fabric
* Cloud Data Integration
* Cloud Data Management Platform
* Cloud Pipeline Designer Standard Edition
* Data Fabric

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

この例では、Talend API Testerを使ってAPIクエリーを発行します。Talend API Testerの詳細は、[Talend Cloud API Testerユーザーガイド](https://help.qlik.com/talend/r/ja-JP/Cloud/api-tester-user-guide)をご覧ください。

## 始める前に

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

## 手順

1. パーソナルアクセストークンがまだない場合は、[Users] (ユーザー)タブで自分のアカウント用にパーソナルアクセストークンを生成します。
   1. 右上にある自分のユーザー名をクリックします。
   2. [Profile preferences] (プロファイルの設定) &gt; [Personal acess tokens] (パーソナルアクセストークン) &gt; [Add token] (トークンを追加)をクリックします。
   3. トークン名を付けて[Generate] (生成)をクリックします。
2. [Method] (メソッド)ドロップダウンリストの横にあるフィールドに、使用するIP許可リストのエンドポイントをhttps://api.&lt;your\_environment&gt;.cloud.talend.com/v1/management/ip-allowlist/ipsとして入力します。

   たとえば、次のような環境になります:
   * ap
   * eu
   * us
   * us-west
   * au

   利用できる環境の詳細は、[Talend Cloudのアプリケーションにアクセス](https://help.qlik.com/talend/ja-JP/installation-guide-windows/Cloud/talend-cloud-application-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"
     }
   ]
   ```

   ![\[Body\] (ボディ)エリアに入力されたIP。](https://help.qlik.com/talend/ja-JP/management-console-user-guide/Resources/images/api_ip_allowlisting.png)
5. [Send] (送信)をクリックしてリクエストを送信します。

## タスクの結果

201というステータスコードが返されると、IP許可リストにIPが正しく追加されます。 ![IP許可リストに正しく追加されたIPのリスト。](https://help.qlik.com/talend/ja-JP/management-console-user-guide/Resources/images/ip_allowlist_with_api.png)

この操作はコマンドラインツールで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\" }]"
```