Microsoft Azure Azure Data Lake Storage REST API — Filesystem Operations

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure Data Lake Storage REST API — Filesystem Operations
  description: 'Microsoft Azure Azure Data Lake Storage REST API — Filesystem Operations. 5 operations. Lead operation: Microsoft
    Azure Create Filesystem. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Filesystem Operations
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: azure-data-lake-storage-rest-filesystem-operations
    baseUri: ''
    description: Microsoft Azure Azure Data Lake Storage REST API — Filesystem Operations business capability. Self-contained,
      no shared references.
    resources:
    - name: filesystem
      path: /{filesystem}
      operations:
      - name: microsoftazurefilesystemcreate
        method: PUT
        description: Microsoft Azure Create Filesystem
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: x-ms-properties
          in: header
          type: string
          description: 'User-defined properties to be stored with the filesystem, in the format of a comma-separated list
            of name and value pairs "n1=v1, n2=v2, ...", where each value '
      - name: microsoftazurefilesystemsetproperties
        method: PATCH
        description: Microsoft Azure Set Filesystem Properties
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: x-ms-properties
          in: header
          type: string
          description: Optional. User-defined properties to be stored with the filesystem, in the format of a comma-separated
            list of name and value pairs "n1=v1, n2=v2, ...", where e
        - name: If-Modified-Since
          in: header
          type: string
          description: Optional. A date and time value. Specify this header to perform the operation only if the resource
            has been modified since the specified date and time.
        - name: If-Unmodified-Since
          in: header
          type: string
          description: Optional. A date and time value. Specify this header to perform the operation only if the resource
            has not been modified since the specified date and time.
      - name: microsoftazurepathlist
        method: GET
        description: Microsoft Azure List Paths
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: directory
          in: query
          type: string
          description: Filters results to paths within the specified directory. An error occurs if the directory does not
            exist.
        - name: recursive
          in: query
          type: boolean
          description: 'If "true", all paths are listed; otherwise, only paths at the root of the filesystem are listed.  If
            "directory" is specified, the list will only include paths '
          required: true
        - name: continuation
          in: query
          type: string
          description: 'The number of paths returned with each invocation is limited. If the number of paths to be returned
            exceeds this limit, a continuation token is returned in the '
        - name: maxResults
          in: query
          type: integer
          description: An optional value that specifies the maximum number of items to return. If omitted or greater than
            5,000, the response will include up to 5,000 items.
        - name: upn
          in: query
          type: boolean
          description: 'Optional. Valid only when Hierarchical Namespace is enabled for the account. If "true", the user identity
            values returned in the owner and group fields of each '
      - name: microsoftazurefilesystemgetproperties
        method: HEAD
        description: Microsoft Azure Get Filesystem Properties
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: microsoftazurefilesystemdelete
        method: DELETE
        description: Microsoft Azure Delete Filesystem
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Modified-Since
          in: header
          type: string
          description: Optional. A date and time value. Specify this header to perform the operation only if the resource
            has been modified since the specified date and time.
        - name: If-Unmodified-Since
          in: header
          type: string
          description: Optional. A date and time value. Specify this header to perform the operation only if the resource
            has not been modified since the specified date and time.
  exposes:
  - type: rest
    namespace: azure-data-lake-storage-rest-filesystem-operations-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure Data Lake Storage REST API — Filesystem Operations. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/{filesystem}
      name: filesystem
      description: REST surface for filesystem.
      operations:
      - method: PUT
        name: microsoftazurefilesystemcreate
        description: Microsoft Azure Create Filesystem
        call: azure-data-lake-storage-rest-filesystem-operations.microsoftazurefilesystemcreate
        with:
          x-ms-properties: rest.x-ms-properties
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: microsoftazurefilesystemsetproperties
        description: Microsoft Azure Set Filesystem Properties
        call: azure-data-lake-storage-rest-filesystem-operations.microsoftazurefilesystemsetproperties
        with:
          x-ms-properties: rest.x-ms-properties
          If-Modified-Since: rest.If-Modified-Since
          If-Unmodified-Since: rest.If-Unmodified-Since
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: microsoftazurepathlist
        description: Microsoft Azure List Paths
        call: azure-data-lake-storage-rest-filesystem-operations.microsoftazurepathlist
        with:
          directory: rest.directory
          recursive: rest.recursive
          continuation: rest.continuation
          maxResults: rest.maxResults
          upn: rest.upn
        outputParameters:
        - type: object
          mapping: $.
      - method: HEAD
        name: microsoftazurefilesystemgetproperties
        description: Microsoft Azure Get Filesystem Properties
        call: azure-data-lake-storage-rest-filesystem-operations.microsoftazurefilesystemgetproperties
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazurefilesystemdelete
        description: Microsoft Azure Delete Filesystem
        call: azure-data-lake-storage-rest-filesystem-operations.microsoftazurefilesystemdelete
        with:
          If-Modified-Since: rest.If-Modified-Since
          If-Unmodified-Since: rest.If-Unmodified-Since
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-data-lake-storage-rest-filesystem-operations-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure Data Lake Storage REST API — Filesystem Operations. One tool per consumed
      operation, routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-create-filesystem
      description: Microsoft Azure Create Filesystem
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: azure-data-lake-storage-rest-filesystem-operations.microsoftazurefilesystemcreate
      with:
        x-ms-properties: tools.x-ms-properties
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-set-filesystem-properties
      description: Microsoft Azure Set Filesystem Properties
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: azure-data-lake-storage-rest-filesystem-operations.microsoftazurefilesystemsetproperties
      with:
        x-ms-properties: tools.x-ms-properties
        If-Modified-Since: tools.If-Modified-Since
        If-Unmodified-Since: tools.If-Unmodified-Since
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-list-paths
      description: Microsoft Azure List Paths
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-data-lake-storage-rest-filesystem-operations.microsoftazurepathlist
      with:
        directory: tools.directory
        recursive: tools.recursive
        continuation: tools.continuation
        maxResults: tools.maxResults
        upn: tools.upn
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-filesystem-properties
      description: Microsoft Azure Get Filesystem Properties
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-data-lake-storage-rest-filesystem-operations.microsoftazurefilesystemgetproperties
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-filesystem
      description: Microsoft Azure Delete Filesystem
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: azure-data-lake-storage-rest-filesystem-operations.microsoftazurefilesystemdelete
      with:
        If-Modified-Since: tools.If-Modified-Since
        If-Unmodified-Since: tools.If-Unmodified-Since
      outputParameters:
      - type: object
        mapping: $.