HDFS FE: Update 2018-11-09 DataLakeStorage Swagger. (Azure#5108)

* HDFS FE: Update 2018-11-09 DataLakeStorage Swagger. * HDFS FE: Update 2018-11-09 DataLakeStorage Swagger - Fix typo. * HDFS FE: Update 2018-11-09 DataLakeStorage Swagger - Fix typo. * HDFS FE: Update 2018-11-09 DataLakeStorage Swagger - Fix typo. * fix Go SDK package path
yangl900 · Jan 29, 2019 · 60a8c18 · 60a8c18
1 parent 03581da
commit 60a8c18
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 16 deletions.
diff --git a/...ation/storage/data-plane/Microsoft.StorageDataLake/stable/2018-11-09/DataLakeStorage.json b/...ation/storage/data-plane/Microsoft.StorageDataLake/stable/2018-11-09/DataLakeStorage.json
@@ -330,7 +330,7 @@
         "parameters": [
           {
             "name": "x-ms-properties",
-            "description": "User-defined properties to be stored with the filesystem, in the format of a comma-separated list of name and value pairs \"n1=v1, n2=v2, ...\", where each value is base64 encoded.",
+            "description": "User-defined properties to be stored with the filesystem, 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.",
             "in": "header",
             "required": false,
             "type": "string"
@@ -378,7 +378,7 @@
         "parameters": [
           {
             "name": "x-ms-properties",
-            "description": "Optional. User-defined properties to be stored with the filesystem, in the format of a comma-separated list of name and value pairs \"n1=v1, n2=v2, ...\", where each value is base64 encoded.  If the filesystem exists, any properties not included in the list will be removed.  All properties are removed if the header is omitted.  To merge new and existing properties, first get all existing properties and the current E-Tag, then make a conditional request with the E-Tag and include values for all properties.",
+            "description": "Optional. User-defined properties to be stored with the filesystem, 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.  If the filesystem exists, any properties not included in the list will be removed.  All properties are removed if the header is omitted.  To merge new and existing properties, first get all existing properties and the current E-Tag, then make a conditional request with the E-Tag and include values for all properties.",
             "in": "header",
             "required": false,
             "type": "string"
@@ -482,7 +482,7 @@
           {
             "name": "upn",
             "in": "query",
-            "description": "Optional. Valid only when Hierarchical Namespace is enabled for the account. If \"true\", the identity values returned in the owner and group fields of each list entry will be transformed from Azure Active Directory Object IDs to User Principal Names.  If \"false\", the values will be returned as Azure Active Directory Object IDs. The default value is false.",
+            "description": "Optional. Valid only when Hierarchical Namespace is enabled for the account. If \"true\", the user identity values returned in the owner and group fields of each list entry will be transformed from Azure Active Directory Object IDs to User Principal Names.  If \"false\", the values will be returned as Azure Active Directory Object IDs. The default value is false. Note that group and application Object IDs are not translated because they do not have unique friendly names.",
             "required": false,
             "type": "boolean"
           }
@@ -521,7 +521,7 @@
                 "type": "string"
               },
               "x-ms-properties": {
-                "description": "The user-defined properties associated with the filesystem.  A comma-separated list of name and value pairs in the format \"n1=v1, n2=v2, ...\", where each value is base64 encoded.",
+                "description": "The user-defined properties associated with the filesystem.  A comma-separated list of name and value pairs in the format \"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-namespace-enabled": {
@@ -587,7 +587,7 @@
           "name": "filesystem",
           "in": "path",
           "description": "The filesystem identifier.  The value must start and end with a letter or number and must contain only letters, numbers, and the dash (-) character.  Consecutive dashes are not permitted.  All letters must be lowercase.  The value must have between 3 and 63 characters.",
-          "pattern": "^[a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$",
+          "pattern": "^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$",
           "minLength": 3,
           "maxLength": 63,
           "required": true,
@@ -792,7 +792,7 @@
           {
             "name": "x-ms-rename-source",
             "in": "header",
-            "description": "An optional file or directory to be renamed.  The value must have the following format: \"/{filesystem}/{path}\".  If \"x-ms-properties\" is specified, the properties will overwrite the existing properties; otherwise, the existing properties will be preserved.",
+            "description": "An optional file or directory to be renamed.  The value must have the following format: \"/{filesystem}/{path}\".  If \"x-ms-properties\" is specified, the properties will overwrite the existing properties; otherwise, the existing properties will be preserved. This value must be a URL percent-encoded string. Note that the string may only contain ASCII characters in the ISO-8859-1 character set.",
             "required": false,
             "type": "string"
           },
@@ -814,7 +814,7 @@
           },
           {
             "name": "x-ms-properties",
-            "description": "Optional.  User-defined properties to be stored 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 base64 encoded.",
+            "description": "Optional.  User-defined properties to be stored 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.",
             "in": "header",
             "required": false,
             "type": "string"
@@ -952,7 +952,7 @@
                 "type": "string"
               },
               "x-ms-properties": {
-                "description": "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 base64 encoded.",
+                "description": "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-request-id": {
@@ -1021,6 +1021,13 @@
             "required": false,
             "type": "boolean"
           },
+          {
+            "name": "close",
+            "in": "query",
+            "description": "Azure Storage Events allow applications to receive notifications when files change. When Azure Storage Events are enabled, a file changed event is raised. This event has a property indicating whether this is the final change to distinguish the difference between an intermediate flush to a file stream and the final close of a file stream. The close query parameter is valid only when the action is \"flush\" and change notifications are enabled. If the value of close is \"true\" and the flush operation completes successfully, the service raises a file change notification with a property indicating that this is the final update (the file stream has been closed). If \"false\" a change notification is raised indicating the file has changed. The default is false. This query parameter is set to true by the Hadoop ABFS driver to indicate that the file stream has been closed.\"",
+            "required": false,
+            "type": "boolean"
+          },
           {
             "name": "Content-Length",
             "in": "header",
@@ -1075,7 +1082,7 @@
           },
           {
             "name": "x-ms-properties",
-            "description": "Optional.  User-defined properties to be stored 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 base64 encoded.  Valid only for the setProperties operation.  If the file or directory exists, any properties not included in the list will be removed.  All properties are removed if the header is omitted.  To merge new and existing properties, first get all existing properties and the current E-Tag, then make a conditional request with the E-Tag and include values for all properties.",
+            "description": "Optional.  User-defined properties to be stored 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. Valid only for the setProperties operation. If the file or directory exists, any properties not included in the list will be removed.  All properties are removed if the header is omitted.  To merge new and existing properties, first get all existing properties and the current E-Tag, then make a conditional request with the E-Tag and include values for all properties.",
             "in": "header",
             "required": false,
             "type": "string"
@@ -1404,7 +1411,7 @@
                 "type": "string"
               },
               "x-ms-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 base64 encoded.",
+                "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-lease-duration": {
@@ -1486,7 +1493,7 @@
                 "type": "string"
               },
               "x-ms-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 base64 encoded.",
+                "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-lease-duration": {
@@ -1626,7 +1633,7 @@
                 "type": "string"
               },
               "x-ms-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 base64 encoded.",
+                "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": {
@@ -1682,7 +1689,7 @@
           {
             "name": "upn",
             "in": "query",
-            "description": "Optional. Valid only when Hierarchical Namespace is enabled for the account. If \"true\", the identity values returned in the x-ms-owner, x-ms-group, and x-ms-acl response headers will be transformed from Azure Active Directory Object IDs to User Principal Names.  If \"false\", the values will be returned as Azure Active Directory Object IDs. The default value is false.",
+            "description": "Optional. Valid only when Hierarchical Namespace is enabled for the account. If \"true\", the user identity values returned in the x-ms-owner, x-ms-group, and x-ms-acl response headers will be transformed from Azure Active Directory Object IDs to User Principal Names.  If \"false\", the values will be returned as Azure Active Directory Object IDs. The default value is false. Note that group and application Object IDs are not translated because they do not have unique friendly names.",
             "required": false,
             "type": "boolean"
           },
@@ -1816,7 +1823,7 @@
           "name": "filesystem",
           "in": "path",
           "description": "The filesystem identifier.",
-          "pattern": "^[a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$",
+          "pattern": "^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$",
           "minLength": 3,
           "maxLength": 63,
           "required": true,

diff --git a/specification/storage/data-plane/readme.go.md b/specification/storage/data-plane/readme.go.md
@@ -23,7 +23,7 @@ These settings apply only when `--tag=package-2018-11 --go` is specified on the
 Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.
 
 ``` yaml $(tag) == 'package-2018-11' && $(go)
-output-folder: $(go-sdk-folder)/services/stable/storage/datalake/2018-11-09/$(namespace)
+output-folder: $(go-sdk-folder)/services/storage/datalake/2018-11-09/$(namespace)
 ```
 
 ### Tag:  package-2018-06-preview and go
@@ -33,4 +33,4 @@ Please also specify `--go-sdk-folder=<path to the root directory of your azure-s
 
 ``` yaml $(tag) == 'package-2018-06-preview' && $(go)
 output-folder: $(go-sdk-folder)/services/preview/storage/datalake/2018-06-17/$(namespace)
-```
+```