WebHDFS（REST API）

运作方式

• HTTP GET
  • 打开（请参阅 FileSystem .open）
  • GETFILESTATUS（请参阅 FileSystem .getFileStatus）
  • LISTSTATUS（请参阅 FileSystem .listStatus）
  • LISTSTATUS_BATCH（请参阅 FileSystem .listStatusIterator）
  • GETCONTENTSUMMARY（请参阅 FileSystem .getContentSummary）
  • GETQUOTAUSAGE（请参阅 FileSystem.getQuotaUsage）
  • GETFILECHECKSUM（请参阅 FileSystem .getFileChecksum）
  • GETHOMEDIRECTORY（请参阅 FileSystem .getHomeDirectory）
  • GETDELEGATIONTOKEN（请参阅 FileSystem .getDelegationToken）
  • GETTRASHROOT（请参阅 FileSystem .getTrashRoot）
  • GETXATTRS（请参阅 FileSystem .getXAttr）
  • GETXATTRS（请参阅 FileSystem .getXAttrs）
  • GETXATTRS（请参阅 FileSystem .getXAttrs）
  • LISTXATTRS（请参阅 FileSystem .listXAttrs）
  • 检查（请参阅 FileSystem .access）
  • GETALLSTORAGEPOLICY（请参阅 FileSystem .getAllStoragePolicies）
  • GETSTORAGEPOLICY（请参阅 FileSystem .getStoragePolicy）
  • GETSNAPSHOTDIFF
  • GETSNAPSHOTTABLEDIRECTORYLIST
  • GETFILEBLOCKLOCATIONS（请参阅 FileSystem .getFileBlockLocations）
  • GETECPOLICY（请参阅 HDFSErasureCoding .getErasureCodingPolicy）
• HTTP PUT
  • 创建（请参阅 FileSystem .create）
  • MKDIRS（请参阅 FileSystem .mkdirs）
  • CREATESYMLINK（请参阅 FileContext .createSymlink）
  • 重命名（请参阅 FileSystem .rename）
  • SETREPLICATION（请参阅 FileSystem .setReplication）
  • SETOWNER（请参阅 FileSystem .setOwner）
  • SETPERMISSION（请参阅 FileSystem .setPermission）
  • SETTIMES（请参见 FileSystem .setTimes）
  • RENEWDELEGATIONTOKEN（见 DelegationTokenAuthenticator .renewDelegationToken）
  • CANCELDELEGATIONTOKEN（见 DelegationTokenAuthenticator .cancelDelegationToken）
  • CREATESNAPSHOT（请参阅 FileSystem .createSnapshot）
  • RENAMESNAPSHOT（请参阅 FileSystem .renameSnapshot）
  • SETXATTR（请参阅 FileSystem.setXAttr）
  • REMOVEXATTR（请参阅 FileSystem .removeXAttr）
  • SETSTORAGEPOLICY（请参阅 FileSystem .setStoragePolicy）
  • ENABLEECPOLICY（见 HDFSErasureCoding .enablePolicy）
  • DISABLEECPOLICY（见 HDFSErasureCoding .disablePolicy）
  • SETECPOLICY（请参阅 HDFSErasureCoding .setErasureCodingPolicy）
• HTTP POST
  • APPEND（请参阅 FileSystem .append）
  • CONCAT（请参阅 FileSystem .concat）
  • TRUNCATE（见文件系统 .truncate）
  • UNSETSTORAGEPOLICY（请参阅 FileSystem .unsetStoragePolicy）
  • UNSETECPOLICY（见 HDFSErasureCoding .unsetErasureCodingPolicy）
• HTTP删除
  • 删除（请参阅 FileSystem .delete）
  • DELETESNAPSHOT（请参阅 FileSystem .deleteSnapshot）

文件系统URI与HTTP URL

WebHDFS的文件系统方案为“ webhdfs：// ”。WebHDFS文件系统URI具有以下格式。

  webhdfs：// <主机>：<HTTP_PORT> / <PATH>

上面的WebHDFS URI对应于下面的HDFS URI。

  hdfs：// <主机>：<RPC_PORT> / <PATH>

在REST API中，在路径中插入前缀“ / webhdfs / v1 ”，并在末尾附加查询。因此，相应的HTTP URL具有以下格式。

  http：// <主机>：<HTTP_PORT> / webhdfs / v1 / <PATH>？op = ...

请注意，如果WebHDFS用SSL保护，则该方案应为“ swebhdfs：// ”。

  swebhdfs：// <主机>：<HTTP_PORT> / <PATH>

另请参阅：SWebHDFS的SSL配置

HDFS配置选项

以下是WebHDFS的HDFS配置选项。

创建并写入文件

• 步骤1：提交HTTP PUT请求，而不会自动跟随重定向，也不会发送文件数据。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = CREATE
                      [＆overwrite = <true | false>] [＆blocksize = <LONG>] [＆replication = <SHORT>]
                      [＆permission = <OCTAL>] [＆buffersize = <INT>] [＆noredirect = <true | false>]“
  

  通常，将请求重定向到要写入文件数据的数据节点。

  HTTP / 1.1 307 TEMPORARY_REDIRECT
  位置：http：// <DATANODE>：<PORT> / webhdfs / v1 / <PATH>？op = CREATE ...
  内容长度：0
  

  但是，如果您不想自动重定向，则可以设置noredirect标志。

  HTTP / 1.1 200 OK
  内容类型：application / json
  {“位置”：“ http：// <DATANODE>：<PORT> / webhdfs / v1 / <PATH>？op = CREATE ...”}
  

• 步骤2：使用位置标头中的URL提交另一个HTTP PUT请求（如果指定了noredirect，则返回返回的响应），并写入要写入的文件数据。

  curl -i -X PUT -T <LOCAL_FILE>“ http：// <DATANODE>：<PORT> / webhdfs / v1 / <PATH>？op = CREATE ...”
  

  客户端在位置标头中收到内容长度为零且文件的WebHDFS URI的201 Created响应：

  HTTP / 1.1 201已创建
  位置：webhdfs：// <HOST>：<PORT> / <PATH>
  内容长度：0
  

  如果未指定权限，将为新创建的文件分配默认的644权限。服务器端不会应用umask模式（因此，在Namenode端设置的“ fs.permissions.umask-mode”值配置将无效）。

请注意，具有两步创建/追加的原因是为了防止客户端在重定向之前发送数据。HTTP / 1.1中的“ Expect：100-continue ”头解决了此问题；参见RFC 2616，第8.2.3节。不幸的是，存在一些软件库错误（例如Jetty 6 HTTP服务器和Java 6 HTTP客户端），这些错误无法正确实现“ Expect：100-continue ”。分两步创建/添加是软件库错误的临时解决方法。

另请参见：覆盖，块大小，复制，许可，缓冲区大小，文件系统 .create

附加到文件

• 步骤1：提交HTTP POST请求，而不会自动跟随重定向，也不会发送文件数据。

  curl -i -X POST“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = APPEND [＆buffersize = <INT>] [＆noredirect = <true | false>]”
  

  通常，将请求重定向到要附加文件数据的数据节点：

  HTTP / 1.1 307 TEMPORARY_REDIRECT
  位置：http：// <DATANODE>：<PORT> / webhdfs / v1 / <PATH>？op = APPEND ...
  内容长度：0
  

但是，如果您不想自动重定向，则可以设置noredirect标志。

    HTTP / 1.1 200 OK
    内容类型：application / json
    {“位置”：“ http：// <DATANODE>：<PORT> / webhdfs / v1 / <PATH>？op = APPEND ...”}

• 步骤2：使用Location标头中的URL提交另一个HTTP POST请求（如果指定了noredirect，则使用返回的响应），并附加要附加的文件数据。

  curl -i -X POST -T <LOCAL_FILE>“ http：// <DATANODE>：<PORT> / webhdfs / v1 / <PATH>？op = APPEND ...”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

有关为何需要此步骤两个步骤的说明，请参见上一节中的注释。

另请参见：buffersize，FileSystem .append

Concat文件

• 提交HTTP POST请求。

  curl -i -X POST“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = CONCAT＆sources = <PATHS>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参见：来源，FileSystem .concat

打开和读取文件

• 提交具有自动后续重定向的HTTP GET请求。

  curl -i -L“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = OPEN
                      [＆offset = <LONG>] [＆length = <LONG>] [＆buffersize = <INT>] [＆noredirect = <true | false>]”
  

  通常，将请求重定向到一个可以读取文件数据的datanode：

  HTTP / 1.1 307 TEMPORARY_REDIRECT
  位置：http：// <DATANODE>：<PORT> / webhdfs / v1 / <PATH>？op = OPEN ...
  内容长度：0
  

  但是，如果您不想被自动重定向，则可以设置noredirect标志。

  HTTP / 1.1 200 OK
  内容类型：application / json
  {“位置”：“ http：// <DATANODE>：<PORT> / webhdfs / v1 / <PATH>？op = OPEN ...”}
  

  客户端遵循重定向到datanode并接收文件数据：

  HTTP / 1.1 200 OK
  内容类型：应用程序/八位字节流
  内容长度：22
  
  您好，webhdfs用户！
  

另请参阅：偏移，长度，缓冲区大小，文件系统。开

建立目录

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = MKDIRS [＆permission = <OCTAL>]”“
  

  客户端收到带有JSON 布尔对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {“布尔值”：true}
  

  如果未指定权限，则默认情况下，新创建的目录将具有755权限。服务器端不会应用umask模式（因此，在Namenode端设置的“ fs.permissions.umask-mode”值配置将无效）。

另请参见：权限，FileSystem .mkdirs

创建符号链接

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = CREATESYMLINK
                                ＆destination = <PATH> [＆createParent = <true | false>]“
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参见：destination，createParent，FileSystem .createSymlink

重命名文件/目录

• 提交HTTP PUT请求。

  curl -i -X PUT“ <主机>：<PORT> / webhdfs / v1 / <PATH>？op = RENAME＆destination = <PATH>”
  

  客户端收到带有JSON 布尔对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {“布尔值”：true}
  

另请参见：destination，FileSystem .rename

删除文件/目录

• 提交HTTP DELETE请求。

  curl -i -X DELETE“ http：// <主机>：<端口> / webhdfs / v1 / <路径>？op = DELETE
                                [＆recursive = <true | false>]”
  

  客户端收到带有JSON 布尔对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {“布尔值”：true}
  

另请参阅：递归，FileSystem .delete

截断文件

• 提交HTTP POST请求。

  curl -i -X POST“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = TRUNCATE＆newlength = <LONG>”
  

  客户端收到带有JSON 布尔对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {“布尔值”：true}
  

另请参见：newlength，FileSystem .truncate

文件/目录的状态

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETFILESTATUS”
  

  客户端收到带有FileStatus JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
    “ FileStatus”：
    {
      “ accessTime”：0，
      “ blockSize”：0，
      “ group”：“ supergroup”，
      “ length”：0，//以字节为单位，目录为零
      “ modificationTime”：1320173277227，
      “ owner”：“ webuser”，
      “ pathSuffix”：“”，
      “权限”：“ 777”，
      “复制”：0，
      “ snapshotEnabled”：是
      “ type”：“ DIRECTORY” //枚举{FILE，DIRECTORY，SYMLINK}
    }
  }
  

另请参阅：FileSystem .getFileStatus

列出目录

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = LISTSTATUS”
  

  客户端收到带有FileStatuses JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  内容长度：427
  
  {
    “ FileStatuses”：
    {
      “ FileStatus”：
      [
        {
          “ accessTime”：1320171722771，
          “ blockSize”：33554432，
          “ childrenNum”：0，
          “ fileId”：16388，
          “ group”：“ supergroup”，
          “长度”：24930，
          “ modificationTime”：1320171722771，
          “ owner”：“ webuser”，
          “ pathSuffix”：“ a.patch”，
          “ permission”：“ 644”，
          “复制”：1，
          “ storagePolicy”：0，
          “ type”：“ FILE”
        }，
        {
          “ accessTime”：0，
          “ blockSize”：0，
          “ childrenNum”：0，
          “ fileId”：16389，
          “ group”：“ supergroup”，
          “长度”：0，
          “ modificationTime”：1320895981256，
          “ owner”：“用户名”，
          “ pathSuffix”：“ bar”，
          “ permission”：“ 711”，
          “复制”：0，
          “ snapshotEnabled”：是
          “ type”：“目录”
        }，
        ...
      ]
    }
  }
  

另请参阅：FileSystem .listStatus

列出文件

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = LISTSTATUS”
  

  客户端收到带有FileStatuses JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  内容长度：427
  
  {
    “ FileStatuses”：
    {
      “ FileStatus”：
      [
        {
          “ accessTime”：1320171722771，
          “ blockSize”：33554432，
          “ childrenNum”：0，
          “ fileId”：16390，
          “ group”：“ supergroup”，
          “长度”：1366，
          “ modificationTime”：1501770633062，
          “ owner”：“ webuser”，
          “ pathSuffix”：“”，
          “ permission”：“ 644”，
          “复制”：1，
          “ storagePolicy”：0，
          “ type”：“ FILE”
        }
      ]
    }
  }
  

另请参阅：FileSystem .listStatus

反复列出目录

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = LISTSTATUS_BATCH＆startAfter = <CHILD>”
  

  客户端收到带有DirectoryListing JSON对象的响应，该对象包含FileStatuses JSON对象以及迭代信息：

  HTTP / 1.1 200 OK
  缓存控制：无缓存
  过期：星期四，2016年9月8日03:40:38 GMT
  日期：2016年9月8日，星期四03:40:38 GMT
  语法：无缓存
  过期：星期四，2016年9月8日03:40:38 GMT
  日期：2016年9月8日，星期四03:40:38 GMT
  语法：无缓存
  内容类型：application / json
  X框架选项：SAMEORIGIN
  传输编码：分块
  服务器：码头（6.1.26）
  
  {
      “ DirectoryListing”：{
          “ partialListing”：{
              “ FileStatuses”：{
                  “ FileStatus”：[
                      {
                          “ accessTime”：0，
                          “ blockSize”：0，
                          “ childrenNum”：0，
                          “ fileId”：16387，
                          “ group”：“ supergroup”，
                          “长度”：0，
                          “ modificationTime”：1473305882563，
                          “ owner”：“ andrew”，
                          “ pathSuffix”：“ bardir”，
                          “权限”：“ 755”，
                          “复制”：0，
                          “ storagePolicy”：0，
                          “ type”：“ DIRECTORY”
                      }，
                      {
                          “ accessTime”：1473305896945，
                          “ blockSize”：1024，
                          “ childrenNum”：0，
                          “ fileId”：16388，
                          “ group”：“ supergroup”，
                          “长度”：0，
                          “ modificationTime”：1473305896965，
                          “ owner”：“ andrew”，
                          “ pathSuffix”：“ bazfile”，
                          “ permission”：“ 644”，
                          “复制”：3，
                          “ storagePolicy”：0，
                          “ type”：“ FILE”
                      }
                  ]
              }
          }，
          “剩余条目”：2
      }
  }
  

如果剩余条目数不为零，则目录中还有其他条目。要查询下一个批次，请将startAfter参数设置为当前批次中返回的最后一个项目的pathSuffix。例如：

    curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = LISTSTATUS_BATCH＆startAfter = bazfile”

它将返回下一批目录条目：

    HTTP / 1.1 200 OK
    缓存控制：无缓存
    过期：星期四，2016年9月8日03:43:20 GMT
    日期：2016年9月8日，星期四03:43:20 GMT
    语法：无缓存
    过期：星期四，2016年9月8日03:43:20 GMT
    日期：2016年9月8日，星期四03:43:20 GMT
    语法：无缓存
    内容类型：application / json
    X框架选项：SAMEORIGIN
    传输编码：分块
    服务器：码头（6.1.26）

    {
        “ DirectoryListing”：{
            “ partialListing”：{
                “ FileStatuses”：{
                    “ FileStatus”：[
                        {
                            “ accessTime”：0，
                            “ blockSize”：0，
                            “ childrenNum”：0，
                            “ fileId”：16386，
                            “ group”：“ supergroup”，
                            “长度”：0，
                            “ modificationTime”：1473305878951，
                            “ owner”：“ andrew”，
                            “ pathSuffix”：“ foodir”，
                            “权限”：“ 755”，
                            “复制”：0，
                            “ storagePolicy”：0，
                            “ type”：“ DIRECTORY”
                        }，
                        {
                            “ accessTime”：1473305902864，
                            “ blockSize”：1024，
                            “ childrenNum”：0，
                            “ fileId”：16389，
                            “ group”：“ supergroup”，
                            “长度”：0，
                            “ modificationTime”：1473305902878，
                            “ owner”：“ andrew”，
                            “ pathSuffix”：“ quxfile”，
                            “ permission”：“ 644”，
                            “复制”：3，
                            “ storagePolicy”：0，
                            “ type”：“ FILE”
                        }
                    ]
                }
            }，
            “剩余条目”：0
        }
    }

批处理大小由NameNode上的dfs.ls.limit选项控制。

另请参阅：FileSystem .listStatusIterator

获取目录的内容摘要

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETCONTENTSUMMARY”
  

  客户端收到带有ContentSummary JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
    “ ContentSummary”：
    {
      “ directoryCount”：2
      “ fileCount”：1
      “长度”：24930，
      “ quota”：-1，
      “ spaceConsumed”：24930，
      “ spaceQuota”：-1，
      “ typeQuota”：
      {
        “存档”：
        {
          “已消耗”：500，
          “ quota”：10000
        }，
        “磁盘”：
        {
          “已消耗”：500，
          “ quota”：10000
        }，
        “ SSD”：
        {
          “已消耗”：500，
          “ quota”：10000
        }
      }
    }
  }
  

另请参阅：FileSystem .getContentSummary

获取目录的配额使用

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETQUOTAUSAGE”
  

  客户端收到带有QuotaUsage JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
    “ QuotaUsage”：
    {
      “ fileAndDirectoryCount”：1
      “ quota”：100，
      “ spaceConsumed”：24930，
      “ spaceQuota”：100000，
      “ typeQuota”：
      {
        “存档”：
        {
          “已消耗”：500，
          “ quota”：10000
        }，
        “磁盘”：
        {
          “已消耗”：500，
          “ quota”：10000
        }，
        “ SSD”：
        {
          “已消耗”：500，
          “ quota”：10000
        }
      }
    }
  }
  

另请参阅：FileSystem .getQuotaUsage

获取文件校验和

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETFILECHECKSUM”
  

  通常，请求被重定向到数据节点：

  HTTP / 1.1 307 TEMPORARY_REDIRECT
  位置：http：// <DATANODE>：<PORT> / webhdfs / v1 / <PATH>？op = GETFILECHECKSUM ...
  内容长度：0
  

  但是，如果您不想自动重定向，则可以设置noredirect标志。

  HTTP / 1.1 200 OK
  内容类型：application / json
  {“位置”：“ http：// <DATANODE>：<PORT> / webhdfs / v1 / <PATH>？op = GETFILECHECKSUM ...”}
  

  客户端遵循重定向到datanode并接收FileChecksum JSON对象：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
    “ FileChecksum”：
    {
      “ algorithm”：“ MD5-of-1MD5-of-512CRC32”，
      “ bytes”：“ eadb10de24aa315748930df6e185c0d ...”，
      “长度”：28
    }
  }
  

另请参阅：FileSystem .getFileChecksum

获取主目录

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 /？op = GETHOMEDIRECTORY”
  

  客户端收到带有Path JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {“路径”：“ /用户/用户名”}
  

另请参阅：FileSystem .getHomeDirectory

获取垃圾根

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETTRASHROOT”
  

  客户端收到带有Path JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {“路径”：“ /用户/用户名/。垃圾”}
  

  如果该路径是加密的区域路径，并且用户具有该路径的权限，则客户端将收到如下响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {“路径”：“ / PATH / .Trash /用户名”}
  

另请参阅：FileSystem .getTrashRoot

有关加密区域中的垃圾桶根的更多详细信息，请参阅《透明加密指南》。

设定权限

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = SETPERMISSION
                                [＆permission = <OCTAL>]”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参见：权限，FileSystem .setPermission

设定拥有者

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = SETOWNER
                                [＆owner = <USER>] [＆group = <GROUP>]“
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参见：owner，group，FileSystem .setOwner

设置复制因子

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = SETREPLICATION
                                [＆replication = <SHORT>]”
  

  客户端收到带有JSON 布尔对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {“布尔值”：true}
  

另请参见：复制，FileSystem .setReplication

设置访问或修改时间

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = SETTIMES
                                [＆modificationtime = <TIME>] [＆accesstime = <TIME>]“
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参见：modificationtime，accesstime，文件系统 .setTimes

修改ACL条目

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = MODIFYACLENTRIES
                                ＆aclspec = <ACLSPEC>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .modifyAclEntries

删除ACL条目

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = REMOVEACLENTRIES
                                ＆aclspec = <ACLSPEC>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .removeAclEntries

删除默认ACL

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = REMOVEDEFAULTACL”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .removeDefaultAcl

删除ACL

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = REMOVEACL”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .removeAcl

设定ACL

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = SETACL
                                ＆aclspec = <ACLSPEC>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .setAcl

获取ACL状态

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETACLSTATUS”
  

  客户端收到带有AclStatus JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
      “ AclStatus”：{
          “条目”：[
              “用户：carla：rw-”， 
              “ group :: rx”
          ]， 
          “ group”：“ supergroup”， 
          “ owner”：“ hadoop”， 
          “ permission”：“ 775”，
          “ stickyBit”：false
      }
  }
  

另请参阅：FileSystem .getAclStatus

检查访问

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = CHECKACCESS
                                ＆fsaction = <FSACTION>
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .access

获取所有存储策略

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1？op = GETALLSTORAGEPOLICY”
  

  客户端收到带有BlockStoragePolicies JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
      “ BlockStoragePolicies”：{
          “ BlockStoragePolicy”：[
             {
                 “ copyOnCreateFile”：否，
                 “ creationFallbacks”：[]，
                 “ id”：2
                 “ name”：“ COLD”，
                 “ replicationFallbacks”：[]，
                 “ storageTypes”：[“ ARCHIVE”]
             }，
             {
                 “ copyOnCreateFile”：否，
                 “ creationFallbacks”：[“ DISK”，“ ARCHIVE”]，
                 “ id”：5
                 “ name”：“ WARM”，
                 “ replicationFallbacks”：[“ DISK”，“ ARCHIVE”]，
                 “ storageTypes”：[“ DISK”，“ ARCHIVE”]
             }，
             {
                 “ copyOnCreateFile”：否，
                 “ creationFallbacks”：[]，
                 “ id”：7
                 “ name”：“ HOT”，
                 “ replicationFallbacks”：[“ ARCHIVE”]，
                 “ storageTypes”：[“ DISK”]
             }，
             {
                 “ copyOnCreateFile”：否，
                 “ creationFallbacks”：[“ SSD”，“ DISK”]，
                 “ id”：10，“ name”：“ ONE_SSD”，
                 “ replicationFallbacks”：[“ SSD”，“ DISK”]，
                 “ storageTypes”：[“ SSD”，“ DISK”]
             }，
             {
                 “ copyOnCreateFile”：否，
                 “ creationFallbacks”：[“ DISK”]，
                 “ id”：12
                 “ name”：“ ALL_SSD”，
                 “ replicationFallbacks”：[“ DISK”]，
                 “ storageTypes”：[“ SSD”]
             }，
             {
                 “ copyOnCreateFile”：是的，
                 “ creationFallbacks”：[“ DISK”]，
                 “ id”：15
                 “ name”：“ LAZY_PERSIST”，
                 “ replicationFallbacks”：[“ DISK”]，
                 “ storageTypes”：[“ RAM_DISK”，“ DISK”]
             }
         ]
     }
  }
  

另请参阅：FileSystem .getAllStoragePolicies

设置存储策略

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = SETSTORAGEPOLICY
                                ＆storagepolicy = <策略>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .setStoragePolicy

未设定的储存政策

• 提交HTTP POT请求。

  curl -i -X POST“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = UNSETSTORAGEPOLICY”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .unsetStoragePolicy

获取存储策略

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETSTORAGEPOLICY”
  

  客户端收到带有BlockStoragePolicy JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
      “ BlockStoragePolicy”：{
          “ copyOnCreateFile”：否，
         “ creationFallbacks”：[]，
          “ id”：7，
          “ name”：“ HOT”，
          “ replicationFallbacks”：[“ ARCHIVE”]，
          “ storageTypes”：[“ DISK”]
      }
  }
  

另请参阅：FileSystem .getStoragePolicy

获取文件阻止位置

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETFILEBLOCKLOCATIONS
  

  客户端收到带有BlockLocations JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
    “ BlockLocations”：
    {
      “ BlockLocation”：
      [
        {
          “ cachedHosts”：[]，
          “ corrupt”：错误，
          “主机”：[“主机”]，
          “ length”：134217728，//此块的长度
          “ names”：[“ host：ip”]，
          “ offset”：0，//文件中块的偏移量
          “ storageTypes”：[“ DISK”]，//枚举{RAM_DISK，SSD，DISK，ARCHIVE}
          “ topologyPaths”：[“ /默认机架/主机名：ip”]
        }，{
          “ cachedHosts”：[]，
          “ corrupt”：错误，
          “主机”：[“主机”]，
          “长度”：62599364，
          “ names”：[“ host：ip”]，
          “偏移”：134217728，
          “ storageTypes”：[“ DISK”]，
          “ topologyPaths”：[“ /默认机架/主机名：ip”]
        }，
        ...
      ]
    }
  }
  

另请参见：offset，length，FileSystem .getFileBlockLocations

设置XAttr

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = SETXATTR
                                ＆xattr.name = <XATTRNAME>＆xattr.value = <XATTRVALUE>
                                ＆flag = <FLAG>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .setXAttr

删除XAttr

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = REMOVEXATTR
                                ＆xattr.name = <XATTRNAME>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .removeXAttr

获取XAttr

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETXATTRS
                                ＆xattr.name = <XATTRNAME>＆encoding = <ENCODING>”
  

  客户端收到带有XAttrs JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
      “ XAttrs”：[
          {
              “ name”：“ XATTRNAME”，
              “值”：“ XATTRVALUE”
          }
      ]
  }
  

另请参阅：FileSystem .getXAttr

获取多个XAttrs

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETXATTRS
                                ＆xattr.name = <XATTRNAME1>＆xattr.name = <XATTRNAME2>
                                ＆encoding = <编码>”
  

  客户端收到带有XAttrs JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
      “ XAttrs”：[
          {
              “名称”：“ XATTRNAME1”，
              “值”：“ XATTRVALUE1”
          }，
          {
              “名称”：“ XATTRNAME2”，
              “值”：“ XATTRVALUE2”
          }
      ]
  }
  

另请参阅：FileSystem .getXAttrs

获取所有XAttrs

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETXATTRS
                                ＆encoding = <编码>”
  

  客户端收到带有XAttrs JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
      “ XAttrs”：[
          {
              “名称”：“ XATTRNAME1”，
              “值”：“ XATTRVALUE1”
          }，
          {
              “名称”：“ XATTRNAME2”，
              “值”：“ XATTRVALUE2”
          }，
          {
              “名称”：“ XATTRNAME3”，
              “值”：“ XATTRVALUE3”
          }
      ]
  }
  

另请参阅：FileSystem .getXAttrs

列出所有XAttrs

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = LISTXATTRS”
  

  客户端收到带有XAttrNames JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
      “ XAttrNames”：“ [\” XATTRNAME1 \“，\” XATTRNAME2 \“，\” XATTRNAME3 \“]”
  }
  

另请参阅：FileSystem .listXAttrs

启用EC政策

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 /？op = ENABLEECPOLICY
                                ＆ecpolicy = <策略>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：HDFSErasureCoding .enablePolicy

停用EC政策

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 /？op = DISABLEECPOLICY
                                ＆ecpolicy = <策略>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：HDFSErasureCoding .disablePolicy

设定EC政策

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = SETECPOLICY
                                ＆ecpolicy = <策略>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：HDFSErasureCoding .setErasureCodingPolicy

获取EC政策

• 提交HTTP GET请求。

  curl -i -X GET“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETECPOLICY
                               ”
  

客户端收到带有ECPolicy JSON对象的响应：

    {
        “名称”：“ RS-10-4-1024k”，
        “模式”：
        {
        “ codecName”：“ rs”，
        “ numDataUnits”：10，
        “ numParityUnits”：4
        “ extraOptions”：{}
        }
        “ cellSize”：1048576，
        “ id”：5，
        “ codecname”：“ rs”，
        “ numDataUnits”：10，
        “ numParityUnits”：4
        “ replicationpolicy”：false，
        “ systemPolicy”：true

    }

另请参见：HDFSErasureCoding .getErasureCodingPolicy

未设定EC政策

• 提交HTTP POST请求。

  curl -i -X POST“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = UNSETECPOLICY
                               ”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参见：HDFSErasureCoding .unsetErasureCodingPolicy

创建快照

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = CREATESNAPSHOT [＆snapshotname = <SNAPSHOTNAME>]”
  

  客户端收到带有Path JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {“路径”：“ /用户/用户名/.snapshot/s1”}
  

另请参阅：FileSystem .createSnapshot

删除快照

• 提交HTTP DELETE请求。

  curl -i -X DELETE“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = DELETESNAPSHOT＆snapshotname = <快照名称>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .deleteSnapshot

重命名快照

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = RENAMESNAPSHOT
                     ＆oldsnapshotname = <快照名称>＆snapshotname = <快照名称>“
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参阅：FileSystem .renameSnapshot

获取快照差异

• 提交HTTP GET请求。

  curl -i GET“ http：// <主机>：<PORT> / webhdfs / v1 / <PATH>？op = GETSNAPSHOTDIFF
                     ＆oldsnapshotname = <快照名称>＆snapshotname = <快照名称>“
  

  客户端收到带有SnapshotDiffReport JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {“ SnapshotDiffReport”：{“ diffList”：[]，“ fromSnapshot”：“ s3”，“ snapshotRoot”：“ / foo”，“ toSnapshot”：“ s4”}}
  

获取快照表目录列表

• 提交HTTP GET请求。

  curl -i GET“ http：// <主机>：<PORT> /webhdfs/v1/?user.name= <USER>＆op = GETSNAPSHOTTABLEDIRECTORYLIST”
  

  如果USER不是hdfs超级用户，则调用仅列出该用户拥有的快照表目录。如果USER是hdfs超级用户，则调用将列出所有snapshottable目录。客户端收到带有SnapshottableDirectoryList JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
      “ SnapshottableDirectoryList”：
      [
          {
            “ dirStatus”：
              {
                  “ accessTime”：0，
                  “ blockSize”：0，
                  “ childrenNum”：0，
                  “ fileId”：16386，
                  “ group”：“ hadoop”，
                  “长度”：0，
                  “修改时间”：1520761889225，
                  “ owner”：“ random”，
                  “ pathSuffix”：“ bar”，
                  “权限”：“ 755”，
                  “复制”：0，
                  “ storagePolicy”：0，
                  “ type”：“目录”
              }，
            “ parentFullPath”：“ /”，
            “ snapshotNumber”：0，
            “快照配额”：65536
          }
      ]
  }
  

获取委托令牌

• 提交HTTP GET请求。

  curl -i“ http：// <主机>：<PORT> / webhdfs / v1 /？op = GETDELEGATIONTOKEN
              [＆renewer = <用户>] [＆服务= <服务>] [＆种类= <种类>]”
  

  客户端收到带有令牌 JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {
    “令牌”：
    {
      “ urlString”：“ JQAIaG9y ...”
    }
  }
  

另请参见：更新器，FileSystem .getDelegationToken，种类，服务

续签授权令牌

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 /？op = RENEWDELEGATIONTOKEN＆token = <令牌>”
  

  客户端收到带有长 JSON对象的响应：

  HTTP / 1.1 200 OK
  内容类型：application / json
  传输编码：分块
  
  {“ long”：1320962673997} //新的到期时间
  

另见：令牌，DelegationTokenAuthenticator .renewDelegationToken

取消授权令牌

• 提交HTTP PUT请求。

  curl -i -X PUT“ http：// <主机>：<PORT> / webhdfs / v1 /？op = CANCELDELEGATIONTOKEN＆token = <令牌>”
  

  客户端收到内容长度为零的响应：

  HTTP / 1.1 200 OK
  内容长度：0
  

另请参见：令牌，委派令牌授权者 .cancelDelegationToken

HTTP响应码

以下是异常响应的示例。

HTTP / 1.1 400错误请求
内容类型：application / json
传输编码：分块

{
  “ RemoteException”：
  {
    “ exception”：“ IllegalArgumentException”，
    “ javaClassName”：“ java.lang.IllegalArgumentException”，
    “ message”：“ webhdfs参数的无效值\” permission \“：...”
  }
}

HTTP / 1.1 401未经授权
内容类型：application / json
传输编码：分块

{
  “ RemoteException”：
  {
    “ exception”：“ SecurityException”，
    “ javaClassName”：“ java.lang.SecurityException”，
    “ message”：“无法获取用户组信息：...”
  }
}

HTTP / 1.1 403禁止
内容类型：application / json
传输编码：分块

{
  “ RemoteException”：
  {
    “ exception”：“ AccessControlException”，
    “ javaClassName”：“ org.apache.hadoop.security.AccessControlException”，
    “ message”：“权限被拒绝：...”
  }
}

找不到HTTP / 1.1 404
内容类型：application / json
传输编码：分块

{
  “ RemoteException”：
  {
    “ exception”：“ FileNotFoundException”，
    “ javaClassName”：“ java.io.FileNotFoundException”，
    “ message”：“文件不存在：/foo/a.patch”
  }
}

ACL状态JSON架构

{
  “ name”：“ AclStatus”，
  “属性”：
  {
    “ AclStatus”：
    {
      “ type”：“ object”，
      “属性”：
      {
        “条目”：
        {
          “ type”：“ array”，
          “项目”：
          {
            “ description”：“ ACL条目”，
            “ type”：“字符串”
          }
        }，
        “组”：
        {
          “ description”：“群组所有者。”，
          “ type”：“ string”，
          “必填”：是
        }，
        “所有者”：
        {
          “ description”：“所有者的用户。”，
          “ type”：“ string”，
          “必填”：是
        }，
        “ stickyBit”：
        {
          “ description”：“如果粘性位打开，则为真。”，
          “ type”：“ boolean”，
          “必填”：是
        }
      }
    }
  }
}

XAttrs JSON模式

{
  “ name”：“ XAttrs”，
  “属性”：
  {
    “ XAttrs”：
    {
      “ type”：“ array”，
      “项目”：
      {
        “ type”：“ object”，
        “属性”：
        {
          “名称”：
          {
            “ description”：“ XAttr名称。”，
            “ type”：“ string”，
            “必填”：是
          }，
          “值”：
          {
            “ description”：“ XAttr值。”，
            “ type”：“ string”
          }
        }
      }
    }
  }
}

XAttrNames JSON模式

{
  “ name”：“ XAttrNames”，
  “属性”：
  {
    “ XAttrNames”：
    {
      “ description”：“ XAttr名称。”，
      “ type”：“ string”，
      “必填”：是
    }
  }
}

布尔JSON模式

{
  “ name”：“ boolean”，
  “属性”：
  {
    “布尔值”：
    {
      “ description”：“布尔值”，
      “ type”：“ boolean”，
      “必填”：是
    }
  }
}

另请参见：MKDIRS，RENAME，DELETE，SETREPLICATION

ContentSummary JSON模式

{
  “ name”：“ ContentSummary”，
  “属性”：
  {
    “ ContentSummary”：
    {
      “ type”：“ object”，
      “属性”：
      {
        “ directoryCount”：
        {
          “ description”：“目录数。”，
          “ type”：“整数”，
          “必填”：是
        }，
        “ fileCount”：
        {
          “ description”：“文件数。”，
          “ type”：“整数”，
          “必填”：是
        }，
        “长度”：
        {
          “ description”：“内容使用的字节数。”，
          “ type”：“整数”，
          “必填”：是
        }，
        “配额”：
        {
          “ description”：“此目录的名称空间配额。”，
          “ type”：“整数”，
          “必填”：是
        }，
        “ spaceConsumed”：
        {
          “ description”：“内容占用的磁盘空间。”，
          “ type”：“整数”，
          “必填”：是
        }，
        “ spaceQuota”：
        {
          “ description”：“磁盘空间配额。”，
          “ type”：“整数”，
          “必填”：是
        }，
        “ typeQuota”：
        {
          “ type”：“ object”，
          “属性”：
          {
            “存档”：
            {
              “ type”：“ object”，
              “属性”：
              {
                “已消耗”：
                {
                  “ description”：“消耗的存储类型空间。”，
                  “ type”：“整数”，
                  “必填”：是
                }，
                “配额”：
                {
                  “ description”：“存储类型配额。”，
                  “ type”：“整数”，
                  “必填”：是
                }
              }
            }，
            “磁盘”：
            {
              “ type”：“ object”，
              “属性”：
              {
                “已消耗”：
                {
                  “ description”：“消耗的存储类型空间。”，
                  “ type”：“整数”，
                  “必填”：是
                }，
                “配额”：
                {
                  “ description”：“存储类型配额。”，
                  “ type”：“整数”，
                  “必填”：是
                }
              }
            }，
            “ SSD”：
            {
              “ type”：“ object”，
              “属性”：
              {
                “已消耗”：
                {
                  “ description”：“消耗的存储类型空间。”，
                  “ type”：“整数”，
                  “必填”：是
                }，
                “配额”：
                {
                  “ description”：“存储类型配额。”，
                  “ type”：“整数”，
                  “必填”：是
                }
              }
            }
          }
        }
      }
    }
  }
}

另请参阅：GETCONTENTSUMMARY

QuotaUsage JSON模式

{
  “ name”：“ QuotaUsage”，
  “属性”：
  {
    “ QuotaUsage”：
    {
      “ type”：“ object”，
      “属性”：
      {
        “ fileAndDirectoryCount”：
        {
          “ description”：“文件和目录的数量。”，
          “ type”：“整数”，
          “必填”：是
        }，
        “配额”：
        {
          “ description”：“此目录的名称空间配额。”，
          “ type”：“整数”，
          “必填”：是
        }，
        “ spaceConsumed”：
        {
          “ description”：“内容占用的磁盘空间。”，
          “ type”：“整数”，
          “必填”：是
        }，
        “ spaceQuota”：
        {
          “ description”：“磁盘空间配额。”，
          “ type”：“整数”，
          “必填”：是
        }，
        “ typeQuota”：
        {
          “ type”：“ object”，
          “属性”：
          {
            “存档”：
            {
              “ type”：“ object”，
              “属性”：
              {
                “已消耗”：
                {
                  “ description”：“消耗的存储类型空间。”，
                  “ type”：“整数”，
                  “必填”：是
                }，
                “配额”：
                {
                  “ description”：“存储类型配额。”，
                  “ type”：“整数”，
                  “必填”：是
                }
              }
            }，
            “磁盘”：
            {
              “ type”：“ object”，
              “属性”：
              {
                “已消耗”：
                {
                  “ description”：“消耗的存储类型空间。”，
                  “ type”：“整数”，
                  “必填”：是
                }，
                “配额”：
                {
                  “ description”：“存储类型配额。”，
                  “ type”：“整数”，
                  “必填”：是
                }
              }
            }，
            “ SSD”：
            {
              “ type”：“ object”，
              “属性”：
              {
                “已消耗”：
                {
                  “ description”：“消耗的存储类型空间。”，
                  “ type”：“整数”，
                  “必填”：是
                }，
                “配额”：
                {
                  “ description”：“存储类型配额。”，
                  “ type”：“整数”，
                  “必填”：是
                }
              }
            }
          }
        }
      }
    }
  }
}

另请参阅：GETQUOTAUSAGE

FileChecksum JSON模式

{
  “ name”：“ FileChecksum”，
  “属性”：
  {
    “ FileChecksum”：
    {
      “ type”：“ object”，
      “属性”：
      {
        “算法”：
        {
          “ description”：“校验和算法的名称。”，
          “ type”：“ string”，
          “必填”：是
        }，
        “字节”：
        {
          “ description”：“校验和的字节序列，以十六进制表示。”，
          “ type”：“ string”，
          “必填”：是
        }，
        “长度”：
        {
          “ description”：“字节的长度（不是字符串的长度）。”，
          “ type”：“整数”，
          “必填”：是
        }
      }
    }
  }
}

FileStatus JSON模式

{
  “ name”：“ FileStatus”，
  “属性”：
  {
    “ FileStatus”：fileStatusProperties //请参阅FileStatus属性
  }
}

另请参阅：FileStatus属性，GETFILESTATUS，FileStatus

var fileStatusProperties =
{
  “ type”：“ object”，
  “属性”：
  {
    “ accessTime”：
    {
      “ description”：“访问时间。”，
      “ type”：“整数”，
      “必填”：是
    }，
    “ blockSize”：
    {
      “ description”：“文件的块大小。”，
      “ type”：“整数”，
      “必填”：是
    }，
    “组”：
    {
      “ description”：“群组所有者。”，
      “ type”：“ string”，
      “必填”：是
    }，
    “长度”：
    {
      “ description”：“文件中的字节数。”，
      “ type”：“整数”，
      “必填”：是
    }，
    “ modificationTime”：
    {
      “ description”：“修改时间。”，
      “ type”：“整数”，
      “必填”：是
    }，
    “所有者”：
    {
      “ description”：“所有者的用户。”，
      “ type”：“ string”，
      “必填”：是
    }，
    “ pathSuffix”：
    {
      “ description”：“路径后缀。”，
      “ type”：“ string”，
      “必填”：是
    }，
    “允许”：
    {
      “ description”：“权限以八进制字符串表示。”，
      “ type”：“ string”，
      “必填”：是
    }，
    “复制”：
    {
      “ description”：“文件的复制数。”，
      “ type”：“整数”，
      “必填”：是
    }，
   “ symlink”：//可选属性
    {
      “ description”：“符号链接的链接目标。”，
      “ type”：“ string”
    }，
   “类型”：
    {
      “ description”：“路径对象的类型。”，
      “枚举”：[“文件”，“目录”，“ SYMLINK”]，
      “必填”：是
    }
  }
};

FileStatuses JSON模式

甲FileStatuses JSON对象表示的阵列时间filestatus JSON对象。

{
  “ name”：“ FileStatuses”，
  “属性”：
  {
    “ FileStatuses”：
    {
      “ type”：“ object”，
      “属性”：
      {
        “ FileStatus”：
        {
          “ description”：“ FileStatus的数组”，
          “ type”：“ array”，
          “ items”：fileStatusProperties //请参阅FileStatus属性
        }
      }
    }
  }
}

另请参阅：FileStatus属性，LISTSTATUS，FileStatus

DirectoryListing JSON模式

一个Directory上市 JSON对象表示了一批目录条目，而迭代列出目录。它包含一个FileStatuses JSON对象以及迭代信息。

{
  “ name”：“ DirectoryListing”，
  “属性”：
  {
    “ DirectoryListing”：
    {
      “ type”：“ object”，
      “属性”：
      {
        “ partialListing”：
        {
          “ description”：“部分目录清单”，
          “ type”：“ object”，//一个FileStatuses对象
          “必填”：是
        }，
        “剩余条目”：
        {
          “ description”：“剩余条目数”，
          “ type”：“整数”，
          “必填”：是
        }
      }
    }
  }

}

另请参阅：FileStatuses JSON模式，LISTSTATUS_BATCH，FileStatus

长JSON模式

{
  “ name”：“ long”，
  “属性”：
  {
    “长”：
    {
      “ description”：“一个长整数值”，
      “ type”：“整数”，
      “必填”：是
    }
  }
}

另请参阅：RENEWDELEGATIONTOKEN，

路径JSON模式

{
  “ name”：“ Path”，
  “属性”：
  {
    “路径”：
    {
      “ description”：“字符串表示路径。”，
      “ type”：“ string”，
      “必填”：是
    }
  }
}

另请参阅：GETHOMEDIRECTORY，路径

RemoteException JSON模式

{
  “ name”：“ RemoteException”，
  “属性”：
  {
    “ RemoteException”：
    {
      “ type”：“ object”，
      “属性”：
      {
        “例外”：
        {
          “ description”：“例外名称”，
          “ type”：“ string”，
          “必填”：是
        }，
        “信息”：
        {
          “ description”：“异常消息”，
          “ type”：“ string”，
          “必填”：是
        }，
        “ javaClassName”：//可选属性
        {
          “ description”：“异常的Java类名称”，
          “ type”：“ string”
        }
      }
    }
  }
}

另请参阅：错误响应

令牌JSON模式

{
  “ name”：“令牌”，
  “属性”：
  {
    “令牌”：tokenProperties //请参阅令牌属性
  }
}

另请参见：令牌属性，GETDELEGATIONTOKEN，委托中的注释。

var tokenProperties =
{
  “ type”：“ object”，
  “属性”：
  {
    “ urlString”：
    {
      “ description”：“编码为URL安全字符串的委托令牌。”，
      “ type”：“ string”，
      “必填”：是
    }
  }
}

BlockStoragePolicy JSON模式

{
  “ name”：“ BlockStoragePolicy”，
  “属性”：
  {
    “ BlockStoragePolicy”：blockStoragePolicyProperties //请参阅BlockStoragePolicy属性
  }
}

另请参阅：BlockStoragePolicy属性，GETSTORAGEPOLICY

var blockStoragePolicyProperties =
{
  “ type”：“ object”，
  “属性”：
  {
    “ID”：
    {
      “ description”：“政策ID。”，
      “ type”：“整数”，
      “必填”：是
    }，
    “名称”：
    {
      “ description”：“政策名称。”，
      “ type”：“ string”，
      “必填”：是
    }，
    “ storageTypes”：
    {
      “ description”：“用于块放置的存储类型的数组。”，
      “ type”：“ array”，
      “必填”：是
      “项目”：
      {
        “ type”：“字符串”
      }
    }，
    “ replicationFallbacks”：
    {
      “ description”：“用于复制的后备存储类型数组。”，
      “ type”：“ array”，
      “必填”：是
      “项目”：
      {
        “ type”：“字符串”
      }
    }，
    “ creationFallbacks”：
    {
      “ description”：“用于文件创建的后备存储类型的数组。”，
      “ type”：“ array”，
      “必填”：是
      “项目”：
      {
       “ type”：“字符串”
      }
    }，
    “ copyOnCreateFile”：
    {
      “ description”：“如果设置，则在创建文件后无法更改策略。”，
      “ type”：“ boolean”，
      “必填”：是
    }
  }
};

ECPolicy JSON模式

{
  “名称”：“ RS-10-4-1024k”，
  模式{
           “ codecName”：“ rs”，
           “ numDataUnits”：10，
           “ numParityUnits”：4
           “ extraOptions”：{}
          }
  “ cellSize”：1048576，
  “ id”：5，
  “ codecname”：“ rs”，
  “ numDataUnits”：10，
  “ numParityUnits”：4
  “ replicationpolicy”：false，
  “ systemPolicy”：true
}

BlockStoragePolicies JSON模式

甲BlockStoragePolicies JSON对象表示的阵列BlockStoragePolicy JSON对象。

{
  “ name”：“ BlockStoragePolicies”，
  “属性”：
  {
    “ BlockStoragePolicies”：
    {
      “ type”：“ object”，
      “属性”：
      {
        “ BlockStoragePolicy”：
        {
          “ description”：“ BlockStoragePolicy的数组”，
          “ type”：“ array”，
          “ items”：blockStoragePolicyProperties //请参见BlockStoragePolicy属性
        }
      }
    }
  }
}

SnapshotDiffReport JSON模式

{
  “ name”：“ SnapshotDiffReport”，
  “ type”：“对象”，
  “属性”：
  {
    “ SnapshotDiffReport”：
    {
      “ type”：“ object”，
      “属性”：
      {
        “ diffList”：
        {
          “ description”：“ DiffReportEntry的数组”，
          “ type”：“ array”，
          “ items”：diffReportEntries，
          “必填”：是
        }，
        “ fromSnapshot”：
        {
          “ description”：“源快照”，
          “ type”：“ string”，
          “必填”：是
        }，
        “ snapshotRoot”：
        {
          “ description”：“快照根路径的字符串表示形式”，
          “ type”：“ string”，
          “必填”：是
        }，
        “ toSnapshot”：
        {
          “ description”：“目标快照”，
          “ type”：“ string”，
          “必填”：是
        }
      }
    }
  }
}

var diffReportEntries =
{
  “ type”：“对象”，
  “属性”：
  {
    “ sourcePath”：
    {
      “ description”：“相对于快照根的源路径名”，
      “ type”：“ string”，
      “必填”：是
    }，
    “ targetPath”：
    {
      “ description”：“相对于用于重命名的快照根的目标路径”，
      “ type”：“ string”，
      “必填”：是
    }，
    “类型”：
    {
      “ description”：“差异报告条目类型”，
      “枚举”：[“创建”，“修改”，“删除”，“重命名”]，
      “必填”：是
    }
  }
}

SnapshottableDirectoryList JSON模式

{
  “ name”：“ SnapshottableDirectoryList”，
  “ type”：“对象”，
  “属性”：
  {
    “ SnapshottableDirectoryList”：
    {
      “ description”：“ SnapshottableDirectoryStatus的数组”，
      “ type”：“ array”，
      “ items”：snapshottableDirectoryStatus，
      “必填”：是
    }
  }
}

var snapshottableDirectoryStatus =
{
  “ type”：“对象”，
  “属性”：
  {
    “ dirStatus”：fileStatusProperties，
    “ parentFullPath”：
    {
      “ description”：“快照表目录的父级的完整路径”，
      “ type”：“ string”，
      “必填”：是
    }，
    “快照编号”：
    {
      “ description”：“在snapshottable目录上创建的快照数”，
      “ type”：“整数”，
      “必填”：是
    }，
    “ snapshotQuota”：
    {
      “ description”：“快照表目录中允许的快照总数”，
      “ type”：“整数”，
      “必填”：是
    }
  }
}

BlockLocations JSON模式

甲BlockLocations JSON对象表示的阵列BlockLocation JSON对象。

{
  “ name”：“ BlockLocations”，
  “属性”：
  {
    “ BlockLocations”：
    {
      “ type”：“ object”，
      “属性”：
      {
        “ BlockLocation”：
        {
          “ description”：“ BlockLocation的数组”，
          “ type”：“ array”，
          “ items”：blockLocationProperties //参见BlockLocation属性
        }
      }
    }
  }
}

另请参见BlockLocation属性，GETFILEBLOCKLOCATIONS，BlockLocation

BlockLocation JSON模式

{
  “ name”：“ BlockLocation”，
  “属性”：
  {
    “ BlockLocation”：blockLocationProperties //请参见BlockLocation属性
  }
}

另请参见BlockLocation属性，GETFILEBLOCKLOCATIONS，BlockLocation

var blockLocationProperties =
{
  “ type”：“ object”，
  “属性”：
  {
    “ cachedHosts”：
    {
      “ description”：“具有缓存副本的Datanode主机名”，
      “ type”：“ array”，
      “ required”：“ true”，
      “项目”：
      {
        “ description”：“一个数据节点主机名”，
        “ type”：“ string”
      }
    }，
    “腐败”：
    {
      “ description”：“如果该块已损坏，则为真”，
      “ type”：“ boolean”，
      “ required”：“ true”
    }，
    “主机”：
    {
      “ description”：“ Datanode主机名存储该块”，
      “ type”：“ array”，
      “ required”：“ true”，
      “项目”：
      {
        “ description”：“一个数据节点主机名”，
        “ type”：“ string”
      }
    }，
    “长度”：
    {
      “ description”：“块的长度”，
      “ type”：“整数”，
      “ required”：“ true”
    }，
    “名称”：
    {
      “ description”：“用于访问块的数据节点IP：xferPort”，
      “ type”：“ array”，
      “ required”：“ true”，
      “项目”：
      {
        “ description”：“ DatanodeIP：xferPort”，
        “ type”：“ string”
      }
    }，
    “偏移”：
    {
      “ description”：“文件中块的偏移量”，
      “ type”：“整数”，
      “ required”：“ true”
    }，
    “ storageTypes”：
    {
      “ description”：“每个副本的存储类型”，
      “ type”：“ array”，
      “ required”：“ true”，
      “项目”：
      {
        “ description”：“存储类型”，
        “枚举”：[“ RAM_DISK”，“ SSD”，“ DISK”，“ ARCHIVE”]
      }
    }，
    “ topologyPaths”：
    {
      “ description”：“网络拓扑中的数据节点地址”，
      “ type”：“ array”，
      “ required”：“ true”，
      “项目”：
      {
        “ description”：“ / rack / host：ip”，
        “ type”：“ string”
      }
    }
  }
};

ACL规格

XAttr名称

XAttr值

另请参阅：扩展属性

XAttr设置标志

另请参阅：扩展属性

XAttr值编码

另请参阅：扩展属性

访问时间

另请参阅：SETTIMES

块大小

另请参阅：创建

缓冲区大小

另请参见：CREATE，APPEND，OPEN

创建标志

以下组合无效：*追加，创建*创建，追加，覆盖

另请参阅：创建

创建父母

另请参阅：CREATESYMLINK

代表团

请注意，委派令牌被编码为URL安全字符串。见encodeToUrlString（）和decodeFromUrlString（字符串）在org.apache.hadoop.security.token.Token的编码的细节。

另请参阅：身份验证

目的地

另请参阅：CREATESYMLINK，RENAME

做为

另请参阅：代理用户

Fs动作

另请参阅：CHECKACCESS，

组

另请参阅：SETOWNER

长度

另请参阅：打开

修改时间

另请参阅：SETTIMES

新长度

偏移量

另请参阅：打开

旧快照名称

另请参阅：RENAMESNAPSHOT

运维

另请参阅：操作

覆写

另请参阅：创建

所有者

另请参阅：SETOWNER

允许

另请参见：CREATE，MKDIRS，SETPERMISSION

递归的

另请参阅：重命名

续订

另请参阅：GETDELEGATIONTOKEN

复写

另请参见：CREATE，SETREPLICATION

快照名称

另请参见：CREATESNAPSHOT，DELETESNAPSHOT，RENAMESNAPSHOT

资料来源

另请参阅：CONCAT

代币

另请参阅：RENEWDELEGATIONTOKEN，CANCELDELEGATIONTOKEN

代币种类

另请参阅：GETDELEGATIONTOKEN

代币服务

另请参阅：GETDELEGATIONTOKEN

用户名

另请参阅：身份验证

否重定向

另请参阅：创建和写入文件

储存政策

另请参阅：SETSTORAGEPOLICY

删除编码政策

另请参阅：ENABLEECPOLICY或DISABLEECPOLICY

之后开始

另请参阅：LISTSTATUS_BATCH