Todos os produtos
Search

Este produto

    Auto Scaling:ModifyScalingConfiguration

    Central de documentação

    Auto Scaling:ModifyScalingConfiguration

    Última atualização: Jul 03, 2026

    Modifica uma configuração de dimensionamento.

    Observações de uso

    • O nome da configuração de dimensionamento deve ser exclusivo no grupo de dimensionamento.

    • Configure a interface de rede primária com um dos métodos a seguir. Use apenas um método por solicitação. A especificação de ambos causa falha na solicitação.

      • Configure diretamente a interface de rede primária com parâmetros como SecurityGroupId, SecurityGroupIds.N e Ipv6AddressCount.

      • Configure as interfaces de rede primária e secundária com o parâmetro NetworkInterfaces.N. Defina NetworkInterfaces.N.InstanceType como Primary para a interface de rede primária. Para interfaces secundárias, defina como Secondary ou deixe sem especificação.

        Nota

        A modificação das configurações de interface de rede de uma configuração de dimensionamento por um desses métodos limpa as configurações definidas pelo outro.

    Experimente agora

    Execute esta operação no OpenAPI Explorer sem calcular assinaturas e obtenha um exemplo de código SDK após o sucesso.

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Valor de exemplo

    Descrição
    Action String Sim ModifyScalingConfiguration

    Defina como ModifyScalingConfiguration.
    ScalingConfigurationId String Sim asc-bp16har3jpj6fjbx****

    ID da configuração de dimensionamento a modificar.
    IoOptimized String Não none

    Indica se a instância é otimizada para E/S. Valores válidos:

    • none: a instância não é otimizada para E/S.
    • optimized: a instância é otimizada para E/S.
    SpotStrategy String Não NoSpot

    Política de lance para instâncias pay-as-you-go. Valores válidos:

    • NoSpot: instância pay-as-you-go regular.
    • SpotWithPriceLimit: instância spot com preço máximo horário especificável.
    • SpotAsPriceGo: instância spot em que o sistema dá lances automaticamente pelo preço de mercado atual.
    ScalingConfigurationName String Não test-modify

    Nome da configuração de dimensionamento. Deve ter de 2 a 64 caracteres, iniciar com letra, dígito ou caractere chinês e pode conter dígitos, sublinhados (_), hífens (-) e pontos (.).

    O nome deve ser exclusivo no grupo de dimensionamento e na região. Se omitido, o ID da configuração de dimensionamento será usado como nome.
    InstanceName String Não inst****

    Nome das instâncias ECS criadas por esta configuração de dimensionamento.
    HostName String Não hos****

    Nome do host da instância ECS. Não pode começar ou terminar com ponto (.) ou hífen (-), nem conter pontos ou hífens consecutivos. As convenções variam conforme o sistema operacional:

    • Windows: deve ter de 2 a 15 caracteres e pode conter letras, dígitos e hífens (-). Não pode conter pontos (.) nem ser composto apenas por dígitos.
    • Outros SO (como Linux): deve ter de 2 a 64 caracteres. É possível usar pontos (.) para separar o nome em vários segmentos. Cada segmento pode conter letras, dígitos e hífens (-).
    ImageId String Não centos6u5_64_20G_aliaegis_2014****.vhd

    ID da imagem usada para criar instâncias.

    Nota Se a imagem anterior incluía disco de sistema e discos de dados, alterar a imagem limpa as informações originais dos discos de dados.
    ImageName String Não suse11sp3_64_20G_aliaegis_2015****.vhd

    Nome da imagem. Os nomes devem ser exclusivos na região. Se ImageId for especificado, ImageName será ignorado.

    Não é possível usar ImageName para especificar imagens do marketplace.
    Cpu Integer Não 2

    Número de vCPUs.

    Especifique Cpu e Memory para definir um intervalo de tipos de instância. Por exemplo, ao definir Cpu como 2 e Memory como 16, todos os tipos com 2 vCPUs e 16 GiB de memória serão correspondidos. O Auto Scaling considera fatores como otimização de E/S e zona de disponibilidade para determinar os tipos disponíveis e cria uma instância do tipo correspondente com menor preço.

    Nota Esta configuração só tem efeito quando a otimização de custos está ativada e nenhum tipo de instância foi especificado na configuração de dimensionamento.
    Memory Integer Não 16

    Tamanho da memória em GiB.

    Especifique Cpu e Memory para definir um intervalo de tipos de instância. Por exemplo, ao definir Cpu como 2 e Memory como 16, todos os tipos com 2 vCPUs e 16 GiB de memória serão correspondidos. O Auto Scaling considera fatores como otimização de E/S e zona de disponibilidade para determinar os tipos disponíveis e cria uma instância do tipo correspondente com menor preço.

    Nota Esta configuração só tem efeito quando a otimização de custos está ativada e nenhum tipo de instância foi especificado na configuração de dimensionamento.
    InternetChargeType String Não PayByBandwidth

    Método de faturamento de rede. Valores válidos:

    • PayByBandwidth: faturamento por largura de banda. InternetMaxBandwidthOut define a largura de banda fixa.
    • PayByTraffic: faturamento por tráfego. InternetMaxBandwidthOut define a largura de banda máxima e o faturamento baseia-se no uso real.
    InternetMaxBandwidthOut Integer Não 10

    Largura de banda pública de saída máxima. Unidade: Mbit/s. Valores válidos: 0 a 100.

    Valor padrão: 0.
    SystemDisk.Category String Não cloud_efficiency

    Categoria do disco de sistema. Valores válidos:

    • cloud: Basic Cloud Disk.
    • cloud_efficiency: Ultra Cloud Disk.
    • cloud_ssd: SSD cloud disk.
    • cloud_essd: ESSD.
    • ephemeral_ssd: local SSD disk.
    • cloud_auto: ESSD AutoPL disk.

    Não é possível especificar este parâmetro e SystemDiskCategories.N simultaneamente. Se nenhum dos dois for especificado, um valor padrão será aplicado. Para instâncias de primeira geração não otimizadas para E/S, o padrão é cloud; caso contrário, é cloud_efficiency.
    SystemDisk.Size Integer Não 50

    Tamanho do disco de sistema. Unidade: GiB. Valores válidos:

    • Basic Cloud Disk: 20 a 500.
    • ESSD:
      • PL0: 1 a 2.048.
      • PL1: 20 a 2.048.
      • PL2: 461 a 2.048.
      • PL3: 1.261 a 2.048.
    • ESSD AutoPL disk: 1 a 2.048.
    • Outros tipos de cloud disk: 20 a 2.048.

    O valor deste parâmetro deve ser maior ou igual a max{1, ImageSize}.

    Valor padrão: max{40, ImageSize}.
    SystemDisk.DiskName String Não cloud_ssdSystem

    Nome do disco de sistema. Deve ter de 2 a 128 caracteres, iniciar com letra ou caractere chinês e não pode começar com http:// ou https://. Pode conter dígitos, dois pontos (:), sublinhados (_) e hífens (-).
    SystemDisk.Description String Não Test system disk.

    Descrição do disco de sistema. Deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.
    SystemDisk.AutoSnapshotPolicyId String Não sp-bp12m37ccmxvbmi5****

    ID da política de snapshot automático do disco de sistema.
    SystemDisk.PerformanceLevel String Não PL0

    Nível de desempenho do ESSD usado como disco de sistema. Valores válidos:

    • PL0: até 10.000 IOPS de leitura/gravação aleatória.
    • PL1: até 50.000 IOPS de leitura/gravação aleatória.
    • PL2: até 100.000 IOPS de leitura/gravação aleatória.
    • PL3: até 1.000.000 IOPS de leitura/gravação aleatória.
    Nota Para detalhes sobre a seleção do nível de desempenho do ESSD, consulte ESSDs.
    LoadBalancerWeight Integer Não 50

    Peso do servidor backend. Valores válidos: 1 a 100.
    UserData String Não ZWNobyBoZWxsbyBlY3Mh

    Dados do usuário da instância ECS. Devem estar codificados em Base64; máximo de 32 KB antes da codificação.
    KeyPairName String Não KeyPair_Name

    Nome do par de chaves para login na instância ECS.

    • Em instâncias Windows, este parâmetro é ignorado.
    • Em instâncias Linux, definir este parâmetro desativa o login por senha por padrão.
    RamRoleName String Não RamRoleTest

    Nome da função RAM da instância ECS. Chame a operação ListRoles para consultar funções RAM disponíveis. Para criar uma função RAM, chame a operação CreateRole.

    PasswordInherit Boolean Não false

    Indica se a senha predefinida na imagem deve ser usada. Se ativado, certifique-se de que a imagem possua uma senha predefinida.
    Tags String Não {"key1":"value1","key2":"value2", ... "key5":"value5"}

    Tags da instância ECS como pares chave-valor. Máximo: 20. Requisitos:

    • A chave pode ter até 64 caracteres, não pode começar com aliyun ou acs:, nem conter http:// ou https://. Não pode ser string vazia.
    • O valor pode ter até 128 caracteres, não pode começar com aliyun ou acs:, nem conter http:// ou https://. Pode ser string vazia.
    DeploymentSetId String Não ds-bp13v7bjnj9gis****

    ID do conjunto de implantação ao qual a instância ECS pertence.
    SecurityGroupId String Não sg-F876F****

    ID do grupo de segurança ao qual a instância ECS pertence. Instâncias no mesmo grupo de segurança podem se comunicar entre si.
    Override Boolean Não true

    Indica se as configurações existentes devem ser substituídas. Valores válidos:

    • true: substitui as configurações existentes.
    • false: não substitui as configurações existentes.
    ResourceGroupId String Não abcd1234abcd****

    ID do grupo de recursos ao qual a instância ECS pertence.
    HpcClusterId String Não hpc-clusterid

    ID do cluster de Computação de Alto Desempenho (HPC) ao qual a instância ECS pertence.
    InstanceDescription String Não Test instance.

    Descrição da instância ECS. Deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.
    Ipv6AddressCount Integer Não 1

    Número de endereços IPv6 gerados aleatoriamente para atribuir à interface de rede elástica.
    CreditSpecification String Não Standard

    Modo de desempenho da instância burstable. Valores válidos:
    ImageFamily String Não hangzhou-daily-update

    Define este parâmetro para usar a imagem disponível mais recente da família especificada na criação de instâncias. Não pode ser especificado se ImageId também estiver definido.
    ZoneId String Não cn-hangzhou-g

    ID da zona de disponibilidade onde a instância ECS reside.
    DedicatedHostId String Não dh-bp67acfmxazb4p****

    ID do host dedicado onde iniciar a instância ECS. Ao especificar um DedicatedHostId, a instância não será spot e quaisquer configurações de SpotStrategy ou SpotPriceLimit serão ignoradas.

    Chame a operação DescribeDedicatedHosts para consultar a lista de IDs de hosts dedicados.
    Affinity String Não default

    Indica se a instância deve ser associada a um host dedicado. Valores válidos:

    • default: a instância não está associada a um host dedicado específico. Ao reiniciar uma instância parada, ela poderá ser movida para outro host se o original não tiver recursos.
    • host: a instância está associada a um host dedicado específico. Ao reiniciar uma instância parada, ela permanece no host original. A reinicialização falhará se o host original não tiver recursos.
    Tenancy String Não default

    Indica se a instância deve ser criada em um host dedicado. Valores válidos:

    • default: a instância executa em hardware compartilhado.
    • host: a instância executa em um host dedicado. Se DedicatedHostId não for especificado, um será selecionado automaticamente.
    SchedulerOptions Map Não ["testManagedPrivateSpaceId****"]

    Opções de agendamento.
    PrivatePoolOptions.MatchCriteria String Não Open

    Define como usar pools privados (gerados por garantias de elasticidade ou reservas de capacidade) ao iniciar instâncias. Valores válidos:

    • Open: modo aberto. O sistema corresponde automaticamente à capacidade de pools privados abertos. Se nenhum pool elegível for encontrado, recursos do pool público serão usados. Neste modo, não é necessário especificar PrivatePoolOptions.Id.
    • Target: modo especificado. A instância inicia usando a capacidade de um pool privado específico. Se o pool estiver indisponível, a inicialização falhará. Neste modo, especifique um ID de pool privado em PrivatePoolOptions.Id.
    • None: sem modo. A instância não usa capacidade de pool privado.
    PrivatePoolOptions.Id String Não eap-bp67acfmxazb4****

    ID do pool privado. Corresponde ao ID da garantia de elasticidade ou reserva de capacidade.
    SpotDuration Integer Não 1

    Período de proteção da instância spot. Unidade: horas. Valores válidos:

    • 1: o Alibaba Cloud garante que a instância não seja liberada automaticamente na primeira hora após a criação. Após esse período, o sistema compara o preço do lance com o de mercado e verifica o inventário de recursos para decidir se retém ou libera a instância.
    • 0: o Alibaba Cloud não garante execução por 1 hora após a criação. O sistema compara o preço do lance com o de mercado e verifica o inventário de recursos para decidir se retém ou libera a instância.
    Nota O Alibaba Cloud envia notificação de evento de sistema ECS 5 minutos antes de liberar uma instância spot. O faturamento é por segundo. Escolha um período de proteção alinhado ao tempo de conclusão da tarefa.

    Valor padrão: 1.
    SpotInterruptionBehavior String Não Terminate

    Ação a tomar quando uma instância spot for interrompida. Apenas Terminate (liberar a instância) é suportado. Este é o padrão.
    DataDisk.N.PerformanceLevel String Não PL1

    Nível de desempenho do ESSD usado como disco de dados. O valor de N deve ser igual ao de N em DataDisk.N.Category=cloud_essd. Valores válidos:

    • PL0: até 10.000 IOPS de leitura/gravação aleatória.
    • PL1: até 50.000 IOPS de leitura/gravação aleatória.
    • PL2: até 100.000 IOPS de leitura/gravação aleatória.
    • PL3: até 1.000.000 IOPS de leitura/gravação aleatória.
    Nota Para detalhes sobre a seleção do nível de desempenho do ESSD, consulte ESSDs.
    DataDisk.N.AutoSnapshotPolicyId String Não sp-bp19nq9enxqkomib****

    ID da política de snapshot automático aplicada ao disco de dados N. O valor de N varia de 1 a 16.
    DataDisk.N.Encrypted String Não false

    Indica se o disco de dados N deve ser criptografado. O valor de N varia de 1 a 16. Valores válidos:

    • true: criptografa o disco.
    • false: não criptografa o disco.
    DataDisk.N.Description String Não Test data disk.

    Descrição do disco de dados N. O valor de N varia de 1 a 16. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.
    DataDisk.N.SnapshotId String Não s-snapshot****

    Snapshot usado para criar o disco de dados N. O valor de N varia de 1 a 16. Se especificado, DataDisk.N.Size será ignorado e o tamanho do disco criado será igual ao do snapshot.

    Snapshots criados em ou antes de 15 de julho de 2013 não são suportados e resultarão no erro InvalidSnapshot.TooOld.
    DataDisk.N.Categories.N String Não cloud

    Lista priorizada de categorias para o disco de dados N. O primeiro N identifica o disco (1-16) e o segundo define a prioridade (1-4). É possível especificar até quatro categorias. O Auto Scaling tenta criar o disco usando a categoria de maior prioridade primeiro, recorrendo às seguintes em caso de falha. Valores válidos:

    • cloud: Basic Cloud Disk. O atributo DeleteWithInstance de um Basic Cloud Disk criado com uma instância é true.
    • cloud_efficiency: Ultra Cloud Disk.
    • cloud_ssd: SSD cloud disk.
    • cloud_essd: ESSD.
    Nota Não é possível especificar este parâmetro e DataDisk.N.Category simultaneamente.
    DataDisk.N.Size Integer Não 100

    Tamanho do disco de dados N. O valor de N varia de 1 a 16. Unidade: GiB. Valores válidos:

    • cloud: 5 a 2.000.
    • cloud_efficiency: 20 a 32.768.
    • cloud_essd: 20 a 32.768.
    • ephemeral_ssd: 5 a 800.

    Se especificado, o tamanho do disco deve ser maior ou igual ao tamanho do snapshot indicado por SnapshotId.
    DataDisk.N.Device String Não /dev/xvdb

    Ponto de montagem do disco de dados N. O valor de N varia de 1 a 16. Se não especificado, o sistema aloca um ponto de montagem ao criar automaticamente a instância ECS. Os pontos variam de /dev/xvdb a /dev/xvdz.
    DataDisk.N.DiskName String Não cloud_ssdData

    Nome do disco de dados N. O valor de N varia de 1 a 16. Deve ter de 2 a 128 caracteres, iniciar com letra ou caractere chinês e não pode começar com http:// ou https://. Pode conter dígitos, dois pontos (:), sublinhados (_) e hífens (-).
    DataDisk.N.Category String Não cloud_ssd

    Categoria do disco de dados N. O valor de N varia de 1 a 16. Valores válidos:

    • cloud: Basic Cloud Disk. O atributo DeleteWithInstance de um Basic Cloud Disk criado com uma instância é true.
    • cloud_efficiency: Ultra Cloud Disk.
    • cloud_ssd: SSD cloud disk.
    • cloud_essd: ESSD.
    • ephemeral_ssd: local SSD disk.
    • cloud_auto: ESSD AutoPL disk.

    Não é possível especificar este parâmetro e DataDisk.N.Categories.N simultaneamente. Se nenhum dos dois for especificado, o valor padrão segue a regra:

    • Instâncias otimizadas para E/S: cloud_efficiency.
    • Instâncias não otimizadas para E/S: cloud.
    DataDisk.N.DeleteWithInstance Boolean Não true

    Indica se o disco de dados N deve ser liberado junto com a instância. O valor de N varia de 1 a 16. Valores válidos:

    • true: o disco é liberado quando a instância é liberada.
    • false: o disco não é liberado quando a instância é liberada.

    Este parâmetro só pode ser definido para cloud disks (DataDisk.N.Category como cloud, cloud_efficiency, cloud_ssd ou cloud_essd). Caso contrário, um erro será retornado.
    DataDisk.N.KMSKeyId String Não 0e478b7a-4262-4802-b8cb-00d3fb40****

    ID da chave KMS do disco de dados N. O valor de N varia de 1 a 16.
    DataDisk.N.ProvisionedIops Long Não 100

    IOPS provisionados para o disco de dados.

    Nota IOPS (Input/Output Operations Per Second) mede o número de operações de E/S que um dispositivo de armazenamento em bloco processa por segundo.
    DataDisk.N.BurstingEnabled Boolean Não false

    Indica se o recurso de burst de desempenho deve ser ativado para o disco de dados. Valores válidos:

    • true: ativa o recurso.

    • false: desativa o recurso.

      Nota Suportado apenas quando DataDisk.Category é cloud_auto.
    SpotPriceLimit.N.PriceLimit Float Não 0.125

    Preço do lance para a instância spot. O valor de N varia de 1 a 20. Efetivo apenas quando SpotStrategy é SpotWithPriceLimit.
    SpotPriceLimit.N.InstanceType String Não ecs.g6.large

    Tipo da instância spot. O valor de N varia de 1 a 20. Efetivo apenas quando SpotStrategy é SpotWithPriceLimit.
    InstanceTypes.N String Não ecs.g6.large

    Vários tipos de instância. Se especificado, InstanceType será ignorado. O valor de N varia de 1 a 20.

    N define a prioridade, sendo 1 a mais alta. Se a criação falhar para um tipo prioritário, o Auto Scaling tentará automaticamente o próximo da lista.
    InstanceTypeOverride.N.InstanceType String Não ecs.c5.xlarge

    Para especificar a capacidade de um tipo de instância na configuração de dimensionamento, informe este parâmetro e InstanceTypeOverride.N.WeightedCapacity.

    Especifica o tipo de instância. É possível definir N instâncias deste parâmetro em conjunto com InstanceTypeOverride.N.WeightedCapacity para estender o suporte a múltiplos tipos com pesos personalizados. O valor de N varia de 1 a 20.

    Nota Não é possível especificar este parâmetro e InstanceTypes.N simultaneamente.

    Para valores válidos de InstanceType, consulte Famílias de instâncias.
    InstanceTypeOverride.N.WeightedCapacity Integer Não 4

    Para especificar a capacidade de um tipo de instância, informe este parâmetro após InstanceTypeOverride.N.InstanceType. Ambos formam um par e o valor de N deve ser idêntico.

    Especifica o peso do tipo de instância. O peso representa a capacidade de uma única instância desse tipo no grupo. Um peso maior exige menos instâncias para atingir a capacidade desejada.

    Configure pesos diferentes para tipos distintos conforme a necessidade, já que métricas como vCPUs e memória podem variar.

    Exemplo:

    • Capacidade atual: 0
    • Capacidade desejada: 6
    • Capacidade de uma instância ecs.c5.xlarge: 4

    Para atingir a capacidade desejada, o grupo escalará horizontalmente duas instâncias ecs.c5.xlarge.

    Nota Durante um scale-out, a capacidade do grupo não pode exceder a soma da capacidade máxima (MaxSize) e o peso máximo dos tipos de instância.

    Valores válidos para WeightedCapacity: 1 a 500.
    SecurityGroupIds.N String Não sg-bp18kz60mefs****

    ID do grupo de segurança.
    InstancePatternInfo.N.Cores Integer Não 2

    Contagem de núcleos vCPU para filtrar tipos de instância no modo de configuração inteligente. Famílias de instâncias. O valor de N varia de 1 a 10.

    Observações:

    • InstancePatternInfo.N aplica-se apenas quando o tipo de rede do grupo é VPC.
    • Ao especificar InstancePatternInfo.N, informe também InstancePatternInfo.N.Cores e InstancePatternInfo.N.Memory.
    • Se InstanceType ou InstanceTypes.N for especificado, esses tipos têm prioridade. Se indisponíveis, o Auto Scaling seleciona o tipo de menor preço que corresponda aos filtros InstancePatternInfo.
    InstancePatternInfo.N.InstanceFamilyLevel String Não EnterpriseLevel

    Nível da família de instâncias para filtrar tipos no modo de configuração inteligente. Valores válidos:

    • EntryLevel: tipos compartilhados com custos menores, mas sem garantia de desempenho computacional estável. Adequado para baixa utilização de CPU. Famílias de instâncias compartilhadas.
    • EnterpriseLevel: instâncias empresariais com desempenho estável e recursos dedicados. Adequado para cenários de alta estabilidade. Famílias de instâncias.
    • CreditEntryLevel: instâncias burstable que usam créditos de CPU. Adequado para baixa utilização média com picos ocasionais. Instâncias burstable.

    O valor de N varia de 1 a 10.
    InstancePatternInfo.N.MaxPrice Float Não 2

    Preço horário máximo aceitável para instâncias pay-as-you-go ou spot, usado para filtrar tipos no modo de configuração inteligente. O valor de N varia de 1 a 10.

    Nota Obrigatório quando SpotStrategy é SpotWithPriceLimit. Opcional nos demais casos.
    InstancePatternInfo.N.Memory Float Não 4

    Tamanho da memória (GiB) para filtrar tipos no modo de configuração inteligente. Famílias de instâncias. O valor de N varia de 1 a 10.
    InstancePatternInfo.N.Architecture.N String Não X86

    Tipo de arquitetura do tipo de instância. Valores válidos:

    • X86: arquitetura x86.
    • Heterogeneous: computação heterogênea, como GPU ou FPGA.
    • BareMental: instância bare metal ECS.
    • Arm: arquitetura Arm.

    Valor padrão: todos os tipos de arquitetura incluídos.
    InstancePatternInfo.N.BurstablePerformance String Não Include

    Indica se instâncias burstable devem ser incluídas. Valores válidos:

    • Exclude: não inclui instâncias burstable.
    • Include: inclui instâncias burstable.
    • Required: inclui apenas instâncias burstable.

    Valor padrão: Include.
    InstancePatternInfo.N.ExcludedInstanceType.N String Não ecs.n1.small/ecs.n1.*/*7*

    Tipos de instância a excluir. Use curingas (*) para excluir um tipo específico ou uma família inteira. Exemplos:

    • ecs.c6.large: exclui o tipo ecs.c6.large.
    • ecs.c6.*: exclui todos os tipos da família c6.
    Nota Para excluir vários tipos, use barras (/) como separador. Exemplo: ecs.n1.small/ecs.n1.*/*7*.
    InstancePatternInfo.N.InstanceTypeFamilies.N String Não ["ecs.g6", "ecs.c6", … "ecs.r6"]

    Famílias de instâncias especificadas. N indica que é possível especificar várias famílias, com valores de 1 a 10.
    InstancePatternInfo.N.MinimumCpuCoreCount Integer Não 2

    Número mínimo de núcleos vCPU para o tipo de instância.
    InstancePatternInfo.N.MaximumCpuCoreCount Integer Não 4

    Número máximo de núcleos vCPU para o tipo de instância.

    Nota MaximumCpuCoreCount não pode superar quatro vezes o valor de MinimumCpuCoreCount.
    InstancePatternInfo.N.GpuSpecs.N String Não ["NVIDIA V100"]

    Tipo de GPU especificado.
    InstancePatternInfo.N.InstanceCategories.N String Não Compute-optimized with GPU

    Categoria do tipo de instância.

    Nota N indica que é possível especificar várias categorias, com valores de 1 a 10.
    • General-purpose
    • Compute-optimized
    • Memory-optimized
    • Big data
    • Local SSDs
    • High Clock Speed
    • Enhanced
    • Shared
    • Compute-optimized with GPU
    • Visual Compute-optimized
    • Heterogeneous Service
    • Compute-optimized with FPGA
    • Compute-optimized with NPU
    • ECS bare metal
    • High-performance compute
    InstancePatternInfo.N.CpuArchitectures.N String Não ["X86", "ARM"]

    Arquitetura de CPU da instância. Valores válidos:

    Nota N indica que é possível especificar várias arquiteturas, com valores de 1 a 2.
    • X86
    • ARM
    InstancePatternInfo.N.PhysicalProcessorModels.N String Não ["Intel Xeon(Ice Lake) Platinum 8369B", "Intel Xeon(Skylake) Platinum 8163", … "Intel Xeon(Cascade Lake) Platinum 8269CY"]

    Modelo de processador da instância. N indica que é possível especificar vários modelos, com valores de 1 a 10.
    InstancePatternInfo.N.MinimumEniQuantity Integer Não 2

    Número mínimo de interfaces de rede elásticas que a instância deve suportar.
    InstancePatternInfo.N.MinimumEniPrivateIpAddressQuantity Integer Não 2

    Número mínimo de endereços IPv4 privados por interface de rede elástica que a instância deve suportar.
    InstancePatternInfo.N.MinimumEniIpv6AddressQuantity Integer Não 1

    Número mínimo de endereços IPv6 por interface de rede elástica que a instância deve suportar.
    InstancePatternInfo.N.MinimumInitialCredit Integer Não 12

    Créditos iniciais mínimos de vCPU para instâncias burstable das famílias t5 ou t6.
    InstancePatternInfo.N.MinimumBaselineCredit Integer Não 12

    Desempenho computacional de linha de base mínimo de vCPU (soma de todas as vCPUs) para instâncias burstable das famílias t5 ou t6.
    InstancePatternInfo.N.MinimumMemorySize Float Não 4

    Tamanho mínimo de memória da instância. Unidade: GiB.
    InstancePatternInfo.N.MaximumMemorySize Float Não 4

    Tamanho máximo de memória da instância. Unidade: GiB.
    InstancePatternInfo.N.MinimumGpuAmount Integer Não 2

    Número mínimo de GPUs necessárias para a instância. Deve ser inteiro positivo maior ou igual a 1.
    InstancePatternInfo.N.MaximumGpuAmount Integer Não 2

    Número máximo de GPUs necessárias para a instância. Deve ser inteiro positivo maior ou igual a 1.
    SystemDiskCategories.N String Não cloud

    Categorias do disco de sistema. O valor de N varia de 1 a 4, permitindo especificar até quatro categorias para um disco de sistema. Um valor N menor indica maior prioridade. Se a criação falhar com a categoria prioritária, o Auto Scaling tenta automaticamente a seguinte. Valores válidos:

    • cloud: Basic Cloud Disk.
    • cloud_efficiency: Ultra Cloud Disk.
    • cloud_ssd: SSD cloud disk.
    • cloud_essd: ESSD.
    Nota Não é possível especificar este parâmetro e SystemDisk.Category simultaneamente.
    Password String Não 123abc****

    Senha da instância ECS. Deve ter de 8 a 30 caracteres e conter pelo menos três destes tipos: maiúsculas, minúsculas, dígitos e caracteres especiais. Caracteres especiais suportados:

    ()~!@#$%^&*-_+=\|{}[]:;'<>,.?/ Para instâncias Windows, a senha não pode começar com barra (/). Recomendamos enviar a solicitação via HTTPS ao especificar Password para evitar vazamentos.
    SystemDisk.Encrypted Boolean Não false

    Indica se o disco de sistema deve ser criptografado. Valores válidos:

    • true: criptografa o disco.
    • false: não criptografa o disco.

    Valor padrão: false.
    SystemDisk.KMSKeyId String Não 0e478b7a-4262-4802-b8cb-00d3fb40****

    ID da chave KMS usada no disco de sistema.
    SystemDisk.EncryptAlgorithm String Não AES-256

    Algoritmo de criptografia do disco de sistema. Valores válidos:

    • AES-256
    • SM4-128

    Valor padrão: AES-256.
    SystemDisk.ProvisionedIops Long Não 100

    IOPS provisionados para o disco de sistema.

    Nota IOPS (Input/Output Operations Per Second) mede o número de operações de E/S que um dispositivo de armazenamento em bloco processa por segundo.
    SystemDisk.BurstingEnabled Boolean Não false

    Indica se o recurso de burst de desempenho deve ser ativado para o disco de sistema. Valores válidos:

    • true: ativa o recurso.

    • false: desativa o recurso.

      Nota Suportado apenas quando SystemDisk.Category é cloud_auto.
    ImageOptions.LoginAsNonRoot Boolean Não false

    Indica se a conta ecs-user deve ser usada para login na instância ECS. Gerenciar nomes de usuário de login de instâncias ECS. Valores válidos:

    • true
    • false
    DeletionProtection Boolean Não false

    Proteção contra exclusão para instâncias pay-as-you-go. Indica se a instância está protegida contra exclusão acidental via console ECS ou API DeleteInstance. Valores válidos:

    • true: ativa a proteção contra liberação. A instância não pode ser liberada pelo console ECS ou API, evitando exclusões acidentais no Auto Scaling.
    • false: desativa a proteção contra liberação. A instância pode ser liberada pelo console ECS ou API.
    Nota Este atributo não afeta atividades normais de scale-in. Durante um scale-in, instâncias pay-as-you-go com proteção ativada podem ser liberadas normalmente.
    StorageSetId String Não ss-bp67acfmxazb4p****

    ID do conjunto de armazenamento.
    StorageSetPartitionNumber Integer Não 2

    Número máximo de partições no conjunto de armazenamento. Deve ser maior ou igual a 2.
    CustomPriorities.N.InstanceType String Não ecs.g6.large

    Prioridade personalizada para combinação de tipo de instância ECS e vSwitch. Especifica o tipo de instância.

    Nota Efetivo apenas quando a política de dimensionamento do grupo é priority policy e o tipo especificado consta na lista da configuração de dimensionamento.

    Se a criação falhar com a combinação prioritária, o Auto Scaling seleciona automaticamente a próxima combinação de tipo de instância ECS e vSwitch na ordem de prioridade.

    Nota Combinações sem prioridade personalizada ficam abaixo das especificadas. A prioridade relativa segue a ordem dos vSwitches no grupo e depois a dos tipos na configuração. Exemplo: vSwitches vsw1 e vsw2, tipos type1 e type2, prioridade personalizada ["vsw2+type2", "vsw1+type2"]. Ordem final: vsw2+type2 > vsw1+type2 > vsw1+type1 > vsw2+type1.
    CustomPriorities.N.VswitchId String Não vsw-bp14zolna43z266bq****

    ID do vSwitch na prioridade personalizada.

    Nota Efetivo apenas quando a scaling policy do grupo é priority policy e o vSwitch especificado consta na lista do grupo.
    NetworkInterfaces.N.InstanceType String Não Primary

    Tipo de interface de rede elástica. Ao usar este parâmetro, configure a interface primária com NetworkInterfaces.N. Não é possível especificar SecurityGroupId ou SecurityGroupIds.N simultaneamente. Valores válidos:

    • Primary: interface de rede primária.
    • Secondary: interface de rede secundária.

    Valor padrão: Secondary.
    NetworkInterfaces.N.NetworkInterfaceTrafficMode String Não HighPerformance

    Modo de comunicação da interface de rede. Valores válidos:

    • Standard: modo TCP.
    • HighPerformance: ativa a Elastic RDMA Interface (ERI) e usa modo RDMA.

    Valor padrão: Standard.

    Nota O número de interfaces com RDMA não pode exceder o limite da família de instâncias. Famílias de instâncias.
    NetworkInterfaces.N.Ipv6AddressCount Integer Não 1

    Número de endereços IPv6 aleatórios para atribuir à interface primária. Observe:

    • Efetivo apenas quando NetworkInterfaces.N.InstanceType é Primary.
    • Não pode ser definido se NetworkInterfaces.N.InstanceType for Secondary ou vazio.
    • Se definido, Ipv6AddressCount não pode ser configurado.
    NetworkInterfaces.N.SecurityGroupIds.N String Não sg-2ze55shrh****

    IDs de grupos de segurança da interface de rede elástica. Observe:

    • Se NetworkInterfaces.N.InstanceType for Primary, este parâmetro é obrigatório. Equivale a SecurityGroupIds.N, mas não é possível definir SecurityGroupId ou SecurityGroupIds.N simultaneamente.
    • Se NetworkInterfaces.N.InstanceType for Secondary ou vazio, este parâmetro é opcional. O padrão é o grupo de segurança da instância ECS (grupo da interface primária).
    NetworkInterfaces.N.SecondaryPrivateIpAddressCount Integer Não 2

    Número de endereços IPv4 privados secundários para atribuir à interface. Valores válidos: 1 a 49.

    • Não pode exceder o limite de IPs do tipo de instância. Famílias de instâncias.
    • NetworkInterface.N.SecondaryPrivateIpAddressCount atribui endereços IPv4 privados secundários (excluindo o primário). O sistema os aloca aleatoriamente do bloco CIDR disponível do vSwitch da interface (NetworkInterface.N.VSwitchId).
    DedicatedHostClusterId String Não dc-2zedxc67zqzt7lb4****

    ID do cluster de hosts dedicados.
    SecurityOptions.ConfidentialComputingMode String Não TDX

    Modo de computação confidencial. Valores válidos:
    HttpEndpoint String Não enabled

    Indica se o canal de acesso a metadados da instância deve ser ativado. Valores válidos:

    • enabled
    • disabled

    Valor padrão: enabled.
    HttpTokens String Não optional

    Indica se o uso do Instance Metadata Service Version 2 (IMDSv2) é obrigatório ao acessar metadados. Valores válidos:

    • optional: não impõe IMDSv2.
    • required: impõe IMDSv2. O acesso normal aos metadados fica bloqueado.

    Valor padrão: optional.
    InternetMaxBandwidthIn Integer Não 10

    Largura de banda pública de entrada máxima. Unidade: Mbit/s. Valores válidos:

    • Se a banda de saída contratada for ≤ 10 Mbit/s: 1 a 10. Padrão: 10.
    • Se a banda de saída contratada for > 10 Mbit/s: 1 até InternetMaxBandwidthOut. Padrão: valor de InternetMaxBandwidthOut.
    ResourcePoolOptions.Strategy String Não PrivatePoolFirst

    Estratégia para uso de pools privados (garantias de elasticidade/reservas) e públicos na inicialização. Valores válidos:

    • PrivatePoolFirst: prioriza pool privado. Se ResourcePoolOptions.PrivatePoolIds for especificado ou condições de PrivatePoolTags forem atendidas, o sistema usa o pool correspondente. Caso contrário, busca automaticamente um pool aberto. Se nenhum for encontrado, usa pool público.
    • PrivatePoolOnly: apenas pool privado. Exige ResourcePoolOptions.PrivatePoolIds. Se o pool não tiver capacidade, a inicialização falha.

    • PublicPoolFirst: prioriza pool público. Se insuficiente, complementa com pool privado. Busca automaticamente um pool aberto; se não houver, usa pool Target via ResourcePoolOptions.PrivatePoolIds ou PrivatePoolTags.

      Nota Política em preview convidado, não suportada atualmente.

    • None: nenhuma política de pool aplicada.

    Valor padrão: None.
    ResourcePoolOptions.PrivatePoolIds.N String Não eap-bp67acfmxazb4****

    ID do pool privado (garantia de elasticidade ou reserva). Aceita apenas pools no modo Target. Não pode ser combinado com PrivatePoolTags. O valor de N varia de 1 a 20.
    ResourcePoolOptions.PrivatePoolTags.N.Key String Não TestKey

    Chave da tag do pool privado.

    Filtra pools Target disponíveis por tags. O valor de N varia de 1 a 20.

    Observações:

    • Quando configurado, o sistema filtra apenas

      pools Target associados à conta com tags correspondentes que também atendam às restrições do grupo (zona de disponibilidade, tipo de instância etc.).

    • Regra: o pool deve corresponder a todas as tags especificadas.
    • Não pode ser combinado com PrivatePoolIds.
    ResourcePoolOptions.PrivatePoolTags.N.Value String Não TestValue

    Valor da tag do pool privado.

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    RequestId

    String

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

    ID da solicitação.

    Exemplos

    Solicitação de exemplo

    http(s)://ess.aliyuncs.com/?Action=ModifyScalingConfiguration
&ScalingConfigurationId=asc-bp16har3jpj6fjbx****
&IoOptimized=none
&SpotStrategy=NoSpot
&ScalingConfigurationName=test-modify
&InstanceName=inst****
&HostName=hos****
&ImageId=centos6u5_64_20G_aliaegis_2014****.vhd
&ImageName=suse11sp3_64_20G_aliaegis_2015****.vhd
&Cpu=2
&Memory=16
&InternetChargeType=PayByBandwidth
&InternetMaxBandwidthOut=10
&SystemDisk.Category=cloud_efficiency
&SystemDisk.Size=50
&SystemDisk.DiskName=cloud_ssdSystem
&SystemDisk.Description=Test system disk.
&SystemDisk.AutoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
&SystemDisk.PerformanceLevel=PL0
&LoadBalancerWeight=50
&UserData=ZWNobyBoZWxsbyBlY3Mh
&KeyPairName=KeyPair_Name
&RamRoleName=RamRoleTest
&PasswordInherit=false
&Tags={"key1":"value1","key2":"value2", ... "key5":"value5"}
&DeploymentSetId=ds-bp13v7bjnj9gis****
&SecurityGroupId=sg-F876F****
&Override=true
&ResourceGroupId=abcd1234abcd****
&HpcClusterId=hpc-clusterid
&InstanceDescription=Test instance.
&Ipv6AddressCount=1
&CreditSpecification=Standard
&ImageFamily=hangzhou-daily-update
&ZoneId=cn-hangzhou-g
&DedicatedHostId=dh-bp67acfmxazb4p****
&Affinity=default
&Tenancy=default
&PrivatePoolOptions.MatchCriteria=Open
&PrivatePoolOptions.Id=eap-bp67acfmxazb4****
&SpotDuration=1
&SpotInterruptionBehavior=Terminate
&DataDisk=[{"PerformanceLevel":"PL1","AutoSnapshotPolicyId":"sp-bp19nq9enxqkomib****","Encrypted":"false","Description":"Test data disk.","SnapshotId":"s-snapshot****","Categories":["cloud"],"Size":100,"Device":"/dev/xvdb","DiskName":"cloud_ssdData","Category":"cloud_ssd","DeleteWithInstance":true,"KMSKeyId":"0e478b7a-4262-4802-b8cb-00d3fb40****","ProvisionedIops":100,"BurstingEnabled":false}]
&SpotPriceLimit=[{"PriceLimit":0.125,"InstanceType":"ecs.g6.large"}]
&InstanceTypes=["ecs.g6.large"]
&InstanceTypeOverride=[{"InstanceType":"ecs.c5.xlarge","WeightedCapacity":4}]
&SecurityGroupIds=["sg-bp18kz60mefs****"]
&InstancePatternInfo=[{"Cores":2,"InstanceFamilyLevel":"EnterpriseLevel","MaxPrice":2.0,"Memory":4.0,"Architecture":["X86"],"BurstablePerformance":"Include","ExcludedInstanceType":["ecs.n1.small/ecs.n1.*/*7*"],"InstanceTypeFamilies":["[\"ecs.g6\", \"ecs.c6\", … \"ecs.r6\"]"],"MinimumCpuCoreCount":2,"MaximumCpuCoreCount":4,"GpuSpecs":["[\"NVIDIA V100\"]"],"InstanceCategories":["Compute-optimized with GPU"],"CpuArchitectures":["[\"X86\", \"ARM\"]"],"PhysicalProcessorModels":["[\"Intel Xeon(Ice Lake) Platinum 8369B\", \"Intel Xeon(Skylake) Platinum 8163\", … \"Intel Xeon(Cascade Lake) Platinum 8269CY\"]"],"MinimumEniQuantity":2,"MinimumEniPrivateIpAddressQuantity":2,"MinimumEniIpv6AddressQuantity":1,"MinimumInitialCredit":12,"MinimumBaselineCredit":12,"MinimumMemorySize":4.0,"MaximumMemorySize":4.0,"MinimumGpuAmount":2,"MaximumGpuAmount":2}]
&SystemDiskCategories=["cloud"]
&Password=123abc****
&SystemDisk.Encrypted=false
&SystemDisk.KMSKeyId=0e478b7a-4262-4802-b8cb-00d3fb40****
&SystemDisk.EncryptAlgorithm=AES-256
&SystemDisk.ProvisionedIops=100
&SystemDisk.BurstingEnabled=false
&ImageOptions.LoginAsNonRoot=false
&DeletionProtection=false
&StorageSetId=ss-bp67acfmxazb4p****
&StorageSetPartitionNumber=2
&CustomPriorities=[{"InstanceType":"ecs.g6.large","VswitchId":"vsw-bp14zolna43z266bq****"}]
&NetworkInterfaces=[{"InstanceType":"Primary","NetworkInterfaceTrafficMode":"HighPerformance","Ipv6AddressCount":1,"SecurityGroupIds":["sg-2ze55shrh****"]}]
&DedicatedHostClusterId=dc-2zedxc67zqzt7lb4****
&SecurityOptions={"ConfidentialComputingMode":"TDX"}
&HttpEndpoint=enabled
&HttpTokens=optional
&InternetMaxBandwidthIn=10
&ResourcePoolOptions={"Strategy":"PrivatePoolFirst","PrivatePoolIds":["eap-bp67acfmxazb4****"]}
&common request parameters

    Respostas de exemplo

    Formato XML

    HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyScalingConfigurationResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyScalingConfigurationResponse>

    Formato JSON

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

    Códigos de erro

    Visite o Error Center para obter mais códigos de erro.

    Código HTTP

    Código de erro

    Mensagem de erro

    Descrição

    403

    Forbidden.Unauthorized

    A required authorization for the specified action is not supplied.

    Você não tem autorização para executar a ação especificada.

    404

    InvalidDataDiskSnapshotId.NotFound

    Snapshot "XXX" does not exist.

    O snapshot especificado não existe.

    400

    InvalidDataDiskSnapshotId.SizeNotSupported

    The capacity of snapshot "XXX" exceeds the size limit of the specified disk category.

    O tamanho do snapshot especificado excede o limite da categoria de disco.

    404

    InvalidImageId.NotFound

    The specified image does not exist.

    A imagem especificada não existe.

    400

    InvalidKeyPairName.NotFound

    The specified KeyPairName does not exist.

    O par de chaves especificado não existe.

    400

    InvalidNetworkType.ForRAMRole

    The RAMRole parameter is not supported for instances in a classic network.

    Funções RAM não são suportadas em rede clássica.

    400

    InvalidParamter

    The specified parameter value is invalid.

    Valor de parâmetro inválido.

    400

    InvalidScalingConfigurationName.Duplicate

    The specified scaling configuration name already exists.

    O nome da configuração de dimensionamento já existe.

    400

    InvalidSecurityGroupId.IncorrectNetworkType

    The network type of the specified security group is not supported for this action.

    O tipo de rede do grupo de segurança não corresponde ao do grupo de dimensionamento.

    400

    InvalidSecurityGroupId.VPCMismatch

    The specified security group and virtual switch are not in the same VPC.

    O grupo de segurança e o vSwitch não estão na mesma VPC.

    400

    InvalidTags.KeyValue

    The key or value of a specified tag cannot be empty.

    Chave ou valor de tag não pode estar vazio.

    400

    InvalidTags.ListSize

    The number of tags cannot exceed 20.

    O número de tags excede o limite de 20.

    400

    InvalidUserData.Base64FormatInvalid

    The UserData parameter must be Base64-encoded.

    Dados do usuário não codificados em Base64.

    400

    InvalidUserData.SizeExceeded

    The value of the UserData parameter exceeds the size limit.

    Tamanho dos dados do usuário excede o limite.

    400

    InvalidSecurityGroupId.IncorrectType

    The managed security group "XXX" is not supported.

    Grupo de segurança gerenciado não suportado.