Consulta os detalhes de um grupo de escalonamento especificado, como as informações básicas, as instâncias no grupo de escalonamento e as configurações de escalonamento. Para grupos de escalonamento do Elastic Container Instance (ECI), se o parâmetro OutputFormat estiver definido como YAML, a saída será retornada no formato YAML de Deployment do Kubernetes.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
ess:DescribeScalingGroupDetail |
get |
*ScalingGroup.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| RegionId |
string |
Sim |
O ID da região do grupo de escalonamento. Para mais informações, consulte Regiões e zonas. |
cn-hangzhou |
| ScalingGroupId |
string |
Sim |
O ID do grupo de escalonamento. |
asg-bp18p2yfxow2dloq**** |
| OutputFormat |
string |
Não |
O formato de saída. Somente o formato YAML é suportado. |
YAML |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| RequestId |
string |
O ID da solicitação. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
| ScalingGroup |
object |
O grupo de Auto Scaling. |
|
| VpcId |
string |
O ID da nuvem privada virtual (VPC). |
vpc-wz9fcq97y1vqkd8bijcq6 |
| CreationTime |
string |
A hora em que o grupo de Auto Scaling foi criado. A hora é exibida em UTC e segue o padrão ISO 8601 no formato AAAA-MM-DDTHH:mmZ. |
2014-08-14T10:58Z |
| TotalInstanceCount |
integer |
O número total de instâncias ECS no grupo de Auto Scaling. |
1 |
| ScalingGroupName |
string |
O nome do grupo de Auto Scaling. O nome deve ser exclusivo em uma região. O nome deve ter de 2 a 64 caracteres. Deve começar com um dígito, uma letra ou um caractere chinês, e pode conter dígitos, sublinhados (_), hifens (-) e pontos (.). |
dyrSuvBOtO1dEdIlIbp**** |
| SpotInstancePools |
integer |
O número de tipos de instância disponíveis especificados. O grupo de Auto Scaling cria instâncias spot entre os tipos de instância especificados que têm os menores custos. Valores válidos: 0 a 10. |
5 |
| StoppedCapacity |
integer |
O número de instâncias no grupo de Auto Scaling que estão no modo econômico. |
1 |
| OnDemandPercentageAboveBaseCapacity |
integer |
A porcentagem de instâncias pay-as-you-go entre as instâncias que excedem o número mínimo de instâncias pay-as-you-go especificado por OnDemandBaseCapacity. Valores válidos: 0 a 100. |
20 |
| ModificationTime |
string |
A hora em que o grupo de Auto Scaling foi modificado. A hora é exibida em UTC e segue o padrão ISO 8601 no formato AAAA-MM-DDTHH:mmZ. |
2014-08-14T10:58Z |
| MinSize |
integer |
O número mínimo de instâncias no grupo de Auto Scaling. |
1 |
| ScalingGroupId |
string |
O ID do grupo de escalonamento. |
asg-bp14wlu85wrpchm0**** |
| CompensateWithOnDemand |
boolean |
Especifica se devem ser criadas automaticamente instâncias pay-as-you-go para atender ao requisito de número de instâncias ECS quando o parâmetro MultiAZPolicy está definido como COST_OPTIMIZED e não é possível criar instâncias spot devido a problemas de preço ou estoque. Valores válidos:
|
true |
| ScalingPolicy |
string |
O modo de recuperação do grupo de Auto Scaling. Valores válidos:
Para obter mais informações sobre as ações em instâncias removidas, consulte RemoveInstances. |
recycle |
| RemovingWaitCapacity |
integer |
O número de instâncias ECS com remoção pendente no grupo de Auto Scaling. |
1 |
| ActiveCapacity |
integer |
O número de instâncias ECS que foram adicionadas ao grupo de Auto Scaling e estão em execução normal. |
1 |
| OnDemandBaseCapacity |
integer |
O número mínimo de instâncias pay-as-you-go necessárias no grupo de Auto Scaling. Valores válidos: 0 a 1000. Quando o número de instâncias pay-as-you-go no grupo de Auto Scaling é menor que esse valor, o sistema cria preferencialmente instâncias pay-as-you-go. |
30 |
| ProtectedCapacity |
integer |
O número de instâncias ECS que estão no estado protegido no grupo de Auto Scaling. |
1 |
| HealthCheckType |
string |
O modo de verificação de integridade do grupo de Auto Scaling. Valores válidos:
|
ECS |
| LifecycleState |
string |
O estado do ciclo de vida do grupo de Auto Scaling. Valores válidos:
|
Active |
| GroupDeletionProtection |
boolean |
Indica se a proteção contra exclusão está ativada para o grupo de Auto Scaling. Valores válidos:
|
true |
| ActiveScalingConfigurationId |
string |
O ID da configuração de dimensionamento ativa no grupo de Auto Scaling. |
asc-bp1et2qekq3ojr33**** |
| GroupType |
string |
O tipo de instâncias gerenciadas pelo grupo de Auto Scaling. Valores válidos:
|
ECS |
| MultiAZPolicy |
string |
A política de scale-out e scale-in para instâncias ECS em um grupo de Auto Scaling com múltiplas zonas ativas. Valores válidos:
|
PRIORITY |
| RemovingCapacity |
integer |
O número de instâncias ECS que estão sendo removidas do grupo de Auto Scaling. |
0 |
| PendingWaitCapacity |
integer |
O número de instâncias ECS com adição pendente ao grupo de Auto Scaling. |
0 |
| StandbyCapacity |
integer |
O número de instâncias que estão no estado de espera no grupo de Auto Scaling. |
1 |
| CurrentHostName |
string |
Nota
Este parâmetro não está disponível. |
hostname |
| PendingCapacity |
integer |
O número de instâncias ECS que estão sendo adicionadas ao grupo de Auto Scaling, mas não concluíram as configurações relevantes. |
0 |
| LaunchTemplateId |
string |
O ID do modelo de inicialização usado pelo grupo de Auto Scaling. |
lt-m5e3ofjr1zn1aw7**** |
| TotalCapacity |
integer |
A capacidade total ponderada de todas as instâncias no grupo de Auto Scaling se os pesos dos tipos de instância estiverem configurados. Caso contrário, este parâmetro indica o número total de instâncias no grupo de Auto Scaling. |
1 |
| DesiredCapacity |
integer |
O número esperado de instâncias no grupo de Auto Scaling. O grupo de Auto Scaling mantém automaticamente o número de instâncias ECS nesse valor esperado. |
5 |
| SpotInstanceRemedy |
boolean |
Indica se o recurso de reposição de instâncias spot está ativado. Depois que esse recurso é ativado, quando o grupo de Auto Scaling recebe uma mensagem do sistema de que uma instância spot será recuperada, o grupo de Auto Scaling tenta criar uma nova instância para substituir a instância spot a ser recuperada. |
true |
| LaunchTemplateVersion |
string |
A versão do modelo de inicialização. |
Default |
| RegionId |
string |
O ID da região do grupo de Auto Scaling. |
cn-shenzhen |
| VSwitchId |
string |
O ID do vSwitch associado ao grupo de Auto Scaling. |
vsw-bp1whw2u46cn8zubm**** |
| MaxSize |
integer |
O número máximo de instâncias no grupo de Auto Scaling. |
2 |
| DefaultCooldown |
integer |
O tempo de resfriamento. Unidade: segundos. |
60 |
| VServerGroups |
array<object> |
A lista de grupos de servidores de back-end. |
|
|
array<object> |
A lista de grupos de servidores de back-end. |
||
| LoadBalancerId |
string |
O ID da instância do Classic Load Balancer (CLB) ao qual o grupo de servidores virtuais pertence. |
147b46d767c-cn-qingdao-cm5**** |
| VServerGroupAttributes |
array<object> |
Os atributos do grupo de servidores de back-end. |
|
|
object |
Os atributos do grupo de servidores de back-end. |
||
| VServerGroupId |
string |
O ID do grupo de servidores de back-end. |
rsp-bp12bjrny**** |
| Weight |
integer |
O peso do grupo de servidores de back-end. |
1 |
| Port |
integer |
A porta do servidor de back-end. |
80 |
| LaunchTemplateOverrides |
array<object> |
As substituições de tipo de instância para o modelo de inicialização. |
|
|
object |
As substituições de tipo de instância para o modelo de inicialização. |
||
| WeightedCapacity |
integer |
O peso do tipo de instância, que indica a capacidade de uma única instância desse tipo no grupo de Auto Scaling. Um peso maior significa que menos instâncias desse tipo são necessárias para atender à capacidade esperada. |
4 |
| InstanceType |
string |
O tipo de instância especificado, que substitui o tipo de instância no modelo de inicialização. |
ecs.c5.xlarge |
| SpotPriceLimit |
number |
O preço máximo por hora para o tipo de instância especificado por LaunchTemplateOverride.InstanceType. Nota
Este parâmetro entra em vigor apenas quando o parâmetro LaunchTemplateId é especificado. |
0.025 |
| AlbServerGroups |
array<object> |
As informações sobre os grupos de servidores ALB. |
|
|
object |
As informações sobre os grupos de servidores ALB. |
||
| AlbServerGroupId |
string |
O ID do grupo de servidores ALB. |
sgp-ddwb0y0g6y9bjm**** |
| Weight |
integer |
O peso da instância como servidor de back-end depois que o Auto Scaling adiciona a instância ao grupo de servidores ALB. |
100 |
| Port |
integer |
O número da porta usado pela instância depois que o Auto Scaling adiciona a instância ao grupo de servidores ALB. |
80 |
| ServerGroups |
array<object> |
As informações sobre os grupos de servidores de balanceamento de carga. Nota
Você pode usar este parâmetro para obter informações sobre os grupos de serviços ALB, grupos de servidores NLB e grupos de serviços GWLB associados ao grupo de Auto Scaling. |
|
|
object |
As informações sobre o grupo de servidores de balanceamento de carga. |
||
| ServerGroupId |
string |
O ID do grupo de servidores. |
sgp-i9ouakeaerr***** |
| Type |
string |
O tipo do grupo de servidores de balanceamento de carga. Valores válidos:
|
ALB |
| Weight |
integer |
O peso da instância como servidor de back-end depois que o Auto Scaling adiciona a instância ao grupo de servidores. |
100 |
| Port |
integer |
O número da porta usado pela instância depois que o Auto Scaling adiciona a instância ao grupo de servidores. |
80 |
| RemovalPolicies |
array |
As políticas para remoção de instâncias do grupo de Auto Scaling. |
|
|
string |
A política para remoção de instâncias ECS do grupo de Auto Scaling. Valores válidos:
|
OldestScalingConfiguration |
|
| DBInstanceIds |
array |
Os IDs das instâncias do ApsaraDB RDS associadas ao grupo de Auto Scaling. |
|
|
string |
Os IDs das instâncias do ApsaraDB RDS associadas ao grupo de Auto Scaling. |
rm-bp15556qzebg1**** |
|
| LoadBalancerIds |
array |
Os IDs das instâncias de balanceamento de carga associadas ao grupo de Auto Scaling. |
|
|
string |
Os IDs das instâncias de balanceamento de carga associadas ao grupo de Auto Scaling. |
lb-bp19byhscefk3x0li**** |
|
| VSwitchIds |
array |
Os IDs dos vSwitches associados ao grupo de Auto Scaling. Se você especificar o parâmetro VSwitchIds, o parâmetro VSwitchId será ignorado. |
|
|
string |
Os IDs dos vSwitches associados ao grupo de Auto Scaling. Se você especificar o parâmetro VSwitchIds, o parâmetro VSwitchId será ignorado. |
vsw-bp1whw2u46cn8zubm**** |
|
| SuspendedProcesses |
array |
Os processos suspensos. Se nenhum processo estiver suspenso, um valor vazio será retornado. Valores válidos:
|
|
|
string |
Os processos suspensos. Se nenhum processo estiver suspenso, um valor vazio será retornado. Valores válidos:
|
ScaleIn |
|
| SystemSuspended |
boolean |
Indica se o Auto Scaling suspende a execução da atividade de dimensionamento no grupo de Auto Scaling. Valores válidos:
|
true |
| IsElasticStrengthInAlarm |
boolean |
Nota
Este parâmetro não está disponível. |
false |
| MonitorGroupId |
string |
O ID do grupo de aplicativos do CloudMonitor associado ao grupo de Auto Scaling. |
1497**** |
| AzBalance |
boolean |
Indica se a capacidade do grupo de Auto Scaling está distribuída uniformemente entre múltiplas zonas. Este parâmetro entra em vigor apenas quando o parâmetro MultiAZPolicy está definido como COMPOSABLE. Valores válidos:
|
false |
| AllocationStrategy |
string |
A estratégia de alocação de capacidade, que determina como o grupo de Auto Scaling seleciona os tipos de instância disponíveis para atender aos requisitos de capacidade. A estratégia de distribuição de capacidade se aplica às capacidades pay-as-you-go e spot. Este parâmetro entra em vigor apenas quando o parâmetro MultiAZPolicy está definido como COMPOSABLE. Valores válidos:
|
priority |
| SpotAllocationStrategy |
string |
A estratégia de alocação de capacidade, que determina como o grupo de Auto Scaling seleciona os tipos de instância disponíveis para atender aos requisitos de capacidade. A estratégia de distribuição de capacidade se aplica às capacidades pay-as-you-go e spot. Este parâmetro entra em vigor apenas quando o parâmetro MultiAZPolicy está definido como COMPOSABLE. Valores válidos:
|
lowestPrice |
| MaxInstanceLifetime |
integer |
O tempo de vida máximo de uma instância no grupo de Auto Scaling. Unidade: segundos. Valores válidos: 0 ou [86400, Integer.maxValue]. Um valor de 0 indica que o valor de MaxInstanceLifetime foi limpo, o que significa que MaxInstanceLifetime não está configurado. Valor padrão: null. Nota
Este parâmetro não é suportado para grupos de Auto Scaling de ECI ou grupos de Auto Scaling que têm o modo econômico ativado. |
null |
| CustomPolicyARN |
string |
O Alibaba Cloud Resource Name (ARN) da função do Function Compute para a política de scale-in personalizada. Este parâmetro entra em vigor apenas quando a primeira política de remoção em RemovalPolicies está definida como CustomPolicy. |
null |
| InitCapacity |
integer |
O número de instâncias no grupo de escalonamento que estão no estado de inicialização antes do scale-out. |
0 |
| ResourceGroupId |
string |
O ID do grupo de recursos ao qual o grupo de escalonamento recém-criado pertence. Nota
Atribui o grupo de escalonamento recém-criado ao grupo de recursos especificado. Se você não especificar esse parâmetro, o grupo de escalonamento pertencerá ao grupo de recursos padrão. |
rg-aek2epf32c4uyji |
| LoadBalancerConfigs |
array<object> |
A lista de configurações de balanceamento de carga. |
|
|
object |
A lista de configurações de balanceamento de carga. |
||
| LoadBalancerId |
string |
O ID da instância de balanceamento de carga CLB (anteriormente SLB). |
lb-2zein3ytoeq49cmkbyxr0 |
| Weight |
integer |
O peso do servidor de backend. |
100 |
| EnableDesiredCapacity |
boolean |
Indica se o recurso de número esperado de instâncias está ativado. Valores válidos:\n- true: O recurso de número esperado de instâncias está ativado.\n- false: O recurso de número esperado de instâncias está desativado. |
true |
| Tags |
array<object> |
O conjunto de tags do grupo de escalonamento. |
|
|
object |
O conjunto de tags do grupo de escalonamento. |
||
| TagKey |
string |
A chave da tag do grupo de escalonamento. |
Department |
| TagValue |
string |
O valor da tag do grupo de escalonamento. |
Finance |
| Propagate |
boolean |
Indica se a tag é propagada. Valores válidos:\n- true: As tags no grupo de escalonamento são propagadas apenas para instâncias recém-criadas, e não para instâncias existentes em execução no grupo de escalonamento.\n- false: As tags no grupo de escalonamento não são propagadas para as instâncias.\n\nValor padrão: false. |
false |
| HealthCheckTypes |
array |
O modo de verificação de integridade do grupo de escalonamento. Valores válidos:\n\n- NONE: Nenhuma verificação de integridade é realizada.\n- ECS: Realiza verificações de integridade nas instâncias do grupo de escalonamento. Este valor é usado para ativar as verificações de integridade de instâncias para grupos de escalonamento ECS e Elastic Container Instance (ECI).\n- LOAD_BALANCER: Determina o status de integridade das instâncias com base nos resultados da verificação de integridade do balanceamento de carga (o tipo de balanceamento de carga CLB não é suportado atualmente). |
|
|
string |
O modo de verificação de integridade do grupo de escalonamento. Valores válidos:\n\n- NONE: Nenhuma verificação de integridade é realizada.\n- ECS: Realiza verificações de integridade nas instâncias do grupo de escalonamento. Este valor é usado para ativar as verificações de integridade de instâncias para grupos de escalonamento ECS e Elastic Container Instance (ECI).\n- LOAD_BALANCER: Determina o status de integridade das instâncias com base nos resultados da verificação de integridade do balanceamento de carga (o tipo de balanceamento de carga CLB não é suportado atualmente). |
ECS |
|
| Output |
string |
Os detalhes de saída do grupo de escalonamento ECI. Atualmente, apenas o formato YAML de Deployment do Kubernetes é suportado. |
apiVersion: apps/v1 kind: Deployment metadata: name: nginx-deployment labels: app: nginx spec: replicas: 3 selector: matchLabels: app: nginx template: metadata: labels: app: nginx annotations: k8s.aliyun.com/eip-bandwidth: 10 k8s.aliyun.com/eci-with-eip: true spec: containers: - name: nginx image: nginx:1.14.2 ports: - containerPort: 80 |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"ScalingGroup": {
"VpcId": "vpc-wz9fcq97y1vqkd8bijcq6",
"CreationTime": "2014-08-14T10:58Z\n",
"TotalInstanceCount": 1,
"ScalingGroupName": "dyrSuvBOtO1dEdIlIbp****\n",
"SpotInstancePools": 5,
"StoppedCapacity": 1,
"OnDemandPercentageAboveBaseCapacity": 20,
"ModificationTime": "2014-08-14T10:58Z\n",
"MinSize": 1,
"ScalingGroupId": "asg-bp14wlu85wrpchm0****\n",
"CompensateWithOnDemand": true,
"ScalingPolicy": "recycle",
"RemovingWaitCapacity": 1,
"ActiveCapacity": 1,
"OnDemandBaseCapacity": 30,
"ProtectedCapacity": 1,
"HealthCheckType": "ECS",
"LifecycleState": "Active",
"GroupDeletionProtection": true,
"ActiveScalingConfigurationId": "asc-bp1et2qekq3ojr33****\n",
"GroupType": "ECS",
"MultiAZPolicy": "PRIORITY",
"RemovingCapacity": 0,
"PendingWaitCapacity": 0,
"StandbyCapacity": 1,
"CurrentHostName": "hostname",
"PendingCapacity": 0,
"LaunchTemplateId": "lt-m5e3ofjr1zn1aw7****\n",
"TotalCapacity": 1,
"DesiredCapacity": 5,
"SpotInstanceRemedy": true,
"LaunchTemplateVersion": "Default",
"RegionId": "cn-shenzhen",
"VSwitchId": "vsw-bp1whw2u46cn8zubm****\n",
"MaxSize": 2,
"DefaultCooldown": 60,
"VServerGroups": [
{
"LoadBalancerId": "147b46d767c-cn-qingdao-cm5****\n",
"VServerGroupAttributes": [
{
"VServerGroupId": "rsp-bp12bjrny****\n",
"Weight": 1,
"Port": 80
}
]
}
],
"LaunchTemplateOverrides": [
{
"WeightedCapacity": 4,
"InstanceType": "ecs.c5.xlarge\n",
"SpotPriceLimit": 0.025
}
],
"AlbServerGroups": [
{
"AlbServerGroupId": "sgp-ddwb0y0g6y9bjm****\n",
"Weight": 100,
"Port": 80
}
],
"ServerGroups": [
{
"ServerGroupId": "sgp-i9ouakeaerr*****\n",
"Type": "ALB",
"Weight": 100,
"Port": 80
}
],
"RemovalPolicies": [
"OldestScalingConfiguration"
],
"DBInstanceIds": [
"rm-bp15556qzebg1****\n"
],
"LoadBalancerIds": [
"lb-bp19byhscefk3x0li****\n"
],
"VSwitchIds": [
"vsw-bp1whw2u46cn8zubm****\n"
],
"SuspendedProcesses": [
"ScaleIn"
],
"SystemSuspended": true,
"IsElasticStrengthInAlarm": false,
"MonitorGroupId": "1497****\n",
"AzBalance": false,
"AllocationStrategy": "priority",
"SpotAllocationStrategy": "lowestPrice",
"MaxInstanceLifetime": 0,
"CustomPolicyARN": "null",
"InitCapacity": 0,
"ResourceGroupId": "rg-aek2epf32c4uyji",
"LoadBalancerConfigs": [
{
"LoadBalancerId": "lb-2zein3ytoeq49cmkbyxr0",
"Weight": 100
}
],
"EnableDesiredCapacity": true,
"Tags": [
{
"TagKey": "Department",
"TagValue": "Finance",
"Propagate": false
}
],
"HealthCheckTypes": [
"ECS"
]
},
"Output": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: nginx-deployment\n labels:\n app: nginx\n spec:\n replicas: 3\n selector:\n matchLabels:\n app: nginx\n template:\n metadata:\n labels:\n app: nginx\n annotations:\n k8s.aliyun.com/eip-bandwidth: 10\n k8s.aliyun.com/eci-with-eip: true\n spec:\n containers:\n - name: nginx\n image: nginx:1.14.2\n ports:\n - containerPort: 80"
}
Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.