• Home /
  • Get Customer IPACL (API)

Get Customer IPACL (API)

Retrieve 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/ GET — Retrieves one or all ACLs for your account.

HTTP Action — GET

URIs:

Retrieve a single ACL — https://api.dynect.net/REST/CustomerIPACL/<scope>/
NOTE: scope is expected to be web or api.

Retrieve all ACLs — https://api.dynect.net/REST/CustomerIPACL/
Arguments:

  • string customer_name — Optional. Enter your customer name to retrieve ACLs for your account.
Response:

  • array acl — List of ACL information.
    • string netmasks — Comma or space-delimited list of netmasks, in CIDR form; no ‘/’ assumes exact address
    • string active — Indicates whether this ACL is active.
      Valid values:
      Y = ACL is active.
      N = ACL is not active.
    • string scope — Indicates where this ACL applies, web will cover both UI and API interactions when there is no (or there is an inactive) api scoped ACL
      Valid values:
      web = ACL controls access to the UI (found at manage.dynect.net)
      api = ACL controls access to the API (accessed by calls to api.dynect.net)

Dyn Logo

SOAP Syntax

Click to view all SOAP Commands
GetCustomerIPACL — Retrieve ACLs for your account.
Arguments:

CustomerIPACL —

  • string customer — Optional. Enter your customer name to retrieve ACLs for your account.
  • string scope — Indicates where this ACL applies, web will cover both UI and API interactions when there is no (or there is an inactive) api scoped ACL.
    Valid values:
    web = ACL controls access to the UI (found at manage.dynect.net)
    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.
      • string active — Indicates whether this ACL is active.
        Valid values:
        Y = ACL is active.
        N = ACL is not active.
      • string scope — Indicates where this ACL applies, web will cover both UI and API interactions when there is no (or there is an inactive) api scoped ACL.
        Valid values:
        web = ACL controls access to the UI (found at manage.dynect.net)
        api = ACL controls access to the API (accessed by calls to api.dynect.net)
  • string token — The session identifier.
Example Request (GetCustomerIPACL) — Click for More Info

DNS API Knowledge Base