全部產品
Search

搜尋本產品

    Serverless App Engine：GetWebshellToken - 擷取遠程登入Token

    文件中心

    Serverless App Engine：GetWebshellToken - 擷取遠程登入Token

    更新時間：Apr 23, 2026

    擷取遠程登入執行個體 Web Shell 的 Token。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    sae:GetWebshellToken

    get

    *全部資源

    *

    		 無 無

    請求文法

    GET /pop/v1/sam/instance/webshellToken HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    AppId

    string

    是

    應用 ID。

    017f39b8-dfa4-4e16-a84b-1dcee4b1****
    PodName

    string

    是

    Pod 名稱。

    hello-podsdfsdfsdfsdf
    ContainerName

    string

    否

    容器名稱。

    注意事項：

    • 如果指定了該參數，雲助手將在執行個體的指定容器內執行指令碼。

    • 如果指定了該參數，僅支援在雲助手 Agent 版本不低於 2.2.3.344 的 Linux 執行個體內運行。

    • 如果指定了該參數，本介面中已指定的Username參數和 CreateCommand 中指定的WorkingDir參數將不會生效。僅支援通過容器預設使用者在容器的預設工作目錄下執行命令。更多資訊，請參見使用雲助手在容器內執行命令。

    • 如果指定了該參數，在 Linux 容器中只支援執行 Shell 指令碼，不支援在指令碼開頭使用類似#!/usr/bin/python命令的形式指定指令碼內容的解譯器。更多資訊，請參見使用雲助手在容器內執行命令。

    ad-helper

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    91F93257-7A4A-4BD3-9A7E-2F6EAE6D****
    Message

    string

    調用結果的附加資訊。取值說明如下：

    • 請求正常，返回 success。

    • 請求異常，返回具體異常錯誤碼。

    success
    TraceId

    string

    調用鏈 ID。

    0a98a02315955564772843261e****
    Data

    object

    返回結果。

    Token

    string

    Token 資訊。

    zWWpvRj_5pzof4hfo7-hGynM8oGMmO_7
    HttpUrl

    string

    Webshell 頁面地址

    HttpUrl : "https://sae.console.alibabacloud.com/cn-shenzhen/app-list/app1/micro-app/shell/pod1?tokenId=xxx
    WebSocketUrl

    string

    Websocket 地址

    wss://sae-webshell.console.aliyun.com/websocket/eamWebshell?tokenId=xxx&region=cn-shenzhen
    ErrorCode

    string

    錯誤碼。取值說明如下：

    • 請求成功：不返回 ErrorCode 欄位。

    • 請求失敗：返回 ErrorCode 欄位。具體資訊，請參見本文的錯誤碼目錄。

    Code

    string

    HTTP 狀態代碼。取值說明如下：

    • 2xx：成功。

    • 3xx：重新導向。

    • 4xx：請求錯誤。

    • 5xx：伺服器錯誤。

    200
    Success

    boolean

    是否成功。

    true

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message": "success",
  "TraceId": "0a98a02315955564772843261e****",
  "Data": {
    "Token": "zWWpvRj_5pzof4hfo7-hGynM8oGMmO_7",
    "HttpUrl": "HttpUrl :  \"https://sae.console.alibabacloud.com/cn-shenzhen/app-list/app1/micro-app/shell/pod1?tokenId=xxx",
    "WebSocketUrl": "wss://sae-webshell.console.aliyun.com/websocket/eamWebshell?tokenId=xxx&region=cn-shenzhen"
  },
  "ErrorCode": "",
  "Code": "200",
  "Success": true
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidApplication.NotFound The current application does not exist. 找不到當前應用。
    400 InvalidParameter.NotEmpty You must specify the parameter %s. 不合法的參數：%s不可為空。
    400 InvalidParameter.Obviously The specified parameter is invalid {%s}. 不合法的參數{%s}。
    400 InvalidParameter.WithMessage The parameter is invalid {%s}: %s 不合法的參數{%s}：%s。
    500 OperationFailed.RPCError Internal RPC request processing error. 內部RPC請求處理報錯。

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

    變更歷史

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