Network ResourcesDistributed Port Group Related Interfaces

RemoveDnsFromL3Network

API Request

URLs

DELETE/v1/l3-networks/{l3NetworkUuid}/dns/{dns}

Headers

Authorization: OAuth the-session-uuid

Curl Sample

curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth 209fa412351946a6bef267d423f4e53c" \
-X DELETE http://localhost:8080/zstack/v1/l3-networks/d96f7d4c0506435a9a1aa7394976c0b2/dns/8.8.4.4?

Request Parameters

NameTypeLocationDescriptionAllowed ValuesStarting Version
l3NetworkUuidStringurlThe L3 network UUID. 0.6
dnsStringurlThe DNS address. 0.6
systemTagsListbodyOptional. The system tags. 0.6
userTagsListbodyOptional. The user tags. 0.6

API Response

Sample Response

{
  "inventory": {
    "name": "Test-L3Network",
    "l2NetworkUuid": "535aea9c1be24fb9b172fa1955341685",
    "dns": []
  }
}
NameTypeDescriptionStarting Version
errorErrorCodeThe error code. If not null, the operation fails, or vice versa. For more information, see error.0.6
inventoryL3NetworkInventorySee inventory.0.6

error

NameTypeDescriptionStarting Version
codeStringThe error code, which is a numbered or alphanumeric code that specifies an error. For example, SYS.1000, HOST.1001.0.6
descriptionStringThe brief description of the error.0.6
detailsStringThe details about the error.0.6
elaborationStringThe reserved field. Default value: null.0.6
opaqueLinkedHashMapThe reserved field. Default value: null.0.6
causeErrorCodeThe root error, which is the associated root cause of the current error. If no root error exists, this parameter is null.0.6

inventory

NameTypeDescriptionStarting Version
uuidStringThe resource UUID.0.6
nameStringThe resource name.0.6
descriptionStringThe detailed description of the resource.0.6
typeString 0.6
zoneUuidStringThe zone UUID.0.6
l2NetworkUuidStringThe L2 network UUID.0.6
stateString 0.6
dnsDomainString 0.6
systemBoolean 0.6
categoryString 0.6
ipVersionIntegerThe IP version.3.1.0
enableIPAMBooleanEnables IP address management.4.10.16
createDateTimestampThe creation date.0.6
lastOpDateTimestampThe last operation date.0.6
dnsList 0.6
ipRangesListSee ipRanges.0.6
networkServicesListSee networkServices.0.6
hostRouteListSee hostRoute.2.3
reservedIpRangesListSee reservedIpRanges4.10.16

ipRanges

NameTypeDescriptionStarting Version
uuidStringThe resource UUID.0.6
l3NetworkUuidStringThe L3 network UUID.0.6
nameStringThe resource name.0.6
descriptionStringThe detailed description of the resource.0.6
startIpString 0.6
endIpString 0.6
netmaskString 0.6
prefixLenStringThe prefix length.3.1.0
gatewayString 0.6
networkCidrString 0.6
ipVersionIntegerThe IP version.3.1.0
addressModeStringThe IPv6 address allocation mode.3.1.0
createDateTimestampThe creation date.0.6
lastOpDateTimestampThe last operation date.0.6

networkServices

NameTypeDescriptionStarting Version
l3NetworkUuidStringThe L3 network UUID.0.6
networkServiceProviderUuidStringThe network service provider UUID.0.6
networkServiceTypeString 0.6

hostRoute

NameTypeDescriptionStarting Version
idLong 2.3
l3NetworkUuidStringThe L3 network UUID.2.3
prefixString 2.3
nexthopString 2.3
createDateTimestampThe creation date.2.3
lastOpDateTimestampThe last operation date.2.3

reservedIpRanges

NameTypeDescriptionStarting Version
uuidStringThe resource UUID.4.10.16
l3NetworkUuidStringThe L3 network UUID.4.10.16
nameStringThe resource name.4.10.16
descriptionStringThe detailed description of the resource.4.10.16
startIpStringThe start IP address (included in the reserved IP range).4.10.16
endIpStringThe end IP address (included in the reserved IP range).4.10.16
ipVersionIntegerThe IP version.4.10.16
createDateTimestampThe creation date.4.10.16
lastOpDateTimestampThe last operation date.4.10.16

SDK Sample

Java SDK

RemoveDnsFromL3NetworkAction action = new RemoveDnsFromL3NetworkAction();
action.l3NetworkUuid = "3e9227b9ecbd42bba0f3a4620f5655d2";
action.dns = "8.8.4.4";
action.sessionId = "f3e42d2a37ed4c42a6ce7d192af94e05";
RemoveDnsFromL3NetworkAction.Result res = action.call();

Python SDK

action = RemoveDnsFromL3NetworkAction()
action.l3NetworkUuid = "bdb41ab0a7c131a285acbfbd6e88b7d1"
action.dns = "8.8.4.4"
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
res = action.call()