Postman を使用して REST API によって Jira Cloud にユーザーを作成する
プラットフォームについて: Cloud のみ - この記事は クラウド プラットフォームのアトラシアン製品に適用されます。
要約
このガイドを参考に、Jira または Confluence Cloud のユーザーを効率的に一括で作成する方法を学んでください。
データを準備する
- テキスト エディターを使用して、作成するすべてのユーザーのメール アドレスを記載したテキスト ドキュメントを準備します。
最初のサインイン後にパスワードをリセットするためのメールを受信できるよう、すべてのユーザーは (メールボックスを与えられた) 有効なメール アドレスを持っている必要があります。 - 最初の行に
emailAddressというラベルのヘッダー行を記述します。 - 作成するユーザーのメール アドレスを記述し、CSV ファイルとして保存します。
- ユーザーの既定のメンバーシップ用に
productsというラベルの列を追加します。
ファイルの例
emailAddress,products
dgrechen@bancly.com,jira-software
khaulkham-fraben@bancly.com,jira-software
igunston2@bancly.com,jira-software
pmaynell3@bancly.com,jira-software
Postman を設定する
以下の場合は、このセクションを省略できます。
「Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)」という名前のコレクションが設定済みである
「Atlassian Cloud」という名前の環境が設定済みである
REST API 呼び出しを設定する
[New (新規)] をクリックするか、
Ctrl+Nキー (Windows/Linux) またはCmd+Nキー (macOS) を押します。[HTTP] を選択します。
リクエスト名を「Create User in Atlassian Cloud (Atlassian Cloud へのユーザーの作成)」に設定します。
メソッドを
GETからPOSTに変更します。URL に以下を貼り付けます。
{{cloudUrl}}/rest/api/2/user[Authorization (認証)] タブをクリックします。
[Type (タイプ)] が [Inherit auth from parent (親から認証を継承)] であることを確認します。
- [Body (本文)] タブをクリックします。
[raw (行)] をクリックします。
コンテンツ タイプを [JSON] に変更します。次のブロックをペイロード領域に貼り付けます。
{ "emailAddress": "{{emailAddress}}", "products": [ "{{products}}" ] }{{emailAddress}} と {{products}} が csv ヘッダーと一致することに注意してください (大文字と小文字は区別されます)。
[Save (保存)] をクリックして、[Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)] コレクションに保存します。
Runner を実行する
Postman の右上にある環境セレクターで [Atlassian Cloud] を選択し、環境を変更します。
サイドバーの [Collections (コレクション)] を選択します。
[Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)] コレクションを選択します。
[Overview (概要)] タブで、右上の実行ボタン ▶️ を選択します。
[実行順序] の下で、REST API 呼び出しが 1 つ (「Create User in Atlassian Cloud (Atlassian Cloud へのユーザーの作成)」) だけであることを確認します。
[Functional (機能)] タブで、[Run manually (手動で実行)] を選択します。
[Data (データ)] をクリックします。
事前に準備した CSV ファイルの場所に移動して選択します。
[Run configuration (実行設定)] の [Iterations (イテレーション)] の数を 1 に減らします。
[Advanced settings (詳細設定)] はそのまま残します。
[Run Atlassian Cloud User Management (Atlassian Cloud ユーザー管理の実行)] をクリックします。
Postman をチェックして、ランナー コレクションがすべてのテストに合格していることを確認します。実行結果は次のように表示されるはずです。
[Iterations (イテレーション)] と [All tests (すべてのテスト)] の回数は同じ
Passed (n) (成功) (n はイテレーションの数)
Failed (0) (失敗)
Skipped (0) (スキップ)
admin.atlassian.com をチェックして、ユーザー数が 1 人増えていることを確認します。ユーザーのアクセス権限を確認します。ユーザーは既定のアクセス権限を継承します。
[Iterations (イテレーション)] の数を CSV ファイルの行数に設定し、前の手順に従って Postman Runner を再実行します。
参考
ユーザーとグループを アトラシアン ガード SCIM でプロビジョニングしている組織では、Atlassian Access ユーザー プロビジョニング REST API を使用してください。