Postman と REST API を使用して Atlassian Cloud からユーザーを削除する
プラットフォームについて: Cloud のみ - この記事は クラウド プラットフォームのアトラシアン製品に適用されます。
このドキュメントはナレッジ ベースのリソースとしてのみ役立ちます。カスタマイズや開発に関するリクエストはアトラシアンのサポート対象外ですのでご注意ください。そのようなリクエストについては、開発者ネットワークまたはパートナー ネットワークをご案内します。
この記事を使用すべきタイミング
この記事は、Atlassian Cloud からユーザーを一括削除する必要があるときはいつでも使用できます。たとえば、Atlassian Cloud へのユーザー移行をテストした後、再テストするために組織から多くのユーザーを削除する必要がある場合があります。また、会社の合併後、古いアカウントを削除する必要がある場合もあります。
この記事では、Jira がクラウド サイトで利用可能であることを前提としています。
この記事を使用すべきでないタイミング
この記事は、Atlassian Guard SCIM でプロビジョニングされたユーザーとグループを持つ組織には適用されません。これらのグループは次回のアップデート/同期後に再作成されるためです。SCIM を通じてプロビジョニングされたユーザーを変更するには、ID プロバイダー管理者にお問い合わせください。
組織のユーザー管理を確認する
admin.atlassian.com にアクセスします。 複数の組織がある場合は、対象の組織を選択します。
オリジナル | 集中型 |
サイト管理者または組織管理者として、[ユーザー] は [Product site (製品サイト)] の下で確認できます。 | 組織管理者として、[ユーザー] は [ディレクトリ] タブで確認できます。 |
データを準備する
admin.atlassian.com に移動します。複数の組織がある場合は、対象の組織を選択します。
このステップは、ご利用のユーザー管理エクスペリエンスによって異なります。
- オリジナル: サイトの名前と URL を選び、そのサイトの [管理] を開いて [ユーザー] を選択します。
- 一元管理: [ディレクトリ] > [ユーザー] の順に選択します。このステップは、ご利用のユーザー管理エクスペリエンスによって異なります。
- オリジナル: [ユーザーをエクスポート] を選択します。
-一元管理: 画面の上部にある […] > [ユーザーをエクスポート] を選択します。エクスポートしたいユーザーを選択します。
サイト/組織内のすべてのユーザー – サイト/組織内にいるすべてのグループ全体のすべてのユーザーが含まれます。
選択したグループのユーザーのみ – 選択したグループのユーザーのみが含まれます。
[すべてのユーザー] を選択すると、アクティブ、一時停止中、非アクティブのユーザーがすべて含まれます。
さらに以下のオプションを選択して、ダウンロードに含めるデータを追加します。これらのオプションはデータのフィルタリングに役立つ場合があります。
[グループ メンバーシップ] – ユーザーが所属しているグループを含みます。初期設定では、複数のグループはコンマ区切りのリストとしてフォーマットされます。
[製品アクセス] – ユーザーがアクセスできる製品と製品の各ロールが含まれます。
[ユーザーをエクスポート] を選択します。
CSV ファイルをダウンロードする準備が整ったら、メールが届きます。しばらくしてもメールが届かない場合は、迷惑メール フォルダーをご確認ください。
メールを開いて [CSV ファイルをダウンロード] を選択します。ログインしていない場合は、ダウンロードを開始する前にログインする必要が生じる場合があります。
表計算プログラムやテキスト エディターを使用して、組織管理者など、削除すべきでない行をすべて削除します。
削除を実行するユーザーが削除されていることを確認します。
「User id (ユーザー ID)」(Atlassian アカウント ID) 列がクリーンアップ中に削除されないことを確認します。
削除するすべてのユーザーを含むリストになった CSV ファイルを保存します。
Postman を設定する
以下の場合は、このセクションを省略できます。
「Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)」という名前のコレクションが設定済みである
「Atlassian Cloud」という名前の環境が設定済みである
REST API 呼び出しを設定する
[New (新規)] をクリックするか、
Ctrl
+N
キー (Windows/Linux) またはCmd
+N
キー (macOS) を押します。[HTTP] を選択します。
リクエスト名を「Delete User from Atlassian Cloud (Atlassian Cloud からのユーザーの削除)」に設定します。
メソッドを
GET
からDELETE
に変更します。URL に以下を貼り付けます。
{{cloudUrl}}/rest/api/2/user?accountId={{User id}}
[Authorization (認証)] タブをクリックします。
[Type (タイプ)] が "Inherit auth from parent (親から認証を継承)" であることを確認します。
[Save (保存)] をクリックして、"Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)" コレクションに保存します。
Runner を実行する
Postman の右上にある環境セレクターで [Atlassian Cloud] を選択し、環境を変更します。
サイドバーの [Collections (コレクション)] を選択します。
[Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)] コレクションを選択します。
[Overview (概要)] タブで、右上の実行ボタン ▶️ を選択します。
[Run order (実行順序)] の下で、REST API 呼び出しが 1 つ (「Delete User from Atlassian Cloud (Atlassian Cloud からのユーザーの削除)」) だけであることを確認します。
[Functional (機能)] タブで、[Run manually (手動で実行)] を選択します。
[Data (データ)] をクリックします。
事前に準備した CSV ファイルの場所に移動して選択します。
[Run configuration (実行設定)] の [Iterations (イテレーション)] の数を 1 に減らします。
ユーザーの削除は破壊的かつ不可逆的なアクションです。すべてのユーザーを体系的に削除する前に、1 人のユーザーでテストして結果を確認することを強くお勧めします。
[Advanced settings (詳細設定)] はそのまま残します。
[Run Atlassian Cloud User Management (Atlassian Cloud ユーザー管理の実行)] をクリックします。
Postman をチェックして、ランナー コレクションがすべてのテストに合格していることを確認します。実行結果は次のように表示されるはずです。
[Iterations (イテレーション)] と [All tests (すべてのテスト)] の回数が同じ
Passed (n) (成功) (n は [Iterations (イテレーション)] の数)
Failed (0) (失敗)
Skipped (0) (スキップ)
admin.atlassian.com をチェックして、ユーザー数が 1 人減っていることを確認します。
[Iterations (イテレーション)] の数を CSV ファイルの行数に設定し、前の手順に従って Postman Runner を再実行します。すでに削除されたユーザーを削除することはできないため、エラーが 1 つ発生することが予想されます。
参考
以下は、現在アクティブな機能リクエストです。
ID-8172 - Getting issue details... STATUS
自由に投票してください。アトラシアンがユーザーのニーズに基づいて新しい開発に優先順位を付ける上で役立ちます。