接口描述
本接口(AssumeRole)用于申请角色的临时凭证。
请求域名:
sts.api.qcloud.com
输入参数
字段 | 是否必选 | 类型 | 描述 |
roleArn | 是 | String | 角色的资源描述。例如:qcs::cam::uin/12345678:role/4611686018427397919、qcs::cam::uin/12345678:roleName/testRoleName。uin:资源拥有者 owneruin;roleName:角色名称;role:角色 ID |
roleSessionName | 是 | String | 临时会话名称,由用户自定义名称 |
durationSeconds | 否 | Int | 指定临时证书的有效期,单位:秒,默认1800秒,最长可设定有效期为7200秒 |
输出参数
字段 | 类型 | 描述 |
credentials | 对象里面包含 token,tmpSecretId,tmpSecretKey 三元组 |
Credentials 数据结构
字段 | 类型 | 描述 |
token | String | token 值 |
tmpSecretId | String | 临时安全证书 ID |
tmpSecretKey | String | 临时安全证书 Key |
示例
输入
https://sts.api.qcloud.com/v2/index.php?Action=AssumeRole&roleArn=qcs%3a%3acam%3a%3auin%2f12345678%3arole%2f4611686018427397919&roleSessionName=abc&durationSeconds=1800&<公共请求参数>
输出
{"code": 0,"message": "","codeDesc": "Success","data": {"credentials": {"sessionToken": "5e776c4216ff4d31a7c74fe194a978a3ff2a42864","tmpSecretId": "************************************************************","tmpSecretKey": "************************************************************"},"expiredTime": 1506433269,"expiration": "2017-09-26T13:41:09Z"}}