全部產品
Search

搜尋本產品

    Elastic Desktop Service：GetConnectionTicket - 擷取串連憑證

    文件中心

    Elastic Desktop Service：GetConnectionTicket - 擷取串連憑證

    更新時間：Mar 17, 2026

    擷取雲電腦串連憑證。

    介面說明

    雲電腦的狀態必須為運行中（Running），使用該介面擷取的 Ticket 到期時間為 10 分鐘。

    調試

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

    調試

    授權資訊

    當前API暫無授權資訊透出。

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    地區 ID。可以調用 DescribeRegions 擷取無影雲電腦支援的地區列表。

    cn-hangzhou
    EndUserId

    string

    否

    雲電腦授權使用者的使用者名稱。必須傳入雲電腦現有的授權使用者才能成功產生憑證。

    alice
    Password

    string

    否

    雲電腦授權使用者的密碼。

    Ab123456
    TaskId

    string

    否

    雲電腦串連任務 ID。

    2afbad19-778a-4fc5-9674-1f19c638****
    DesktopId

    string

    否

    需產生串連憑證的雲電腦 ID。必須傳入該欄位才能成功產生憑證。

    ecd-gx2x1dhsmucyy****
    Uuid

    string

    否

    用戶端唯一標識。若使用無影用戶端，可在用戶端登入介面的關於對話方塊中查看該參數。

    28c80e90-f71e-4c23-93d6-1225329cf949
    CommandContent

    string

    否

    當前參數可以配置自訂使用者態應用，當成功擷取憑證後，自動執行應用。

    • appPath：String 類型，應用開機檔案路徑，例如："C:\\Program Files (x86)\\000\\000.exe"，注意路徑分隔字元要用雙斜杠（\\）。

    • appParameter：String 類型，應用啟動參數，例如："meetingid 000 meetingname aaa"，注意參數與參數之間直接用空格。

    { "startApplication": { "startApplicationList": [ { "sessionName": "", "appList": [ { "appPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe", "appParameter": "www.example.com www.example1.com" } ] } ] } }

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

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

    string

    任務狀態。

    枚舉值：

    • FAILED :

      擷取憑證失敗

    • RUNNING :

      擷取憑證中

    • FINISHED :

      擷取完成

    FINISHED
    Ticket

    string

    雲電腦串連憑證。

    W0VuY29kaW5nXQ0KSW5wdXRFbmNvZGluZz1V********
    TaskId

    string

    雲電腦串連任務 ID。

    2afbad19-778a-4fc5-9674-1f19c638****
    TaskCode

    string

    用於串連使用者執行個體的 Ticket，使用時需要先將其內容執行 base64 的解碼，並儲存為 xxx.ica 檔案，然後開啟這個檔案。Python 程式碼範例：

    import base64
response = {
    "Ticket": "W0VuY29kaW5nXQ0KSW5wdXRFbmNvZGluZz1V********",
    "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
}
f = open ('xxx.ica', 'w')
out = base64.b64decode(response['Ticket'])
f.write(out)
f.close()

    W0VuY29kaW5nXQ0KSW5wdXRFbmNvZGluZz1V********
    TaskMessage

    string

    雲電腦串連任務 ID。

    2afbad19-778a-4fc5-9674-1f19c638****
    DesktopId

    string

    雲電腦 ID。

    ecd-gx2x1dhsmucyy****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "TaskStatus": "FINISHED",
  "Ticket": "W0VuY29kaW5nXQ0KSW5wdXRFbmNvZGluZz1V********",
  "TaskId": "2afbad19-778a-4fc5-9674-1f19c638****",
  "TaskCode": "W0VuY29kaW5nXQ0KSW5wdXRFbmNvZGluZz1V********",
  "TaskMessage": "2afbad19-778a-4fc5-9674-1f19c638****",
  "DesktopId": "ecd-gx2x1dhsmucyy****"
}

    錯誤碼

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

    變更歷史

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