DescribeRecommendInstanceType - Elastic Compute Service: Central de Documentação do Alibaba Cloud

(Beta) Consulta um ou mais tipos de instância alternativos com base em um tipo de instância especificado. Para tipos de instância que foram ou serão descontinuados, DescribeRecommendInstanceType lista todos os tipos de instância que podem servir como substitutos.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Cores	integer	Não	O número de vCPUs da instância ECS. Nota Se você especificar os parâmetros Cores e Memory, o sistema seleciona todos os tipos de instância que atendem aos requisitos de vCPU e memória especificados.	2
Memory	number	Não	O tamanho da memória da instância ECS. Unidade: GiB. Nota Se você especificar os parâmetros Cores e Memory, o sistema seleciona todos os tipos de instância que atendem aos requisitos de vCPU e memória especificados.	8.0
InstanceFamilyLevel	string	Não	O nível da família de instâncias. Valores válidos: EntryLevel: nível de entrada. EnterpriseLevel: nível corporativo. CreditEntryLevel: nível de entrada baseado em créditos. Para obter detalhes, consulte Instâncias com desempenho intermitente.	EnterpriseLevel
InstanceType	string	Não	O tipo de instância especificado. Para obter detalhes, consulte Famílias de instâncias. Você também pode chamar a operação DescribeInstanceTypes para consultar a lista mais recente de tipos de instância. Nota Se você especificar InstanceType, não poderá especificar Cores ou Memory.	ecs.hfg6.large
NetworkType	string	Sim	O tipo de rede da instância ECS. Valores válidos: vpc: virtual private cloud (VPC). classic: rede clássica. A rede clássica não está mais disponível. Para obter mais informações, consulte Aviso de descontinuação. Valor padrão: vpc.	vpc
InstanceChargeType	string	Não	O método de cobrança da instância ECS. Para obter detalhes, consulte Visão geral da cobrança. Valores válidos: PrePaid: assinatura. PostPaid: pay-as-you-go. Valor padrão: PostPaid.	PostPaid
SpotStrategy	string	Não	A política de lance para a instância spot. Valores válidos: NoSpot: uma instância pay-as-you-go. SpotWithPriceLimit: uma instância spot com um preço máximo por hora. SpotAsPriceGo: uma instância spot para a qual o sistema dá lances automaticamente até o preço pay-as-you-go. Nota Ao usar SpotStrategy, defina InstanceChargerType como PostPaid. Valor padrão: NoSpot.	NoSpot
IoOptimized	string	Não	Especifica se a instância é otimizada para E/S. Se o tipo de instância suportar apenas instâncias não otimizadas para E/S, você não poderá definir o parâmetro IoOptimized. Valores válidos: optimized: otimizada para E/S. none: não otimizada para E/S. Valor padrão: optimized. Se você especificar um tipo de instância descontinuado, o valor padrão será none.	optimized
PriorityStrategy	string	Não	A estratégia de recomendação baseada em prioridade. Valores válidos: InventoryFirst: inventário primeiro. PriceFirst: preço primeiro. Os tipos de instância são classificados pelo preço unitário da vCPU por hora em ordem crescente. NewProductFirst: produto mais recente primeiro. Valor padrão: InventoryFirst.	PriceFirst
MaxPrice	number	Não	O preço máximo aceitável por hora para instâncias pay-as-you-go ou spot. Nota Para definir o preço máximo por hora para uma instância spot, defina SpotStrategy como SpotWithPriceLimit.	10.0
RegionId	string	Sim	O ID da região. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
ZoneId	string	Não	O ID da zona. Você pode chamar DescribeZones para consultar a lista de zonas mais recente. Defina ZoneMatchMode como Include (valor padrão) para recomendar preferencialmente tipos de instância na zona especificada por ZoneId e também listar tipos de instância em outras zonas dentro da mesma região.	cn-hangzhou-f
SystemDiskCategory	string	Não	A categoria do disco do sistema. Valores válidos: cloud_efficiency: ultra disco. cloud_ssd: SSD padrão. cloud_essd: SSD corporativo (ESSD). cloud: disco básico. Valor padrão para instâncias não otimizadas para E/S: cloud. Valor padrão para instâncias otimizadas para E/S: cloud_efficiency.	cloud_ssd
ZoneMatchMode	string	Não	Especifica se deve recomendar apenas tipos de instância na zona especificada por ZoneId. Valores válidos: Strict: recomenda apenas tipos de instância na zona especificada por ZoneId. Include: recomenda tipos de instância em outras zonas dentro da mesma região. Quando ZoneId é especificado, o valor padrão deste parâmetro é Strict, o que indica que apenas os tipos de instância na zona especificada por ZoneId são recomendados.	Strict
Scene	string	Não	O cenário no qual os tipos de instância são recomendados. Valores válidos: UPGRADE: upgrade ou downgrade de um tipo de instância. CREATE: criar uma instância. Valor padrão: CREATE.	CREATE
InstanceTypeFamily	array	Não	Configurações para a coleção de famílias de instâncias alternativas a partir das quais os tipos de instância alternativos são selecionados. Você pode especificar até 10 famílias de instâncias.	ecs.hfg6
	string	Não	A família de instâncias. Para valores válidos de tipos de instância, consulte Famílias de instâncias. Você também pode chamar DescribeInstanceTypeFamilys para consultar a lista de famílias de instâncias.	ecs.hfg6

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Data	object
RecommendInstanceType	array<object>	Os tipos de instância recomendados.
	array<object>
CommodityCode	string	O código da commodity do tipo de instância.	ecs
ZoneId	string	O ID da zona do tipo de instância.	cn-hangzhou-h
Priority	integer	A prioridade para classificação.	2
NetworkType	string	O tipo de rede da instância ECS.	vpc
Scene	string	O cenário no qual o tipo de instância é recomendado.	CREATE
SpotStrategy	string	A política de lance para a instância spot.	NoSpot
RegionId	string	O ID da região do tipo de instância.	cn-hangzhou
InstanceChargeType	string	O método de cobrança da instância.	PostPaid
Zones	object
zone	array<object>	As zonas do tipo de instância.
	array<object>
ZoneNo	string	O ID da zona do tipo de instância.	cn-hangzhou-h
NetworkTypes	object
NetworkType	array	Os tipos de rede do tipo de instância.
	string	O tipo de rede do tipo de instância.	vpc
InstanceType	object	O nome do tipo de instância.
SupportIoOptimized	string	Indica se o tipo de instância suporta otimização de E/S.	optimized
Cores	integer	O número de vCPUs do tipo de instância.	1
Memory	integer	O tamanho da memória do tipo de instância. Unidade: MB.	8192
InstanceType	string	O nome do tipo de instância.	ecs.hfg6.large
InstanceTypeFamily	string	A família de instâncias.	ecs.hfg6
Generation	string	A geração da família de instâncias.	ecs-4

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Data": {
    "RecommendInstanceType": [
      {
        "CommodityCode": "ecs",
        "ZoneId": "cn-hangzhou-h",
        "Priority": 2,
        "NetworkType": "vpc",
        "Scene": "CREATE",
        "SpotStrategy": "NoSpot",
        "RegionId": "cn-hangzhou",
        "InstanceChargeType": "PostPaid",
        "Zones": {
          "zone": [
            {
              "ZoneNo": "cn-hangzhou-h",
              "NetworkTypes": {
                "NetworkType": [
                  "vpc"
                ]
              }
            }
          ]
        },
        "InstanceType": {
          "SupportIoOptimized": "optimized",
          "Cores": 1,
          "Memory": 8192,
          "InstanceType": "ecs.hfg6.large",
          "InstanceTypeFamily": "ecs.hfg6",
          "Generation": "ecs-4"
        }
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	RecommendEmpty.InstanceTypeNotAuthorized	The recommend instanceTypes are not authorized.	O conjunto recomendado está vazio. Nenhum tipo de instância alternativo adequado está disponível na região ou zona especificada.
400	RecommendEmpty.InstanceTypeSoldOut	The recommend instanceTypes are out of usage.	O conjunto de tipos de instância recomendados está vazio. Os tipos de instância na zona ou região especificada estão esgotados e nenhuma alternativa adequada está disponível.
400	RecommendEmpty.DiskCategoryNotRecommended	The specified disk category is not available for recommended.	O tipo de disco especificado está esgotado.
400	InvalidNetworkType.ValueNotSupported	The specified parameter NetworkType is not valid.
400	InvalidSpotStrategy.ValueNotSupported	The specified parameter SpotStrategy is not valid.
400	InvalidInstanceChargeType.NotFound	The specified parameter InstanceChargeType is not valid.	O método de cobrança da instância não existe em nossos registros.
400	InvalidPriorityStrategy.ValueNotSupported	The specified parameter PriorityStrategy is not supported.
400	InvalidParam.TypeAndCpuMem.Conflict	The specified parameters InstanceType and Cores,Memory should not be blank at the same time.	Você não pode especificar o tipo de instância, o número de vCPUs e o tamanho da memória ao mesmo tempo.
400	InvalidIoOptimized.NotFound	The specified parameter IoOptimized is not valid.	O parâmetro IoOptimized especificado é inválido.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.
400	InvalidDiskCategory.NotFound	The specified parameter SystemDiskCategory is not supported.	A DiskCategory especificada não é suportada.
400	InvalidInstanceTypeFamily.NotFound	The specified InstanceTypeFamily is not valid.
400	InvalidMaxPrice.NotSupported	The specified MaxPrice is not valid.	O campo de preço máximo especificado é inválido. Este campo é válido apenas para instâncias spot e deve ser maior que 0.
400	InvalidZoneId.MalFormed	The specified ZoneId is not valid when Cores and Memory is not null.
400	InvalidInstanceType.NotSupported	The specified InstanceType is not valid.	A arquitetura de imagem especificada não é suportada por este tipo de instância.
400	InvalidZoneId.ValueNotSupported	The specified ZoneId is not valid.	O ZoneId especificado é inválido.
400	InvalidCoreAndMemory.ValueNotSupported	The specified Cores/Memory does not match instance type.	O número especificado de núcleos de CPU e o tamanho da memória não correspondem ao tipo de instância ou à família de instâncias especificada.
400	QuotaExceed.AfterpayInstance	Living afterpay instances quota exceeded.	O inventário de instâncias pay-as-you-go é insuficiente. Reduza o número de instâncias a serem criadas.
400	RecommendEmpty.PerformanceNotSatisfied	The performance of recommend instanceType is not satisfied.
400	RecommendEmpty.PriceNotSatisfied	The current price of recommend instanceTypes above user max price.	O conjunto recomendado está vazio. Nenhum tipo de instância que atenda aos requisitos de preço está disponível na região ou zona especificada.
400	RecommendEmpty.QuotaNotSatisfied	The quota of recommend instanceTypes are out of usage.	O conjunto recomendado está vazio. Nenhum tipo de instância está disponível na região ou zona especificada devido a restrições de cota.
400	RecommendEmpty.IzNotMatched	The iz of recommend instanceTypes are not match.
400	RecommendEmpty.InstanceTypeNotMatched	The recommend instanceTypes are not match.
400	InvalidScene.ValueNotSupported	The specified Scene is invalid.
400	RecommendEmpty.InstanceTypeFamilyNotMatched	The recommend instanceTypeFamily are not match.	O conjunto recomendado está vazio. Nenhum tipo de instância que atenda aos requisitos da família de instâncias está disponível na região ou zona especificada.
400	RecommendEmpty.GenerationNotMatch	The recommend instanceType generation are not match.
400	RecommendEmpty.NetworkTypeNotSupported	The recommend instanceType networkType are not match.
400	InvalidInstanceFamilyLevel.NotSupported	The specified InstanceFamilyLevel is not valid.	O parâmetro InstanceFamilyLevel especificado é inválido. Verifique se o valor do parâmetro está correto.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	As informações da região são inválidas.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.