Cria ou modifica uma reserva de capacidade.
Descrição da operação
ModifyCapacityReservation é uma operação assíncrona. O sistema retorna um ID de solicitação, mas a reserva de capacidade ainda não foi concluída e a tarefa de reserva continua em execução em segundo plano. Você pode chamar DescribeCapacityReservation para consultar o status da reserva de capacidade:\n - Pending: A reserva de capacidade está em andamento.\n - Provisioned: A reserva de capacidade foi concluída.\n - Rebalancing: A reserva de capacidade está sendo redistribuída entre as zonas.
Experimente agora
Testar
Autorização RAM
Sintaxe da solicitação
POST HTTP/1.1Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| LoadBalancerId |
string |
Sim |
O ID da instância do Application Load Balancing. Antes de configurar uma reserva de capacidade, a instância deve ter pelo menos um listener no estado Running. |
alb-iv9gj3spak6fbj**** |
| ResetCapacityReservation |
boolean |
Não |
Especifica se a reserva de capacidade deve ser cancelada. Valores válidos:\n* true: Cancela a reserva de capacidade.\n* false (padrão): Não cancela a reserva de capacidade. Você não precisa especificar este parâmetro ao criar ou modificar uma reserva de capacidade. |
false |
| MinimumLoadBalancerCapacity |
object |
Não |
A capacidade mínima reservada de balanceamento de carga. |
|
| CapacityUnits |
integer |
Não |
O número de LCUs reservadas por hora. |
100 |
| DryRun |
boolean |
Não |
Especifica se deve ser realizado um dry run. Valores válidos:\n- true: Envia uma solicitação de dry run sem reservar recursos. O sistema verifica os parâmetros obrigatórios, o formato da solicitação e os limites do serviço. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de erro DryRunOperation será retornado.\n- false (padrão): Envia uma solicitação normal. Após a verificação ser bem-sucedida, um código de status HTTP 2xx é retornado e a operação é executada. Valores válidos:
|
false |
| ClientToken |
string |
Não |
O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento.\n\n> Se você não especificar este parâmetro, o sistema usará o RequestId da solicitação de API como ClientToken. O RequestId pode ser diferente para cada solicitação de API. |
5A2CFF0E-5718-45B5-9D4D-70B3FF3898 |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
Esquema da resposta. |
||
| RequestId |
string |
O ID da solicitação. |
593B0448-D13E-4C56-AC0D-FDF0F****** |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "593B0448-D13E-4C56-AC0D-FDF0F******"
}Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | OperationDenied.ListenerNotFound | The operation is not allowed because of ListenerNotFound. | A instância não possui nenhum listener no estado de execução. |
| 400 | OperationDenied.CapacityReservationNotSupport | Resource reservation is not supported. | O recurso de reserva de recursos não é suportado. |
| 400 | OperationDenied.CapacityUnitsBelowMinimum | The operation is not allowed because of CapacityUnitsBelowMinimum. | A LCU reservada não atende ao requisito mínimo. |
| 400 | OperationDenied.CapacityDecreaseRequestLimitExceeded | The operation is not allowed because of CapacityDecreaseRequestLimitExceeded. | O número de downgrades ou cancelamentos para recursos de instância reservada excedeu o limite. |
| 400 | OperationDenied.PriorRequestNotComplete | The operation is not allowed because of PriorRequestNotComplete. | A solicitação anterior de reserva de recursos não foi concluída. |
| 400 | OperationDenied.DeploymentSetExists | The operation is not allowed because of OperationDenied.DeploymentSetExists. | A reserva de recursos associada a um conjunto de implantação não pode ser modificada. |
| 400 | OperationDenied.DeploymentSetIsEmpty | The operation is not allowed because of OperationDenied.DeploymentSetIsEmpty. | O conjunto de implantação não contém nenhuma instância ECS. |
| 400 | OperationDenied.DeploymentSetsConflicts | The operation is not allowed because of OperationDenied.DeploymentSetsConflicts. | As zonas das instâncias ECS no conjunto de implantação entram em conflito com a zona da instância ALB. |
| 400 | OperationDenied.DeploymentSetsNotSupport | The operation is not allowed because of OperationDenied.DeploymentSetsNotSupport. | O recurso de conjunto de implantação não é suportado. |
| 400 | OperationDenied.DeploymentSetsStrategyNotMatch | The operation is not allowed because of DeploymentSetsStrategyNotMatch. | A política do conjunto de implantação não corresponde. Apenas conjuntos de implantação com a política de baixa latência de rede são suportados. |
| 400 | QuotaExceeded.ReservationMaxLcuPerLb | The quota of %s is exceeded, usage %s/%s. | A cota %s foi excedida. O valor atual é %s e o valor da cota é %s. |
| 400 | QuotaExceeded.ReservationMaxLcuPerRegion | The quota of %s is exceeded, usage %s/%s. | A cota %s foi excedida. O valor atual é %s e o valor da cota é %s. |
| 400 | QuotaExceeded.DeploymentSetsNum | The quota of %s is exceeded, usage %s/%s. | A cota %s foi excedida. O valor atual é %s e o valor da cota é %s. |
| 400 | OperationDenied.DeploymentSetsNotSharedToAlb | DeploymentSets are not shared to alb. | O conjunto de implantação não é compartilhado com o ALB. |
| 404 | ResourceNotFound.LoadBalancer | The specified resource of %s is not found. | O recurso %s não existe. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.