全部產品
Search
文件中心

Elastic Desktop Service:DescribeVirtualMFADevices - 查詢AD帳號綁定的虛擬MFA裝置

更新時間:Mar 13, 2026

查詢AD帳號綁定的虛擬MFA裝置。

調試

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

調試

授權資訊

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

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

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

cn-hangzhou

MaxResults

integer

返回結果的最大數量。取值範圍:1~500。預設值:100。

100

NextToken

string

查詢憑證。取值為上一次調用此 API 時返回的 NextToken 參數值。

caeba0bbb2be03f84eb48b699f0a4883

OfficeSiteId

string

辦公網路識別碼。

cn-hangzhou+dir-269345****

EndUserId

array

AD 帳號的使用者名稱列表。

testuser

string

AD 帳號的使用者名稱。

testuser

Filter

string

返回參數

名稱

類型

描述

樣本值

object

返回資訊集合。

NextToken

string

下一個查詢開始的 Token,NextToken 為空白表示沒有下一個。

AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL23as

RequestId

string

請求 ID。

FB550AAB-FB36-4A91-93F6-F4374AF65403

VirtualMFADevices

array<object>

虛擬 MFA 裝置資訊集合。

array<object>

虛擬 MFA 裝置資訊。

SerialNumber

string

虛擬 MFA 裝置的序號。

a25f297f-f2e1-4a44-bbf1-5f48a6e5****

GmtUnlock

string

虛擬 MFA 裝置被鎖定後的自動解鎖時間。按照ISO 8601標準表示,並使用 UTC+0 時間,格式為 YYYY-MM-DDThh:mm:ssZ。

2020-12-21T15:21:28Z

EndUserId

string

使用該虛擬 MFA 裝置的 AD 帳號使用者名稱。

usertest

ConsecutiveFails

integer

連續綁定或者認證虛擬 MFA 裝置失敗的次數。

1

OfficeSiteId

string

辦公網路識別碼。

cn-hangzhou+dir-269345****

status

string

虛擬 MFA 裝置狀態。

枚舉值:

  • LOCKED :

    鎖定

  • UNBOUND :

    未綁定

  • NORMAL :

    正常

NORMAL

DirectoryId

string

說明

該參數正在邀測中,暫未開放使用。

cn-hangzhou+dir-gx2x1dhsmu52rd****

GmtEnabled

string

虛擬 MFA 裝置啟用時間。按照ISO 8601標準表示,並使用 UTC+0 時間,格式為 YYYY-MM-DDThh:mm:ssZ。

2020-12-20T14:52:28Z

AdUser

object

EndUser

string

DisplayName

string

DisplayNameNew

string

UserPrincipalName

string

樣本

正常返回樣本

JSON格式

{
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL23as",
  "RequestId": "FB550AAB-FB36-4A91-93F6-F4374AF65403",
  "VirtualMFADevices": [
    {
      "SerialNumber": "a25f297f-f2e1-4a44-bbf1-5f48a6e5****",
      "GmtUnlock": "2020-12-21T15:21:28Z",
      "EndUserId": "usertest",
      "ConsecutiveFails": 1,
      "OfficeSiteId": "cn-hangzhou+dir-269345****",
      "status": "NORMAL",
      "DirectoryId": "cn-hangzhou+dir-gx2x1dhsmu52rd****",
      "GmtEnabled": "2020-12-20T14:52:28Z",
      "AdUser": {
        "EndUser": "",
        "DisplayName": "",
        "DisplayNameNew": "",
        "UserPrincipalName": ""
      }
    }
  ]
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情