From 3e843e8654bc25fd9a3c9b02e5e853d78dcb4aba Mon Sep 17 00:00:00 2001 From: Aravind Bharatha Date: Wed, 29 Mar 2023 19:39:25 -0400 Subject: [PATCH] [Hub Generated] Review request for Microsoft.Help to update swagger documentation for version preview/2023-01-01-preview (#23357) * updating api spec documentation * updating api spec documentation #2 * updating api spec documentation #3 --- .../examples/CreateDiagnosticForKeyVaultResource.json | 2 +- .../Microsoft.Help/preview/2023-01-01-preview/help.json | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/specification/help/resource-manager/Microsoft.Help/preview/2023-01-01-preview/examples/CreateDiagnosticForKeyVaultResource.json b/specification/help/resource-manager/Microsoft.Help/preview/2023-01-01-preview/examples/CreateDiagnosticForKeyVaultResource.json index f10d3a361a45..c2c326c76eda 100644 --- a/specification/help/resource-manager/Microsoft.Help/preview/2023-01-01-preview/examples/CreateDiagnosticForKeyVaultResource.json +++ b/specification/help/resource-manager/Microsoft.Help/preview/2023-01-01-preview/examples/CreateDiagnosticForKeyVaultResource.json @@ -9,7 +9,7 @@ { "solutionId": "SampleSolutionId", "additionalParameters": { - "foo": "bar" + "serverName": "testServer" } } ], diff --git a/specification/help/resource-manager/Microsoft.Help/preview/2023-01-01-preview/help.json b/specification/help/resource-manager/Microsoft.Help/preview/2023-01-01-preview/help.json index dd150f6fdcb9..18f4581f31ca 100644 --- a/specification/help/resource-manager/Microsoft.Help/preview/2023-01-01-preview/help.json +++ b/specification/help/resource-manager/Microsoft.Help/preview/2023-01-01-preview/help.json @@ -123,7 +123,7 @@ "tags": [ "diagnostics" ], - "description": "

Overview:

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:
Solution DiscoveryLists the diagnostics for an Azure issue based on the prerequisites.
DiagnosticsCreate and Get diagnostics for issues with Azure resources based on prerequisites (see below).

Prerequisites for Diagnostics:

The diagnostics API is called after solutions discovery and returns diagnostic info for your Azure issue.

You must have reader access role at the resource level to create diagnostics.

'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.

You can create diagnostics using the ‘solutionId’ from Solution Discovery API response and ‘additionalParameters’

Note: ‘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": { @@ -172,7 +172,7 @@ "tags": [ "diagnostics" ], - "description": "

Overview:

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:
Solution DiscoveryLists the diagnostics for an Azure issue based on the prerequisites.
DiagnosticsCreate and Get diagnostics for issues with Azure resources based on prerequisites (see below).

Prerequisites for Diagnostics:

The diagnostics API is called after solutions discovery and returns diagnostic info for your Azure issue.

You must have reader access role at the resource level to get the diagnostics.

'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": [ { @@ -211,7 +211,7 @@ "tags": [ "discoverySolutions" ], - "description": "

Overview:

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:
Solution DiscoveryLists the diagnostics for an Azure issue based on the prerequisites (see below).
DiagnosticsCreate and Get diagnostics for issues with Azure resources.

Prerequisites for solution discovery:

You can call the API to discover solutions with the following inputs:
i. Required inputs: resourceUri.
ii. Optional input: problemClassificationId.

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) reference.

You must have reader access role at the resource level to get the solutions.

Note: 'RequiredParameterSets' from Discovery Solutions API response has to be passed via 'properties.insights.additionalParameters' as an input to Diagnostics API.

", + "description": "Solutions Discovery is the initial point of entry within Help API, which helps you identify the relevant solutions for your Azure issue.

You can discover solutions using resourceUri OR resourceUri + problemClassificationId.

We will do our best in returning relevant diagnostics for your Azure issue.

Get the problemClassificationId(s) using this [reference](https://learn.microsoft.com/en-us/rest/api/support/problem-classifications/list?tabs=HTTP).

Note: ‘requiredParameterSets’ from Solutions Discovery API response must be passed via ‘additionalParameters’ as an input to Diagnostics API.", "operationId": "DiscoverySolution_List", "parameters": [ {