Replacing (Updating) a list of zones within a permission group using the API requires specific syntax depending on whether you are using REST or SOAP. Use this table to find the syntax for your command.
See Understanding Group Permissions for a listing of all default permissions groups within Managed DNS.
Understanding How The API Works »
REST Syntax
Click to view all REST Resources |
PermissionGroupZoneEntry — Replaces the list of zones in a permission group with a new list.
HTTP Action — PUT
URI — https://api.dynect.net/REST/PermissionGroupZoneEntry/<group_name>/
|
Arguments — Click for More Info
- array
zone — A list of zones. Pass an empty list or omit the argument to clear the list of zones in the permission group.
- string
zone_name — Required. The name of the zone or FQDN where the permissions should apply.
- string
recurse — Indicates whether or not permissions should apply to subnodes of the zone_name as well.
Valid values:
Y – Permissions should apply to zone_name and any nodes below zone_name . Default.
N – Permissions should apply only to zone_name .
|
Response:
Not Applicable.
|
SOAP Syntax
Click to view all SOAP Commands |
SetPermissionGroupZones — Replaces the list of zones in a permission group with a new list.
|
Arguments — Click for More Info
- string
group_name — Required. The permission group’s name.
- array
zone — A list of zones. Pass an empty list or omit the argument to clear the list of zones in the permission group.
- string
zone_name — Required. The name of the zone or FQDN where the permissions should apply.
- string
recurse — Indicates whether or not permissions should apply to subnodes of the zone_name as well.
Valid values:
Y – Permissions should apply to zone_name and any nodes below zone_name . Default.
N – Permissions should apply only to zone_name .
- string
token — Required. The session identifier.
|
Response:
Not Applicable.
|
Example Request — Click for More Info
{
'token' => 'asdlj34ot879834cdzjklfK',
'group_name' => 'MyGroup',
'zone' => [
{
zone_name => 'test.com',
}, {
zone_name => 'test2.com',
recurse => 'N'
},
]
}
|
DNS API Knowledge Base