APIを使ってユーザーを作成 - Cloud

Talend Cloud APIユーザーガイド

Version
Cloud
Language
日本語 (日本)
Product
Talend Cloud
Module
Talend API Designer
Talend API Tester
Talend Data Preparation
Talend Data Stewardship
Talend Management Console
Content
ジョブデザインと開発 > Designing APIs
ジョブデザインと開発 > Testing APIs
ユーザー管理APIを使ってユーザーを作成できます。

始める前に

API呼び出しの発行に使用するアカウントに[Users - Management] (ユーザー - 管理)権限があることを確認します。

このタスクについて

このセクションでは、Talend API TesterはAPI呼び出しを発行してユーザーを作成する方法のデモンストレーションに使用されます。

手順

  1. [Users] (ユーザー)ページで、自分のアカウント用にパーソナルアクセストークンを生成します。
  2. ブラウザーでTalend API Testerを開き、[Method] (メソッド) リストで[GET]を選択します。
  3. [Method] (メソッド)ドロップダウンリストの横にあるフィールドに、使用するユーザー管理のエンドポイントをhttps://api.<your_environment>.cloud.talend.com/v1/management/roles/として入力します。
    <your_environment>の部分には次のいずれかが入ります。
    • eu
    • us
    • us-west
  4. [HEADERS] (ヘッダー)エリアで[Add header] (ヘッダーの追加)をクリックし、表示される[name] (名前)フィールドにAuthroizationを、[value] (値)フィールドにBearerとパーソナルアクセストークンをそれぞれ入力します。Bearerとパーソナルアクセストークンは空白で区切ります。
  5. [Send] (送信)をクリックすると、作成するユーザーに割り当てるロールIDの取得用コールが発行されます。
    応答には、Talend Cloud アプリケーションで既に定義されているロールのIDがリスト表示されます。作成するユーザーに割り当てるIDをメモします。
  6. [Method] (メソッド)リストでPOSTを選択し、横にあるフィールドに、使用するユーザー管理エンドポイントをhttps://api.<your_environment>.cloud.talend.com/v1/management/users/として入力します。

    例え

  7. [Add query parameter] (クエリーパラメーターを追加)をクリックし、表示される[name] (名前)フィールドにinviteパラメーターを、[value] (値)フィールドにtrueをそれぞれ入力します。この行はinvite = trueのようになります。
  8. [Add header] (ヘッダーの追加)をクリックします。表示される[name] (名前)フィールドにContent-Typeと、[value] (値)フィールドにapplication/jsonとそれぞれ入力します。
  9. [BODY] (ボディ)エリアに、作成するユーザーのプロファイルを入力します。

    例え

    {
    	"active": true,
    	"email": "user_email_to_receive_invitation",
    	"firstName": "string",
    	"lastName": "string",
    	"login": "string",
    	"roleIds": [
    		"role_id_retrieved_in_previous_steps"
    	]
    }

    この例では、ユーザーの作成に必須フィールドのみが使われています。

    必要であればフィールドをさらに追加します:
    "password": "string",
    "phone": "string",
    "preferredLanguage": "EN",
    "timezone": "string",
    "title": "string",
    有効なパスワードは7文字以上で、次の文字が含まれている必要があります:
    • 数字
    • 大文字
    • 特殊文字
    • emailfirstNamelastNameloginからの情報は含めないようにしてください
  10. [Send] (送信)をクリックして呼び出しを送信します。

タスクの結果

作成が正常に完了し、ステータスコード201が返されます。レスポンスの[BODY] (ボディ)フィールドに、作成したユーザーの詳細が表示されます。