全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::ECD::Desktops

更新时间:Jul 06, 2025

ALIYUN::ECD::Desktops digunakan untuk membuat satu atau lebih desktop cloud.

Sintaksis

{
  "Type": "ALIYUN::ECD::Desktops",
  "Properties": {
    "UserAssignMode": String,
    "PromotionId": String,
    "PolicyGroupId": String,
    "UserName": String,
    "AutoRenew": Boolean,
    "Amount": Integer,
    "DesktopName": String,
    "Hostname": String,
    "Period": Integer,
    "VolumeEncryptionEnabled": Boolean,
    "AutoPay": Boolean,
    "GroupId": String,
    "OfficeSiteId": String,
    "DesktopNameSuffix": Boolean,
    "BundleId": String,
    "EndUserId": List,
    "VpcId": String,
    "ChargeType": String,
    "VolumeEncryptionKey": String,
    "Tags": List,
    "PeriodUnit": String,
    "DirectoryId": String
  }
}

Properti

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
UserAssignModeStringTidakTidakMode penugasan desktop cloud yang ingin Anda buat. Nilai default: ALL. Nilai valid:
  • ALL: Jika Anda menentukan properti EndUserId, desktop cloud akan ditugaskan ke setiap pengguna reguler yang Anda tentukan.
  • PER_USER: Jika Anda menentukan properti EndUserId, desktop cloud akan dibagikan secara merata kepada semua pengguna reguler yang Anda tentukan.

    Dalam hal ini, Anda harus memastikan bahwa nilai properti Amount dapat dibagi dengan jumlah ID pengguna reguler yang ditentukan oleh properti EndUserId.

Catatan Jika Anda tidak menentukan properti EndUserId, desktop cloud tidak akan ditugaskan ke pengguna reguler.
PromotionIdStringTidakTidakID promosi penjualan. Tidak ada.
PolicyGroupIdStringYaTidakID kebijakan. Tidak ada.
AutoRenewBooleanTidakTidakMenentukan apakah akan mengaktifkan perpanjangan otomatis. Nilai default: false. Nilai valid:
  • true: mengaktifkan perpanjangan otomatis. Durasi perpanjangan sama dengan durasi langganan yang Anda tentukan untuk parameter Period saat membeli desktop cloud.
  • false: menonaktifkan perpanjangan otomatis.
Catatan Properti ini hanya berlaku jika Anda menetapkan properti ChargeType ke PrePaid.
AmountIntegerTidakTidakJumlah desktop cloud yang ingin Anda buat. Nilai valid: 1 hingga 300.

Nilai default: 1.

DesktopNameStringTidakTidakNama desktop cloud. Tidak ada.
HostnameStringTidakTidakNama host kustom yang Anda tentukan untuk desktop cloud. Anda hanya dapat menentukan nama host kustom untuk desktop cloud Windows di ruang kerja tipe akun Active Directory (AD) perusahaan.
Jika Anda membuat desktop cloud, nama host yang Anda tentukan harus memenuhi persyaratan berikut:
  • Nama host harus memiliki panjang 2 hingga 15 karakter.
  • Nama host dapat berisi huruf, angka, dan tanda hubung (-). Nama host tidak boleh dimulai atau diakhiri dengan tanda hubung (-), berisi tanda hubung (-) berturut-turut, atau hanya berisi angka.

Jika Anda membuat beberapa desktop cloud, nama host yang Anda tentukan harus dalam format name_prefix[begin_number,bits]name_suffix. Sebagai contoh, jika Anda menetapkan properti Hostname ke ecd-[1,4]-test, nama host desktop cloud pertama adalah ecd-0001-test dan nama host desktop cloud kedua adalah ecd-0002-test. Sisanya dapat disimpulkan dengan analogi.

Informasi berikut menjelaskan parameter untuk format tersebut:
  • name_prefix: awalan nama host.
  • begin_number,bits: nomor terurut dalam nama host.
  • name_suffix: akhiran nama host.
PeriodIntegerTidakTidakDurasi langganan desktop cloud yang ingin Anda beli. Satuan nilainya ditentukan oleh properti PeriodUnit. Properti ini hanya berlaku dan diperlukan jika Anda menetapkan properti ChargeType ke PrePaid.
  • Nilai valid jika Anda menetapkan properti PeriodUnit ke Month: 1, 2, 3, dan 6.
  • Nilai valid jika Anda menetapkan properti PeriodUnit ke Year: 1, 2, 3, 4, dan 5.
VolumeEncryptionEnabledBooleanTidakTidakMenentukan apakah akan mengaktifkan enkripsi disk. Nilai default: false. Nilai valid:
  • true
  • false
AutoPayBooleanTidakTidakMenentukan apakah akan mengaktifkan pembayaran otomatis.
Nilai default: true. Nilai valid:
  • true: mengaktifkan pembayaran otomatis.

    Pastikan Anda memiliki saldo yang cukup di akun Alibaba Cloud Anda. Jika tidak, pesanan Anda menjadi tidak valid.

  • false: menonaktifkan pembayaran otomatis. Dalam hal ini, pesanan dibuat, tetapi tidak ada pembayaran yang dilakukan.
GroupIdStringTidakTidakID grup desktop. Tidak ada.
OfficeSiteIdStringYaTidakID ruang kerja. Tidak ada.
DesktopNameSuffixBooleanTidakTidakMenentukan apakah akan menambahkan akhiran secara otomatis ke nama desktop cloud. Nilai default: false. Nilai valid:
  • true
  • false
BundleIdStringYaTidakID template desktop cloud. Tidak ada.
EndUserIdListTidakTidakID pengguna reguler yang berwenang menggunakan desktop cloud. Desktop cloud yang Anda buat ditugaskan ke pengguna reguler. Anda dapat menentukan 1 hingga 100 ID pengguna.
  • Hanya satu pengguna reguler yang dapat menggunakan desktop cloud pada satu waktu.
  • Jika Anda tidak menentukan properti EndUserId, desktop cloud yang Anda buat tidak akan ditugaskan ke pengguna reguler.
ChargeTypeStringTidakTidakMetode penagihan desktop cloud.
Nilai default: PostPaid. Nilai valid:
  • PostPaid: bayar sesuai pemakaian
  • PrePaid: langganan
VolumeEncryptionKeyStringTidakTidakID Key Management Service (KMS) key yang digunakan saat enkripsi disk diaktifkan. Untuk informasi lebih lanjut tentang cara menanyakan ID key, lihat ListKeys.
TagsListTidakTidakTag. Untuk informasi lebih lanjut, lihat Properti Tags.
PeriodUnitStringTidakTidakSatuan durasi langganan. Nilai default: Month. Nilai valid:
  • Month
  • Year
VpcIdStringTidakTidakProperti ini tidak tersedia. Tidak ada.
DirectoryIdStringTidakTidakProperti ini tidak tersedia. Tidak ada.
UserNameStringTidakTidakProperti ini tidak tersedia. Tidak ada.

Sintaksis Tags

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

Properti Tags

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
ValueStringTidakTidakNilai tag. Anda dapat menentukan 1 hingga 20 nilai untuk sebuah tag.
KeyStringYaTidakKunci tag. Anda dapat menentukan 1 hingga 20 kunci untuk sebuah tag.

Nilai kembali

Fn::GetAtt

  • DesktopId: ID desktop cloud.
  • OrderId: ID pesanan.

Contoh

  • JSON format

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "PolicyGroupId": {
          "Type": "String",
          "Description": "ID kebijakan."
        },
        "OfficeSiteId": {
          "Type": "String",
          "Description": "ID ruang kerja."
        },
        "BundleId": {
          "Type": "String",
          "Description": "ID template desktop cloud."
        }
      },
      "Resources": {
        "Desktops": {
          "Type": "ALIYUN::ECD::Desktops",
          "Properties": {
            "PolicyGroupId": {
              "Ref": "PolicyGroupId"
            },
            "OfficeSiteId": {
              "Ref": "OfficeSiteId"
            },
            "BundleId": {
              "Ref": "BundleId"
            }
          }
        }
      },
      "Outputs": {
        "DesktopId": {
          "Description": "ID desktop cloud. Jika beberapa desktop cloud dibuat dalam satu panggilan, ID desktop cloud dikembalikan.",
          "Value": {
            "Fn::GetAtt": [
              "Desktops",
              "DesktopId"
            ]
          }
        },
        "OrderId": {
          "Description": "ID pesanan.\nCatatan Parameter ini hanya dikembalikan jika parameter ChargeType diatur ke PrePaid.",
          "Value": {
            "Fn::GetAtt": [
              "Desktops",
              "OrderId"
            ]
          }
        }
      }
    }
  • YAML format

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      PolicyGroupId:
        Type: String
        Description: ID kebijakan.
      OfficeSiteId:
        Type: String
        Description: ID ruang kerja.
      BundleId:
        Type: String
        Description: ID template desktop cloud.
    Resources:
      Desktops:
        Type: ALIYUN::ECD::Desktops
        Properties:
          PolicyGroupId:
            Ref: PolicyGroupId
          OfficeSiteId:
            Ref: OfficeSiteId
          BundleId:
            Ref: BundleId
    Outputs:
      DesktopId:
        Description: |-
          ID desktop cloud. Jika beberapa desktop cloud dibuat dalam satu panggilan, 
          ID desktop cloud dikembalikan.
        Value:
          Fn::GetAtt:
            - Desktops
            - DesktopId
      OrderId:
        Description: |-
          ID pesanan.
          Catatan Parameter ini hanya dikembalikan jika parameter ChargeType diatur ke PrePaid.
        Value:
          Fn::GetAtt:
            - Desktops
            - OrderId