Azure Data Lake Storage Filesystems API

openapi: 3.1.0
info:
  title: Azure Data Lake Storage Gen2 REST Filesystems API
  description: Azure Data Lake Storage Gen2 REST API supports filesystem and path operations on hierarchical namespace storage accounts. Authentication is via Shared Key, SAS, or Azure AD bearer tokens.
  version: '2024-05-04'
servers:
- url: https://{account}.dfs.core.windows.net
  variables:
    account:
      default: myaccount
      description: Storage account name
security:
- sharedKey: []
- sasToken: []
tags:
- name: Filesystems
  description: Filesystems operations
paths:
  /:
    get:
      operationId: listContainers
      summary: Azure Data Lake Storage Gen2 REST API List
      description: Lists filesystems in the account.
      tags:
      - Filesystems
      parameters:
      - name: comp
        in: query
        required: true
        schema:
          type: string
          enum:
          - list
      responses:
        '200':
          description: Filesystems listing
          content:
            application/xml:
              schema:
                type: object
  /{container}:
    parameters:
    - name: container
      in: path
      required: true
      schema:
        type: string
    put:
      operationId: createContainer
      summary: Azure Data Lake Storage Gen2 REST API Create
      description: Creates a new filesystem.
      tags:
      - Filesystems
      responses:
        '201':
          description: Created
    get:
      operationId: getContainerProperties
      summary: Azure Data Lake Storage Gen2 REST API Get properties
      description: Returns the properties of the filesystem.
      tags:
      - Filesystems
      responses:
        '200':
          description: Properties
    delete:
      operationId: deleteContainer
      summary: Azure Data Lake Storage Gen2 REST API Delete
      description: Deletes the filesystem.
      tags:
      - Filesystems
      responses:
        '202':
          description: Deletion accepted
  /{container}/{path}:
    parameters:
    - name: container
      in: path
      required: true
      schema:
        type: string
    - name: path
      in: path
      required: true
      schema:
        type: string
    put:
      operationId: putItem
      summary: Azure Data Lake Storage Gen2 REST API Put item
      description: Creates or updates a resource at the path.
      tags:
      - Filesystems
      requestBody:
        content:
          application/octet-stream:
            schema:
              type: string
              format: binary
      responses:
        '201':
          description: Created
    get:
      operationId: getItem
      summary: Azure Data Lake Storage Gen2 REST API Get item
      description: Retrieves a resource at the path.
      tags:
      - Filesystems
      responses:
        '200':
          description: OK
    delete:
      operationId: deleteItem
      summary: Azure Data Lake Storage Gen2 REST API Delete item
      description: Deletes a resource at the path.
      tags:
      - Filesystems
      responses:
        '202':
          description: Deletion accepted
components:
  securitySchemes:
    sharedKey:
      type: apiKey
      in: header
      name: Authorization
      description: Shared Key authentication
    sasToken:
      type: apiKey
      in: query
      name: sig
      description: Shared Access Signature token
externalDocs:
  description: Azure Data Lake Storage Gen2 REST API Documentation
  url: https://learn.microsoft.com/en-us/rest/api/storageservices/data-lake-storage-gen2
x-generated-from: https://learn.microsoft.com/en-us/rest/api/storageservices/data-lake-storage-gen2
x-generated-by: claude-crawl-2026-05-08