Microsoft Azure Run History APIs — RunMetrics

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Run History APIs — RunMetrics
  description: 'Microsoft Azure Run History APIs — RunMetrics. 4 operations. Lead operation: Microsoft Azure Get Metric Details.
    Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - RunMetrics
  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: run-history-apis-runmetrics
    baseUri: ''
    description: Microsoft Azure Run History APIs — RunMetrics business capability. Self-contained, no shared references.
    resources:
    - name: history-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-provi
      path: /history/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/metrics/{metricId}
      operations:
      - name: microsoftazurerunmetricsget
        method: GET
        description: Microsoft Azure Get Metric Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: experimentName
          in: path
          type: string
          description: The experiment name.
          required: true
        - name: metricId
          in: path
          type: string
          description: The identifier for a Metric.
          required: true
    - name: history-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-provi
      path: /history/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/metrics:query
      operations:
      - name: microsoftazurerunmetricsgetbyquery
        method: POST
        description: Microsoft Azure Get All Run Metrics For The Specific Experiment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: experimentName
          in: path
          type: string
          description: The experiment name.
          required: true
        - name: queryParams
          in: body
          type: string
          description: Query Parameters for data sorting and filtering.
        - name: MergeStrategyType
          in: query
          type: string
          description: "The type of merge strategy. Currently supported strategies are:\r"
        - name: MergeStrategyOptions
          in: query
          type: string
          description: Controls behavior of the merge strategy in certain cases; e.g. when a metric is not merged.
        - name: MergeStrategySettings.Version
          in: query
          type: string
          description: The strategy settings version.
        - name: MergeStrategySettings.SelectMetrics
          in: query
          type: string
          description: Defines how to select metrics when merging them together.
    - name: history-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-provi
      path: /history/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/runs/{runId}/batch/metrics
      operations:
      - name: microsoftazurerunmetricsbatchpost
        method: POST
        description: Microsoft Azure Post Metrics To 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 identifier for a run.
          required: true
        - name: batchMetricDto
          in: body
          type: string
          description: Details of the Metrics which will be added to the Run Id.
    - name: history-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-provi
      path: /history/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/runs/{runId}/metrics
      operations:
      - name: microsoftazurerunmetricspost
        method: POST
        description: Microsoft Azure Post Metric To 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 identifier for a run.
          required: true
        - name: metricDto
          in: body
          type: string
          description: Details of the metric which will be added to the Run Id.
  exposes:
  - type: rest
    namespace: run-history-apis-runmetrics-rest
    port: 8080
    description: REST adapter for Microsoft Azure Run History APIs — RunMetrics. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/history/v1-0/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-machinelearningservices/workspaces/{workspacename}/experiments/{experimentname}/metrics/{metricid}
      name: history-v1-0-subscriptions-subscriptionid-resourcegroups-resourcegroupname-provi
      description: REST surface for history-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-provi.
      operations:
      - method: GET
        name: microsoftazurerunmetricsget
        description: Microsoft Azure Get Metric Details
        call: run-history-apis-runmetrics.microsoftazurerunmetricsget
        with:
          experimentName: rest.experimentName
          metricId: rest.metricId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/history/v1-0/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-machinelearningservices/workspaces/{workspacename}/experiments/{experimentname}/metrics-query
      name: history-v1-0-subscriptions-subscriptionid-resourcegroups-resourcegroupname-provi
      description: REST surface for history-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-provi.
      operations:
      - method: POST
        name: microsoftazurerunmetricsgetbyquery
        description: Microsoft Azure Get All Run Metrics For The Specific Experiment
        call: run-history-apis-runmetrics.microsoftazurerunmetricsgetbyquery
        with:
          experimentName: rest.experimentName
          queryParams: rest.queryParams
          MergeStrategyType: rest.MergeStrategyType
          MergeStrategyOptions: rest.MergeStrategyOptions
          MergeStrategySettings.Version: rest.MergeStrategySettings.Version
          MergeStrategySettings.SelectMetrics: rest.MergeStrategySettings.SelectMetrics
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/history/v1-0/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-machinelearningservices/workspaces/{workspacename}/experiments/{experimentname}/runs/{runid}/batch/metrics
      name: history-v1-0-subscriptions-subscriptionid-resourcegroups-resourcegroupname-provi
      description: REST surface for history-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-provi.
      operations:
      - method: POST
        name: microsoftazurerunmetricsbatchpost
        description: Microsoft Azure Post Metrics To A Run
        call: run-history-apis-runmetrics.microsoftazurerunmetricsbatchpost
        with:
          experimentName: rest.experimentName
          runId: rest.runId
          batchMetricDto: rest.batchMetricDto
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/history/v1-0/subscriptions/{subscriptionid}/resourcegroups/{resourcegroupname}/providers/microsoft-machinelearningservices/workspaces/{workspacename}/experiments/{experimentname}/runs/{runid}/metrics
      name: history-v1-0-subscriptions-subscriptionid-resourcegroups-resourcegroupname-provi
      description: REST surface for history-v1.0-subscriptions-subscriptionId-resourceGroups-resourceGroupName-provi.
      operations:
      - method: POST
        name: microsoftazurerunmetricspost
        description: Microsoft Azure Post Metric To A Run
        call: run-history-apis-runmetrics.microsoftazurerunmetricspost
        with:
          experimentName: rest.experimentName
          runId: rest.runId
          metricDto: rest.metricDto
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: run-history-apis-runmetrics-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Run History APIs — RunMetrics. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: microsoft-azure-get-metric-details
      description: Microsoft Azure Get Metric Details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: run-history-apis-runmetrics.microsoftazurerunmetricsget
      with:
        experimentName: tools.experimentName
        metricId: tools.metricId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-all-run
      description: Microsoft Azure Get All Run Metrics For The Specific Experiment
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: run-history-apis-runmetrics.microsoftazurerunmetricsgetbyquery
      with:
        experimentName: tools.experimentName
        queryParams: tools.queryParams
        MergeStrategyType: tools.MergeStrategyType
        MergeStrategyOptions: tools.MergeStrategyOptions
        MergeStrategySettings.Version: tools.MergeStrategySettings.Version
        MergeStrategySettings.SelectMetrics: tools.MergeStrategySettings.SelectMetrics
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-metrics-run
      description: Microsoft Azure Post Metrics To A Run
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: run-history-apis-runmetrics.microsoftazurerunmetricsbatchpost
      with:
        experimentName: tools.experimentName
        runId: tools.runId
        batchMetricDto: tools.batchMetricDto
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-metric-run
      description: Microsoft Azure Post Metric To A Run
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: run-history-apis-runmetrics.microsoftazurerunmetricspost
      with:
        experimentName: tools.experimentName
        runId: tools.runId
        metricDto: tools.metricDto
      outputParameters:
      - type: object
        mapping: $.