Microsoft Azure DeviceUpdateClient — Update Management

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure DeviceUpdateClient — Update Management
  description: 'Microsoft Azure DeviceUpdateClient — Update Management. 11 operations. Lead operation: Microsoft Azure Get
    Deviceupdate Instanceid Updates. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Update Management
  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: deviceupdateclient-update-management
    baseUri: ''
    description: Microsoft Azure DeviceUpdateClient — Update Management business capability. Self-contained, no shared references.
    resources:
    - name: deviceUpdate-instanceId-updates
      path: /deviceUpdate/{instanceId}/updates
      operations:
      - name: microsoftazuredeviceupdatelistupdates
        method: GET
        description: Microsoft Azure Get Deviceupdate Instanceid Updates
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: search
          in: query
          type: string
          description: Request updates matching a free-text search expression.
        - name: filter
          in: query
          type: string
          description: Filter updates by its properties.
    - name: deviceUpdate-instanceId-updates-operations
      path: /deviceUpdate/{instanceId}/updates/operations
      operations:
      - name: microsoftazuredeviceupdatelistoperations
        method: GET
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Operations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: 'Restricts the set of operations returned. Only one specific filter is supported: "status eq ''NotStarted''
            or status eq ''Running''"'
        - name: top
          in: query
          type: integer
          description: Specifies a non-negative integer n that limits the number of items returned from a collection. The
            service returns the number of available items up to but not g
    - name: deviceUpdate-instanceId-updates-operations-operationId
      path: /deviceUpdate/{instanceId}/updates/operations/{operationId}
      operations:
      - name: microsoftazuredeviceupdategetoperation
        method: GET
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Operations Operationid
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deviceUpdate-instanceId-updates-providers
      path: /deviceUpdate/{instanceId}/updates/providers
      operations:
      - name: microsoftazuredeviceupdatelistproviders
        method: GET
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deviceUpdate-instanceId-updates-providers-provider-names
      path: /deviceUpdate/{instanceId}/updates/providers/{provider}/names
      operations:
      - name: microsoftazuredeviceupdatelistnames
        method: GET
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deviceUpdate-instanceId-updates-providers-provider-names-name-versions
      path: /deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions
      operations:
      - name: microsoftazuredeviceupdatelistversions
        method: GET
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: Filter updates by its properties.
    - name: deviceUpdate-instanceId-updates-providers-provider-names-name-versions-version
      path: /deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions/{version}
      operations:
      - name: microsoftazuredeviceupdategetupdate
        method: GET
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: microsoftazuredeviceupdatedeleteupdate
        method: DELETE
        description: Microsoft Azure Delete Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deviceUpdate-instanceId-updates-providers-provider-names-name-versions-version-f
      path: /deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions/{version}/files
      operations:
      - name: microsoftazuredeviceupdatelistfiles
        method: GET
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version Files
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deviceUpdate-instanceId-updates-providers-provider-names-name-versions-version-f
      path: /deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions/{version}/files/{fileId}
      operations:
      - name: microsoftazuredeviceupdategetfile
        method: GET
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version Files
          Fileid
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: deviceUpdate-instanceId-updates:import
      path: /deviceUpdate/{instanceId}/updates:import
      operations:
      - name: microsoftazuredeviceupdateimportupdate
        method: POST
        description: Microsoft Azure Post Deviceupdate Instanceid Updates:import
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: updateToImport
          in: body
          type: string
          description: The update to be imported.
          required: true
  exposes:
  - type: rest
    namespace: deviceupdateclient-update-management-rest
    port: 8080
    description: REST adapter for Microsoft Azure DeviceUpdateClient — Update Management. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/deviceupdate/{instanceid}/updates
      name: deviceupdate-instanceid-updates
      description: REST surface for deviceUpdate-instanceId-updates.
      operations:
      - method: GET
        name: microsoftazuredeviceupdatelistupdates
        description: Microsoft Azure Get Deviceupdate Instanceid Updates
        call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistupdates
        with:
          search: rest.search
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deviceupdate/{instanceid}/updates/operations
      name: deviceupdate-instanceid-updates-operations
      description: REST surface for deviceUpdate-instanceId-updates-operations.
      operations:
      - method: GET
        name: microsoftazuredeviceupdatelistoperations
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Operations
        call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistoperations
        with:
          filter: rest.filter
          top: rest.top
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deviceupdate/{instanceid}/updates/operations/{operationid}
      name: deviceupdate-instanceid-updates-operations-operationid
      description: REST surface for deviceUpdate-instanceId-updates-operations-operationId.
      operations:
      - method: GET
        name: microsoftazuredeviceupdategetoperation
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Operations Operationid
        call: deviceupdateclient-update-management.microsoftazuredeviceupdategetoperation
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deviceupdate/{instanceid}/updates/providers
      name: deviceupdate-instanceid-updates-providers
      description: REST surface for deviceUpdate-instanceId-updates-providers.
      operations:
      - method: GET
        name: microsoftazuredeviceupdatelistproviders
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers
        call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistproviders
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deviceupdate/{instanceid}/updates/providers/{provider}/names
      name: deviceupdate-instanceid-updates-providers-provider-names
      description: REST surface for deviceUpdate-instanceId-updates-providers-provider-names.
      operations:
      - method: GET
        name: microsoftazuredeviceupdatelistnames
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names
        call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistnames
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deviceupdate/{instanceid}/updates/providers/{provider}/names/{name}/versions
      name: deviceupdate-instanceid-updates-providers-provider-names-name-versions
      description: REST surface for deviceUpdate-instanceId-updates-providers-provider-names-name-versions.
      operations:
      - method: GET
        name: microsoftazuredeviceupdatelistversions
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions
        call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistversions
        with:
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deviceupdate/{instanceid}/updates/providers/{provider}/names/{name}/versions/{version}
      name: deviceupdate-instanceid-updates-providers-provider-names-name-versions-version
      description: REST surface for deviceUpdate-instanceId-updates-providers-provider-names-name-versions-version.
      operations:
      - method: GET
        name: microsoftazuredeviceupdategetupdate
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version
        call: deviceupdateclient-update-management.microsoftazuredeviceupdategetupdate
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazuredeviceupdatedeleteupdate
        description: Microsoft Azure Delete Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version
        call: deviceupdateclient-update-management.microsoftazuredeviceupdatedeleteupdate
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deviceupdate/{instanceid}/updates/providers/{provider}/names/{name}/versions/{version}/files
      name: deviceupdate-instanceid-updates-providers-provider-names-name-versions-version-f
      description: REST surface for deviceUpdate-instanceId-updates-providers-provider-names-name-versions-version-f.
      operations:
      - method: GET
        name: microsoftazuredeviceupdatelistfiles
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version Files
        call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistfiles
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deviceupdate/{instanceid}/updates/providers/{provider}/names/{name}/versions/{version}/files/{fileid}
      name: deviceupdate-instanceid-updates-providers-provider-names-name-versions-version-f
      description: REST surface for deviceUpdate-instanceId-updates-providers-provider-names-name-versions-version-f.
      operations:
      - method: GET
        name: microsoftazuredeviceupdategetfile
        description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version Files
          Fileid
        call: deviceupdateclient-update-management.microsoftazuredeviceupdategetfile
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deviceupdate/{instanceid}/updates-import
      name: deviceupdate-instanceid-updates-import
      description: REST surface for deviceUpdate-instanceId-updates:import.
      operations:
      - method: POST
        name: microsoftazuredeviceupdateimportupdate
        description: Microsoft Azure Post Deviceupdate Instanceid Updates:import
        call: deviceupdateclient-update-management.microsoftazuredeviceupdateimportupdate
        with:
          updateToImport: rest.updateToImport
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: deviceupdateclient-update-management-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure DeviceUpdateClient — Update Management. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-get-deviceupdate-instanceid
      description: Microsoft Azure Get Deviceupdate Instanceid Updates
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistupdates
      with:
        search: tools.search
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-deviceupdate-instanceid-2
      description: Microsoft Azure Get Deviceupdate Instanceid Updates Operations
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistoperations
      with:
        filter: tools.filter
        top: tools.top
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-deviceupdate-instanceid-3
      description: Microsoft Azure Get Deviceupdate Instanceid Updates Operations Operationid
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: deviceupdateclient-update-management.microsoftazuredeviceupdategetoperation
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-deviceupdate-instanceid-4
      description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistproviders
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-deviceupdate-instanceid-5
      description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistnames
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-deviceupdate-instanceid-6
      description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistversions
      with:
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-deviceupdate-instanceid-7
      description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: deviceupdateclient-update-management.microsoftazuredeviceupdategetupdate
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-deviceupdate-instanceid
      description: Microsoft Azure Delete Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: deviceupdateclient-update-management.microsoftazuredeviceupdatedeleteupdate
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-deviceupdate-instanceid-8
      description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version Files
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: deviceupdateclient-update-management.microsoftazuredeviceupdatelistfiles
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-deviceupdate-instanceid-9
      description: Microsoft Azure Get Deviceupdate Instanceid Updates Providers Provider Names Name Versions Version Files
        Fileid
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: deviceupdateclient-update-management.microsoftazuredeviceupdategetfile
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-deviceupdate-instanceid
      description: Microsoft Azure Post Deviceupdate Instanceid Updates:import
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: deviceupdateclient-update-management.microsoftazuredeviceupdateimportupdate
      with:
        updateToImport: tools.updateToImport
      outputParameters:
      - type: object
        mapping: $.