Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


3.8 セッションの一覧を取得する

REST APIサーバ上の有効なセッションの一覧を取得します。この操作は、Administrator ユーザグループ(ビルトイングループ)に属するユーザVSP 5000 シリーズVSP E シリーズVSP Gx00 モデルVSP G1000VSP G1500VSP Fx00 モデルまたはVSP F1500の場合)、またはmaintenanceユーザ(Virtual Storage PlatformまたはUnified Storage VMの場合)だけが実行できます。

実行権限

Administrator ユーザグループ(ビルトイングループ)VSP 5000 シリーズVSP E シリーズVSP Gx00 モデルVSP G1000VSP G1500VSP Fx00 モデルまたはVSP F1500の場合)

maintenanceユーザ(Virtual Storage PlatformまたはUnified Storage VMの場合)

リクエストライン

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/sessions

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ
{
  "data": [
    {
      "sessionId": 8,
      "userId": "rest-user",
      "ipAddress": "192.0.2.100",
      "createdTime": "2015-09-14T01:02:24Z",
      "lastAccessedTime": "2015-09-14T01:02:24Z"
    },
    {
      "sessionId": 6,
      "userId": "api-user",
      "ipAddress": "192.0.2.100",
      "createdTime": "2015-09-14T00:59:58Z",
      "lastAccessedTime": "2015-09-14T00:59:58Z"
    },
    {
      "sessionId": 5,
      "userId": "admin-user",
      "ipAddress": "192.0.2.100",
      "createdTime": "2015-09-14T00:59:53Z",
      "lastAccessedTime": "2015-09-14T00:59:53Z"
    }
  ]
}

属性

説明

sessionId

int

セッションID

userId

string

セッションを生成したユーザID

ipAddress

string

セッションを生成したREST APIクライアントのIPアドレス

REST APIクライアントから別のサーバを経由してREST APIサーバにアクセスしている場合は、クライアントのIPアドレスと経由したサーバのIPアドレスを連結した文字列(REST APIサーバが受信したX-Forwarded-Forヘッダの内容)が出力されます。

createdTime

ISO8601string

セッションが生成された時刻

lastAccessedTime

ISO8601string

セッションが最後に使用された時刻

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/sessions/