Microsoft.Support (stable:2020-04-01)

2025/04/24 • 4 updated methods

SupportTickets_List (updated)
Description :  Lists all the support tickets for an Azure subscription. You can also filter the support tickets by _Status_, _CreatedDate_, _ServiceId_, and _ProblemClassificationId_ using the $filter parameter. Output will be a paged result with _nextLink_, using which you can retrieve the next set of support tickets.

Support ticket data is available for 18 months after ticket creation. If a ticket was created more than 18 months ago, a request for data might cause an error.
Reference :  Link ¶

⚶ Changes

{
  "#id": "SupportTickets_List",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "contactDetails": [
                  {
                    "#name": "phoneNumber",
                    "Description": {
                      "new": "Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases.",
                      "old": "Phone number. This is required if preferred contact method is phone."
                    }
                  }
                ]
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets
{
$top:
{
Description: The number of values to return in the collection. Default is 25 and max is 100. ,
Format: int32 ,
Required: False ,
}
integer ,
$filter:
{
Description: The filter to apply on the operation. We support 'odata v4.0' filter semantics. [Learn more](https://docs.microsoft.com/odata/concepts/queryoptions-overview). _Status_, _ServiceId_, and _ProblemClassificationId_ filters can only be used with Equals ('eq') operator. For _CreatedDate_ filter, the supported operators are Greater Than ('gt') and Greater Than or Equals ('ge'). When using both filters, combine them using the logical 'AND'. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Azure subscription Id. ,
Required: True ,
}
string ,
api-version:
{
Description: API version. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of SupportTicket resources. ,
Required: False ,
}
[
{
id:
{
Description: Id of the resource. ,
Required: False ,
}
string ,
name:
{
Description: Name of the resource. ,
Required: False ,
}
string ,
type:
{
Description: Type of the resource 'Microsoft.Support/supportTickets'. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the resource. ,
Required: False ,
}
{
supportTicketId:
{
Description: System generated support ticket Id that is unique. ,
Required: False ,
}
string ,
description:
{
Description: Detailed description of the question or issue. ,
Required: True ,
}
string ,
problemClassificationId:
{
Description: Each Azure service has its own set of issue categories, also known as problem classification. This parameter is the unique Id for the type of problem you are experiencing. ,
Required: True ,
}
string ,
problemClassificationDisplayName:
{
Description: Localized name of problem classification. ,
Required: False ,
}
string ,
severity:
{
Description: A value that indicates the urgency of the case, which in turn determines the response time according to the service level agreement of the technical support plan you have with Azure. Note: 'Highest critical impact', also known as the 'Emergency - Severe impact' level in the Azure portal is reserved only for our Premium customers. ,
Enum:
{
minimal: No description available. ,
moderate: No description available. ,
critical: No description available. ,
highestcriticalimpact: No description available. ,
}
,
Required: True ,
}
enum ,
enrollmentId:
{
Description: Enrollment Id associated with the support ticket. ,
Required: False ,
}
string ,
require24X7Response:
{
Description: Indicates if this requires a 24x7 response from Azure. ,
Required: False ,
}
boolean ,
contactDetails:
{
Description: Contact information of the user requesting to create a support ticket. ,
Required: True ,
}
{
firstName:
{
Description: First name. ,
Required: True ,
}
string ,
lastName:
{
Description: Last name. ,
Required: True ,
}
string ,
preferredContactMethod:
{
Description: Preferred contact method. ,
Enum:
{
email: No description available. ,
phone: No description available. ,
}
,
Required: True ,
}
enum ,
primaryEmailAddress:
{
Description: Primary email address. ,
Required: True ,
}
string ,
additionalEmailAddresses:
{
Description: Additional email addresses listed will be copied on any correspondence about the support ticket. ,
Required: False ,
}
[
string ,
]
,
phoneNumber:
{
Description: Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases. ,
Required: False ,
}
string ,
preferredTimeZone:
{
Description: Time zone of the user. This is the name of the time zone from [Microsoft Time Zone Index Values](https://support.microsoft.com/help/973627/microsoft-time-zone-index-values). ,
Required: True ,
}
string ,
country:
{
Description: Country of the user. This is the ISO 3166-1 alpha-3 code. ,
Required: True ,
}
string ,
preferredSupportLanguage:
{
Description: Preferred language of support from Azure. Support languages vary based on the severity you choose for your support ticket. Learn more at [Azure Severity and responsiveness](https://azure.microsoft.com/support/plans/response). Use the standard language-country code. Valid values are 'en-us' for English, 'zh-hans' for Chinese, 'es-es' for Spanish, 'fr-fr' for French, 'ja-jp' for Japanese, 'ko-kr' for Korean, 'ru-ru' for Russian, 'pt-br' for Portuguese, 'it-it' for Italian, 'zh-tw' for Chinese and 'de-de' for German. ,
Required: True ,
}
string ,
}
,
serviceLevelAgreement:
{
Description: Service Level Agreement information for this support ticket. ,
Required: False ,
}
{
startTime:
{
Description: Time in UTC (ISO 8601 format) when the service level agreement starts. ,
Format: date-time ,
Required: False ,
}
string ,
expirationTime:
{
Description: Time in UTC (ISO 8601 format) when the service level agreement expires. ,
Format: date-time ,
Required: False ,
}
string ,
slaMinutes:
{
Description: Service Level Agreement in minutes. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
supportEngineer:
{
Description: Information about the support engineer working on this support ticket. ,
Required: False ,
}
{
emailAddress:
{
Description: Email address of the Azure Support engineer assigned to the support ticket. ,
Required: False ,
}
string ,
}
,
supportPlanType:
{
Description: Support plan type associated with the support ticket. ,
Required: False ,
}
string ,
title:
{
Description: Title of the support ticket. ,
Required: True ,
}
string ,
problemStartTime:
{
Description: Time in UTC (ISO 8601 format) when the problem started. ,
Format: date-time ,
Required: False ,
}
string ,
serviceId:
{
Description: This is the resource Id of the Azure service resource associated with the support ticket. ,
Required: True ,
}
string ,
serviceDisplayName:
{
Description: Localized name of the Azure service. ,
Required: False ,
}
string ,
status:
{
Description: Status of the support ticket. ,
Required: False ,
}
string ,
createdDate:
{
Description: Time in UTC (ISO 8601 format) when the support ticket was created. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedDate:
{
Description: Time in UTC (ISO 8601 format) when the support ticket was last modified. ,
Format: date-time ,
Required: False ,
}
string ,
technicalTicketDetails:
{
Description: Additional ticket details associated with a technical support ticket request. ,
Required: False ,
}
{
resourceId:
{
Description: This is the resource Id of the Azure service resource (For example: A virtual machine resource or an HDInsight resource) for which the support ticket is created. ,
Required: False ,
}
string ,
}
,
quotaTicketDetails:
{
Description: Additional ticket details associated with a quota support ticket request. ,
Required: False ,
}
{
quotaChangeRequestSubType:
{
Description: Required for certain quota types when there is a sub type, such as Batch, for which you are requesting a quota increase. ,
Required: False ,
}
string ,
quotaChangeRequestVersion:
{
Description: Quota change request version. ,
Required: False ,
}
string ,
quotaChangeRequests:
{
Description: This property is required for providing the region and new quota limits. ,
Required: False ,
}
[
{
region:
{
Description: Region for which the quota increase request is being made. ,
Required: False ,
}
string ,
payload:
{
Description: Payload of the quota increase request. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: The URI to fetch the next page of SupportTicket resources. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The API error details. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
SupportTickets_Get (updated)
Description :  Get ticket details for an Azure subscription. Support ticket data is available for 18 months after ticket creation. If a ticket was created more than 18 months ago, a request for data might cause an error.
Reference :  Link ¶

⚶ Changes

{
  "#id": "SupportTickets_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "contactDetails": [
              {
                "#name": "phoneNumber",
                "Description": {
                  "new": "Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases.",
                  "old": "Phone number. This is required if preferred contact method is phone."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}
{
supportTicketName:
{
Description: Support ticket name. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Azure subscription Id. ,
Required: True ,
}
string ,
api-version:
{
Description: API version. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: Id of the resource. ,
Required: False ,
}
string ,
name:
{
Description: Name of the resource. ,
Required: False ,
}
string ,
type:
{
Description: Type of the resource 'Microsoft.Support/supportTickets'. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the resource. ,
Required: False ,
}
{
supportTicketId:
{
Description: System generated support ticket Id that is unique. ,
Required: False ,
}
string ,
description:
{
Description: Detailed description of the question or issue. ,
Required: True ,
}
string ,
problemClassificationId:
{
Description: Each Azure service has its own set of issue categories, also known as problem classification. This parameter is the unique Id for the type of problem you are experiencing. ,
Required: True ,
}
string ,
problemClassificationDisplayName:
{
Description: Localized name of problem classification. ,
Required: False ,
}
string ,
severity:
{
Description: A value that indicates the urgency of the case, which in turn determines the response time according to the service level agreement of the technical support plan you have with Azure. Note: 'Highest critical impact', also known as the 'Emergency - Severe impact' level in the Azure portal is reserved only for our Premium customers. ,
Enum:
{
minimal: No description available. ,
moderate: No description available. ,
critical: No description available. ,
highestcriticalimpact: No description available. ,
}
,
Required: True ,
}
enum ,
enrollmentId:
{
Description: Enrollment Id associated with the support ticket. ,
Required: False ,
}
string ,
require24X7Response:
{
Description: Indicates if this requires a 24x7 response from Azure. ,
Required: False ,
}
boolean ,
contactDetails:
{
Description: Contact information of the user requesting to create a support ticket. ,
Required: True ,
}
{
firstName:
{
Description: First name. ,
Required: True ,
}
string ,
lastName:
{
Description: Last name. ,
Required: True ,
}
string ,
preferredContactMethod:
{
Description: Preferred contact method. ,
Enum:
{
email: No description available. ,
phone: No description available. ,
}
,
Required: True ,
}
enum ,
primaryEmailAddress:
{
Description: Primary email address. ,
Required: True ,
}
string ,
additionalEmailAddresses:
{
Description: Additional email addresses listed will be copied on any correspondence about the support ticket. ,
Required: False ,
}
[
string ,
]
,
phoneNumber:
{
Description: Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases. ,
Required: False ,
}
string ,
preferredTimeZone:
{
Description: Time zone of the user. This is the name of the time zone from [Microsoft Time Zone Index Values](https://support.microsoft.com/help/973627/microsoft-time-zone-index-values). ,
Required: True ,
}
string ,
country:
{
Description: Country of the user. This is the ISO 3166-1 alpha-3 code. ,
Required: True ,
}
string ,
preferredSupportLanguage:
{
Description: Preferred language of support from Azure. Support languages vary based on the severity you choose for your support ticket. Learn more at [Azure Severity and responsiveness](https://azure.microsoft.com/support/plans/response). Use the standard language-country code. Valid values are 'en-us' for English, 'zh-hans' for Chinese, 'es-es' for Spanish, 'fr-fr' for French, 'ja-jp' for Japanese, 'ko-kr' for Korean, 'ru-ru' for Russian, 'pt-br' for Portuguese, 'it-it' for Italian, 'zh-tw' for Chinese and 'de-de' for German. ,
Required: True ,
}
string ,
}
,
serviceLevelAgreement:
{
Description: Service Level Agreement information for this support ticket. ,
Required: False ,
}
{
startTime:
{
Description: Time in UTC (ISO 8601 format) when the service level agreement starts. ,
Format: date-time ,
Required: False ,
}
string ,
expirationTime:
{
Description: Time in UTC (ISO 8601 format) when the service level agreement expires. ,
Format: date-time ,
Required: False ,
}
string ,
slaMinutes:
{
Description: Service Level Agreement in minutes. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
supportEngineer:
{
Description: Information about the support engineer working on this support ticket. ,
Required: False ,
}
{
emailAddress:
{
Description: Email address of the Azure Support engineer assigned to the support ticket. ,
Required: False ,
}
string ,
}
,
supportPlanType:
{
Description: Support plan type associated with the support ticket. ,
Required: False ,
}
string ,
title:
{
Description: Title of the support ticket. ,
Required: True ,
}
string ,
problemStartTime:
{
Description: Time in UTC (ISO 8601 format) when the problem started. ,
Format: date-time ,
Required: False ,
}
string ,
serviceId:
{
Description: This is the resource Id of the Azure service resource associated with the support ticket. ,
Required: True ,
}
string ,
serviceDisplayName:
{
Description: Localized name of the Azure service. ,
Required: False ,
}
string ,
status:
{
Description: Status of the support ticket. ,
Required: False ,
}
string ,
createdDate:
{
Description: Time in UTC (ISO 8601 format) when the support ticket was created. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedDate:
{
Description: Time in UTC (ISO 8601 format) when the support ticket was last modified. ,
Format: date-time ,
Required: False ,
}
string ,
technicalTicketDetails:
{
Description: Additional ticket details associated with a technical support ticket request. ,
Required: False ,
}
{
resourceId:
{
Description: This is the resource Id of the Azure service resource (For example: A virtual machine resource or an HDInsight resource) for which the support ticket is created. ,
Required: False ,
}
string ,
}
,
quotaTicketDetails:
{
Description: Additional ticket details associated with a quota support ticket request. ,
Required: False ,
}
{
quotaChangeRequestSubType:
{
Description: Required for certain quota types when there is a sub type, such as Batch, for which you are requesting a quota increase. ,
Required: False ,
}
string ,
quotaChangeRequestVersion:
{
Description: Quota change request version. ,
Required: False ,
}
string ,
quotaChangeRequests:
{
Description: This property is required for providing the region and new quota limits. ,
Required: False ,
}
[
{
region:
{
Description: Region for which the quota increase request is being made. ,
Required: False ,
}
string ,
payload:
{
Description: Payload of the quota increase request. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The API error details. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
SupportTickets_Update (updated)
Description :  This API allows you to update the severity level, ticket status, and your contact information in the support ticket.

Note: The severity levels cannot be changed if a support ticket is actively being worked upon by an Azure support engineer. In such a case, contact your support engineer to request severity update by adding a new communication using the Communications API.

Changing the ticket status to _closed_ is allowed only on an unassigned case. When an engineer is actively working on the ticket, send your ticket closure request by sending a note to your engineer.
Reference :  Link ¶

⚶ Changes

{
  "#id": "SupportTickets_Update",
  "$parameters": {
    "updateSupportTicket": {
      "$properties": {
        "contactDetails": [
          {
            "#name": "phoneNumber",
            "Description": {
              "new": "Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases.",
              "old": "Phone number. This is required if preferred contact method is phone."
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "contactDetails": [
              {
                "#name": "phoneNumber",
                "Description": {
                  "new": "Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases.",
                  "old": "Phone number. This is required if preferred contact method is phone."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}
{
supportTicketName:
{
Description: Support ticket name. ,
Required: True ,
}
string ,
updateSupportTicket:
{
Description: UpdateSupportTicket object. ,
Required: True ,
}
{
severity:
{
Description: Severity level. ,
Enum:
{
minimal: No description available. ,
moderate: No description available. ,
critical: No description available. ,
highestcriticalimpact: No description available. ,
}
,
Required: False ,
}
enum ,
status:
{
Description: Status to be updated on the ticket. ,
Enum:
{
open: No description available. ,
closed: No description available. ,
}
,
Required: False ,
}
enum ,
contactDetails:
{
Description: Contact details to be updated on the support ticket. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
preferredContactMethod:
{
Description: Preferred contact method. ,
Enum:
{
email: No description available. ,
phone: No description available. ,
}
,
Required: False ,
}
enum ,
primaryEmailAddress:
{
Description: Primary email address. ,
Required: False ,
}
string ,
additionalEmailAddresses:
{
Description: Email addresses listed will be copied on any correspondence about the support ticket. ,
Required: False ,
}
[
string ,
]
,
phoneNumber:
{
Description: Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases. ,
Required: False ,
}
string ,
preferredTimeZone:
{
Description: Time zone of the user. This is the name of the time zone from [Microsoft Time Zone Index Values](https://support.microsoft.com/help/973627/microsoft-time-zone-index-values). ,
Required: False ,
}
string ,
country:
{
Description: Country of the user. This is the ISO 3166-1 alpha-3 code. ,
Required: False ,
}
string ,
preferredSupportLanguage:
{
Description: Preferred language of support from Azure. Support languages vary based on the severity you choose for your support ticket. Learn more at [Azure Severity and responsiveness](https://azure.microsoft.com/support/plans/response/). Use the standard language-country code. Valid values are 'en-us' for English, 'zh-hans' for Chinese, 'es-es' for Spanish, 'fr-fr' for French, 'ja-jp' for Japanese, 'ko-kr' for Korean, 'ru-ru' for Russian, 'pt-br' for Portuguese, 'it-it' for Italian, 'zh-tw' for Chinese and 'de-de' for German. ,
Required: False ,
}
string ,
}
,
}
,
subscriptionId:
{
Description: Azure subscription Id. ,
Required: True ,
}
string ,
api-version:
{
Description: API version. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: Id of the resource. ,
Required: False ,
}
string ,
name:
{
Description: Name of the resource. ,
Required: False ,
}
string ,
type:
{
Description: Type of the resource 'Microsoft.Support/supportTickets'. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the resource. ,
Required: False ,
}
{
supportTicketId:
{
Description: System generated support ticket Id that is unique. ,
Required: False ,
}
string ,
description:
{
Description: Detailed description of the question or issue. ,
Required: True ,
}
string ,
problemClassificationId:
{
Description: Each Azure service has its own set of issue categories, also known as problem classification. This parameter is the unique Id for the type of problem you are experiencing. ,
Required: True ,
}
string ,
problemClassificationDisplayName:
{
Description: Localized name of problem classification. ,
Required: False ,
}
string ,
severity:
{
Description: A value that indicates the urgency of the case, which in turn determines the response time according to the service level agreement of the technical support plan you have with Azure. Note: 'Highest critical impact', also known as the 'Emergency - Severe impact' level in the Azure portal is reserved only for our Premium customers. ,
Enum:
{
minimal: No description available. ,
moderate: No description available. ,
critical: No description available. ,
highestcriticalimpact: No description available. ,
}
,
Required: True ,
}
enum ,
enrollmentId:
{
Description: Enrollment Id associated with the support ticket. ,
Required: False ,
}
string ,
require24X7Response:
{
Description: Indicates if this requires a 24x7 response from Azure. ,
Required: False ,
}
boolean ,
contactDetails:
{
Description: Contact information of the user requesting to create a support ticket. ,
Required: True ,
}
{
firstName:
{
Description: First name. ,
Required: True ,
}
string ,
lastName:
{
Description: Last name. ,
Required: True ,
}
string ,
preferredContactMethod:
{
Description: Preferred contact method. ,
Enum:
{
email: No description available. ,
phone: No description available. ,
}
,
Required: True ,
}
enum ,
primaryEmailAddress:
{
Description: Primary email address. ,
Required: True ,
}
string ,
additionalEmailAddresses:
{
Description: Additional email addresses listed will be copied on any correspondence about the support ticket. ,
Required: False ,
}
[
string ,
]
,
phoneNumber:
{
Description: Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases. ,
Required: False ,
}
string ,
preferredTimeZone:
{
Description: Time zone of the user. This is the name of the time zone from [Microsoft Time Zone Index Values](https://support.microsoft.com/help/973627/microsoft-time-zone-index-values). ,
Required: True ,
}
string ,
country:
{
Description: Country of the user. This is the ISO 3166-1 alpha-3 code. ,
Required: True ,
}
string ,
preferredSupportLanguage:
{
Description: Preferred language of support from Azure. Support languages vary based on the severity you choose for your support ticket. Learn more at [Azure Severity and responsiveness](https://azure.microsoft.com/support/plans/response). Use the standard language-country code. Valid values are 'en-us' for English, 'zh-hans' for Chinese, 'es-es' for Spanish, 'fr-fr' for French, 'ja-jp' for Japanese, 'ko-kr' for Korean, 'ru-ru' for Russian, 'pt-br' for Portuguese, 'it-it' for Italian, 'zh-tw' for Chinese and 'de-de' for German. ,
Required: True ,
}
string ,
}
,
serviceLevelAgreement:
{
Description: Service Level Agreement information for this support ticket. ,
Required: False ,
}
{
startTime:
{
Description: Time in UTC (ISO 8601 format) when the service level agreement starts. ,
Format: date-time ,
Required: False ,
}
string ,
expirationTime:
{
Description: Time in UTC (ISO 8601 format) when the service level agreement expires. ,
Format: date-time ,
Required: False ,
}
string ,
slaMinutes:
{
Description: Service Level Agreement in minutes. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
supportEngineer:
{
Description: Information about the support engineer working on this support ticket. ,
Required: False ,
}
{
emailAddress:
{
Description: Email address of the Azure Support engineer assigned to the support ticket. ,
Required: False ,
}
string ,
}
,
supportPlanType:
{
Description: Support plan type associated with the support ticket. ,
Required: False ,
}
string ,
title:
{
Description: Title of the support ticket. ,
Required: True ,
}
string ,
problemStartTime:
{
Description: Time in UTC (ISO 8601 format) when the problem started. ,
Format: date-time ,
Required: False ,
}
string ,
serviceId:
{
Description: This is the resource Id of the Azure service resource associated with the support ticket. ,
Required: True ,
}
string ,
serviceDisplayName:
{
Description: Localized name of the Azure service. ,
Required: False ,
}
string ,
status:
{
Description: Status of the support ticket. ,
Required: False ,
}
string ,
createdDate:
{
Description: Time in UTC (ISO 8601 format) when the support ticket was created. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedDate:
{
Description: Time in UTC (ISO 8601 format) when the support ticket was last modified. ,
Format: date-time ,
Required: False ,
}
string ,
technicalTicketDetails:
{
Description: Additional ticket details associated with a technical support ticket request. ,
Required: False ,
}
{
resourceId:
{
Description: This is the resource Id of the Azure service resource (For example: A virtual machine resource or an HDInsight resource) for which the support ticket is created. ,
Required: False ,
}
string ,
}
,
quotaTicketDetails:
{
Description: Additional ticket details associated with a quota support ticket request. ,
Required: False ,
}
{
quotaChangeRequestSubType:
{
Description: Required for certain quota types when there is a sub type, such as Batch, for which you are requesting a quota increase. ,
Required: False ,
}
string ,
quotaChangeRequestVersion:
{
Description: Quota change request version. ,
Required: False ,
}
string ,
quotaChangeRequests:
{
Description: This property is required for providing the region and new quota limits. ,
Required: False ,
}
[
{
region:
{
Description: Region for which the quota increase request is being made. ,
Required: False ,
}
string ,
payload:
{
Description: Payload of the quota increase request. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The API error details. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
SupportTickets_Create (updated)
Description :  Creates a new support ticket for Subscription and Service limits (Quota), Technical, Billing, and Subscription Management issues for the specified subscription. Learn the [prerequisites](https://aka.ms/supportAPI) required to create a support ticket.

Always call the Services and ProblemClassifications API to get the most recent set of services and problem categories required for support ticket creation.

Adding attachments is not currently supported via the API. To add a file to an existing support ticket, visit the [Manage support ticket](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/managesupportrequest) page in the Azure portal, select the support ticket, and use the file upload control to add a new file.

Providing consent to share diagnostic information with Azure support is currently not supported via the API. The Azure support engineer working on your ticket will reach out to you for consent if your issue requires gathering diagnostic information from your Azure resources.

**Creating a support ticket for on-behalf-of**: Include _x-ms-authorization-auxiliary_ header to provide an auxiliary token as per [documentation](https://docs.microsoft.com/azure/azure-resource-manager/management/authenticate-multi-tenant). The primary token will be from the tenant for whom a support ticket is being raised against the subscription, i.e. Cloud solution provider (CSP) customer tenant. The auxiliary token will be from the Cloud solution provider (CSP) partner tenant.
Reference :  Link ¶

⚶ Changes

{
  "#id": "SupportTickets_Create",
  "$parameters": {
    "createSupportTicketParameters": {
      "$properties": {
        "properties": [
          {
            "contactDetails": [
              {
                "#name": "phoneNumber",
                "Description": {
                  "new": "Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases.",
                  "old": "Phone number. This is required if preferred contact method is phone."
                }
              }
            ]
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "contactDetails": [
              {
                "#name": "phoneNumber",
                "Description": {
                  "new": "Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases.",
                  "old": "Phone number. This is required if preferred contact method is phone."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}
{
supportTicketName:
{
Description: Support ticket name. ,
Required: True ,
}
string ,
createSupportTicketParameters:
{
Description: Support ticket request payload. ,
Required: True ,
}
{
id:
{
Description: Id of the resource. ,
Required: False ,
}
string ,
name:
{
Description: Name of the resource. ,
Required: False ,
}
string ,
type:
{
Description: Type of the resource 'Microsoft.Support/supportTickets'. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the resource. ,
Required: False ,
}
{
supportTicketId:
{
Description: System generated support ticket Id that is unique. ,
Required: False ,
}
string ,
description:
{
Description: Detailed description of the question or issue. ,
Required: True ,
}
string ,
problemClassificationId:
{
Description: Each Azure service has its own set of issue categories, also known as problem classification. This parameter is the unique Id for the type of problem you are experiencing. ,
Required: True ,
}
string ,
problemClassificationDisplayName:
{
Description: Localized name of problem classification. ,
Required: False ,
}
string ,
severity:
{
Description: A value that indicates the urgency of the case, which in turn determines the response time according to the service level agreement of the technical support plan you have with Azure. Note: 'Highest critical impact', also known as the 'Emergency - Severe impact' level in the Azure portal is reserved only for our Premium customers. ,
Enum:
{
minimal: No description available. ,
moderate: No description available. ,
critical: No description available. ,
highestcriticalimpact: No description available. ,
}
,
Required: True ,
}
enum ,
enrollmentId:
{
Description: Enrollment Id associated with the support ticket. ,
Required: False ,
}
string ,
require24X7Response:
{
Description: Indicates if this requires a 24x7 response from Azure. ,
Required: False ,
}
boolean ,
contactDetails:
{
Description: Contact information of the user requesting to create a support ticket. ,
Required: True ,
}
{
firstName:
{
Description: First name. ,
Required: True ,
}
string ,
lastName:
{
Description: Last name. ,
Required: True ,
}
string ,
preferredContactMethod:
{
Description: Preferred contact method. ,
Enum:
{
email: No description available. ,
phone: No description available. ,
}
,
Required: True ,
}
enum ,
primaryEmailAddress:
{
Description: Primary email address. ,
Required: True ,
}
string ,
additionalEmailAddresses:
{
Description: Additional email addresses listed will be copied on any correspondence about the support ticket. ,
Required: False ,
}
[
string ,
]
,
phoneNumber:
{
Description: Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases. ,
Required: False ,
}
string ,
preferredTimeZone:
{
Description: Time zone of the user. This is the name of the time zone from [Microsoft Time Zone Index Values](https://support.microsoft.com/help/973627/microsoft-time-zone-index-values). ,
Required: True ,
}
string ,
country:
{
Description: Country of the user. This is the ISO 3166-1 alpha-3 code. ,
Required: True ,
}
string ,
preferredSupportLanguage:
{
Description: Preferred language of support from Azure. Support languages vary based on the severity you choose for your support ticket. Learn more at [Azure Severity and responsiveness](https://azure.microsoft.com/support/plans/response). Use the standard language-country code. Valid values are 'en-us' for English, 'zh-hans' for Chinese, 'es-es' for Spanish, 'fr-fr' for French, 'ja-jp' for Japanese, 'ko-kr' for Korean, 'ru-ru' for Russian, 'pt-br' for Portuguese, 'it-it' for Italian, 'zh-tw' for Chinese and 'de-de' for German. ,
Required: True ,
}
string ,
}
,
serviceLevelAgreement:
{
Description: Service Level Agreement information for this support ticket. ,
Required: False ,
}
{
startTime:
{
Description: Time in UTC (ISO 8601 format) when the service level agreement starts. ,
Format: date-time ,
Required: False ,
}
string ,
expirationTime:
{
Description: Time in UTC (ISO 8601 format) when the service level agreement expires. ,
Format: date-time ,
Required: False ,
}
string ,
slaMinutes:
{
Description: Service Level Agreement in minutes. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
supportEngineer:
{
Description: Information about the support engineer working on this support ticket. ,
Required: False ,
}
{
emailAddress:
{
Description: Email address of the Azure Support engineer assigned to the support ticket. ,
Required: False ,
}
string ,
}
,
supportPlanType:
{
Description: Support plan type associated with the support ticket. ,
Required: False ,
}
string ,
title:
{
Description: Title of the support ticket. ,
Required: True ,
}
string ,
problemStartTime:
{
Description: Time in UTC (ISO 8601 format) when the problem started. ,
Format: date-time ,
Required: False ,
}
string ,
serviceId:
{
Description: This is the resource Id of the Azure service resource associated with the support ticket. ,
Required: True ,
}
string ,
serviceDisplayName:
{
Description: Localized name of the Azure service. ,
Required: False ,
}
string ,
status:
{
Description: Status of the support ticket. ,
Required: False ,
}
string ,
createdDate:
{
Description: Time in UTC (ISO 8601 format) when the support ticket was created. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedDate:
{
Description: Time in UTC (ISO 8601 format) when the support ticket was last modified. ,
Format: date-time ,
Required: False ,
}
string ,
technicalTicketDetails:
{
Description: Additional ticket details associated with a technical support ticket request. ,
Required: False ,
}
{
resourceId:
{
Description: This is the resource Id of the Azure service resource (For example: A virtual machine resource or an HDInsight resource) for which the support ticket is created. ,
Required: False ,
}
string ,
}
,
quotaTicketDetails:
{
Description: Additional ticket details associated with a quota support ticket request. ,
Required: False ,
}
{
quotaChangeRequestSubType:
{
Description: Required for certain quota types when there is a sub type, such as Batch, for which you are requesting a quota increase. ,
Required: False ,
}
string ,
quotaChangeRequestVersion:
{
Description: Quota change request version. ,
Required: False ,
}
string ,
quotaChangeRequests:
{
Description: This property is required for providing the region and new quota limits. ,
Required: False ,
}
[
{
region:
{
Description: Region for which the quota increase request is being made. ,
Required: False ,
}
string ,
payload:
{
Description: Payload of the quota increase request. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
}
,
subscriptionId:
{
Description: Azure subscription Id. ,
Required: True ,
}
string ,
api-version:
{
Description: API version. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: Id of the resource. ,
Required: False ,
}
string ,
name:
{
Description: Name of the resource. ,
Required: False ,
}
string ,
type:
{
Description: Type of the resource 'Microsoft.Support/supportTickets'. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the resource. ,
Required: False ,
}
{
supportTicketId:
{
Description: System generated support ticket Id that is unique. ,
Required: False ,
}
string ,
description:
{
Description: Detailed description of the question or issue. ,
Required: True ,
}
string ,
problemClassificationId:
{
Description: Each Azure service has its own set of issue categories, also known as problem classification. This parameter is the unique Id for the type of problem you are experiencing. ,
Required: True ,
}
string ,
problemClassificationDisplayName:
{
Description: Localized name of problem classification. ,
Required: False ,
}
string ,
severity:
{
Description: A value that indicates the urgency of the case, which in turn determines the response time according to the service level agreement of the technical support plan you have with Azure. Note: 'Highest critical impact', also known as the 'Emergency - Severe impact' level in the Azure portal is reserved only for our Premium customers. ,
Enum:
{
minimal: No description available. ,
moderate: No description available. ,
critical: No description available. ,
highestcriticalimpact: No description available. ,
}
,
Required: True ,
}
enum ,
enrollmentId:
{
Description: Enrollment Id associated with the support ticket. ,
Required: False ,
}
string ,
require24X7Response:
{
Description: Indicates if this requires a 24x7 response from Azure. ,
Required: False ,
}
boolean ,
contactDetails:
{
Description: Contact information of the user requesting to create a support ticket. ,
Required: True ,
}
{
firstName:
{
Description: First name. ,
Required: True ,
}
string ,
lastName:
{
Description: Last name. ,
Required: True ,
}
string ,
preferredContactMethod:
{
Description: Preferred contact method. ,
Enum:
{
email: No description available. ,
phone: No description available. ,
}
,
Required: True ,
}
enum ,
primaryEmailAddress:
{
Description: Primary email address. ,
Required: True ,
}
string ,
additionalEmailAddresses:
{
Description: Additional email addresses listed will be copied on any correspondence about the support ticket. ,
Required: False ,
}
[
string ,
]
,
phoneNumber:
{
Description: Phone number. This is required if preferred contact method is phone. It is also required when submitting 'critical' or 'highestcriticalimpact' severity cases. ,
Required: False ,
}
string ,
preferredTimeZone:
{
Description: Time zone of the user. This is the name of the time zone from [Microsoft Time Zone Index Values](https://support.microsoft.com/help/973627/microsoft-time-zone-index-values). ,
Required: True ,
}
string ,
country:
{
Description: Country of the user. This is the ISO 3166-1 alpha-3 code. ,
Required: True ,
}
string ,
preferredSupportLanguage:
{
Description: Preferred language of support from Azure. Support languages vary based on the severity you choose for your support ticket. Learn more at [Azure Severity and responsiveness](https://azure.microsoft.com/support/plans/response). Use the standard language-country code. Valid values are 'en-us' for English, 'zh-hans' for Chinese, 'es-es' for Spanish, 'fr-fr' for French, 'ja-jp' for Japanese, 'ko-kr' for Korean, 'ru-ru' for Russian, 'pt-br' for Portuguese, 'it-it' for Italian, 'zh-tw' for Chinese and 'de-de' for German. ,
Required: True ,
}
string ,
}
,
serviceLevelAgreement:
{
Description: Service Level Agreement information for this support ticket. ,
Required: False ,
}
{
startTime:
{
Description: Time in UTC (ISO 8601 format) when the service level agreement starts. ,
Format: date-time ,
Required: False ,
}
string ,
expirationTime:
{
Description: Time in UTC (ISO 8601 format) when the service level agreement expires. ,
Format: date-time ,
Required: False ,
}
string ,
slaMinutes:
{
Description: Service Level Agreement in minutes. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
supportEngineer:
{
Description: Information about the support engineer working on this support ticket. ,
Required: False ,
}
{
emailAddress:
{
Description: Email address of the Azure Support engineer assigned to the support ticket. ,
Required: False ,
}
string ,
}
,
supportPlanType:
{
Description: Support plan type associated with the support ticket. ,
Required: False ,
}
string ,
title:
{
Description: Title of the support ticket. ,
Required: True ,
}
string ,
problemStartTime:
{
Description: Time in UTC (ISO 8601 format) when the problem started. ,
Format: date-time ,
Required: False ,
}
string ,
serviceId:
{
Description: This is the resource Id of the Azure service resource associated with the support ticket. ,
Required: True ,
}
string ,
serviceDisplayName:
{
Description: Localized name of the Azure service. ,
Required: False ,
}
string ,
status:
{
Description: Status of the support ticket. ,
Required: False ,
}
string ,
createdDate:
{
Description: Time in UTC (ISO 8601 format) when the support ticket was created. ,
Format: date-time ,
Required: False ,
}
string ,
modifiedDate:
{
Description: Time in UTC (ISO 8601 format) when the support ticket was last modified. ,
Format: date-time ,
Required: False ,
}
string ,
technicalTicketDetails:
{
Description: Additional ticket details associated with a technical support ticket request. ,
Required: False ,
}
{
resourceId:
{
Description: This is the resource Id of the Azure service resource (For example: A virtual machine resource or an HDInsight resource) for which the support ticket is created. ,
Required: False ,
}
string ,
}
,
quotaTicketDetails:
{
Description: Additional ticket details associated with a quota support ticket request. ,
Required: False ,
}
{
quotaChangeRequestSubType:
{
Description: Required for certain quota types when there is a sub type, such as Batch, for which you are requesting a quota increase. ,
Required: False ,
}
string ,
quotaChangeRequestVersion:
{
Description: Quota change request version. ,
Required: False ,
}
string ,
quotaChangeRequests:
{
Description: This property is required for providing the region and new quota limits. ,
Required: False ,
}
[
{
region:
{
Description: Region for which the quota increase request is being made. ,
Required: False ,
}
string ,
payload:
{
Description: Payload of the quota increase request. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
}

⚐ Response (202)

{}

⚐ Response (default)

{
error:
{
Description: The API error details. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}