Microsoft Azure RunCommandsClient — VirtualMachineRunCommands

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure RunCommandsClient — VirtualMachineRunCommands
  description: 'Microsoft Azure RunCommandsClient — VirtualMachineRunCommands. 7 operations. Lead operation: Microsoft Azure
    Get Subscriptions Subscriptionid Providers Microsoft Compute Locations Location Runcommands. Self-contained Naftiko capability
    covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - VirtualMachineRunCommands
  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: runcommandsclient-virtualmachineruncommands
    baseUri: https://management.azure.com
    description: Microsoft Azure RunCommandsClient — VirtualMachineRunCommands business capability. Self-contained, no shared
      references.
    resources:
    - name: subscriptions-subscriptionId-providers-Microsoft.Compute-locations-location-runC
      path: /subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/runCommands
      operations:
      - name: microsoftazurevirtualmachineruncommandslist
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Compute Locations Location Runcommands
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location
          in: path
          type: string
          description: The location upon which run commands is queried.
          required: true
    - name: subscriptions-subscriptionId-providers-Microsoft.Compute-locations-location-runC
      path: /subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/runCommands/{commandId}
      operations:
      - name: microsoftazurevirtualmachineruncommandsget
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Compute Locations Location Runcommands
          Commandid
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: location
          in: path
          type: string
          description: The location upon which run commands is queried.
          required: true
        - name: commandId
          in: path
          type: string
          description: The command id.
          required: true
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/runCommands
      operations:
      - name: microsoftazurevirtualmachineruncommandslistbyvirtualmachine
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Compute Virtualmachines Vmname Runcommands
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: resourceGroupName
          in: path
          type: string
          description: The name of the resource group.
          required: true
        - name: vmName
          in: path
          type: string
          description: The name of the virtual machine containing the run command.
          required: true
        - name: $expand
          in: query
          type: string
          description: The expand expression to apply on the operation.
    - name: subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof
      path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/runCommands/{runCommandName}
      operations:
      - name: microsoftazurevirtualmachineruncommandscreateorupdate
        method: PUT
        description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Compute Virtualmachines Vmname Runcommands Runcommandname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: resourceGroupName
          in: path
          type: string
          description: The name of the resource group.
          required: true
        - name: vmName
          in: path
          type: string
          description: The name of the virtual machine where the run command should be created or updated.
          required: true
        - name: runCommandName
          in: path
          type: string
          description: The name of the virtual machine run command.
          required: true
        - name: runCommand
          in: body
          type: string
          description: Parameters supplied to the Create Virtual Machine RunCommand operation.
          required: true
      - name: microsoftazurevirtualmachineruncommandsupdate
        method: PATCH
        description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Compute Virtualmachines Vmname Runcommands Runcommandname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: resourceGroupName
          in: path
          type: string
          description: The name of the resource group.
          required: true
        - name: vmName
          in: path
          type: string
          description: The name of the virtual machine where the run command should be updated.
          required: true
        - name: runCommandName
          in: path
          type: string
          description: The name of the virtual machine run command.
          required: true
        - name: runCommand
          in: body
          type: string
          description: Parameters supplied to the Update Virtual Machine RunCommand operation.
          required: true
      - name: microsoftazurevirtualmachineruncommandsdelete
        method: DELETE
        description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Compute Virtualmachines Vmname Runcommands Runcommandname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: resourceGroupName
          in: path
          type: string
          description: The name of the resource group.
          required: true
        - name: vmName
          in: path
          type: string
          description: The name of the virtual machine where the run command should be deleted.
          required: true
        - name: runCommandName
          in: path
          type: string
          description: The name of the virtual machine run command.
          required: true
      - name: microsoftazurevirtualmachineruncommandsgetbyvirtualmachine
        method: GET
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Compute Virtualmachines Vmname Runcommands Runcommandname
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: resourceGroupName
          in: path
          type: string
          description: The name of the resource group.
          required: true
        - name: vmName
          in: path
          type: string
          description: The name of the virtual machine containing the run command.
          required: true
        - name: runCommandName
          in: path
          type: string
          description: The name of the virtual machine run command.
          required: true
        - name: $expand
          in: query
          type: string
          description: The expand expression to apply on the operation.
  exposes:
  - type: rest
    namespace: runcommandsclient-virtualmachineruncommands-rest
    port: 8080
    description: REST adapter for Microsoft Azure RunCommandsClient — VirtualMachineRunCommands. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-compute/locations/{location}/runcommands
      name: subscriptions-subscriptionid-providers-microsoft-compute-locations-location-runc
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.Compute-locations-location-runC.
      operations:
      - method: GET
        name: microsoftazurevirtualmachineruncommandslist
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Compute Locations Location Runcommands
        call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandslist
        with:
          location: rest.location
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/providers/microsoft-compute/locations/{location}/runcommands/{commandid}
      name: subscriptions-subscriptionid-providers-microsoft-compute-locations-location-runc
      description: REST surface for subscriptions-subscriptionId-providers-Microsoft.Compute-locations-location-runC.
      operations:
      - method: GET
        name: microsoftazurevirtualmachineruncommandsget
        description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Compute Locations Location Runcommands
          Commandid
        call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandsget
        with:
          location: rest.location
          commandId: rest.commandId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-compute/virtualmachines/{vmname}/runcommands
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: GET
        name: microsoftazurevirtualmachineruncommandslistbyvirtualmachine
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Compute Virtualmachines Vmname Runcommands
        call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandslistbyvirtualmachine
        with:
          resourceGroupName: rest.resourceGroupName
          vmName: rest.vmName
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-compute/virtualmachines/{vmname}/runcommands/{runcommandname}
      name: subscriptions-subscriptionid-resourcegroups-resourcegroupname-providers-microsof
      description: REST surface for subscriptions-subscriptionId-resourceGroups-resourceGroupName-providers-Microsof.
      operations:
      - method: PUT
        name: microsoftazurevirtualmachineruncommandscreateorupdate
        description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Compute Virtualmachines Vmname Runcommands Runcommandname
        call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandscreateorupdate
        with:
          resourceGroupName: rest.resourceGroupName
          vmName: rest.vmName
          runCommandName: rest.runCommandName
          runCommand: rest.runCommand
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: microsoftazurevirtualmachineruncommandsupdate
        description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Compute Virtualmachines Vmname Runcommands Runcommandname
        call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandsupdate
        with:
          resourceGroupName: rest.resourceGroupName
          vmName: rest.vmName
          runCommandName: rest.runCommandName
          runCommand: rest.runCommand
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazurevirtualmachineruncommandsdelete
        description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Compute Virtualmachines Vmname Runcommands Runcommandname
        call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandsdelete
        with:
          resourceGroupName: rest.resourceGroupName
          vmName: rest.vmName
          runCommandName: rest.runCommandName
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: microsoftazurevirtualmachineruncommandsgetbyvirtualmachine
        description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
          Compute Virtualmachines Vmname Runcommands Runcommandname
        call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandsgetbyvirtualmachine
        with:
          resourceGroupName: rest.resourceGroupName
          vmName: rest.vmName
          runCommandName: rest.runCommandName
          $expand: rest.$expand
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: runcommandsclient-virtualmachineruncommands-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure RunCommandsClient — VirtualMachineRunCommands. 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 Compute Locations Location Runcommands
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandslist
      with:
        location: tools.location
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-2
      description: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Compute Locations Location Runcommands
        Commandid
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandsget
      with:
        location: tools.location
        commandId: tools.commandId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-3
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Compute
        Virtualmachines Vmname Runcommands
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandslistbyvirtualmachine
      with:
        resourceGroupName: tools.resourceGroupName
        vmName: tools.vmName
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-put-subscriptions-subscriptionid
      description: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Compute
        Virtualmachines Vmname Runcommands Runcommandname
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandscreateorupdate
      with:
        resourceGroupName: tools.resourceGroupName
        vmName: tools.vmName
        runCommandName: tools.runCommandName
        runCommand: tools.runCommand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-patch-subscriptions-subscriptionid
      description: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Compute Virtualmachines Vmname Runcommands Runcommandname
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandsupdate
      with:
        resourceGroupName: tools.resourceGroupName
        vmName: tools.vmName
        runCommandName: tools.runCommandName
        runCommand: tools.runCommand
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-delete-subscriptions-subscriptionid
      description: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft
        Compute Virtualmachines Vmname Runcommands Runcommandname
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandsdelete
      with:
        resourceGroupName: tools.resourceGroupName
        vmName: tools.vmName
        runCommandName: tools.runCommandName
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-subscriptions-subscriptionid-4
      description: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Compute
        Virtualmachines Vmname Runcommands Runcommandname
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: runcommandsclient-virtualmachineruncommands.microsoftazurevirtualmachineruncommandsgetbyvirtualmachine
      with:
        resourceGroupName: tools.resourceGroupName
        vmName: tools.vmName
        runCommandName: tools.runCommandName
        $expand: tools.$expand
      outputParameters:
      - type: object
        mapping: $.