naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Managed Lustre client — amlFilesystems
  description: 'Microsoft Azure Managed Lustre client — amlFilesystems. 10 operations. Lead operation: Microsoft Azure Get
    Subscriptions Subscriptionid Providers Microsoft Storagecache Amlfilesystems. Self-contained Naftiko capability covering
    one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - amlFilesystems
  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: managed-lustre-client-amlfilesystems
    baseUri: https://management.azure.com
    description: Microsoft Azure Managed Lustre client — amlFilesystems business capability. Self-contained, no shared references.
    resources:
    - name: subscriptions-subscriptionId-providers-Microsoft.StorageCache-amlFilesystems
      path: /subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/amlFilesystems
      operations:
      - name: microsoftazureamlfilesystemslist
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Storagecache Amlfilesystems
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionId-providers-Microsoft.StorageCache-checkAmlFSSubnets
      path: /subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/checkAmlFSSubnets
      operations:
      - name: microsoftazurecheckamlfssubnets
        method: POST
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Storagecache Checkamlfssubnets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: amlFilesystemSubnetInfo
          in: body
          type: string
          description: Information about the subnets to validate.
    - name: subscriptions-subscriptionId-providers-Microsoft.StorageCache-getRequiredAmlFSSu
      path: /subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/getRequiredAmlFSSubnetsSize
      operations:
      - name: microsoftazuregetrequiredamlfssubnetssize
        method: POST
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Storagecache Getrequiredamlfssubnetssize
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: requiredAMLFilesystemSubnetsSizeInfo
          in: body
          type: string
          description: Information to determine the number of available IPs a subnet will need to host the AML file system.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems
      operations:
      - name: microsoftazureamlfilesystemslistbyresourcegroup
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}
      operations:
      - name: microsoftazureamlfilesystemsdelete
        method: DELETE
        description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: microsoftazureamlfilesystemsget
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: microsoftazureamlfilesystemscreateorupdate
        method: PUT
        description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: amlFilesystem
          in: body
          type: string
          description: Object containing the user-selectable properties of the AML file system. If read-only properties are
            included, they must match the existing values of those prop
          required: true
      - name: microsoftazureamlfilesystemsupdate
        method: PATCH
        description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: amlFilesystem
          in: body
          type: string
          description: Object containing the user-selectable properties of the AML file system. If read-only properties are
            included, they must match the existing values of those prop
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}/archive
      operations:
      - name: microsoftazureamlfilesystemsarchive
        method: POST
        description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname Archive
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: archiveInfo
          in: body
          type: string
          description: Information about the archive operation
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}/cancelArchive
      operations:
      - name: microsoftazureamlfilesystemscancelarchive
        method: POST
        description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname Cancelarchive
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: managed-lustre-client-amlfilesystems-rest
    port: 8080
    description: REST adapter for Microsoft Azure Managed Lustre client — amlFilesystems. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-storagecache/amlfilesystems
      name: subscriptions-subscriptionid-providers-microsoft-storagecache-amlfilesystems
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.StorageCache-amlFilesystems.
      operations:
      - method: GET
        name: microsoftazureamlfilesystemslist
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Storagecache Amlfilesystems
        call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemslist
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-storagecache/checkamlfssubnets
      name: subscriptions-subscriptionid-providers-microsoft-storagecache-checkamlfssubnets
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.StorageCache-checkAmlFSSubnets.
      operations:
      - method: POST
        name: microsoftazurecheckamlfssubnets
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Storagecache Checkamlfssubnets
        call: managed-lustre-client-amlfilesystems.microsoftazurecheckamlfssubnets
        with:
          amlFilesystemSubnetInfo: rest.amlFilesystemSubnetInfo
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-storagecache/getrequiredamlfssubnetssize
      name: subscriptions-subscriptionid-providers-microsoft-storagecache-getrequiredamlfssu
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.StorageCache-getRequiredAmlFSSu.
      operations:
      - method: POST
        name: microsoftazuregetrequiredamlfssubnetssize
        description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Storagecache Getrequiredamlfssubnetssize
        call: managed-lustre-client-amlfilesystems.microsoftazuregetrequiredamlfssubnetssize
        with:
          requiredAMLFilesystemSubnetsSizeInfo: rest.requiredAMLFilesystemSubnetsSizeInfo
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-storagecache/amlfilesystems
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazureamlfilesystemslistbyresourcegroup
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems
        call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemslistbyresourcegroup
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-storagecache/amlfilesystems/{amlfilesystemname}
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: DELETE
        name: microsoftazureamlfilesystemsdelete
        description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname
        call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemsdelete
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: microsoftazureamlfilesystemsget
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname
        call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemsget
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: microsoftazureamlfilesystemscreateorupdate
        description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname
        call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemscreateorupdate
        with:
          amlFilesystem: rest.amlFilesystem
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: microsoftazureamlfilesystemsupdate
        description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname
        call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemsupdate
        with:
          amlFilesystem: rest.amlFilesystem
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-storagecache/amlfilesystems/{amlfilesystemname}/archive
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazureamlfilesystemsarchive
        description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname Archive
        call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemsarchive
        with:
          archiveInfo: rest.archiveInfo
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-storagecache/amlfilesystems/{amlfilesystemname}/cancelarchive
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazureamlfilesystemscancelarchive
        description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Storagecache Amlfilesystems Amlfilesystemname Cancelarchive
        call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemscancelarchive
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: managed-lustre-client-amlfilesystems-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Managed Lustre client — amlFilesystems. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-get-subscriptions-subscriptionid
      description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Storagecache Amlfilesystems
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemslist
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-subscriptions-subscriptionid
      description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Storagecache Checkamlfssubnets
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: managed-lustre-client-amlfilesystems.microsoftazurecheckamlfssubnets
      with:
        amlFilesystemSubnetInfo: tools.amlFilesystemSubnetInfo
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-subscriptions-subscriptionid-2
      description: Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Storagecache Getrequiredamlfssubnetssize
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: managed-lustre-client-amlfilesystems.microsoftazuregetrequiredamlfssubnetssize
      with:
        requiredAMLFilesystemSubnetsSizeInfo: tools.requiredAMLFilesystemSubnetsSizeInfo
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-2
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Storagecache
        Amlfilesystems
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemslistbyresourcegroup
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-subscriptions-subscriptionid
      description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Storagecache Amlfilesystems Amlfilesystemname
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemsdelete
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-3
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Storagecache
        Amlfilesystems Amlfilesystemname
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemsget
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-put-subscriptions-subscriptionid
      description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Storagecache
        Amlfilesystems Amlfilesystemname
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemscreateorupdate
      with:
        amlFilesystem: tools.amlFilesystem
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-patch-subscriptions-subscriptionid
      description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Storagecache Amlfilesystems Amlfilesystemname
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemsupdate
      with:
        amlFilesystem: tools.amlFilesystem
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-subscriptions-subscriptionid-3
      description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Storagecache Amlfilesystems Amlfilesystemname Archive
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemsarchive
      with:
        archiveInfo: tools.archiveInfo
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-subscriptions-subscriptionid-4
      description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Storagecache Amlfilesystems Amlfilesystemname Cancelarchive
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: managed-lustre-client-amlfilesystems.microsoftazureamlfilesystemscancelarchive
      outputParameters:
      - type: object
        mapping: $.