Get switchable role
- Print
- PDF
Get switchable role
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Available in Classic and VPC
Get the list of roles that can be switched from a sub account Calls can only be made from a sub account.
Request
This section describes the request format. The method and URI are as follows:
| Method | URI |
|---|---|
| GET | /api/v1/switchable-roles |
Request headers
For information about the headers common to all Sub Account APIs, see Sub Account request headers.
Request query parameters
You can use the following query parameters with your request:
| Field | Type | Required | Description |
|---|---|---|---|
searchColumn | String | Optional | Search column
|
searchWord | String | Optional | Search keyword |
Request example
The request example is as follows:
curl --location --request GET 'https://subaccount.apigw.ntruss.com/api/v1/switchable-roles' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Accept: application/json'
Response
This section describes the response format.
Response body
The response body includes the following data:
| Field | Type | Required | Description |
|---|---|---|---|
roleNo | String | - | Role ID |
roleNrn | String | - | NAVER Cloud Platform resource identification value for role |
displayName | String | - | Role name |
description | String | - | Description of the role |
isCurrentRole | Boolean | - | Current usage status
|
Response status codes
For information about the HTTP status codes common to all Sub Account APIs, see Sub Account status codes.
Response example
The response example is as follows:
[
{
"roleNo": "9ba09190-****-****-****-246e966ebec4",
"roleNrn": "nrn:PUB:IAM::5*****8:Role/9ba09190-****-****-****-246e966ebec4",
"displayName": "Adm",
"description": "admin",
"isCurrentRole": false
}
]
Was this article helpful?