naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Edge Ordering Service-Customer — OrderItems
  description: 'Microsoft Azure Edge Ordering Service-Customer — OrderItems. 8 operations. Lead operation: Microsoft Azure
    Get Subscriptions Subscriptionid Providers Microsoft Edgeorder Orderitems. Self-contained Naftiko capability covering
    one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - OrderItems
  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: edge-ordering-service-customer-orderitems
    baseUri: https://management.azure.com
    description: Microsoft Azure Edge Ordering Service-Customer — OrderItems business capability. Self-contained, no shared
      references.
    resources:
    - name: subscriptions-subscriptionId-providers-Microsoft.EdgeOrder-orderItems
      path: /subscriptions/{subscriptionId}/providers/Microsoft.EdgeOrder/orderItems
      operations:
      - name: microsoftazureorderitemslistbysubscription
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Edgeorder Orderitems
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $filter
          in: query
          type: string
          description: $filter is supported to filter based on order id. Filter supports only equals operation.
        - name: $expand
          in: query
          type: string
          description: $expand is supported on parent device details, device details, forward shipping details and reverse
            shipping details parameters. Each of these can be provided a
        - name: $skipToken
          in: query
          type: string
          description: $skipToken is supported on Get list of order items, which provides the next page in the list of order
            items.
        - name: $top
          in: query
          type: integer
          description: $top is supported on fetching list of resources. $top=10 means that the first 10 items in the list
            will be returned to the API caller.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EdgeOrder/orderItems
      operations:
      - name: microsoftazureorderitemslistbyresourcegroup
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $filter
          in: query
          type: string
          description: $filter is supported to filter based on order id. Filter supports only equals operation.
        - name: $expand
          in: query
          type: string
          description: $expand is supported on parent device details, device details, forward shipping details and reverse
            shipping details parameters. Each of these can be provided a
        - name: $skipToken
          in: query
          type: string
          description: $skipToken is supported on Get list of order items, which provides the next page in the list of order
            items.
        - name: $top
          in: query
          type: integer
          description: $top is supported on fetching list of resources. $top=10 means that the first 10 items in the list
            will be returned to the API caller.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EdgeOrder/orderItems/{orderItemName}
      operations:
      - name: microsoftazureorderitemsget
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: $expand
          in: query
          type: string
          description: $expand is supported on parent device details, device details, forward shipping details and reverse
            shipping details parameters. Each of these can be provided a
      - name: microsoftazureorderitemscreate
        method: PUT
        description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orderItemResource
          in: body
          type: string
          description: Order item details from request body.
          required: true
      - name: microsoftazureorderitemsdelete
        method: DELETE
        description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: microsoftazureorderitemsupdate
        method: PATCH
        description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: If-Match
          in: header
          type: string
          description: Defines the If-Match condition. The patch will be performed only if the ETag of the order on the server
            matches this value.
        - name: orderItemUpdateParameter
          in: body
          type: string
          description: Order item update parameters from request body.
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EdgeOrder/orderItems/{orderItemName}/cancel
      operations:
      - name: microsoftazureorderitemscancel
        method: POST
        description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname Cancel
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: cancellationReason
          in: body
          type: string
          description: Reason for cancellation.
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EdgeOrder/orderItems/{orderItemName}/return
      operations:
      - name: microsoftazureorderitemsreturn
        method: POST
        description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname Return
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: returnOrderItemDetails
          in: body
          type: string
          description: Return order item details.
          required: true
  exposes:
  - type: rest
    namespace: edge-ordering-service-customer-orderitems-rest
    port: 8080
    description: REST adapter for Microsoft Azure Edge Ordering Service-Customer — OrderItems. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-edgeorder/orderitems
      name: subscriptions-subscriptionid-providers-microsoft-edgeorder-orderitems
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.EdgeOrder-orderItems.
      operations:
      - method: GET
        name: microsoftazureorderitemslistbysubscription
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Edgeorder Orderitems
        call: edge-ordering-service-customer-orderitems.microsoftazureorderitemslistbysubscription
        with:
          $filter: rest.$filter
          $expand: rest.$expand
          $skipToken: rest.$skipToken
          $top: rest.$top
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-edgeorder/orderitems
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazureorderitemslistbyresourcegroup
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems
        call: edge-ordering-service-customer-orderitems.microsoftazureorderitemslistbyresourcegroup
        with:
          $filter: rest.$filter
          $expand: rest.$expand
          $skipToken: rest.$skipToken
          $top: rest.$top
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-edgeorder/orderitems/{orderitemname}
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazureorderitemsget
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname
        call: edge-ordering-service-customer-orderitems.microsoftazureorderitemsget
        with:
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: microsoftazureorderitemscreate
        description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname
        call: edge-ordering-service-customer-orderitems.microsoftazureorderitemscreate
        with:
          orderItemResource: rest.orderItemResource
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazureorderitemsdelete
        description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname
        call: edge-ordering-service-customer-orderitems.microsoftazureorderitemsdelete
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: microsoftazureorderitemsupdate
        description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname
        call: edge-ordering-service-customer-orderitems.microsoftazureorderitemsupdate
        with:
          If-Match: rest.If-Match
          orderItemUpdateParameter: rest.orderItemUpdateParameter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-edgeorder/orderitems/{orderitemname}/cancel
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazureorderitemscancel
        description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname Cancel
        call: edge-ordering-service-customer-orderitems.microsoftazureorderitemscancel
        with:
          cancellationReason: rest.cancellationReason
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-edgeorder/orderitems/{orderitemname}/return
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: POST
        name: microsoftazureorderitemsreturn
        description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Edgeorder Orderitems Orderitemname Return
        call: edge-ordering-service-customer-orderitems.microsoftazureorderitemsreturn
        with:
          returnOrderItemDetails: rest.returnOrderItemDetails
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: edge-ordering-service-customer-orderitems-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Edge Ordering Service-Customer — OrderItems. 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 Edgeorder Orderitems
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: edge-ordering-service-customer-orderitems.microsoftazureorderitemslistbysubscription
      with:
        $filter: tools.$filter
        $expand: tools.$expand
        $skipToken: tools.$skipToken
        $top: tools.$top
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-2
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Edgeorder
        Orderitems
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: edge-ordering-service-customer-orderitems.microsoftazureorderitemslistbyresourcegroup
      with:
        $filter: tools.$filter
        $expand: tools.$expand
        $skipToken: tools.$skipToken
        $top: tools.$top
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-3
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Edgeorder
        Orderitems Orderitemname
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: edge-ordering-service-customer-orderitems.microsoftazureorderitemsget
      with:
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-put-subscriptions-subscriptionid
      description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Edgeorder
        Orderitems Orderitemname
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: edge-ordering-service-customer-orderitems.microsoftazureorderitemscreate
      with:
        orderItemResource: tools.orderItemResource
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-subscriptions-subscriptionid
      description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Edgeorder Orderitems Orderitemname
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: edge-ordering-service-customer-orderitems.microsoftazureorderitemsdelete
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-patch-subscriptions-subscriptionid
      description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Edgeorder Orderitems Orderitemname
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: edge-ordering-service-customer-orderitems.microsoftazureorderitemsupdate
      with:
        If-Match: tools.If-Match
        orderItemUpdateParameter: tools.orderItemUpdateParameter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-subscriptions-subscriptionid
      description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Edgeorder Orderitems Orderitemname Cancel
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: edge-ordering-service-customer-orderitems.microsoftazureorderitemscancel
      with:
        cancellationReason: tools.cancellationReason
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-subscriptions-subscriptionid-2
      description: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Edgeorder Orderitems Orderitemname Return
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: edge-ordering-service-customer-orderitems.microsoftazureorderitemsreturn
      with:
        returnOrderItemDetails: tools.returnOrderItemDetails
      outputParameters:
      - type: object
        mapping: $.