Create temporary credentials
- Print
- PDF
Create temporary credentials
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Available in Classic and VPC
Create temporary credentials for a sub account using the Secure Token Service.
Request
This section describes the request format. The method and URI are as follows:
Method | URI |
---|---|
POST | /api/v1/credentials |
Request headers
For information about the headers common to all Secure Token Service APIs, see Secure Token Service request headers.
Request body
The following describes the body.
Field | Type | Required | Description |
---|---|---|---|
durationSec | Integer | Optional | Access key validity time (second)
|
serialNumber | String | Optional | Serial number
|
tokenCode | Integer | Optional | OTP verification code |
Request example
The request example is as follows:
curl --location --request POST 'https://sts.apigw.ntruss.com/api/v1/credentials' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '{
"durationSec": "43200"
}'
Response
This section describes the response format.
Response body
The response body includes the following data:
Field | Type | Required | Description |
---|---|---|---|
accessKey | String | - | Access key |
keySecret | String | - | Secret key |
createTime | String | - | Creation date
|
expireTime | String | - | Expiration date
|
useMfa | Boolean | - | MFA authentication status
|
Response status codes
For information about the HTTP status codes common to all Secure Token Service APIs, see Secure Token Service response status codes.
Response example
The response example is as follows:
{
"accessKey": "ncp_iam_***************",
"keySecret": "ncp_iam_**********************",
"createTime": "2024-10-10T16:58:28Z",
"expireTime": "2024-10-10T17:58:28Z",
"useMfa": false
}
Was this article helpful?