Added APIs to set and get access control properties for paths

Author: zezha-msft

azure-storage-blob/ChangeLog.md

@@ -4,7 +4,7 @@
 
 ## Version XX.XX.XX
 
-- Added support for directory operations: create, rename, and delete.
+- Added support for path operations(only available for accounts with ADLS Gen2 Inter-op enabled): create and delete directory, rename path, get and set path access control.
 
 ## Version 2.1.0:
 

azure-storage-blob/azure/storage/blob/_deserialization.py

@@ -38,7 +38,10 @@
     ResourceProperties,
     BlobPrefix,
     AccountInformation,
-    UserDelegationKey, BatchSubResponse)
+    BatchSubResponse,
+    UserDelegationKey,
+    PathProperties,
+)
 from ._encryption import _decrypt_blob
 from azure.storage.common.models import _list
 from azure.storage.common._error import (
@@ -653,3 +656,12 @@ def _parse_sub_response_to_http_response(sub_response):
 def _parse_continuation_token(response):
     marker = response.headers.get('x-ms-continuation')
     return marker if marker is not '' else None
+
+
+def _parse_path_permission_and_acl(response):
+    props = PathProperties()
+    props.owner = response.headers.get('x-ms-owner')
+    props.group = response.headers.get('x-ms-group')
+    props.permissions = response.headers.get('x-ms-permissions')
+    props.acl = response.headers.get('x-ms-acl')
+    return props

azure-storage-blob/azure/storage/blob/baseblobservice.py

@@ -975,3 +975,24 @@ def __init__(self, key_value, key_hash):
         self.key_value = key_value
         self.key_hash = key_hash
         self.algorithm = 'AES256'
+
+class PathProperties(object):
+    """
+    Represent a path's properties(only permissions and acl at the moment).
+    The path can be either a directory or a file.
+
+    :ivar string owner:
+        Represents the owner of the path.
+    :ivar string group:
+        Represents the group of the path.
+    :ivar string permissions:
+        Represents the permissions of the path.
+    :ivar string acl:
+        Represents the acl of the path.
+    """
+
+    def __init__(self):
+        self.owner = None
+        self.group = None
+        self.permissions = None
+        self.acl = None