Added FileSystem Get/SetAccessControl and SetPermissions (#8081)

specification/storage/data-plane/Microsoft.StorageDataLake/stable/2018-11-09/DataLakeStorage.json

@@ -482,6 +482,301 @@
         }
       ]
     },
+    "/{filesystem}/?action=setAccessControl": {
+      "patch": {
+        "tags": [
+          "FileSystem Operations"
+        ],
+        "operationId": "FileSystem_SetAccessControl",
+        "description": "Set the owner, group, permissions, or access control list for a file system.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/Timeout"
+          },
+          {
+            "$ref": "#/parameters/LeaseIdOptional"
+          },
+          {
+            "$ref": "#/parameters/Owner"
+          },
+          {
+            "$ref": "#/parameters/Group"
+          },
+          {
+            "$ref": "#/parameters/Permissions"
+          },
+          {
+            "$ref": "#/parameters/Acl"
+          },
+          {
+            "$ref": "#/parameters/IfMatch"
+          },
+          {
+            "$ref": "#/parameters/IfNoneMatch"
+          },
+          {
+            "$ref": "#/parameters/IfModifiedSince"
+          },
+          {
+            "$ref": "#/parameters/IfUnmodifiedSince"
+          },
+          {
+            "$ref": "#/parameters/ClientRequestId"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Set file system access control response.",
+            "headers": {
+              "Date": {
+                "type": "string",
+                "format": "date-time-rfc1123",
+                "description": "A UTC date/time value generated by the service that indicates the time at which the response was initiated."
+              },
+              "ETag": {
+                "type": "string",
+                "format": "etag",
+                "description": "An HTTP entity tag associated with the file or directory."
+              },
+              "Last-Modified": {
+                "type": "string",
+                "format": "date-time-rfc1123",
+                "description": "The data and time the file or directory was last modified. Write operations on the file system update the last modified time."
+              },
+              "x-ms-client-request-id": {
+                "x-ms-client-name": "ClientRequestId",
+                "type": "string",
+                "description": "If a client request id header is sent in the request, this header will be present in the response with the same value."
+              },
+              "x-ms-request-id": {
+                "x-ms-client-name": "RequestId",
+                "type": "string",
+                "description": "A server-generated UUID recorded in the analytics logs for troubleshooting and correlation."
+              },
+              "x-ms-version": {
+                "x-ms-client-name": "Version",
+                "type": "string",
+                "description": "The version of the REST protocol used to process the request."
+              }
+            }
+          },
+          "default": {
+            "description": "Failure",
+            "headers": {
+              "x-ms-client-request-id": {
+                "x-ms-client-name": "ClientRequestId",
+                "type": "string",
+                "description": "If a client request id header is sent in the request, this header will be present in the response with the same value."
+              },
+              "x-ms-request-id": {
+                "x-ms-client-name": "RequestId",
+                "type": "string",
+                "description": "A server-generated UUID recorded in the analytics logs for troubleshooting and correlation."
+              },
+              "x-ms-version": {
+                "x-ms-client-name": "Version",
+                "type": "string",
+                "description": "The version of the REST protocol used to process the request."
+              }
+            },
+            "schema": {
+              "$ref": "#/definitions/StorageError"
+            }
+          }
+        }
+      },
+      "parameters": [
+        {
+          "name": "action",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "enum": [
+            "setAccessControl"
+          ]
+        }
+      ]
+    },
+    "/{filesystem}/?action=getAccessControl": {
+      "head": {
+        "operationId": "FileSystem_GetAccessControl",
+        "summary": "Get Access Control List",
+        "description": "Get Access Control List returns the access control list for a file system. This operation supports conditional HTTP requests.  For more information, see [Specifying Conditional Headers for Blob Service Operations](https://docs.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations).",
+        "tags": [
+          "File System Operations"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/Upn"
+          },
+          {
+            "$ref": "#/parameters/LeaseIdOptional"
+          },
+          {
+            "$ref": "#/parameters/IfMatch"
+          },
+          {
+            "$ref": "#/parameters/IfNoneMatch"
+          },
+          {
+            "$ref": "#/parameters/IfModifiedSince"
+          },
+          {
+            "$ref": "#/parameters/IfUnmodifiedSince"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns all properties for the file or directory.",
+            "headers": {
+              "Accept-Ranges": {
+                "description": "Indicates that the service supports requests for partial file content.",
+                "type": "string"
+              },
+              "Cache-Control": {
+                "description": "If the Cache-Control request header has previously been set for the resource, that value is returned in this header.",
+                "type": "string"
+              },
+              "Content-Disposition": {
+                "description": "If the Content-Disposition request header has previously been set for the resource, that value is returned in this header.",
+                "type": "string"
+              },
+              "Content-Encoding": {
+                "description": "If the Content-Encoding request header has previously been set for the resource, that value is returned in this header.",
+                "type": "string"
+              },
+              "Content-Language": {
+                "description": "If the Content-Language request header has previously been set for the resource, that value is returned in this header.",
+                "type": "string"
+              },
+              "Content-Length": {
+                "description": "The size of the resource in bytes.",
+                "type": "integer",
+                "format": "int64"
+              },
+              "Content-Range": {
+                "description": "Indicates the range of bytes returned in the event that the client requested a subset of the file by setting the Range request header.",
+                "type": "string"
+              },
+              "Content-Type": {
+                "description": "The content type specified for the resource. If no content type was specified, the default content type is application/octet-stream.",
+                "type": "string"
+              },
+              "Content-MD5": {
+                "description": "The MD5 hash of complete file stored in storage. This header is returned only for \"GetProperties\" operation. If the Content-MD5 header has been set for the file, this response header is returned for GetProperties call so that the client can check for message content integrity.",
+                "type": "string"
+              },
+              "Date": {
+                "description": "A UTC date/time value generated by the service that indicates the time at which the response was initiated.",
+                "type": "string",
+                "format": "date-time-rfc1123"
+              },
+              "ETag": {
+                "description": "An HTTP entity tag associated with the file or directory.",
+                "format": "etag",
+                "type": "string"
+              },
+              "Last-Modified": {
+                "description": "The data and time the file or directory was last modified.  Write operations on the file or directory update the last modified time.",
+                "format": "date-time-rfc1123",
+                "type": "string"
+              },
+              "x-ms-request-id": {
+                "x-ms-client-name": "RequestId",
+                "description": "A server-generated UUID recorded in the analytics logs for troubleshooting and correlation.",
+                "pattern": "^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$",
+                "type": "string"
+              },
+              "x-ms-version": {
+                "x-ms-client-name": "Version",
+                "description": "The version of the REST protocol used to process the request.",
+                "type": "string"
+              },
+              "x-ms-resource-type": {
+                "x-ms-client-name": "ResourceType",
+                "description": "The type of the resource.  The value may be \"file\" or \"directory\".  If not set, the value is \"file\".",
+                "type": "string"
+              },
+              "x-ms-properties": {
+                "x-ms-client-name": "Properties",
+                "description": "The user-defined properties associated with the file or directory, in the format of a comma-separated list of name and value pairs \"n1=v1, n2=v2, ...\", where each value is a base64 encoded string. Note that the string may only contain ASCII characters in the ISO-8859-1 character set.",
+                "type": "string"
+              },
+              "x-ms-owner": {
+                "x-ms-client-name": "Owner",
+                "description": "The owner of the file or directory. Included in the response if Hierarchical Namespace is enabled for the account.",
+                "type": "string"
+              },
+              "x-ms-group": {
+                "x-ms-client-name": "Group",
+                "description": "The owning group of the file or directory. Included in the response if Hierarchical Namespace is enabled for the account.",
+                "type": "string"
+              },
+              "x-ms-permissions": {
+                "x-ms-client-name": "Permissions",
+                "description": "The POSIX access permissions for the file owner, the file owning group, and others. Included in the response if Hierarchical Namespace is enabled for the account.",
+                "type": "string"
+              },
+              "x-ms-acl": {
+                "x-ms-client-name": "ACL",
+                "description": "The POSIX access control list for the file or directory.  Included in the response only if the action is \"getAccessControl\" and Hierarchical Namespace is enabled for the account.",
+                "type": "string"
+              },
+              "x-ms-lease-duration": {
+                "x-ms-client-name": "LeaseDuration",
+                "description": "When a resource is leased, specifies whether the lease is of infinite or fixed duration.",
+                "type": "string"
+              },
+              "x-ms-lease-state": {
+                "x-ms-client-name": "LeaseState",
+                "description": "Lease state of the resource.",
+                "type": "string"
+              },
+              "x-ms-lease-status": {
+                "x-ms-client-name": "LeaseStatus",
+                "description": "The lease status of the resource.",
+                "type": "string"
+              }
+            }
+          },
+          "default": {
+            "description": "Failure",
+            "headers": {
+              "x-ms-error-code": {
+                "x-ms-client-name": "ErrorCode",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "#/definitions/StorageError"
+            }
+          }
+        }
+      },
+      "parameters": [
+        {
+          "name": "action",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "enum": [
+            "getAccessControl"
+          ]
+        },
+        {
+          "$ref": "#/parameters/ClientRequestId"
+        },
+        {
+          "$ref": "#/parameters/Timeout"
+        },
+        {
+          "$ref": "#/parameters/ApiVersionParameter"
+        }
+      ]
+    },
     "/{filesystem}/{path}": {
       "put": {
         "operationId": "Path_Create",