組織 をプログラムで扱う場合、組織のメンバー一覧を取得する必要があることがあります。
組織に関連付けられているメンバーは、 または のいずれかで確認できます。
- Auth0 Dashboard > 組織 に移動し、メンバーシップを表示する対象の組織を選択します。
- メンバー ビューを選択します。
Auth0 Dashboard または Management API で表示できる組織メンバーは最大 1000 件ですが、それ以上のメンバーが存在する場合もあります。
Get Organization Members エンドポイントに GET リクエストを送信します。プレースホルダー値 ORG_ID と MGMT_API_ACCESS_TOKEN は、それぞれ組織 ID と Management API の に必ず置き換えてください。
Auth0 ドメインを確認するAuth0 ドメインは、テナント名、リージョンのサブドメイン (テナントが US リージョンにあり、2020 年 6 月より前に作成されている場合を除く) 、および .auth0.com を組み合わせたものです。たとえば、テナント名が travel0 の場合、Auth0 ドメイン名は travel0.us.auth0.com になります。 (テナントが US にあり、2020 年 6 月より前に作成されている場合、ドメイン名は https://travel0.auth0.com になります。)カスタムドメインを使用している場合は、カスタムドメイン名を指定してください。
| 値 | 説明 |
|---|
ORG_ID | メンバーを取得する対象の組織のID。 |
MGMT_API_ACCESS_TOKEN | スコープ read:organization_members を持つManagement API のアクセストークン。 |
想定されるレスポンスステータスコードは次のとおりです。
| ステータスコード | エラーコード | メッセージ | 原因 |
|---|
200 | | メンバーを正常に取得しました。 | |
400 | invalid_paging | リクエストしたページが、許可されている最大件数の 1000 レコードを超えています。 | API は最大 1000 レコードまでしか返さないように制限されています。 |
400 | invalid_body | リクエスト本文が無効です。メッセージは原因によって異なります。 | リクエストのペイロードが無効です。 |
401 | | 無効なトークンです。 | |
401 | | JSON Web Token の検証で受信した署名が無効です。 | |
401 | | クライアントはグローバルではありません。 | |
403 | insufficient_scope | スコープが不足しています。必要なスコープ: read:organization_members。 | 指定されたベアラートークンのスコープでは許可されていないフィールドの読み取りまたは書き込みを試行しました。 |
429 | | リクエストが多すぎます。X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset ヘッダーを確認してください。 | |