Mengambil informasi mengenai resource pengguna.
Deskripsi operasi
Sebelum memanggil operasi ini, pastikan untuk memverifikasi jenis resource dan layanan yang didukung di Alibaba Cloud Workspace.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| ClientId |
string |
Yes |
ID client. Sistem menghasilkan ID unik untuk setiap client. Parameter ini tidak sensitif dan tidak perlu dienkripsi. |
54c17e1d-2d72-4b87-aa33-25f3b3f2**** |
| ClientType |
string |
No |
Jenis client. Nilai yang valid:
Valid values:
|
windows |
| ClientVersion |
string |
No |
Versi client. |
7.6.0-R-20241112.222305 |
| LoginToken |
string |
Yes |
Token login. Anda dapat memanggil operasi |
v18101ac6a9e69c66b04a163031680463660b4b216cd758f34b60b9ad6a7c7f7334b83dd8f75eef4209c68f9f1080b**** |
| SessionId |
string |
No |
ID sesi. Anda dapat memanggil operasi |
cd45e873-650d-4d70-acb9-f996187a**** |
| LoginRegionId |
string |
No |
ID wilayah tempat pengguna akhir login ke client. Parameter ini berlaku untuk login berbasis ID jaringan kantor. Untuk login berbasis ID organisasi, Anda dapat mengosongkan parameter ini. |
cn-hangzhou |
| SearchRegionId |
string |
No |
ID wilayah yang dicari. Anda dapat menentukan parameter ini untuk memfilter resource cloud di wilayah tertentu. |
cn-hangzhou |
| OfficeSiteIds |
array |
No |
ID jaringan kantor. Parameter ini wajib untuk login menggunakan akun Active Directory (AD) perusahaan. |
|
|
string |
No |
ID jaringan kantor. |
cn-hangzhou+dir-5440**** |
|
| ResourceTypes |
array |
No |
Jenis resource. Jika Anda mengosongkan parameter ini, semua jenis resource yang didukung akan ditanyakan. |
|
|
string |
No |
Jenis resource. Nilai yang valid:
Valid values:
|
Desktop |
|
| ProductTypes |
array |
No |
Jenis layanan. Jika Anda mengosongkan parameter ini, semua jenis layanan yang didukung akan ditanyakan. |
|
|
string |
No |
Jenis layanan. Nilai yang valid:
Valid values:
|
CloudApp |
|
| ResourceIds |
array |
No |
ID resource. Anda dapat menentukan hingga 100 ID resource. |
|
|
string |
No |
ID resource. |
ecd-00001 |
|
| ResourceName |
string |
No |
Nama resource. Pencarian fuzzy didukung. |
testName |
| ProtocolType |
string |
No |
Jenis protokol. Anda dapat menentukan parameter ini untuk memfilter komputer cloud. Nilai yang valid:
Valid values:
|
ASP |
| AccessType |
string |
No |
Jenis akses. Jika Anda mengosongkan parameter ini, kedua jenis akan ditampilkan. Nilai yang valid:
Valid values:
|
INTERNET |
| Language |
string |
No |
Bahasa client. Nilai yang valid:
Valid values:
|
zh-CN |
| CategoryType |
integer |
No |
Kategori resource tingkat-1. |
1 |
| CategoryId |
integer |
No |
Kategori resource tingkat-2. |
0 |
| QueryFotaUpdate |
boolean |
No |
Menentukan apakah akan mengembalikan informasi versi gambar komputer cloud. |
false |
| RefreshFotaUpdate |
boolean |
No |
Menentukan apakah akan menyegarkan informasi over-the-air (OTA) secara real time. |
false |
| OrderBy |
string |
No |
Bidang pengurutan. Jika Anda tidak menentukan parameter ini, resource diurutkan berdasarkan waktu pembuatan secara default. Nilai yang valid:
Valid values:
|
AssignTime |
| SortType |
string |
No |
Metode pengurutan. Nilai yang valid:
Valid values:
|
ASC |
| MaxResults |
integer |
No |
Jumlah entri per halaman. Nilai default: 500. |
500 |
| NextToken |
string |
No |
Token paginasi. Dapat digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. |
caeba0bbb2be03f84eb48b699f0a4883 |
| AutoRefresh |
boolean |
No |
Menentukan apakah akan mengaktifkan fitur penyegaran langsung. Catatan
Untuk memastikan kecepatan respons operasi, kami menyarankan agar Anda menyetel nilai ke Nilai yang valid:
Valid values:
|
false |
| Scene |
string |
No |
Skenario penggunaan client. Tetapkan nilai ke Nilai yang valid:
Valid values:
|
desktop |
DualCenterForward
deprecated
|
boolean |
No |
Menentukan apakah akan mengaktifkan penerusan geo-redundan. Tetapkan nilai ke Nilai yang valid:
Valid values:
|
false |
| QueryDesktopTimers |
boolean |
No |
Apakah akan menanyakan informasi tugas terjadwal komputer cloud, default bernilai true. Valid values:
|
true |
| QueryDesktopDurationList |
boolean |
No |
Apakah akan menanyakan informasi paket langganan komputer cloud, default bernilai true. Valid values:
|
true |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| NextToken |
string |
Token paginasi. Dapat digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Jika NextToken kosong, berarti tidak ada halaman berikutnya. |
AAAAAV3MpHK1AP0pfERHZN5pu6nmB7qrRFJ8vmttjxPL**** |
| RequestId |
string |
ID permintaan. |
1CBAFFAB-B697-4049-A9B1-67E1FC5F**** |
| QueryFailedResourceTypes |
array |
Jenis resource yang gagal ditanyakan. |
|
|
string |
Jenis resource yang gagal ditanyakan. Nilai yang valid:
Valid values:
|
CloudDesktop |
|
| Resources |
array<object> |
Resource. |
|
|
array<object> |
Resource. |
||
| AliUid |
integer |
ID Akun Alibaba Cloud. |
194101959**** |
| ResourceType |
string |
Jenis resource. Nilai yang valid:
Valid values:
|
Desktop |
| RegionId |
string |
ID wilayah. |
cn-hangzhou |
| RegionLocation |
string |
Lokasi geografis. Nilai yang valid:
Valid values:
|
Mainland |
| ResourceGroupId |
string |
ID kelompok sumber daya. |
dg-0**** |
| ResourceId |
string |
ID resource. |
ecd-d19tya8zi4**** |
| ResourceLevel |
string |
Tingkat resource. Nilai yang valid:
Valid values:
|
Center |
| CenterResourceId |
string |
ID resource terpusat. |
ecds-0**** |
| ResourceName |
string |
Nama resource. |
testName01 |
| CreateTime |
string |
Waktu saat resource dibuat. |
2024-12-11T07:12:12Z |
| ProductType |
string |
Jenis layanan. Nilai yang valid:
Valid values:
|
AndroidCloud |
| OfficeSiteId |
string |
ID jaringan kantor. |
cn-shanghai+dir-3367**** |
| AccessType |
string |
Jenis akses. Nilai yang valid:
Valid values:
|
INTERNET |
| ProtocolType |
string |
Jenis protokol. Nilai yang valid:
Valid values:
|
ASP |
| OsType |
string |
Jenis OS. Nilai yang valid:
Valid values:
|
Windows |
| Os |
string |
Platform OS. |
Windows Server 2022 |
| OsDescription |
string |
Deskripsi platform OS. |
Windows 正版授权 |
| SupportHibernation |
boolean |
Menunjukkan apakah hibernasi didukung. Nilai yang valid:
Valid values:
|
true |
| HibernationBeta |
boolean |
Menunjukkan apakah ini adalah versi beta dari fitur hibernasi. Nilai yang valid:
Valid values:
|
false |
| SessionType |
string |
Jenis sesi. Nilai yang valid:
Valid values:
|
SINGLE_SESSION |
| ChargeType |
string |
Metode penagihan. Nilai yang valid:
Valid values:
|
PrePaid |
| SubPayType |
string |
Metode penagihan sub. Nilai yang valid:
Valid values:
|
PrePaid |
| ExpiredTime |
string |
Waktu kedaluwarsa resource langganan. |
2025-02-22T16:00:00Z |
| AuthMode |
string |
Mode otorisasi aplikasi cloud. Nilai yang valid:
Valid values:
|
App |
| AppId |
string |
ID aplikasi. Parameter ini hanya untuk aplikasi. |
app-0001 |
| Version |
string |
Versi resource. Parameter ini hanya untuk aplikasi. |
资源版本。 |
| CategoryType |
integer |
Kategori resource tingkat-1. Parameter ini hanya untuk aplikasi. |
1 |
| CategoryId |
integer |
Kategori resource tingkat-2. Parameter ini hanya untuk aplikasi. |
0 |
| Icon |
string |
Ikon resource. Parameter ini hanya untuk aplikasi. |
http://example.com/icon.png |
| ThemeColor |
string |
Warna tema resource. Parameter ini hanya untuk aplikasi. |
#FFFFFF |
| CdsName |
string |
Nama drive. Parameter ini hanya untuk drive perusahaan. |
cn-shanghai+cds-695277**** |
| ExternalDomainId |
string |
ID domain eksternal. Parameter ini hanya untuk drive perusahaan. |
stg114510 |
| ExternalUserId |
string |
ID pengguna eksternal. Parameter ini hanya untuk drive perusahaan. |
test001 |
| GlobalStatus |
boolean |
Menunjukkan apakah akses lintas wilayah didukung. Parameter ini hanya untuk drive perusahaan. |
true |
| LocalName |
string |
Nama wilayah. |
华东1(杭州) |
| DesktopTimers |
array<object> |
Tugas terjadwal untuk komputer cloud. |
|
|
object |
Tugas terjadwal. |
||
| TimerType |
string |
Jenis tugas. |
TimerBoot |
| CronExpression |
string |
Ekspresi cron yang ditentukan dalam tugas terjadwal. |
0 30 13 ? * 1-7 |
| Interval |
integer |
Interval eksekusi tugas terjadwal. |
15 |
| Enforce |
boolean |
Menunjukkan apakah tugas terjadwal dieksekusi secara paksa. |
false |
| ResetType |
string |
Opsi reset. |
RESET_TYPE_SYSTEM |
| AllowClientSetting |
string |
Menunjukkan apakah pengguna akhir diizinkan mengonfigurasi tugas terjadwal pada client. |
false |
| OperationType |
string |
Jenis aksi terjadwal. |
Hibernate |
| ExecutionTime |
string |
Waktu eksekusi tugas terjadwal. |
2025-01-21T11:37Z |
| Clients |
array<object> |
Jenis client yang didukung oleh resource. |
|
|
object |
Jenis client yang didukung oleh resource. |
||
| ClientType |
string |
Jenis client. |
windows |
| Status |
string |
Status. Nilai yang valid:
Valid values:
|
ON |
| ResourceStatus |
string |
Status resource. Nilai yang valid:
Valid values:
|
Running |
| LastStartTime |
string |
Waktu terakhir resource dimulai. |
2025-01-24T03:12:04Z |
| OrderStatus |
string |
Status pesanan. Nilai yang valid:
Valid values:
|
Normal |
| ManagementStatuses |
array |
Status manajemen. |
|
|
string |
Status manajemen. |
NoFlag |
|
| ResourceSessionStatus |
string |
Status sesi. Nilai yang valid:
Valid values:
|
Connected |
| Sessions |
array<object> |
Sesi yang dibuat antara pengguna dan resource. |
|
|
object |
Sesi yang dibuat antara pengguna dan resource. |
||
| UserId |
string |
Username yang digunakan untuk login ke resource. |
user001 |
| UserPrincipalName |
string |
Nama Utama Pengguna (UPN) pengguna yang terikat ke resource (jika berlaku). Parameter ini hanya dikembalikan saat Anda menanyakan sesi pengguna saat ini. |
benchmark_test@test.shenzhen |
| ResourceSessionStartTime |
string |
Timestamp saat sesi resource dibuat. |
2025-01-22T11:03:36Z |
| NickName |
string |
Nama panggilan pengguna. |
user-001 |
| RealDesktopId |
string |
ID asli komputer cloud (dari berbagi). Parameter ini hanya dikembalikan saat berbagi komputer cloud memiliki sesi yang sedang berlangsung. |
ecd-0001 |
| UserCustomName |
string |
Nama kustom resource. |
我的云电脑 |
| FotaUpdate |
object |
Info pembaruan komputer cloud. |
|
| Project |
string |
Nama proyek. |
wuying-asp_single_session_desktop_win_x64 |
| Channel |
string |
Saluran. |
aliyun |
| CurrentAppVersion |
string |
Nomor versi saat ini dari gambar komputer cloud. |
2.7.0-R-20250122.154826 |
| NewAppVersion |
string |
Nomor versi target dari gambar komputer cloud. |
2.7.0-R-20250125.154826 |
| Force |
boolean |
Menentukan apakah akan menerapkan pembaruan paksa. |
false |
| ReleaseNote |
string |
Deskripsi versi gambar komputer cloud. |
新版本 |
| Size |
string |
Ukuran paket pembaruan untuk gambar komputer cloud. Satuan: KB. |
474981930 |
| ReleaseNoteEn |
string |
Catatan rilis bahasa Inggris untuk versi gambar baru. |
new version |
| ReleaseNoteJp |
string |
Catatan rilis bahasa Jepang untuk versi gambar baru. |
新バージョン |
| NewDcdVersion |
string |
Versi terbaru yang tersedia untuk memperbarui disk komponen. |
2.6.9-R-20250123.153415 |
| OsUpdate |
object |
Info pembaruan OS. |
|
| CheckId |
string |
ID tugas pemeriksaan. |
wua-1740652957251743*** |
| PackageCount |
integer |
Jumlah paket. |
1 |
| Packages |
array<object> |
Paket patch. |
|
|
object |
Paket patch. |
||
| Kb |
string |
Nomor patch. |
KB2267*** |
| Title |
string |
Judul patch. |
用于****的补丁。 |
| Description |
string |
Deskripsi patch. |
安装此更新可修改用于检测病毒、间谍软件和其他潜在不需要的软件的文件。此项一旦安装,便无法删除。 |
| KbListString |
string |
Nomor patch. |
KB2267*** |
| UpdateCatalogUrl |
string |
URL kategorisasi pembaruan. |
https://catalog.update.microsoft.com/home.aspx |
| HasUpgrade |
boolean |
Menunjukkan apakah ada pembaruan. |
true |
| DesktopDurationList |
array<object> |
Paket langganan komputer cloud. |
|
|
object |
Paket langganan komputer cloud. |
||
| PackageCreationTime |
string |
Waktu pembuatan paket. |
2025-01-17T07:01Z |
| PackageStatus |
string |
Status paket. |
Available |
| UsedDuration |
integer |
Durasi langganan yang dikonsumsi. |
16850 |
| PackageExpiredTime |
string |
Waktu kedaluwarsa paket. |
2025-02-17T15:59Z |
| PackageId |
string |
ID paket. |
mdp-0bxls4qpi6bl6**** |
| TotalDuration |
integer |
Durasi total. |
432000 |
| PackageType |
string |
Jenis paket. Nilai yang valid:
Valid values:
|
NORMAL_PACKAGE |
| PeriodStartTime |
string |
Waktu mulai efektif paket untuk bulan ini. |
2025-01-17T07:01Z |
| PeriodEndTime |
string |
Waktu akhir efektif paket untuk bulan ini. |
2025-02-17T15:59Z |
| PostPaidLimitFee |
number |
Biaya maksimum untuk paket pada fase kedua. Catatan
Parameter ini dikembalikan jika Anda menyetel ResourceType ke |
199 |
| OrderInstanceId |
string |
ID pesanan instans. |
mdp-0bxls4qpi6bl6**** |
| PackageUsedUpStrategy |
string |
Kebijakan status komputer cloud setelah kuota paket bulanan habis. Nilai yang valid:
Valid values:
|
Postpaid |
| ConnectionProperties |
string |
Atribut koneksi dalam format JSON. Client tidak perlu memproses atribut ini; atribut langsung diteruskan ke pusat manajemen resource saat resource aplikasi dibuat. |
{"authMode":"App"} |
| SupportedActions |
array |
Aksi yang didukung. Parameter ini hanya dikembalikan untuk komputer cloud atau ponsel cloud. |
|
|
string |
Aksi yang didukung. Nilai yang valid:
Valid values:
|
Start |
|
| RankVersion |
integer |
Nomor versi data peringkat. |
1732869815062 |
| TotalCount |
integer |
Total jumlah. |
10 |
| MaxResults |
integer |
Jumlah maksimum yang dikembalikan. |
100 |
Parameter respons ini tidak tersedia untuk semua resource. Pastikan Anda mengetahui bidang yang berlaku untuk setiap resource.
Contoh
Respons sukses
JSONformat
{
"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": "资源版本。",
"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": "我的云电脑",
"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": "用于****的补丁。",
"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"
]
}
],
"RankVersion": 1732869815062,
"TotalCount": 10,
"MaxResults": 100
}
Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.