Show role (GET /v3/roles/{role_id})
Shows the specified role.
Request headers
Content-type
Indicates the format of content defined in the MIME specification.
Specify application/json. (required)
Data type | Cardinality |
---|---|
xsd:string | 1..1 |
Accept
Indicates the accept format defined in the MIME specification.
Specify application/json. (optional)
Data type | Cardinality |
---|---|
xsd:string | 1..1 |
X-Auth-Token
Valid authentication token
Data type | Cardinality |
---|---|
xsd:string | 1..1 |
Request parameters
role_id
Role ID (required)
Data type | Cardinality | Parent element | Child element |
---|---|---|---|
xsd:string | 1..1 | None | None |
Response headers
HTTP status code
Returns the HTTP status code of the request.
One of the following values will be returned.
- 200:
- Normal completion
- 400:
- Invalid access (invalid parameter, etc.)
- 401:
- Authentication error
- 403:
- Cannot access (no privileges)
- 404:
- No applicable resources
- 409:
- Data conflict occurred
- 500:
- Unexpected error
- 501:
- Has not been implemented
- 503:
- Cannot use service
Data type | Cardinality |
---|---|
int | 1..1 |
Vary
By setting or changing the following header, notification is given that expressions can be requested in a different file format.
X-Auth-Token
Data type | Cardinality |
---|---|
xsd:string | 1..1 |
Content-Type
Indicates the format of content defined in the MIME specification.
application/json
Data type | Cardinality |
---|---|
xsd:string | 1..1 |
Content-Length
Indicates the length of an entity in bytes.
Data type | Cardinality |
---|---|
int | 1..1 |
Date
Indicates the date when the request was created.
Data type | Cardinality |
---|---|
date | 1..1 |
Response elements
role
role object
Data type | Cardinality | Parent element | Child element |
---|---|---|---|
Element | 1..1 | None | id links name |
id
Role ID
Data type | Cardinality | Parent element | Child element |
---|---|---|---|
xsd:string | 1..1 | role | None |
links
Link information of role
Data type | Cardinality | Parent element | Child element |
---|---|---|---|
Element | 1..1 | role | self |
name
Role name
Data type | Cardinality | Parent element | Child element |
---|---|---|---|
xsd:string | 1..1 | role | None |
Example of request
GET /v3/roles/--role-id--
X-Auth-Token: MIIIHgYJKoZIhvcNAQcCoIIIDzCCCAsCAQExC . . .
Example of response
[Reference when the preset role is Global Administrator]
{
"role": {
"id": "--member-role-id--",
"links": {
"self": "http://identity.jp-east-1.cloud.global.fujitsu.com/v3/roles/--member-role-id--"
},
"name": "_member_"
}
}