全部產品
Search

搜尋本產品

    ：GetAuthCode - 擷取授權碼

    文件中心

    ：GetAuthCode - 擷取授權碼

    更新時間：Aug 08, 2025

    擷取一個包含使用者身份資訊和許可權資訊的授權碼，在整合情境中可使用該授權碼喚起雲應用。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ecd:GetAuthCode

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ExternalUserId

    string

    否

    外部使用者 ID，該 ID 由調用方自訂，確保在一個阿里雲帳號下唯一即可。不能和EndUserId同時為空白。

    alice
    EndUserId

    string

    否

    無影便捷帳號的使用者名稱，在一個阿里雲帳號下唯一。不能和ExternalUserId同時為空白。

    alice
    Policy

    string

    否

    權限原則，限制授權碼的存取權限，為空白表示不限制。

    文法：

    {
      "Version": "1",
      "Resource": {
            "Type": "<資源類型>",
            "Id": "<資源 ID>"
      }
}

    其中，<資源類型>的取值範圍是：

    • AppInstanceGroup：交付組（ID 可通過 ListAppInstanceGroup 介面擷取）

    • AppInstance：應用執行個體（專用欄位）

    • App：應用（ID 可通過 ListAppInstanceGroup 介面擷取）

    { "Version": "1", "Resource": { "Type": "AppInstanceGroup", "Id": "aig-9ciijz60n4xsv****" } }
    AutoCreateUser

    boolean

    否

    根據ExternalUserId確認是否同步建立 EndUserId。僅在EndUserId取值為空白時生效。

    false

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回資訊集合。

    RequestId

    string

    請求 ID。

    1CBAFFAB-B697-4049-A9B1-67E1FC5F****
    AuthModel

    object

    授權碼資訊。

    AuthCode

    string

    授權碼。該授權碼有效期間為 3 分鐘，且無論校正成功或失敗，只能被使用一次。當為一個使用者產生多個授權碼時，只有最後一次產生的有效。

    acv2ZEq2TNSqOlX+DvyetHGRT08iPhbWg/os1W4HojpBxkMQZkAnbKSfz/wNvS0E149IQZ5TogvBUE8ghCSVV+QBnv48Y+sn4z9fY5ywZA1peI5s4TplQI0TADBhPZXEIzMOdmbNsDGGlGcKOAq8ixd1Epzdu9XfvRzdLOO6o3zQwTZxXsjOgGBW8JTcgCP9W9iYiIjHIdZ2VCAnmMzuyVkyED8gymEevH10QoclyH/O3s8Yq6VF34gMXihDQeiI8PyiAZrW0JWXSWpdy3n4yGtAqMAgv46FzTA+XJ6C********
    EndUserId

    string

    無影便捷帳號的使用者名稱。

    alice
    ExpireTime

    string

    授權碼到期時間，採用 ISO 8601 標準的 UTC 時間。

    2015-01-23T12:33:18Z

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "AuthModel": {
    "AuthCode": "acv2ZEq2TNSqOlX+DvyetHGRT08iPhbWg/os1W4HojpBxkMQZkAnbKSfz/wNvS0E149IQZ5TogvBUE8ghCSVV+QBnv48Y+sn4z9fY5ywZA1peI5s4TplQI0TADBhPZXEIzMOdmbNsDGGlGcKOAq8ixd1Epzdu9XfvRzdLOO6o3zQwTZxXsjOgGBW8JTcgCP9W9iYiIjHIdZ2VCAnmMzuyVkyED8gymEevH10QoclyH/O3s8Yq6VF34gMXihDQeiI8PyiAZrW0JWXSWpdy3n4yGtAqMAgv46FzTA+XJ6C********",
    "EndUserId": "alice",
    "ExpireTime": "2015-01-23T12:33:18Z"
  }
}

    錯誤碼

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

    變更歷史

    更多資訊，參考變更詳情。