{"files":{"SKILL.md":"---\nname: hdinsightjobclient\ndescription: \"HDInsightJobClient API skill. Use when working with HDInsightJobClient for templeton, ws. Covers 10 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# HDInsightJobClient\nAPI version: 2018-11-01-preview\n\n## Auth\nOAuth2\n\n## Base URL\nNot specified.\n\n## Setup\n1. Configure auth: OAuth2\n2. GET /templeton/v1/jobs -- gets the list of jobs from the specified hdinsight cluster.\n3. POST /templeton/v1/hive -- create first hive\n\n## Endpoints\n10 endpoints across 2 groups. See references/api-spec.lap for full details.\n\n### Templeton\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /templeton/v1/jobs/{jobId} | Gets job details from the specified HDInsight cluster. |\n| DELETE | /templeton/v1/jobs/{jobId} | Initiates cancel on given running job in the specified HDInsight. |\n| GET | /templeton/v1/jobs | Gets the list of jobs from the specified HDInsight cluster. |\n| GET | /templeton/v1/jobs?op=LISTAFTERID | Gets numrecords Of Jobs after jobid from the specified HDInsight cluster. |\n| POST | /templeton/v1/hive | Submits a Hive job to an HDInsight cluster. |\n| POST | /templeton/v1/mapreduce/jar | Submits a MapReduce job to an HDInsight cluster. |\n| POST | /templeton/v1/mapreduce/streaming | Submits a MapReduce streaming job to an HDInsight cluster. |\n| POST | /templeton/v1/pig | Submits a Pig job to an HDInsight cluster. |\n| POST | /templeton/v1/sqoop | Submits a Sqoop job to an HDInsight cluster. |\n\n### Ws\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /ws/v1/cluster/apps/{appId}/state | Gets application state from the specified HDInsight cluster. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Get job details?\" -> GET /templeton/v1/jobs/{jobId}\n- \"Delete a job?\" -> DELETE /templeton/v1/jobs/{jobId}\n- \"List all jobs?\" -> GET /templeton/v1/jobs\n- \"List all jobs?op=LISTAFTERID?\" -> GET /templeton/v1/jobs?op=LISTAFTERID\n- \"Create a hive?\" -> POST /templeton/v1/hive\n- \"Create a jar?\" -> POST /templeton/v1/mapreduce/jar\n- \"Create a streaming?\" -> POST /templeton/v1/mapreduce/streaming\n- \"Create a pig?\" -> POST /templeton/v1/pig\n- \"Create a sqoop?\" -> POST /templeton/v1/sqoop\n- \"List all state?\" -> GET /ws/v1/cluster/apps/{appId}/state\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 HDInsightJobClient\n@version 2018-11-01-preview\n@auth OAuth2\n@endpoints 10\n@toc templeton(9), ws(1)\n\n@group templeton\n@endpoint GET /templeton/v1/jobs/{jobId}\n@desc Gets job details from the specified HDInsight cluster.\n@required {user.name: any # The user name used for running job., jobId: any # The id of the job., fields: any # If fields set to '*', the request will return full details of the job. Currently the value can only be '*'.}\n@returns(200) OK response definition.\n\n@endpoint DELETE /templeton/v1/jobs/{jobId}\n@desc Initiates cancel on given running job in the specified HDInsight.\n@required {user.name: any # The user name used for running job., jobId: any # The id of the job.}\n@returns(200) OK response definition.\n\n@endpoint GET /templeton/v1/jobs\n@desc Gets the list of jobs from the specified HDInsight cluster.\n@required {user.name: any # The user name used for running job., showall: any # If showall is set to 'true', the request will return all jobs the user has permission to view, not only the jobs belonging to the user., fields: any # If fields set to '*', the request will return full details of the job. Currently the value can only be '*'.}\n@returns(200) OK response definition.\n\n@endpoint GET /templeton/v1/jobs?op=LISTAFTERID\n@desc Gets numrecords Of Jobs after jobid from the specified HDInsight cluster.\n@required {user.name: any # The user name used for running job., showall: any # If showall is set to 'true', the request will return all jobs the user has permission to view, not only the jobs belonging to the user., fields: any # If fields set to '*', the request will return full details of the job. Currently the value can only be '*'.}\n@optional {jobid: any # JobId from where to list jobs., numrecords: any # Number of jobs to fetch.}\n@returns(200) OK response definition.\n\n@endpoint POST /templeton/v1/hive\n@desc Submits a Hive job to an HDInsight cluster.\n@required {user.name: any # The user name used for running job., content: map # The content of the Hive job request.}\n@returns(200) OK response definition.\n\n@endpoint POST /templeton/v1/mapreduce/jar\n@desc Submits a MapReduce job to an HDInsight cluster.\n@required {user.name: any # The user name used for running job., content: map # The content of the MapReduce job request.}\n@returns(200) OK response definition.\n\n@endpoint POST /templeton/v1/mapreduce/streaming\n@desc Submits a MapReduce streaming job to an HDInsight cluster.\n@required {user.name: any # The user name used for running job., content: map # The content of the MapReduce job request.}\n@returns(200) OK response definition.\n\n@endpoint POST /templeton/v1/pig\n@desc Submits a Pig job to an HDInsight cluster.\n@required {user.name: any # The user name used for running job., content: map # The content of the Pig job request.}\n@returns(200) OK response definition.\n\n@endpoint POST /templeton/v1/sqoop\n@desc Submits a Sqoop job to an HDInsight cluster.\n@required {user.name: any # The user name used for running job., content: map # The content of the Sqoop job request.}\n@returns(200) OK response definition.\n\n@endgroup\n\n@group ws\n@endpoint GET /ws/v1/cluster/apps/{appId}/state\n@desc Gets application state from the specified HDInsight cluster.\n@required {appId: any # The id of the job.}\n@returns(200) OK response definition.\n\n@endgroup\n\n@end\n"}}