Microsoft Azure Execution Service API — Execution

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Execution Service API — Execution
  description: 'Microsoft Azure Execution Service API — Execution. 4 operations. Lead operation: Microsoft Azure Cancel A
    Run. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Execution
  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: execution-service-execution
    baseUri: ''
    description: Microsoft Azure Execution Service API — Execution business capability. Self-contained, no shared references.
    resources:
    - name: execution-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-pro
      path: /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/runId/{runId}/cancel
      operations:
      - name: microsoftazurerunscancelrunwithuri
        method: POST
        description: Microsoft Azure Cancel A Run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: experimentName
          in: path
          type: string
          description: The experiment name.
          required: true
        - name: runId
          in: path
          type: string
          description: The id of the run to cancel.
          required: true
    - name: execution-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-pro
      path: /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/snapshotrun
      operations:
      - name: microsoftazurerunsstartsnapshotrun
        method: POST
        description: Microsoft Azure Start A Run From A Snapshot On A Remote Compute Target
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: experimentName
          in: path
          type: string
          description: The experiment name.
          required: true
        - name: definition
          in: body
          type: string
          description: A JSON run definition structure.
          required: true
        - name: runId
          in: query
          type: string
          description: A run id. If not supplied a run id will be created automatically.
    - name: execution-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-pro
      path: /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/startlocalrun
      operations:
      - name: microsoftazurerunsstartlocalrun
        method: POST
        description: Microsoft Azure Start A Run On A Local Machine
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: experimentName
          in: path
          type: string
          description: The experiment name.
          required: true
        - name: definition
          in: body
          type: string
          description: A JSON run definition structure.
          required: true
        - name: runId
          in: query
          type: string
          description: A run id. If not supplied a run id will be created automatically.
    - name: execution-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-pro
      path: /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/startrun
      operations:
      - name: microsoftazurerunsstartrun
        method: POST
        description: Microsoft Azure Start A Run On A Remote Compute Target
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: experimentName
          in: path
          type: string
          description: The experiment name.
          required: true
        - name: runDefinitionFile
          in: formData
          type: file
          description: The JSON file containing the RunDefinition
          required: true
        - name: projectZipFile
          in: formData
          type: file
          description: The zip archive of the project folder containing the source code to use for the run.
          required: true
        - name: runId
          in: query
          type: string
          description: A run id. If not supplied a run id will be created automatically.
  exposes:
  - type: rest
    namespace: execution-service-execution-rest
    port: 8080
    description: REST adapter for Microsoft Azure Execution Service API — Execution. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/execution/v1-0/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-machinelearningservices/workspaces/{workspacename}/experiments/{experimentname}/runid/{runid}/cancel
      name: execution-v1-0-subscriptions-subscriptionid-resourcegroups-resourcegroupname-pro
      description: REST surface for execution-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-pro.
      operations:
      - method: POST
        name: microsoftazurerunscancelrunwithuri
        description: Microsoft Azure Cancel A Run
        call: execution-service-execution.microsoftazurerunscancelrunwithuri
        with:
          experimentName: rest.experimentName
          runId: rest.runId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/execution/v1-0/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-machinelearningservices/workspaces/{workspacename}/experiments/{experimentname}/snapshotrun
      name: execution-v1-0-subscriptions-subscriptionid-resourcegroups-resourcegroupname-pro
      description: REST surface for execution-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-pro.
      operations:
      - method: POST
        name: microsoftazurerunsstartsnapshotrun
        description: Microsoft Azure Start A Run From A Snapshot On A Remote Compute Target
        call: execution-service-execution.microsoftazurerunsstartsnapshotrun
        with:
          experimentName: rest.experimentName
          definition: rest.definition
          runId: rest.runId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/execution/v1-0/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-machinelearningservices/workspaces/{workspacename}/experiments/{experimentname}/startlocalrun
      name: execution-v1-0-subscriptions-subscriptionid-resourcegroups-resourcegroupname-pro
      description: REST surface for execution-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-pro.
      operations:
      - method: POST
        name: microsoftazurerunsstartlocalrun
        description: Microsoft Azure Start A Run On A Local Machine
        call: execution-service-execution.microsoftazurerunsstartlocalrun
        with:
          experimentName: rest.experimentName
          definition: rest.definition
          runId: rest.runId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/execution/v1-0/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-machinelearningservices/workspaces/{workspacename}/experiments/{experimentname}/startrun
      name: execution-v1-0-subscriptions-subscriptionid-resourcegroups-resourcegroupname-pro
      description: REST surface for execution-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-pro.
      operations:
      - method: POST
        name: microsoftazurerunsstartrun
        description: Microsoft Azure Start A Run On A Remote Compute Target
        call: execution-service-execution.microsoftazurerunsstartrun
        with:
          experimentName: rest.experimentName
          runDefinitionFile: rest.runDefinitionFile
          projectZipFile: rest.projectZipFile
          runId: rest.runId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: execution-service-execution-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Execution Service API — Execution. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-cancel-run
      description: Microsoft Azure Cancel A Run
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: execution-service-execution.microsoftazurerunscancelrunwithuri
      with:
        experimentName: tools.experimentName
        runId: tools.runId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-start-run-snapshot
      description: Microsoft Azure Start A Run From A Snapshot On A Remote Compute Target
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: execution-service-execution.microsoftazurerunsstartsnapshotrun
      with:
        experimentName: tools.experimentName
        definition: tools.definition
        runId: tools.runId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-start-run-local
      description: Microsoft Azure Start A Run On A Local Machine
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: execution-service-execution.microsoftazurerunsstartlocalrun
      with:
        experimentName: tools.experimentName
        definition: tools.definition
        runId: tools.runId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-start-run-remote
      description: Microsoft Azure Start A Run On A Remote Compute Target
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: execution-service-execution.microsoftazurerunsstartrun
      with:
        experimentName: tools.experimentName
        runDefinitionFile: tools.runDefinitionFile
        projectZipFile: tools.projectZipFile
        runId: tools.runId
      outputParameters:
      - type: object
        mapping: $.