Get Network Dhcp Config

Get Network Dhcp Config

Retrieves Dhcp configuration of a specific Org vDC network.

Request
URI
GET
https://{api_host}/cloudapi/1.0.0/orgVdcNetworks/{vdcNetworkId}/dhcp
COPY
Path Parameters
string
vdcNetworkId
Required

vdcNetworkId

string
vdcNetworkId
Required

vdcNetworkId

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns VdcNetworkDhcpConfig of type(s) application/json;version=36.0 
{
    "enabled": false,
    "leaseTime": 0,
    "dhcpPools": [
        {
            "enabled": false,
            "ipRange": {
                "startAddress": "string",
                "endAddress": "string"
            },
            "maxLeaseTime": 0,
            "defaultLeaseTime": 0
        }
    ],
    "mode": "string",
    "ipAddress": "string"
}
boolean
enabled
Optional

Whether the DHCP service is currently enabled on network.

integer As int64 As int64
leaseTime
Optional

The amount of time in seconds of how long a DHCP IP will be leased out for. The minimum is 60s while the maximum is 4,294,967,295s, which is roughly 49,710 days.

array of VdcNetworkDhcpPool
dhcpPools
Optional

Range of DHCP IP addresses

string
mode
Optional

This value describes how the DHCP service is configured for this network. Once a DHCP service has been created, the mode attribute cannot be changed. The mode field will default to 'EDGE' if it is not provided. This field only applies to networks backed by an NSX-T network provider.

  • The supported values are EDGE and NETWORK.
  • If EDGE is specified, the DHCP service of the edge is used to obtain DHCP IPs.
  • If NETWORK is specified, a DHCP server is created for use by this network.
In order to use DHCP for IPV6, NETWORK mode must be used. Routed networks which are using NETWORK DHCP services can be disconnected from the edge gateway and still retain their DHCP configuration, however network using EDGE DHCP cannot be disconnected from the gateway until DHCP has been disabled.
string
ipAddress
Optional

The IP address of the DHCP service. This is required upon create if using NETWORK mode. This field only applies to networks backed by an NSX-T network provider.


404

The specified resource was not found

Returns Error of type(s) application/json;version=36.0 
{
    "minorErrorCode": "string",
    "message": "string",
    "stackTrace": "string"
}
string
minorErrorCode
Required

minorErrorCode

string
message
Required

message

string
stackTrace
Optional

stackTrace


Availability
Added in 32.0
On This Page
Org Vdc Network Dhcp Operations
DELETE
Delete Network Dhcp Config
GET
Get Network Dhcp Config
PUT
Update Network Dhcp Config