<commit_before><!---
  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.
-->

WebHDFS REST API
================

* [WebHDFS REST API](#WebHDFS_REST_API)
    * [Document Conventions](#Document_Conventions)
    * [Introduction](#Introduction)
        * [Operations](#Operations)
        * [FileSystem URIs vs HTTP URLs](#FileSystem_URIs_vs_HTTP_URLs)
        * [HDFS Configuration Options](#HDFS_Configuration_Options)
    * [Authentication](#Authentication)
    * [Proxy Users](#Proxy_Users)
    * [Cross-Site Request Forgery Prevention](#Cross-Site_Request_Forgery_Prevention)
    * [WebHDFS Retry Policy](#WebHDFS_Retry_Policy)
    * [File and Directory Operations](#File_and_Directory_Operations)
        * [Create and Write to a File](#Create_and_Write_to_a_File)
        * [Append to a File](#Append_to_a_File)
        * [Concat File(s)](#Concat_Files)
        * [Open and Read a File](#Open_and_Read_a_File)
        * [Make a Directory](#Make_a_Directory)
        * [Create a Symbolic Link](#Create_a_Symbolic_Link)
        * [Rename a File/Directory](#Rename_a_FileDirectory)
        * [Delete a File/Directory](#Delete_a_FileDirectory)
        * [Truncate a File](#Truncate_a_File)
        * [Status of a File/Directory](#Status_of_a_FileDirectory)
        * [List a Directory](#List_a_Directory)
        * [Iteratively List a Directory](#Iteratively_List_a_Directory)
    * [Other File System Operations](#Other_File_System_Operations)
        * [Get Content Summary of a Directory](#Get_Content_Summary_of_a_Directory)
        * [Get File Checksum](#Get_File_Checksum)
        * [Get Home Directory](#Get_Home_Directory)
        * [Set Permission](#Set_Permission)
        * [Set Owner](#Set_Owner)
        * [Set Replication Factor](#Set_Replication_Factor)
        * [Set Access or Modification Time](#Set_Access_or_Modification_Time)
        * [Modify ACL Entries](#Modify_ACL_Entries)
        * [Remove ACL Entries](#Remove_ACL_Entries)
        * [Remove Default ACL](#Remove_Default_ACL)
        * [Remove ACL](#Remove_ACL)
        * [Set ACL](#Set_ACL)
        * [Get ACL Status](#Get_ACL_Status)
        * [Check access](#Check_access)
    * [Extended Attributes(XAttrs) Operations](#Extended_AttributesXAttrs_Operations)
        * [Set XAttr](#Set_XAttr)
        * [Remove XAttr](#Remove_XAttr)
        * [Get an XAttr](#Get_an_XAttr)
        * [Get multiple XAttrs](#Get_multiple_XAttrs)
        * [Get all XAttrs](#Get_all_XAttrs)
        * [List all XAttrs](#List_all_XAttrs)
    * [Snapshot Operations](#Snapshot_Operations)
        * [Create Snapshot](#Create_Snapshot)
        * [Delete Snapshot](#Delete_Snapshot)
        * [Rename Snapshot](#Rename_Snapshot)
    * [Delegation Token Operations](#Delegation_Token_Operations)
        * [Get Delegation Token](#Get_Delegation_Token)
        * [Renew Delegation Token](#Renew_Delegation_Token)
        * [Cancel Delegation Token](#Cancel_Delegation_Token)
    * [Error Responses](#Error_Responses)
        * [HTTP Response Codes](#HTTP_Response_Codes)
            * [Illegal Argument Exception](#Illegal_Argument_Exception)
            * [Security Exception](#Security_Exception)
            * [Access Control Exception](#Access_Control_Exception)
            * [File Not Found Exception](#File_Not_Found_Exception)
    * [JSON Schemas](#JSON_Schemas)
        * [ACL Status JSON Schema](#ACL_Status_JSON_Schema)
        * [XAttrs JSON Schema](#XAttrs_JSON_Schema)
        * [XAttrNames JSON Schema](#XAttrNames_JSON_Schema)
        * [Boolean JSON Schema](#Boolean_JSON_Schema)
        * [ContentSummary JSON Schema](#ContentSummary_JSON_Schema)
        * [FileChecksum JSON Schema](#FileChecksum_JSON_Schema)
        * [FileStatus JSON Schema](#FileStatus_JSON_Schema)
            * [FileStatus Properties](#FileStatus_Properties)
        * [FileStatuses JSON Schema](#FileStatuses_JSON_Schema)
        * [Long JSON Schema](#Long_JSON_Schema)
        * [Path JSON Schema](#Path_JSON_Schema)
        * [RemoteException JSON Schema](#RemoteException_JSON_Schema)
        * [Token JSON Schema](#Token_JSON_Schema)
            * [Token Properties](#Token_Properties)
    * [HTTP Query Parameter Dictionary](#HTTP_Query_Parameter_Dictionary)
        * [ACL Spec](#ACL_Spec)
        * [XAttr Name](#XAttr_Name)
        * [XAttr Value](#XAttr_Value)
        * [XAttr set flag](#XAttr_set_flag)
        * [XAttr value encoding](#XAttr_value_encoding)
        * [Access Time](#Access_Time)
        * [Block Size](#Block_Size)
        * [Buffer Size](#Buffer_Size)
        * [Create Flag](#Create_Flag)
        * [Create Parent](#Create_Parent)
        * [Delegation](#Delegation)
        * [Destination](#Destination)
        * [Do As](#Do_As)
        * [Fs Action](#Fs_Action)
        * [Group](#Group)
        * [Length](#Length)
        * [Modification Time](#Modification_Time)
        * [Offset](#Offset)
        * [Old Snapshot Name](#Old_Snapshot_Name)
        * [Op](#Op)
        * [Overwrite](#Overwrite)
        * [Owner](#Owner)
        * [Permission](#Permission)
        * [Recursive](#Recursive)
        * [Renewer](#Renewer)
        * [Replication](#Replication)
        * [Snapshot Name](#Snapshot_Name)
        * [Sources](#Sources)
        * [Token](#Token)
        * [Token Kind](#Token_Kind)
        * [Token Service](#Token_Service)
        * [Username](#Username)
        * [NoRedirect](#NoRedirect)

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 [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html)/[FileContext](../../api/org/apache/hadoop/fs/FileContext.html) interface for HDFS. The operations and the corresponding FileSystem/FileContext methods are shown in the next section. The Section [HTTP Query Parameter Dictionary](#HTTP_Query_Parameter_Dictionary) specifies the parameter details such as the defaults and the valid values.

### Operations

*   HTTP GET
    * [`OPEN`](#Open_and_Read_a_File) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).open)
    * [`GETFILESTATUS`](#Status_of_a_FileDirectory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getFileStatus)
    * [`LISTSTATUS`](#List_a_Directory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).listStatus)
    * [`LISTSTATUS_BATCH`](#Iteratively_List_a_Directory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).listStatusIterator)
    * [`GETCONTENTSUMMARY`](#Get_Content_Summary_of_a_Directory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getContentSummary)
    * [`GETFILECHECKSUM`](#Get_File_Checksum) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getFileChecksum)
    * [`GETHOMEDIRECTORY`](#Get_Home_Directory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getHomeDirectory)
    * [`GETDELEGATIONTOKEN`](#Get_Delegation_Token) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getDelegationToken)
    * [`GETXATTRS`](#Get_an_XAttr) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getXAttr)
    * [`GETXATTRS`](#Get_multiple_XAttrs) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getXAttrs)
    * [`GETXATTRS`](#Get_all_XAttrs) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getXAttrs)
    * [`LISTXATTRS`](#List_all_XAttrs) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).listXAttrs)
    * [`CHECKACCESS`](#Check_access) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).access)
*   HTTP PUT
    * [`CREATE`](#Create_and_Write_to_a_File) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).create)
    * [`MKDIRS`](#Make_a_Directory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).mkdirs)
    * [`CREATESYMLINK`](#Create_a_Symbolic_Link) (see [FileContext](../../api/org/apache/hadoop/fs/FileContext.html).createSymlink)
    * [`RENAME`](#Rename_a_FileDirectory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).rename)
    * [`SETREPLICATION`](#Set_Replication_Factor) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).setReplication)
    * [`SETOWNER`](#Set_Owner) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).setOwner)
    * [`SETPERMISSION`](#Set_Permission) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).setPermission)
    * [`SETTIMES`](#Set_Access_or_Modification_Time) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).setTimes)
    * [`RENEWDELEGATIONTOKEN`](#Renew_Delegation_Token) (see [DelegationTokenAuthenticator](../../api/org/apache/hadoop/security/token/delegation/web/DelegationTokenAuthenticator.html).renewDelegationToken)
    * [`CANCELDELEGATIONTOKEN`](#Cancel_Delegation_Token) (see [DelegationTokenAuthenticator](../../api/org/apache/hadoop/security/token/delegation/web/DelegationTokenAuthenticator.html).cancelDelegationToken)
    * [`CREATESNAPSHOT`](#Create_Snapshot) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).createSnapshot)
    * [`RENAMESNAPSHOT`](#Rename_Snapshot) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).renameSnapshot)
    * [`SETXATTR`](#Set_XAttr) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).setXAttr)
    * [`REMOVEXATTR`](#Remove_XAttr) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).removeXAttr)
*   HTTP POST
    * [`APPEND`](#Append_to_a_File) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).append)
    * [`CONCAT`](#Concat_Files) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).concat)
    * [`TRUNCATE`](#Truncate_a_File) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).concat)
*   HTTP DELETE
    * [`DELETE`](#Delete_a_FileDirectory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).delete)
    * [`DELETESNAPSHOT`](#Delete_Snapshot) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).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><commit_msg>HDFS-10947. Correct the API name for truncate in webhdfs document. Contributed by <NAME><commit_after><!---
  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.
-->

WebHDFS REST API
================

* [WebHDFS REST API](#WebHDFS_REST_API)
    * [Document Conventions](#Document_Conventions)
    * [Introduction](#Introduction)
        * [Operations](#Operations)
        * [FileSystem URIs vs HTTP URLs](#FileSystem_URIs_vs_HTTP_URLs)
        * [HDFS Configuration Options](#HDFS_Configuration_Options)
    * [Authentication](#Authentication)
    * [Proxy Users](#Proxy_Users)
    * [Cross-Site Request Forgery Prevention](#Cross-Site_Request_Forgery_Prevention)
    * [WebHDFS Retry Policy](#WebHDFS_Retry_Policy)
    * [File and Directory Operations](#File_and_Directory_Operations)
        * [Create and Write to a File](#Create_and_Write_to_a_File)
        * [Append to a File](#Append_to_a_File)
        * [Concat File(s)](#Concat_Files)
        * [Open and Read a File](#Open_and_Read_a_File)
        * [Make a Directory](#Make_a_Directory)
        * [Create a Symbolic Link](#Create_a_Symbolic_Link)
        * [Rename a File/Directory](#Rename_a_FileDirectory)
        * [Delete a File/Directory](#Delete_a_FileDirectory)
        * [Truncate a File](#Truncate_a_File)
        * [Status of a File/Directory](#Status_of_a_FileDirectory)
        * [List a Directory](#List_a_Directory)
        * [Iteratively List a Directory](#Iteratively_List_a_Directory)
    * [Other File System Operations](#Other_File_System_Operations)
        * [Get Content Summary of a Directory](#Get_Content_Summary_of_a_Directory)
        * [Get File Checksum](#Get_File_Checksum)
        * [Get Home Directory](#Get_Home_Directory)
        * [Set Permission](#Set_Permission)
        * [Set Owner](#Set_Owner)
        * [Set Replication Factor](#Set_Replication_Factor)
        * [Set Access or Modification Time](#Set_Access_or_Modification_Time)
        * [Modify ACL Entries](#Modify_ACL_Entries)
        * [Remove ACL Entries](#Remove_ACL_Entries)
        * [Remove Default ACL](#Remove_Default_ACL)
        * [Remove ACL](#Remove_ACL)
        * [Set ACL](#Set_ACL)
        * [Get ACL Status](#Get_ACL_Status)
        * [Check access](#Check_access)
    * [Extended Attributes(XAttrs) Operations](#Extended_AttributesXAttrs_Operations)
        * [Set XAttr](#Set_XAttr)
        * [Remove XAttr](#Remove_XAttr)
        * [Get an XAttr](#Get_an_XAttr)
        * [Get multiple XAttrs](#Get_multiple_XAttrs)
        * [Get all XAttrs](#Get_all_XAttrs)
        * [List all XAttrs](#List_all_XAttrs)
    * [Snapshot Operations](#Snapshot_Operations)
        * [Create Snapshot](#Create_Snapshot)
        * [Delete Snapshot](#Delete_Snapshot)
        * [Rename Snapshot](#Rename_Snapshot)
    * [Delegation Token Operations](#Delegation_Token_Operations)
        * [Get Delegation Token](#Get_Delegation_Token)
        * [Renew Delegation Token](#Renew_Delegation_Token)
        * [Cancel Delegation Token](#Cancel_Delegation_Token)
    * [Error Responses](#Error_Responses)
        * [HTTP Response Codes](#HTTP_Response_Codes)
            * [Illegal Argument Exception](#Illegal_Argument_Exception)
            * [Security Exception](#Security_Exception)
            * [Access Control Exception](#Access_Control_Exception)
            * [File Not Found Exception](#File_Not_Found_Exception)
    * [JSON Schemas](#JSON_Schemas)
        * [ACL Status JSON Schema](#ACL_Status_JSON_Schema)
        * [XAttrs JSON Schema](#XAttrs_JSON_Schema)
        * [XAttrNames JSON Schema](#XAttrNames_JSON_Schema)
        * [Boolean JSON Schema](#Boolean_JSON_Schema)
        * [ContentSummary JSON Schema](#ContentSummary_JSON_Schema)
        * [FileChecksum JSON Schema](#FileChecksum_JSON_Schema)
        * [FileStatus JSON Schema](#FileStatus_JSON_Schema)
            * [FileStatus Properties](#FileStatus_Properties)
        * [FileStatuses JSON Schema](#FileStatuses_JSON_Schema)
        * [Long JSON Schema](#Long_JSON_Schema)
        * [Path JSON Schema](#Path_JSON_Schema)
        * [RemoteException JSON Schema](#RemoteException_JSON_Schema)
        * [Token JSON Schema](#Token_JSON_Schema)
            * [Token Properties](#Token_Properties)
    * [HTTP Query Parameter Dictionary](#HTTP_Query_Parameter_Dictionary)
        * [ACL Spec](#ACL_Spec)
        * [XAttr Name](#XAttr_Name)
        * [XAttr Value](#XAttr_Value)
        * [XAttr set flag](#XAttr_set_flag)
        * [XAttr value encoding](#XAttr_value_encoding)
        * [Access Time](#Access_Time)
        * [Block Size](#Block_Size)
        * [Buffer Size](#Buffer_Size)
        * [Create Flag](#Create_Flag)
        * [Create Parent](#Create_Parent)
        * [Delegation](#Delegation)
        * [Destination](#Destination)
        * [Do As](#Do_As)
        * [Fs Action](#Fs_Action)
        * [Group](#Group)
        * [Length](#Length)
        * [Modification Time](#Modification_Time)
        * [Offset](#Offset)
        * [Old Snapshot Name](#Old_Snapshot_Name)
        * [Op](#Op)
        * [Overwrite](#Overwrite)
        * [Owner](#Owner)
        * [Permission](#Permission)
        * [Recursive](#Recursive)
        * [Renewer](#Renewer)
        * [Replication](#Replication)
        * [Snapshot Name](#Snapshot_Name)
        * [Sources](#Sources)
        * [Token](#Token)
        * [Token Kind](#Token_Kind)
        * [Token Service](#Token_Service)
        * [Username](#Username)
        * [NoRedirect](#NoRedirect)

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 [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html)/[FileContext](../../api/org/apache/hadoop/fs/FileContext.html) interface for HDFS. The operations and the corresponding FileSystem/FileContext methods are shown in the next section. The Section [HTTP Query Parameter Dictionary](#HTTP_Query_Parameter_Dictionary) specifies the parameter details such as the defaults and the valid values.

### Operations

*   HTTP GET
    * [`OPEN`](#Open_and_Read_a_File) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).open)
    * [`GETFILESTATUS`](#Status_of_a_FileDirectory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getFileStatus)
    * [`LISTSTATUS`](#List_a_Directory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).listStatus)
    * [`LISTSTATUS_BATCH`](#Iteratively_List_a_Directory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).listStatusIterator)
    * [`GETCONTENTSUMMARY`](#Get_Content_Summary_of_a_Directory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getContentSummary)
    * [`GETFILECHECKSUM`](#Get_File_Checksum) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getFileChecksum)
    * [`GETHOMEDIRECTORY`](#Get_Home_Directory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getHomeDirectory)
    * [`GETDELEGATIONTOKEN`](#Get_Delegation_Token) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getDelegationToken)
    * [`GETXATTRS`](#Get_an_XAttr) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getXAttr)
    * [`GETXATTRS`](#Get_multiple_XAttrs) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getXAttrs)
    * [`GETXATTRS`](#Get_all_XAttrs) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).getXAttrs)
    * [`LISTXATTRS`](#List_all_XAttrs) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).listXAttrs)
    * [`CHECKACCESS`](#Check_access) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).access)
*   HTTP PUT
    * [`CREATE`](#Create_and_Write_to_a_File) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).create)
    * [`MKDIRS`](#Make_a_Directory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).mkdirs)
    * [`CREATESYMLINK`](#Create_a_Symbolic_Link) (see [FileContext](../../api/org/apache/hadoop/fs/FileContext.html).createSymlink)
    * [`RENAME`](#Rename_a_FileDirectory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).rename)
    * [`SETREPLICATION`](#Set_Replication_Factor) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).setReplication)
    * [`SETOWNER`](#Set_Owner) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).setOwner)
    * [`SETPERMISSION`](#Set_Permission) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).setPermission)
    * [`SETTIMES`](#Set_Access_or_Modification_Time) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).setTimes)
    * [`RENEWDELEGATIONTOKEN`](#Renew_Delegation_Token) (see [DelegationTokenAuthenticator](../../api/org/apache/hadoop/security/token/delegation/web/DelegationTokenAuthenticator.html).renewDelegationToken)
    * [`CANCELDELEGATIONTOKEN`](#Cancel_Delegation_Token) (see [DelegationTokenAuthenticator](../../api/org/apache/hadoop/security/token/delegation/web/DelegationTokenAuthenticator.html).cancelDelegationToken)
    * [`CREATESNAPSHOT`](#Create_Snapshot) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).createSnapshot)
    * [`RENAMESNAPSHOT`](#Rename_Snapshot) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).renameSnapshot)
    * [`SETXATTR`](#Set_XAttr) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).setXAttr)
    * [`REMOVEXATTR`](#Remove_XAttr) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).removeXAttr)
*   HTTP POST
    * [`APPEND`](#Append_to_a_File) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).append)
    * [`CONCAT`](#Concat_Files) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).concat)
    * [`TRUNCATE`](#Truncate_a_File) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).truncate)
*   HTTP DELETE
    * [`DELETE`](#Delete_a_FileDirectory) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).delete)
    * [`DELETESNAPSHOT`](#Delete_Snapshot) (see [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).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>
{'fraction_non_alphanumeric': 0.15619534508273913, 'fraction_numerical': 0.0005829857841158796, 'mean_word_length': 3.8796498905908097, 'pattern_counts': {'":': 0, '<': 20, '<?xml version=': 0, '>': 20, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4151922', 'n_tokens_mistral': 7248, 'n_tokens_neox': 6903, 'n_words': 1165}