Microsoft.Help (preview:2023-09-01)

2025/09/12 • 13 new, 13 deleted methods

Operations_List (new)
Description Returns list of operations.
Reference Link ¶

⚼ Request

GET:  /providers/Microsoft.Help/operations
{
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
name: string ,
isDataAction: boolean ,
display:
{
provider: string ,
resource: string ,
operation: string ,
description: string ,
}
,
origin: enum ,
actionType: enum ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
CheckNameAvailability_Post (new)
Description This API is used to check the uniqueness of a resource name used for a diagnostic, troubleshooter or solutions
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/checkNameAvailability
{
scope: string ,
api-version: string ,
CheckNameAvailabilityRequest:
{
name: string ,
type: string ,
}
,
}

⚐ Response (200)

{
nameAvailable: boolean ,
reason: string ,
message: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Diagnostics_Create (new)
Description Creates a diagnostic for the specific resource using solutionId and requiredInputs* from discovery solutions.
Diagnostics are powerful solutions that access product resources or other relevant data and provide the root cause of the issue and the steps to address the issue.

Note: ‘requiredInputs’ from Discovery solutions response must be passed via ‘additionalParameters’ as an input to Diagnostics API.
Reference Link ¶

⚼ Request

PUT:  /{scope}/providers/Microsoft.Help/diagnostics/{diagnosticsResourceName}
{
scope: string ,
diagnosticsResourceName: string ,
api-version: string ,
diagnosticResourceRequest:
{
properties:
{
globalParameters: object ,
insights:
[
{
solutionId: string ,
additionalParameters: object ,
}
,
]
,
acceptedAt: string ,
provisioningState: enum ,
diagnostics:
[
{
solutionId: string ,
status: enum ,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
type: string ,
message: string ,
details:
[
string ,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
globalParameters: object ,
insights:
[
{
solutionId: string ,
additionalParameters: object ,
}
,
]
,
acceptedAt: string ,
provisioningState: enum ,
diagnostics:
[
{
solutionId: string ,
status: enum ,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
type: string ,
message: string ,
details:
[
string ,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
globalParameters: object ,
insights:
[
{
solutionId: string ,
additionalParameters: object ,
}
,
]
,
acceptedAt: string ,
provisioningState: enum ,
diagnostics:
[
{
solutionId: string ,
status: enum ,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
type: string ,
message: string ,
details:
[
string ,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Diagnostics_Get (new)
Description Get the diagnostics using the 'diagnosticsResourceName' you chose while creating the diagnostic.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/diagnostics/{diagnosticsResourceName}
{
scope: string ,
diagnosticsResourceName: string ,
api-version: string ,
}

⚐ Response (200)

{
properties:
{
globalParameters: object ,
insights:
[
{
solutionId: string ,
additionalParameters: object ,
}
,
]
,
acceptedAt: string ,
provisioningState: enum ,
diagnostics:
[
{
solutionId: string ,
status: enum ,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
type: string ,
message: string ,
details:
[
string ,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
DiscoverySolution_List (new)
Description Lists the relevant Azure diagnostics and solutions using [problemClassification API](https://learn.microsoft.com/rest/api/support/problem-classifications/list?tabs=HTTP)) AND resourceUri or resourceType.
Discovery Solutions is the initial entry point within Help API, which identifies relevant Azure diagnostics and solutions.

Required Input : problemClassificationId (Use the [problemClassification API](https://learn.microsoft.com/rest/api/support/problem-classifications/list?tabs=HTTP))
Optional input: resourceUri OR resource Type

Note: ‘requiredInputs’ from Discovery solutions response must be passed via ‘additionalParameters’ as an input to Diagnostics and Solutions API.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/discoverySolutions
{
scope: string ,
api-version: string ,
$filter: string ,
$skiptoken: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
solutions:
[
{
solutionId: string ,
solutionType: enum ,
description: string ,
requiredInputs:
[
string ,
]
,
}
,
]
,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Solution_Create (new)
Description Creates a solution for the specific Azure resource or subscription using the inputs ‘solutionId and requiredInputs’ from discovery solutions.
Azure solutions comprise a comprehensive library of self-help resources that have been thoughtfully curated by Azure engineers to aid customers in resolving typical troubleshooting issues. These solutions encompass (1.) dynamic and context-aware diagnostics, guided troubleshooting wizards, and data visualizations, (2.) rich instructional video tutorials and illustrative diagrams and images, and (3.) thoughtfully assembled textual troubleshooting instructions. All these components are seamlessly converged into unified solutions tailored to address a specific support problem area. Each solution type may require one or more ‘requiredParameters’ that are required to execute the individual solution component. In the absence of the ‘requiredParameters’ it is likely that some of the solutions might fail execution, and you might see an empty response.

Note:
1. ‘requiredInputs’ from Discovery solutions response must be passed via ‘parameters’ in the request body of Solutions API.
2. ‘requiredParameters’ from the Solutions response is the same as ‘ additionalParameters’ in the request for diagnostics
3. ‘requiredParameters’ from the Solutions response is the same as ‘properties.parameters’ in the request for Troubleshooters
Reference Link ¶

⚼ Request

PUT:  /{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}
{
scope: string ,
solutionResourceName: string ,
api-version: string ,
solutionRequestBody:
{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Solution_Get (new)
Description Get the solution using the applicable solutionResourceName while creating the solution.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}
{
scope: string ,
solutionResourceName: string ,
api-version: string ,
}

⚐ Response (200)

{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Solution_Update (new)
Description Update the requiredInputs or additional information needed to execute the solution
Reference Link ¶

⚼ Request

PATCH:  /{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}
{
scope: string ,
solutionResourceName: string ,
api-version: string ,
solutionPatchRequestBody:
{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
$headers:
{
location: string ,
}
,
$schema:
{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Troubleshooters_Create (new)
Description Creates the specific troubleshooter action under a resource or subscription using the ‘solutionId’ and ‘properties.parameters’ as the trigger.
Azure Troubleshooters help with hard to classify issues, reducing the gap between customer observed problems and solutions by guiding the user effortlessly through the troubleshooting process. Each Troubleshooter flow represents a problem area within Azure and has a complex tree-like structure that addresses many root causes. These flows are prepared with the help of Subject Matter experts and customer support engineers by carefully considering previous support requests raised by customers. Troubleshooters terminate at a well curated solution based off of resource backend signals and customer manual selections.
Reference Link ¶

⚼ Request

PUT:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}
{
scope: string ,
troubleshooterName: string ,
api-version: string ,
createTroubleshooterRequestBody:
{
properties:
{
solutionId: string ,
parameters: object ,
provisioningState: enum ,
steps:
[
{
id: string ,
title: string ,
description: string ,
guidance: string ,
executionStatus: enum ,
executionStatusDescription: string ,
type: enum ,
isLastStep: boolean ,
inputs:
[
{
questionId: string ,
questionType: enum ,
questionContent: string ,
questionContentType: enum ,
responseHint: string ,
recommendedOption: string ,
selectedOptionValue: string ,
responseValidationProperties:
{
regex: string ,
isRequired: boolean ,
validationErrorMessage: string ,
maxLength: integer ,
}
,
responseOptions:
[
{
key: string ,
value: string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
result: string ,
type: enum ,
}
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
solutionId: string ,
parameters: object ,
provisioningState: enum ,
steps:
[
{
id: string ,
title: string ,
description: string ,
guidance: string ,
executionStatus: enum ,
executionStatusDescription: string ,
type: enum ,
isLastStep: boolean ,
inputs:
[
{
questionId: string ,
questionType: enum ,
questionContent: string ,
questionContentType: enum ,
responseHint: string ,
recommendedOption: string ,
selectedOptionValue: string ,
responseValidationProperties:
{
regex: string ,
isRequired: boolean ,
validationErrorMessage: string ,
maxLength: integer ,
}
,
responseOptions:
[
{
key: string ,
value: string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
result: string ,
type: enum ,
}
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
solutionId: string ,
parameters: object ,
provisioningState: enum ,
steps:
[
{
id: string ,
title: string ,
description: string ,
guidance: string ,
executionStatus: enum ,
executionStatusDescription: string ,
type: enum ,
isLastStep: boolean ,
inputs:
[
{
questionId: string ,
questionType: enum ,
questionContent: string ,
questionContentType: enum ,
responseHint: string ,
recommendedOption: string ,
selectedOptionValue: string ,
responseValidationProperties:
{
regex: string ,
isRequired: boolean ,
validationErrorMessage: string ,
maxLength: integer ,
}
,
responseOptions:
[
{
key: string ,
value: string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
result: string ,
type: enum ,
}
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Troubleshooters_Get (new)
Description Gets troubleshooter instance result which includes the step status/result of the troubleshooter resource name that is being executed.
Get API is used to retrieve the result of a Troubleshooter instance, which includes the status and result of each step in the Troubleshooter workflow. This API requires the Troubleshooter resource name that was created using the Create API.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}
{
scope: string ,
troubleshooterName: string ,
api-version: string ,
}

⚐ Response (200)

{
properties:
{
solutionId: string ,
parameters: object ,
provisioningState: enum ,
steps:
[
{
id: string ,
title: string ,
description: string ,
guidance: string ,
executionStatus: enum ,
executionStatusDescription: string ,
type: enum ,
isLastStep: boolean ,
inputs:
[
{
questionId: string ,
questionType: enum ,
questionContent: string ,
questionContentType: enum ,
responseHint: string ,
recommendedOption: string ,
selectedOptionValue: string ,
responseValidationProperties:
{
regex: string ,
isRequired: boolean ,
validationErrorMessage: string ,
maxLength: integer ,
}
,
responseOptions:
[
{
key: string ,
value: string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
result: string ,
type: enum ,
}
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Troubleshooters_Continue (new)
Description Uses ‘stepId’ and ‘responses’ as the trigger to continue the troubleshooting steps for the respective troubleshooter resource name.
Continue API is used to provide inputs that are required for the specific troubleshooter to progress into the next step in the process. This API is used after the Troubleshooter has been created using the Create API.
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}/continue
{
scope: string ,
troubleshooterName: string ,
api-version: string ,
continueRequestBody:
{
stepId: string ,
responses:
[
{
questionId: string ,
questionType: enum ,
response: string ,
}
,
]
,
}
,
}

⚐ Response (204)

{
location: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Troubleshooters_End (new)
Description Ends the troubleshooter action
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}/end
{
scope: string ,
troubleshooterName: string ,
api-version: string ,
}

⚐ Response (204)

{
location: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Troubleshooters_Restart (new)
Description Restarts the troubleshooter API using applicable troubleshooter resource name as the input.
It returns new resource name which should be used in subsequent request. The old resource name is obsolete after this API is invoked.
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}/restart
{
scope: string ,
troubleshooterName: string ,
api-version: string ,
}

⚐ Response (200)

{
$headers:
{
location: string ,
}
,
$schema:
{
troubleshooterResourceName: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Operations_List (removed)
Description Returns list of operations.
Reference Link ¶

⚼ Request

GET:  /providers/Microsoft.Help/operations
{
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
name: string ,
isDataAction: boolean ,
display:
{
provider: string ,
resource: string ,
operation: string ,
description: string ,
}
,
origin: enum ,
actionType: enum ,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
CheckNameAvailability_Post (removed)
Description This API is used to check the uniqueness of a resource name used for a diagnostic, troubleshooter or solutions
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/checkNameAvailability
{
scope: string ,
api-version: string ,
CheckNameAvailabilityRequest:
{
name: string ,
type: string ,
}
,
}

⚐ Response (200)

{
nameAvailable: boolean ,
reason: string ,
message: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Diagnostics_Create (removed)
Description Creates a diagnostic for the specific resource using solutionId and requiredInputs* from discovery solutions.
Diagnostics are powerful solutions that access product resources or other relevant data and provide the root cause of the issue and the steps to address the issue.

Note: ‘requiredInputs’ from Discovery solutions response must be passed via ‘additionalParameters’ as an input to Diagnostics API.
Reference Link ¶

⚼ Request

PUT:  /{scope}/providers/Microsoft.Help/diagnostics/{diagnosticsResourceName}
{
scope: string ,
diagnosticsResourceName: string ,
api-version: string ,
diagnosticResourceRequest:
{
properties:
{
globalParameters: object ,
insights:
[
{
solutionId: string ,
additionalParameters: object ,
}
,
]
,
acceptedAt: string ,
provisioningState: enum ,
diagnostics:
[
{
solutionId: string ,
status: enum ,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
type: string ,
message: string ,
details:
[
string ,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
globalParameters: object ,
insights:
[
{
solutionId: string ,
additionalParameters: object ,
}
,
]
,
acceptedAt: string ,
provisioningState: enum ,
diagnostics:
[
{
solutionId: string ,
status: enum ,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
type: string ,
message: string ,
details:
[
string ,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
globalParameters: object ,
insights:
[
{
solutionId: string ,
additionalParameters: object ,
}
,
]
,
acceptedAt: string ,
provisioningState: enum ,
diagnostics:
[
{
solutionId: string ,
status: enum ,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
type: string ,
message: string ,
details:
[
string ,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Diagnostics_Get (removed)
Description Get the diagnostics using the 'diagnosticsResourceName' you chose while creating the diagnostic.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/diagnostics/{diagnosticsResourceName}
{
scope: string ,
diagnosticsResourceName: string ,
api-version: string ,
}

⚐ Response (200)

{
properties:
{
globalParameters: object ,
insights:
[
{
solutionId: string ,
additionalParameters: object ,
}
,
]
,
acceptedAt: string ,
provisioningState: enum ,
diagnostics:
[
{
solutionId: string ,
status: enum ,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
type: string ,
message: string ,
details:
[
string ,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
DiscoverySolution_List (removed)
Description Lists the relevant Azure diagnostics and solutions using [problemClassification API](https://learn.microsoft.com/rest/api/support/problem-classifications/list?tabs=HTTP)) AND resourceUri or resourceType.
Discovery Solutions is the initial entry point within Help API, which identifies relevant Azure diagnostics and solutions.

Required Input : problemClassificationId (Use the [problemClassification API](https://learn.microsoft.com/rest/api/support/problem-classifications/list?tabs=HTTP))
Optional input: resourceUri OR resource Type

Note: ‘requiredInputs’ from Discovery solutions response must be passed via ‘additionalParameters’ as an input to Diagnostics and Solutions API.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/discoverySolutions
{
scope: string ,
api-version: string ,
$filter: string ,
$skiptoken: string ,
}

⚐ Response (200)

{
value:
[
{
properties:
{
solutions:
[
{
solutionId: string ,
solutionType: enum ,
description: string ,
requiredInputs:
[
string ,
]
,
}
,
]
,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Solution_Create (removed)
Description Creates a solution for the specific Azure resource or subscription using the inputs ‘solutionId and requiredInputs’ from discovery solutions.
Azure solutions comprise a comprehensive library of self-help resources that have been thoughtfully curated by Azure engineers to aid customers in resolving typical troubleshooting issues. These solutions encompass (1.) dynamic and context-aware diagnostics, guided troubleshooting wizards, and data visualizations, (2.) rich instructional video tutorials and illustrative diagrams and images, and (3.) thoughtfully assembled textual troubleshooting instructions. All these components are seamlessly converged into unified solutions tailored to address a specific support problem area. Each solution type may require one or more ‘requiredParameters’ that are required to execute the individual solution component. In the absence of the ‘requiredParameters’ it is likely that some of the solutions might fail execution, and you might see an empty response.

Note:
1. ‘requiredInputs’ from Discovery solutions response must be passed via ‘parameters’ in the request body of Solutions API.
2. ‘requiredParameters’ from the Solutions response is the same as ‘ additionalParameters’ in the request for diagnostics
3. ‘requiredParameters’ from the Solutions response is the same as ‘properties.parameters’ in the request for Troubleshooters
Reference Link ¶

⚼ Request

PUT:  /{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}
{
scope: string ,
solutionResourceName: string ,
api-version: string ,
solutionRequestBody:
{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Solution_Get (removed)
Description Get the solution using the applicable solutionResourceName while creating the solution.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}
{
scope: string ,
solutionResourceName: string ,
api-version: string ,
}

⚐ Response (200)

{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Solution_Update (removed)
Description Update the requiredInputs or additional information needed to execute the solution
Reference Link ¶

⚼ Request

PATCH:  /{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}
{
scope: string ,
solutionResourceName: string ,
api-version: string ,
solutionPatchRequestBody:
{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
$headers:
{
location: string ,
}
,
$schema:
{
properties:
{
triggerCriteria:
[
{
name: enum ,
value: string ,
}
,
]
,
parameters: object ,
solutionId: string ,
provisioningState: enum ,
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
sections:
[
{
title: string ,
content: string ,
replacementMaps:
{
webResults:
[
{
replacementKey: string ,
searchResults:
[
{
solutionId: string ,
content: string ,
title: string ,
confidence: enum ,
source: string ,
resultType: enum ,
rank: integer ,
link: string ,
}
,
]
,
}
,
]
,
diagnostics:
[
{
solutionId: string ,
status: enum ,
statusDetails: string ,
replacementKey: string ,
requiredParameters:
[
string ,
]
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
}
,
]
,
troubleshooters:
[
{
solutionId: string ,
title: string ,
summary: string ,
}
,
]
,
metricsBasedCharts:
[
{
name: string ,
aggregationType: enum ,
timeSpanDuration: string ,
title: string ,
filterGroup:
{
filter:
[
{
name: string ,
values: string ,
operator: string ,
}
,
]
,
}
,
replacementKey: string ,
}
,
]
,
videos:
[
{
replacementKey: string ,
}
,
]
,
videoGroups:
[
{
videos:
[
{
src: string ,
title: string ,
}
,
]
,
replacementKey: string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Troubleshooters_Create (removed)
Description Creates the specific troubleshooter action under a resource or subscription using the ‘solutionId’ and ‘properties.parameters’ as the trigger.
Azure Troubleshooters help with hard to classify issues, reducing the gap between customer observed problems and solutions by guiding the user effortlessly through the troubleshooting process. Each Troubleshooter flow represents a problem area within Azure and has a complex tree-like structure that addresses many root causes. These flows are prepared with the help of Subject Matter experts and customer support engineers by carefully considering previous support requests raised by customers. Troubleshooters terminate at a well curated solution based off of resource backend signals and customer manual selections.
Reference Link ¶

⚼ Request

PUT:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}
{
scope: string ,
troubleshooterName: string ,
api-version: string ,
createTroubleshooterRequestBody:
{
properties:
{
solutionId: string ,
parameters: object ,
provisioningState: enum ,
steps:
[
{
id: string ,
title: string ,
description: string ,
guidance: string ,
executionStatus: enum ,
executionStatusDescription: string ,
type: enum ,
isLastStep: boolean ,
inputs:
[
{
questionId: string ,
questionType: enum ,
questionContent: string ,
questionContentType: enum ,
responseHint: string ,
recommendedOption: string ,
selectedOptionValue: string ,
responseValidationProperties:
{
regex: string ,
isRequired: boolean ,
validationErrorMessage: string ,
maxLength: integer ,
}
,
responseOptions:
[
{
key: string ,
value: string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
result: string ,
type: enum ,
}
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
solutionId: string ,
parameters: object ,
provisioningState: enum ,
steps:
[
{
id: string ,
title: string ,
description: string ,
guidance: string ,
executionStatus: enum ,
executionStatusDescription: string ,
type: enum ,
isLastStep: boolean ,
inputs:
[
{
questionId: string ,
questionType: enum ,
questionContent: string ,
questionContentType: enum ,
responseHint: string ,
recommendedOption: string ,
selectedOptionValue: string ,
responseValidationProperties:
{
regex: string ,
isRequired: boolean ,
validationErrorMessage: string ,
maxLength: integer ,
}
,
responseOptions:
[
{
key: string ,
value: string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
result: string ,
type: enum ,
}
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
solutionId: string ,
parameters: object ,
provisioningState: enum ,
steps:
[
{
id: string ,
title: string ,
description: string ,
guidance: string ,
executionStatus: enum ,
executionStatusDescription: string ,
type: enum ,
isLastStep: boolean ,
inputs:
[
{
questionId: string ,
questionType: enum ,
questionContent: string ,
questionContentType: enum ,
responseHint: string ,
recommendedOption: string ,
selectedOptionValue: string ,
responseValidationProperties:
{
regex: string ,
isRequired: boolean ,
validationErrorMessage: string ,
maxLength: integer ,
}
,
responseOptions:
[
{
key: string ,
value: string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
result: string ,
type: enum ,
}
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Troubleshooters_Get (removed)
Description Gets troubleshooter instance result which includes the step status/result of the troubleshooter resource name that is being executed.
Get API is used to retrieve the result of a Troubleshooter instance, which includes the status and result of each step in the Troubleshooter workflow. This API requires the Troubleshooter resource name that was created using the Create API.
Reference Link ¶

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}
{
scope: string ,
troubleshooterName: string ,
api-version: string ,
}

⚐ Response (200)

{
properties:
{
solutionId: string ,
parameters: object ,
provisioningState: enum ,
steps:
[
{
id: string ,
title: string ,
description: string ,
guidance: string ,
executionStatus: enum ,
executionStatusDescription: string ,
type: enum ,
isLastStep: boolean ,
inputs:
[
{
questionId: string ,
questionType: enum ,
questionContent: string ,
questionContentType: enum ,
responseHint: string ,
recommendedOption: string ,
selectedOptionValue: string ,
responseValidationProperties:
{
regex: string ,
isRequired: boolean ,
validationErrorMessage: string ,
maxLength: integer ,
}
,
responseOptions:
[
{
key: string ,
value: string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
result: string ,
type: enum ,
}
,
insights:
[
{
id: string ,
title: string ,
results: string ,
importanceLevel: enum ,
}
,
]
,
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Troubleshooters_Continue (removed)
Description Uses ‘stepId’ and ‘responses’ as the trigger to continue the troubleshooting steps for the respective troubleshooter resource name.
Continue API is used to provide inputs that are required for the specific troubleshooter to progress into the next step in the process. This API is used after the Troubleshooter has been created using the Create API.
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}/continue
{
scope: string ,
troubleshooterName: string ,
api-version: string ,
continueRequestBody:
{
stepId: string ,
responses:
[
{
questionId: string ,
questionType: enum ,
response: string ,
}
,
]
,
}
,
}

⚐ Response (204)

{
location: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Troubleshooters_End (removed)
Description Ends the troubleshooter action
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}/end
{
scope: string ,
troubleshooterName: string ,
api-version: string ,
}

⚐ Response (204)

{
location: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Troubleshooters_Restart (removed)
Description Restarts the troubleshooter API using applicable troubleshooter resource name as the input.
It returns new resource name which should be used in subsequent request. The old resource name is obsolete after this API is invoked.
Reference Link ¶

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}/restart
{
scope: string ,
troubleshooterName: string ,
api-version: string ,
}

⚐ Response (200)

{
$headers:
{
location: string ,
}
,
$schema:
{
troubleshooterResourceName: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}