DescribeElasticStrength - Auto Scaling: Central de Documentação do Alibaba Cloud

A configuração de um grupo de escalabilidade é fundamental para scale-outs bem-sucedidos. O Auto Scaling usa a força elástica para quantificar a eficácia de uma configuração de escalabilidade, ajudando você a realizar otimizações direcionadas.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ess:DescribeElasticStrength

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região onde o grupo de escalabilidade está localizado.	cn-qingdao
ScalingGroupId	string	Não	O ID do grupo de escalabilidade.	asg-bp18p2yfxow2dloq****
InstanceTypes	array	Não	Uma lista de tipos de instância ECS. Se especificado, este parâmetro substitui os tipos de instância na configuração de escalabilidade.
	string	Não	O tipo de instância ECS.	ecs.g6.large
PriorityStrategy	string	Não	Aviso Este parâmetro está obsoleto. Use `SpotStrategy` em vez disso. A estratégia spot para instâncias pay-as-you-go. Se especificado, este parâmetro substitui a estratégia spot na configuração de escalabilidade. Valores válidos: `NoSpot`: Uma instância pay-as-you-go regular. `SpotWithPriceLimit`: Uma instância spot com um preço máximo especificado. `SpotAsPriceGo`: Uma instância spot em que o sistema faz lances automaticamente pelo preço de mercado atual. Valor padrão: `NoSpot`.	NoSpot
SystemDiskCategories	array	Não	Uma lista de categorias de disco de sistema. Se especificado, este parâmetro substitui as categorias de disco de sistema na configuração de escalabilidade. Valores válidos: `cloud`: Disco em Nuvem Básico. `cloud_efficiency`: Disco em Nuvem Ultra. `cloud_ssd`: SSD Padrão. `cloud_essd`: ESSD. Nota Este parâmetro é obrigatório se `ScalingGroupId` não for especificado.
	string	Não	A categoria do disco de sistema. Valores válidos: `cloud`: Disco em Nuvem Básico. `cloud_efficiency`: Disco em Nuvem Ultra. `cloud_ssd`: SSD Padrão. `cloud_essd`: ESSD.	cloud
ScalingGroupIds	array	Não	Os IDs de um ou mais grupos de escalabilidade para consultar em uma operação em lote.
	string	Não	O ID de um grupo de escalabilidade.	asg-bp14wlu85wrpchm0****
SpotStrategy	string	Não	A estratégia spot para instâncias. Valores válidos: `NoSpot`: Uma instância pay-as-you-go regular. `SpotWithPriceLimit`: Uma instância spot com um preço máximo especificado. `SpotAsPriceGo`: Uma instância spot em que o sistema faz lances automaticamente pelo preço de mercado atual. Valor padrão: `NoSpot`.	NoSpot
VSwitchIds	array	Não	Uma lista de IDs de VSwitch. Nota Este parâmetro é obrigatório se `ScalingGroupId` não for especificado.
	string	Não	O ID do VSwitch.	vsw-bp1whw2u46cn8zubm****
ImageId	string	Não	O ID da imagem usada para criar instâncias. Nota Se `ScalingGroupId` não for especificado, você deve especificar pelo menos um entre `ImageId`, `ImageName` ou `ImageFamily`.	centos6u5_64_20G_aliaegis****.vhd
ImageName	string	Não	O nome da imagem. O nome deve ser exclusivo dentro de uma região. Se você especificar `ImageId`, este parâmetro será ignorado. Você não pode usar este parâmetro para especificar uma imagem do Marketplace. Nota Se `ScalingGroupId` não for especificado, você deve especificar pelo menos um entre `ImageId`, `ImageName` ou `ImageFamily`.	ubuntu_18_04_x64_20G_alibase_20231225.vhd
ImageFamily	string	Não	O nome da família de imagens. Você pode definir este parâmetro para usar a imagem disponível mais recente da família de imagens especificada para criar instâncias. Se você especificar ImageId, este parâmetro será ignorado. Nota Se `ScalingGroupId` não for especificado, você deve especificar pelo menos um entre `ImageId`, `ImageName` ou `ImageFamily`.	CentOS7
DataDiskCategories	array	Não	Uma lista de categorias de disco de dados usadas para avaliar a força elástica. Se uma categoria for incompatível, a resposta identifica a categoria específica incompatível. Nota Você pode especificar este parâmetro se `ScalingGroupId` não for especificado.
	string	Não	A categoria do disco de dados. Valores válidos: `cloud`: Disco em Nuvem Básico `cloud_efficiency`: Disco em Nuvem Ultra `cloud_ssd`: SSD Padrão `cloud_essd`: ESSD `ephemeral_ssd`: SSD local	cloud_essd
Ipv6AddressCount	integer	Não	O número de endereços IPv6 a serem configurados para cada instância. A força elástica é reduzida para tipos de instância que não suportam o número especificado de endereços IPv6. Nota Você pode especificar este parâmetro se `ScalingGroupId` não for especificado.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O esquema de resposta.
RequestId	string	O ID da solicitação.	73469C7-AA6F-4DC5-B3DB-A3DC0DE3****
TotalStrength	number	A força elástica total do grupo de escalabilidade. A força é a soma das pontuações de todas as combinações configuradas de tipo de instância e zona. Cada combinação recebe uma pontuação de 0 (força baixa) a 1 (força alta) com base na disponibilidade de recursos. Aviso Este parâmetro está obsoleto.	1.5
ElasticStrength	string	A força elástica do grupo de escalabilidade atual. Valores válidos: Strong: força elástica alta. Medium: força elástica média. Weak: força elástica fraca.	Strong
ResourcePools	array<object>	Um array de pools de recursos. Este parâmetro é retornado quando a chamada de API é direcionada a um único grupo de escalabilidade.
	array<object>
Strength	number	A força elástica do pool de recursos.	0.6
InstanceType	string	O tipo de instância do pool de recursos.	ecs.c7t.xlarge
ZoneId	string	O ID da zona do pool de recursos.	cn-hangzhou-g
VSwitchIds	array	Os VSwitches na zona do pool de recursos.
	string	O ID do VSwitch.	vsw-2ze0uc933kantv******
Code	string	O código de erro retornado quando a força elástica é 0.	IMG_NOT_SUPPORTED
Msg	string	A mensagem de erro retornada quando a força elástica é 0.	The instanceType does not support the image in the configuration.
Status	string	A disponibilidade do pool de recursos. Valores válidos: Available: O pool de recursos está disponível. Unavailable: O pool de recursos está indisponível. Isso pode ocorrer se o tipo de instância não estiver implantado na zona, tiver inventário insuficiente ou não atender a outras restrições.	Available
InventoryHealth	object	A saúde do inventário.
HealthScore	integer	The health score. A score from 5 to 6 indicates high confidence in supply. A score from 1 to 4 indicates that supply is not guaranteed. Consider making on-demand reservations. A score from -3 to 0 indicates a supply health alert. Consider using a different instance type. The health score is calculated using the formula: `HealthScore` = `AdequacyScore` + `SupplyScore` - `HotScore`.	3
AdequacyScore	integer	The adequacy score. Valid values: 0 to 3.	3
SupplyScore	integer	The supply score. Valid values: 0 to 3.	3
HotScore	integer	The hot score. Valid values: 0 to 3.	3
ElasticStrength	string	A força elástica do pool de recursos, que é baseada na saúde do inventário e no estoque atual. Valores válidos: Strong: força elástica alta. Medium: força elástica média. Weak: força elástica fraca.	Medium
ElasticStrengthModels	array<object>	Um array de detalhes de força elástica, retornado quando a chamada de API é direcionada a múltiplos grupos de escalabilidade.
	array<object>
ScalingGroupId	string	O ID do grupo de escalabilidade.	asg-wz98mnj7nblv9gc****
ElasticStrength	string	A força elástica do grupo de escalabilidade atual. Valores válidos: Strong: força elástica alta. Medium: força elástica média. Weak: força elástica fraca.	Strong
TotalStrength	number	A força elástica total do grupo de escalabilidade. A força é a soma das pontuações de todas as combinações configuradas de tipo de instância e zona. Cada combinação recebe uma pontuação de 0 (força baixa) a 1 (força alta) com base na disponibilidade de recursos. Aviso Este parâmetro está obsoleto.	1.5
ResourcePools	array<object>	Detalhes dos pools de recursos dentro do grupo de escalabilidade.
	array<object>
InstanceType	string	The instance type of the resource pool.	ecs.r7.large
Strength	number	The elastic strength of the resource pool. Aviso This parameter is deprecated.	0.6
ZoneId	string	The zone ID of the resource pool.	cn-hangzhou-g
VSwitchIds	array	The VSwitches in the zone of the resource pool.
	string	The VSwitch ID.	vsw-2ze6e8p4******
Code	string	The error code returned when the elastic strength is 0.	InstanceTypesOrDiskTypesNotSupported
Msg	string	The error message returned when the elastic strength is 0.	The instanceTypes or diskTypes are not supported.
Status	string	The availability of the resource pool. Valid values: Available: The resource pool is available. Unavailable: The resource pool is unavailable. This can occur if the instance type is not deployed in the zone, has insufficient inventory, or does not meet other constraints.	Available
InventoryHealth	object	The inventory health.
HealthScore	integer	The health score. A score from 5 to 6 indicates high confidence in supply. A score from 1 to 4 indicates that supply is not guaranteed. Consider making on-demand reservations. A score from -3 to 0 indicates a supply health alert. Consider using a different instance type. The health score is calculated using the formula: `HealthScore` = `AdequacyScore` + `SupplyScore` - `HotScore`.	3
AdequacyScore	integer	The adequacy score. Valid values: 0 to 3.	3
SupplyScore	integer	The supply score. Valid values: 0 to 3.	2
HotScore	integer	The hot score. Valid values: 0 to 3.	0
ElasticStrength	string	The elastic strength of the resource pool, which is based on its inventory health and current stock. Valid values: Strong: high elastic strength. Medium: medium elastic strength. Weak: weak elastic strength.	Strong

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "73469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TotalStrength": 1.5,
  "ElasticStrength": "Strong",
  "ResourcePools": [
    {
      "Strength": 0.6,
      "InstanceType": "ecs.c7t.xlarge",
      "ZoneId": "cn-hangzhou-g",
      "VSwitchIds": [
        "vsw-2ze0uc933kantv******"
      ],
      "Code": "IMG_NOT_SUPPORTED",
      "Msg": "The instanceType does not support the image in the configuration.",
      "Status": "Available",
      "InventoryHealth": {
        "HealthScore": 3,
        "AdequacyScore": 3,
        "SupplyScore": 3,
        "HotScore": 3
      },
      "ElasticStrength": "Medium"
    }
  ],
  "ElasticStrengthModels": [
    {
      "ScalingGroupId": "asg-wz98mnj7nblv9gc****",
      "ElasticStrength": "Strong",
      "TotalStrength": 1.5,
      "ResourcePools": [
        {
          "InstanceType": "ecs.r7.large",
          "Strength": 0.6,
          "ZoneId": "cn-hangzhou-g",
          "VSwitchIds": [
            "vsw-2ze6e8p4******"
          ],
          "Code": "InstanceTypesOrDiskTypesNotSupported",
          "Msg": "The instanceTypes or diskTypes are not supported.",
          "Status": "Available",
          "InventoryHealth": {
            "HealthScore": 3,
            "AdequacyScore": 3,
            "SupplyScore": 2,
            "HotScore": 0
          },
          "ElasticStrength": "Strong"
        }
      ]
    }
  ]
}

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.