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

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
RegionId	String	Sim	cn-hangzhou	ID da região do conjunto de opções DHCP a ser consultado. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
DhcpOptionsSetId	String	Sim	dopt-o6w0df4epg9zo8isy****	ID do conjunto de opções DHCP.
Action	String	Sim	GetDhcpOptionsSet	Operação a ser executada. Defina o valor como GetDhcpOptionsSet.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
DhcpOptionsSetDescription	String	test	Descrição do conjunto de opções DHCP.
Status	String	Available	Status do conjunto de opções DHCP. Valores válidos: Available InUse Deleted Pending
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	ID da solicitação.
DhcpOptionsSetId	String	dopt-o6w0df4epg9zo8isy****	ID do conjunto de opções DHCP.
DhcpOptionsSetName	String	test	Nome do conjunto de opções DHCP.
OwnerId	Long	283117732402483989	ID da conta Alibaba Cloud proprietária do conjunto de opções DHCP.
DhcpOptions	Object		Informações de configuração do conjunto de opções DHCP.
DomainNameServers	String	192.XX.XX.123	Endereço IP do servidor DNS.
DomainName	String	example.com	Sufixo do nome do host.
LeaseTime	String	3650d	Tempo de concessão dos endereços IPv4 do conjunto de opções DHCP. Em horas, os valores válidos são 24h a 1176h e 87600h a 175200h. Valor padrão: 87600h. Em dias, os valores válidos são 1d a 49d e 3650d a 7300d. Valor padrão: 3650d.
Ipv6LeaseTime	String	3650d	Tempo de concessão dos endereços IPv6 do conjunto de opções DHCP. Em horas, os valores válidos são 24h a 1176h e 87600h a 175200h. Valor padrão: 87600h. Em dias, os valores válidos são 1d a 49d e 3650d a 7300d. Valor padrão: 3650d.
AssociateVpcs	Array of AssociateVpc		Informações sobre a Virtual Private Cloud (VPC) associada ao conjunto de opções DHCP.
AssociateStatus	String	InUse	Status da VPC associada ao conjunto de opções DHCP. Valores válidos: InUse Pending
VpcId	String	vpc-eb3b54r6otues4tjj****	ID da VPC associada ao conjunto de opções DHCP.
ResourceGroupId	String	rg-acfmxazb4ph****	ID do grupo de recursos ao qual o conjunto de opções DHCP pertence.
Tags	Array of Tag		Informações das tags.
Key	String	FinanceDept	Chave da tag.
Value	String	FinanceJoshua	Valor da tag.

Exemplos

Exemplos de solicitação

http(s)://[Endpoint]/?RegionId=cn-hangzhou
&DhcpOptionsSetId=dopt-o6w0df4epg9zo8isy****
&Action=GetDhcpOptionsSet
&Common request parameters

Exemplos de resposta de sucesso

Formato XML

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

<GetDhcpOptionsSetResponse>
    <DhcpOptionsSetDescription>test</DhcpOptionsSetDescription>
    <Status>Available</Status>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
    <DhcpOptionsSetId>dopt-o6w0df4epg9zo8isy****</DhcpOptionsSetId>
    <DhcpOptionsSetName>test</DhcpOptionsSetName>
    <OwnerId>283117732402484000</OwnerId>
    <DhcpOptions>
        <DomainNameServers>192.XX.XX.123</DomainNameServers>
        <DomainName>example.com</DomainName>
        <LeaseTime>3650d</LeaseTime>
        <Ipv6LeaseTime>3650d</Ipv6LeaseTime>
    </DhcpOptions>
    <AssociateVpcs>
        <AssociateStatus>InUse</AssociateStatus>
        <VpcId>vpc-eb3b54r6otues4tjj****</VpcId>
    </AssociateVpcs>
    <ResourceGroupId>rg-acfmxazb4ph****</ResourceGroupId>
    <Tags>
        <Key>FinanceDept</Key>
        <Value>FinanceJoshua</Value>
    </Tags>
</GetDhcpOptionsSetResponse>

Formato JSON

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

{
  "DhcpOptionsSetDescription" : "test",
  "Status" : "Available",
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "DhcpOptionsSetId" : "dopt-o6w0df4epg9zo8isy****",
  "DhcpOptionsSetName" : "test",
  "OwnerId" : 283117732402484000,
  "DhcpOptions" : {
    "DomainNameServers" : "192.XX.XX.123",
    "DomainName" : "example.com",
    "LeaseTime" : "3650d",
    "Ipv6LeaseTime" : "3650d"
  },
  "AssociateVpcs" : [ {
    "AssociateStatus" : "InUse",
    "VpcId" : "vpc-eb3b54r6otues4tjj****"
  } ],
  "ResourceGroupId" : "rg-acfmxazb4ph****",
  "Tags" : [ {
    "Key" : "FinanceDept",
    "Value" : "FinanceJoshua"
  } ]
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	Erro retornado quando a região especificada não existe. Verifique se o ID da região é válido.

Para obter uma lista de códigos de erro, visite o Error Center.