CreateAutoProvisioningGroup - : Central de Documentação do Alibaba Cloud

Notas de uso

O Auto Provisioning é um serviço que permite a implantação rápida de um cluster de instâncias composto por instâncias preemptivas e instâncias com pagamento conforme o uso. O Auto Provisioning oferece suporte à implantação simplificada de clusters de instâncias entre diferentes métodos de cobrança, famílias de instâncias e zonas. Para obter mais informações, consulte Usar operações de API relacionadas ao grupo de aprovisionamento automático para criar várias instâncias do Elastic Compute Service (ECS) ao mesmo tempo.
O Auto Provisioning utiliza grupos de aprovisionamento automático para agendar e manter recursos de computação. Você pode usar grupos de aprovisionamento automático para obter um fornecimento estável de recursos de computação. Isso ajuda a reduzir o impacto na capacidade de computação quando instâncias preemptivas são recuperadas.
O Auto Provisioning é fornecido gratuitamente. No entanto, você será cobrado pelos recursos de instância criados nos grupos de aprovisionamento automático. Para obter mais informações, consulte Visão geral de instâncias preemptivas e Pagamento conforme o uso.
Quando você especifica tanto um modelo de execução (LaunchTemplateId) quanto configurações estendidas (parâmetros LaunchConfiguration.*), o LaunchTemplateId tem precedência.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateAutoProvisioningGroup	A operação que você deseja executar. Defina o valor como CreateAutoProvisioningGroup.
RegionId	String	Sim	cn-hangzhou	O ID da região na qual criar o grupo de aprovisionamento automático. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.
ResourceGroupId	String	Não	rg-bp67acfmxazb4p****	O ID do grupo de recursos ao qual atribuir o grupo de aprovisionamento automático.
AutoProvisioningGroupName	String	Não	apg-test	O nome do grupo de aprovisionamento automático. O nome deve ter de 2 a 128 caracteres. O nome deve começar com uma letra e não pode começar com `http://` ou `https://`. O nome pode conter letras, dígitos, dois-pontos (:), sublinhados (_) e hifens (-).
AutoProvisioningGroupType	String	Não	maintain	O tipo de entrega do grupo de aprovisionamento automático. Valores válidos: request: entrega assíncrona única. Quando o grupo de aprovisionamento automático é iniciado, ele tenta entregar de forma assíncrona um cluster de instâncias que atenda à capacidade alvo apenas uma vez. O grupo não tenta novamente a operação, independentemente de todas as instâncias terem sido entregues. instant: entrega síncrona única. Quando o grupo de aprovisionamento automático é iniciado, ele tenta entregar de forma síncrona um cluster de instâncias que atenda à capacidade alvo apenas uma vez. A lista de instâncias entregues e as causas de falhas de entrega são retornadas na resposta. maintain: entrega contínua. Quando o grupo de aprovisionamento automático é iniciado, ele tenta entregar um cluster de instâncias que atenda à capacidade alvo e monitora a capacidade em tempo real. Se a capacidade alvo do grupo de aprovisionamento automático não for atingida, o grupo continua criando instâncias até que a capacidade alvo seja atingida. Valor padrão: maintain.
SpotAllocationStrategy	String	Não	diversified	A política para criar instâncias preemptivas. Valores válidos: lowest-price: política de otimização de custos. O grupo de aprovisionamento automático seleciona o tipo de instância com menor preço para criar instâncias. diversified: política de distribuição equilibrada. O grupo de aprovisionamento automático cria instâncias nas zonas especificadas nas configurações estendidas e, em seguida, distribui as instâncias uniformemente entre as zonas. capacity-optimized: política de distribuição otimizada por capacidade. O grupo de aprovisionamento automático cria instâncias dos tipos de instância ideais nas zonas ideais com base na disponibilidade de recursos. Valor padrão: lowest-price.
SpotInstanceInterruptionBehavior	String	Não	terminate	A operação a ser executada na instância preemptiva quando ela é interrompida. Valores válidos: stop: para a instância preemptiva. terminate: libera a instância preemptiva. Valor padrão: terminate.
SpotInstancePoolsToUseCount	Integer	Não	2	O número de instâncias preemptivas do tipo de instância com menor preço a serem criadas pelo grupo de aprovisionamento automático. Este parâmetro entra em vigor quando `SpotAllocationStrategy` está definido como `lowest-price`. O valor deve ser menor que o valor de N especificado em `LaunchTemplateConfig.N`.
PayAsYouGoAllocationStrategy	String	Não	prioritized	A política para criar instâncias com pagamento conforme o uso. Valores válidos: lowest-price: política de otimização de custos. O grupo de aprovisionamento automático seleciona o tipo de instância com menor preço para criar instâncias. prioritized: política baseada em prioridade. O grupo de aprovisionamento automático cria instâncias com base na prioridade especificada por `LaunchTemplateConfig.N.Priority`. Valor padrão: lowest-price.
ExcessCapacityTerminationPolicy	String	Não	termination	Especifica se as instâncias reduzidas devem ser liberadas quando a capacidade em tempo real do grupo de aprovisionamento automático excede a capacidade alvo e o grupo é acionado para reduzir. Valores válidos: termination: libera as instâncias removidas do grupo de aprovisionamento automático. no-termination: apenas remove as instâncias do grupo de aprovisionamento automático, mas não as libera. Valor padrão: no-termination.
ValidFrom	String	Não	2019-04-01T15:10:20Z	O horário em que o grupo de aprovisionamento automático deve ser iniciado. O período entre este ponto no tempo e o ponto no tempo especificado por `ValidUntil` é o período de validade do grupo de aprovisionamento automático. Especifica o horário no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. Por padrão, um grupo de aprovisionamento automático é iniciado imediatamente após ser criado.
ValidUntil	String	Não	2019-06-01T15:10:20Z	O horário em que o grupo de aprovisionamento automático expira. O período entre este ponto no tempo e o ponto no tempo especificado por `ValidFrom` é o período de validade do grupo de aprovisionamento automático. Especifica o horário no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. Valor padrão: 2099-12-31T23:59:59Z.
TerminateInstancesWithExpiration	Boolean	Não	true	Especifica se as instâncias do grupo de aprovisionamento automático devem ser liberadas quando o grupo expira. Valores válidos: true: libera as instâncias. false: apenas remove as instâncias do grupo de aprovisionamento automático, mas não as libera. Valor padrão: false.
TerminateInstances	Boolean	Não	true	Especifica se as instâncias do grupo de aprovisionamento automático devem ser liberadas quando o grupo é excluído. Valores válidos: true: libera as instâncias. false: mantém as instâncias. Valor padrão: false.
MaxSpotPrice	Float	Não	2	O preço máximo de instâncias preemptivas no grupo de aprovisionamento automático. null Quando `MaxSpotPrice` e `LaunchTemplateConfig.N.MaxPrice` são especificados, o menor dos dois valores de parâmetro é utilizado.
TotalTargetCapacity	String	Sim	60	A capacidade alvo total do grupo de aprovisionamento automático. O valor deve ser um número inteiro positivo. A capacidade alvo total do grupo de aprovisionamento automático deve ser maior ou igual à soma da capacidade alvo de instâncias com pagamento conforme o uso especificada por `PayAsYouGoTargetCapacity` e da capacidade alvo de instâncias preemptivas especificada por `SpotTargetCapacity`.
PayAsYouGoTargetCapacity	String	Não	30	A capacidade alvo de instâncias com pagamento conforme o uso no grupo de aprovisionamento automático. O valor deve ser menor ou igual ao valor de `TotalTargetCapacity`.
SpotTargetCapacity	String	Não	20	A capacidade alvo de instâncias preemptivas no grupo de aprovisionamento automático. O valor deve ser menor ou igual ao valor de `TotalTargetCapacity`.
DefaultTargetCapacityType	String	Não	Spot	O método de cobrança das instâncias suplementares. Quando a soma dos valores de `PayAsYouGoTargetCapacity` e `SpotTargetCapacity` é menor que o valor de `TotalTargetCapacity`, o grupo de aprovisionamento automático cria instâncias com o método de cobrança especificado para atingir a capacidade alvo total. Valores válidos: PayAsYouGo: pagamento conforme o uso Spot: instância preemptiva Valor padrão: Spot.
LaunchTemplateId	String	Não	lt-bp1fgzds4bdogu03****	O ID do modelo de execução associado ao grupo de aprovisionamento automático. Você pode chamar a operação DescribeLaunchTemplates para consultar os modelos de execução disponíveis. Quando LaunchTemplateId e parâmetros `LaunchConfiguration.*` são especificados, o LaunchTemplateId tem precedência.
LaunchTemplateVersion	String	Não	1	A versão do modelo de execução associado ao grupo de aprovisionamento automático. Você pode chamar a operação DescribeLaunchTemplateVersions para consultar as versões dos modelos de execução disponíveis. Valor padrão: a versão padrão do modelo de execução.
Description	String	Não	testDescription	A descrição do grupo de aprovisionamento automático.
ClientToken	String	Não	0c593ea1-3bea-11e9-b96b-88e9fe637760	O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para obter mais informações, consulte Como garantir a idempotência.
LaunchConfiguration.ImageId	String	Não	m-bp1g7004ksh0oeuc****	O ID da imagem a ser usada para criar a instância. Você pode chamar a operação DescribeImages para consultar os recursos de imagem disponíveis. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.SecurityGroupId	String	Não	sg-bp15ed6xe1yxeycg****	O ID do grupo de segurança ao qual atribuir a instância. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.IoOptimized	String	Não	optimized	Especifica 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. Para instâncias de tipos de instância descontinuados, o valor padrão é none. Para instâncias de outros tipos de instância, o valor padrão é optimized. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.InternetChargeType	String	Não	PayByTraffic	O método de cobrança para uso de rede. Valores válidos: PayByBandwidth PayByTraffic null Quando o método de cobrança por tráfego é utilizado para uso de rede, os valores máximos de largura de banda de entrada e saída são usados como limites superiores de largura de banda, em vez de especificações de desempenho garantidas. Em cenários em que a demanda supera o fornecimento de recursos, os valores máximos de largura de banda podem ser limitados. Se você deseja largura de banda garantida para sua instância, use o método de cobrança por largura de banda. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.InternetMaxBandwidthIn	Integer	Não	10	A largura de banda pública máxima de entrada. Unidade: Mbit/s. Valores válidos: Quando a largura de banda pública máxima de saída é menor ou igual a 10 Mbit/s, os valores válidos deste parâmetro são de 1 a 10 e o valor padrão é 10. Quando a largura de banda pública máxima de saída é maior que 10 Mbit/s, os valores válidos deste parâmetro são de 1 ao valor de `LaunchConfiguration.InternetMaxBandwidthOut`, e o valor padrão é o valor de `LaunchConfiguration.InternetMaxBandwidthOut`. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.InternetMaxBandwidthOut	Integer	Não	10	A largura de banda pública máxima de saída. Unidade: Mbit/s. Valores válidos: 0 a 100. Valor padrão: 0. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.InstanceName	String	Não	k8s-node-[1,4]-alibabacloud	O nome da instância. O nome deve ter de 2 a 128 caracteres. O nome deve começar com uma letra e não pode começar com `http://` ou `https://`. O nome pode conter letras, dígitos, dois-pontos (:), sublinhados (_), pontos (.) e hifens (-). O valor padrão deste parâmetro é o valor de `InstanceId`. Quando você cria instâncias em lote, é possível configurar nomes sequenciais para as instâncias em lote. Para obter mais informações, consulte Configurar nomes ou nomes de host sequenciais em lote para várias instâncias. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.HostName	String	Não	k8s-node-[1,4]-ecshost	O nome de host da instância. Observe os seguintes itens: O nome de host não pode começar ou terminar com um ponto (.) ou hifen (-). O nome de host não pode conter pontos (.) ou hifens (-) consecutivos. Para instâncias Windows, o nome de host deve ter de 2 a 15 caracteres e não pode conter pontos (.) ou ser composto apenas por dígitos. Ele pode conter letras, dígitos e hifens (-). Para instâncias que executam outros sistemas operacionais, como Linux, o nome de host deve ter de 2 a 64 caracteres. Você pode usar pontos (.) para separar um nome de host em vários segmentos. Cada segmento pode conter letras, dígitos e hifens (-). Você não pode especificar `LaunchConfiguration.HostName` e `LaunchConfiguration.HostNames.N` ao mesmo tempo. Caso contrário, um erro será retornado. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.InstanceDescription	String	Não	Instance_Description	A descrição da instância. A descrição deve ter de 2 a 256 caracteres. A descrição pode conter letras e não pode começar com `http://` ou `https://`. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.KeyPairName	String	Não	KeyPair_Name	O nome do par de chaves. Para instâncias Windows, este parâmetro é ignorado. Este parâmetro é vazio por padrão. Por padrão, o logon baseado em senha está desabilitado para instâncias Linux. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.RamRoleName	String	Não	RAM_Name	O nome da função do Resource Access Management (RAM) da instância. Você pode chamar a operação ListRoles fornecida pelo RAM para consultar as funções RAM de instância que você criou. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.SecurityEnhancementStrategy	String	Não	Active	Especifica se o reforço de segurança deve ser habilitado. Valores válidos: Active: habilita o reforço de segurança para o sistema operacional. Este valor é aplicável apenas a imagens públicas. Deactive: não habilita o reforço de segurança. Este valor é aplicável a todos os tipos de imagem. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.UserData	String	Não	ZWNobyBoZWxsbyBlY3Mh	Os dados do usuário da instância. Os dados do usuário devem ser codificados em Base64. Os dados brutos podem ter até 16 KB de tamanho. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.SystemDiskCategory	String	Não	cloud_ssd	A categoria do disco do sistema. Valores válidos: cloud_efficiency: disco ultra cloud_ssd: SSD padrão cloud_essd: SSD aprimorado (ESSD) cloud: disco básico Para instâncias não otimizadas para E/S de tipos de instância descontinuados, o valor padrão é cloud. Para instâncias de outros tipos de instância, o valor padrão é cloud_efficiency. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.SystemDiskSize	Integer	Não	40	O tamanho do disco do sistema. Valores válidos: 20 a 500. Unidade: GiB. O valor deve ser pelo menos 20 e maior ou igual ao tamanho da imagem especificada por LaunchConfiguration.ImageId. Valor padrão: 40 ou o tamanho da imagem especificada por LaunchConfiguration.ImageId, o que for maior. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.SystemDiskName	String	Não	cloud_ssdSystem	O nome do disco do sistema. O nome deve ter de 2 a 128 caracteres. O nome deve começar com uma letra e não pode começar com `http://` ou `https://`. O nome pode conter letras, dígitos, pontos (.), dois-pontos (:), sublinhados (_) e hifens (-). Este parâmetro é vazio por padrão. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.SystemDiskDescription	String	Não	SystemDisk_Description	A descrição do disco do sistema. A descrição deve ter de 2 a 256 caracteres. A descrição pode conter letras e não pode começar com `http://` ou `https://`. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.SystemDiskPerformanceLevel	String	Não	PL0	O nível de desempenho do ESSD a ser usado como disco do sistema. Valores válidos: PL0 (padrão): um único ESSD pode fornecer até 10.000 IOPS de leitura/gravação aleatória. PL1: um único ESSD pode fornecer até 50.000 IOPS de leitura/gravação aleatória. PL2: um único ESSD pode fornecer até 100.000 IOPS de leitura/gravação aleatória. PL3: um único ESSD pode fornecer até 1.000.000 IOPS de leitura/gravação aleatória. Para obter mais informações sobre os níveis de desempenho do ESSD, consulte ESSDs. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.PasswordInherit	Boolean	Não	true	Especifica se a senha predefinida na imagem deve ser usada. Valores válidos: true false Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.ResourceGroupId	String	Não	rg-bp67acfmxazb4p****	O ID do grupo de recursos ao qual atribuir a instância. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.CreditSpecification	String	Não	Standard	O modo de desempenho da instância com capacidade de intermitência (burstable). Valores válidos: Standard: o modo padrão. Para obter mais informações, consulte a seção "Modo padrão" em Visão geral de instâncias com capacidade de intermitência. Unlimited: o modo ilimitado. Para obter mais informações, consulte a seção "Modo ilimitado" em Visão geral de instâncias com capacidade de intermitência. Este parâmetro é vazio por padrão. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.Password	String	Não	EcsV587!	A senha da instância. A senha deve ter de 8 a 30 caracteres e conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. A senha pode conter os seguintes caracteres especiais: ()`~!@#$%^&-_+=\|{}:;'<>,.?/Para instâncias Windows, a senha não pode começar com uma barra (/). Quando LaunchTemplateId e parâmetros LaunchConfiguration. são especificados, o LaunchTemplateId tem precedência.`
LaunchConfiguration.DeploymentSetId	String	Não	ds-bp1frxuzdg87zh4p****	O ID do conjunto de implantação.
LaunchTemplateConfig.N.VSwitchId	String	Não	vsw-sn5bsitu4lfzgc5o7****	O ID do vSwitch na configuração estendida N. A zona das instâncias do ECS criadas a partir da configuração estendida é determinada pelo vSwitch. null Se você especificar um ou mais parâmetros `LaunchTemplateConfig.N.*`, também deve especificar `LaunchTemplateConfig.N.VSwitchId`.
LaunchTemplateConfig.N.MaxPrice	double	Não	3	O preço máximo de instâncias preemptivas na configuração estendida N. null Se você especificar um ou mais parâmetros `LaunchTemplateConfig.N.*`, também deve especificar `LaunchTemplateConfig.N.MaxPrice`.
LaunchTemplateConfig.N.Priority	Integer	Não	1	A prioridade da configuração estendida N. O valor 0 indica a maior prioridade. Valores válidos: 0 a + ∞.
LaunchTemplateConfig.N.InstanceType	String	Não	ecs.g5.large	O tipo de instância na configuração estendida N. Valores válidos de N: 1 a 20. Para obter mais informações sobre os valores válidos deste parâmetro, consulte Visão geral das famílias de instâncias.
LaunchTemplateConfig.N.WeightedCapacity	double	Não	2	O peso do tipo de instância na configuração estendida N. Um peso maior indica que uma única instância tem mais poder de computação e menos instâncias são necessárias. O valor deve ser maior que 0. O peso é calculado com base no poder de computação do tipo de instância especificado e no poder de computação mínimo de uma única instância no cluster a ser criado pelo grupo de aprovisionamento automático. Por exemplo, suponha que o poder de computação mínimo de uma única instância seja 8 vCPUs e 60 GiB de memória. Para um tipo de instância com 8 vCPUs e 60 GiB de memória, você pode definir o peso como 1. Para um tipo de instância com 16 vCPUs e 120 GiB de memória, você pode definir o peso como 2.
LaunchTemplateConfig.N.MaxQuantity	Integer	Não	false	null Este parâmetro está em pré-visualização por convite e não está disponível publicamente.
LaunchTemplateConfig.N.Cores.N	Integer	Não	2	O número de vCPUs do tipo de instância na configuração estendida N. Este parâmetro é usado para filtrar tipos de instância. Para obter mais informações, consulte Visão geral das famílias de instâncias. Valores válidos de N: 1 a 10.
LaunchTemplateConfig.N.Memories.N	Float	Não	4	O tamanho da memória do tipo de instância na configuração estendida N. Unidade: GiB. Este parâmetro é usado para filtrar tipos de instância. Para obter mais informações, consulte Visão geral das famílias de instâncias. Valores válidos de N: 1 a 10.
LaunchTemplateConfig.N.InstanceFamilyLevel	String	Não	EnterpriseLevel	O nível da família de instâncias do tipo de instância na configuração estendida N. Este parâmetro é usado para filtrar tipos de instância. Valores válidos: EntryLevel: nível de entrada (tipos de instância compartilhados). Tipos de instância deste nível são os mais econômicos, mas podem não fornecer desempenho de computação estável. Tipos de instância deste nível são adequados para cenários em que a utilização da CPU é baixa. Para obter mais informações, consulte Famílias de instâncias compartilhadas. EnterpriseLevel: nível empresarial. Tipos de instância deste nível fornecem desempenho estável e recursos dedicados e são adequados para cenários que requerem alta estabilidade. Para obter mais informações, consulte Visão geral das famílias de instâncias. CreditEntryLevel: nível de entrada com créditos (tipos de instância com capacidade de intermitência). Créditos de CPU são usados para garantir o desempenho de computação. Tipos de instância deste nível são adequados para cenários em que a utilização da CPU é baixa, mas pode variar em casos específicos. Para obter mais informações, consulte Visão geral de instâncias com capacidade de intermitência. Valores válidos de N: 1 a 10.
LaunchTemplateConfig.N.ExcludedInstanceTypes.N	String	Não	ecs.n1.small/ecs.n1./7*	O tipo de instância N que você deseja excluir na configuração estendida N. Você pode usar caracteres curinga, como um asterisco (), para excluir um tipo de instância ou uma família de instâncias. Exemplos: ecs.c6.large: o tipo de instância ecs.c6.large é excluído. ecs.c6.: a família de instâncias c6 é excluída.
LaunchTemplateConfig.N.Architectures.N	String	Não	X86	A arquitetura N do tipo de instância na configuração estendida N. Valores válidos: X86: x86 Heterogeneous: computação heterogênea, como aceleração por GPU ou FPGA BareMetal: Instância ECS Bare Metal Arm: Arm SuperComputeCluster: Super Computing Cluster Por padrão, todos os valores estão incluídos.
LaunchTemplateConfig.N.BurstablePerformance	String	Não	Include	Especifica se tipos de instância com capacidade de intermitência devem ser incluídos. Valores válidos: Exclude: não inclui tipos de instância com capacidade de intermitência. Include: inclui tipos de instância com capacidade de intermitência. Required: inclui apenas tipos de instância com capacidade de intermitência. Valor padrão: Include.
LaunchConfiguration.DataDisk.N.PerformanceLevel	String	Não	PL1	O nível de desempenho do ESSD a ser usado como disco de dados N. O valor de N neste parâmetro deve ser o mesmo que o valor de N em `LaunchConfiguration.DataDisk.N.Category`. Valores válidos: PL0: um único ESSD pode fornecer até 10.000 IOPS de leitura/gravação aleatória. PL1 (padrão): um único ESSD pode fornecer até 50.000 IOPS de leitura/gravação aleatória. PL2: um único ESSD pode fornecer até 100.000 IOPS de leitura/gravação aleatória. PL3: um único ESSD pode fornecer até 1.000.000 IOPS de leitura/gravação aleatória. Para obter mais informações sobre os níveis de desempenho do ESSD, consulte ESSDs. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.DataDisk.N.KmsKeyId	String	Não	0e478b7a-4262-4802-b8cb-00d3fb40****	O ID da chave do Key Management Service (KMS) a ser usada para o disco de dados N. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.DataDisk.N.Description	String	Não	DataDisk_Description	A descrição do disco de dados N. A descrição deve ter de 2 a 256 caracteres. A descrição pode conter letras e não pode começar com `http://` ou `https://`. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.DataDisk.N.SnapshotId	String	Não	s-bp17441ohwka0yuh****	O ID do snapshot a ser usado para criar o disco de dados N. Valores válidos de N: 1 a 16. Depois que este parâmetro é especificado, `LaunchConfiguration.DataDisk.N.Size` é ignorado. O tamanho do disco de dados N é o mesmo que o do snapshot especificado por este parâmetro. Use snapshots criados em ou após 15 de julho de 2013. Caso contrário, um erro será retornado e sua solicitação será rejeitada. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.DataDisk.N.Size	Integer	Não	20	O tamanho do disco de dados N. Valores válidos de N: 1 a 16. Unidade: GiB. Valores válidos: Valores válidos quando LaunchConfiguration.DataDisk.N.Category está definido como cloud_efficiency: 20 a 32768. Valores válidos quando LaunchConfiguration.DataDisk.N.Category está definido como cloud_ssd: 20 a 32768. Valores válidos quando LaunchConfiguration.DataDisk.N.Category está definido como cloud_essd: dependem do valor de `LaunchConfiguration.DataDisk.N.PerformanceLevel`. Valores válidos quando LaunchConfiguration.DataDisk.N.PerformanceLevel está definido como PL0: 40 a 32768. Valores válidos quando LaunchConfiguration.DataDisk.N.PerformanceLevel está definido como PL1: 20 a 32768. Valores válidos quando LaunchConfiguration.DataDisk.N.PerformanceLevel está definido como PL2: 461 a 32768. Valores válidos quando LaunchConfiguration.DataDisk.N.PerformanceLevel está definido como PL3: 1261 a 32768. Valores válidos quando LaunchConfiguration.DataDisk.N.Category está definido como cloud: 5 a 2000. null O valor de LaunchConfiguration.DataDisk.N.Size deve ser maior ou igual ao tamanho do snapshot especificado por `LaunchConfiguration.DataDisk.N.SnapshotId`. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.DataDisk.N.Device	String	Não	/dev/vd1	O ponto de montagem do disco de dados N. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.DataDisk.N.DiskName	String	Não	cloud_ssdData	O nome do disco de dados N. O nome deve ter de 2 a 128 caracteres. O nome deve começar com uma letra e não pode começar com `http://` ou `https://`. O nome pode conter letras, dígitos, pontos (.), dois-pontos (:), sublinhados (_) e hifens (-). Este parâmetro é vazio por padrão. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.DataDisk.N.Category	String	Não	cloud_ssd	A categoria do disco de dados N. Valores válidos de N: 1 a 16. Valores válidos: cloud_efficiency: disco ultra cloud_ssd: SSD padrão cloud_essd: ESSD cloud: disco básico Para instâncias otimizadas para E/S, o valor padrão é cloud_efficiency. Para instâncias não otimizadas para E/S, o valor padrão é cloud. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.DataDisk.N.DeleteWithInstance	Boolean	Não	true	Especifica se o disco de dados N deve ser liberado quando a instância associada é liberada. Valores válidos: true false Valor padrão: true. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.DataDisk.N.Encrypted	Boolean	Não	false	Especifica se o disco de dados N deve ser criptografado. Valores válidos: true false Valor padrão: false. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.Tag.N.Key	String	Não	TestKey	A chave da tag N a ser adicionada à instância. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres e não pode começar com acs: ou aliyun. A chave da tag não pode conter `http://` ou `https://`. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.Tag.N.Value	String	Não	TestValue	O valor da tag N a ser adicionada à instância. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode conter `http://` ou `https://`. O valor da tag não pode começar com acs:. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
SystemDiskConfig.N.DiskCategory	String	Não	cloud_ssd	A categoria do disco do sistema N. Você pode usar este parâmetro para especificar várias categorias de disco, e as categorias de disco são priorizadas na ordem em que são especificadas. Se uma categoria de disco especificada não estiver disponível, o sistema usará a próxima categoria de disco disponível. Valores válidos: cloud_efficiency: disco ultra cloud_ssd: SSD padrão cloud_essd: ESSD cloud: disco básico
DataDiskConfig.N.DiskCategory	String	Não	cloud_efficiency	A categoria do disco de dados N. Você pode usar este parâmetro para especificar várias categorias de disco, e as categorias de disco são priorizadas na ordem em que são especificadas. Se uma categoria de disco especificada não estiver disponível, o sistema usará a próxima categoria de disco disponível. Valores válidos: cloud_efficiency: disco ultra cloud_ssd: SSD padrão cloud_essd: ESSD cloud: disco básico
LaunchConfiguration.HostNames.N	String	Não	ecs-host-01	O nome de host da instância N. Você pode usar este parâmetro para especificar nomes de host diferentes para várias instâncias. Observe os seguintes itens: Este parâmetro entra em vigor apenas quando `AutoProvisioningGroupType` está definido como instant. O valor de N indica o número de instâncias. Valores válidos de N: 1 a 1000. O valor de N deve ser o mesmo que o valor de TotalTargetCapacity. O nome de host não pode começar ou terminar com um ponto (.) ou hifen (-). O nome de host não pode conter pontos (.) ou hifens (-) consecutivos. Para instâncias Windows, o nome de host deve ter de 2 a 15 caracteres e não pode conter pontos (.) ou ser composto apenas por dígitos. O nome de host pode conter letras, dígitos e hifens (-). Para instâncias que executam outros sistemas operacionais, como Linux, o nome de host deve ter de 2 a 64 caracteres. Você pode usar pontos (.) para separar o nome de host em vários segmentos. Cada segmento pode conter letras, dígitos e hifens (-). Você não pode especificar `LaunchConfiguration.HostName` e `LaunchConfiguration.HostNames.N` ao mesmo tempo. Caso contrário, um erro será retornado. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
MinTargetCapacity	String	Não	20	A capacidade alvo mínima do grupo de aprovisionamento automático. O valor deve ser um número inteiro positivo. Ao especificar este parâmetro, observe os seguintes itens: Este parâmetro entra em vigor apenas quando `AutoProvisioningGroupType` está definido como instant. Se o número de instâncias que podem ser criadas na região atual for menor que o valor deste parâmetro, a operação não poderá ser chamada e nenhuma instância será criada. Se o número de instâncias que podem ser criadas na região atual for maior que o valor deste parâmetro, as instâncias poderão ser criadas com base nos parâmetros especificados.
LaunchConfiguration.SecurityGroupIds.N	String	Não	sg-bp15ed6xe1yxeycg****	O ID do grupo de segurança N ao qual atribuir a instância. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.SystemDisk.Encrypted	String	Não	false	Especifica se o disco do sistema deve ser criptografado. Valores válidos: true false Valor padrão: false. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.SystemDisk.KMSKeyId	String	Não	0e478b7a-4262-4802-b8cb-00d3fb40****	O ID da chave KMS a ser usada para o disco do sistema. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.SystemDisk.EncryptAlgorithm	String	Não	aes-256	O algoritmo a ser usado para criptografar o disco do sistema. Valores válidos: aes-256 sm4-128 Valor padrão: aes-256. Quando LaunchTemplateId e parâmetros LaunchConfiguration.* são especificados, o LaunchTemplateId tem precedência.
LaunchConfiguration.Arn.N.Rolearn	String	Não	acs:ram::123456789012****:role/adminrole	Este parâmetro não está disponível publicamente.
LaunchConfiguration.Arn.N.RoleType	String	Não	34458433936495****:alice	Este parâmetro não está disponível publicamente.
LaunchConfiguration.Arn.N.AssumeRoleFor	Long	Não	123456789012****	Este parâmetro não está disponível publicamente.
HibernationOptionsConfigured	Boolean	Não	false	null Este parâmetro está em pré-visualização por convite e não está disponível publicamente.
LaunchConfiguration.AutoReleaseTime	String	Não	2018-01-01T12:05:00Z	O horário para liberar automaticamente a instância com pagamento conforme o uso. Especifica o horário no padrão ISO 8601 no formato `yyyy-MM-ddTHH:mm:ssZ`. O horário deve estar em UTC. Se o valor dos segundos (`ss`) não for `00`, o horário será automaticamente arredondado para o minuto mais próximo com base no valor dos minutos (`mm`). O horário especificado deve ser pelo menos 30 minutos posterior ao horário atual. O horário especificado pode ser no máximo três anos a partir do horário atual.
LaunchConfiguration.ImageFamily	String	Não	hangzhou-daily-update	O nome da família de imagens. O nome deve ter de 2 a 128 caracteres. O nome deve começar com uma letra e não pode começar com `aliyun` ou `acs:`. O nome não pode conter `http://` ou `https://`. O nome pode conter letras, dígitos, dois-pontos (:), sublinhados (_) e hifens (-).

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
AutoProvisioningGroupId	String	apg-sn54avj8htgvtyh8****	O ID do grupo de aprovisionamento automático.
RequestId	String	745CEC9F-0DD7-4451-9FE7-8B752F39****	O ID da solicitação.
LaunchResults	Array of LaunchResult		As instâncias criadas pelo grupo de aprovisionamento automático. Os valores dos parâmetros neste array são retornados apenas quando AutoProvisioningGroupType está definido como `instant`.
LaunchResult
ZoneId	String	cn-hangzhou-g	O ID da zona da instância.
ErrorMsg	String	Specific parameter is not valid.	A mensagem de erro retornada quando a instância não pode ser criada.
InstanceType	String	ecs.g5.large	O tipo de instância.
ErrorCode	String	InvalidParameter	O código de erro retornado quando a instância não pode ser criada.
SpotStrategy	String	NoSpot	A política de licitação para a instância com pagamento conforme o uso. Valores válidos: NoSpot: a instância é uma instância regular com pagamento conforme o uso. SpotWithPriceLimit: a instância é uma instância preemptiva com preços máximos por hora definidos pelo usuário. SpotAsPriceGo: a instância é uma instância preemptiva para a qual o preço de mercado no momento da compra é automaticamente usado como o preço de oferta.
Amount	Integer	1	O número de instâncias criadas.
InstanceIds	Array of String	["i-bp67acfmxazb4p****"]	Os IDs das instâncias criadas.

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=CreateAutoProvisioningGroup
&LaunchTemplateId=lt-bp1fgzds4bdogu03****
&RegionId=cn-hangzhou
&TotalTargetCapacity=60
&SpotInstancePoolsToUseCount=2
&ExcessCapacityTerminationPolicy=termination
&TerminateInstancesWithExpiration=true
&TerminateInstances=false
&PayAsYouGoTargetCapacity=30
&SpotTargetCapacity=20
&DefaultTargetCapacityType=Spot
&LaunchTemplateConfig.1.InstanceType=ecs.g5.large
&LaunchTemplateConfig.1.MaxPrice=3
&LaunchTemplateConfig.1.VSwitchId=vsw-sn5bsitu4lfzgc5o7****
&LaunchTemplateConfig.1.WeightedCapacity=2
&LaunchTemplateConfig.1.Priority=1
&<Common request parameters>

Exemplos de respostas bem-sucedidas

Formato XML

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

<CreateAutoProvisioningGroupResponse>
  <AutoProvisioningGroupId>apg-sn54avj8htgvtyh8****</AutoProvisioningGroupId>
  <RequestId>745CEC9F-0DD7-4451-9FE7-8B752F39****</RequestId>
</CreateAutoProvisioningGroupResponse>

Formato JSON

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

{
  "AutoProvisioningGroupId" : "apg-sn54avj8htgvtyh8****",
  "RequestId" : "745CEC9F-0DD7-4451-9FE7-8B752F39****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	%s	Valor de parâmetro inválido.
400	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente mais tarde.
400	MissingParameter	%s	Um parâmetro obrigatório não foi especificado.
400	InvalidVSwitchId.NotFound	%s	O vSwitch especificado não foi encontrado.
400	InvalidImageFamily.Confict	The specified parameter ImageFamily should be empty when the parameter ImageId is specified.	O parâmetro ImageFamily deve ser deixado vazio se um ID de imagem for especificado.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.