{"files":{"SKILL.md":"---\nname: deviceservices\ndescription: \"DeviceServices API skill. Use when working with DeviceServices for providers, subscriptions. Covers 8 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# DeviceServices\nAPI version: 2019-06-01\n\n## Auth\nOAuth2\n\n## Base URL\nhttps://management.azure.com\n\n## Setup\n1. Configure auth: OAuth2\n2. GET /providers/Microsoft.WindowsIoT/operations -- lists all of the available windows iot services rest api operations.\n3. POST /subscriptions/{subscriptionId}/providers/Microsoft.WindowsIoT/checkDeviceServiceNameAvailability -- create first checkDeviceServiceNameAvailability\n\n## Endpoints\n8 endpoints across 2 groups. See references/api-spec.lap for full details.\n\n### Providers\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /providers/Microsoft.WindowsIoT/operations | Lists all of the available Windows IoT Services REST API operations. |\n\n### Subscriptions\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName} | Get the non-security related metadata of a Windows IoT Device Service. |\n| PUT | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName} | Create or update the metadata of a Windows IoT Device Service. |\n| PATCH | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName} | Updates the metadata of a Windows IoT Device Service. |\n| DELETE | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName} | Delete a Windows IoT Device Service. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices | Get all the IoT hubs in a resource group. |\n| GET | /subscriptions/{subscriptionId}/providers/Microsoft.WindowsIoT/deviceServices | Get all the IoT hubs in a subscription. |\n| POST | /subscriptions/{subscriptionId}/providers/Microsoft.WindowsIoT/checkDeviceServiceNameAvailability | Check if a Windows IoT Device Service name is available. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all operations?\" -> GET /providers/Microsoft.WindowsIoT/operations\n- \"Get deviceService details?\" -> GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName}\n- \"Update a deviceService?\" -> PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName}\n- \"Partially update a deviceService?\" -> PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName}\n- \"Delete a deviceService?\" -> DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName}\n- \"List all deviceServices?\" -> GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices\n- \"Create a checkDeviceServiceNameAvailability?\" -> POST /subscriptions/{subscriptionId}/providers/Microsoft.WindowsIoT/checkDeviceServiceNameAvailability\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 DeviceServices\n@base https://management.azure.com\n@version 2019-06-01\n@auth OAuth2\n@common_fields {api-version: any # The version of the API.}\n@endpoints 8\n@toc providers(1), subscriptions(7)\n\n@group providers\n@endpoint GET /providers/Microsoft.WindowsIoT/operations\n@desc Lists all of the available Windows IoT Services REST API operations.\n@returns(200) OK. The request has succeeded.\n\n@endgroup\n\n@group subscriptions\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName}\n@desc Get the non-security related metadata of a Windows IoT Device Service.\n@required {subscriptionId: any # The subscription identifier., resourceGroupName: any # The name of the resource group that contains the Windows IoT Device Service., deviceName: any # The name of the Windows IoT Device Service.}\n@returns(200) OK. The request has succeeded.\n\n@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName}\n@desc Create or update the metadata of a Windows IoT Device Service.\n@required {subscriptionId: any # The subscription identifier., resourceGroupName: any # The name of the resource group that contains the Windows IoT Device Service., deviceName: any # The name of the Windows IoT Device Service., deviceService: map # The Windows IoT Device Service metadata and security metadata.}\n@optional {If-Match: any # ETag of the Windows IoT Device Service. Do not specify for creating a new Windows IoT Device Service. Required to update an existing Windows IoT Device Service.}\n@returns(200) OK. The request has succeeded.\n@returns(201) OK. The request has succeeded.\n\n@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName}\n@desc Updates the metadata of a Windows IoT Device Service.\n@required {subscriptionId: any # The subscription identifier., resourceGroupName: any # The name of the resource group that contains the Windows IoT Device Service., deviceName: any # The name of the Windows IoT Device Service., deviceService: map # The Windows IoT Device Service metadata and security metadata.}\n@optional {If-Match: any # ETag of the Windows IoT Device Service. Do not specify for creating a brand new Windows IoT Device Service. Required to update an existing Windows IoT Device Service.}\n@returns(200) OK. The request has succeeded.\n\n@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices/{deviceName}\n@desc Delete a Windows IoT Device Service.\n@required {subscriptionId: any # The subscription identifier., resourceGroupName: any # The name of the resource group that contains the Windows IoT Device Service., deviceName: any # The name of the Windows IoT Device Service.}\n@returns(200) OK. The request has succeeded.\n@returns(204) OK. The request has succeeded with no content to return.\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsIoT/deviceServices\n@desc Get all the IoT hubs in a resource group.\n@required {subscriptionId: any # The subscription identifier., resourceGroupName: any # The name of the resource group that contains the Windows IoT Device Service.}\n@returns(200) OK. The request has succeeded.\n\n@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.WindowsIoT/deviceServices\n@desc Get all the IoT hubs in a subscription.\n@required {subscriptionId: any # The subscription identifier.}\n@returns(200) OK. The request has succeeded.\n\n@endpoint POST /subscriptions/{subscriptionId}/providers/Microsoft.WindowsIoT/checkDeviceServiceNameAvailability\n@desc Check if a Windows IoT Device Service name is available.\n@required {subscriptionId: any # The subscription identifier., deviceServiceCheckNameAvailabilityParameters: map # Set the name parameter in the DeviceServiceCheckNameAvailabilityParameters structure to the name of the Windows IoT Device Service to check.}\n@returns(200) OK. The request has succeeded.\n\n@endgroup\n\n@end\n"}}