Retrieve and update all Access Control Lists (ACLs) or one specific ACL. ACLs control access to the Managed DNS management interfaces, both UI and API.
Understanding How The API Works »
REST Syntax
Click to view all REST Resources |
/REST/CustomerIPACL/ PUT -or- POST — Updates one or all ACLs for your account.
HTTP Action — PUT -or- POST
URIs:
Updates a single IPACL — https://api.dynect.net/REST/CustomerIPACL/<scope>/
Updates all ACLs — https://api.dynect.net/REST/CustomerIPACL/<scope>/
NOTE: scope is expected to be web or api. May be set in either or both of the URI arguments. If both are set, they must match. |
Arguments —
- string
netmasks — comma or space-delimited list of netmasks, in CIDR form; no ‘/’ assumes exact address.
NOTE: Set netmasks to an empty string `”` in order to delete that scope’s ACL (default web)
- string
active — Indicates whether this ACL is active.
Valid values:
Y = active (default)
N = inactive
NOTE: active sent without netmasks set will update that scope’s ACL to the value specified.
- string
scope — Identifies where this ACL applies. web will cover API interactions when there is no (or there is an inactive) api ACL.
Valid values
web = ACL controls access to the UI (found at manage.dynect.net), default.
api = ACL controls access to the API (accessed by calls to api.dynect.net).
|
Response —
- array
acl — list of ACL information.
- string
netmasks — comma or space-delimited list of netmasks, in CIDR form; no ‘/’ assumes exact address.
NOTE: Set netmasks to an empty string `”` in order to delete that scope’s ACL (default web)
- string
active — Indicates whether this ACL is active.
Valid values:
Y = active (default)
N = inactive
NOTE: active sent without netmasks set will update that scope’s ACL to the value specified.
- string
scope — Identifies where this ACL applies. web will cover API interactions when there is no (or there is an inactive) api ACL.
Valid values
web = ACL controls access to the UI (found at manage.dynect.net), default.
api = ACL controls access to the API (accessed by calls to api.dynect.net).
|
SOAP Syntax
Click to view all SOAP Commands |
SetCustomerIPACL — Updates one or all ACLs for your account. |
Arguments —
- string
customer_name — Retrieve ACLs for your account.
- string
netmasks — comma or space-delimited list of netmasks, in CIDR form; no ‘/’ assumes exact address.
NOTE: Set netmasks to an empty string `”` in order to delete that scope’s ACL (default web)
- string
active — Indicates whether this ACL is active.
Valid values:
Y = active (default)
N = inactive
NOTE: active sent without netmasks set will update that scope’s ACL to the value specified.
- string
scope — Identifies where this ACL applies. web will cover API interactions when there is no (or there is an inactive) api ACL.
Valid values
web = ACL controls access to the UI (found at manage.dynect.net), default.
api = ACL controls access to the API (accessed by calls to api.dynect.net).
- string
token — Required. The session identifier.
|
Response —
- hash
data
- array
acl — list of ACL information.
- string
netmasks — comma or space-delimited list of netmasks, in CIDR form; no ‘/’ assumes exact address.
NOTE: Set netmasks to an empty string `”` in order to delete that scope’s ACL (default web)
- string
active — Indicates whether this ACL is active.
Valid values:
Y = active (default)
N = inactive
NOTE: active sent without netmasks set will update that scope’s ACL to the value specified.
- string
scope — Identifies where this ACL applies. web will cover API interactions when there is no (or there is an inactive) api ACL.
Valid values
web = ACL controls access to the UI (found at manage.dynect.net), default.
api = ACL controls access to the API (accessed by calls to api.dynect.net).
- string
token — The session identifier.
|
Example Request — Click for More Info
{
'customer_name' => 'mycust',
'netmasks' => '1.5.3.0/24 34.54.32.0/19',
'active' => 'Y',
'scope' => 'web',
'token' => 'asdlj34ot879834cdzjklfK',
}
|
DNS API Knowledge Base