Consulta uma lista de recursos do usuário.
Descrição da operação
Antes de chamar esta operação, certifique-se de compreender os tipos de recursos e produtos do Wuying Workspace.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| ClientId |
string |
Sim |
Um ID exclusivo gerado pelo cliente, semelhante a um UUID. Este parâmetro não é sensível e não requer criptografia. |
54c17e1d-2d72-4b87-aa33-25f3b3f2**** |
| ClientType |
string |
Não |
O tipo do cliente. Valores válidos:
|
windows |
| ClientVersion |
string |
Não |
A versão do cliente. |
7.6.0-R-20241112.222305 |
| LoginToken |
string |
Sim |
A credencial de logon. Obtenha este token chamando a operação GetLoginToken. Após fazer logon, você também pode chamar a operação RefreshLoginToken para obter um token atualizado. O token é retornado no parâmetro LoginToken. |
v18101ac6a9e69c66b04a163031680463660b4b216cd758f34b60b9ad6a7c7f7334b83dd8f75eef4209c68f9f1080b**** |
| SessionId |
string |
Não |
O ID da sessão. Obtenha este ID chamando a operação GetLoginToken. |
cd45e873-650d-4d70-acb9-f996187a**** |
| LoginRegionId |
string |
Não |
O ID da região onde você faz logon. Este parâmetro é obrigatório quando você faz logon usando um ID de rede de escritório. Você não precisa especificar este parâmetro quando faz logon usando um ID de organização. |
cn-hangzhou |
| SearchRegionId |
string |
Não |
O ID da região a ser pesquisada. Este parâmetro filtra as informações de recursos em nuvem na região especificada. |
cn-hangzhou |
| OfficeSiteIds |
array |
Não |
Uma lista de IDs de rede de escritório. Especifique este parâmetro quando fizer logon com uma conta do Active Directory (AD). |
|
|
string |
Não |
O ID da rede de escritório. |
cn-hangzhou+dir-5440**** |
|
| ResourceTypes |
array |
Não |
Uma lista de tipos de recursos. Se você deixar este campo vazio, todos os tipos de recursos serão consultados. |
|
|
string |
Não |
O tipo de recurso. Valores válidos:
|
Desktop |
|
| ProductTypes |
array |
Não |
Uma lista de tipos de produtos. Se você deixar este campo vazio, todos os tipos de produtos serão consultados. |
|
|
string |
Não |
O tipo de produto. Valores válidos:
|
CloudApp |
|
| ResourceIds |
array |
Não |
Uma lista de IDs de recursos. Você pode especificar de 0 a 100 IDs. |
|
|
string |
Não |
O ID do recurso. |
ecd-00001 |
|
| ResourceName |
string |
Não |
O nome do recurso. A pesquisa aproximada é suportada. |
testName |
| ProtocolType |
string |
Não |
O tipo de protocolo. Este parâmetro é usado apenas para filtrar cloud desktops. Valores válidos:
|
ASP |
| AccessType |
string |
Não |
O tipo de acesso. Se você não especificar este parâmetro, os recursos de ambos os tipos de acesso serão retornados. Valores válidos:
|
INTERNET |
| Language |
string |
Não |
O idioma do cliente. Valores válidos:
|
zh-CN |
| CategoryType |
integer |
Não |
A categoria de recurso de nível superior. |
1 |
| CategoryId |
integer |
Não |
A categoria de recurso de segundo nível. |
0 |
| QueryFotaUpdate |
boolean |
Não |
Especifica se devem ser consultadas as informações da versão da imagem do cloud desktop. |
false |
| RefreshFotaUpdate |
boolean |
Não |
Especifica se as informações over-the-air (OTA) devem ser atualizadas em tempo real. |
false |
| OrderBy |
string |
Não |
O campo a ser usado para classificação. Se você não especificar este parâmetro, os resultados serão classificados por hora de criação em ordem decrescente. Valores válidos:
|
AssignTime |
| SortType |
string |
Não |
A ordem de classificação. Valores válidos:
|
ASC |
| MaxResults |
integer |
Não |
O número de entradas a serem retornadas em cada página para uma consulta paginada. Valor padrão: 500. |
500 |
| NextToken |
string |
Não |
O token para a próxima página. |
caeba0bbb2be03f84eb48b699f0a4883 |
| AutoRefresh |
boolean |
Não |
Especifica se deve atualizar imediatamente. Nota
Para garantir uma resposta rápida, defina este parâmetro como false. Valores válidos:
|
false |
| Scene |
string |
Não |
O cenário do cliente, usado para identificar a ordem de classificação. Defina o valor como desktop. Valores válidos:
|
desktop |
DualCenterForward
deprecated
|
boolean |
Não |
Especifica se o encaminhamento de centro duplo deve ser usado. Defina o valor como false. Valores válidos:
|
false |
| QueryDesktopTimers |
boolean |
Não |
Especifica se as informações sobre tarefas agendadas para o cloud desktop devem ser consultadas. O valor padrão é true. Valores válidos:
|
true |
| QueryDesktopDurationList |
boolean |
Não |
Especifica se as informações sobre planos de cloud desktop devem ser consultadas. O valor padrão é true. Valores válidos:
|
true |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| NextToken |
string |
O token que marca o início da próxima página de uma consulta paginada. Se este parâmetro estiver vazio, nenhum outro dado será retornado. |
AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL**** |
| RequestId |
string |
O ID da solicitação. |
1CBAFFAB-B697-4049-A9B1-67E1FC5F**** |
| QueryFailedResourceTypes |
array |
Uma lista de tipos de recursos para os quais a consulta falhou. |
|
|
string |
O tipo de recurso. Valores válidos:
|
CloudDesktop |
|
| Resources |
array<object> |
Uma lista de detalhes dos recursos. |
|
|
array<object> |
Os detalhes do recurso. |
||
| AliUid |
integer |
O ID da conta Alibaba Cloud. |
194101959**** |
| ResourceType |
string |
O tipo de recurso. Valores válidos:
|
Desktop |
| RegionId |
string |
O ID da região. |
cn-hangzhou |
| RegionLocation |
string |
A localização da região. Valores válidos:
|
Mainland |
| ResourceGroupId |
string |
O ID do grupo de recursos. |
dg-0**** |
| ResourceId |
string |
O ID do recurso. |
ecd-d19tya8zi4**** |
| ResourceLevel |
string |
O nível do recurso. Valores válidos:
|
Center |
| CenterResourceId |
string |
O ID do recurso centralizado. |
ecds-0**** |
| ResourceName |
string |
O nome do recurso. |
testName01 |
| CreateTime |
string |
A hora em que o recurso foi criado. |
2024-12-11T07:12:12Z |
| ProductType |
string |
O tipo de produto. Valores válidos:
|
AndroidCloud |
| OfficeSiteId |
string |
O ID da rede de escritório. |
cn-shanghai+dir-3367**** |
| AccessType |
string |
O tipo de acesso. Valores válidos:
|
INTERNET |
| ProtocolType |
string |
O tipo de protocolo. Valores válidos:
|
ASP |
| OsType |
string |
O tipo de sistema operacional. Valores válidos:
|
Windows |
| Os |
string |
Informações sobre a plataforma do sistema operacional. |
Windows Server 2022 |
| OsDescription |
string |
Uma descrição da plataforma do sistema operacional. |
Windows 正版授权 |
| SupportHibernation |
boolean |
Indica se a hibernação é suportada. Valores válidos:
|
true |
| HibernationBeta |
boolean |
Indica se esta é uma versão beta para teste de hibernação. Valores válidos:
|
false |
| SessionType |
string |
O tipo de sessão. Valores válidos:
|
SINGLE_SESSION |
| ChargeType |
string |
O método de cobrança. Valores válidos:
|
PrePaid |
| SubPayType |
string |
O submétodo de cobrança. Valores válidos:
|
PrePaid |
| ExpiredTime |
string |
O tempo de expiração para recursos de assinatura. |
2025-02-22T16:00:00Z |
| AuthMode |
string |
O modo de autorização para o aplicativo em nuvem. Valores válidos:
|
App |
| AppId |
string |
O ID do aplicativo. Este parâmetro é específico para recursos do tipo App. |
app-0001 |
| Version |
string |
A versão do recurso. Este parâmetro é específico para recursos do tipo App. |
Resource version. |
| CategoryType |
integer |
A categoria de recurso de nível superior. Este parâmetro é específico para recursos do tipo App. |
1 |
| CategoryId |
integer |
A categoria de recurso de segundo nível. Este parâmetro é específico para recursos do tipo App. |
0 |
| Icon |
string |
A URL do ícone do recurso. Este parâmetro é específico para recursos do tipo App. |
http://example.com/icon.png |
| ThemeColor |
string |
A cor do tema do recurso. Este parâmetro é específico para recursos do tipo App. |
#FFFFFF |
| CdsName |
string |
O nome do cloud drive. Este parâmetro é específico para recursos do tipo CloudDrive. |
cn-shanghai+cds-695277**** |
| ExternalDomainId |
string |
O ID do domínio externo. Este parâmetro é específico para recursos do tipo CloudDrive. |
stg114510 |
| ExternalUserId |
string |
O ID do usuário externo. Este parâmetro é específico para recursos do tipo CloudDrive. |
test001 |
| GlobalStatus |
boolean |
Indica se o acesso entre regiões é suportado. Este parâmetro é específico para recursos do tipo CloudDrive. |
true |
| LocalName |
string |
O nome da região. |
华东1(杭州) |
| DesktopTimers |
array<object> |
Uma lista de configurações de tarefas agendadas para o cloud desktop. |
|
|
object |
As configurações de tarefas agendadas para o cloud desktop. |
||
| TimerType |
string |
The task type. |
TimerBoot |
| CronExpression |
string |
The cron expression for the scheduled task. |
0 30 13 ? * 1-7 |
| Interval |
integer |
The interval for the scheduled task. |
15 |
| Enforce |
boolean |
Indicates whether the task is forcibly executed. |
false |
| ResetType |
string |
The reset type. |
RESET_TYPE_SYSTEM |
| AllowClientSetting |
string |
Indicates whether client-side settings are allowed. |
false |
| OperationType |
string |
The operation type. |
Hibernate |
| ExecutionTime |
string |
The execution time. |
2025-01-21T11:37Z |
| Clients |
array<object> |
Uma lista de tipos de cliente suportados pelo recurso. |
|
|
object |
Configurações para um único tipo de cliente suportado pelo recurso. |
||
| ClientType |
string |
The client type. |
windows |
| Status |
string |
The support status. Valores válidos:
|
ON |
| ResourceStatus |
string |
O status do recurso. Valores válidos:
|
Running |
| LastStartTime |
string |
A última vez que o recurso foi iniciado. |
2025-01-24T03:12:04Z |
| OrderStatus |
string |
O status do pedido. Valores válidos:
|
Normal |
| ManagementStatuses |
array |
Uma lista de status de gerenciamento. |
|
|
string |
O status de gerenciamento. |
NoFlag |
|
| ResourceSessionStatus |
string |
O status da sessão. Valores válidos:
|
Connected |
| Sessions |
array<object> |
Uma lista de informações de sessão do usuário para o recurso. |
|
|
object |
As informações de sessão do usuário para o recurso. |
||
| UserId |
string |
The username used to log on to the resource. |
user001 |
| UserPrincipalName |
string |
The User Principal Name (UPN) of the user to whom the resource is bound, if available. This parameter has a value only for the session of the current user who is making the query. |
benchmark_test@test.shenzhen |
| ResourceSessionStartTime |
string |
The time when the resource session was connected. |
2025-01-22T11:03:36Z |
| NickName |
string |
The user's nickname. |
user-001 |
| RealDesktopId |
string |
[Cloud desktop compartilhado] O ID real do cloud desktop. Este parâmetro é retornado quando existe uma sessão no cloud desktop compartilhado. |
ecd-0001 |
| UserCustomName |
string |
O nome personalizado definido pelo usuário. |
My cloud desktop |
| FotaUpdate |
object |
As informações de atualização do cloud desktop. |
|
| Project |
string |
The project name. |
wuying-asp_single_session_desktop_win_x64 |
| Channel |
string |
The channel. |
aliyun |
| CurrentAppVersion |
string |
The current image version of the cloud desktop. |
2.7.0-R-20250122.154826 |
| NewAppVersion |
string |
The version to which the cloud desktop can be upgraded. |
2.7.0-R-20250125.154826 |
| Force |
boolean |
Indicates whether the upgrade is mandatory. |
false |
| ReleaseNote |
string |
The description of the new version. |
新版本 |
| Size |
string |
The size of the upgrade package. Unit: KB. |
474981930 |
| ReleaseNoteEn |
string |
The English description of the new version. |
new version |
| ReleaseNoteJp |
string |
The Japanese description of the new version. |
新バージョン |
| NewDcdVersion |
string |
The version of the component disk to which the cloud desktop can be upgraded. |
2.6.9-R-20250123.153415 |
| OsUpdate |
object |
As informações de atualização do sistema operacional. |
|
| CheckId |
string |
The check ID. |
wua-1740652957251743*** |
| PackageCount |
integer |
The number of packages. |
1 |
| Packages |
array<object> |
A list of patch package information. |
|
|
object |
The patch package information. |
||
| Kb |
string |
The patch number. |
KB2267*** |
| Title |
string |
The patch title. |
Patch for ****. |
| Description |
string |
The patch description. |
安装此更新可修改用于检测病毒、间谍软件和其他潜在不需要的软件的文件。此项一旦安装,便无法删除。 |
| KbListString |
string |
Information about the list of patch numbers. |
KB2267*** |
| UpdateCatalogUrl |
string |
The update category URL. |
https://catalog.update.microsoft.com/home.aspx |
| HasUpgrade |
boolean |
Indica se existe uma atualização. |
true |
| DesktopDurationList |
array<object> |
Uma lista de informações de planos de cloud desktop. |
|
|
object |
As informações do plano de cloud desktop. |
||
| PackageCreationTime |
string |
The creation time. |
2025-01-17T07:01Z |
| PackageStatus |
string |
The status. |
Available |
| UsedDuration |
integer |
The used duration. |
16850 |
| PackageExpiredTime |
string |
The expiration time. |
2025-02-17T15:59Z |
| PackageId |
string |
The plan ID. |
mdp-0bxls4qpi6bl6**** |
| TotalDuration |
integer |
The total duration. |
432000 |
| PackageType |
string |
The duration plan type. Valores válidos:
|
NORMAL_PACKAGE |
| PeriodStartTime |
string |
The start time of the monthly plan. |
2025-01-17T07:01Z |
| PeriodEndTime |
string |
The end time of the monthly plan. |
2025-02-17T15:59Z |
| PostPaidLimitFee |
number |
The capped amount for the second-stage plan. Nota
This parameter is returned only when `ResourceType` is |
199 |
| OrderInstanceId |
string |
The order instance ID. |
mdp-0bxls4qpi6bl6**** |
| PackageUsedUpStrategy |
string |
The policy for the cloud desktop status after the monthly quota of the plan is used up. Valores válidos:
|
Postpaid |
| ConnectionProperties |
string |
As propriedades de conexão, que é uma string JSON. O cliente não precisa analisar o conteúdo. Quando um recurso de aplicativo estabelece uma conexão, esta string é passada diretamente para o controle central de recursos. |
{"authMode":"App"} |
| SupportedActions |
array |
Uma lista de tipos de operação suportados. Atualmente, isso é suportado apenas para cloud phones e cloud desktops (incluindo cloud desktops compartilhados). |
|
|
string |
O tipo de operação. Valores válidos:
|
Start |
|
| SupportAgentIm |
boolean |
||
| AgentImUrl |
string |
https://wuying.aliyun.com/OpenIM/chat?desktopId=ecd-xxxxx |
|
| RankVersion |
integer |
O número da versão dos dados de classificação. |
1732869815062 |
| TotalCount |
integer |
O número total. |
10 |
| MaxResults |
integer |
O número máximo de entradas retornadas. |
100 |
| AgentBriefSummary |
object |
||
| TotalCount |
integer |
10 |
|
| AgentBriefs |
array<object> |
||
|
object |
|||
| AgentPlatform |
string |
ENTERPRISE_JVS |
|
| AgentProvider |
string |
OpenClaw |
|
| Count |
integer |
2 |
|
| AvatarUrl |
string |
https://abc.com/efg.png |
|
| Url |
string |
https://test.png |
|
| DisplayName |
string |
JVS Claw |
|
| SubTitle |
string |
智在进化,快乐养虾 |
|
| AvatarNoResourceUrl |
string |
https://xxx.png |
Nem todos os parâmetros de resposta estão disponíveis para cada recurso. Certifique-se de saber quais parâmetros são retornados para cada tipo de recurso.
Exemplos
Resposta de sucesso
JSON formato
{
"NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL****",
"RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
"QueryFailedResourceTypes": [
"CloudDesktop"
],
"Resources": [
{
"AliUid": 0,
"ResourceType": "Desktop",
"RegionId": "cn-hangzhou",
"RegionLocation": "Mainland",
"ResourceGroupId": "dg-0****",
"ResourceId": "ecd-d19tya8zi4****",
"ResourceLevel": "Center",
"CenterResourceId": "ecds-0****",
"ResourceName": "testName01",
"CreateTime": "2024-12-11T07:12:12Z",
"ProductType": "AndroidCloud",
"OfficeSiteId": "cn-shanghai+dir-3367****",
"AccessType": "INTERNET",
"ProtocolType": "ASP",
"OsType": "Windows",
"Os": "Windows Server 2022",
"OsDescription": "Windows 正版授权",
"SupportHibernation": true,
"HibernationBeta": false,
"SessionType": "SINGLE_SESSION",
"ChargeType": "PrePaid",
"SubPayType": "PrePaid",
"ExpiredTime": "2025-02-22T16:00:00Z",
"AuthMode": "App",
"AppId": "app-0001",
"Version": "Resource version.",
"CategoryType": 1,
"CategoryId": 0,
"Icon": "http://example.com/icon.png",
"ThemeColor": "#FFFFFF",
"CdsName": "cn-shanghai+cds-695277****",
"ExternalDomainId": "stg114510",
"ExternalUserId": "test001",
"GlobalStatus": true,
"LocalName": "华东1(杭州)",
"DesktopTimers": [
{
"TimerType": "TimerBoot",
"CronExpression": "0 30 13 ? * 1-7",
"Interval": 15,
"Enforce": false,
"ResetType": "RESET_TYPE_SYSTEM",
"AllowClientSetting": "false",
"OperationType": "Hibernate",
"ExecutionTime": "2025-01-21T11:37Z"
}
],
"Clients": [
{
"ClientType": "windows",
"Status": "ON"
}
],
"ResourceStatus": "Running",
"LastStartTime": "2025-01-24T03:12:04Z",
"OrderStatus": "Normal",
"ManagementStatuses": [
"NoFlag"
],
"ResourceSessionStatus": "Connected",
"Sessions": [
{
"UserId": "user001",
"UserPrincipalName": "benchmark_test@test.shenzhen",
"ResourceSessionStartTime": "2025-01-22T11:03:36Z",
"NickName": "user-001"
}
],
"RealDesktopId": "ecd-0001",
"UserCustomName": "My cloud desktop",
"FotaUpdate": {
"Project": "wuying-asp_single_session_desktop_win_x64",
"Channel": "aliyun",
"CurrentAppVersion": "2.7.0-R-20250122.154826",
"NewAppVersion": "2.7.0-R-20250125.154826",
"Force": false,
"ReleaseNote": "新版本",
"Size": "474981930",
"ReleaseNoteEn": "new version",
"ReleaseNoteJp": "新バージョン",
"NewDcdVersion": "2.6.9-R-20250123.153415"
},
"OsUpdate": {
"CheckId": "wua-1740652957251743***",
"PackageCount": 1,
"Packages": [
{
"Kb": "KB2267***",
"Title": "Patch for ****.",
"Description": "安装此更新可修改用于检测病毒、间谍软件和其他潜在不需要的软件的文件。此项一旦安装,便无法删除。"
}
],
"KbListString": "KB2267***",
"UpdateCatalogUrl": "https://catalog.update.microsoft.com/home.aspx"
},
"HasUpgrade": true,
"DesktopDurationList": [
{
"PackageCreationTime": "2025-01-17T07:01Z",
"PackageStatus": "Available",
"UsedDuration": 16850,
"PackageExpiredTime": "2025-02-17T15:59Z",
"PackageId": "mdp-0bxls4qpi6bl6****",
"TotalDuration": 432000,
"PackageType": "NORMAL_PACKAGE",
"PeriodStartTime": "2025-01-17T07:01Z",
"PeriodEndTime": "2025-02-17T15:59Z",
"PostPaidLimitFee": 199,
"OrderInstanceId": "mdp-0bxls4qpi6bl6****",
"PackageUsedUpStrategy": "Postpaid"
}
],
"ConnectionProperties": "{\"authMode\":\"App\"}",
"SupportedActions": [
"Start"
],
"SupportAgentIm": false,
"AgentImUrl": "https://wuying.aliyun.com/OpenIM/chat?desktopId=ecd-xxxxx"
}
],
"RankVersion": 1732869815062,
"TotalCount": 10,
"MaxResults": 100,
"AgentBriefSummary": {
"TotalCount": 10,
"AgentBriefs": [
{
"AgentPlatform": "ENTERPRISE_JVS",
"AgentProvider": "OpenClaw",
"Count": 2,
"AvatarUrl": "https://abc.com/efg.png",
"Url": "https://test.png",
"DisplayName": "JVS Claw",
"SubTitle": "智在进化,快乐养虾",
"AvatarNoResourceUrl": "https://xxx.png"
}
]
}
}
Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.