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

この記事は、Atlassian Cloud からチームを一括削除する必要があるときはいつでも使用できます。たとえば、Atlassian Cloud への移行をテストした後、再テストするために組織から多くのチームを削除する必要がある場合があります。

Postman を設定する

データを準備する

1. GET REST API の「チーム一覧を取得する」の手順に従って、teamId. を取得します。

2. 各チームの HTTP レスポンスから "teamId": "<string>" を特定します。

3. 削除するチームの teamId の値をコピーします。

4. 「REST API 呼び出しを設定する」セクションで説明されている DELETE REST API 呼び出しで、これらのチーム ID を使用します。その際、{{teamId}} をそれぞれの値に置き換えます。

REST API 呼び出しを設定する

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

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

3. リクエスト名を「Delete Team from Atlassian Cloud (Atlassian Cloud からのチームの削除)」に設定します。

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

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

   https://api.atlassian.com/public/teams/v1/org/{{organizationId}}/teams/{{teamId}}

6. {{organizationId}} を組織 ID に置き換えます (環境レベルなど、他の場所で設定されていない場合）。
   1. 「Atlassian Cloud 組織の ID を取得する」の手順に従って、組織 ID を取得します。
7. [Authorization (認証)] タブをクリックします。

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

9. [Save (保存)] をクリックして、"Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)" コレクションに保存します。

Runner を実行する 

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

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

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

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

5. [Run order (実行順序)] の下で、REST API 呼び出しが 1 つ (「Delete Team from Atlassian Cloud (Atlassian Cloud からのチームの削除)」) だけであることを確認します。

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

7. [Data (データ)] をクリックします。

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

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

   チームの削除は破壊的かつ不可逆的なアクションです。すべてのチームを体系的に削除する前に、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 を再実行します。すでに削除されたチームを削除することはできないため、エラーが 1 つ発生することが予想されます。

参考

• developer.atlassian.com - チームを削除する
• Postman - Collection Runner を使用する