この記事を使用すべきタイミング

この記事は、Atlassian Cloud (Jira または Confluence) で多くのグループを作成する必要がある場合に参考にしてください。

この記事を使用すべきでないタイミング

ユーザーとグループを Atlassian Guard SCIM でプロビジョニングしている組織では、Atlassian Access ユーザー プロビジョニング REST API を利用してください。

データを準備する

1. テキスト エディターを開いて、形成するすべてのグループのリストを含むドキュメントを作成します。
2. 最初の行に groupName というラベルのヘッダーを含めます。
3. ドキュメントを CSV 形式で保存します。これで、確立するグループのリストが含まれるようになります。

ファイルの例

groupName
office-pouso-alegre
mtv-sales-ops
mtv-developers
team-rainbow
vip-support

Postman を設定する

Postman を使用する手順の詳細については、「一括ユーザー管理用の Postman の設定」を参照してください。

REST API 呼び出しを設定する

1. [New (新規)] を選択するか、Ctrl + N キー (Windows/Linux) または Cmd + N キー (MacOS) を押します。

2. [HTTP] を選択します。

3. リクエスト名を「Create Group in Atlassian Cloud (Atlassian Cloud でのグループの作成)」に設定します。

4. メソッドを GET から POST に変更します。

5. URL に以下を貼り付けます。

   {{cloudUrl}}/rest/api/latest/group

6. [Authorization (承認)] タブを選択します。

7. [Type (タイプ)] が [Inherit auth from parent (親から認証を継承)] であることを確認します。

8. [Body (本文)] タブを選択します。
   

9. [raw] を選択します。

10. コンテンツ タイプを [JSON] に変更します。

11. 次のブロックをペイロード領域に貼り付けます。

    {
      "name": "{{groupName}}"
    }

    {{groupName}} が csv ヘッダーと一致することに注意してください (大文字と小文字は区別されます)。

12. [保存] を選択し、「Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)」コレクションに保存します。

Postman Runner を実行する 

1. Postman の右上にある環境セレクターで [Atlassian Cloud] を選択し、環境を変更します。

2. サイドバーの [Collections (コレクション)] を選択します。

3. [Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)] コレクションを選択します。

4. [Overview (概要)] タブで、右上隅の [Run (実行)] を選択します。

5. [Run order (実行順序)] の下で、REST API 呼び出しが 1 つ (「Create Group in Atlassian Cloud (Atlassian Cloud でのユーザーの作成)」) だけであることを確認します。

6. [Functional (機能)] タブで、[Run manually (手動で実行)] を選択します。

7. [データ] を選択します。

8. 事前に準備した CSV ファイルの場所に移動して選択します。

9. [Run configuration (実行設定)] の [Iterations (イテレーション)] の数を 1 に減らします。

10. [Advanced settings (詳細設定)] はそのまま残します。

11. [Run Atlassian Cloud User Management (Atlassian Cloud ユーザー管理を実行)] を選択します。

12. Postman をチェックして、ランナー コレクションがすべてのテストに合格していることを確認します。実行結果は次のように表示されるはずです。

    1. [Iterations (イテレーション)] と [All tests (すべてのテスト)] の回数が同じ

    2. Passed (n) (成功) (n は [Iterations (イテレーション)] の数)

    3. Failed (0) (失敗)

    4. Skipped (0) (スキップ)

13. admin.atlassian.com をチェックして、グループ数が 1 つ増えていることを確認します。

14. [Iterations (イテレーション)] の数を CSV ファイルの行数に設定し、前の手順に従って Postman Runner を再実行します。

参考

• Jira Cloud REST API - グループの作成
• Postman - Collection Runner を使用する