Todos os produtos
Search
Central de documentação

Virtual Private Cloud:UpdateDhcpOptionsSetAttribute

Última atualização: Jul 07, 2026

Modifica a configuração de um conjunto de opções DHCP.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

A região onde o conjunto de opções DHCP está implantado. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

DhcpOptionsSetId

string

Sim

O ID do conjunto de opções DHCP.

dopt-o6w0df4epg9zo8isy****

DomainNameServers

string

Não

O endereço IP do servidor DNS. Você pode inserir no máximo quatro endereços IP de servidores DNS. Separe os endereços IP com vírgulas (,).

Nota

Se você não especificar um endereço IP de servidor DNS, as instâncias do Elastic Compute Service (ECS) usarão os endereços IP dos servidores DNS do Alibaba Cloud, que são 100.100.2.136 e 100.100.2.138.

192.XX.XX.123

DomainName

string

Não

O domínio raiz. Por exemplo, você pode definir o valor como example.com.

Depois que um conjunto de opções DHCP é associado a uma virtual private cloud (VPC), o domínio raiz no conjunto de opções DHCP é sincronizado automaticamente com as instâncias ECS na VPC.

example.com

DhcpOptionsSetName

string

Não

O nome do conjunto de opções DHCP.

O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). O nome deve começar com uma letra.

name

DhcpOptionsSetDescription

string

Não

Insira uma descrição para o conjunto de opções DHCP.

A descrição deve ter de 2 a 256 caracteres. Deve começar com uma letra e não pode começar com http:// ou https://. Você também pode deixar a descrição vazia.

description

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.

Nota

Se você não definir este parâmetro, ClientToken será definido com o valor de RequestId. O valor de RequestId para cada solicitação de API pode ser diferente.

0c593ea1-3bea-11e9-b96b-88e9fe637760

DryRun

boolean

Não

Especifica se deve ser realizado um dry run. Valores válidos:

true: realiza um dry run. O sistema verifica os parâmetros obrigatórios, o formato da solicitação e os limites. Se a solicitação falhar no dry run, uma mensagem de erro será retornada. Se a solicitação passar no dry run, o código de erro DryRunOperation será retornado.

false (padrão): realiza um dry run e envia a solicitação. Se a solicitação passar no dry run, um código de status HTTP 2xx será retornado e a operação será executada.

false

LeaseTime

string

Não

O tempo de concessão dos endereços IPv4 para o conjunto de opções DHCP.

  • Se você usar horas como unidade, os valores válidos são 24h a 1176h e 87600h a 175200h. Valor padrão: 87600h.

  • Se você usar dias como unidade, os valores válidos são 1d a 49d e 3650d a 7300d. Valor padrão: 3650d.

Nota

Se você especificar um valor, também deverá especificar a unidade.

3650d

Ipv6LeaseTime

string

Não

O tempo de concessão dos endereços IPv6 para o conjunto de opções DHCP.

  • Se você usar horas como unidade, os valores válidos são 24h a 1176h e 87600h a 175200h. Valor padrão: 87600h.

  • Se você usar dias como unidade, os valores válidos são 1d a 49d e 3650d a 7300d. Valor padrão: 3650d.

Nota

Se você especificar um valor, também deverá especificar a unidade.

3650d

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidDhcpOptionsSetId.NotFound The specified dhcpOptionsSetId does not exist. The DHCP options set does not exist. Check whether the parameter is set to a valid value.
400 IncorrectStatus.DhcpOptionsSet The DhcpOptionsSet status does not support this operation. The DHCP options set that is associated with the VPC is being configured. As a result, the DHCP options set does not support this operation. You can perform the operation after the status of the DHCP options set is stable.
400 IllegalParam.DomainNameServers The specified DomainNameServers is invalid. DomainNameServers is set to an invalid value.
400 IllegalParam.DomainName The specified DomainName is invalid. The error message returned because DomainName is set to an invalid value.
400 IllegalParam.DhcpOptionsSetName The specified DhcpOptionsSetName is invalid. DhcpOptionsSetName is set to an invalid value.
400 IllegalParam.DhcpOptionsSetDescription The specified DhcpOptionsSetDescription is invalid. DhcpOptionsSetDescription is set to an invalid value.
400 OperationUnsupported.DhcpLeaseTime The DhcpOptionsSet of this region does not support custom LeaseTime. DHCP options sets in the region do not support a custom lease time.
400 OperationUnsupported.DhcpOptionsSet The DHCP options set feature in this region is not supported. The current region does not support the DHCP options sets feature.
400 OperationDenied.ModifyDefaultDhcpOptionsSet The default DHCP options set is not allowed to be modified. The default DHCP options set is not allowed to be modified.
400 InvalidRegionId.NotFound The specified RegionId does not exist. The specified region does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.