ListDhcpOptionsSets - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Consulta conjuntos de opções do Dynamic Host Configuration Protocol (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	O ID da região dos conjuntos de opções de DHCP que você deseja consultar. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
NextToken	string	Não	O token de paginação usado na próxima solicitação para recuperar uma nova página de resultados. Valores válidos: Você não precisa especificar este parâmetro na primeira solicitação. Você deve especificar o token obtido na consulta anterior como o valor do parâmetro NextToken.	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	Não	O número de entradas por página. Valores válidos: 1 a 100. Valor padrão: 10.	10
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 de DHCP é associado a uma virtual private cloud (VPC), o domínio raiz no conjunto de opções de DHCP é sincronizado automaticamente com as instâncias ECS na VPC. Valores válidos: example.com : example.com.	example.com
DhcpOptionsSetName	string	Não	O nome do conjunto de opções de DHCP. O nome deve ter de 1 a 128 caracteres e pode conter dígitos, sublinhados (_) e hifens (-). Deve começar com uma letra. Valores válidos: tf-testAccVpcDhcpOptionsSets-1585169790614573448 Valores válidos: tf-testAccVpcDhcpOptionsSets-1585169790614573448 : tf-testAccVpcDhcpOptionsSets-1585169790614573448	test
DhcpOptionsSetId	array	Não	O ID do conjunto de opções de DHCP. Você pode especificar no máximo 20 IDs.	dopt-o6w0df4epg9zo8isy****
	string	Não	O ID do conjunto de opções de DHCP. Você pode especificar no máximo 20 IDs.	dopt-o6w0df4epg9zo8isy****
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o conjunto de opções de DHCP pertence.	rg-acfmxazb4ph****
Tags	array<object>	Não	A lista de tags.
	object	Não	A lista de tags.
Key	string	Não	A chave da tag. Você pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 64 caracteres e pode conter dígitos, pontos (.), sublinhados (_) e hifens (-). A chave da tag deve começar com uma letra, mas não pode começar com aliyun ou acs:. A chave da tag não pode conter http:// ou https://.	FinanceDept
Value	string	Não	O valor da tag. Você pode especificar no máximo 20 valores de tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e pode conter dígitos, pontos (.), sublinhados (_) e hifens (-). O valor da tag deve começar com uma letra, mas não pode começar com aliyun ou acs:. O valor da tag não pode conter http:// ou https://.	FinanceJoshua

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O token de paginação usado na próxima solicitação para recuperar uma nova página de resultados. Valores válidos: Se NextToken estiver vazio, não há próxima página. Se um valor de NextToken for retornado, ele indica o token usado para a próxima consulta.
NextToken	string	Um token de paginação. Pode ser usado na próxima solicitação para recuperar uma nova página de resultados. Valores válidos: Se NextToken estiver vazio, não existe próxima página. Se um valor for retornado para NextToken, o valor é usado para recuperar uma nova página de resultados.	FFmyTO70tTpLG6I3FmYAXGKPd********
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
DhcpOptionsSets	array<object>	A lista dos conjuntos de opções de DHCP.
	array<object>	A lista dos conjuntos de opções de DHCP.
DhcpOptionsSetDescription	string	A descrição do conjunto de opções de DHCP.	test
Status	string	O status do conjunto de opções de DHCP. Valores válidos: Available InUse Pending Deleted	Available
DhcpOptionsSetId	string	O ID do conjunto de opções de DHCP.	dopt-o6w0df4epg9zo8isy****
DhcpOptionsSetName	string	O nome do conjunto de opções de DHCP.	test
AssociateVpcCount	integer	O número de VPCs às quais o conjunto de opções de DHCP está associado.	2
OwnerId	integer	O ID da conta Alibaba Cloud à qual o conjunto de opções de DHCP pertence.	253460731706911258
DhcpOptions	object	Os detalhes das opções de DHCP.
DomainNameServers	string	The IP address of the DNS server.	192.168.XX.XX
DomainName	string	The suffix of the hostname.	example.com
LeaseTime	string	The lease time of the IPv4 addresses for the DHCP options set. If you use hours as the unit, valid values are 24h to 1176h and 87600h to 175200h. Default value: 87600h. If you use days as the unit, valid values are 1d to 49d and 3650d to 7300d. Default value: 3650d.	3650d
Ipv6LeaseTime	string	The lease time of the IPv6 DHCP options set. If you use hours as the unit, Unit: h. Valid values are 24h to 1176h and 87600h to 175200h. Default value: 24h. If you use days as the unit, Unit: d. Valid values are 1d to 49d and 3650d to 7300d. Default value: 1d.	3650d
ResourceGroupId	string	O ID do grupo de recursos ao qual o conjunto de opções de DHCP pertence.	rg-acfmxazb4ph****
Tags	array<object>	A lista de tags.
	object	A lista de tags.
Key	string	The key of tag N added to the resource.	FinanceDept
Value	string	The value of tag N added to the resource.	FinanceJoshua
CreationTime	string	A hora de criação dos conjuntos de opções de DHCP.	2025-08-21 ***
TotalCount	string	O número de entradas.	10

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd********",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "DhcpOptionsSets": [
    {
      "DhcpOptionsSetDescription": "test",
      "Status": "Available",
      "DhcpOptionsSetId": "dopt-o6w0df4epg9zo8isy****",
      "DhcpOptionsSetName": "test",
      "AssociateVpcCount": 2,
      "OwnerId": 253460731706911260,
      "DhcpOptions": {
        "DomainNameServers": "192.168.XX.XX",
        "DomainName": "example.com",
        "LeaseTime": "3650d",
        "Ipv6LeaseTime": "3650d"
      },
      "ResourceGroupId": "rg-acfmxazb4ph****",
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ],
      "CreationTime": "2025-08-21 ***"
    }
  ],
  "TotalCount": "10"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.NextToken	The specified NextToken is invalid.	The specified NextToken is invalid.
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.