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": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "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 JSON response body for this method.
