Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Auto Scaling/ Referência de API/ APIs/ Grupos de AS/ Modificação de um grupo de AS

Atualizado em 2023-07-04 GMT+08:00

Ver PDF

Modificação de um grupo de AS

Função

Essa API é usada para modificar um grupo de AS especificado.

Quando a configuração de AS de um grupo de AS é alterada, as instâncias existentes criadas usando a configuração de AS original não são afetadas.
Se nenhuma ação de dimensionamento estiver sendo executada, você poderá modificar suas configurações de sub-rede, ELB e AZ.
Alterar o número de instâncias esperadas em um grupo de AS acionará uma ação de dimensionamento para adicionar ou remover instâncias de ou para o grupo de AS. O número de instâncias esperadas deve ser maior ou igual ao número mínimo de instâncias e menor ou igual ao número máximo de instâncias.

URI

PUT /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id}

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	Especifica o ID do projeto.
scaling_group_id	Sim	String	Especifica o ID do grupo de AS.

Mensagem de solicitação

Parâmetros de solicitação

**Tabela 2** Parâmetros de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
scaling_group_name	Não	String	Especifica o nome do grupo de AS. O nome contém apenas letras, dígitos, sublinhados (_) e hifens (-) e não pode exceder 64 caracteres.
desire_instance_number	Não	Integer	Especifica o número esperado de instâncias. O valor varia desde o número mínimo de instâncias até o número máximo de instâncias.
min_instance_number	Não	Integer	Especifica o número mínimo de instâncias.
max_instance_number	Não	Integer	Especifica o número máximo de instâncias, que é maior ou igual ao número mínimo de instâncias.
cool_down_time	Não	Integer	Especifica o período de resfriamento (em segundos). O valor varia de 0 a 86400 e é de 300 por padrão.
available_zones	Não	Array of strings	Especifica as informações de AZ. As instâncias adicionadas em uma ação de dimensionamento serão criadas em uma AZ especificada. Se você não especificar uma AZ, o sistema especificará uma automaticamente. Você pode alterar a AZ de um grupo de AS somente quando nenhuma ação de dimensionamento estiver sendo executada no grupo.
networks	Não	Array of networks objects	Especifica as informações da rede. Você pode selecionar até cinco sub-redes. A primeira sub-rede que você selecionar é usada pelas NICs primárias dos ECSs por padrão. Para obter informações sobre a estrutura de dados, consulte Tabela 4. O valor deste parâmetro só pode ser alterado quando todas as seguintes condições forem atendidas: Nenhuma ação de dimensionamento é acionada no grupo de AS. O número de instâncias no grupo de AS é 0. O grupo de AS não está em serviço.
security_groups	Não	Array of security_groups objects	Especifica o grupo de segurança. Um máximo de um grupo de segurança pode ser selecionado. Para obter informações sobre a estrutura de dados, consulte Tabela 7. Se o grupo de segurança for especificado tanto na configuração do AS como no grupo de AS, instâncias de ECS dimensionadas serão adicionadas ao grupo de segurança especificado na configuração do AS. Se o grupo de segurança não for especificado em nenhuma delas, instâncias de ECS dimensionadas serão adicionadas ao grupo de segurança padrão. Para sua conveniência, é aconselhável especificar o grupo de segurança na configuração do AS. O valor deste parâmetro só pode ser alterado quando todas as seguintes condições forem atendidas: Nenhuma ação de dimensionamento é acionada no grupo de AS. O número de instâncias no grupo de AS é 0. O grupo de AS não está em serviço.
lb_listener_id	Não	String	Especifica o ID de um ouvinte do balanceador de carga clássico. O sistema suporta a vinculação de até seis ouvintes do balanceador de carga, cujos IDs são separados usando uma vírgula (,). O valor deste parâmetro só pode ser alterado quando todas as seguintes condições forem atendidas: Nenhuma ação de dimensionamento é acionada no grupo de AS. O número de instâncias no grupo de AS é 0. O grupo de AS não está em serviço.
lbaas_listeners	Não	Array of lbaas_listeners objects	Especifica informações sobre um balanceador de carga avançado. O sistema suporta a vinculação de até seis balanceadores de carga. Este parâmetro está na estrutura de dados da lista. Para mais detalhes, consulte Tabela 3.
health_periodic_audit_method	Não	String	Especifica o método de verificação de integridade para instâncias no grupo de AS. Os métodos de verificação de integridade incluem ELB_AUDIT e NOVA_AUDIT. Quando o balanceamento de carga é configurado para um grupo de AS, o valor padrão é ELB_AUDIT. Caso contrário, o valor padrão é NOVA_AUDIT. ELB_AUDIT: indica a verificação de integridade do ELB, que entra em vigor em um grupo de AS com um ouvinte. NOVA_AUDIT: indica a verificação de integridade do ECS, que é o método de verificação de integridade fornecido com o AS.
health_periodic_audit_time	Não	Integer	Especifica o período de verificação de integridade para as instâncias no grupo de AS. O valor pode ser 1, 5, 15, 60 ou 180 na unidade de minutos. Se o valor for definido como 0, a verificação de integridade é executada a cada 10 segundos.
instance_terminate_policy	Não	String	Especifica a política de remoção de instância. OLD_CONFIG_OLD_INSTANCE (padrão): as instâncias criadas anteriormente com base nas configurações de AS criadas anteriormente são removidas primeiro. OLD_CONFIG_NEW_INSTANCE: as instâncias criadas posteriormente com base nas configurações de AS criadas anteriormente são removidas primeiro. OLD_INSTANCE: as instâncias criadas anteriormente são removidas primeiro. NEW_INSTANCE: as instâncias criadas posteriormente são removidas primeiro.
health_periodic_audit_grace_period	Não	Integer	Especifica o período de carência para a verificação de integridade da instância. A unidade é a segunda e o intervalo de valor é 0-86400. O valor padrão é 600. O período de carência da verificação de integridade começa depois que uma instância é adicionada a um grupo de AS e é habilitada. O grupo de AS começará a verificar o status da instância somente após o término do período de carência. Esse parâmetro é válido somente quando o método de verificação de integridade da instância do grupo de AS é ELB_AUDIT.
scaling_configuration_id	Não	String	Especifica o ID de configuração de AS, que pode ser obtido usando a API para consulta de configurações de AS. Para mais detalhes, consulte Consulta das configurações do AS.
notifications	Não	Array of strings	Especifica o modo de notificação. EMAIL refere-se a notificação por e-mail. Este modo de notificação foi cancelado. É aconselhável configurar a função de notificação para o grupo de AS. Para mais detalhes, consulte Notificações.
delete_publicip	Não	Boolean	Especifica se o EIP vinculado ao ECS deve ser excluído ao excluir o ECS. Se você não quiser excluir o EIP, defina esse parâmetro como false. Em seguida, o sistema apenas desvincula o EIP do ECS e reserva o EIP. true: exclui o EIP vinculado ao ECS ao excluir o ECS. Se o EIP for cobrado anualmente/mensalmente, ele não será excluído quando o ECS for excluído. false: apenas desvincula o EIP vinculado ao ECS ao excluir o ECS.
delete_volume	Não	Boolean	Especifica se devem ser excluídos os discos de dados anexados a um ECS ao excluir o ECS. O valor pode ser true ou false. O valor padrão é false. true: exclui os discos de dados anexados ao ECS ao excluir o ECS. Se os discos de dados forem cobrados anualmente/mensalmente, eles não serão excluídos quando o ECS for excluído. false: somente desanexa os discos de dados anexados ao ECS ao excluir o ECS.
enterprise_project_id	Não	String	Especifica o ID do projeto empresarial, que é usado para especificar o projeto empresarial ao qual o grupo de AS pertence. Se o valor for 0 ou deixado em branco, o grupo de AS pertence ao projeto empresarial padrão. Se o valor for um UUID, o grupo de AS pertence ao projeto empresarial correspondente ao UUID.. Se um projeto empresarial é configurado para um grupo de AS, os ECSs criados neste grupo de AS também pertencem a este projeto empresarial. Caso contrário, será utilizado o projeto empresarial padrão.
multi_az_priority_policy	Não	String	Especifica a política de prioridade usada para selecionar AZs de destino ao ajustar o número de instâncias em um grupo de AS. EQUILIBRIUM_DISTRIBUTE (padrão): ao ajustar o número de instâncias, certifique-se de que as instâncias em cada AZ na lista available_zones sejam distribuídas uniformemente. Se as instâncias não puderem ser adicionadas à AZ de destino, selecione outra AZ com base na política PICK_FIRST. PICK_FIRST: ao ajustar o número de instâncias, as AZs de destino são determinadas na ordem na lista available_zones.
description	Não	String	Especifica a descrição do grupo de AS. O valor pode conter de 1 a 256 caracteres.
iam_agency_name	Não	String	Especifica o nome da agência, em 1 a 64 caracteres. Se iam_agency_name for definido como nulo, você não precisa modificá-lo. Se iam_agency_name for deixado em branco ou tiver um valor, você precisará modificá-lo.

**Tabela 3** Descrição do campo **lbaas_listeners**
Parâmetro	Obrigatório	Tipo	Descrição
pool_id	Sim	String	Especifica o ID do grupo de ECS de back-end. O valor deste parâmetro só pode ser alterado quando todas as seguintes condições forem atendidas: Nenhuma ação de dimensionamento é acionada no grupo de AS. O número de instâncias no grupo de AS é 0. O grupo de AS não está em serviço.
protocol_port	Sim	Integer	Especifica o ID do protocolo de back-end, que é a porta na qual um ECS de back-end escuta o tráfego. O ID da porta varia de 1 a 65535.
weight	Sim	Integer	Especifica o peso, que determina a parte das solicitações que um ECS de back-end processa ao ser comparado a outros ECSs de back-end adicionados ao mesmo ouvinte. O valor deste parâmetro varia de 0 a 100.

**Tabela 4** Descrição do campo **networks**
Parâmetro	Obrigatório	Tipo	Descrição
id	Sim	String	Especifica o ID da sub-rede.
ipv6_enable	Não	Boolean	Especifica se deve ser compatível com endereços IPv6. true: indica que a NIC suporta endereços IPv6. false: indica que a NIC não suporta endereços IPv6. O valor padrão é false.
ipv6_bandwidth	Não	ipv6_bandwidth object	Especifica a largura de banda compartilhada de um endereço IPv6. Esse parâmetro é deixado em branco por padrão, indicando que nenhuma largura de banda IPv6 compartilhada está vinculada.
allowed_address_pairs	Não	Array of allowed_address_pairs objects	Especifica se deve permitir que o sistema verifique os endereços de origem e de destino.

**Tabela 5** Descrição do campo **ipv6_bandwidth**
Parâmetro	Obrigatório	Tipo	Descrição
id	Sim	String	Especifica o ID da largura de banda compartilhada de um endereço IPv6.

**Tabela 6** Descrição do campo **allowed_address_pairs**
Parâmetro	Tipo	Descrição
ip_address	String	Especifica se deve permitir que o sistema verifique os endereços de origem e de destino. Essa função está ativada por padrão. Este parâmetro não pode ser deixado vazio. Para desativar esta função, defina o valor para 1.1.1.1/0. Para ativar esta função, defina um valor diferente de 1.1.1.1/0.

**Tabela 7** Descrição do campo **security_groups**
Parâmetro	Obrigatório	Tipo	Descrição
id	Sim	String	Especifica o ID do grupo de segurança.

Exemplo de solicitação

Este exemplo mostra como alterar o nome, a configuração de AS, projeto corporativo, o número esperado de instâncias, o número mínimo de instâncias, o número máximo de instâncias e período de resfriamento do grupo de AS com ID a8327883-6b07-4497-9c61-68d03ee193a1.

PUT https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group/a8327883-6b07-4497-9c61-68d03ee193a1

{
    "scaling_group_name": "group_1",
    "scaling_configuration_id": "f8327883-6a07-4497-9a61-68c03e8e72a2",
    "enterprise_project_id": "c92b1a5d-6f20-43f2-b1b7-7ce35e58e413",
    "desire_instance_number": 1,
    "min_instance_number": 1,
    "max_instance_number": 3,
    "cool_down_time": 200,
    "multi_az_priority_policy": "PICK_FIRST"
 ":"test"
}

Mensagem de resposta

Parâmetros de resposta

**Tabela 8** Parâmetros de resposta
Parâmetro	Type	Descrição
scaling_group_id	String	Especifica o ID do grupo de AS.

Exemplo de resposta

{
    "scaling_group_id": "a8327883-6b07-4497-9c61-68d03ee193a1"
}

Valores retornados

Normal
200

Anormal

Valores retornados	Descrição
400 Bad Request	O servidor falhou ao processar a solicitação.
401 Unauthorized	Você deve digitar o nome de usuário e a senha para acessar a página solicitada.
403 Forbidden	Você está proibido de acessar a página solicitada.
404 Not Found	O servidor não conseguiu encontrar a página solicitada.
405 Method Not Allowed	Você não tem permissão para usar o método especificado na solicitação.
406 Not Acceptable	A resposta gerada pelo servidor não poderia ser aceita pelo cliente.
407 Proxy Authentication Required	Você deve usar o servidor proxy para autenticação para que a solicitação possa ser processada.
408 Request Timeout	A solicitação expirou o tempo limite.
409 Conflict	A solicitação não pôde ser processada devido a um conflito.
500 Internal Server Error	Falhou ao concluir a solicitação porque ocorre um erro de serviço interno.
501 Not Implemented	Falhou ao concluir a solicitação porque o servidor não suporta a função solicitada.
502 Bad Gateway	Falhou ao concluir a solicitação porque a solicitação é inválida.
503 Service Unavailable	Falhou ao concluir a solicitação porque o sistema não está disponível.
504 Gateway Timeout	Ocorreu um erro de tempo limite de gateway.