{"files":{"SKILL.md":"---\nname: execution-service-api\ndescription: \"Execution Service API skill. Use when working with Execution Service for execution. Covers 4 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Execution Service API\nAPI version: 2019-09-30\n\n## Auth\nOAuth2\n\n## Base URL\nNot specified.\n\n## Setup\n1. Configure auth: OAuth2\n2. Verify API access with a test request\n3. POST /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/startlocalrun -- create first startlocalrun\n\n## Endpoints\n4 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Execution\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/startlocalrun | Start a run on a local machine. |\n| POST | /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/startrun | Start a run on a remote compute target. |\n| POST | /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/snapshotrun | Start a run from a snapshot on a remote compute target. |\n| POST | /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/runId/{runId}/cancel | Cancel a run. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a startlocalrun?\" -> POST /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/startlocalrun\n- \"Create a startrun?\" -> POST /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/startrun\n- \"Create a snapshotrun?\" -> POST /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/snapshotrun\n- \"Create a cancel?\" -> POST /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/runId/{runId}/cancel\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Execution Service API\n@version 2019-09-30\n@auth OAuth2\n@endpoints 4\n@toc execution(4)\n\n@endpoint POST /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/startlocalrun\n@desc Start a run on a local machine.\n@required {subscriptionId: any # The Azure Subscription ID., resourceGroupName: any # The Name of the resource group in which the workspace is located., workspaceName: any # The name of the workspace., experimentName: any # The experiment name., definition: map # A JSON run definition structure.}\n@optional {runId: any # A run id. If not supplied a run id will be created automatically.}\n@returns(200) File Response\n\n@endpoint POST /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/startrun\n@desc Start a run on a remote compute target.\n@required {subscriptionId: any # The Azure Subscription ID., resourceGroupName: any # The Name of the resource group in which the workspace is located., workspaceName: any # The name of the workspace., experimentName: any # The experiment name., runDefinitionFile: any # The JSON file containing the RunDefinition, projectZipFile: any # The zip archive of the project folder containing the source code to use for the run.}\n@optional {runId: any # A run id. If not supplied a run id will be created automatically.}\n@returns(200) A run was successfully started.\n\n@endpoint POST /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/snapshotrun\n@desc Start a run from a snapshot on a remote compute target.\n@required {subscriptionId: any # The Azure Subscription ID., resourceGroupName: any # The Name of the resource group in which the workspace is located., workspaceName: any # The name of the workspace., experimentName: any # The experiment name., definition: map # A JSON run definition structure.}\n@optional {runId: any # A run id. If not supplied a run id will be created automatically.}\n@returns(200) A snapshot run was successfully started.\n\n@endpoint POST /execution/v1.0/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/experiments/{experimentName}/runId/{runId}/cancel\n@desc Cancel a run.\n@required {subscriptionId: any # The Azure Subscription ID., resourceGroupName: any # The Name of the resource group in which the workspace is located., workspaceName: any # The name of the workspace., experimentName: any # The experiment name., runId: any # The id of the run to cancel.}\n@returns(200) The run was successfully cancelled.\n\n@end\n"}}