The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.
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
}