日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

AI 助理
備案控制臺
文檔
輸入文檔關鍵字查找
首頁 訪問控制 開發參考 API參考 API參考（STS） API目錄 角色扮演 AssumeRole - 獲取扮演角色的臨時身份憑證

AssumeRole - 獲取扮演角色的臨時身份憑證

更新時間：
產品詳情
我的收藏

通過調用AssumeRole接口，獲取一個扮演RAM角色的臨時身份憑證（STS Token）。

接口說明

前提條件

該接口不能使用阿里云賬號（主賬號）調用，只能使用 RAM 用戶或 RAM 角色調用，請確保已為調用者（RAM 用戶或 RAM 角色）授予 STS 的管理權限（AliyunSTSAssumeRoleAccess）。

否則，會報如下錯誤：

You are not authorized to do this action. You should be authorized by RAM.

問題原因和解決方法如下：

最佳實踐

STS Token 自頒發后將在一段時間內有效，建議您設置合理的 Token 有效期，并在有效期內重復使用，以避免業務請求速率上升后，STS Token 頒發的速率限制影響到業務。具體速率限制，請參見 STS 服務調用次數是否有上限。您可以通過請求參數DurationSeconds設置 Token 有效期。

在移動端上傳或下載 OSS 文件等場景下，其訪問量較大，即使重復使用 STS Token 也可能無法滿足限流要求。為避免 STS 的限流成為 OSS 訪問量的瓶頸，您可以嘗試 OSS 的在 URL 中包含簽名的方案。更多信息，請參見在 URL 中包含簽名和服務端簽名后直傳。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：

  • 操作：是指具體的權限點。
  • 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
  • 資源類型：是指操作中支持授權的資源類型。具體說明如下：
    • 對于必選的資源類型，用背景高亮的方式表示。
    • 對于不支持資源級授權的操作，用全部資源表示。
  • 條件關鍵字：是指云產品自身定義的條件關鍵字。
  • 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
sts:AssumeRoleget
*Role
acs:ram::{#accountId}:role/{#RoleName}
    無
無

請求參數

名稱類型必填描述示例值
DurationSecondslong否

Token 有效期。單位：秒。

Token 有效期最小值為 900 秒，最大值為要扮演角色的MaxSessionDuration時間。默認值為 3600 秒。

您可以通過 CreateRole 或 UpdateRole 設置角色最大會話時間MaxSessionDuration。更多信息，請參見 CreateRole 或 UpdateRole 。

3600
Policystring否

為 STS Token 額外添加的一個權限策略，進一步限制 STS Token 的權限。具體如下：

  • 如果指定該權限策略，則 STS Token 最終的權限策略取 RAM 角色權限策略與該權限策略的交集。
  • 如果不指定該權限策略，則 STS Token 最終的權限策略取 RAM 角色的權限策略。

長度為 1~2048 個字符。

關于權限策略元素和示例，請參見權限策略基本元素和權限策略示例庫。

{"Statement": [{"Action": ["*"],"Effect": "Allow","Resource": ["*"]}],"Version":"1"}
RoleArnstring是

要扮演的 RAM 角色 ARN。

該角色是可信實體為阿里云賬號類型的 RAM 角色。更多信息，請參見創建可信實體為阿里云賬號的 RAM 角色或 CreateRole 。

格式：acs:ram::<account_id>:role/<role_name> 。

您可以通過 RAM 控制臺或 API 查看角色 ARN。具體如下：

acs:ram::123456789012****:role/adminrole
RoleSessionNamestring是

角色會話名稱。

該參數為用戶自定義參數。通常設置為調用該 API 的用戶身份，例如：用戶名。在操作審計日志中，即使是同一個 RAM 角色執行的操作，也可以根據不同的RoleSessionName來區分實際操作者，以實現用戶級別的訪問審計。

長度為 2~64 個字符，可包含英文字母、數字和特殊字符.@-_。

alice
ExternalIdstring否

角色外部 ID。

該參數為外部提供的用于表示角色的參數信息，主要功能是防止混淆代理人問題。更多信息，請參見使用 ExternalId 防止混淆代理人問題。

長度為 2~1224 個字符，可包含英文字母、數字和特殊字符=,.@:/-_。正則為：[\w+=,.@:\/-]*。

abcd1234

關于公共請求參數的詳情，請參見公共請求參數。

返回參數

名稱類型描述示例值
object

返回參數。

RequestIdstring

請求 ID。

6894B13B-6D71-4EF5-88FA-F32781734A7F
AssumedRoleUserobject

角色扮演時的臨時身份。

AssumedRoleIdstring

臨時身份的 ID。

34458433936495****:alice
Arnstring

臨時身份的 ARN。

acs:ram::123456789012****:role/adminrole/alice
Credentialsobject

訪問憑證。

SecurityTokenstring

安全令牌。

說明 安全令牌的長度不固定，我們強烈建議您不要對安全令牌的最大長度做任何限制。
********
Expirationstring

Token 到期失效時間（UTC 時間）。

2015-04-09T11:52:19Z
AccessKeySecretstring

訪問密鑰。

wyLTSmsyPGP1ohvvw8xYgB29dlGI8KMiH2pK****
AccessKeyIdstring

訪問密鑰 ID。

STS.L4aBSCSJVMuKg5U1****

示例

正常返回示例

JSON格式

{
  "RequestId": "6894B13B-6D71-4EF5-88FA-F32781734A7F",
  "AssumedRoleUser": {
    "AssumedRoleId": "34458433936495****:alice",
    "Arn": "acs:ram::123456789012****:role/adminrole/alice"
  },
  "Credentials": {
    "SecurityToken": "********",
    "Expiration": "2015-04-09T11:52:19Z",
    "AccessKeySecret": "wyLTSmsyPGP1ohvvw8xYgB29dlGI8KMiH2pK****",
    "AccessKeyId": "STS.L4aBSCSJVMuKg5U1****"
  }
}

錯誤碼

HTTP status code錯誤碼錯誤信息描述
400InvalidParameter.DurationSecondsThe Min/Max value of DurationSeconds is 15min/1hr.DurationSeconds參數不合法，DurationSeconds最小值為15分鐘，最大值為1小時
400InvalidParameter.ExternalIdThe parameter ExternalId is wrongly formed.參數ExternalId不合法
400InvalidParameter.RoleArnThe parameter RoleArn is wrongly formed.參數RoleArn的格式錯誤
400InvalidParameter.RoleSessionNameThe parameter RoleSessionName is wrongly formed.參數RoleSessionName格式錯誤。
400InvalidParameter.SerialNumberThe parameter SerialNumber is wrongly formed.-
400InvalidParameter.TokenCodeThe parameter TokenCode is wrongly formed.-
400InvalidParameter.PolicyGrammarThe parameter Policy has not passed grammar check.參數Policy語法格式檢查未通過。
400InvalidParameter.PolicySizeThe size of Policy must be smaller than 2048 bytes.Policy參數不合法，Policy長度必須小于2048字節。
400InvalidParameter.ContentTypeThe ContentType request header must be either "application/json" or "application/x-www-form-urlencoded".-
403NoPermissionYou are not authorized to do this action. You should be authorized by RAM.-
403AuthenticationFail.ApiUsernameThe specified api username is not legal.-
403AuthenticationFail.ApiPasswordThe specified api password is not legal.-
403NoPermissionNo permission perform sts:AssumeRole on this Role. Maybe you are not authorized to perform sts:AssumeRole or the specified role does not trust you-
403NoPermissionRoles may not be assumed by root accounts.-
404EntityNotExist.RoleThe specified Role not exists .-
500InternalErrorSTS Server Internal Error happened, please send the RequestId to us.-

訪問錯誤中心查看更多錯誤碼。

變更歷史

變更時間變更內容概要操作
2022-09-27OpenAPI 錯誤碼發生變更查看變更詳情