PurchaseReservedInstancesOffering - : Central de Documentação do Alibaba Cloud

Descrição

Antes de chamar esta operação, certifique-se de compreender totalmente o método de faturamento das instâncias reservadas. Para mais informações, consulte Instâncias reservadas.
Antes de adquirir uma instância reservada, chame a operação DescribeAvailableResource para consultar os recursos de instância disponíveis.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	PurchaseReservedInstancesOffering	A operação a ser executada. Defina o valor como PurchaseReservedInstancesOffering.
RegionId	String	Sim	cn-hangzhou	ID da região onde você adquirirá a instância reservada. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
Tag.N.Key	String	Não	TestKey	Chave da tag N a ser adicionada à instância reservada. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Pode ter até 128 caracteres e não pode conter `http://` ou `https://`. Não pode começar com `acs:` ou `aliyun`.
Tag.N.Value	String	Não	TestValue	Valor da tag N a ser adicionado à instância reservada. Valores válidos de N: 1 a 20. O valor da tag não pode ser uma string vazia. Pode ter até 128 caracteres e não pode conter `http://` ou `https://`. Não pode começar com `acs:` ou `aliyun`.
ResourceGroupId	String	Não	rg-bp199lyny9b3****	ID do grupo de recursos.
ZoneId	String	Não	cn-hangzhou-g	ID da zona onde você adquirirá a instância reservada. Este parâmetro é obrigatório quando `Scope` está definido como `Zone`. Chame a operação DescribeZones para consultar a lista de zonas mais recente.
ReservedInstanceName	String	Não	testReservedInstanceName	Nome da instância reservada. Deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com http:// ou https://. Pode conter dígitos, letras, dois pontos (:), sublinhados (_) e hifens (-).
InstanceType	String	Sim	ecs.g5.large	Tipo da instância. Para mais informações, consulte Famílias de instâncias.
Scope	String	Não	Zone	Escopo da instância reservada. Valores válidos: Region: regional Zone: zonal Valor padrão: Region.
InstanceAmount	Integer	Não	3	Quantidade de instâncias de pagamento conforme o uso do mesmo tipo que a instância reservada pode corresponder simultaneamente. Valores válidos: 1 a 50. Por exemplo, se InstanceAmount for 3 e InstanceType for ecs.g5.large, a instância reservada poderá corresponder a três instâncias de pagamento conforme o uso ecs.g5.large ao mesmo tempo.
OfferingType	String	Não	All Upfront	Opção de pagamento da instância reservada. Valores válidos: No Upfront Partial Upfront All Upfront Valor padrão: All Upfront.
Description	String	Não	testDescription	Descrição da instância reservada. Deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://. Este parâmetro está vazio por padrão.
Platform	String	Não	Linux	Sistema operacional da imagem usada pela instância. Valores válidos: Windows: sistema operacional Windows Server Linux: sistema operacional Linux e do tipo UNIX Valor padrão: Linux.
Period	Integer	Não	1	Prazo da instância reservada. Valores válidos: 1 e 3. Valor padrão: 1.
PeriodUnit	String	Não	Year	Unidade do prazo da instância reservada. Valor válido: Year. Valor padrão: Year.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	Token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor, mas certifique-se de que ele seja único entre diferentes solicitações. O valor de ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.
AutoRenew	Boolean	Não	true	Especifica se a renovação automática deve ser ativada para a instância reservada. true: ativa a renovação automática para a instância reservada. false: não ativa a renovação automática para a instância reservada.
AutoRenewPeriod	Integer	Não	1	Prazo de renovação automática da instância reservada. Este parâmetro entra em vigor apenas quando AutoRenew está definido como true. Valores válidos: 12, 36. Valor padrão quando PeriodUnit está definido como Year: 12

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	8C314443-AF0D-4766-9562-C83B7F1A3C8B	ID da solicitação.
ReservedInstanceIdSets	Array of String	ecsri-2ze53qonjqxg7r****	IDs das instâncias reservadas.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=PurchaseReservedInstancesOffering
&RegionId=cn-hangzhou
&Scope=Zone
&ZoneId=cn-hangzhou-a
&ReservedInstanceName=test
&InstanceType=ecs.g5.2xlarge
&InstanceAmount=1
&OfferingType=AllUpfront
&Period=1
&PeriodUnit=Year
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<PurchaseReservedInstancesOfferingResponse>
    <RequestId>8C314443-AF0D-4766-9562-C83B7F1A3C8B</RequestId>
    <ReservedInstanceIdSets>
        <ReservedInstanceId>ecsri-2ze53qonjqxg7r****</ReservedInstanceId>
    </ReservedInstanceIdSets>
</PurchaseReservedInstancesOfferingResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ReservedInstanceIdSets" : {
    "ReservedInstanceId" : [ "ecsri-2ze53qonjqxg7r****" ]
  },
  "RequestId" : "8C314443-AF0D-4766-9562-C83B7F1A3C8B"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Você não tem autorização para usar o tipo de instância especificado.
400	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	O parâmetro Description especificado é inválido. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.
400	InvalidParameter.Conflict	The specified region and cluster do not match.	A região e o cluster especificados não correspondem um ao outro.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	O parâmetro Tag.N.Key especificado é inválido.
400	RegionUnauthorized	%s	Você não tem autorização para executar a operação na região especificada. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
400	Zone.NotOnSale	%s	Os recursos solicitados estão indisponíveis na zona especificada. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	O parâmetro PeriodUnit especificado é inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	O parâmetro Tag.N.Value especificado é inválido.
400	InvalidChargeType.ValueNotSupported	ChargeType is not valid.	O método de faturamento especificado não é suportado. Defina um método de faturamento suportado.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType beyond the permitted range.	O parâmetro InstanceType especificado é inválido.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	O parâmetro InstanceType especificado não existe ou você não tem autorização para gerenciar instâncias desse tipo.
403	OperationDenied	The creation of Host to the specified Zone is not allowed.	Você não tem autorização para criar hosts dedicados na zona especificada.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	Os recursos solicitados estão indisponíveis na zona especificada. Tente um tipo de instância ou zona diferente. Chame a operação DescribeZones para consultar os recursos disponíveis.
403	OperationDenied	Sales of this resource are temporarily suspended in the specified region; please try again later.	Os recursos solicitados estão indisponíveis na região especificada. Tente novamente mais tarde.
403	NodeControllerUnavailable	The Node Controller is temporarily unavailable.	O controlador de nó está indisponível.
403	OperationDenied	The resource is out of usage.	A instância não está no estado Running. Inicie a instância ou verifique se a operação especificada é válida.
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.	O parâmetro ResourceOwnerAccount especificado é inválido.
403	Zone.NotOpen	The specified zone is not granted to you to buy resources yet.	Você não tem autorização para comprar recursos na zona especificada.
403	Zone.NotOnSale	The specified zone is not available for purchase.	Os recursos solicitados estão indisponíveis na zona especificada. Tente outros tipos de instância ou selecione outras regiões ou zonas.
403	InvalidParameter.NotMatch	%s	Um parâmetro especificado é inválido. Verifique se existem conflitos de parâmetros.
403	Account.Arrearage	Your account has been in arrears.	O saldo da sua conta é insuficiente. Adicione fundos à sua conta Alibaba Cloud e tente novamente.
404	PaymentMethodNotFound	No payment method has been registered on the account.	Você não configurou um método de pagamento para sua conta.
500	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente mais tarde.
500	InternalError	%s	Ocorreu um erro interno.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, visite o API Error Center.