/policyengine/v1/applications: ポスト

/policyengine/v1/applications は、アクション・エージェントを登録します。 IBM Data Catalogingにアプリケーションを登録できるのは、 データ管理ロールを持つ IBM Data Cataloging ユーザーのみです。

以下の表に、 /policyengine/v1/applications エンドポイントにアクセスできるロールを示します。

表 1. 役割によるアクセス
データ管理者	コレクション管理者	データ・ユーザー	管理者	サービス・ユーザー
✓	X	Χ	Χ	Χ

リクエストの概要 URL

curl -k -H “Authorization: Bearer <token>” -H "Content-Type: application/json" -X POST
https://<data_cataloging_host>/policyengine/v1/applications

サポートされる要求タイプと応答形式

サポートされる要求タイプ:

post

サポートされる応答形式:

JSON

examples

アプリケーションの登録には、以下のステップが含まれます。

以下の例に示すように、データ管理者ユーザーの資格情報を使用して認証トークンを取得します。
```
curl -k https://<data_cataloging_host>/auth/v1/token -u “<user_name>:<password>
```
有効なユーザーの場合、認証トークンは “X-Auth-Token” 応答ヘッダーで返されます。
application の詳細を含む .json ファイルを作成します。
```
cat agentregmsg.json

{
"action_agent": "extractapplication",
"action_id": "DEEPINSPECT",
"action_params": ["extract_tags"]
}
```
注：有効な action_id としてサポートされているのは DEEPINSPECT のみであり、常に大文字でなければならない。 action_agent パラメーターは最大64文字で、英数字と「. ただし、文字列に変換されるアクション・パラメーターは最大256文字までです。

以下の要求を送信します。

curl -k https://<data_cataloging_host>/policyengine/v1/applications -H "Content-Type: application/json" -X POST -d @agentregmsg.json -H “Authorization: Bearer <token>”

回答：

    
Content-Type: application/json
    {
      "broker_ip": 9.11.200.114,
      "broker_port": 9093,
      "work_q": "extractapplication_work",
      "completion_q": "extractapplication_compl"
    }

複数のアプリケーション・インスタンス

アプリケーションの複数のコピーを実行したい場合、最初に登録しようとしたアプリケーションだけが成功応答を受け取ります。それ以降の申し込みには、 409 Conflict 。このような場合は、 /policyengine/v1/agents/<エージェント名> エンドポイントを使用して、必要な Kafka 情報を検索してください。

GET 応答の例:


{
"broker_ip": "localhost",
"work_q": "extractapplication_work",
"auth": "extractapplication_user:extractapplication_password",
"params": "["tags"]",
"agent": "extractagent",
"broker_port": "9093",
"completion_q": "extractapplication_compl",
"action_id": "\"DEEPINSPECT\""
}