Get Group Information#

指定したテナントの指定グループ情報を取得します。

APIエンドポイント#

リージョン	APIエンドポイント
西日本リージョン3の場合	https://objectstorage-s.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合	https://objectstorage-s.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

GET

/v2/admin/{tenantID}/groups/{groupID}

HTTPステータスコード#

正常時：200

エラー時：400, 403, 404, 405, 409, 411, 412, 416, 422, 500, 501, 503

リクエストパラメータの説明#

名前	In	Type	デフォルト値 /必須指定	Description
tenantID	path	string	必須	テナント識別子
groupID	path	string	必須	グループ識別子
X-Auth-Token	header	string	必須	認証のトークン

レスポンスヘッダーの説明#

名前	Type	Description
Date	string	トランザクションが実行された日時
Content-Type	string	MIME仕様で定義されているコンテントの形式
Content-Length	string	レスポンスボディのバイト数
X-Fcx-Endpoint-Request	string	このリクエストに付与されるID トラブルについて問い合わせる際に利用されます。

レスポンスボディ（正常系）の説明#

名前	Type	Description
apiVersion	string	APIの内部のバージョン番号
data	object	StatementからuniqueNameまでを含むグループデータの情報
Statement	array	ポリシーの主要エレメント
Action	array	許可する操作が表示されます。
NotAction	array	拒否する操作が表示されます。
Effect	string	ポリシーに指定する内容を、許可(Allow)するか拒否(Deny)するかが表示されます。
Resource	array	対象とするバケットがURNで表示されます。
NotResource	array	対象外とするバケットがURNで表示されます。
Sid	string	ポリシードキュメントに与える任意の識別子
Condition	array	ポリシーを適用する条件を示す式が表示されます。
accountId	string	テナント識別子
displayname	string	グループ名(表示用)
groupURN	string	テナント識別子＋グループ名例：urn:sgws:identity::accountId:group/グループ名
id	string	グループ識別子オブジェクトストレージ内で一意の識別子です。この識別子を利用してグループの操作を実施します。
uniqueName	string	グループ名
responseTime	string	応答が生成された日時
status	object	要求の結果「success」または「error」が表示されます。

リクエスト例#

リクエストヘッダー

GET /v2/admin/46799197538990820493/groups/c6e7ebdb-465e-434b-9346-cf6ea3d9b239 HTTP/1.1
User-Agent: curl/7.29.0
Host: objectstorage-s.jp-east-3.cloud.global.fujitsu.com
Accept: */*
X-Auth-Token:gAAAAABc65O4zxRC2f3VSR4_0sKYlyFAU6q-P9vJ03k4MFBtH5LXjQu-uO358VYOXUkrmjGc9Gt-S96V_IvifHTTgNeex3pKV3bIqVZIxDVHqAIIji8_304nQANuNJF2F82uQJ2aMca6jjooVV1jYMt8Oi9dYP1cNMQiIp61sunt5pDA2BK73-0

レスポンス例#

レスポンスヘッダー

HTTP/1.1 200 OK
Date: Mon, 27 May 2019 07:37:29 GMT
Content-Type: application/json
Content-Length: 402
Connection: keep-alive
Api-Version: 2
Cache-Control: no-cache
Content-Security-Policy: frame-ancestors 'self'; block-all-mixed-content
Expires: Mon, 27 May 2019 07:37:29 GMT
Strict-Transport-Security: max-age=31536000; includeSubDomains
Vary: Api-Version
X-Content-Security-Policy: frame-ancestors: 'self'; block-all-mixed-content
X-Content-Type-Options: nosniff
X-Frame-Options: SAMEORIGIN
X-Fcx-Endpoint-Request: EXECUTED_api2-rmp1.management.jp-east-3.local-1126-70897-1_200

レスポンスボディ

{
    "apiVersion": "2.2",
    "data": {
        "Statement": [
            {
                "Action": "s3:*",
                "Effect": "Allow",
                "Resource": "urn:sgws:s3:::*",
                "Sid": "Test group policy"
            }
        ],
        "accountId": "46799197538990820493",
        "displayName": "testgroup5",
        "groupURN": "urn:sgws:identity::46799197538990820493:group/testgroup5",
        "id": "c6e7ebdb-465e-434b-9346-cf6ea3d9b239",
        "uniqueName": "group/testgroup5"
    },
    "responseTime": "2019-05-27T07:37:29.355Z",
    "status": "success"
}