{"files":{"SKILL.md":"---\nname: recommendations-api-client\ndescription: \"Recommendations API Client API skill. Use when working with Recommendations API Client for subscriptions. Covers 15 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Recommendations API Client\nAPI version: 2018-02-01\n\n## Auth\nOAuth2\n\n## Base URL\nhttps://management.azure.com\n\n## Setup\n1. Configure auth: OAuth2\n2. GET /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations -- list all recommendations for a subscription.\n3. POST /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations/reset -- create first reset\n\n## Endpoints\n15 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Subscriptions\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations | List all recommendations for a subscription. |\n| POST | /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations/reset | Reset all recommendation opt-out settings for a subscription. |\n| POST | /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations/{name}/disable | Disables the specified rule so it will not apply to a subscription in the future. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendationHistory | Get past recommendations for an app, optionally specified by the time range. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations | Get all recommendations for an app. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/disable | Disable all recommendations for an app. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/reset | Reset all recommendation opt-out settings for an app. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/{name} | Get a recommendation rule for an app. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/{name}/disable | Disables the specific rule for a web site permanently. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendationHistory | Get past recommendations for an app, optionally specified by the time range. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations | Get all recommendations for an app. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/disable | Disable all recommendations for an app. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/reset | Reset all recommendation opt-out settings for an app. |\n| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/{name} | Get a recommendation rule for an app. |\n| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/{name}/disable | Disables the specific rule for a web site permanently. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all recommendations?\" -> GET /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations\n- \"Create a reset?\" -> POST /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations/reset\n- \"Create a disable?\" -> POST /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations/{name}/disable\n- \"List all recommendationHistory?\" -> GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendationHistory\n- \"Get recommendation details?\" -> GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/{name}\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 Recommendations API Client\n@base https://management.azure.com\n@version 2018-02-01\n@auth OAuth2\n@common_fields {subscriptionId: any # Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000)., api-version: any # API Version}\n@endpoints 15\n@toc subscriptions(15)\n\n@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations\n@desc List all recommendations for a subscription.\n@optional {featured: any # Specify true to return only the most critical recommendations. The default is false, which returns all recommendations., $filter: any # Filter is specified by using OData syntax. Example: $filter=channel eq 'Api' or channel eq 'Notification' and startTime eq 2014-01-01T00:00:00Z and endTime eq 2014-12-31T23:59:59Z and timeGrain eq duration'[PT1H|PT1M|P1D]}\n@returns(200) OK\n\n@endpoint POST /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations/reset\n@desc Reset all recommendation opt-out settings for a subscription.\n@returns(204) No Content\n\n@endpoint POST /subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations/{name}/disable\n@desc Disables the specified rule so it will not apply to a subscription in the future.\n@required {name: any # Rule name}\n@returns(200) Successfully disabled recommendations.\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendationHistory\n@desc Get past recommendations for an app, optionally specified by the time range.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., hostingEnvironmentName: any # Name of the hosting environment.}\n@optional {expiredOnly: any # Specify false to return all recommendations. The default is true, which returns only expired recommendations., $filter: any # Filter is specified by using OData syntax. Example: $filter=channel eq 'Api' or channel eq 'Notification' and startTime eq 2014-01-01T00:00:00Z and endTime eq 2014-12-31T23:59:59Z and timeGrain eq duration'[PT1H|PT1M|P1D]}\n@returns(200) OK\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations\n@desc Get all recommendations for an app.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., hostingEnvironmentName: any # Name of the app.}\n@optional {featured: any # Specify true to return only the most critical recommendations. The default is false, which returns all recommendations., $filter: any # Return only channels specified in the filter. Filter is specified by using OData syntax. Example: $filter=channel eq 'Api' or channel eq 'Notification'}\n@returns(200) OK\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/disable\n@desc Disable all recommendations for an app.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., environmentName: any # Name of the app., hostingEnvironmentName: any}\n@returns(204) No Content\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/reset\n@desc Reset all recommendation opt-out settings for an app.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., environmentName: any # Name of the app., hostingEnvironmentName: any}\n@returns(204) No Content\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/{name}\n@desc Get a recommendation rule for an app.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., hostingEnvironmentName: any # Name of the hosting environment., name: any # Name of the recommendation.}\n@optional {updateSeen: any # Specify true to update the last-seen timestamp of the recommendation object., recommendationId: any # The GUID of the recommendation object if you query an expired one. You don't need to specify it to query an active entry.}\n@returns(200) OK\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/{name}/disable\n@desc Disables the specific rule for a web site permanently.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., environmentName: any # Site name, name: any # Rule name, hostingEnvironmentName: any}\n@returns(200) Successfully disabled recommendations.\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendationHistory\n@desc Get past recommendations for an app, optionally specified by the time range.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., siteName: any # Name of the app.}\n@optional {expiredOnly: any # Specify false to return all recommendations. The default is true, which returns only expired recommendations., $filter: any # Filter is specified by using OData syntax. Example: $filter=channel eq 'Api' or channel eq 'Notification' and startTime eq 2014-01-01T00:00:00Z and endTime eq 2014-12-31T23:59:59Z and timeGrain eq duration'[PT1H|PT1M|P1D]}\n@returns(200) OK\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations\n@desc Get all recommendations for an app.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., siteName: any # Name of the app.}\n@optional {featured: any # Specify true to return only the most critical recommendations. The default is false, which returns all recommendations., $filter: any # Return only channels specified in the filter. Filter is specified by using OData syntax. Example: $filter=channel eq 'Api' or channel eq 'Notification'}\n@returns(200) OK\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/disable\n@desc Disable all recommendations for an app.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., siteName: any # Name of the app.}\n@returns(204) No Content\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/reset\n@desc Reset all recommendation opt-out settings for an app.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., siteName: any # Name of the app.}\n@returns(204) No Content\n\n@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/{name}\n@desc Get a recommendation rule for an app.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., siteName: any # Name of the app., name: any # Name of the recommendation.}\n@optional {updateSeen: any # Specify true to update the last-seen timestamp of the recommendation object., recommendationId: any # The GUID of the recommendation object if you query an expired one. You don't need to specify it to query an active entry.}\n@returns(200) OK\n\n@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/{name}/disable\n@desc Disables the specific rule for a web site permanently.\n@required {resourceGroupName: any # Name of the resource group to which the resource belongs., siteName: any # Site name, name: any # Rule name}\n@returns(200) Successfully disabled recommendations.\n\n@end\n"}}