hadoop-common-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From z..@apache.org
Subject [23/50] [abbrv] hadoop git commit: HDFS-7668. Convert site documentation from apt to markdown (Masatake Iwasaki via aw)
Date Mon, 16 Feb 2015 18:31:30 GMT
http://git-wip-us.apache.org/repos/asf/hadoop/blob/a45ef2b6/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
----------------------------------------------------------------------
diff --git a/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm b/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
deleted file mode 100644
index 3668286..0000000
--- a/hadoop-hdfs-project/hadoop-hdfs/src/site/apt/WebHDFS.apt.vm
+++ /dev/null
@@ -1,2628 +0,0 @@
-~~ Licensed under the Apache License, Version 2.0 (the "License");
-~~ you may not use this file except in compliance with the License.
-~~ You may obtain a copy of the License at
-~~
-~~   http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing, software
-~~ distributed under the License is distributed on an "AS IS" BASIS,
-~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-~~ See the License for the specific language governing permissions and
-~~ limitations under the License. See accompanying LICENSE file.
-
-  ---
-  Hadoop Distributed File System-${project.version} - WebHDFS REST API
-  ---
-  ---
-  ${maven.build.timestamp}
-
-WebHDFS REST API
-
-%{toc|section=1|fromDepth=0}
-
-* {Document Conventions}
-
-*----------------------+-------------------------------------------------------------------------------+
-| <<<Monospaced>>>     | Used for commands, HTTP request and responses and code blocks.                |
-*----------------------+-------------------------------------------------------------------------------+
-| <<<\<Monospaced\>>>> | User entered values.                                                          |
-*----------------------+-------------------------------------------------------------------------------+
-| <<<[Monospaced]>>>   | Optional values.  When the value is not specified, the default value is used. |
-*----------------------+-------------------------------------------------------------------------------+
-| <Italics>            | Important phrases and words.                                                  |
-*----------------------+-------------------------------------------------------------------------------+
-
-
-* {Introduction}
-
-  The HTTP REST API supports the complete
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}/{{{../../api/org/apache/hadoop/fs/FileContext.html}FileContext}}
-  interface for HDFS.
-  The operations and the corresponding FileSystem/FileContext methods are shown in the next section.
-  The Section {{HTTP Query Parameter Dictionary}} specifies the parameter details
-  such as the defaults and the valid values.
-
-** {Operations}
-
-  * HTTP GET
-
-    * {{{Open and Read a File}<<<OPEN>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.open)
-
-    * {{{Status of a File/Directory}<<<GETFILESTATUS>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getFileStatus)
-
-    * {{{List a Directory}<<<LISTSTATUS>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.listStatus)
-
-    * {{{Get Content Summary of a Directory}<<<GETCONTENTSUMMARY>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getContentSummary)
-
-    * {{{Get File Checksum}<<<GETFILECHECKSUM>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getFileChecksum)
-
-    * {{{Get Home Directory}<<<GETHOMEDIRECTORY>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getHomeDirectory)
-
-    * {{{Get Delegation Token}<<<GETDELEGATIONTOKEN>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getDelegationToken)
-
-    * {{{Get Delegation Tokens}<<<GETDELEGATIONTOKENS>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getDelegationTokens)
-
-    * {{{Get an XAttr}<<<GETXATTRS>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getXAttr)
-
-    * {{{Get multiple XAttrs}<<<GETXATTRS>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getXAttrs)
-
-    * {{{Get all XAttrs}<<<GETXATTRS>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getXAttrs)
-
-    * {{{List all XAttrs}<<<LISTXATTRS>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.listXAttrs)
-
-    * {{{Check access}<<<CHECKACCESS>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.access)
-
-  * HTTP PUT
-
-    * {{{Create and Write to a File}<<<CREATE>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.create)
-
-    * {{{Make a Directory}<<<MKDIRS>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.mkdirs)
-
-    * {{{Create a Symbolic Link}<<<CREATESYMLINK>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileContext.html}FileContext}}.createSymlink)
-
-    * {{{Rename a File/Directory}<<<RENAME>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.rename)
-
-    * {{{Set Replication Factor}<<<SETREPLICATION>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.setReplication)
-
-    * {{{Set Owner}<<<SETOWNER>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.setOwner)
-
-    * {{{Set Permission}<<<SETPERMISSION>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.setPermission)
-
-    * {{{Set Access or Modification Time}<<<SETTIMES>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.setTimes)
-
-    * {{{Renew Delegation Token}<<<RENEWDELEGATIONTOKEN>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.renewDelegationToken)
-
-    * {{{Cancel Delegation Token}<<<CANCELDELEGATIONTOKEN>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.cancelDelegationToken)
-
-    * {{{Create Snapshot}<<<CREATESNAPSHOT>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.createSnapshot)
-
-    * {{{Rename Snapshot}<<<RENAMESNAPSHOT>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.renameSnapshot)
-
-    * {{{Set XAttr}<<<SETXATTR>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.setXAttr)
-
-    * {{{Remove XAttr}<<<REMOVEXATTR>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.removeXAttr)
-
-  * HTTP POST
-
-    * {{{Append to a File}<<<APPEND>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.append)
-
-    * {{{Concat File(s)}<<<CONCAT>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.concat)
-
-    * {{{Truncate a File}<<<TRUNCATE>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.truncate)
-
-  * HTTP DELETE
-
-    * {{{Delete a File/Directory}<<<DELETE>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.delete)
- 
-    * {{{Delete Snapshot}<<<DELETESNAPSHOT>>>}}
-        (see  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.deleteSnapshot)
-
-** {FileSystem URIs vs HTTP URLs}
-
-  The FileSystem scheme of WebHDFS is "<<<webhdfs://>>>".
-  A WebHDFS FileSystem URI has the following format.
-
-+---------------------------------
-  webhdfs://<HOST>:<HTTP_PORT>/<PATH>
-+---------------------------------
-
-  The above WebHDFS URI corresponds to the below HDFS URI.
-
-+---------------------------------
-  hdfs://<HOST>:<RPC_PORT>/<PATH>
-+---------------------------------
-
-  In the REST API, the prefix "<<</webhdfs/v1>>>" is inserted in the path and a query is appended at the end.
-  Therefore, the corresponding HTTP URL has the following format.
-
-+---------------------------------
-  http://<HOST>:<HTTP_PORT>/webhdfs/v1/<PATH>?op=...
-+---------------------------------
-
-** {HDFS Configuration Options}
-
-  Below are the HDFS configuration options for WebHDFS.
-
-*-------------------------------------------------+---------------------------------------------------+
-|| Property Name	                          || Description                                      |
-*-------------------------------------------------+---------------------------------------------------+
-| <<<dfs.webhdfs.enabled                      >>> | Enable/disable WebHDFS in Namenodes and Datanodes |
-*-------------------------------------------------+---------------------------------------------------+
-| <<<dfs.web.authentication.kerberos.principal>>> | The HTTP Kerberos principal used by Hadoop-Auth in the HTTP endpoint. The HTTP Kerberos principal MUST start with 'HTTP/' per Kerberos HTTP SPNEGO specification.  A value of "*" will use all HTTP principals found in the keytab. |
-*-------------------------------------------------+---------------------------------------------------+
-| <<<dfs.web.authentication.kerberos.keytab   >>> | The Kerberos keytab file with the credentials for the HTTP Kerberos principal used by Hadoop-Auth in the HTTP endpoint. |
-*-------------------------------------------------+---------------------------------------------------+
-
-* {Authentication}
-
-  When security is <off>, the authenticated user is the username specified in the <<<user.name>>> query parameter.
-  If the <<<user.name>>> parameter is not set,
-  the server may either set the authenticated user to a default web user, if there is any, or return an error response.
-
-
-  When security is <on>, authentication is performed by either Hadoop delegation token or Kerberos SPNEGO.
-  If a token is set in the <<<delegation>>> query parameter, the authenticated user is the user encoded in the token.
-  If the <<<delegation>>> parameter is not set, the user is authenticated by Kerberos SPNEGO.
-
-
-  Below are examples using the <<<curl>>> command tool.
-
-  [[1]] Authentication when security is off:
-
-+---------------------------------
-curl -i "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?[user.name=<USER>&]op=..."
-+---------------------------------
- 
-  [[1]] Authentication using Kerberos SPNEGO when security is on:
-
-+---------------------------------
-curl -i --negotiate -u : "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=..."
-+---------------------------------
- 
-  [[1]] Authentication using Hadoop delegation token when security is on:
-
-+---------------------------------
-curl -i "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?delegation=<TOKEN>&op=..."
-+---------------------------------
-
-  []
- 
-  See also: {{{../hadoop-common/HttpAuthentication.html}Authentication for Hadoop HTTP web-consoles}}
-
-* {Proxy Users}
-
-  When the proxy user feature is enabled, a proxy user <P> may submit a request on behalf of another user <U>.
-  The username of <U> must be specified in the <<<doas>>> query parameter unless a delegation token is presented in authentication.
-  In such case, the information of both users <P> and <U> must be encoded in the delegation token.
-
-  [[1]] A proxy request when security is off:
-
-+---------------------------------
-curl -i "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?[user.name=<USER>&]doas=<USER>&op=..."
-+---------------------------------
-
-  [[1]] A proxy request using Kerberos SPNEGO when security is on:
-
-+---------------------------------
-curl -i --negotiate -u : "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?doas=<USER>&op=..."
-+---------------------------------
-
-  [[1]] A proxy request using Hadoop delegation token when security is on:
-
-+---------------------------------
-curl -i "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?delegation=<TOKEN>&op=..."
-+---------------------------------
-
-
-* {File and Directory Operations}
-
-** {Create and Write to a File}
-
-  * Step 1: Submit a HTTP PUT request without automatically following redirects and without sending the file data.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=CREATE
-                    [&overwrite=<true|false>][&blocksize=<LONG>][&replication=<SHORT>]
-                    [&permission=<OCTAL>][&buffersize=<INT>]"
-+---------------------------------
-
-  The request is redirected to a datanode where the file data is to be written:
-
-+---------------------------------
-HTTP/1.1 307 TEMPORARY_REDIRECT
-Location: http://<DATANODE>:<PORT>/webhdfs/v1/<PATH>?op=CREATE...
-Content-Length: 0
-+---------------------------------
-
-  * Step 2: Submit another HTTP PUT request using the URL in the <<<Location>>> header with the file data to be written.
-
-+---------------------------------
-curl -i -X PUT -T <LOCAL_FILE> "http://<DATANODE>:<PORT>/webhdfs/v1/<PATH>?op=CREATE..."
-+---------------------------------
-
-  The client receives a <<<201 Created>>> response with zero content length
-  and the WebHDFS URI of the file in the <<<Location>>> header:
-
-+---------------------------------
-HTTP/1.1 201 Created
-Location: webhdfs://<HOST>:<PORT>/<PATH>
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  <<Note>> that the reason of having two-step create/append is
-  for preventing clients to send out data before the redirect.
-  This issue is addressed by the "<<<Expect: 100-continue>>>" header in HTTP/1.1;
-  see {{{http://www.w3.org/Protocols/rfc2616/rfc2616-sec8.html#sec8.2.3}RFC 2616, Section 8.2.3}}.
-  Unfortunately, there are software library bugs (e.g. Jetty 6 HTTP server and Java 6 HTTP client),
-  which do not correctly implement "<<<Expect: 100-continue>>>".
-  The two-step create/append is a temporary workaround for the software library bugs.
-
-  See also:
-  {{{Overwrite}<<<overwrite>>>}},
-  {{{Block Size}<<<blocksize>>>}},
-  {{{Replication}<<<replication>>>}},
-  {{{Permission}<<<permission>>>}},
-  {{{Buffer Size}<<<buffersize>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.create
-
-
-** {Append to a File}
-
-  * Step 1: Submit a HTTP POST request without automatically following redirects and without sending the file data.
-
-+---------------------------------
-curl -i -X POST "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=APPEND[&buffersize=<INT>]"
-+---------------------------------
-
-  The request is redirected to a datanode where the file data is to be appended:
-
-+---------------------------------
-HTTP/1.1 307 TEMPORARY_REDIRECT
-Location: http://<DATANODE>:<PORT>/webhdfs/v1/<PATH>?op=APPEND...
-Content-Length: 0
-+---------------------------------
-
-  * Step 2: Submit another HTTP POST request using the URL in the <<<Location>>> header with the file data to be appended.
-
-+---------------------------------
-curl -i -X POST -T <LOCAL_FILE> "http://<DATANODE>:<PORT>/webhdfs/v1/<PATH>?op=APPEND..."
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See the note in the previous section for the description of why this operation requires two steps.
-
-  See also:
-  {{{Buffer Size}<<<buffersize>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.append
-
-
-** {Concat File(s)}
-
-  * Submit a HTTP POST request.
-
-+---------------------------------
-curl -i -X POST "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=CONCAT&sources=<PATHS>"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Sources}<<<sources>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.concat
-
-
-** {Open and Read a File}
-
-  * Submit a HTTP GET request with automatically following redirects.
-
-+---------------------------------
-curl -i -L "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=OPEN
-                    [&offset=<LONG>][&length=<LONG>][&buffersize=<INT>]"
-+---------------------------------
-
-  The request is redirected to a datanode where the file data can be read:
-
-+---------------------------------
-HTTP/1.1 307 TEMPORARY_REDIRECT
-Location: http://<DATANODE>:<PORT>/webhdfs/v1/<PATH>?op=OPEN...
-Content-Length: 0
-+---------------------------------
-
-  The client follows the redirect to the datanode and receives the file data:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/octet-stream
-Content-Length: 22
-
-Hello, webhdfs user!
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Offset}<<<offset>>>}},
-  {{{Length}<<<length>>>}},
-  {{{Buffer Size}<<<buffersize>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.open
-
-
-** {Make a Directory}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=MKDIRS[&permission=<OCTAL>]"
-+---------------------------------
-
-  The client receives a response with a {{{Boolean JSON Schema}<<<boolean>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{"boolean": true}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Permission}<<<permission>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.mkdirs
-
-
-** {Create a Symbolic Link}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=CREATESYMLINK
-                              &destination=<PATH>[&createParent=<true|false>]"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Destination}<<<destination>>>}},
-  {{{Create Parent}<<<createParent>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.createSymlink
-
-
-** {Rename a File/Directory}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "<HOST>:<PORT>/webhdfs/v1/<PATH>?op=RENAME&destination=<PATH>"
-+---------------------------------
-
-  The client receives a response with a {{{Boolean JSON Schema}<<<boolean>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{"boolean": true}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Destination}<<<destination>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.rename
-
-
-** {Delete a File/Directory}
-
-  * Submit a HTTP DELETE request.
-
-+---------------------------------
-curl -i -X DELETE "http://<host>:<port>/webhdfs/v1/<path>?op=DELETE
-                              [&recursive=<true|false>]"
-+---------------------------------
-
-  The client receives a response with a {{{Boolean JSON Schema}<<<boolean>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{"boolean": true}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Recursive}<<<recursive>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.delete
-
-
-** {Truncate a File}
-
-  * Submit a HTTP POST request.
-
-+---------------------------------
-curl -i -X POST "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=TRUNCATE&newlength=<LONG>"
-+---------------------------------
-
-  The client receives a response with a {{{Boolean JSON Schema}<<<boolean>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{"boolean": true}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{New Length}<<<newlength>>>}},
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.truncate
-
-
-** {Status of a File/Directory}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i  "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=GETFILESTATUS"
-+---------------------------------
-
-  The client receives a response with a {{{FileStatus JSON Schema}<<<FileStatus>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-  "FileStatus":
-  {
-    "accessTime"      : 0,
-    "blockSize"       : 0,
-    "childrenNum"     : 1,
-    "fileId"          : 16386,
-    "group"           : "supergroup",
-    "length"          : 0,             //in bytes, zero for directories
-    "modificationTime": 1320173277227,
-    "owner"           : "webuser",
-    "pathSuffix"      : "",
-    "permission"      : "777",
-    "replication"     : 0,
-    "type"            : "DIRECTORY"    //enum {FILE, DIRECTORY, SYMLINK}
-  }
-}
-+---------------------------------
-
-  []
-
-  See also:
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getFileStatus
-
-
-** {List a Directory}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i  "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=LISTSTATUS"
-+---------------------------------
-
-  The client receives a response with a {{{FileStatuses JSON Schema}<<<FileStatuses>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Length: 427
-
-{
-  "FileStatuses":
-  {
-    "FileStatus":
-    [
-      {
-        "accessTime"      : 1320171722771,
-        "blockSize"       : 33554432,
-        "childrenNum"     : 0,
-        "fileId"          : 16387,
-        "group"           : "supergroup",
-        "length"          : 24930,
-        "modificationTime": 1320171722771,
-        "owner"           : "webuser",
-        "pathSuffix"      : "a.patch",
-        "permission"      : "644",
-        "replication"     : 1,
-        "type"            : "FILE"
-      },
-      {
-        "accessTime"      : 0,
-        "blockSize"       : 0,
-        "childrenNum"     : 2,
-        "fileId"          : 16388,
-        "group"           : "supergroup",
-        "length"          : 0,
-        "modificationTime": 1320895981256,
-        "owner"           : "szetszwo",
-        "pathSuffix"      : "bar",
-        "permission"      : "711",
-        "replication"     : 0,
-        "type"            : "DIRECTORY"
-      },
-      ...
-    ]
-  }
-}
-+---------------------------------
-
-  []
-
-  See also:
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.listStatus
-
-
-* {Other File System Operations}
-
-** {Get Content Summary of a Directory}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=GETCONTENTSUMMARY"
-+---------------------------------
-
-  The client receives a response with a {{{ContentSummary JSON Schema}<<<ContentSummary>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-  "ContentSummary":
-  {
-    "directoryCount": 2,
-    "fileCount"     : 1,
-    "length"        : 24930,
-    "quota"         : -1,
-    "spaceConsumed" : 24930,
-    "spaceQuota"    : -1
-  }
-}
-+---------------------------------
-
-  []
-
-  See also:
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getContentSummary
-
-
-** {Get File Checksum}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=GETFILECHECKSUM"
-+---------------------------------
-
-  The request is redirected to a datanode:
-
-+---------------------------------
-HTTP/1.1 307 TEMPORARY_REDIRECT
-Location: http://<DATANODE>:<PORT>/webhdfs/v1/<PATH>?op=GETFILECHECKSUM...
-Content-Length: 0
-+---------------------------------
-
-  The client follows the redirect to the datanode and receives a {{{FileChecksum JSON Schema}<<<FileChecksum>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-  "FileChecksum":
-  {
-    "algorithm": "MD5-of-1MD5-of-512CRC32",
-    "bytes"    : "eadb10de24aa315748930df6e185c0d ...",
-    "length"   : 28
-  }
-}
-+---------------------------------
-
-  []
-
-  See also:
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getFileChecksum
-
-
-** {Get Home Directory}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i "http://<HOST>:<PORT>/webhdfs/v1/?op=GETHOMEDIRECTORY"
-+---------------------------------
-
-  The client receives a response with a {{{Path JSON Schema}<<<Path>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{"Path": "/user/szetszwo"}
-+---------------------------------
-
-  []
-
-  See also:
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getHomeDirectory
-
-
-** {Set Permission}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=SETPERMISSION
-                              [&permission=<OCTAL>]"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Permission}<<<permission>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.setPermission
-
-
-** {Set Owner}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=SETOWNER
-                              [&owner=<USER>][&group=<GROUP>]"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Owner}<<<owner>>>}},
-  {{{Group}<<<group>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.setOwner
-
-
-** {Set Replication Factor}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=SETREPLICATION
-                              [&replication=<SHORT>]"
-+---------------------------------
-
-  The client receives a response with a {{{Boolean JSON Schema}<<<boolean>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{"boolean": true}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Replication}<<<replication>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.setReplication
-
-
-** {Set Access or Modification Time}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=SETTIMES
-                              [&modificationtime=<TIME>][&accesstime=<TIME>]"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Modification Time}<<<modificationtime>>>}},
-  {{{Access Time}<<<accesstime>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.setTimes
-
-
-** {Modify ACL Entries}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=MODIFYACLENTRIES
-                              &aclspec=<ACLSPEC>"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.modifyAclEntries
-
-
-** {Remove ACL Entries}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=REMOVEACLENTRIES
-                              &aclspec=<ACLSPEC>"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.removeAclEntries
-
-
-** {Remove Default ACL}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=REMOVEDEFAULTACL"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.removeDefaultAcl
-
-
-** {Remove ACL}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=REMOVEACL"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.removeAcl
-
-
-** {Set ACL}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=SETACL
-                              &aclspec=<ACLSPEC>"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.setAcl
-
-
-** {Get ACL Status}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=GETACLSTATUS"
-+---------------------------------
-
-  The client receives a response with a {{{ACL Status JSON Schema}<<<AclStatus>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-    "AclStatus": {
-        "entries": [
-            "user:carla:rw-", 
-            "group::r-x"
-        ], 
-        "group": "supergroup", 
-        "owner": "hadoop", 
-        "permission":"775",
-        "stickyBit": false
-    }
-}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getAclStatus
-
-
-** {Check access}
-
-  * Submit a HTTP GET request.
-  
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=CHECKACCESS
-                              &fsaction=<FSACTION>
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.access
-    
-
-* {Extended Attributes(XAttrs) Operations}
-
-** {Set XAttr}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=SETXATTR
-                              &xattr.name=<XATTRNAME>&xattr.value=<XATTRVALUE>
-                              &flag=<FLAG>"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.setXAttr
-
-
-** {Remove XAttr}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=REMOVEXATTR
-                              &xattr.name=<XATTRNAME>"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.removeXAttr
-
-
-** {Get an XAttr}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=GETXATTRS
-                              &xattr.name=<XATTRNAME>&encoding=<ENCODING>"
-+---------------------------------
-
-  The client receives a response with a {{{XAttrs JSON Schema}<<<XAttrs>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-    "XAttrs": [
-        {
-            "name":"XATTRNAME",
-            "value":"XATTRVALUE"
-        }
-    ]
-}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getXAttr
-
-
-** {Get multiple XAttrs}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=GETXATTRS
-                              &xattr.name=<XATTRNAME1>&xattr.name=<XATTRNAME2>
-                              &encoding=<ENCODING>"
-+---------------------------------
-
-  The client receives a response with a {{{XAttrs JSON Schema}<<<XAttrs>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-    "XAttrs": [
-        {
-            "name":"XATTRNAME1",
-            "value":"XATTRVALUE1"
-        },
-        {
-            "name":"XATTRNAME2",
-            "value":"XATTRVALUE2"
-        }
-    ]
-}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getXAttrs
-
-
-** {Get all XAttrs}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=GETXATTRS
-                              &encoding=<ENCODING>"
-+---------------------------------
-
-  The client receives a response with a {{{XAttrs JSON Schema}<<<XAttrs>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-    "XAttrs": [
-        {
-            "name":"XATTRNAME1",
-            "value":"XATTRVALUE1"
-        },
-        {
-            "name":"XATTRNAME2",
-            "value":"XATTRVALUE2"
-        },
-        {
-            "name":"XATTRNAME3",
-            "value":"XATTRVALUE3"
-        }
-    ]
-}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getXAttrs
-
-
-** {List all XAttrs}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=LISTXATTRS"
-+---------------------------------
-
-  The client receives a response with a {{{XAttrNames JSON Schema}<<<XAttrNames>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-    "XAttrNames":"[\"XATTRNAME1\",\"XATTRNAME2\",\"XATTRNAME3\"]"
-}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.listXAttrs
-
-
-* {Snapshot Operations}
-
-** {Create Snapshot}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=CREATESNAPSHOT[&snapshotname=<SNAPSHOTNAME>]"
-+---------------------------------
-
-  The client receives a response with a {{{Path JSON Schema}<<<Path>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{"Path": "/user/szetszwo/.snapshot/s1"}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.createSnapshot
-
-
-** {Delete Snapshot}
-
-  * Submit a HTTP DELETE request.
-
-+---------------------------------
-curl -i -X DELETE "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=DELETESNAPSHOT&snapshotname=<SNAPSHOTNAME>"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.deleteSnapshot
-
-
-** {Rename Snapshot}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=RENAMESNAPSHOT
-                   &oldsnapshotname=<SNAPSHOTNAME>&snapshotname=<SNAPSHOTNAME>"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.renameSnapshot
-
-
-* {Delegation Token Operations}
-
-** {Get Delegation Token}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i "http://<HOST>:<PORT>/webhdfs/v1/?op=GETDELEGATIONTOKEN&renewer=<USER>&service=<SERVICE>&kind=<KIND>"
-+---------------------------------
-
-  The client receives a response with a {{{Token JSON Schema}<<<Token>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-  "Token":
-  {
-    "urlString": "JQAIaG9y..."
-  }
-}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Renewer}<<<renewer>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getDelegationToken,
-  {{{Token Kind}<<<kind>>>}},
-  {{{Token Service}<<<service>>>}}
-
-
-
-** {Get Delegation Tokens}
-
-  * Submit a HTTP GET request.
-
-+---------------------------------
-curl -i "http://<HOST>:<PORT>/webhdfs/v1/?op=GETDELEGATIONTOKENS&renewer=<USER>"
-+---------------------------------
-
-  The client receives a response with a {{{Tokens JSON Schema}<<<Tokens>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-  "Tokens":
-  {
-    "Token":
-    [
-      {
-        "urlString":"KAAKSm9i ..."
-      }
-    ]
-  }
-}
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Renewer}<<<renewer>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.getDelegationTokens
-
-
-** {Renew Delegation Token}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/?op=RENEWDELEGATIONTOKEN&token=<TOKEN>"
-+---------------------------------
-
-  The client receives a response with a {{{Long JSON Schema}<<<long>>> JSON object}}:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{"long": 1320962673997}           //the new expiration time
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Token}<<<token>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.renewDelegationToken
-
-
-** {Cancel Delegation Token}
-
-  * Submit a HTTP PUT request.
-
-+---------------------------------
-curl -i -X PUT "http://<HOST>:<PORT>/webhdfs/v1/?op=CANCELDELEGATIONTOKEN&token=<TOKEN>"
-+---------------------------------
-
-  The client receives a response with zero content length:
-
-+---------------------------------
-HTTP/1.1 200 OK
-Content-Length: 0
-+---------------------------------
-
-  []
-
-  See also:
-  {{{Token}<<<token>>>}},
-   {{{../../api/org/apache/hadoop/fs/FileSystem.html}FileSystem}}.cancelDelegationToken
-
-
-* {Error Responses}
-
-  When an operation fails, the server may throw an exception.
-  The JSON schema of error responses is defined in {{RemoteException JSON Schema}}.
-  The table below shows the mapping from exceptions to HTTP response codes.
-
-** {HTTP Response Codes}
-
-*-------------------------------------+---------------------------------+
-|| Exceptions                         || HTTP Response Codes            |
-*-------------------------------------+---------------------------------+
-| <<<IllegalArgumentException     >>> | <<<400 Bad Request          >>> |
-*-------------------------------------+---------------------------------+
-| <<<UnsupportedOperationException>>> | <<<400 Bad Request          >>> |
-*-------------------------------------+---------------------------------+
-| <<<SecurityException            >>> | <<<401 Unauthorized         >>> |
-*-------------------------------------+---------------------------------+
-| <<<IOException                  >>> | <<<403 Forbidden            >>> |
-*-------------------------------------+---------------------------------+
-| <<<FileNotFoundException        >>> | <<<404 Not Found            >>> |
-*-------------------------------------+---------------------------------+
-| <<<RumtimeException             >>> | <<<500 Internal Server Error>>> |
-*-------------------------------------+---------------------------------+
-
-  Below are examples of exception responses.
-
-*** {Illegal Argument Exception}
-
-+---------------------------------
-HTTP/1.1 400 Bad Request
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-  "RemoteException":
-  {
-    "exception"    : "IllegalArgumentException",
-    "javaClassName": "java.lang.IllegalArgumentException",
-    "message"      : "Invalid value for webhdfs parameter \"permission\": ..."
-  }
-}
-+---------------------------------
-
-
-*** {Security Exception}
-
-+---------------------------------
-HTTP/1.1 401 Unauthorized
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-  "RemoteException":
-  {
-    "exception"    : "SecurityException",
-    "javaClassName": "java.lang.SecurityException",
-    "message"      : "Failed to obtain user group information: ..."
-  }
-}
-+---------------------------------
-
-
-*** {Access Control Exception}
-
-+---------------------------------
-HTTP/1.1 403 Forbidden
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-  "RemoteException":
-  {
-    "exception"    : "AccessControlException",
-    "javaClassName": "org.apache.hadoop.security.AccessControlException",
-    "message"      : "Permission denied: ..."
-  }
-}
-+---------------------------------
-
-
-*** {File Not Found Exception}
-
-+---------------------------------
-HTTP/1.1 404 Not Found
-Content-Type: application/json
-Transfer-Encoding: chunked
-
-{
-  "RemoteException":
-  {
-    "exception"    : "FileNotFoundException",
-    "javaClassName": "java.io.FileNotFoundException",
-    "message"      : "File does not exist: /foo/a.patch"
-  }
-}
-+---------------------------------
-
-
-* {JSON Schemas}
-
-  All operations, except for {{{Open and Read a File}<<<OPEN>>>}},
-  either return a zero-length response or a JSON response. 
-  For {{{Open and Read a File}<<<OPEN>>>}}, the response is an octet-stream.
-  The JSON schemas are shown below.
-  See {{{http://tools.ietf.org/id/draft-zyp-json-schema-03.html}draft-zyp-json-schema-03}}
-  for the syntax definitions of the JSON schemas.
-
-  <<Note>> that the default value of
-  {{{http://tools.ietf.org/id/draft-zyp-json-schema-03.html#additionalProperties}<<<additionalProperties>>>}}
-  is an empty schema which allows any value for additional properties.
-  Therefore, all WebHDFS JSON responses allow any additional property.
-  However, if additional properties are included in the responses, they are
-  considered as optional properties in order to maintain compatibility.
-
-** {ACL Status JSON Schema}
-
-+---------------------------------
-{
-  "name"      : "AclStatus",
-  "properties":
-  {
-    "AclStatus":
-    {
-      "type"      : "object",
-      "properties":
-      {
-        "entries":
-        {
-          "type": "array"
-          "items":
-          {
-            "description": "ACL entry.",
-            "type": "string"
-          }
-        },
-        "group":
-        {
-          "description": "The group owner.",
-          "type"       : "string",
-          "required"   : true
-        },
-        "owner":
-        {
-          "description": "The user who is the owner.",
-          "type"       : "string",
-          "required"   : true
-        },
-        "stickyBit":
-        {
-          "description": "True if the sticky bit is on.",
-          "type"       : "boolean",
-          "required"   : true
-        },
-      }
-    }
-  }
-}
-+---------------------------------
-
-
-** {XAttrs JSON Schema}
-
-+---------------------------------
-{
-  "name"      : "XAttrs",
-  "properties":
-  {
-    "XAttrs":
-    {
-      "type"      : "array",
-      "items":
-      {
-        "type"    " "object",
-        "properties":
-        {
-          "name":
-          {
-            "description": "XAttr name.",
-            "type"       : "string",
-            "required"   : true
-          },
-          "value":
-          {
-            "description": "XAttr value.",
-            "type"       : "string"
-          }
-        }
-      }
-    }
-  }
-}
-+---------------------------------
-
-
-** {XAttrNames JSON Schema}
-
-+---------------------------------
-{
-  "name"      : "XAttrNames",
-  "properties":
-  {
-    "XAttrNames":
-    {
-      "description": "XAttr names.",
-      "type"       : "string"
-      "required"   : true
-    }
-  }
-}
-+---------------------------------
-
-
-** {Boolean JSON Schema}
-
-+---------------------------------
-{
-  "name"      : "boolean",
-  "properties":
-  {
-    "boolean":
-    {
-      "description": "A boolean value",
-      "type"       : "boolean",
-      "required"   : true
-    }
-  }
-}
-+---------------------------------
-
-  See also:
-  {{{Make a Directory}<<<MKDIRS>>>}},
-  {{{Rename a File/Directory}<<<RENAME>>>}},
-  {{{Delete a File/Directory}<<<DELETE>>>}},
-  {{{Set Replication Factor}<<<SETREPLICATION>>>}}
-
-
-** {ContentSummary JSON Schema}
-
-+---------------------------------
-{
-  "name"      : "ContentSummary",
-  "properties":
-  {
-    "ContentSummary":
-    {
-      "type"      : "object",
-      "properties":
-      {
-        "directoryCount":
-        {
-          "description": "The number of directories.",
-          "type"       : "integer",
-          "required"   : true
-        },
-        "fileCount":
-        {
-          "description": "The number of files.",
-          "type"       : "integer",
-          "required"   : true
-        },
-        "length":
-        {
-          "description": "The number of bytes used by the content.",
-          "type"       : "integer",
-          "required"   : true
-        },
-        "quota":
-        {
-          "description": "The namespace quota of this directory.",
-          "type"       : "integer",
-          "required"   : true
-        },
-        "spaceConsumed":
-        {
-          "description": "The disk space consumed by the content.",
-          "type"       : "integer",
-          "required"   : true
-        },
-        "spaceQuota":
-        {
-          "description": "The disk space quota.",
-          "type"       : "integer",
-          "required"   : true
-        }
-      }
-    }
-  }
-}
-+---------------------------------
-
-  See also:
-  {{{Get Content Summary of a Directory}<<<GETCONTENTSUMMARY>>>}}
-
-
-** {FileChecksum JSON Schema}
-
-+---------------------------------
-{
-  "name"      : "FileChecksum",
-  "properties":
-  {
-    "FileChecksum":
-    {
-      "type"      : "object",
-      "properties":
-      {
-        "algorithm":
-        {
-          "description": "The name of the checksum algorithm.",
-          "type"       : "string",
-          "required"   : true
-        },
-        "bytes":
-        {
-          "description": "The byte sequence of the checksum in hexadecimal.",
-          "type"       : "string",
-          "required"   : true
-        },
-        "length":
-        {
-          "description": "The length of the bytes (not the length of the string).",
-          "type"       : "integer",
-          "required"   : true
-        }
-      }
-    }
-  }
-}
-+---------------------------------
-
-  See also:
-  {{{Get File Checksum}<<<GETFILECHECKSUM>>>}}
-
-
-** {FileStatus JSON Schema}
-
-+---------------------------------
-{
-  "name"      : "FileStatus",
-  "properties":
-  {
-    "FileStatus": fileStatusProperties      //See FileStatus Properties
-  }
-}
-+---------------------------------
-
-  See also:
-  {{{FileStatus Properties}<<<FileStatus>>> Properties}},
-  {{{Status of a File/Directory}<<<GETFILESTATUS>>>}},
-  {{{../../api/org/apache/hadoop/fs/FileStatus.html}FileStatus}}
-
-
-*** {FileStatus Properties}
-
-  JavaScript syntax is used to define <<<fileStatusProperties>>>
-  so that it can be referred in both <<<FileStatus>>> and <<<FileStatuses>>> JSON schemas.
-
-+---------------------------------
-var fileStatusProperties =
-{
-  "type"      : "object",
-  "properties":
-  {
-    "accessTime":
-    {
-      "description": "The access time.",
-      "type"       : "integer",
-      "required"   : true
-    },
-    "blockSize":
-    {
-      "description": "The block size of a file.",
-      "type"       : "integer",
-      "required"   : true
-    },
-    "childrenNum":
-    {
-      "description": "The number of children.",
-      "type"       : "integer",
-      "required"   : true
-    },
-    "fileId":
-    {
-      "description": "The inode ID.",
-      "type"       : "integer",
-      "required"   : true
-    },
-    "group":
-    {
-      "description": "The group owner.",
-      "type"       : "string",
-      "required"   : true
-    },
-    "length":
-    {
-      "description": "The number of bytes in a file.",
-      "type"       : "integer",
-      "required"   : true
-    },
-    "modificationTime":
-    {
-      "description": "The modification time.",
-      "type"       : "integer",
-      "required"   : true
-    },
-    "owner":
-    {
-      "description": "The user who is the owner.",
-      "type"       : "string",
-      "required"   : true
-    },
-    "pathSuffix":
-    {
-      "description": "The path suffix.",
-      "type"       : "string",
-      "required"   : true
-    },
-    "permission":
-    {
-      "description": "The permission represented as a octal string.",
-      "type"       : "string",
-      "required"   : true
-    },
-    "replication":
-    {
-      "description": "The number of replication of a file.",
-      "type"       : "integer",
-      "required"   : true
-    },
-   "symlink":                                         //an optional property
-    {
-      "description": "The link target of a symlink.",
-      "type"       : "string"
-    },
-   "type":
-    {
-      "description": "The type of the path object.",
-      "enum"       : ["FILE", "DIRECTORY", "SYMLINK"],
-      "required"   : true
-    }
-  }
-};
-+---------------------------------
-
-
-** {FileStatuses JSON Schema}
-
-  A <<<FileStatuses>>> JSON object represents an array of <<<FileStatus>>> JSON objects.
-
-+---------------------------------
-{
-  "name"      : "FileStatuses",
-  "properties":
-  {
-    "FileStatuses":
-    {
-      "type"      : "object",
-      "properties":
-      {
-        "FileStatus":
-        {
-          "description": "An array of FileStatus",
-          "type"       : "array",
-          "items"      : fileStatusProperties      //See FileStatus Properties
-        }
-      }
-    }
-  }
-}
-+---------------------------------
-
-  See also:
-  {{{FileStatus Properties}<<<FileStatus>>> Properties}},
-  {{{List a Directory}<<<LISTSTATUS>>>}},
-  {{{../../api/org/apache/hadoop/fs/FileStatus.html}FileStatus}}
-
-
-** {Long JSON Schema}
-
-+---------------------------------
-{
-  "name"      : "long",
-  "properties":
-  {
-    "long":
-    {
-      "description": "A long integer value",
-      "type"       : "integer",
-      "required"   : true
-    }
-  }
-}
-+---------------------------------
-
-  See also:
-  {{{Renew Delegation Token}<<<RENEWDELEGATIONTOKEN>>>}},
-
-
-** {Path JSON Schema}
-
-+---------------------------------
-{
-  "name"      : "Path",
-  "properties":
-  {
-    "Path":
-    {
-      "description": "The string representation a Path.",
-      "type"       : "string",
-      "required"   : true
-    }
-  }
-}
-+---------------------------------
-
-  See also:
-  {{{Get Home Directory}<<<GETHOMEDIRECTORY>>>}},
-  {{{../../api/org/apache/hadoop/fs/Path.html}Path}}
-
-
-** {RemoteException JSON Schema}
-
-+---------------------------------
-{
-  "name"      : "RemoteException",
-  "properties":
-  {
-    "RemoteException":
-    {
-      "type"      : "object",
-      "properties":
-      {
-        "exception":
-        {
-          "description": "Name of the exception",
-          "type"       : "string",
-          "required"   : true
-        },
-        "message":
-        {
-          "description": "Exception message",
-          "type"       : "string",
-          "required"   : true
-        },
-        "javaClassName":                                     //an optional property
-        {
-          "description": "Java class name of the exception",
-          "type"       : "string",
-        }
-      }
-    }
-  }
-}
-+---------------------------------
-
-  See also:
-  {{Error Responses}}
-
-
-** {Token JSON Schema}
-
-+---------------------------------
-{
-  "name"      : "Token",
-  "properties":
-  {
-    "Token": tokenProperties      //See Token Properties
-  }
-}
-+---------------------------------
-
-  See also:
-  {{{Token Properties}<<<Token>>> Properties}},
-  {{{Get Delegation Token}<<<GETDELEGATIONTOKEN>>>}},
-  the note in {{Delegation}}.
-
-*** {Token Properties}
-
-  JavaScript syntax is used to define <<<tokenProperties>>>
-  so that it can be referred in both <<<Token>>> and <<<Tokens>>> JSON schemas.
-
-+---------------------------------
-var tokenProperties =
-{
-  "type"      : "object",
-  "properties":
-  {
-    "urlString":
-    {
-      "description": "A delegation token encoded as a URL safe string.",
-      "type"       : "string",
-      "required"   : true
-    }
-  }
-}
-+---------------------------------
-
-** {Tokens JSON Schema}
-
-  A <<<Tokens>>> JSON object represents an array of <<<Token>>> JSON objects.
-
-+---------------------------------
-{
-  "name"      : "Tokens",
-  "properties":
-  {
-    "Tokens":
-    {
-      "type"      : "object",
-      "properties":
-      {
-        "Token":
-        {
-          "description": "An array of Token",
-          "type"       : "array",
-          "items"      : "Token": tokenProperties      //See Token Properties
-        }
-      }
-    }
-  }
-}
-+---------------------------------
-
-  See also:
-  {{{Token Properties}<<<Token>>> Properties}},
-  {{{Get Delegation Tokens}<<<GETDELEGATIONTOKENS>>>}},
-  the note in {{Delegation}}.
-
-
-* {HTTP Query Parameter Dictionary}
-
-** {ACL Spec}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<aclspec>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The ACL spec included in ACL modification operations. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | See {{{./HdfsPermissionsGuide.html}Permissions and HDFS}}. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | See {{{./HdfsPermissionsGuide.html}Permissions and HDFS}}. |
-*----------------+-------------------------------------------------------------------+
-
-
-** {XAttr Name}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<xattr.name>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The XAttr name of a file/directory. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | Any string prefixed with user./trusted./system./security.. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string prefixed with user./trusted./system./security.. |
-*----------------+-------------------------------------------------------------------+
-
-
-** {XAttr Value}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<xattr.value>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The XAttr value of a file/directory. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | An encoded value. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Enclosed in double quotes or prefixed with 0x or 0s. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{./ExtendedAttributes.html}Extended Attributes}}
-
-
-** {XAttr set flag}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<flag>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The XAttr set flag. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | CREATE,REPLACE. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | CREATE,REPLACE. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{./ExtendedAttributes.html}Extended Attributes}}
-
-
-** {XAttr value encoding}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<encoding>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The XAttr value encoding. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | text \| hex \| base64 |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | text \| hex \| base64 |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{./ExtendedAttributes.html}Extended Attributes}}
-
-
-** {Access Time}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<accesstime>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The access time of a file/directory. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | long |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | -1 (means keeping it unchanged) |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | -1 or a timestamp |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any integer. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Set Access or Modification Time}<<<SETTIMES>>>}}
-
-
-** {Block Size}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<blocksize>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The block size of a file. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | long |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | Specified in the configuration. |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | \> 0 |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any integer. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Create and Write to a File}<<<CREATE>>>}}
-
-
-** {Buffer Size}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<buffersize>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The size of the buffer used in transferring data. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | int |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | Specified in the configuration. |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | \> 0 |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any integer. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Create and Write to a File}<<<CREATE>>>}},
-  {{{Append to a File}<<<APPEND>>>}},
-  {{{Open and Read a File}<<<OPEN>>>}}
-
-
-** {Create Parent}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<createparent>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | If the parent directories do not exist, should they be created?   |
-*----------------+-------------------------------------------------------------------+
-|| Type          | boolean |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | false |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | true | false |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | true | false |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Create a Symbolic Link}<<<CREATESYMLINK>>>}}
-
-
-** {Delegation}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<delegation>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The delegation token used for authentication. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | An encoded token. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | See the note below. |
-*----------------+-------------------------------------------------------------------+
-
-  <<Note>> that delegation tokens are encoded as a URL safe string;
-  see <<<encodeToUrlString()>>>
-  and <<<decodeFromUrlString(String)>>>
-  in <<<org.apache.hadoop.security.token.Token>>> for the details of the encoding.
-
-
-  See also:
-  {{Authentication}}
-
-
-** {Destination}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<destination>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The destination path. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | Path |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> (an invalid path) |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | An absolute FileSystem path without scheme and authority. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any path. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Create a Symbolic Link}<<<CREATESYMLINK>>>}},
-  {{{Rename a File/Directory}<<<RENAME>>>}}
-
-
-** {Do As}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<doas>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | Allowing a proxy user to do as another user. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | null |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | Any valid username. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{Proxy Users}}
-
-
-** {Fs Action}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<fsaction>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | File system operation read/write/execute |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | null (an invalid value) |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | Strings matching regex pattern \"[rwx-]\{3\}\" |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | \"[rwx-]\{3\}\" |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Check access}<<<CHECKACCESS>>>}},
-
-** {Group}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<group>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The name of a group. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> (means keeping it unchanged) |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | Any valid group name. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Set Owner}<<<SETOWNER>>>}}
-
-
-** {Length}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<length>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The number of bytes to be processed. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | long |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | null (means the entire file) |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | \>= 0 or null |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any integer. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Open and Read a File}<<<OPEN>>>}}
-
-
-** {Modification Time}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<modificationtime>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The modification time of a file/directory. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | long |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | -1 (means keeping it unchanged) |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | -1 or a timestamp |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any integer. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Set Access or Modification Time}<<<SETTIMES>>>}}
-
-
-** {New Length}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<newlength>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The size the file is to be truncated to. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | long |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | \>= 0 |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any long. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Truncate a File}<<<TRUNCATE>>>}}
-
-
-** {Offset}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<offset>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The starting byte position. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | long |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | 0 |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | \>= 0 |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any integer. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Open and Read a File}<<<OPEN>>>}}
-
-
-** {Old Snapshot Name}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<oldsnapshotname>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The old name of the snapshot to be renamed. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | null |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | An existing snapshot name. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Rename Snapshot}<<<RENAMESNAPSHOT>>>}}
-
-
-** {Op}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<op>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The name of the operation to be executed. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | enum |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | null (an invalid value) |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | Any valid operation name. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{Operations}}
-
-
-** {Overwrite}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<overwrite>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | If a file already exists, should it be overwritten? |
-*----------------+-------------------------------------------------------------------+
-|| Type          | boolean |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | false |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | true | false |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | true | false |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Create and Write to a File}<<<CREATE>>>}}
-
-
-** {Owner}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<owner>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The username who is the owner of a file/directory. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> (means keeping it unchanged) |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | Any valid username. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Set Owner}<<<SETOWNER>>>}}
-
-
-** {Permission}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<permission>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The permission of a file/directory. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | Octal |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | 755 |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | 0 - 1777 |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any radix-8 integer (leading zeros may be omitted.) |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Create and Write to a File}<<<CREATE>>>}},
-  {{{Make a Directory}<<<MKDIRS>>>}},
-  {{{Set Permission}<<<SETPERMISSION>>>}}
-
-
-** {Recursive}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<recursive>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | Should the operation act on the content in the subdirectories? |
-*----------------+-------------------------------------------------------------------+
-|| Type          | boolean |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | false |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | true | false |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | true | false |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Rename a File/Directory}<<<RENAME>>>}}
-
-
-** {Renewer}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<renewer>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The username of the renewer of a delegation token. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> (means the current user) |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | Any valid username. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Get Delegation Token}<<<GETDELEGATIONTOKEN>>>}},
-  {{{Get Delegation Tokens}<<<GETDELEGATIONTOKENS>>>}}
-
-
-** {Replication}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<replication>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The number of replications of a file. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | short |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | Specified in the configuration. |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | \> 0 |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any integer. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Create and Write to a File}<<<CREATE>>>}},
-  {{{Set Replication Factor}<<<SETREPLICATION>>>}}
-
-
-** {Snapshot Name}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<snapshotname>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The name of the snapshot to be created/deleted. |
-||               | Or the new name for snapshot rename.            |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | null |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | Any valid snapshot name. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Create Snapshot}<<<CREATESNAPSHOT>>>}},
-  {{{Delete Snapshot}<<<DELETESNAPSHOT>>>}},
-  {{{Rename Snapshot}<<<RENAMESNAPSHOT>>>}}
-
-
-** {Sources}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<sources>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | A list of source paths. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | A list of comma seperated absolute FileSystem paths without scheme and authority. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Concat File(s)}<<<CONCAT>>>}}
-
-
-** {Token}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<token>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The delegation token used for the operation. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | An encoded token. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | See the note in {{Delegation}}. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Renew Delegation Token}<<<RENEWDELEGATIONTOKEN>>>}},
-  {{{Cancel Delegation Token}<<<CANCELDELEGATIONTOKEN>>>}}
-
-
-** {Token Kind}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<kind>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The kind of the delegation token requested |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> (Server sets the default kind for the service) |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | A string that represents token kind e.g "HDFS_DELEGATION_TOKEN" or "WEBHDFS delegation" |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Get Delegation Token}<<<GETDELEGATIONTOKEN>>>}}
-
-
-** {Token Service}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<service>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The name of the service where the token is supposed to be used, e.g. ip:port of the namenode |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | \<empty\> |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | ip:port in string format or logical name of the service |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{{Get Delegation Token}<<<GETDELEGATIONTOKEN>>>}}
-
-
-** {Username}
-
-*----------------+-------------------------------------------------------------------+
-|| Name          | <<<user.name>>> |
-*----------------+-------------------------------------------------------------------+
-|| Description   | The authenticated user; see {{Authentication}}. |
-*----------------+-------------------------------------------------------------------+
-|| Type          | String |
-*----------------+-------------------------------------------------------------------+
-|| Default Value | null |
-*----------------+-------------------------------------------------------------------+
-|| Valid Values  | Any valid username. |
-*----------------+-------------------------------------------------------------------+
-|| Syntax        | Any string. |
-*----------------+-------------------------------------------------------------------+
-
-  See also:
-  {{Authentication}}


Mime
View raw message