naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure DataLakeStoreFileSystemManagementClient — FileSystem
  description: 'Microsoft Azure DataLakeStoreFileSystemManagementClient — FileSystem. 3 operations. Lead operation: Microsoft
    Azure Put Webhdfsext Path. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - FileSystem
  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: datalakestorefilesystemmanagementclient-filesystem
    baseUri: ''
    description: Microsoft Azure DataLakeStoreFileSystemManagementClient — FileSystem business capability. Self-contained,
      no shared references.
    resources:
    - name: WebHdfsExt-path
      path: /WebHdfsExt/{path}
      operations:
      - name: microsoftazurefilesystemsetfileexpiry
        method: PUT
        description: Microsoft Azure Put Webhdfsext Path
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: path
          in: path
          type: string
          description: The Data Lake Store path (starting with '/') of the file on which to set or remove the expiration time.
          required: true
        - name: expiryOption
          in: query
          type: string
          description: 'Indicates the type of expiration to use for the file: 1. NeverExpire: ExpireTime is ignored. 2. RelativeToNow:
            ExpireTime is an integer in milliseconds represen'
          required: true
        - name: expireTime
          in: query
          type: integer
          description: The time that the file will expire, corresponding to the ExpiryOption that was set.
        - name: op
          in: query
          type: string
          description: The constant value for the operation.
          required: true
      - name: microsoftazurefilesystemconcurrentappend
        method: POST
        description: Microsoft Azure Post Webhdfsext Path
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: path
          in: path
          type: string
          description: The Data Lake Store path (starting with '/') of the file to which to append using concurrent append.
          required: true
        - name: streamContents
          in: body
          type: object
          description: The file contents to include when appending to the file.  The maximum content size is 4MB.  For content
            larger than 4MB you must append the content in 4MB chunk
          required: true
        - name: appendMode
          in: query
          type: string
          description: Indicates the concurrent append call should create the file if it doesn't exist or just open the existing
            file for append
        - name: op
          in: query
          type: string
          description: The constant value for the operation.
          required: true
        - name: Transfer-Encoding
          in: header
          type: string
          description: Indicates the data being sent to the server is being streamed in chunks.
          required: true
        - name: syncFlag
          in: query
          type: string
          description: Optionally indicates what to do after completion of the concurrent append. DATA indicates that more
            data will be sent immediately by the client, the file handle
    - name: webhdfs-v1-path
      path: /webhdfs/v1/{path}
      operations:
      - name: microsoftazurefilesystemcheckaccess
        method: GET
        description: Microsoft Azure Get Webhdfs Path
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: path
          in: path
          type: string
          description: The Data Lake Store path (starting with '/') of the file or directory for which to check access.
          required: true
        - name: fsaction
          in: query
          type: string
          description: File system operation read/write/execute in string form, matching regex pattern '[rwx-]{3}'
          required: true
        - name: op
          in: query
          type: string
          description: The constant value for the operation.
          required: true
  exposes:
  - type: rest
    namespace: datalakestorefilesystemmanagementclient-filesystem-rest
    port: 8080
    description: REST adapter for Microsoft Azure DataLakeStoreFileSystemManagementClient — FileSystem. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/webhdfsext/{path}
      name: webhdfsext-path
      description: REST surface for WebHdfsExt-path.
      operations:
      - method: PUT
        name: microsoftazurefilesystemsetfileexpiry
        description: Microsoft Azure Put Webhdfsext Path
        call: datalakestorefilesystemmanagementclient-filesystem.microsoftazurefilesystemsetfileexpiry
        with:
          path: rest.path
          expiryOption: rest.expiryOption
          expireTime: rest.expireTime
          op: rest.op
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazurefilesystemconcurrentappend
        description: Microsoft Azure Post Webhdfsext Path
        call: datalakestorefilesystemmanagementclient-filesystem.microsoftazurefilesystemconcurrentappend
        with:
          path: rest.path
          streamContents: rest.streamContents
          appendMode: rest.appendMode
          op: rest.op
          Transfer-Encoding: rest.Transfer-Encoding
          syncFlag: rest.syncFlag
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/webhdfs/v1/{path}
      name: webhdfs-v1-path
      description: REST surface for webhdfs-v1-path.
      operations:
      - method: GET
        name: microsoftazurefilesystemcheckaccess
        description: Microsoft Azure Get Webhdfs Path
        call: datalakestorefilesystemmanagementclient-filesystem.microsoftazurefilesystemcheckaccess
        with:
          path: rest.path
          fsaction: rest.fsaction
          op: rest.op
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: datalakestorefilesystemmanagementclient-filesystem-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure DataLakeStoreFileSystemManagementClient — FileSystem. One tool per consumed
      operation, routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-put-webhdfsext-path
      description: Microsoft Azure Put Webhdfsext Path
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: datalakestorefilesystemmanagementclient-filesystem.microsoftazurefilesystemsetfileexpiry
      with:
        path: tools.path
        expiryOption: tools.expiryOption
        expireTime: tools.expireTime
        op: tools.op
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-webhdfsext-path
      description: Microsoft Azure Post Webhdfsext Path
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: datalakestorefilesystemmanagementclient-filesystem.microsoftazurefilesystemconcurrentappend
      with:
        path: tools.path
        streamContents: tools.streamContents
        appendMode: tools.appendMode
        op: tools.op
        Transfer-Encoding: tools.Transfer-Encoding
        syncFlag: tools.syncFlag
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-webhdfs-path
      description: Microsoft Azure Get Webhdfs Path
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datalakestorefilesystemmanagementclient-filesystem.microsoftazurefilesystemcheckaccess
      with:
        path: tools.path
        fsaction: tools.fsaction
        op: tools.op
      outputParameters:
      - type: object
        mapping: $.