gslb zone¶
Specify the DNS zone name for which global SLB is provided
zone Specification¶
Type
Collection
Object Key(s)
name
Collection Name
Collection URI
/axapi/v3/gslb/zone
Element Name
zone
Element URI
/axapi/v3/gslb/zone/{name}
Element Attributes
zone_attributes
Statistics Data URI
/axapi/v3/gslb/zone/{name}/stats
Operational Data URI
/axapi/v3/gslb/zone/{name}/oper
Schema
Operations Allowed:
| Operation | Method | URI | Payload | |
|---|---|---|---|---|
Create Object | POST | /axapi/v3/gslb/zone | ||
Create List | POST | /axapi/v3/gslb/zone | ||
Get Object | GET | /axapi/v3/gslb/zone/{name} | ||
Get List | GET | /axapi/v3/gslb/zone | ||
Modify Object | POST | /axapi/v3/gslb/zone/{name} | ||
Replace Object | PUT | /axapi/v3/gslb/zone/{name} | ||
Replace List | PUT | /axapi/v3/gslb/zone | ||
Delete Object | DELETE | /axapi/v3/gslb/zone/{name} |
zone-list¶
zone-list is JSON List of zone attributes
zone-list : [
]
zone attributes¶
disable
Description Disable all services in the GSLB zone
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
dns-caa-record-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/dns-caa-record/{critical-flag}+{issue}+{issuewild}+{iodef}+{property-tag}+{rdata}
dns-mx-record-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/dns-mx-record/{mx-name}
dns-ns-record-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/dns-ns-record/{ns-name}
dns-soa-record
Description: dns-soa-record is a JSON Block. Please see below for dns-soa-record
Type: Object
name
Description Specify the name for the DNS zone
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
policy
Description Specify the policy for this zone (Specify policy name)
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
Default: default
service-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/service/{service-port}+{service-name}
template
Description: template is a JSON Block. Please see below for template
Type: Object
ttl
Description Specify the zone ttl value (TTL value, unit: second, default is 10)
Type: number
Range: 0-1000000000
Default: 10
Mutual Exclusion: ttl and use-server-ttl are mutually exclusive
use-server-ttl
Description Use DNS Server Response TTL value in GSLB Proxy mode
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
Mutual Exclusion: use-server-ttl and ttl are mutually exclusive
user-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
dns-ns-record-list¶
Specification
Type
list
Block object keys
ns-name
Description Specify Domain Name
Type: string
Maximum Length: 127 characters
Maximum Length: 1 characters
ttl
Description Specify TTL
Type: number
Range: 0-2147483647
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
dns-caa-record-list¶
Specification
Type
list
Block object keys
critical-flag
Description Issuer Critical Flag
Type: number
Range: 0-255
iodef
Description Specify iodef property
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
issue
Description Specify issue property
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
issuewild
Description Specify issuewild property
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
property-tag
Description Specify other property tags, only allowed lowercase alphanumeric
Type: string
Format: string-rlx
Maximum Length: 255 characters
Maximum Length: 1 characters
rdata
Description Specify the Issuer Domain Name or a URL
Type: string
Format: string-rlx
Maximum Length: 1000 characters
Maximum Length: 1 characters
ttl
Description Specify TTL
Type: number
Range: 0-2147483647
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
dns-mx-record-list¶
Specification
Type
list
Block object keys
mx-name
Description Specify Domain Name
Type: string
Maximum Length: 127 characters
Maximum Length: 1 characters
priority
Description Specify Priority
Type: number
Range: 0-65535
ttl
Description Specify TTL
Type: number
Range: 0-2147483647
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
template¶
Specification
Type
object
dnssec
Description Specify DNSSEC template (Specify template name)
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
dns-soa-record¶
Specification
Type
object
ex-expire
Description Specify Expire Time Interval, default is 1209600
Type: number
Range: 0-2147483647
Default: 1209600
ex-mail
Description Mailbox
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
ex-refresh
Description Specify Refresh Time Interval, default is 3600
Type: number
Range: 0-2147483647
Default: 3600
ex-retry
Description Specify Retry Time Interval, default is 900
Type: number
Range: 0-2147483647
Default: 900
ex-serial
Description Specify Serial Number, default is Current Time (Time Interval)
Type: number
Range: 0-2147483647
ex-soa-ttl
Description Specify Negative caching TTL, default is Zone TTL
Type: number
Range: 0-2147483647
expire
Description Specify Expire Time Interval, default is 1209600
Type: number
Range: 0-2147483647
Default: 1209600
external
Description Specify External SOA Record (DNS Server Name)
Type: string
Maximum Length: 127 characters
Maximum Length: 1 characters
Description Mailbox
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
refresh
Description Specify Refresh Time Interval, default is 3600
Type: number
Range: 0-2147483647
Default: 3600
retry
Description Specify Retry Time Interval, default is 900
Type: number
Range: 0-2147483647
Default: 900
serial
Description Specify Serial Number, default is Current Time (Time Interval)
Type: number
Range: 0-2147483647
soa-name
Description DNS Server Name
Type: string
Maximum Length: 127 characters
Maximum Length: 1 characters
soa-ttl
Description Specify Negative caching TTL, default is Zone TTL
Type: number
Range: 0-2147483647
service-list¶
Specification
Type
list
Block object keys
action
Description ‘drop’: Drop query; ‘forward’: Forward packet; ‘ignore’: Send empty response; ‘reject’: Send refuse response;
Type: string
Supported Values: drop, forward, ignore, reject
disable
Description Disable
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
dns-a-record
Description: dns-a-record is a JSON Block. Please see below for service-list_dns-a-record
Type: Object
Refernce Object: /axapi/v3/gslb/zone/{name}/service/{service-port}+{service-name}/dns-a-record
dns-caa-record-list
dns-cname-record-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/service/{service-port}+{service-name}/dns-cname-record/{alias-name}
dns-mx-record-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/service/{service-port}+{service-name}/dns-mx-record/{mx-name}
dns-naptr-record-list
dns-ns-record-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/service/{service-port}+{service-name}/dns-ns-record/{ns-name}
dns-ptr-record-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/service/{service-port}+{service-name}/dns-ptr-record/{ptr-name}
dns-record-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/service/{service-port}+{service-name}/dns-record/{type}
dns-srv-record-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/service/{service-port}+{service-name}/dns-srv-record/{srv-name}+{port}
dns-txt-record-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/service/{service-port}+{service-name}/dns-txt-record/{record-name}
forward-type
Description ‘both’: Forward both query and response; ‘query’: Forward query; ‘response’: Forward response;
Type: string
Supported Values: both, query, response
geo-location-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/service/{service-port}+{service-name}/geo-location/{geo-name}
health-check-gateway
Description ‘enable’: Enable Gateway Status Check; ‘disable’: Disable Gateway Status Check;
Type: string
Supported Values: enable, disable
Default: enable
health-check-port
Type: List
policy
Description Specify policy for this service (Specify policy name)
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
service-name
Description Specify the service name for the zone, * for wildcard
Type: string
Format: string-rlx
Maximum Length: 63 characters
Maximum Length: 1 characters
Default:
service-port
Description Port number of the service
Type: number
Range: 0-65534
user-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
service-list_dns-a-record¶
Specification
Type
object
dns-a-record-ipv4-list
dns-a-record-ipv6-list
dns-a-record-srv-list
Type: List
Refernce Object: /axapi/v3/gslb/zone/{name}/service/{service-port}+{service-name}/dns-a-record/dns-a-record-srv/{svrname}
service-list_dns-a-record_dns-a-record-ipv6-list¶
Specification
Type
list
Block object keys
admin-ip
Description Specify admin priority of Service-IP (Specify the priority)
Type: number
Range: 1-255
as-backup
Description As backup when fail
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
as-replace
Description Return this Service-IP when enable ip-replace
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
disable
Description Disable this Service-IP
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
dns-a-record-ipv6
Description IPV6 address
Type: string
Format: ipv6-address
no-resp
Description Don’t use this Service-IP as DNS response
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
static
Description Return this Service-IP in DNS server mode
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
ttl
Description Specify TTL for Service-IP
Type: number
Range: 0-2147483647
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
weight
Description Specify weight for Service-IP (Weight value)
Type: number
Range: 1-100
service-list_dns-a-record_dns-a-record-ipv4-list¶
Specification
Type
list
Block object keys
admin-ip
Description Specify admin priority of Service-IP (Specify the priority)
Type: number
Range: 1-255
as-backup
Description As backup when fail
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
as-replace
Description Return this Service-IP when enable ip-replace
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
disable
Description Disable this Service-IP
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
dns-a-record-ip
Description Specify IP address
Type: string
Format: ipv4-address
no-resp
Description Don’t use this Service-IP as DNS response
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
static
Description Return this Service-IP in DNS server mode
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
ttl
Description Specify TTL for Service-IP
Type: number
Range: 0-2147483647
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
weight
Description Specify weight for Service-IP (Weight value)
Type: number
Range: 1-100
service-list_dns-a-record_dns-a-record-srv-list¶
Specification
Type
list
Block object keys
admin-ip
Description Specify admin priority of Service-IP (Specify the priority)
Type: number
Range: 1-255
as-backup
Description As backup when fail
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
as-replace
Description Return this Service-IP when enable ip-replace
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
disable
Description Disable this Service-IP
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
no-resp
Description Don’t use this Service-IP as DNS response
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
static
Description Return this Service-IP in DNS server mode
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
svrname
Description Specify name
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
Refernce Object: /axapi/v3/gslb/service-ip
ttl
Description Specify TTL for Service-IP
Type: number
Range: 0-2147483647
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
weight
Description Specify weight for Service-IP (Weight value)
Type: number
Range: 1-100
service-list_health-check-port¶
Specification
Type
list
Block object keys
health-check-port
Description Check Related Port Status (Port Number)
Type: number
Range: 0-65534
service-list_dns-txt-record-list¶
Specification
Type
list
Block object keys
record-name
Description Specify the Object Name for TXT Data
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
ttl
Description Specify TTL
Type: number
Range: 0-2147483647
Default: 0
txt-data
Description Specify TXT Data
Type: string
Format: string-rlx
Maximum Length: 1000 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
service-list_dns-mx-record-list¶
Specification
Type
list
Block object keys
mx-name
Description Specify Domain Name
Type: string
Maximum Length: 127 characters
Maximum Length: 1 characters
priority
Description Specify Priority
Type: number
Range: 0-65535
ttl
Description Specify TTL
Type: number
Range: 0-2147483647
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
service-list_dns-record-list¶
Specification
Type
list
Block object keys
data
Description Specify DNS Data
Type: string
Format: string-rlx
Maximum Length: 512 characters
Maximum Length: 1 characters
type
Description Specify DNS Type
Type: number
Range: 1-65535
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
service-list_dns-ns-record-list¶
Specification
Type
list
Block object keys
ns-name
Description Specify Domain Name
Type: string
Maximum Length: 127 characters
Maximum Length: 1 characters
ttl
Description Specify TTL
Type: number
Range: 0-2147483647
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
service-list_dns-srv-record-list¶
Specification
Type
list
Block object keys
port
Description Specify Port (Port Number)
Type: number
Range: 0-65534
priority
Description Specify Priority
Type: number
Range: 0-65535
srv-name
Description Specify Domain Name
Type: string
Maximum Length: 127 characters
Maximum Length: 1 characters
ttl
Description Specify TTL
Type: number
Range: 0-2147483647
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
weight
Description Specify Weight, default is 10
Type: number
Range: 0-65535
Default: 10
service-list_dns-caa-record-list¶
Specification
Type
list
Block object keys
critical-flag
Description Issuer Critical Flag
Type: number
Range: 0-255
iodef
Description Specify iodef property
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
issue
Description Specify issue property
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
issuewild
Description Specify issuewild property
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
property-tag
Description Specify other property tags, only allowed lowercase alphanumeric
Type: string
Format: string-rlx
Maximum Length: 255 characters
Maximum Length: 1 characters
rdata
Description Specify the Issuer Domain Name or a URL
Type: string
Format: string-rlx
Maximum Length: 1000 characters
Maximum Length: 1 characters
ttl
Description Specify TTL
Type: number
Range: 0-2147483647
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
service-list_dns-ptr-record-list¶
Specification
Type
list
Block object keys
ptr-name
Description Specify Domain Name
Type: string
Maximum Length: 127 characters
Maximum Length: 1 characters
ttl
Description Specify TTL
Type: number
Range: 0-2147483647
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
service-list_dns-cname-record-list¶
Specification
Type
list
Block object keys
admin-preference
Description Specify Administrative Preference, default is 100
Type: number
Range: 0-255
Default: 100
alias-name
Description Specify the alias name
Type: string
Maximum Length: 127 characters
Maximum Length: 1 characters
as-backup
Description As backup when fail
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
weight
Description Specify Weight, default is 1
Type: number
Range: 1-100
Default: 1
service-list_geo-location-list¶
Specification
Type
list
Block object keys
action
Description Action for this geo-location
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
Mutual Exclusion: action and policy are mutually exclusive
action-type
Description ‘allow’: Allow query from this geo-location; ‘drop’: Drop query from this geo-location; ‘forward’: Forward packet for this geo-location; ‘ignore’: Send empty response to this geo-location; ‘reject’: Send refuse response to this geo-location;
Type: string
Supported Values: allow, drop, forward, ignore, reject
alias
Type: List
forward-type
Description ‘both’: Forward both query and response; ‘query’: Forward query from this geo-location; ‘response’: Forward response to this geo-location;
Type: string
Supported Values: both, query, response
geo-name
Description Specify the geo-location
Type: string
Maximum Length: 127 characters
Maximum Length: 1 characters
policy
Description Policy for this geo-location (Specify the policy name)
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
Mutual Exclusion: policy and action are mutually exclusive
user-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
service-list_geo-location-list_alias¶
Specification
Type
list
Block object keys
alias
Description Send CNAME response for this geo-location (Specify a CNAME record)
Type: string
Maximum Length: 127 characters
Maximum Length: 1 characters
service-list_dns-naptr-record-list¶
Specification
Type
list
Block object keys
flag
Description Specify the flag (e.g., a, s). Default is empty flag
Type: string
Maximum Length: 1 characters
Maximum Length: 1 characters
Default:
naptr-target
Description Specify the replacement or regular expression
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
order
Description Specify Order
Type: number
Range: 0-65535
preference
Description Specify Preference
Type: number
Range: 0-65535
regexp
Description Return the regular expression
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
service-proto
Description Specify Service and Protocol
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
ttl
Description Specify TTL
Type: number
Range: 0-2147483647
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
stats data¶
Counter |
Size |
Description |
|
|---|---|---|---|
received-query |
8 |
Total Number of DNS queries received for the zone |
|
sent-response |
8 |
Total Number of DNS replies sent to clients for the zone |
|
sticky-mode-response |
8 |
Total Number of DNS replies sent to clients by the ACOS device to keep the clients on the same site. (This statistic applies on |
|
server-mode-response |
8 |
Total Number of DNS replies sent to clients by the ACOS device as a DNS server for the zone. (This statistic applies only if th |
|
cache-mode-response |
8 |
Total Number of cached DNS replies sent to clients by the ACOS device for the zone. (This statistic applies only if the DNS cac |
|
backup-mode-response |
8 |
Total Number of DNS replies sent to clients by the ACOS device in backup mode |
|
proxy-mode-response |
8 |
Total Number of DNS replies sent to clients by the ACOS device as a DNS proxy for the zone |
operational data¶
Counter |
Size |
Description |
|
|---|---|---|---|
state |
string |
state |