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

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

Operations_List (new)
Description :  This lists all the available Microsoft Support REST API operations.
Reference :  Link ¶

⚼ Request

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

⚐ Response (200)

{
value:
[
{
name: string ,
display:
{
description: string ,
operation: string ,
provider: string ,
resource: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Services_List (new)
Description :  Lists all the Azure services available for support ticket creation. For **Technical** issues, select the Service Id that maps to the Azure service/product as displayed in the **Services** drop-down list on the Azure portal's [New support request](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview) page. Always use the service and its corresponding problem classification(s) obtained programmatically for support ticket creation. This practice ensures that you always have the most recent set of service and problem classification Ids.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Support/services
{
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
id: string ,
name: string ,
type: string ,
properties:
{
displayName: string ,
resourceTypes:
[
string ,
]
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Services_Get (new)
Description :  Gets a specific Azure service for support ticket creation.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Support/services/{serviceName}
{
serviceName: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
displayName: string ,
resourceTypes:
[
string ,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
ProblemClassifications_List (new)
Description :  Lists all the problem classifications (categories) available for a specific Azure service. Always use the service and problem classifications obtained programmatically. This practice ensures that you always have the most recent set of service and problem classification Ids.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Support/services/{serviceName}/problemClassifications
{
serviceName: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
id: string ,
name: string ,
type: string ,
properties:
{
displayName: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
ProblemClassifications_Get (new)
Description :  Get problem classification details for a specific Azure service.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Support/services/{serviceName}/problemClassifications/{problemClassificationName}
{
serviceName: string ,
problemClassificationName: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
displayName: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
SupportTickets_CheckNameAvailability (new)
Description :  Check the availability of a resource name. This API should be used to check the uniqueness of the name for support ticket creation for the selected subscription.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/checkNameAvailability
{
checkNameAvailabilityInput:
{
name: string ,
type: enum ,
}
,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

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

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
SupportTickets_List (new)
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 ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets
{
$top: integer ,
$filter: string ,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
id: string ,
name: string ,
type: string ,
properties:
{
supportTicketId: string ,
description: string ,
problemClassificationId: string ,
problemClassificationDisplayName: string ,
severity: enum ,
enrollmentId: string ,
require24X7Response: boolean ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
serviceLevelAgreement:
{
startTime: string ,
expirationTime: string ,
slaMinutes: integer ,
}
,
supportEngineer:
{
emailAddress: string ,
}
,
supportPlanType: string ,
title: string ,
problemStartTime: string ,
serviceId: string ,
serviceDisplayName: string ,
status: string ,
createdDate: string ,
modifiedDate: string ,
technicalTicketDetails:
{
resourceId: string ,
}
,
quotaTicketDetails:
{
quotaChangeRequestSubType: string ,
quotaChangeRequestVersion: string ,
quotaChangeRequests:
[
{
region: string ,
payload: string ,
}
,
]
,
}
,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
SupportTickets_Get (new)
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 ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}
{
supportTicketName: string ,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
supportTicketId: string ,
description: string ,
problemClassificationId: string ,
problemClassificationDisplayName: string ,
severity: enum ,
enrollmentId: string ,
require24X7Response: boolean ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
serviceLevelAgreement:
{
startTime: string ,
expirationTime: string ,
slaMinutes: integer ,
}
,
supportEngineer:
{
emailAddress: string ,
}
,
supportPlanType: string ,
title: string ,
problemStartTime: string ,
serviceId: string ,
serviceDisplayName: string ,
status: string ,
createdDate: string ,
modifiedDate: string ,
technicalTicketDetails:
{
resourceId: string ,
}
,
quotaTicketDetails:
{
quotaChangeRequestSubType: string ,
quotaChangeRequestVersion: string ,
quotaChangeRequests:
[
{
region: string ,
payload: string ,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
SupportTickets_Update (new)
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 ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}
{
supportTicketName: string ,
updateSupportTicket:
{
severity: enum ,
status: enum ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
}
,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
supportTicketId: string ,
description: string ,
problemClassificationId: string ,
problemClassificationDisplayName: string ,
severity: enum ,
enrollmentId: string ,
require24X7Response: boolean ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
serviceLevelAgreement:
{
startTime: string ,
expirationTime: string ,
slaMinutes: integer ,
}
,
supportEngineer:
{
emailAddress: string ,
}
,
supportPlanType: string ,
title: string ,
problemStartTime: string ,
serviceId: string ,
serviceDisplayName: string ,
status: string ,
createdDate: string ,
modifiedDate: string ,
technicalTicketDetails:
{
resourceId: string ,
}
,
quotaTicketDetails:
{
quotaChangeRequestSubType: string ,
quotaChangeRequestVersion: string ,
quotaChangeRequests:
[
{
region: string ,
payload: string ,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
SupportTickets_Create (new)
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 ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}
{
supportTicketName: string ,
createSupportTicketParameters:
{
id: string ,
name: string ,
type: string ,
properties:
{
supportTicketId: string ,
description: string ,
problemClassificationId: string ,
problemClassificationDisplayName: string ,
severity: enum ,
enrollmentId: string ,
require24X7Response: boolean ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
serviceLevelAgreement:
{
startTime: string ,
expirationTime: string ,
slaMinutes: integer ,
}
,
supportEngineer:
{
emailAddress: string ,
}
,
supportPlanType: string ,
title: string ,
problemStartTime: string ,
serviceId: string ,
serviceDisplayName: string ,
status: string ,
createdDate: string ,
modifiedDate: string ,
technicalTicketDetails:
{
resourceId: string ,
}
,
quotaTicketDetails:
{
quotaChangeRequestSubType: string ,
quotaChangeRequestVersion: string ,
quotaChangeRequests:
[
{
region: string ,
payload: string ,
}
,
]
,
}
,
}
,
}
,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
supportTicketId: string ,
description: string ,
problemClassificationId: string ,
problemClassificationDisplayName: string ,
severity: enum ,
enrollmentId: string ,
require24X7Response: boolean ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
serviceLevelAgreement:
{
startTime: string ,
expirationTime: string ,
slaMinutes: integer ,
}
,
supportEngineer:
{
emailAddress: string ,
}
,
supportPlanType: string ,
title: string ,
problemStartTime: string ,
serviceId: string ,
serviceDisplayName: string ,
status: string ,
createdDate: string ,
modifiedDate: string ,
technicalTicketDetails:
{
resourceId: string ,
}
,
quotaTicketDetails:
{
quotaChangeRequestSubType: string ,
quotaChangeRequestVersion: string ,
quotaChangeRequests:
[
{
region: string ,
payload: string ,
}
,
]
,
}
,
}
,
}

⚐ Response (202)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Communications_CheckNameAvailability (new)
Description :  Check the availability of a resource name. This API should be used to check the uniqueness of the name for adding a new communication to the support ticket.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/checkNameAvailability
{
supportTicketName: string ,
checkNameAvailabilityInput:
{
name: string ,
type: enum ,
}
,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

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

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Communications_List (new)
Description :  Lists all communications (attachments not included) for a support ticket.

You can also filter support ticket communications by _CreatedDate_ or _CommunicationType_ using the $filter parameter. The only type of communication supported today is _Web_. Output will be a paged result with _nextLink_, using which you can retrieve the next set of Communication results.

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 ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications
{
supportTicketName: string ,
$top: integer ,
$filter: string ,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
id: string ,
name: string ,
type: string ,
properties:
{
communicationType: enum ,
communicationDirection: enum ,
sender: string ,
subject: string ,
body: string ,
createdDate: string ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Communications_Get (new)
Description :  Returns communication details for a support ticket.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications/{communicationName}
{
supportTicketName: string ,
communicationName: string ,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
communicationType: enum ,
communicationDirection: enum ,
sender: string ,
subject: string ,
body: string ,
createdDate: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Communications_Create (new)
Description :  Adds a new customer communication to an Azure support ticket.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications/{communicationName}
{
supportTicketName: string ,
communicationName: string ,
createCommunicationParameters:
{
id: string ,
name: string ,
type: string ,
properties:
{
communicationType: enum ,
communicationDirection: enum ,
sender: string ,
subject: string ,
body: string ,
createdDate: string ,
}
,
}
,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
communicationType: enum ,
communicationDirection: enum ,
sender: string ,
subject: string ,
body: string ,
createdDate: string ,
}
,
}

⚐ Response (202)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Operations_List (removed)
Description :  This lists all the available Microsoft Support REST API operations.
Reference :  Link ¶

⚼ Request

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

⚐ Response (200)

{
value:
[
{
name: string ,
display:
{
description: string ,
operation: string ,
provider: string ,
resource: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Services_List (removed)
Description :  Lists all the Azure services available for support ticket creation. For **Technical** issues, select the Service Id that maps to the Azure service/product as displayed in the **Services** drop-down list on the Azure portal's [New support request](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview) page. Always use the service and its corresponding problem classification(s) obtained programmatically for support ticket creation. This practice ensures that you always have the most recent set of service and problem classification Ids.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Support/services
{
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
id: string ,
name: string ,
type: string ,
properties:
{
displayName: string ,
resourceTypes:
[
string ,
]
,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Services_Get (removed)
Description :  Gets a specific Azure service for support ticket creation.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Support/services/{serviceName}
{
serviceName: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
displayName: string ,
resourceTypes:
[
string ,
]
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
ProblemClassifications_List (removed)
Description :  Lists all the problem classifications (categories) available for a specific Azure service. Always use the service and problem classifications obtained programmatically. This practice ensures that you always have the most recent set of service and problem classification Ids.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Support/services/{serviceName}/problemClassifications
{
serviceName: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
id: string ,
name: string ,
type: string ,
properties:
{
displayName: string ,
}
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
ProblemClassifications_Get (removed)
Description :  Get problem classification details for a specific Azure service.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.Support/services/{serviceName}/problemClassifications/{problemClassificationName}
{
serviceName: string ,
problemClassificationName: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
displayName: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
SupportTickets_CheckNameAvailability (removed)
Description :  Check the availability of a resource name. This API should be used to check the uniqueness of the name for support ticket creation for the selected subscription.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/checkNameAvailability
{
checkNameAvailabilityInput:
{
name: string ,
type: enum ,
}
,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

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

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
SupportTickets_List (removed)
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 ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets
{
$top: integer ,
$filter: string ,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
id: string ,
name: string ,
type: string ,
properties:
{
supportTicketId: string ,
description: string ,
problemClassificationId: string ,
problemClassificationDisplayName: string ,
severity: enum ,
enrollmentId: string ,
require24X7Response: boolean ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
serviceLevelAgreement:
{
startTime: string ,
expirationTime: string ,
slaMinutes: integer ,
}
,
supportEngineer:
{
emailAddress: string ,
}
,
supportPlanType: string ,
title: string ,
problemStartTime: string ,
serviceId: string ,
serviceDisplayName: string ,
status: string ,
createdDate: string ,
modifiedDate: string ,
technicalTicketDetails:
{
resourceId: string ,
}
,
quotaTicketDetails:
{
quotaChangeRequestSubType: string ,
quotaChangeRequestVersion: string ,
quotaChangeRequests:
[
{
region: string ,
payload: string ,
}
,
]
,
}
,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
SupportTickets_Get (removed)
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 ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}
{
supportTicketName: string ,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
supportTicketId: string ,
description: string ,
problemClassificationId: string ,
problemClassificationDisplayName: string ,
severity: enum ,
enrollmentId: string ,
require24X7Response: boolean ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
serviceLevelAgreement:
{
startTime: string ,
expirationTime: string ,
slaMinutes: integer ,
}
,
supportEngineer:
{
emailAddress: string ,
}
,
supportPlanType: string ,
title: string ,
problemStartTime: string ,
serviceId: string ,
serviceDisplayName: string ,
status: string ,
createdDate: string ,
modifiedDate: string ,
technicalTicketDetails:
{
resourceId: string ,
}
,
quotaTicketDetails:
{
quotaChangeRequestSubType: string ,
quotaChangeRequestVersion: string ,
quotaChangeRequests:
[
{
region: string ,
payload: string ,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
SupportTickets_Update (removed)
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 ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}
{
supportTicketName: string ,
updateSupportTicket:
{
severity: enum ,
status: enum ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
}
,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
supportTicketId: string ,
description: string ,
problemClassificationId: string ,
problemClassificationDisplayName: string ,
severity: enum ,
enrollmentId: string ,
require24X7Response: boolean ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
serviceLevelAgreement:
{
startTime: string ,
expirationTime: string ,
slaMinutes: integer ,
}
,
supportEngineer:
{
emailAddress: string ,
}
,
supportPlanType: string ,
title: string ,
problemStartTime: string ,
serviceId: string ,
serviceDisplayName: string ,
status: string ,
createdDate: string ,
modifiedDate: string ,
technicalTicketDetails:
{
resourceId: string ,
}
,
quotaTicketDetails:
{
quotaChangeRequestSubType: string ,
quotaChangeRequestVersion: string ,
quotaChangeRequests:
[
{
region: string ,
payload: string ,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
SupportTickets_Create (removed)
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 ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}
{
supportTicketName: string ,
createSupportTicketParameters:
{
id: string ,
name: string ,
type: string ,
properties:
{
supportTicketId: string ,
description: string ,
problemClassificationId: string ,
problemClassificationDisplayName: string ,
severity: enum ,
enrollmentId: string ,
require24X7Response: boolean ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
serviceLevelAgreement:
{
startTime: string ,
expirationTime: string ,
slaMinutes: integer ,
}
,
supportEngineer:
{
emailAddress: string ,
}
,
supportPlanType: string ,
title: string ,
problemStartTime: string ,
serviceId: string ,
serviceDisplayName: string ,
status: string ,
createdDate: string ,
modifiedDate: string ,
technicalTicketDetails:
{
resourceId: string ,
}
,
quotaTicketDetails:
{
quotaChangeRequestSubType: string ,
quotaChangeRequestVersion: string ,
quotaChangeRequests:
[
{
region: string ,
payload: string ,
}
,
]
,
}
,
}
,
}
,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
supportTicketId: string ,
description: string ,
problemClassificationId: string ,
problemClassificationDisplayName: string ,
severity: enum ,
enrollmentId: string ,
require24X7Response: boolean ,
contactDetails:
{
firstName: string ,
lastName: string ,
preferredContactMethod: enum ,
primaryEmailAddress: string ,
additionalEmailAddresses:
[
string ,
]
,
phoneNumber: string ,
preferredTimeZone: string ,
country: string ,
preferredSupportLanguage: string ,
}
,
serviceLevelAgreement:
{
startTime: string ,
expirationTime: string ,
slaMinutes: integer ,
}
,
supportEngineer:
{
emailAddress: string ,
}
,
supportPlanType: string ,
title: string ,
problemStartTime: string ,
serviceId: string ,
serviceDisplayName: string ,
status: string ,
createdDate: string ,
modifiedDate: string ,
technicalTicketDetails:
{
resourceId: string ,
}
,
quotaTicketDetails:
{
quotaChangeRequestSubType: string ,
quotaChangeRequestVersion: string ,
quotaChangeRequests:
[
{
region: string ,
payload: string ,
}
,
]
,
}
,
}
,
}

⚐ Response (202)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Communications_CheckNameAvailability (removed)
Description :  Check the availability of a resource name. This API should be used to check the uniqueness of the name for adding a new communication to the support ticket.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/checkNameAvailability
{
supportTicketName: string ,
checkNameAvailabilityInput:
{
name: string ,
type: enum ,
}
,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

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

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Communications_List (removed)
Description :  Lists all communications (attachments not included) for a support ticket.

You can also filter support ticket communications by _CreatedDate_ or _CommunicationType_ using the $filter parameter. The only type of communication supported today is _Web_. Output will be a paged result with _nextLink_, using which you can retrieve the next set of Communication results.

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 ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications
{
supportTicketName: string ,
$top: integer ,
$filter: string ,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
value:
[
{
id: string ,
name: string ,
type: string ,
properties:
{
communicationType: enum ,
communicationDirection: enum ,
sender: string ,
subject: string ,
body: string ,
createdDate: string ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Communications_Get (removed)
Description :  Returns communication details for a support ticket.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications/{communicationName}
{
supportTicketName: string ,
communicationName: string ,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
communicationType: enum ,
communicationDirection: enum ,
sender: string ,
subject: string ,
body: string ,
createdDate: string ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}
Communications_Create (removed)
Description :  Adds a new customer communication to an Azure support ticket.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications/{communicationName}
{
supportTicketName: string ,
communicationName: string ,
createCommunicationParameters:
{
id: string ,
name: string ,
type: string ,
properties:
{
communicationType: enum ,
communicationDirection: enum ,
sender: string ,
subject: string ,
body: string ,
createdDate: string ,
}
,
}
,
subscriptionId: string ,
api-version: string ,
}

⚐ Response (200)

{
id: string ,
name: string ,
type: string ,
properties:
{
communicationType: enum ,
communicationDirection: enum ,
sender: string ,
subject: string ,
body: string ,
createdDate: string ,
}
,
}

⚐ Response (202)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
code: string ,
message: string ,
target: string ,
}
,
]
,
}
,
}