Skip to content

Commit

Permalink
[Hub Generated] Review request for Microsoft.Help to update swagger d…
Browse files Browse the repository at this point in the history
…ocumentation for version preview/2023-01-01-preview (#23357)

* updating api spec documentation

* updating api spec documentation #2

* updating api spec documentation #3
  • Loading branch information
BharathaAravind authored Mar 29, 2023
1 parent e5d60da commit 3e843e8
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 4 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
{
"solutionId": "SampleSolutionId",
"additionalParameters": {
"foo": "bar"
"serverName": "testServer"
}
}
],
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -123,7 +123,7 @@
"tags": [
"diagnostics"
],
"description": "<p><b>Overview:</b></p><p>Azure Help API programmatically helps you troubleshoot Azure issues and provides access to rich and powerful self-help solutions and diagnostics. Using the API, you can perform the following operations: <table><tr><td>Solution Discovery</td><td>Lists the diagnostics for an Azure issue based on the prerequisites.</td></tr><tr><td>Diagnostics</td><td>Create and Get diagnostics for issues with Azure resources based on prerequisites (see below).</td></tr></table></p><p><b>Prerequisites for Diagnostics:</b> <br/> <br/> The diagnostics API is called after solutions discovery and returns diagnostic info for your Azure issue. <br/> <br/>You must have <a href=\"https://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles#reader\">reader access role </a> at the resource level to create diagnostics. <br/> <br/> 'RequiredParameterSets' from Discovery Solutions API response has to be passed via 'properties.insights.additionalParameters' as a key-value pairs to Diagnostics Api.",
"description": "Diagnostics tells you precisely the root cause of the issue and how to address it. You can get diagnostics once you discover and identify the relevant solution for your Azure issue.<br/><br/> You can create diagnostics using the ‘solutionId’ from Solution Discovery API response and ‘additionalParameters’ <br/><br/> <b>Note: </b>‘requiredParameterSets’ from Solutions Discovery API response must be passed via ‘additionalParameters’ as an input to Diagnostics API",
"operationId": "Diagnostics_Create",
"x-ms-long-running-operation": true,
"x-ms-long-running-operation-options": {
Expand Down Expand Up @@ -172,7 +172,7 @@
"tags": [
"diagnostics"
],
"description": "<p><b>Overview:</b></p><p>Azure Help API programmatically helps you troubleshoot Azure issues and provides access to rich and powerful self-help solutions and diagnostics. Using the API, you can perform the following operations: <table><tr><td>Solution Discovery</td><td>Lists the diagnostics for an Azure issue based on the prerequisites.</td></tr><tr><td>Diagnostics</td><td>Create and Get diagnostics for issues with Azure resources based on prerequisites (see below).</td></tr></table></p><p><b>Prerequisites for Diagnostics:</b> <br/> <br/> The diagnostics API is called after solutions discovery and returns diagnostic info for your Azure issue. <br/> <br/>You must have <a href=\"https://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles#reader\">reader access role </a> at the resource level to get the diagnostics. <br/> <br/> 'RequiredParameterSets' from Discovery Solutions API response has to be passed via 'properties.insights.additionalParameters' as a key-value pairs to Diagnostics Api.",
"description": "Get the diagnostics using the 'diagnosticsResourceName' you chose while creating the diagnostic.",
"operationId": "Diagnostics_Get",
"parameters": [
{
Expand Down Expand Up @@ -211,7 +211,7 @@
"tags": [
"discoverySolutions"
],
"description": "<p><b>Overview:</b></p><p>Azure Help API programmatically helps you troubleshoot Azure issues and provides access to rich and powerful self-help solutions and diagnostics. Using the API, you can perform the following operations: <table><tr><td>Solution Discovery</td><td>Lists the diagnostics for an Azure issue based on the prerequisites (see below).</td></tr><tr><td>Diagnostics</td><td>Create and Get diagnostics for issues with Azure resources.</td></tr></table></p><p><b>Prerequisites for solution discovery:</b><br/> <br/>You can call the API to discover solutions with the following inputs: <br/> i. Required inputs: resourceUri. <br/>ii. Optional input: problemClassificationId. <br/> <br/> This API enables discovery of diagnostics for a defined list of Azure support issues, and is not supported for all ProblemClassificationId(s) at the moment. For ProblemClassificationId(s) that are not supported, the API response will not return any diagnostics. You can use ProblemClassifications API to get the problem categories and ProblemClassificationId(s) <a href=\"https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-faq#how-do-i-turn-on-antimalware-in-my-virtual-machine-scale-set\">reference.</a> <br/> <br/>You must have <a href=\"https://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles#reader\">reader access role </a> at the resource level to get the solutions.<br/><br/><b>Note:</b> 'RequiredParameterSets' from Discovery Solutions API response has to be passed via 'properties.insights.additionalParameters' as an input to Diagnostics API.</p>",
"description": "Solutions Discovery is the initial point of entry within Help API, which helps you identify the relevant solutions for your Azure issue.<br/><br/> You can discover solutions using resourceUri OR resourceUri + problemClassificationId.<br/><br/>We will do our best in returning relevant diagnostics for your Azure issue.<br/><br/> Get the problemClassificationId(s) using this [reference](https://learn.microsoft.com/en-us/rest/api/support/problem-classifications/list?tabs=HTTP).<br/><br/> <b>Note: </b> ‘requiredParameterSets’ from Solutions Discovery API response must be passed via ‘additionalParameters’ as an input to Diagnostics API.",
"operationId": "DiscoverySolution_List",
"parameters": [
{
Expand Down

0 comments on commit 3e843e8

Please sign in to comment.