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

A validade da configuração de um grupo de escalabilidade determina em grande parte a taxa de sucesso das operações de expansão. O Auto Scaling utiliza a força elástica para descrever a validade das configurações de escalabilidade, quantificando a qualidade da configuração e ajudando você a otimizar as configurações de escalabilidade adequadamente.

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 do grupo de escalabilidade.	cn-qingdao
ScalingGroupId	string	Não	O ID do grupo de escalabilidade.	asg-bp18p2yfxow2dloq****
InstanceTypes	array	Não	A coleção de tipos de instância para instâncias 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 da instância ECS.	ecs.g6.large
PriorityStrategy	string	Não	Nota Este parâmetro está obsoleto. Use SpotStrategy em vez disso. A política de preempção para instâncias pay-as-you-go. Se especificado, este parâmetro substitui a política de preempção configurada para o grupo de escalabilidade. Valores válidos: NoSpot: uma instância pay-as-you-go regular. SpotWithPriceLimit: uma instância spot com limite de preço máximo. SpotAsPriceGo: uma instância spot com preço baseado na taxa de mercado atual. Valor padrão: NoSpot.	NoSpot
SystemDiskCategories	array	Não	Os tipos de disco em nuvem do sistema. Se especificado, este parâmetro substitui os tipos de disco em nuvem do 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: Enterprise SSD (ESSD). Nota Se você não especificar um ID de grupo de escalabilidade, deverá especificar este parâmetro.
	string	Não	Os tipos de disco em nuvem do sistema. Valores válidos: cloud: disco em nuvem básico. cloud_efficiency: disco em nuvem ultra. cloud_ssd: SSD padrão. cloud_essd: Enterprise SSD (ESSD).	cloud
ScalingGroupIds	array	Não	Os IDs dos grupos de escalabilidade para consultas em lote.
	string	Não	O ID do grupo de escalabilidade.	asg-bp14wlu85wrpchm0****
SpotStrategy	string	Não	A política de preempção para instâncias. Valores válidos: NoSpot: uma instância pay-as-you-go regular. SpotWithPriceLimit: uma instância spot com limite de preço máximo. SpotAsPriceGo: uma instância spot com preço baseado na taxa de mercado atual. Valor padrão: NoSpot.	NoSpot
VSwitchIds	array	Não	Os IDs de múltiplos vSwitches. Nota Se você não especificar um ID de grupo de escalabilidade, deverá especificar este parâmetro.
	string	Não	Os IDs de múltiplos vSwitches. Nota Se você não especificar um ID de grupo de escalabilidade, deverá especificar este parâmetro.	vsw-bp1whw2u46cn8zubm****
ImageId	string	Não	O ID do arquivo de imagem. O recurso de imagem utilizado para a criação automática de instâncias. Nota Se você não especificar um ID de grupo de escalabilidade, deverá especificar pelo menos um entre ImageId, ImageName ou ImageFamily.	centos6u5_64_20G_aliaegis****.vhd
ImageName	string	Não	O nome da imagem. Os nomes de imagem são exclusivos dentro de uma região. Se ImageId for especificado, ImageName será ignorado. Você não pode usar ImageName para especificar imagens do Alibaba Cloud Marketplace. Nota Se você não especificar um ID de grupo de escalabilidade, deverá 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. Se você especificar este parâmetro, a imagem disponível mais recente na família de imagens especificada será usada para criar instâncias. Se ImageId já estiver especificado, você não poderá especificar este parâmetro. Nota Se você não especificar um ID de grupo de escalabilidade, deverá especificar pelo menos um entre ImageId, ImageName ou ImageFamily.	CentOS7
DataDiskCategories	array	Não	A força elástica quando múltiplos tipos de disco em nuvem de dados são especificados. Se um tipo de disco em nuvem de dados não corresponder, o tipo de disco específico incompatível será retornado no resultado da consulta. Nota Se você não especificar um ID de grupo de escalabilidade, poderá especificar este parâmetro.
	string	Não	O tipo de disco em nuvem de dados. Valores válidos: cloud: disco em nuvem básico cloud_efficiency: disco em nuvem ultra cloud_ssd: SSD padrão cloud_essd: Enterprise SSD (ESSD) ephemeral_ssd: SSD local.	cloud_essd
Ipv6AddressCount	integer	Não	O número de endereços IPv6. Se o tipo de instância não atender ao requisito de contagem de endereços IPv6, a força elástica será degradada. Nota Se você não especificar um ID de grupo de escalabilidade, poderá especificar este parâmetro.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Schema da resposta.
RequestId	string	O ID da solicitação.	73469C7-AA6F-4DC5-B3DB-A3DC0DE3****
TotalStrength	number	A força elástica do grupo de escalabilidade. Cada combinação de tipo de instância e zona recebe uma pontuação de 0 a 1 com base nas condições de fornecimento, onde 0 indica baixa força elástica e 1 indica alta força elástica. A soma das pontuações de todas as combinações de tipo de instância e zona representa a força elástica do grupo de escalabilidade. Aviso Este parâmetro está obsoleto. .	1.5
ElasticStrength	string	A força elástica do grupo de escalabilidade atual. Valores válidos: Strong: alta força elástica. Medium: média força elástica. Weak: baixa força elástica.	Strong
ResourcePools	array<object>	A força elástica ao consultar 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 motivo (código de erro) quando a força elástica é 0.	InstanceTypesOrDiskTypesNotSupported
Msg	string	O motivo (descrição do erro) quando a força elástica é 0.	The instanceTypes or diskTypes are not supported.
Status	string	Indica se o pool de recursos está disponível. Valores válidos: Available: disponível. Unavailable: indisponível. Violações de restrições, tipos de instância não implantados ou tipos de instância esgotados podem tornar o tipo de instância indisponível.	Available
InventoryHealth	object	As informações de saúde do inventário.
HealthScore	integer	The inventory health score. 5 to 6: indicates high supply certainty. 1 to 4: indicates uncertain supply. Consider reservations as needed. -3 to 0: indicates a supply health warning. Consider switching to a different instance type. Formula: `HealthScore` (inventory health score) = `AdequacyScore` (adequacy) + `SupplyScore` (replenishment capability) - `HotScore` (demand intensity).	3
AdequacyScore	integer	The adequacy score. Valid values: 0 to 3.	3
SupplyScore	integer	The replenishment capability score. Valid values: 0 to 3.	3
HotScore	integer	The demand intensity score. Valid values: 0 to 3.	3
ElasticStrength	string	A força elástica do pool de recursos atual, que leva em consideração tanto a saúde do inventário quanto o status atual do inventário do pool de recursos. Valores válidos: Strong: alta força elástica. Medium: média força elástica. Weak: baixa força elástica.	Medium
ElasticStrengthModels	array<object>	A força elástica ao consultar grupos de escalabilidade em lote.
	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: alta força elástica. Medium: média força elástica. Weak: baixa força elástica.	Strong
TotalStrength	number	A força elástica do grupo de escalabilidade atual. Cada combinação de tipo de instância e zona recebe uma pontuação de 0 a 1 com base nas condições de fornecimento, onde 0 indica baixa força elástica e 1 indica alta força elástica. A soma das pontuações de todas as combinações de tipo de instância e zona representa a força elástica do grupo de escalabilidade. Aviso Este parâmetro está obsoleto. .	5
ResourcePools	array<object>	As informações de força elástica para cada pool de recursos.
	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-2ze6e8p4aid08lymlsguv
Code	string	The reason (error code) when the elastic strength is 0.	InstanceTypesOrDiskTypesNotSupported
Msg	string	The reason (error description) when the elastic strength is 0.	The instanceTypes or diskTypes are not supported.
Status	string	Indicates whether the resource pool is available. Valid values: Available: available. Unavailable: unavailable. Constraint violations, undeployed instance types, or out-of-stock instance types can cause the instance type to be unavailable.	Available
InventoryHealth	object	The inventory health information.
HealthScore	integer	The inventory health score. 5 to 6: indicates high supply certainty. 1 to 4: indicates uncertain supply. Consider reservations as needed. -3 to 0: indicates a supply health warning. Consider switching to a different instance type. Formula: `HealthScore` (inventory health score) = `AdequacyScore` (adequacy) + `SupplyScore` (replenishment capability) - `HotScore` (demand intensity).	3
AdequacyScore	integer	The adequacy score. Valid values: 0 to 3.	3
SupplyScore	integer	The replenishment capability score. Valid values: 0 to 3.	2
HotScore	integer	The demand intensity score. Valid values: 0 to 3.	0
ElasticStrength	string	The elastic strength of the current resource pool, which takes into account both the inventory health and current inventory status of the resource pool. Valid values: Strong: high elastic strength. Medium: medium elastic strength. Weak: low 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": "InstanceTypesOrDiskTypesNotSupported",
      "Msg": "The instanceTypes or diskTypes are not supported.",
      "Status": "Available",
      "InventoryHealth": {
        "HealthScore": 3,
        "AdequacyScore": 3,
        "SupplyScore": 3,
        "HotScore": 3
      },
      "ElasticStrength": "Medium"
    }
  ],
  "ElasticStrengthModels": [
    {
      "ScalingGroupId": "asg-wz98mnj7nblv9gc****",
      "ElasticStrength": "Strong",
      "TotalStrength": 5,
      "ResourcePools": [
        {
          "InstanceType": "ecs.r7.large",
          "Strength": 0.6,
          "ZoneId": "cn-hangzhou-g",
          "VSwitchIds": [
            "vsw-2ze6e8p4aid08lymlsguv"
          ],
          "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.