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

Descrição da operação

Certifique-se de compreender totalmente os métodos de cobrança e a precificação da reserva de capacidade elástica antes de usar esta operação.

Antes de adquirir um serviço de reserva de capacidade elástica, você pode chamar DescribeElasticityAssurances para consultar os serviços de reserva de capacidade elástica disponíveis.

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

ecs:PurchaseElasticityAssurance

update

*ElasticityAssurance.

acs:ecs:{#regionId}:{#accountId}:elasticityassurance/{#ElasticityAssuranceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do serviço de reserva de capacidade elástica. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
Period	integer	Não	A duração da aquisição. A unidade da duração é determinada pelo parâmetro PeriodUnit. Valores válidos: Se PeriodUnit estiver definido como Month: 1, 2, 3, 4, 5, 6, 7, 8 e 9. Se PeriodUnit estiver definido como Year: 1, 2, 3, 4 e 5. Valor padrão: 1.	1
PeriodUnit	string	Não	A unidade da duração da aquisição. Valores válidos: Month: mês. Year: ano. Valor padrão: Year.	Month
PrivatePoolOptions.Id	string	Sim	O ID do serviço de reserva de capacidade elástica.	eap-bp67acfmxazb4****
ClientToken	string	Não	Garante a idempotência da solicitação. O valor é gerado pelo seu cliente e deve ser único entre diferentes solicitações. O valor de `ClientToken` pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
PrivatePoolOptions.MatchCriteria	string	Não	O modo de correspondência do serviço de reserva de capacidade elástica. Valores válidos: Open: modo aberto. O sistema corresponde automaticamente à capacidade disponível do pool privado aberto quando as instâncias são iniciadas. Se nenhuma capacidade de pool privado correspondente estiver disponível, os recursos do pool público serão utilizados. Target: modo direcionado. As instâncias são iniciadas utilizando a capacidade especificada do pool privado. Se a capacidade especificada do pool privado não estiver disponível, a inicialização das instâncias falhará. Valor padrão: Open.	Open
StartTime	string	Não	O período de vigência do serviço de reserva de capacidade elástica. Por padrão, o serviço entra em vigor quando a operação é invocada. Especifique a hora no padrão ISO 8601 no formato `yyyy-MM-ddTHH:mm:ssZ`. A hora deve estar em UTC. Para mais informações, consulte ISO 8601.	2024-06-18T00:00:00Z

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidStartTime.MalFormed	The specified StartTime is out of the permitted range.
400	Invalid.PrivatePoolOptions.Id	The PrivatePool does not exist.	O parâmetro especificado PrivatePoolOptions.Id deve estar vazio.
400	InvalidParameter.PeriodUnit	The specified PeriodUnit is not supported.	O PeriodUnit especificado é inválido.
401	InvalidUser.Unauthorized	The user is not authorized.	A conta que você está usando não tem as permissões necessárias.
500	InternalError	Internal error.	Ocorreu um erro ao enviar a solicitação. Tente novamente mais tarde.
403	IncorrectPrivatePoolStatus	The current status of the private pool does not support this operation.	O status atual do pool privado especificado no parâmetro não suporta esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.