全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

获取临时身份提供商角色令牌

接口说明

获取临时身份提供商角色令牌,用于URL方式登录控制台

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数
参数名称
类型
必填
描述
Action String
公共参数,本接口取值:AssumeRoleTemporarySAML。
Version String
公共参数,本接口取值:2015-11-01。
RoleKrn String

要扮演的IAM角色的KRN,参考格式:krn:ksc:iam::account-id:role/role-name。

您可以通过IAM控制台访问对应角色详情页查询对应角色的KRN信息。

RoleSessionName String

角色会话名称。
该参数为用户自定义参数。通常设置为调用该API的用户身份来区分实际不同的操作者。

DurationSeconds String

过期时间。单位:秒。

过期时间最小值为900秒,最大值为86400秒,默认值为3600秒。

Policy String

为STS Token额外添加的一个权限策略,进一步限制STS Token的权限。具体如下:
如果指定该权限策略,则STS Token最终的权限策略取IAM角色权限策略与该权限策略的交集。
如果不指定该权限策略,则STS Token最终的权限策略取IAM角色的权限策略。
长度为1~1024个字符。

格式:

{
“Version”: “2015-11-01”,
“Statement”: [
{
“Effect”: “Allow”,
“Action”: “",
“Resource”: "”
}
]
}

返回参数

参数名称
类型
描述
AssumeRoleResult Object
Credentials Object

访问凭证

Expiration String

失效时间,UTC时间,即协调世界时。

SecretAccessKey String

访问密钥

AccessKeyId String

访问密钥ID

SecurityToken String

安全令牌

AssumedRoleUser Object

角色扮演时的临时身份。

Krn String

临时身份的KRN信息

AssumedRoleId String

临时身份的ID

RequestId String

请求ID

请求示例

curl -X POST
'http://sts.api.ksyun.com/?Action=AssumeRoleTemporarySAML&Version=2015-11-01'
-H 'authorization: xxx, SignedHeaders=content-type;host;x-amz-date, Signature=xxx'
-H 'cache-control: no-cache'
-H 'content-type: application/json'
-H 'host: sts.api.ksyun.com'
-H 'x-amz-date: 20170720T022802Z'
-d '{"RoleKrn":"xxx","RoleSessionName":"xxx","DurationSeconds":"xxx","Policy":"xxx"}'

返回示例

JSON格式

{
"AssumeRoleResult":{
"Credentials":{
"SecretAccessKey":"OKLUVHCZLX9C+t+PCrlAZVZbEK****NUKEmE4RErqal8nAw/aTZJufSeTbiw==",
"Expiration":"2021-10-27T11:50:43Z",
"AccessKeyId":"AKTRdn017****TDgat2Ovr6Q",
"SecurityToken":"V2HXmcSj****ojZb+H/o3ubtiOt6yN+4JRffLJScgigtNdLEr***vekRGIKJm3JO4p8h4foWQ3rjNZwjAY7mAouH/TiX+gjSA9GRViP7zVX8eMNuz8HNHi+8tt"
},
"AssumedRoleUser":{
"Krn":"krn:ksc:sts::2000110852:assumed-role/testrole/RoleSessionName",
"AssumedRoleId":"pPUkx5moQC****lAv4nztzw:RoleSessionName"
}
},
"RequestId":"7f8c593a-53c6-4d3a-bf2b-2efbd29b6a26"
}

错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码

错误码
错误信息
Http状态码
描述
InvalidParameterValueAn invalid or out-of-range value was supplied for the input parameter.400参数格式/取值范围不对,具体参数名在错误消息中说明(UserName)
NoSuchEntityThe request was rejected because it referenced a resource that does not exist404实体不存在,具体实体名称在错误消息中说明
AccessDenied用户krn:ksc:iam::%s:user%s%s没有权限执行操作:%s:%s。403没有执行该操作的权限
纯净模式常规模式

纯净模式

点击可全屏预览文档内容