Microsoft.Help (preview:2024-03-01)

2025/08/15 • 19 updated methods

CheckNameAvailability_CheckAvailability (updated)
Description :  This API is used to check the uniqueness of a resource name used for a diagnostic, troubleshooter or solutions
Reference :  Link ¶

⚶ Changes

{
  "#id": "CheckNameAvailability_CheckAvailability",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    }
  ]
}

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/checkNameAvailability
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
CheckNameAvailabilityRequest:
{
Description: The required parameters for availability check. ,
Required: False ,
}
{
name:
{
Description: The name of the resource for which availability needs to be checked. ,
Required: False ,
}
string ,
type:
{
Description: The resource type. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
nameAvailable:
{
Description: Returns true or false depending on the availability of the name ,
Required: False ,
}
boolean ,
reason:
{
Description: Reason for why value is not available. This field is returned if nameAvailable is false. ,
Required: False ,
}
string ,
message:
{
Description: Gets an error message explaining the 'reason' value with more details. This field is returned iif nameAvailable is false. ,
Required: False ,
}
string ,
}

⚐ Response (default)

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

⚶ Changes

{
  "#id": "Diagnostics_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    }
  ]
}

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/diagnostics/{diagnosticsResourceName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
diagnosticsResourceName:
{
Description: Unique resource name for insight resources ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Diagnostic Resource properties. ,
Required: False ,
}
{
globalParameters:
{
Description: Global parameters is an optional map which can be used to add key and value to request body to improve the diagnostics results ,
Required: False ,
}
object ,
insights:
{
Description: SolutionIds that are needed to be invoked. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to invoke. ,
Required: False ,
}
string ,
additionalParameters:
{
Description: Additional parameters required to invoke the solutionId. ,
Required: False ,
}
object ,
}
,
]
,
acceptedAt:
{
Description: Diagnostic Request Accepted time. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of diagnostic provisioning. ,
Enum:
{
Succeeded: All Diagnostics in the Batch succeeded. ,
PartialComplete: Some Diagnostics are still running or failed. ,
Failed: All Diagnostics failed to run. ,
Running: All Diagnostics are still running. ,
Canceled: When Diagnostic request gets canceled. ,
}
,
Required: False ,
}
enum ,
diagnostics:
{
Description: Array of Diagnostics. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
insights:
{
Description: The problems (if any) detected by this insight. ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
error:
{
Description: Error definition. ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
type:
{
Description: Service specific error type which serves as additional context for the error herein. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of additional nested error response info objects, as described by this contract. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Diagnostics_Create (updated)
Description :  Creates a diagnostic for the specific resource using solutionId 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.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Diagnostics_Create",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    }
  ]
}

⚼ Request

PUT:  /{scope}/providers/Microsoft.Help/diagnostics/{diagnosticsResourceName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
diagnosticsResourceName:
{
Description: Unique resource name for insight resources ,
Required: True ,
}
string ,
diagnosticResourceRequest:
{
Description: The required request body for this insightResource invocation. ,
Required: False ,
}
{
properties:
{
Description: Diagnostic Resource properties. ,
Required: False ,
}
{
globalParameters:
{
Description: Global parameters is an optional map which can be used to add key and value to request body to improve the diagnostics results ,
Required: False ,
}
object ,
insights:
{
Description: SolutionIds that are needed to be invoked. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to invoke. ,
Required: False ,
}
string ,
additionalParameters:
{
Description: Additional parameters required to invoke the solutionId. ,
Required: False ,
}
object ,
}
,
]
,
acceptedAt:
{
Description: Diagnostic Request Accepted time. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of diagnostic provisioning. ,
Enum:
{
Succeeded: All Diagnostics in the Batch succeeded. ,
PartialComplete: Some Diagnostics are still running or failed. ,
Failed: All Diagnostics failed to run. ,
Running: All Diagnostics are still running. ,
Canceled: When Diagnostic request gets canceled. ,
}
,
Required: False ,
}
enum ,
diagnostics:
{
Description: Array of Diagnostics. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
insights:
{
Description: The problems (if any) detected by this insight. ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
error:
{
Description: Error definition. ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
type:
{
Description: Service specific error type which serves as additional context for the error herein. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of additional nested error response info objects, as described by this contract. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Diagnostic Resource properties. ,
Required: False ,
}
{
globalParameters:
{
Description: Global parameters is an optional map which can be used to add key and value to request body to improve the diagnostics results ,
Required: False ,
}
object ,
insights:
{
Description: SolutionIds that are needed to be invoked. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to invoke. ,
Required: False ,
}
string ,
additionalParameters:
{
Description: Additional parameters required to invoke the solutionId. ,
Required: False ,
}
object ,
}
,
]
,
acceptedAt:
{
Description: Diagnostic Request Accepted time. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of diagnostic provisioning. ,
Enum:
{
Succeeded: All Diagnostics in the Batch succeeded. ,
PartialComplete: Some Diagnostics are still running or failed. ,
Failed: All Diagnostics failed to run. ,
Running: All Diagnostics are still running. ,
Canceled: When Diagnostic request gets canceled. ,
}
,
Required: False ,
}
enum ,
diagnostics:
{
Description: Array of Diagnostics. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
insights:
{
Description: The problems (if any) detected by this insight. ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
error:
{
Description: Error definition. ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
type:
{
Description: Service specific error type which serves as additional context for the error herein. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of additional nested error response info objects, as described by this contract. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (201)

{
$headers:
{
azure-asyncoperation:
{
Description: A link to the status monitor ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}
,
$schema:
{
Description: Diagnostic resource ,
}
{
properties:
{
Description: Diagnostic Resource properties. ,
Required: False ,
}
{
globalParameters:
{
Description: Global parameters is an optional map which can be used to add key and value to request body to improve the diagnostics results ,
Required: False ,
}
object ,
insights:
{
Description: SolutionIds that are needed to be invoked. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to invoke. ,
Required: False ,
}
string ,
additionalParameters:
{
Description: Additional parameters required to invoke the solutionId. ,
Required: False ,
}
object ,
}
,
]
,
acceptedAt:
{
Description: Diagnostic Request Accepted time. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of diagnostic provisioning. ,
Enum:
{
Succeeded: All Diagnostics in the Batch succeeded. ,
PartialComplete: Some Diagnostics are still running or failed. ,
Failed: All Diagnostics failed to run. ,
Running: All Diagnostics are still running. ,
Canceled: When Diagnostic request gets canceled. ,
}
,
Required: False ,
}
enum ,
diagnostics:
{
Description: Array of Diagnostics. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
insights:
{
Description: The problems (if any) detected by this insight. ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
error:
{
Description: Error definition. ,
Required: False ,
}
{
code:
{
Description: Service specific error code which serves as the substatus for the HTTP error code. ,
Required: False ,
}
string ,
type:
{
Description: Service specific error type which serves as additional context for the error herein. ,
Required: False ,
}
string ,
message:
{
Description: Description of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of additional nested error response info objects, as described by this contract. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
SimplifiedSolutions_Get (updated)
Description :  Get the simplified Solutions using the applicable solutionResourceName while creating the simplified Solutions.
Reference :  Link ¶

⚶ Changes

{
  "#id": "SimplifiedSolutions_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "Succeeded",
                  "All Solutions in the Batch succeeded."
                ],
                [
                  "PartialComplete",
                  "Some Solutions are still running or failed."
                ],
                [
                  "Failed",
                  "All Solutions failed to run."
                ],
                [
                  "Running",
                  "All Solutions are still running."
                ],
                [
                  "Canceled",
                  "When Solutions request gets canceled."
                ]
              ],
              "old": [
                [
                  "Succeeded",
                  "All Simplified Solutions in the Batch succeeded."
                ],
                [
                  "PartialComplete",
                  "Some Simplified Solutions are still running or failed."
                ],
                [
                  "Failed",
                  "All Simplified Solutions failed to run."
                ],
                [
                  "Running",
                  "All Simplified Solutions are still running."
                ],
                [
                  "Canceled",
                  "When Simplified Solutions request gets canceled."
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/simplifiedSolutions/{simplifiedSolutionsResourceName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
simplifiedSolutionsResourceName:
{
Description: Simplified Solutions Resource Name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Simplified Solutions result ,
Required: False ,
}
{
solutionId:
{
Description: Solution Id to identify single Simplified Solution. ,
Required: False ,
}
string ,
parameters:
{
Description: Client input parameters to run Simplified Solutions ,
Required: False ,
}
object ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
appendix:
{
Description: Additional parameter response for Simplified Solutions ,
Required: False ,
}
object ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of Simplified Solution provisioning. ,
Enum:
{
Succeeded: All Solutions in the Batch succeeded. ,
PartialComplete: Some Solutions are still running or failed. ,
Failed: All Solutions failed to run. ,
Running: All Solutions are still running. ,
Canceled: When Solutions request gets canceled. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
SimplifiedSolutions_Create (updated)
Description :  Creates Simplified Solutions for an Azure subscription using 'solutionId' from Discovery Solutions as the input.

Simplified Solutions API makes the consumption of solutions APIs easier while still providing access to the same powerful solutions rendered in Solutions API. With Simplified Solutions, users don't have to worry about stitching together the article using replacement maps and can use the content in the API response to directly render as HTML content.
Reference :  Link ¶

⚶ Changes

{
  "#id": "SimplifiedSolutions_Create",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    },
    {
      "simplifiedSolutionsRequestBody": {
        "$properties": {
          "properties": [
            {
              "#name": "provisioningState",
              "Enum": {
                "new": [
                  [
                    "Succeeded",
                    "All Solutions in the Batch succeeded."
                  ],
                  [
                    "PartialComplete",
                    "Some Solutions are still running or failed."
                  ],
                  [
                    "Failed",
                    "All Solutions failed to run."
                  ],
                  [
                    "Running",
                    "All Solutions are still running."
                  ],
                  [
                    "Canceled",
                    "When Solutions request gets canceled."
                  ]
                ],
                "old": [
                  [
                    "Succeeded",
                    "All Simplified Solutions in the Batch succeeded."
                  ],
                  [
                    "PartialComplete",
                    "Some Simplified Solutions are still running or failed."
                  ],
                  [
                    "Failed",
                    "All Simplified Solutions failed to run."
                  ],
                  [
                    "Running",
                    "All Simplified Solutions are still running."
                  ],
                  [
                    "Canceled",
                    "When Simplified Solutions request gets canceled."
                  ]
                ]
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "Succeeded",
                  "All Solutions in the Batch succeeded."
                ],
                [
                  "PartialComplete",
                  "Some Solutions are still running or failed."
                ],
                [
                  "Failed",
                  "All Solutions failed to run."
                ],
                [
                  "Running",
                  "All Solutions are still running."
                ],
                [
                  "Canceled",
                  "When Solutions request gets canceled."
                ]
              ],
              "old": [
                [
                  "Succeeded",
                  "All Simplified Solutions in the Batch succeeded."
                ],
                [
                  "PartialComplete",
                  "Some Simplified Solutions are still running or failed."
                ],
                [
                  "Failed",
                  "All Simplified Solutions failed to run."
                ],
                [
                  "Running",
                  "All Simplified Solutions are still running."
                ],
                [
                  "Canceled",
                  "When Simplified Solutions request gets canceled."
                ]
              ]
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "provisioningState",
            "Enum": {
              "new": [
                [
                  "Succeeded",
                  "All Solutions in the Batch succeeded."
                ],
                [
                  "PartialComplete",
                  "Some Solutions are still running or failed."
                ],
                [
                  "Failed",
                  "All Solutions failed to run."
                ],
                [
                  "Running",
                  "All Solutions are still running."
                ],
                [
                  "Canceled",
                  "When Solutions request gets canceled."
                ]
              ],
              "old": [
                [
                  "Succeeded",
                  "All Simplified Solutions in the Batch succeeded."
                ],
                [
                  "PartialComplete",
                  "Some Simplified Solutions are still running or failed."
                ],
                [
                  "Failed",
                  "All Simplified Solutions failed to run."
                ],
                [
                  "Running",
                  "All Simplified Solutions are still running."
                ],
                [
                  "Canceled",
                  "When Simplified Solutions request gets canceled."
                ]
              ]
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /{scope}/providers/Microsoft.Help/simplifiedSolutions/{simplifiedSolutionsResourceName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
simplifiedSolutionsResourceName:
{
Description: Simplified Solutions Resource Name. ,
Required: True ,
}
string ,
simplifiedSolutionsRequestBody:
{
Description: The required request body for simplified Solutions resource creation. ,
Required: False ,
}
{
properties:
{
Description: Simplified Solutions result ,
Required: False ,
}
{
solutionId:
{
Description: Solution Id to identify single Simplified Solution. ,
Required: False ,
}
string ,
parameters:
{
Description: Client input parameters to run Simplified Solutions ,
Required: False ,
}
object ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
appendix:
{
Description: Additional parameter response for Simplified Solutions ,
Required: False ,
}
object ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of Simplified Solution provisioning. ,
Enum:
{
Succeeded: All Solutions in the Batch succeeded. ,
PartialComplete: Some Solutions are still running or failed. ,
Failed: All Solutions failed to run. ,
Running: All Solutions are still running. ,
Canceled: When Solutions request gets canceled. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Simplified Solutions result ,
Required: False ,
}
{
solutionId:
{
Description: Solution Id to identify single Simplified Solution. ,
Required: False ,
}
string ,
parameters:
{
Description: Client input parameters to run Simplified Solutions ,
Required: False ,
}
object ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
appendix:
{
Description: Additional parameter response for Simplified Solutions ,
Required: False ,
}
object ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of Simplified Solution provisioning. ,
Enum:
{
Succeeded: All Solutions in the Batch succeeded. ,
PartialComplete: Some Solutions are still running or failed. ,
Failed: All Solutions failed to run. ,
Running: All Solutions are still running. ,
Canceled: When Solutions request gets canceled. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
$headers:
{
azure-asyncoperation:
{
Description: A link to the status monitor ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}
,
$schema:
{
Description: Simplified Solutions response. ,
}
{
properties:
{
Description: Simplified Solutions result ,
Required: False ,
}
{
solutionId:
{
Description: Solution Id to identify single Simplified Solution. ,
Required: False ,
}
string ,
parameters:
{
Description: Client input parameters to run Simplified Solutions ,
Required: False ,
}
object ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
appendix:
{
Description: Additional parameter response for Simplified Solutions ,
Required: False ,
}
object ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of Simplified Solution provisioning. ,
Enum:
{
Succeeded: All Solutions in the Batch succeeded. ,
PartialComplete: Some Solutions are still running or failed. ,
Failed: All Solutions failed to run. ,
Running: All Solutions are still running. ,
Canceled: When Solutions request gets canceled. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

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

⚶ Changes

{
  "#id": "Solution_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "replacementMaps": [
              {
                "diagnostics": {
                  "$properties": [
                    {
                      "#name": "status",
                      "Description": {
                        "new": "Denotes the status of the diagnostic resource.",
                        "old": "The status of the resource."
                      },
                      "Enum": {
                        "new": [
                          [
                            "Failed",
                            "Diagnostic creation failed."
                          ],
                          [
                            "MissingInputs",
                            "Request is missing required inputs to run."
                          ],
                          [
                            "Running",
                            "Diagnostic is still running."
                          ],
                          [
                            "Succeeded",
                            "Diagnostic creation succeeded."
                          ],
                          [
                            "Timeout",
                            "Diagnostic was timed out."
                          ]
                        ],
                        "old": [
                          [
                            "Failed",
                            ""
                          ],
                          [
                            "MissingInputs",
                            ""
                          ],
                          [
                            "Running",
                            ""
                          ],
                          [
                            "Succeeded",
                            ""
                          ],
                          [
                            "Timeout",
                            ""
                          ]
                        ]
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "sections": {
              "$properties": {
                "replacementMaps": [
                  {
                    "diagnostics": {
                      "$properties": [
                        {
                          "#name": "status",
                          "Description": {
                            "new": "Denotes the status of the diagnostic resource.",
                            "old": "The status of the resource."
                          },
                          "Enum": {
                            "new": [
                              [
                                "Failed",
                                "Diagnostic creation failed."
                              ],
                              [
                                "MissingInputs",
                                "Request is missing required inputs to run."
                              ],
                              [
                                "Running",
                                "Diagnostic is still running."
                              ],
                              [
                                "Succeeded",
                                "Diagnostic creation succeeded."
                              ],
                              [
                                "Timeout",
                                "Diagnostic was timed out."
                              ]
                            ],
                            "old": [
                              [
                                "Failed",
                                ""
                              ],
                              [
                                "MissingInputs",
                                ""
                              ],
                              [
                                "Running",
                                ""
                              ],
                              [
                                "Succeeded",
                                ""
                              ],
                              [
                                "Timeout",
                                ""
                              ]
                            ]
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
solutionResourceName:
{
Description: Solution resource Name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Solution result ,
Required: False ,
}
{
triggerCriteria:
{
Description: Solution request trigger criteria ,
Required: False ,
}
[
{
name:
{
Description: Trigger criterion name. ,
Enum:
{
SolutionId: No description available. ,
ProblemClassificationId: No description available. ,
ReplacementKey: No description available. ,
}
,
Required: False ,
}
enum ,
value:
{
Description: Trigger criterion value. ,
Required: False ,
}
string ,
}
,
]
,
parameters:
{
Description: Client input parameters to run Solution ,
Required: False ,
}
object ,
solutionId:
{
Description: Solution Id to identify single solution. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of solution provisioning. ,
Enum:
{
Succeeded: All Solutions in the Batch succeeded. ,
PartialComplete: Some Solutions are still running or failed. ,
Failed: All Solutions failed to run. ,
Running: All Solutions are still running. ,
Canceled: When Solutions request gets canceled. ,
}
,
Required: False ,
}
enum ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
sections:
{
Description: List of section object. ,
Required: False ,
}
[
{
title:
{
Description: Solution sections title. ,
Required: False ,
}
string ,
content:
{
Description: Solution sections content. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Solution_Create (updated)
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.
(3.) Thoughtfully assembled textual troubleshooting instructions.
All these components are seamlessly converged into unified solutions tailored to address a specific support problem area.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Solution_Create",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    },
    {
      "solutionRequestBody": {
        "$properties": {
          "properties": [
            {
              "replacementMaps": [
                {
                  "diagnostics": {
                    "$properties": [
                      {
                        "#name": "status",
                        "Description": {
                          "new": "Denotes the status of the diagnostic resource.",
                          "old": "The status of the resource."
                        },
                        "Enum": {
                          "new": [
                            [
                              "Failed",
                              "Diagnostic creation failed."
                            ],
                            [
                              "MissingInputs",
                              "Request is missing required inputs to run."
                            ],
                            [
                              "Running",
                              "Diagnostic is still running."
                            ],
                            [
                              "Succeeded",
                              "Diagnostic creation succeeded."
                            ],
                            [
                              "Timeout",
                              "Diagnostic was timed out."
                            ]
                          ],
                          "old": [
                            [
                              "Failed",
                              ""
                            ],
                            [
                              "MissingInputs",
                              ""
                            ],
                            [
                              "Running",
                              ""
                            ],
                            [
                              "Succeeded",
                              ""
                            ],
                            [
                              "Timeout",
                              ""
                            ]
                          ]
                        }
                      }
                    ]
                  }
                }
              ]
            },
            {
              "sections": {
                "$properties": {
                  "replacementMaps": [
                    {
                      "diagnostics": {
                        "$properties": [
                          {
                            "#name": "status",
                            "Description": {
                              "new": "Denotes the status of the diagnostic resource.",
                              "old": "The status of the resource."
                            },
                            "Enum": {
                              "new": [
                                [
                                  "Failed",
                                  "Diagnostic creation failed."
                                ],
                                [
                                  "MissingInputs",
                                  "Request is missing required inputs to run."
                                ],
                                [
                                  "Running",
                                  "Diagnostic is still running."
                                ],
                                [
                                  "Succeeded",
                                  "Diagnostic creation succeeded."
                                ],
                                [
                                  "Timeout",
                                  "Diagnostic was timed out."
                                ]
                              ],
                              "old": [
                                [
                                  "Failed",
                                  ""
                                ],
                                [
                                  "MissingInputs",
                                  ""
                                ],
                                [
                                  "Running",
                                  ""
                                ],
                                [
                                  "Succeeded",
                                  ""
                                ],
                                [
                                  "Timeout",
                                  ""
                                ]
                              ]
                            }
                          }
                        ]
                      }
                    }
                  ]
                }
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "replacementMaps": [
              {
                "diagnostics": {
                  "$properties": [
                    {
                      "#name": "status",
                      "Description": {
                        "new": "Denotes the status of the diagnostic resource.",
                        "old": "The status of the resource."
                      },
                      "Enum": {
                        "new": [
                          [
                            "Failed",
                            "Diagnostic creation failed."
                          ],
                          [
                            "MissingInputs",
                            "Request is missing required inputs to run."
                          ],
                          [
                            "Running",
                            "Diagnostic is still running."
                          ],
                          [
                            "Succeeded",
                            "Diagnostic creation succeeded."
                          ],
                          [
                            "Timeout",
                            "Diagnostic was timed out."
                          ]
                        ],
                        "old": [
                          [
                            "Failed",
                            ""
                          ],
                          [
                            "MissingInputs",
                            ""
                          ],
                          [
                            "Running",
                            ""
                          ],
                          [
                            "Succeeded",
                            ""
                          ],
                          [
                            "Timeout",
                            ""
                          ]
                        ]
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "sections": {
              "$properties": {
                "replacementMaps": [
                  {
                    "diagnostics": {
                      "$properties": [
                        {
                          "#name": "status",
                          "Description": {
                            "new": "Denotes the status of the diagnostic resource.",
                            "old": "The status of the resource."
                          },
                          "Enum": {
                            "new": [
                              [
                                "Failed",
                                "Diagnostic creation failed."
                              ],
                              [
                                "MissingInputs",
                                "Request is missing required inputs to run."
                              ],
                              [
                                "Running",
                                "Diagnostic is still running."
                              ],
                              [
                                "Succeeded",
                                "Diagnostic creation succeeded."
                              ],
                              [
                                "Timeout",
                                "Diagnostic was timed out."
                              ]
                            ],
                            "old": [
                              [
                                "Failed",
                                ""
                              ],
                              [
                                "MissingInputs",
                                ""
                              ],
                              [
                                "Running",
                                ""
                              ],
                              [
                                "Succeeded",
                                ""
                              ],
                              [
                                "Timeout",
                                ""
                              ]
                            ]
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "replacementMaps": [
              {
                "diagnostics": {
                  "$properties": [
                    {
                      "#name": "status",
                      "Description": {
                        "new": "Denotes the status of the diagnostic resource.",
                        "old": "The status of the resource."
                      },
                      "Enum": {
                        "new": [
                          [
                            "Failed",
                            "Diagnostic creation failed."
                          ],
                          [
                            "MissingInputs",
                            "Request is missing required inputs to run."
                          ],
                          [
                            "Running",
                            "Diagnostic is still running."
                          ],
                          [
                            "Succeeded",
                            "Diagnostic creation succeeded."
                          ],
                          [
                            "Timeout",
                            "Diagnostic was timed out."
                          ]
                        ],
                        "old": [
                          [
                            "Failed",
                            ""
                          ],
                          [
                            "MissingInputs",
                            ""
                          ],
                          [
                            "Running",
                            ""
                          ],
                          [
                            "Succeeded",
                            ""
                          ],
                          [
                            "Timeout",
                            ""
                          ]
                        ]
                      }
                    }
                  ]
                }
              }
            ]
          },
          {
            "sections": {
              "$properties": {
                "replacementMaps": [
                  {
                    "diagnostics": {
                      "$properties": [
                        {
                          "#name": "status",
                          "Description": {
                            "new": "Denotes the status of the diagnostic resource.",
                            "old": "The status of the resource."
                          },
                          "Enum": {
                            "new": [
                              [
                                "Failed",
                                "Diagnostic creation failed."
                              ],
                              [
                                "MissingInputs",
                                "Request is missing required inputs to run."
                              ],
                              [
                                "Running",
                                "Diagnostic is still running."
                              ],
                              [
                                "Succeeded",
                                "Diagnostic creation succeeded."
                              ],
                              [
                                "Timeout",
                                "Diagnostic was timed out."
                              ]
                            ],
                            "old": [
                              [
                                "Failed",
                                ""
                              ],
                              [
                                "MissingInputs",
                                ""
                              ],
                              [
                                "Running",
                                ""
                              ],
                              [
                                "Succeeded",
                                ""
                              ],
                              [
                                "Timeout",
                                ""
                              ]
                            ]
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
solutionResourceName:
{
Description: Solution resource Name. ,
Required: True ,
}
string ,
solutionRequestBody:
{
Description: The required request body for this solution resource creation. ,
Required: False ,
}
{
properties:
{
Description: Solution result ,
Required: False ,
}
{
triggerCriteria:
{
Description: Solution request trigger criteria ,
Required: False ,
}
[
{
name:
{
Description: Trigger criterion name. ,
Enum:
{
SolutionId: No description available. ,
ProblemClassificationId: No description available. ,
ReplacementKey: No description available. ,
}
,
Required: False ,
}
enum ,
value:
{
Description: Trigger criterion value. ,
Required: False ,
}
string ,
}
,
]
,
parameters:
{
Description: Client input parameters to run Solution ,
Required: False ,
}
object ,
solutionId:
{
Description: Solution Id to identify single solution. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of solution provisioning. ,
Enum:
{
Succeeded: All Solutions in the Batch succeeded. ,
PartialComplete: Some Solutions are still running or failed. ,
Failed: All Solutions failed to run. ,
Running: All Solutions are still running. ,
Canceled: When Solutions request gets canceled. ,
}
,
Required: False ,
}
enum ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
sections:
{
Description: List of section object. ,
Required: False ,
}
[
{
title:
{
Description: Solution sections title. ,
Required: False ,
}
string ,
content:
{
Description: Solution sections content. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Solution result ,
Required: False ,
}
{
triggerCriteria:
{
Description: Solution request trigger criteria ,
Required: False ,
}
[
{
name:
{
Description: Trigger criterion name. ,
Enum:
{
SolutionId: No description available. ,
ProblemClassificationId: No description available. ,
ReplacementKey: No description available. ,
}
,
Required: False ,
}
enum ,
value:
{
Description: Trigger criterion value. ,
Required: False ,
}
string ,
}
,
]
,
parameters:
{
Description: Client input parameters to run Solution ,
Required: False ,
}
object ,
solutionId:
{
Description: Solution Id to identify single solution. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of solution provisioning. ,
Enum:
{
Succeeded: All Solutions in the Batch succeeded. ,
PartialComplete: Some Solutions are still running or failed. ,
Failed: All Solutions failed to run. ,
Running: All Solutions are still running. ,
Canceled: When Solutions request gets canceled. ,
}
,
Required: False ,
}
enum ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
sections:
{
Description: List of section object. ,
Required: False ,
}
[
{
title:
{
Description: Solution sections title. ,
Required: False ,
}
string ,
content:
{
Description: Solution sections content. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (201)

{
$headers:
{
azure-asyncoperation:
{
Description: A link to the status monitor ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}
,
$schema:
{
Description: Solution response. ,
}
{
properties:
{
Description: Solution result ,
Required: False ,
}
{
triggerCriteria:
{
Description: Solution request trigger criteria ,
Required: False ,
}
[
{
name:
{
Description: Trigger criterion name. ,
Enum:
{
SolutionId: No description available. ,
ProblemClassificationId: No description available. ,
ReplacementKey: No description available. ,
}
,
Required: False ,
}
enum ,
value:
{
Description: Trigger criterion value. ,
Required: False ,
}
string ,
}
,
]
,
parameters:
{
Description: Client input parameters to run Solution ,
Required: False ,
}
object ,
solutionId:
{
Description: Solution Id to identify single solution. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of solution provisioning. ,
Enum:
{
Succeeded: All Solutions in the Batch succeeded. ,
PartialComplete: Some Solutions are still running or failed. ,
Failed: All Solutions failed to run. ,
Running: All Solutions are still running. ,
Canceled: When Solutions request gets canceled. ,
}
,
Required: False ,
}
enum ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
sections:
{
Description: List of section object. ,
Required: False ,
}
[
{
title:
{
Description: Solution sections title. ,
Required: False ,
}
string ,
content:
{
Description: Solution sections content. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

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

⚶ Changes

{
  "#id": "Solution_Update",
  "Description": {
    "new": "Update the requiredInputs or additional information needed to execute the solution",
    "old": "Update the requiredInputs or additional information needed to execute the solution "
  },
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    },
    {
      "solutionPatchRequestBody": {
        "$properties": {
          "properties": [
            {
              "replacementMaps": [
                {
                  "diagnostics": {
                    "$properties": [
                      {
                        "#name": "status",
                        "Description": {
                          "new": "Denotes the status of the diagnostic resource.",
                          "old": "The status of the resource."
                        },
                        "Enum": {
                          "new": [
                            [
                              "Failed",
                              "Diagnostic creation failed."
                            ],
                            [
                              "MissingInputs",
                              "Request is missing required inputs to run."
                            ],
                            [
                              "Running",
                              "Diagnostic is still running."
                            ],
                            [
                              "Succeeded",
                              "Diagnostic creation succeeded."
                            ],
                            [
                              "Timeout",
                              "Diagnostic was timed out."
                            ]
                          ],
                          "old": [
                            [
                              "Failed",
                              ""
                            ],
                            [
                              "MissingInputs",
                              ""
                            ],
                            [
                              "Running",
                              ""
                            ],
                            [
                              "Succeeded",
                              ""
                            ],
                            [
                              "Timeout",
                              ""
                            ]
                          ]
                        }
                      }
                    ]
                  }
                }
              ]
            },
            {
              "sections": {
                "$properties": {
                  "replacementMaps": [
                    {
                      "diagnostics": {
                        "$properties": [
                          {
                            "#name": "status",
                            "Description": {
                              "new": "Denotes the status of the diagnostic resource.",
                              "old": "The status of the resource."
                            },
                            "Enum": {
                              "new": [
                                [
                                  "Failed",
                                  "Diagnostic creation failed."
                                ],
                                [
                                  "MissingInputs",
                                  "Request is missing required inputs to run."
                                ],
                                [
                                  "Running",
                                  "Diagnostic is still running."
                                ],
                                [
                                  "Succeeded",
                                  "Diagnostic creation succeeded."
                                ],
                                [
                                  "Timeout",
                                  "Diagnostic was timed out."
                                ]
                              ],
                              "old": [
                                [
                                  "Failed",
                                  ""
                                ],
                                [
                                  "MissingInputs",
                                  ""
                                ],
                                [
                                  "Running",
                                  ""
                                ],
                                [
                                  "Succeeded",
                                  ""
                                ],
                                [
                                  "Timeout",
                                  ""
                                ]
                              ]
                            }
                          }
                        ]
                      }
                    }
                  ]
                }
              }
            }
          ]
        }
      }
    }
  ],
  "$responses": [
    {
      "200": {
        "$properties": {
          "properties": [
            {
              "replacementMaps": [
                {
                  "diagnostics": {
                    "$properties": [
                      {
                        "#name": "status",
                        "Description": {
                          "new": "Denotes the status of the diagnostic resource.",
                          "old": "The status of the resource."
                        },
                        "Enum": {
                          "new": [
                            [
                              "Failed",
                              "Diagnostic creation failed."
                            ],
                            [
                              "MissingInputs",
                              "Request is missing required inputs to run."
                            ],
                            [
                              "Running",
                              "Diagnostic is still running."
                            ],
                            [
                              "Succeeded",
                              "Diagnostic creation succeeded."
                            ],
                            [
                              "Timeout",
                              "Diagnostic was timed out."
                            ]
                          ],
                          "old": [
                            [
                              "Failed",
                              ""
                            ],
                            [
                              "MissingInputs",
                              ""
                            ],
                            [
                              "Running",
                              ""
                            ],
                            [
                              "Succeeded",
                              ""
                            ],
                            [
                              "Timeout",
                              ""
                            ]
                          ]
                        }
                      }
                    ]
                  }
                }
              ]
            },
            {
              "sections": {
                "$properties": {
                  "replacementMaps": [
                    {
                      "diagnostics": {
                        "$properties": [
                          {
                            "#name": "status",
                            "Description": {
                              "new": "Denotes the status of the diagnostic resource.",
                              "old": "The status of the resource."
                            },
                            "Enum": {
                              "new": [
                                [
                                  "Failed",
                                  "Diagnostic creation failed."
                                ],
                                [
                                  "MissingInputs",
                                  "Request is missing required inputs to run."
                                ],
                                [
                                  "Running",
                                  "Diagnostic is still running."
                                ],
                                [
                                  "Succeeded",
                                  "Diagnostic creation succeeded."
                                ],
                                [
                                  "Timeout",
                                  "Diagnostic was timed out."
                                ]
                              ],
                              "old": [
                                [
                                  "Failed",
                                  ""
                                ],
                                [
                                  "MissingInputs",
                                  ""
                                ],
                                [
                                  "Running",
                                  ""
                                ],
                                [
                                  "Succeeded",
                                  ""
                                ],
                                [
                                  "Timeout",
                                  ""
                                ]
                              ]
                            }
                          }
                        ]
                      }
                    }
                  ]
                }
              }
            }
          ]
        }
      }
    },
    {
      "#status": "202",
      "$headers": {
        "@added_90b2da5f10c746d597cf9e2dcf861e37": {
          "#name": "azure-asyncoperation",
          "Description": "A link to the status monitor",
          "Type": "string"
        },
        "@removed_cbd07264e18e4cbca3d11cda1e59bcc4": {
          "#name": "location",
          "Type": "string"
        }
      },
      "$schema": {
        "$properties": {
          "properties": [
            {
              "replacementMaps": [
                {
                  "diagnostics": {
                    "$properties": [
                      {
                        "#name": "status",
                        "Description": {
                          "new": "Denotes the status of the diagnostic resource.",
                          "old": "The status of the resource."
                        },
                        "Enum": {
                          "new": [
                            [
                              "Failed",
                              "Diagnostic creation failed."
                            ],
                            [
                              "MissingInputs",
                              "Request is missing required inputs to run."
                            ],
                            [
                              "Running",
                              "Diagnostic is still running."
                            ],
                            [
                              "Succeeded",
                              "Diagnostic creation succeeded."
                            ],
                            [
                              "Timeout",
                              "Diagnostic was timed out."
                            ]
                          ],
                          "old": [
                            [
                              "Failed",
                              ""
                            ],
                            [
                              "MissingInputs",
                              ""
                            ],
                            [
                              "Running",
                              ""
                            ],
                            [
                              "Succeeded",
                              ""
                            ],
                            [
                              "Timeout",
                              ""
                            ]
                          ]
                        }
                      }
                    ]
                  }
                }
              ]
            },
            {
              "sections": {
                "$properties": {
                  "replacementMaps": [
                    {
                      "diagnostics": {
                        "$properties": [
                          {
                            "#name": "status",
                            "Description": {
                              "new": "Denotes the status of the diagnostic resource.",
                              "old": "The status of the resource."
                            },
                            "Enum": {
                              "new": [
                                [
                                  "Failed",
                                  "Diagnostic creation failed."
                                ],
                                [
                                  "MissingInputs",
                                  "Request is missing required inputs to run."
                                ],
                                [
                                  "Running",
                                  "Diagnostic is still running."
                                ],
                                [
                                  "Succeeded",
                                  "Diagnostic creation succeeded."
                                ],
                                [
                                  "Timeout",
                                  "Diagnostic was timed out."
                                ]
                              ],
                              "old": [
                                [
                                  "Failed",
                                  ""
                                ],
                                [
                                  "MissingInputs",
                                  ""
                                ],
                                [
                                  "Running",
                                  ""
                                ],
                                [
                                  "Succeeded",
                                  ""
                                ],
                                [
                                  "Timeout",
                                  ""
                                ]
                              ]
                            }
                          }
                        ]
                      }
                    }
                  ]
                }
              }
            }
          ]
        }
      }
    }
  ]
}

⚼ Request

PATCH:  /{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
solutionResourceName:
{
Description: Solution resource Name. ,
Required: True ,
}
string ,
solutionPatchRequestBody:
{
Description: The required request body for updating a solution resource. ,
Required: False ,
}
{
properties:
{
Description: Solution result ,
Required: False ,
}
{
triggerCriteria:
{
Description: Solution request trigger criteria ,
Required: False ,
}
[
{
name:
{
Description: Trigger criterion name. ,
Enum:
{
SolutionId: No description available. ,
ProblemClassificationId: No description available. ,
ReplacementKey: No description available. ,
}
,
Required: False ,
}
enum ,
value:
{
Description: Trigger criterion value. ,
Required: False ,
}
string ,
}
,
]
,
parameters:
{
Description: Client input parameters to run Solution ,
Required: False ,
}
object ,
solutionId:
{
Description: Solution Id to identify single solution. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of solution provisioning. ,
Enum:
{
Succeeded: All Solutions in the Batch succeeded. ,
PartialComplete: Some Solutions are still running or failed. ,
Failed: All Solutions failed to run. ,
Running: All Solutions are still running. ,
Canceled: When Solutions request gets canceled. ,
}
,
Required: False ,
}
enum ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
sections:
{
Description: List of section object. ,
Required: False ,
}
[
{
title:
{
Description: Solution sections title. ,
Required: False ,
}
string ,
content:
{
Description: Solution sections content. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Solution result ,
Required: False ,
}
{
triggerCriteria:
{
Description: Solution request trigger criteria ,
Required: False ,
}
[
{
name:
{
Description: Trigger criterion name. ,
Enum:
{
SolutionId: No description available. ,
ProblemClassificationId: No description available. ,
ReplacementKey: No description available. ,
}
,
Required: False ,
}
enum ,
value:
{
Description: Trigger criterion value. ,
Required: False ,
}
string ,
}
,
]
,
parameters:
{
Description: Client input parameters to run Solution ,
Required: False ,
}
object ,
solutionId:
{
Description: Solution Id to identify single solution. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of solution provisioning. ,
Enum:
{
Succeeded: All Solutions in the Batch succeeded. ,
PartialComplete: Some Solutions are still running or failed. ,
Failed: All Solutions failed to run. ,
Running: All Solutions are still running. ,
Canceled: When Solutions request gets canceled. ,
}
,
Required: False ,
}
enum ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
sections:
{
Description: List of section object. ,
Required: False ,
}
[
{
title:
{
Description: Solution sections title. ,
Required: False ,
}
string ,
content:
{
Description: Solution sections content. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (202)

{
$headers:
{
azure-asyncoperation:
{
Description: A link to the status monitor ,
}
string ,
}
,
$schema:
{
Description: Solution response. ,
}
{
properties:
{
Description: Solution result ,
Required: False ,
}
{
triggerCriteria:
{
Description: Solution request trigger criteria ,
Required: False ,
}
[
{
name:
{
Description: Trigger criterion name. ,
Enum:
{
SolutionId: No description available. ,
ProblemClassificationId: No description available. ,
ReplacementKey: No description available. ,
}
,
Required: False ,
}
enum ,
value:
{
Description: Trigger criterion value. ,
Required: False ,
}
string ,
}
,
]
,
parameters:
{
Description: Client input parameters to run Solution ,
Required: False ,
}
object ,
solutionId:
{
Description: Solution Id to identify single solution. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Status of solution provisioning. ,
Enum:
{
Succeeded: All Solutions in the Batch succeeded. ,
PartialComplete: Some Solutions are still running or failed. ,
Failed: All Solutions failed to run. ,
Running: All Solutions are still running. ,
Canceled: When Solutions request gets canceled. ,
}
,
Required: False ,
}
enum ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
sections:
{
Description: List of section object. ,
Required: False ,
}
[
{
title:
{
Description: Solution sections title. ,
Required: False ,
}
string ,
content:
{
Description: Solution sections content. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
diagnostics:
{
Description: Solution diagnostics results. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Diagnostic ,
Required: False ,
}
string ,
status:
{
Description: Denotes the status of the diagnostic resource. ,
Enum:
{
Failed: Diagnostic creation failed. ,
MissingInputs: Request is missing required inputs to run. ,
Running: Diagnostic is still running. ,
Succeeded: Diagnostic creation succeeded. ,
Timeout: Diagnostic was timed out. ,
}
,
Required: False ,
}
enum ,
statusDetails:
{
Description: Details of the status ,
Required: False ,
}
string ,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
estimatedCompletionTime:
{
Description: Diagnostics estimated completion time in minutes ,
Required: False ,
}
string ,
requiredParameters:
{
Description: Required parameters of this item ,
Required: False ,
}
[
string ,
]
,
insights:
{
Description: Diagnostic insights ,
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
troubleshooters:
{
Description: Solutions Troubleshooters ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id to identify single Solutions Troubleshooter ,
Required: False ,
}
string ,
title:
{
Description: Troubleshooter title ,
Required: False ,
}
string ,
summary:
{
Description: Troubleshooter summary ,
Required: False ,
}
string ,
}
,
]
,
metricsBasedCharts:
{
Description: Solution metrics based charts ,
Required: False ,
}
[
{
name:
{
Description: Chart name ,
Required: False ,
}
string ,
aggregationType:
{
Description: Allowed values are Sum, Avg, Count, Min, Max. Default is Sum ,
Enum:
{
Sum: No description available. ,
Avg: No description available. ,
Count: No description available. ,
Min: No description available. ,
Max: No description available. ,
}
,
Required: False ,
}
enum ,
timeSpanDuration:
{
Description: Time span duration ,
Required: False ,
}
string ,
title:
{
Description: Chart title ,
Required: False ,
}
string ,
filterGroup:
{
Description: Filter group ,
Required: False ,
}
{
filter:
{
Description: List of filters ,
Required: False ,
}
[
{
name:
{
Description: Filter name ,
Required: False ,
}
string ,
values:
{
Description: Filter values ,
Required: False ,
}
string ,
operator:
{
Description: Filter operator ,
Required: False ,
}
string ,
}
,
]
,
}
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Solution_WarmUp (updated)
Description :  Warm up the solution resource by preloading asynchronous diagnostics results into cache
Reference :  Link ¶

⚶ Changes

{
  "#id": "Solution_WarmUp",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    }
  ]
}

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/solutions/{solutionResourceName}/warmup
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
solutionResourceName:
{
Description: Solution resource Name. ,
Required: True ,
}
string ,
solutionWarmUpRequestBody:
{
Description: The required request body for warming up a solution resource. ,
Required: False ,
}
{
parameters:
{
Description: Dictionary of ,
Required: False ,
}
object ,
}
,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Troubleshooters_Get (updated)
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 ¶

⚶ Changes

{
  "#id": "Troubleshooters_Get",
  "$parameters": [
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    }
  ]
}

⚼ Request

GET:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
troubleshooterName:
{
Description: Troubleshooter resource Name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Troubleshooter Instance properties. ,
Required: False ,
}
{
solutionId:
{
Description: Solution Id to identify single troubleshooter. ,
Required: False ,
}
string ,
parameters:
{
Description: Client input parameters to run Troubleshooter Resource ,
Required: False ,
}
object ,
provisioningState:
{
Description: Status of troubleshooter provisioning. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Running: No description available. ,
AutoContinue: No description available. ,
}
,
Required: False ,
}
enum ,
steps:
{
Description: List of step object. ,
Required: False ,
}
[
{
id:
{
Description: Unique step id. ,
Required: False ,
}
string ,
title:
{
Description: Step title. ,
Required: False ,
}
string ,
description:
{
Description: Step description. ,
Required: False ,
}
string ,
guidance:
{
Description: Get or sets the Step guidance. ,
Required: False ,
}
string ,
executionStatus:
{
Description: Status of Troubleshooter Step execution. ,
Enum:
{
Success: Step execution succeeded. ,
Running: Step execution running ,
Failed: Step execution failed ,
Warning: Step execution warning ,
}
,
Required: False ,
}
enum ,
executionStatusDescription:
{
Description: This field has more detailed status description of the execution status. ,
Required: False ,
}
string ,
type:
{
Description: Type of Troubleshooting step. ,
Enum:
{
Decision: No description available. ,
Solution: No description available. ,
Insight: No description available. ,
AutomatedCheck: No description available. ,
Input: No description available. ,
}
,
Required: False ,
}
enum ,
isLastStep:
{
Description: is this last step of the workflow. ,
Required: False ,
}
boolean ,
inputs:
{
Required: False ,
}
[
{
questionId:
{
Description: Use Index as QuestionId. ,
Required: False ,
}
string ,
questionType:
{
Description: Type of Question ,
Enum:
{
RadioButton: SingleChoice radio button ,
Dropdown: SingleChoice dropdown. ,
TextInput: Text Input ,
MultiLineInfoBox: MultiLineInfoBox ,
DateTimePicker: DateTime Picker ,
MultiSelect: Multi Select ,
}
,
Required: False ,
}
enum ,
questionTitle:
{
Description: Question title ,
Required: False ,
}
string ,
questionContent:
{
Description: User question content. ,
Required: False ,
}
string ,
questionContentType:
{
Description: Default is Text. ,
Enum:
{
Text: No description available. ,
Html: No description available. ,
Markdown: No description available. ,
}
,
Required: False ,
}
enum ,
responseHint:
{
Description: Place holder text for response hints. ,
Required: False ,
}
string ,
recommendedOption:
{
Description: Result of Automate step. ,
Required: False ,
}
string ,
selectedOptionValue:
{
Description: Text of response that was selected. ,
Required: False ,
}
string ,
responseValidationProperties:
{
Description: Troubleshooter step input response validation properties ,
Required: False ,
}
{
regex:
{
Description: Regex used for the input validation. ,
Required: False ,
}
string ,
validationScope:
{
Description: Validation scope ,
Enum:
{
None: No description available. ,
URLFormat: No description available. ,
GuidFormat: No description available. ,
IpAddressFormat: No description available. ,
NumberOnlyFormat: No description available. ,
}
,
Required: False ,
}
enum ,
isRequired:
{
Description: Default True ,
Required: False ,
}
boolean ,
validationErrorMessage:
{
Description: Validation Error Message. ,
Required: False ,
}
string ,
maxLength:
{
Description: Max text input (open Ended Text). ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
responseOptions:
{
Required: False ,
}
[
{
key:
{
Description: Unique string. ,
Required: False ,
}
string ,
value:
{
Description: Option description ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
Description: Only for AutomatedStep type ,
Required: False ,
}
{
version:
{
Description: Version for automated check result ,
Required: False ,
}
string ,
status:
{
Description: Status for automated check result ,
Required: False ,
}
string ,
result:
{
Description: Insight Article Content ,
Required: False ,
}
string ,
type:
{
Description: Type of Result. ,
Enum:
{
Success: No description available. ,
Warning: No description available. ,
Error: No description available. ,
Information: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
insights:
{
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Troubleshooters_Create (updated)
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 ¶

⚶ Changes

{
  "#id": "Troubleshooters_Create",
  "$parameters": [
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    }
  ]
}

⚼ Request

PUT:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
troubleshooterName:
{
Description: Troubleshooter resource Name. ,
Required: True ,
}
string ,
createTroubleshooterRequestBody:
{
Description: The required request body for this Troubleshooter resource creation. ,
Required: False ,
}
{
properties:
{
Description: Troubleshooter Instance properties. ,
Required: False ,
}
{
solutionId:
{
Description: Solution Id to identify single troubleshooter. ,
Required: False ,
}
string ,
parameters:
{
Description: Client input parameters to run Troubleshooter Resource ,
Required: False ,
}
object ,
provisioningState:
{
Description: Status of troubleshooter provisioning. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Running: No description available. ,
AutoContinue: No description available. ,
}
,
Required: False ,
}
enum ,
steps:
{
Description: List of step object. ,
Required: False ,
}
[
{
id:
{
Description: Unique step id. ,
Required: False ,
}
string ,
title:
{
Description: Step title. ,
Required: False ,
}
string ,
description:
{
Description: Step description. ,
Required: False ,
}
string ,
guidance:
{
Description: Get or sets the Step guidance. ,
Required: False ,
}
string ,
executionStatus:
{
Description: Status of Troubleshooter Step execution. ,
Enum:
{
Success: Step execution succeeded. ,
Running: Step execution running ,
Failed: Step execution failed ,
Warning: Step execution warning ,
}
,
Required: False ,
}
enum ,
executionStatusDescription:
{
Description: This field has more detailed status description of the execution status. ,
Required: False ,
}
string ,
type:
{
Description: Type of Troubleshooting step. ,
Enum:
{
Decision: No description available. ,
Solution: No description available. ,
Insight: No description available. ,
AutomatedCheck: No description available. ,
Input: No description available. ,
}
,
Required: False ,
}
enum ,
isLastStep:
{
Description: is this last step of the workflow. ,
Required: False ,
}
boolean ,
inputs:
{
Required: False ,
}
[
{
questionId:
{
Description: Use Index as QuestionId. ,
Required: False ,
}
string ,
questionType:
{
Description: Type of Question ,
Enum:
{
RadioButton: SingleChoice radio button ,
Dropdown: SingleChoice dropdown. ,
TextInput: Text Input ,
MultiLineInfoBox: MultiLineInfoBox ,
DateTimePicker: DateTime Picker ,
MultiSelect: Multi Select ,
}
,
Required: False ,
}
enum ,
questionTitle:
{
Description: Question title ,
Required: False ,
}
string ,
questionContent:
{
Description: User question content. ,
Required: False ,
}
string ,
questionContentType:
{
Description: Default is Text. ,
Enum:
{
Text: No description available. ,
Html: No description available. ,
Markdown: No description available. ,
}
,
Required: False ,
}
enum ,
responseHint:
{
Description: Place holder text for response hints. ,
Required: False ,
}
string ,
recommendedOption:
{
Description: Result of Automate step. ,
Required: False ,
}
string ,
selectedOptionValue:
{
Description: Text of response that was selected. ,
Required: False ,
}
string ,
responseValidationProperties:
{
Description: Troubleshooter step input response validation properties ,
Required: False ,
}
{
regex:
{
Description: Regex used for the input validation. ,
Required: False ,
}
string ,
validationScope:
{
Description: Validation scope ,
Enum:
{
None: No description available. ,
URLFormat: No description available. ,
GuidFormat: No description available. ,
IpAddressFormat: No description available. ,
NumberOnlyFormat: No description available. ,
}
,
Required: False ,
}
enum ,
isRequired:
{
Description: Default True ,
Required: False ,
}
boolean ,
validationErrorMessage:
{
Description: Validation Error Message. ,
Required: False ,
}
string ,
maxLength:
{
Description: Max text input (open Ended Text). ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
responseOptions:
{
Required: False ,
}
[
{
key:
{
Description: Unique string. ,
Required: False ,
}
string ,
value:
{
Description: Option description ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
Description: Only for AutomatedStep type ,
Required: False ,
}
{
version:
{
Description: Version for automated check result ,
Required: False ,
}
string ,
status:
{
Description: Status for automated check result ,
Required: False ,
}
string ,
result:
{
Description: Insight Article Content ,
Required: False ,
}
string ,
type:
{
Description: Type of Result. ,
Enum:
{
Success: No description available. ,
Warning: No description available. ,
Error: No description available. ,
Information: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
insights:
{
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Troubleshooter Instance properties. ,
Required: False ,
}
{
solutionId:
{
Description: Solution Id to identify single troubleshooter. ,
Required: False ,
}
string ,
parameters:
{
Description: Client input parameters to run Troubleshooter Resource ,
Required: False ,
}
object ,
provisioningState:
{
Description: Status of troubleshooter provisioning. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Running: No description available. ,
AutoContinue: No description available. ,
}
,
Required: False ,
}
enum ,
steps:
{
Description: List of step object. ,
Required: False ,
}
[
{
id:
{
Description: Unique step id. ,
Required: False ,
}
string ,
title:
{
Description: Step title. ,
Required: False ,
}
string ,
description:
{
Description: Step description. ,
Required: False ,
}
string ,
guidance:
{
Description: Get or sets the Step guidance. ,
Required: False ,
}
string ,
executionStatus:
{
Description: Status of Troubleshooter Step execution. ,
Enum:
{
Success: Step execution succeeded. ,
Running: Step execution running ,
Failed: Step execution failed ,
Warning: Step execution warning ,
}
,
Required: False ,
}
enum ,
executionStatusDescription:
{
Description: This field has more detailed status description of the execution status. ,
Required: False ,
}
string ,
type:
{
Description: Type of Troubleshooting step. ,
Enum:
{
Decision: No description available. ,
Solution: No description available. ,
Insight: No description available. ,
AutomatedCheck: No description available. ,
Input: No description available. ,
}
,
Required: False ,
}
enum ,
isLastStep:
{
Description: is this last step of the workflow. ,
Required: False ,
}
boolean ,
inputs:
{
Required: False ,
}
[
{
questionId:
{
Description: Use Index as QuestionId. ,
Required: False ,
}
string ,
questionType:
{
Description: Type of Question ,
Enum:
{
RadioButton: SingleChoice radio button ,
Dropdown: SingleChoice dropdown. ,
TextInput: Text Input ,
MultiLineInfoBox: MultiLineInfoBox ,
DateTimePicker: DateTime Picker ,
MultiSelect: Multi Select ,
}
,
Required: False ,
}
enum ,
questionTitle:
{
Description: Question title ,
Required: False ,
}
string ,
questionContent:
{
Description: User question content. ,
Required: False ,
}
string ,
questionContentType:
{
Description: Default is Text. ,
Enum:
{
Text: No description available. ,
Html: No description available. ,
Markdown: No description available. ,
}
,
Required: False ,
}
enum ,
responseHint:
{
Description: Place holder text for response hints. ,
Required: False ,
}
string ,
recommendedOption:
{
Description: Result of Automate step. ,
Required: False ,
}
string ,
selectedOptionValue:
{
Description: Text of response that was selected. ,
Required: False ,
}
string ,
responseValidationProperties:
{
Description: Troubleshooter step input response validation properties ,
Required: False ,
}
{
regex:
{
Description: Regex used for the input validation. ,
Required: False ,
}
string ,
validationScope:
{
Description: Validation scope ,
Enum:
{
None: No description available. ,
URLFormat: No description available. ,
GuidFormat: No description available. ,
IpAddressFormat: No description available. ,
NumberOnlyFormat: No description available. ,
}
,
Required: False ,
}
enum ,
isRequired:
{
Description: Default True ,
Required: False ,
}
boolean ,
validationErrorMessage:
{
Description: Validation Error Message. ,
Required: False ,
}
string ,
maxLength:
{
Description: Max text input (open Ended Text). ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
responseOptions:
{
Required: False ,
}
[
{
key:
{
Description: Unique string. ,
Required: False ,
}
string ,
value:
{
Description: Option description ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
Description: Only for AutomatedStep type ,
Required: False ,
}
{
version:
{
Description: Version for automated check result ,
Required: False ,
}
string ,
status:
{
Description: Status for automated check result ,
Required: False ,
}
string ,
result:
{
Description: Insight Article Content ,
Required: False ,
}
string ,
type:
{
Description: Type of Result. ,
Enum:
{
Success: No description available. ,
Warning: No description available. ,
Error: No description available. ,
Information: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
insights:
{
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Troubleshooter Instance properties. ,
Required: False ,
}
{
solutionId:
{
Description: Solution Id to identify single troubleshooter. ,
Required: False ,
}
string ,
parameters:
{
Description: Client input parameters to run Troubleshooter Resource ,
Required: False ,
}
object ,
provisioningState:
{
Description: Status of troubleshooter provisioning. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
Running: No description available. ,
AutoContinue: No description available. ,
}
,
Required: False ,
}
enum ,
steps:
{
Description: List of step object. ,
Required: False ,
}
[
{
id:
{
Description: Unique step id. ,
Required: False ,
}
string ,
title:
{
Description: Step title. ,
Required: False ,
}
string ,
description:
{
Description: Step description. ,
Required: False ,
}
string ,
guidance:
{
Description: Get or sets the Step guidance. ,
Required: False ,
}
string ,
executionStatus:
{
Description: Status of Troubleshooter Step execution. ,
Enum:
{
Success: Step execution succeeded. ,
Running: Step execution running ,
Failed: Step execution failed ,
Warning: Step execution warning ,
}
,
Required: False ,
}
enum ,
executionStatusDescription:
{
Description: This field has more detailed status description of the execution status. ,
Required: False ,
}
string ,
type:
{
Description: Type of Troubleshooting step. ,
Enum:
{
Decision: No description available. ,
Solution: No description available. ,
Insight: No description available. ,
AutomatedCheck: No description available. ,
Input: No description available. ,
}
,
Required: False ,
}
enum ,
isLastStep:
{
Description: is this last step of the workflow. ,
Required: False ,
}
boolean ,
inputs:
{
Required: False ,
}
[
{
questionId:
{
Description: Use Index as QuestionId. ,
Required: False ,
}
string ,
questionType:
{
Description: Type of Question ,
Enum:
{
RadioButton: SingleChoice radio button ,
Dropdown: SingleChoice dropdown. ,
TextInput: Text Input ,
MultiLineInfoBox: MultiLineInfoBox ,
DateTimePicker: DateTime Picker ,
MultiSelect: Multi Select ,
}
,
Required: False ,
}
enum ,
questionTitle:
{
Description: Question title ,
Required: False ,
}
string ,
questionContent:
{
Description: User question content. ,
Required: False ,
}
string ,
questionContentType:
{
Description: Default is Text. ,
Enum:
{
Text: No description available. ,
Html: No description available. ,
Markdown: No description available. ,
}
,
Required: False ,
}
enum ,
responseHint:
{
Description: Place holder text for response hints. ,
Required: False ,
}
string ,
recommendedOption:
{
Description: Result of Automate step. ,
Required: False ,
}
string ,
selectedOptionValue:
{
Description: Text of response that was selected. ,
Required: False ,
}
string ,
responseValidationProperties:
{
Description: Troubleshooter step input response validation properties ,
Required: False ,
}
{
regex:
{
Description: Regex used for the input validation. ,
Required: False ,
}
string ,
validationScope:
{
Description: Validation scope ,
Enum:
{
None: No description available. ,
URLFormat: No description available. ,
GuidFormat: No description available. ,
IpAddressFormat: No description available. ,
NumberOnlyFormat: No description available. ,
}
,
Required: False ,
}
enum ,
isRequired:
{
Description: Default True ,
Required: False ,
}
boolean ,
validationErrorMessage:
{
Description: Validation Error Message. ,
Required: False ,
}
string ,
maxLength:
{
Description: Max text input (open Ended Text). ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
responseOptions:
{
Required: False ,
}
[
{
key:
{
Description: Unique string. ,
Required: False ,
}
string ,
value:
{
Description: Option description ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
automatedCheckResults:
{
Description: Only for AutomatedStep type ,
Required: False ,
}
{
version:
{
Description: Version for automated check result ,
Required: False ,
}
string ,
status:
{
Description: Status for automated check result ,
Required: False ,
}
string ,
result:
{
Description: Insight Article Content ,
Required: False ,
}
string ,
type:
{
Description: Type of Result. ,
Enum:
{
Success: No description available. ,
Warning: No description available. ,
Error: No description available. ,
Information: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
insights:
{
Required: False ,
}
[
{
id:
{
Description: Article id. ,
Required: False ,
}
string ,
title:
{
Description: This insight's title. ,
Required: False ,
}
string ,
results:
{
Description: Detailed result content. ,
Required: False ,
}
string ,
importanceLevel:
{
Description: Importance level of the insight. ,
Enum:
{
Critical: A critical insight has been found after running the diagnostic. ,
Warning: A warning insight has been found after running the diagnostic. ,
Information: An information insight has been found after running the diagnostic. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Troubleshooters_Continue (updated)
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 ¶

⚶ Changes

{
  "#id": "Troubleshooters_Continue",
  "$parameters": [
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    }
  ]
}

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}/continue
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
troubleshooterName:
{
Description: Troubleshooter resource Name. ,
Required: True ,
}
string ,
continueRequestBody:
{
Description: The required request body for going to next step in Troubleshooter resource. ,
Required: False ,
}
{
stepId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
responses:
{
Required: False ,
}
[
{
questionId:
{
Description: id of the question. ,
Required: False ,
}
string ,
questionType:
{
Description: Type of Question ,
Enum:
{
RadioButton: SingleChoice radio button ,
Dropdown: SingleChoice dropdown. ,
TextInput: Text Input ,
MultiLineInfoBox: MultiLineInfoBox ,
DateTimePicker: DateTime Picker ,
MultiSelect: Multi Select ,
}
,
Required: False ,
}
enum ,
response:
{
Description: Response key for SingleInput. For Multi-line test/open ended question it is free form text ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (204)

{
location: string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Troubleshooters_End (updated)
Description :  Ends the troubleshooter action
Reference :  Link ¶

⚶ Changes

{
  "#id": "Troubleshooters_End",
  "$parameters": [
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    }
  ]
}

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}/end
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
troubleshooterName:
{
Description: Troubleshooter resource Name. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{
location: string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Troubleshooters_Restart (updated)
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 ¶

⚶ Changes

{
  "#id": "Troubleshooters_Restart",
  "$parameters": [
    {
      "#name": "scope",
      "Description": {
        "new": "The fully qualified Azure Resource manager identifier of the resource.",
        "old": "scope = resourceUri of affected resource.
 For example: /subscriptions/0d0fcd2e-c4fd-4349-8497-200edb3923c6/resourcegroups/myresourceGroup/providers/Microsoft.KeyVault/vaults/test-keyvault-non-read "
      }
    }
  ]
}

⚼ Request

POST:  /{scope}/providers/Microsoft.Help/troubleshooters/{troubleshooterName}/restart
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
scope:
{
Description: The fully qualified Azure Resource manager identifier of the resource. ,
Required: True ,
}
string ,
troubleshooterName:
{
Description: Troubleshooter resource Name. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Troubleshooter restart response ,
}
{
troubleshooterResourceName:
{
Description: Updated TroubleshooterResource Name . ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
DiscoverySolutionNLP_DiscoverSolutions (updated)
Description :  Search for relevant Azure Diagnostics, Solutions and Troubleshooters using a natural language issue summary.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DiscoverySolutionNLP_DiscoverSolutions",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "discoverSolutionRequest",
      "Description": {
        "new": "The request body",
        "old": "Request body for discovering solutions using NLP."
      }
    }
  ]
}

⚼ Request

POST:  /providers/Microsoft.Help/discoverSolutions
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
discoverSolutionRequest:
{
Description: The request body ,
Required: False ,
}
{
issueSummary:
{
Description: Natural language description of the issue. ,
Required: True ,
}
string ,
resourceId:
{
Description: ARM resource Id of the resource that is having the issue. Only applicable for Discovery Solution NLP Subscription Scope. ,
Required: False ,
}
string ,
serviceId:
{
Description: ARM service Id of the service that is having the issue. For more information on service Id see https://learn.microsoft.com/rest/api/support/services/list?tabs=HTTP. ,
Required: False ,
}
string ,
additionalContext:
{
Description: Additional information in the form of a string. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
value:
{
Description: The list of solution metadata. ,
Required: False ,
}
[
{
properties:
{
Description: Solution metadata Resource properties. ,
Required: False ,
}
{
problemTitle:
{
Description: Title of the problem classification. ,
Required: False ,
}
string ,
problemDescription:
{
Description: Description of the problem classification. ,
Required: False ,
}
string ,
serviceId:
{
Description: Id of the service (https://learn.microsoft.com/en-us/rest/api/support/services?view=rest-support-2020-04-01) that may be used to create a support ticket. ,
Required: False ,
}
string ,
problemClassificationId:
{
Description: Id of the ProblemClassification (https://learn.microsoft.com/en-us/rest/api/support/problem-classifications?view=rest-support-2020-04-01) that may be used to create a support ticket. ,
Required: False ,
}
string ,
solutions:
{
Description: The list of solution metadata. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id. ,
Required: False ,
}
string ,
solutionType:
{
Description: Solution Type. ,
Enum:
{
Diagnostics: Diagnostics resource type. ,
Solutions: Solutions resource type. ,
Troubleshooters: Troubleshooters resource type. ,
SelfHelp: SelfHelp resource type. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: A detailed description of solution. ,
Required: False ,
}
string ,
requiredInputs:
{
Description: Required parameters for invoking this particular solution. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
relatedServices:
{
Description: The set of services that are most likely related to the request. If relatedServices is included in the response then solutions may not be discovered until the client calls a second time specifying one of the service Ids in the relatedServices object. ,
Required: False ,
}
[
{
serviceId:
{
Description: Azure resource Id of the service. ,
Format: arm-id ,
Required: False ,
}
string ,
displayName:
{
Description: Localized name of the azure service. ,
Required: False ,
}
string ,
resourceTypes:
{
Description: List of applicable ARM resource types for this service. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
DiscoverySolution_List (updated)
Description :  Lists the relevant Azure Diagnostics, Solutions and Troubleshooters 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 ¶

⚶ Changes

{
  "#id": "DiscoverySolution_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The SolutionMetadataResource items on this page",
            "old": "The list of metadata."
          },
          "Required": {
            "new": true,
            "old": false
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "The link used to get the next page of solution metadata."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /providers/Microsoft.Help/discoverySolutions
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
$filter:
{
Description: 'ProblemClassificationId' is a mandatory filter to get solutions ids. It also supports optional 'ResourceType' and 'SolutionType' filters. The [$filter](https://learn.microsoft.com/en-us/odata/webapi/first-odata-api#filter) supports only 'and', 'or' and 'eq' operators. Example: $filter=ProblemClassificationId eq '1ddda5b4-cf6c-4d4f-91ad-bc38ab0e811e' ,
Required: False ,
}
string ,
$skiptoken:
{
Description: Skiptoken is only used if a previous operation returned a partial result. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The SolutionMetadataResource items on this page ,
Required: True ,
}
[
{
properties:
{
Description: Solution metadata Resource properties. ,
Required: False ,
}
{
solutions:
{
Description: List of metadata. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id. ,
Required: False ,
}
string ,
solutionType:
{
Description: Solution Type. ,
Enum:
{
Diagnostics: Diagnostics resource type. ,
Solutions: Solutions resource type. ,
Troubleshooters: Troubleshooters resource type. ,
SelfHelp: SelfHelp resource type. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: A detailed description of solution. ,
Required: False ,
}
string ,
requiredInputs:
{
Description: Required parameters for invoking this particular solution. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Operations_List (updated)
Description :  List the operations for the provider
Reference :  Link ¶

⚶ Changes

{
  "#id": "Operations_List",
  "Description": {
    "new": "List the operations for the provider",
    "old": "Returns list of operations."
  },
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    }
  ]
}

⚼ Request

GET:  /providers/Microsoft.Help/operations
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of operations supported by the resource provider ,
Required: False ,
}
[
{
name:
{
Description: The name of the operation, as per Resource-Based Access Control (RBAC). Examples: "Microsoft.Compute/virtualMachines/write", "Microsoft.Compute/virtualMachines/capture/action" ,
Required: False ,
}
string ,
isDataAction:
{
Description: Whether the operation applies to data-plane. This is "true" for data-plane operations and "false" for ARM/control-plane operations. ,
Required: False ,
}
boolean ,
display:
{
Description: Localized display information for this particular operation. ,
Required: False ,
}
{
provider:
{
Description: The localized friendly form of the resource provider name, e.g. "Microsoft Monitoring Insights" or "Microsoft Compute". ,
Required: False ,
}
string ,
resource:
{
Description: The localized friendly name of the resource type related to this operation. E.g. "Virtual Machines" or "Job Schedule Collections". ,
Required: False ,
}
string ,
operation:
{
Description: The concise, localized friendly name for the operation; suitable for dropdowns. E.g. "Create or Update Virtual Machine", "Restart Virtual Machine". ,
Required: False ,
}
string ,
description:
{
Description: The short, localized friendly description of the operation; suitable for tool tips and detailed views. ,
Required: False ,
}
string ,
}
,
origin:
{
Description: The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default value is "user,system" ,
Enum:
{
user: No description available. ,
system: No description available. ,
user,system: No description available. ,
}
,
Required: False ,
}
enum ,
actionType:
{
Description: Enum. Indicates the action type. "Internal" refers to actions that are for internal only APIs. ,
Enum:
{
Internal: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of operation list results (if there are any). ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
SolutionSelfHelp_Get (updated)
Description :  Gets Self Help Solutions for a given solutionId. Self Help Solutions consist of rich instructional video tutorials, links and guides to public documentation related to a specific problem that enables users to troubleshoot Azure issues.
Reference :  Link ¶

⚶ Changes

{
  "#id": "SolutionSelfHelp_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    }
  ]
}

⚼ Request

GET:  /providers/Microsoft.Help/selfHelp/{solutionId}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
solutionId:
{
Description: SolutionId is a unique id to identify a solution. You can retrieve the solution id using the Discovery api - https://learn.microsoft.com/en-us/rest/api/help/discovery-solution/list?view=rest-help-2023-09-01-preview&tabs=HTTP ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Solution result ,
Required: False ,
}
{
solutionId:
{
Description: SolutionId is a unique id to identify a solution. You can retrieve the solution id using the Discovery api - https://learn.microsoft.com/en-us/rest/api/help/discovery-solution/list?view=rest-help-2023-09-01-preview&tabs=HTTP ,
Required: False ,
}
string ,
title:
{
Description: The title. ,
Required: False ,
}
string ,
content:
{
Description: The HTML content that needs to be rendered and shown to customer. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
sections:
{
Description: List of section object. ,
Required: False ,
}
[
{
title:
{
Description: Solution sections title. ,
Required: False ,
}
string ,
content:
{
Description: Solution sections content. ,
Required: False ,
}
string ,
replacementMaps:
{
Description: Solution replacement maps. ,
Required: False ,
}
{
webResults:
{
Description: Solution AzureKB results ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the content ,
Required: False ,
}
string ,
searchResults:
{
Description: AzureKB search results ,
Required: False ,
}
[
{
solutionId:
{
Description: Unique id of the result. ,
Required: False ,
}
string ,
content:
{
Description: Content of the search result. ,
Required: False ,
}
string ,
title:
{
Description: Title of the search result. ,
Required: False ,
}
string ,
confidence:
{
Description: Confidence of the search result. ,
Enum:
{
Low: No description available. ,
Medium: No description available. ,
High: No description available. ,
}
,
Required: False ,
}
enum ,
source:
{
Description: Source of the search result. ,
Required: False ,
}
string ,
resultType:
{
Description: Result type of the search result. ,
Enum:
{
Community: No description available. ,
Documentation: No description available. ,
}
,
Required: False ,
}
enum ,
rank:
{
Description: rank of the search result ,
Format: int32 ,
Required: False ,
}
integer ,
link:
{
Description: Link to the document. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
videos:
{
Description: Video solutions, which have the power to engage the customer by stimulating their senses ,
Required: False ,
}
[
{
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
videoGroups:
{
Description: Group of Videos ,
Required: False ,
}
[
{
videos:
{
Description: List of videos will be shown to customers ,
Required: False ,
}
[
{
src:
{
Description: Link to the video ,
Required: False ,
}
string ,
title:
{
Description: Title of the video ,
Required: False ,
}
string ,
}
,
]
,
replacementKey:
{
Description: Place holder used in HTML Content replace control with the insight content ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
DiscoverySolutionNLP_DiscoverSolutionsBySubscription (updated)
Description :  Search for relevant Azure Diagnostics, Solutions and Troubleshooters using a natural language issue summary and subscription.
Reference :  Link ¶

⚶ Changes

{
  "#id": "DiscoverySolutionNLP_DiscoverSolutionsBySubscription",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "The Azure subscription ID."
      }
    },
    {
      "#name": "discoverSolutionRequest",
      "Description": {
        "new": "The request body",
        "old": "Request body for discovering solutions using NLP."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.Help/discoverSolutions
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
discoverSolutionRequest:
{
Description: The request body ,
Required: False ,
}
{
issueSummary:
{
Description: Natural language description of the issue. ,
Required: True ,
}
string ,
resourceId:
{
Description: ARM resource Id of the resource that is having the issue. Only applicable for Discovery Solution NLP Subscription Scope. ,
Required: False ,
}
string ,
serviceId:
{
Description: ARM service Id of the service that is having the issue. For more information on service Id see https://learn.microsoft.com/rest/api/support/services/list?tabs=HTTP. ,
Required: False ,
}
string ,
additionalContext:
{
Description: Additional information in the form of a string. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
value:
{
Description: The list of solution metadata. ,
Required: False ,
}
[
{
properties:
{
Description: Solution metadata Resource properties. ,
Required: False ,
}
{
problemTitle:
{
Description: Title of the problem classification. ,
Required: False ,
}
string ,
problemDescription:
{
Description: Description of the problem classification. ,
Required: False ,
}
string ,
serviceId:
{
Description: Id of the service (https://learn.microsoft.com/en-us/rest/api/support/services?view=rest-support-2020-04-01) that may be used to create a support ticket. ,
Required: False ,
}
string ,
problemClassificationId:
{
Description: Id of the ProblemClassification (https://learn.microsoft.com/en-us/rest/api/support/problem-classifications?view=rest-support-2020-04-01) that may be used to create a support ticket. ,
Required: False ,
}
string ,
solutions:
{
Description: The list of solution metadata. ,
Required: False ,
}
[
{
solutionId:
{
Description: Solution Id. ,
Required: False ,
}
string ,
solutionType:
{
Description: Solution Type. ,
Enum:
{
Diagnostics: Diagnostics resource type. ,
Solutions: Solutions resource type. ,
Troubleshooters: Troubleshooters resource type. ,
SelfHelp: SelfHelp resource type. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: A detailed description of solution. ,
Required: False ,
}
string ,
requiredInputs:
{
Description: Required parameters for invoking this particular solution. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
relatedServices:
{
Description: The set of services that are most likely related to the request. If relatedServices is included in the response then solutions may not be discovered until the client calls a second time specifying one of the service Ids in the relatedServices object. ,
Required: False ,
}
[
{
serviceId:
{
Description: Azure resource Id of the service. ,
Format: arm-id ,
Required: False ,
}
string ,
displayName:
{
Description: Localized name of the azure service. ,
Required: False ,
}
string ,
resourceTypes:
{
Description: List of applicable ARM resource types for this service. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}