Resource URL: /platform/<<version=3>>/auth/settings/acls

    Overview: This resource contains ACL policy settings.

     Methods: GET, PUT

********************************************************************************

Method GET: Retrieve the ACL policy settings and preset configurations.

       URL: GET /platform/<<version=3>>/auth/settings/acls

Query arguments:
preset=<enum> Where <enum> is one of balanced, unix, windows.  If specified the
              preset configuration values for all applicable ACL policies are
              returned.

GET response body schema:
{
  "type": "object", 
  "properties": {
    "acl_policy_settings": {
      "type": "object", 
      "description": "ACL policies settings.", 
      "properties": {
        "calcmode_owner": {
          "type": [
            {
              "enum": [
                "owner_aces", 
                "owner_only"
              ], 
              "type": "string", 
              "description": "Approximate owner mode bits when ACL exists."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "calcmode": {
          "type": [
            {
              "enum": [
                "approx", 
                "777"
              ], 
              "type": "string", 
              "description": "Displayed mode bits."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "chmod_inheritable": {
          "type": [
            {
              "enum": [
                "yes", 
                "no"
              ], 
              "type": "string", 
              "description": "ACLs created on directories by UNIX chmod."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "dos_attr": {
          "type": [
            {
              "enum": [
                "deny_smb", 
                "deny_smb_and_nfs"
              ], 
              "type": "string", 
              "description": " Read only DOS attribute."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "chmod": {
          "type": [
            {
              "enum": [
                "remove", 
                "replace", 
                "replace_users_and_groups", 
                "merge", 
                "deny", 
                "ignore"
              ], 
              "type": "string", 
              "description": "chmod on files with existing ACLs."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "group_owner_inheritance": {
          "type": [
            {
              "enum": [
                "native", 
                "parent", 
                "creator"
              ], 
              "type": "string", 
              "description": "Group owner inheritance."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "access": {
          "type": [
            {
              "enum": [
                "unix", 
                "windows"
              ], 
              "type": "string", 
              "description": "Access checks (chmod, chown)."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "chown": {
          "type": [
            {
              "enum": [
                "owner_group_and_acl", 
                "owner_group_only", 
                "ignore"
              ], 
              "type": "string", 
              "description": "chown/chgrp on files with existing ACLs."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "chmod_007": {
          "type": [
            {
              "enum": [
                "default", 
                "remove"
              ], 
              "type": "string", 
              "description": "chmod (007) on files with existing ACLs."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "create_over_smb": {
          "type": [
            {
              "enum": [
                "allow", 
                "disallow"
              ], 
              "type": "string", 
              "description": "ACL creation over SMB."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "rwx": {
          "type": [
            {
              "enum": [
                "retain", 
                "full_control"
              ], 
              "type": "string", 
              "description": "Treatment of 'rwx' permissions."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "utimes": {
          "type": [
            {
              "enum": [
                "only_owner", 
                "owner_and_write"
              ], 
              "type": "string", 
              "description": "Access check (utimes)"
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "calcmode_group": {
          "type": [
            {
              "enum": [
                "group_aces", 
                "group_only"
              ], 
              "type": "string", 
              "description": "Approximate group mode bits when ACL exists."
            }, 
            {
              "type": "null"
            }
          ]
        }, 
        "synthetic_denies": {
          "type": [
            {
              "enum": [
                "none", 
                "remove"
              ], 
              "type": "string", 
              "description": "Synthetic 'deny' ACEs."
            }, 
            {
              "type": "null"
            }
          ]
        }
      }
    }
  }
}

********************************************************************************

Method PUT: Modify cluster ACL policy settings.

       URL: PUT /platform/<<version=3>>/auth/settings/acls

Query arguments:

PUT request body schema:
{
  "type": "object", 
  "description": "ACL policies settings.", 
  "properties": {
    "calcmode_owner": {
      "enum": [
        "owner_aces", 
        "owner_only"
      ], 
      "type": "string", 
      "description": "Approximate owner mode bits when ACL exists."
    }, 
    "calcmode": {
      "enum": [
        "approx", 
        "777"
      ], 
      "type": "string", 
      "description": "Displayed mode bits."
    }, 
    "chmod_inheritable": {
      "enum": [
        "yes", 
        "no"
      ], 
      "type": "string", 
      "description": "ACLs created on directories by UNIX chmod."
    }, 
    "dos_attr": {
      "enum": [
        "deny_smb", 
        "deny_smb_and_nfs"
      ], 
      "type": "string", 
      "description": " Read only DOS attribute."
    }, 
    "chmod": {
      "enum": [
        "remove", 
        "replace", 
        "replace_users_and_groups", 
        "merge", 
        "deny", 
        "ignore"
      ], 
      "type": "string", 
      "description": "chmod on files with existing ACLs."
    }, 
    "group_owner_inheritance": {
      "enum": [
        "native", 
        "parent", 
        "creator"
      ], 
      "type": "string", 
      "description": "Group owner inheritance."
    }, 
    "access": {
      "enum": [
        "unix", 
        "windows"
      ], 
      "type": "string", 
      "description": "Access checks (chmod, chown)."
    }, 
    "chown": {
      "enum": [
        "owner_group_and_acl", 
        "owner_group_only", 
        "ignore"
      ], 
      "type": "string", 
      "description": "chown/chgrp on files with existing ACLs."
    }, 
    "chmod_007": {
      "enum": [
        "default", 
        "remove"
      ], 
      "type": "string", 
      "description": "chmod (007) on files with existing ACLs."
    }, 
    "create_over_smb": {
      "enum": [
        "allow", 
        "disallow"
      ], 
      "type": "string", 
      "description": "ACL creation over SMB."
    }, 
    "rwx": {
      "enum": [
        "retain", 
        "full_control"
      ], 
      "type": "string", 
      "description": "Treatment of 'rwx' permissions."
    }, 
    "utimes": {
      "enum": [
        "only_owner", 
        "owner_and_write"
      ], 
      "type": "string", 
      "description": "Access check (utimes)"
    }, 
    "calcmode_group": {
      "enum": [
        "group_aces", 
        "group_only"
      ], 
      "type": "string", 
      "description": "Approximate group mode bits when ACL exists."
    }, 
    "synthetic_denies": {
      "enum": [
        "none", 
        "remove"
      ], 
      "type": "string", 
      "description": "Synthetic 'deny' ACEs."
    }
  }
}

There is no response body for this method.
