ユーザーグループのセッションを終了させるジョブを作成

post
https://api.box.com/2.0
/groups/terminate_sessions

グループのロールと権限を検証し、グループのセッションを終了させる非同期ジョブを作成します。POSTリクエストのステータスを返します。

リクエスト

bearer [ACCESS_TOKEN]
application/json

リクエスト本文

string array本文内必須
["123456","456789"]

グループIDのリスト

レスポンス

リクエストのステータスに関するメッセージを返します。

一部のパラメータが無効な場合にエラーを返します。

  • Groups can not be NULL or EMPTY: 値が指定されていない場合
  • group id format is string: 指定されたグループIDの形式が正しくない場合
  • Supported payload format is JSON: 指定されたペイロードの形式が正しくない場合

権限が不足している場合にエラーを返します。

リソースが見つからなかった場合にエラーを返します。

リクエスト制限を超えた場合にエラーを返します。

内部サーバーの問題が発生している場合にエラーを返します。

リクエストがタイムアウトした場合にエラーを返します。

予期しないクライアントエラー。

post
ユーザーグループのセッションを終了させるジョブを作成
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

cURL
curl -i -X POST "https://api.box.com/2.0/groups/terminate_sessions" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -H "accept: application/json" \
     -d
    {
    "group_ids": ["6178859178", "4824866571"],
    }
Node
var groupIDs = ['11111', '22222'];

client.groups.terminateSession(groupIDs)
	.then((result) => {
		/* result -> {
			message: 'Request is successful, please check the admin events for the status of the job'
		} */ 
	});

レスポンスの例

{
  "message": "Request is successful, please check the admin\nevents for the status of the job"
}