メンバーのロール変更
PATCH
/console/v1/accounts/{accountId}/members/{humanPrincipalId}メンバーの組織でのロールを変更します。
認証
Authorizationstring必須Bearer <マネジメントトークン> の形式で指定します。
詳しくは認証を参照してください。
パスパラメーター
accountIdstring必須組織のID。
コンソールのURLの /accounts/ に続く部分です。
humanPrincipalIdstring必須メンバーのID。
メンバー一覧の humanPrincipalId で取得できます。
リクエストボディ
roleIdstring必須変更後のロールのID。
メンバー一覧の accountRoles で取得できます。
レスポンス
ステータスコード 204 を返します。
レスポンスボディはありません。
エラー
エラーの形式はエラーを参照してください。
| ステータスコード | error | 原因 |
|---|---|---|
400 | bad_request | リクエストボディの形式や値が正しくない |
401 | console_authentication_failed | マネジメントトークンが正しくない、または有効期限が切れている |
403 | console_authorization_denied | 操作する権限がない、またはマネジメントトークンの発行者自身を指定している |
404 | not_found | リソースが見つからない、またはIDの形式が正しくない |
409 | account_admin_required | 変更すると、オーナーが1人もいなくなる |
503 | console_invitations_unavailable | サービスが一時的に利用できない |