Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ECD::DesktopGroup

Última atualização: Jun 27, 2026

Crie um pool de cloud computers.

Sintaxe

{
  "Type": "ALIYUN::ECD::DesktopGroup",
  "Properties": {
    "ConnectDuration": Integer,
    "DesktopGroupName": String,
    "AutoRenew": Boolean,
    "VolumeEncryptionEnabled": Boolean,
    "AllowBufferCount": Integer,
    "GroupVersion": Integer,
    "KeepDuration": Integer,
    "IdleDisconnectDuration": Integer,
    "MaxDesktopsCount": Integer,
    "ResetType": Integer,
    "MinDesktopsCount": Integer,
    "Comments": String,
    "PolicyGroupId": String,
    "EndUserIds": List,
    "Period": Integer,
    "DefaultInitDesktopCount": Integer,
    "AutoPay": Boolean,
    "OfficeSiteId": String,
    "BundleId": String,
    "StopDuration": Integer,
    "ChargeType": String,
    "VolumeEncryptionKey": String,
    "AllowAutoSetup": Integer,
    "BuyDesktopsCount": Integer,
    "PeriodUnit": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

BundleId

String

Sim

Não

ID do modelo de cloud computer.

Nenhuma.

ChargeType

String

Sim

Não

Método de faturamento dos cloud computers.

Valores válidos:

  • PostPaid

  • PrePaid

OfficeSiteId

String

Sim

Não

ID da rede de escritório à qual o pool de cloud computers pertence.

Nenhuma.

PolicyGroupId

String

Sim

Não

ID da política a associar ao pool de cloud computers.

Nenhuma.

AllowAutoSetup

Integer

Não

Não

Indica se os cloud computers no pool por assinatura devem ser criados automaticamente.

Especifique esta propriedade apenas quando ChargeType estiver definido como PrePaid. Valores válidos:

  • 0: não cria cloud computers automaticamente no pool por assinatura.

  • 1: cria cloud computers automaticamente no pool por assinatura.

AllowBufferCount

Integer

Não

Não

Quantidade de cloud computers reserváveis no pool com pagamento conforme o uso.

Especifique esta propriedade apenas quando ChargeType estiver definido como PostPaid. Valores válidos:

  • 0: não reserva cloud desktops no pool com pagamento conforme o uso.

  • N: reserva N cloud desktops no pool com pagamento conforme o uso. N varia de 1 a 100.

AutoPay

Boolean

Não

Não

Indica se o pagamento de pedidos por assinatura deve ser concluído automaticamente.

Nenhuma.

AutoRenew

Boolean

Não

Não

Indica se a renovação automática deve ser ativada para o pool de cloud computers por assinatura.

Valores válidos:

  • true

  • false

BuyDesktopsCount

Integer

Não

Não

O significado desta propriedade varia conforme o método de faturamento do pool de cloud computers.

  • Para pools por assinatura, defina a quantidade de cloud computers a adquirir no pool.

  • Para pools com pagamento conforme o uso, defina a quantidade mínima de cloud computers a criar no pool.

Valores válidos: 0 a 200.

Comments

String

Não

Não

Descrição.

Nenhuma.

ConnectDuration

Integer

Não

Não

Duração máxima permitida para uma sessão permanecer conectada.

A sessão é desconectada automaticamente ao atingir essa duração. Unidade: milissegundos. Valores válidos: 900000 a 345600000 (15 minutos a 4 dias).

DefaultInitDesktopCount

Integer

Não

Não

Quantidade de cloud computers criados automaticamente junto com o pool.

Valor padrão: 1.

DesktopGroupName

String

Não

Não

Nome do pool de cloud computers.

O nome pode ter até 30 caracteres. Deve começar com uma letra e não pode iniciar com http:// ou https://. Pode conter letras, dígitos, dois-pontos (:), sublinhados (_), pontos (.) e hifens (-).

EndUserIds

List

Não

Não

IDs dos usuários autorizados para o pool de cloud computers.

Nenhuma.

GroupVersion

Integer

Não

Não

Versão do pool de cloud computers.

Nenhuma.

IdleDisconnectDuration

Integer

Não

Não

Tempo máximo de ociosidade antes da desconexão da sessão. Se nenhuma entrada de teclado ou mouse for detectada nesse período, a sessão é encerrada automaticamente.

Unidade: milissegundos. Valores válidos: 360000 a 3600000 (intervalo de 6 a 60 minutos).

Um lembrete de economia de dados é enviado ao usuário final 30 segundos antes do término desse período.

KeepDuration

Integer

Não

Não

Período durante o qual a sessão permanece ativa após a desconexão.

Unidade: milissegundos. Valores válidos: 180000 a 345600000 (3 minutos a 4 dias). O valor 0 indica que a sessão permanece ativa indefinidamente após a desconexão.

Após a desconexão, a sessão continua ativa por esse período. Se o usuário final retomar dentro desse prazo, os dados originais são preservados. Caso contrário, os dados não salvos são limpos.

MaxDesktopsCount

Integer

Não

Não

Número máximo de cloud computers permitidos no pool com pagamento conforme o uso.

Valores válidos: 0 a 500.

MinDesktopsCount

Integer

Não

Não

Número máximo de cloud computers que podem ser criados automaticamente no pool por assinatura.

Especifique esta propriedade apenas quando ChargeType estiver definido como PrePaid. Valores válidos: 0 a 500. Valor padrão: 1.

Period

Integer

Não

Não

Duração da assinatura do pool de cloud computers.

Especifique esta propriedade apenas quando ChargeType estiver definido como PrePaid. A unidade de Period é definida por PeriodUnit.

  • Valores válidos quando PeriodUnit está definido como Month:

    • 1

    • 2

    • 3

    • 6

  • Valores válidos quando PeriodUnit está definido como Year:

    • 1

    • 2

    • 3

    • 4

    • 5

PeriodUnit

String

Não

Não

Unidade da duração da assinatura.

Valores válidos:

  • Month

  • Year

ResetType

Integer

Não

Não

Tipo de redefinição de disco dos cloud computers.

Valores válidos:

  • 0: não redefine discos.

  • 1: redefine apenas discos de sistema.

  • 2: redefine apenas discos de usuário.

  • 3: redefine discos de sistema e de usuário.

StopDuration

Integer

Não

Não

Tempo de ociosidade após o qual o cloud computer é parado.

O cloud computer é parado automaticamente ao atingir essa duração. Se um usuário final se conectar a um cloud computer parado, ele será iniciado automaticamente. Unidade: milissegundos.

VolumeEncryptionEnabled

Boolean

Não

Não

Indica se a criptografia de disco deve ser ativada.

Nenhuma.

VolumeEncryptionKey

String

Não

Não

ID da chave do Key Management Service (KMS) usada quando a criptografia de disco está ativada.

Nenhuma.

Valores de retorno

Fn::GetAtt

DesktopGroupId: ID do pool de cloud computers.

Exemplos

Formato YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  PolicyGroupId:
    Type: String
    Description:
      en: The ID of the policy.
    Required: true
  OfficeSiteId:
    Type: String
    Description:
      en: The ID of the workspace.
    Required: true
  BundleId:
    Type: String
    Description:
      en: The ID of the desktop template.
    Required: true
  ChargeType:
    Type: String
    Description:
      en: |-
        The billing method of the cloud desktops in the desktop group.  Enumeration Value:
        PostPaid
        PrePaid
    AllowedValues:
      - PostPaid
      - PrePaid
    Required: true
Resources:
  ExtensionResource:
    Type: ALIYUN::ECD::DesktopGroup
    Properties:
      PolicyGroupId:
        Ref: PolicyGroupId
      OfficeSiteId:
        Ref: OfficeSiteId
      BundleId:
        Ref: BundleId
      ChargeType:
        Ref: ChargeType
Outputs:
  DesktopGroupId:
    Description: Id of created DesktopGroup
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - DesktopGroupId

Formato JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "PolicyGroupId": {
      "Type": "String",
      "Description": {
        "en": "The ID of the policy."
      },
      "Required": true
    },
    "OfficeSiteId": {
      "Type": "String",
      "Description": {
        "en": "The ID of the workspace."
      },
      "Required": true
    },
    "BundleId": {
      "Type": "String",
      "Description": {
        "en": "The ID of the desktop template."
      },
      "Required": true
    },
    "ChargeType": {
      "Type": "String",
      "Description": {
        "en": "The billing method of the cloud desktops in the desktop group.  Enumeration Value:\nPostPaid\nPrePaid"
      },
      "AllowedValues": [
        "PostPaid",
        "PrePaid"
      ],
      "Required": true
    }
  },
  "Resources": {
    "ExtensionResource": {
      "Type": "ALIYUN::ECD::DesktopGroup",
      "Properties": {
        "PolicyGroupId": {
          "Ref": "PolicyGroupId"
        },
        "OfficeSiteId": {
          "Ref": "OfficeSiteId"
        },
        "BundleId": {
          "Ref": "BundleId"
        },
        "ChargeType": {
          "Ref": "ChargeType"
        }
      }
    }
  },
  "Outputs": {
    "DesktopGroupId": {
      "Description": "Id of created DesktopGroup",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "DesktopGroupId"
        ]
      }
    }
  }
}