ADL Update for catalog and filesystem (#391)

* Need to make contents required since this is a PUT.

Will add extensions that make it optional in C# and zero it out to an
empty stream.

* update documentation to reflect param required

* undo this temp change

Issue: Azure/autorest#884 is tracking support
for this being an optional param properly and not resulting in a null
reference. So I will keep this spec as is.

* temp commit to remove the required flag

We need a way to have template parameters not be required when they are
in the host. I will work with Amar for this next week.

* Revert "temp commit to remove the required flag"

This reverts commit be8b7bf.

* Work around for issue: 903

explicitly calling out our chunked transfer APIs until issue:
Azure/autorest#903 is resolved.

* Add missing method to delete all secrets in db

In hyak, we could do this by simply excluding the parameter. That is not
swagger compliant, so we need a separate entry.

* Test out composites.

* Remove composite specs since they don't work

* update the required piece.

* Try nesting again.

* Removing get/set from descriptions

latest generation tool automatically adds it.

* Fixed to not remove "Gets " from method descript

* Add the get back to globals.

* make typefieldinfo an array.

* Adding offset support for append operations

This is an optional value used for unique implementations that know
exactly where in the stream they want to begin appending data.

* Add file already exists exception for webhdfs

* Add BadOffsetException to swagger.

* Fix issues with bad rebase

had to copy back from azure and make the minor edits to these two .json
files.

arm-datalake-analytics/catalog/2015-10-01-preview/swagger/catalog.json

@@ -2304,7 +2304,11 @@
       ],
       "properties": {
         "columns": {
-          "$ref": "#/definitions/TypeFieldInfo",
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/TypeFieldInfo"
+          },
           "description": "the type field information associated with this table type."
         }
       },

arm-datalake-store/filesystem/2015-10-01-preview/swagger/filesystem.json

@@ -517,6 +517,14 @@
             "required": true,
             "description": "The file contents to include when appending to the file."
           },
+          {
+            "name": "offset",
+            "in": "query",
+            "required": false,
+            "type": "integer",
+            "format": "int64",
+            "description": "The optional offset in the stream to begin the append operation. Default is to append at the end of the stream."
+          },
           {
             "name": "op",
             "in": "query",
@@ -1354,6 +1362,24 @@
       ],
       "description": "A WebHDFS exception thrown indicating the file or folder could not be found. Thrown when a 404 error response code is returned (not found)."
     },
+    "AdlsFileAlreadyExistsException": {
+      "x-ms-discriminator-value": "FileAlreadyExistsException",
+      "allOf": [ 
+        { 
+          "$ref":  "#/definitions/AdlsRemoteException" 
+        } 
+      ],
+      "description": "A WebHDFS exception thrown indicating the file or folder already exists. Thrown when a 403 error response code is returned (forbidden)."
+    },
+    "AdlsBadOffsetException": {
+      "x-ms-discriminator-value": "BadOffsetException",
+      "allOf": [ 
+        { 
+          "$ref":  "#/definitions/AdlsRemoteException" 
+        } 
+      ],
+      "description": "A WebHDFS exception thrown indicating the append or read is from a bad offset. Thrown when a 400 error response code is returned for append and open operations (Bad request)."
+    },
     "AdlsRuntimeException": {
       "x-ms-discriminator-value": "RuntimeException",
       "allOf": [