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

Observações de uso

Observe os seguintes pontos:

Para obter informações sobre os limites das instâncias reservadas, consulte a seção "Limites" em Visão geral.
Antes de chamar esta operação para dividir uma instância reservada, verifique os limites aplicáveis à divisão. Para mais informações, consulte Dividir uma instância reservada.
Antes de mesclar instâncias reservadas com esta operação, familiarize-se com as restrições de mesclagem. Consulte Mesclar instâncias reservadas para obter detalhes.
Ao modificar uma instância reservada, conheça previamente os métodos e limites permitidos. Mais informações estão disponíveis em Modificar uma instância reservada.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar o OpenAPI Explorer para chamar esta operação. A ferramenta gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyReservedInstances	A operação a ser executada. Defina o valor como ModifyReservedInstances.
RegionId	String	Sim	cn-hangzhou	O ID da região da instância reservada. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
ReservedInstanceId.N	String	Não	ecsri-bp15xx2****	O ID da instância reservada N. Valores válidos de N: 1 a 20.
Configuration.N.ReservedInstanceName	String	Não	testReservedInstanceName	O nome da instância reservada N. Valores válidos de N: 1 a 100. O nome deve ter entre 2 e 128 caracteres. Deve começar com uma letra, mas não pode iniciar com http:// ou https://. São aceitos dígitos, letras, dois pontos (:), sublinhados (_) e hifens (-).
Configuration.N.ZoneId	String	Não	cn-hangzhou-i	O ID da zona da instância reservada N. Valores válidos de N: 1 a 100. Este parâmetro é obrigatório quando `Scope` está definido como `Zone`. Chame a operação DescribeZones para obter a lista atualizada de zonas.
Configuration.N.Scope	String	Sim	Zone	O escopo da instância reservada N. Valores válidos: Region Zone Valores válidos de N: 1 a 100. Valor padrão: Region.
Configuration.N.InstanceType	String	Sim	ecs.c5.4xlarge	O tipo de instância compatível com a instância reservada N. Valores válidos de N: 1 a 100. Nota Os tipos de instância aplicáveis são atualizados continuamente. Para mais informações, consulte a seção "Atributos" em Visão geral de instâncias reservadas.
Configuration.N.InstanceAmount	Integer	Sim	1	A quantidade de instâncias de pagamento conforme o uso do mesmo tipo que a instância reservada N pode corresponder. O valor deste parâmetro deve ser maior ou igual a 1. Valores válidos de N: 1 a 100.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7	O ID da solicitação.
ReservedInstanceIdSets	Array of String	{"ReservedInstanceId":"ecsri-bp1cx3","ecsri-bp15xx2"]}	Os IDs das instâncias reservadas.

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=ModifyReservedInstances
&RegionId=cn-hangzhou
&ReservedInstanceId.1=ecsri-bp1cx3****
&ReservedInstanceId.2=ecsri-bp15xx2****
&Configuration.1.InstanceType=ecs.c5.4xlarge
&Configuration.1.Scope=Zone
&Configuration.2.InstanceType=ecs.g5.4xlarge
&Configuration.2.Scope=Region
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyReservedInstancesResponse>
    <ReservedInstanceIdSets>
        <ReservedInstanceId>ecsri-bp1cx3****</ReservedInstanceId>
        <ReservedInstanceId>ecsri-bp15xx2****</ReservedInstanceId>
    </ReservedInstanceIdSets>
    <RequestId>ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7</RequestId>
</ModifyReservedInstancesResponse>

Formato JSON

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

{
  "ReservedInstanceIdSets" : {
    "ReservedInstanceId" : [ "ecsri-bp1cx3****", "ecsri-bp15xx2****" ]
  },
  "RequestId" : "ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7"
}

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 este tipo de instância.
400	InvalidParameter.Conflict	The specified region and cluster do not match.	A região e o cluster especificados não correspondem entre si.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor inválido para Tag.N.Key.
400	RegionUnauthorized	%s	Você não tem permissão para executar a operação nesta região. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
400	Zone.NotOnSale	%s	Os recursos solicitados não estão disponí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.	Valor inválido para PeriodUnit.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor inválido para Tag.N.Value.
400	InvalidChargeType.ValueNotSupported	ChargeType is not valid.	Este método de faturamento não é suportado. Selecione outro método.
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 não estão disponíveis na zona especificada. Tente outro tipo de instância ou zona. 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.	O recurso solicitado está indisponível temporariamente 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 é inválida.
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.	Valor inválido para ResourceOwnerAccount.
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 não estão disponíveis na zona especificada. Tente outros tipos de instância ou selecione outras regiões ou zonas.
403	InvalidParameter.NotMatch	%s	Valor de parâmetro inválido. Verifique se existem conflitos de parâmetros.
403	Account.Arrearage	Your account has been in arrears.	O saldo da conta é insuficiente. Adicione fundos à conta e tente novamente.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Não é possível executar esta operação no recurso no estado atual.
403	OperationDenied.OnlyModifyName	It is not allowed to modify the ReservedInstanceName only.	O nome da instância reservada não pode ser modificado isoladamente.
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.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.