ユーザーの削除
delete
https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/users/{userId}
このAPIは、既存のユーザーを削除するリクエストを送信し、ユーザーの削除は非同期に実行されます。ユーザーが削除されると、そのユーザーが作成したジョブはすべて停止および削除されます。また、そのユーザーが作成したブラックアウトも削除されます。ただし、ユーザー削除のコールを発行したときに、そのユーザーが作成したブラックアウトがアクティブな場合は、そのユーザーを削除できません。この状態は、ユーザー削除の無効状態とみなされます。まず、そうしたアクティブなブラックアウトをすべて停止してから、失敗したユーザー削除コールを再発行する必要があります。
リクエスト
パス・パラメータ
- userId(必須): string
ユーザーのID。
サポートされているメディア・タイプ
- application/json
ルート・スキーマ: schema
型:
object
ユーザー削除の情報
ソースの表示
-
delegateUserName: string
削除されるユーザーが所有するセキュア・オブジェクトを割り当てるユーザーの名前。delegateUserNameを指定しないと、削除されるユーザーが所有するセキュア・オブジェクトは削除されます。例:
USER_B
-
forceDelete: boolean
ユーザーのログイン・セッションがアクティブな場合でもユーザーの削除を強制実行するフラグ。デフォルト値はfalse例:
true
レスポンス
サポートされているメディア・タイプ
- application/json
202レスポンス
401レスポンス
認証に失敗しました
ルート・スキーマ: ErrorResponse
型:
object
エラー発生時に返送されるレスポンス
ソースの表示
-
code: string
エラーのステータス・コード。例:
IllegalArgument
-
message: string
説明的なエラー・メッセージ例:
argument given is not supported
403レスポンス
許可されていません
ルート・スキーマ: MissingPrivErrorResponse
型:
object
必要な権限がない場合にエラーとして返送されるレスポンス
ソースの表示
-
missingPrivileges: array missingPrivileges
エラーが発生したために欠落している権限。これにより、権限オブジェクトには権限の内部名および表示名のみが含まれます
すべてに一致
必要な権限がない場合にエラーとして返送されるレスポンス
ソースの表示
- object ErrorResponse
エラー発生時に返送されるレスポンス
ネストされたスキーマ: missingPrivileges
型:
array
エラーが発生したために欠落している権限。これにより、権限オブジェクトには権限の内部名および表示名のみが含まれます
ソースの表示
- 配列: object MissingPrivilegeSummary
これは、リソースの表示または管理のための権限がないことを表します。
ネストされたスキーマ: ErrorResponse
型:
object
エラー発生時に返送されるレスポンス
ソースの表示
-
code: string
エラーのステータス・コード。例:
IllegalArgument
-
message: string
説明的なエラー・メッセージ例:
argument given is not supported
ネストされたスキーマ: MissingPrivilegeSummary
型:
object
これは、リソースの表示または管理のための権限がないことを表します。
ソースの表示
-
displayName: string
権限の表示名例:
Manage
-
name: string
権限の名前例:
MANAGE_JOB
404レスポンス
見つかりません
ルート・スキーマ: ErrorResponse
型:
object
エラー発生時に返送されるレスポンス
ソースの表示
-
code: string
エラーのステータス・コード。例:
IllegalArgument
-
message: string
説明的なエラー・メッセージ例:
argument given is not supported
409レスポンス
ユーザーには現在アクティブなセッションがあります。
ルート・スキーマ: ErrorResponse
型:
object
エラー発生時に返送されるレスポンス
ソースの表示
-
code: string
エラーのステータス・コード。例:
IllegalArgument
-
message: string
説明的なエラー・メッセージ例:
argument given is not supported
500レスポンス
内部サーバー・エラー
ルート・スキーマ: ErrorResponse
型:
object
エラー発生時に返送されるレスポンス
ソースの表示
-
code: string
エラーのステータス・コード。例:
IllegalArgument
-
message: string
説明的なエラー・メッセージ例:
argument given is not supported
503レスポンス
サービスを使用できません
ルート・スキーマ: ErrorResponse
型:
object
エラー発生時に返送されるレスポンス
ソースの表示
-
code: string
エラーのステータス・コード。例:
IllegalArgument
-
message: string
説明的なエラー・メッセージ例:
argument given is not supported
デフォルト・レスポンス
予期しないエラー
ルート・スキーマ: ErrorResponse
型:
object
エラー発生時に返送されるレスポンス
ソースの表示
-
code: string
エラーのステータス・コード。例:
IllegalArgument
-
message: string
説明的なエラー・メッセージ例:
argument given is not supported