az support tickets

Note

This reference is part of the support extension for the Azure CLI (version 2.0.81 or higher). The extension will automatically install the first time you run an az support tickets command. Learn more about extensions.

Create and manage Azure support ticket.

Commands

Name Description Type Status
az support tickets communications

Manage support ticket communications.

Extension GA
az support tickets communications create

Adds a new customer communication to an Azure support ticket.

Extension GA
az support tickets communications list

Lists all communications (attachments not included) for a support ticket.

Extension GA
az support tickets communications show

Gets communication details for a support ticket.

Extension GA
az support tickets create

Creates a new support ticket for Quota increase, Technical, Billing, and Subscription Management issues for the specified subscription.

Extension GA
az support tickets list

Lists all the support tickets for an Azure subscription.

Extension GA
az support tickets show

Gets support ticket details for an Azure subscription.

Extension GA
az support tickets update

Updates severity level, status and customer contact information for a support ticket.

Extension GA

az support tickets create

Creates a new support ticket for Quota increase, Technical, Billing, and Subscription Management issues for the specified subscription.

az support tickets create --contact-country
                          --contact-email
                          --contact-first-name
                          --contact-language
                          --contact-last-name
                          --contact-method {email, phone}
                          --contact-timezone
                          --description
                          --problem-classification
                          --severity {critical, highestcriticalimpact, minimal, moderate}
                          --ticket-name
                          --title
                          [--contact-additional-emails]
                          [--contact-phone-number]
                          [--partner-tenant-id]
                          [--quota-change-payload]
                          [--quota-change-regions]
                          [--quota-change-subtype]
                          [--quota-change-version]
                          [--require-24-by-7-response {false, true}]
                          [--start-time]
                          [--technical-resource]

Examples

Create a ticket for Billing related issues.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "BillingTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/BillingServiceNameGuid/problemClassifications/BillingProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "BillingTestTicketName" \
  --title "BillingTicketTitle"

Create a ticket for Subscription Management related issues.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "SubMgmtTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/SubMgmtServiceNameGuid/problemClassifications/SubMgmtProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "SubMgmtTestTicketName" \
  --title "SubMgmtTicketTitle"

Create a ticket for Technical issue related to a specific resource.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "TechnicalTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/TechnicalServiceNameGuid/problemClassifications/TechnicalProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "TechnicalTestTicketName" \
  --title "TechnicalTicketTitle" \
  --contact-additional-emails "xyz@contoso.com" "devs@contoso.com" \
  --technical-resource "/subscriptions/SubscriptionGuid/resourceGroups/RgName/providers/Microsoft.Compute/virtualMachines/RName"

Create a ticket for Billing related issues in admin on behalf of (AOBO) mode.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "BillingTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/BillingServiceNameGuid/problemClassifications/BillingProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "BillingTestTicketName" \
  --title "BillingTicketTitle" \
  --partner-tenant-id "CSPPartnerTenantIdGuid"

Create a ticket for Generic Quota increase for any Azure Service.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/GenericProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle"

Create a ticket to request Quota increase for Compute VM Cores.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/CoresQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"SKU\":\"DSv3 Series\", \"NewLimit\":104}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0"

Create a ticket to request Quota increase for Low-priority cores for a Batch account.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/BatchQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"AccountName\":\"test\", \"NewLimit\":200, \"Type\":\"LowPriority\"}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0" \
  --quota-change-subtype "Account"

Create a ticket to request Quota increase for specific VM family cores for a Batch account.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/BatchQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"AccountName\":\"test\", \"VMFamily\":\"standardA0_A7Family\", \"NewLimit\":200, \"Type\":\"Dedicated\"}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0" \
  --quota-change-subtype "Account"

Create a ticket to request Quota increase for Pools for a Batch account.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/BatchQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"AccountName\":\"test\", \"NewLimit\":200, \"Type\":\"Pools\"}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0" \
  --quota-change-subtype "Account"

Create a ticket to request Quota increase for Active Jobs and Job Schedules for a Batch account.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/BatchQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"AccountName\":\"test\", \"NewLimit\":200, \"Type\":\"Jobs\"}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0" \
  --quota-change-subtype "Account"

Create a ticket to request Quota increase for number of Batch accounts for a subscription.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/BatchQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"NewLimit\":200, \"Type\":\"Account\"}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0" \
  --quota-change-subtype "Subscription"

Create a ticket to request Quota increase for DTUs for SQL Database.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/SqlDatabaseQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"ServerName\":\"testserver\", \"NewLimit\":54000}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0" \
  --quota-change-subtype "DTUs"

Create a ticket to request Quota increase for Servers for SQL Database.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/SqlDatabaseQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"NewLimit\":54000}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0" \
  --quota-change-subtype "Servers"

Create a ticket to request Quota increase for DTUs for SQL Data Warehouse.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/SqlDataWarehouseQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"ServerName\":\"testserver\", \"NewLimit\":54000}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0" \
  --quota-change-subtype "DTUs"

Create a ticket to request Quota increase for Servers for SQL Data Warehouse.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/SqlDataWarehouseQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"NewLimit\":200}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0" \
  --quota-change-subtype "Servers"

Create a ticket to request Quota increase for specific VM family cores for Machine Learning service.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/MachineLearningQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"VMFamily\":\"standardA0_A7Family\", \"NewLimit\":200, \"Type\":\"Dedicated\"}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0" \
  --quota-change-subtype "BatchAml"

Create a ticket to request Quota increase for Low-priority cores for Machine Learning service.

az support tickets create \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "email" \
  --contact-timezone "Pacific Standard Time" \
  --description "QuotaTicketDescription" \
  --problem-classification "/providers/Microsoft.Support/services/QuotaServiceNameGuid/problemClassifications/MachineLearningQuotaProblemClassificationNameGuid" \
  --severity "minimal" \
  --ticket-name "QuotaTestTicketName" \
  --title "QuotaTicketTitle" \
  --quota-change-payload "{\"NewLimit\":200, \"Type\":\"LowPriority\"}" \
  --quota-change-regions "EastUS" \
  --quota-change-version "1.0" \
  --quota-change-subtype "BatchAml"

Required Parameters

--contact-country

Country of the user. This is the ISO Alpha-3 code.

--contact-email

Primary email address.

--contact-first-name

First Name.

--contact-language

Preferred language of support from Azure. Support languages vary based on the severity you choose for your support ticket. This is the standard country-language code.

--contact-last-name

Last Name.

--contact-method

Preferred contact method.

accepted values: email, phone
--contact-timezone

Time zone of the user. This is the name of the time zone from Microsoft Time Zone Index Values.

--description

Detailed description of the question or issue.

--problem-classification

Each Azure service has its own set of issue category called problem classification that corresponds to the type of problem you are experiencing. This parameter is the resource id of ProblemClassification resource.

--severity

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.

accepted values: critical, highestcriticalimpact, minimal, moderate
--ticket-name

Support ticket name.

--title

Title of the support ticket.

Optional Parameters

--contact-additional-emails

Space-separated list of additional email addresses. Additional email addresses will be copied on any correspondence about the support ticket.

--contact-phone-number

Phone number. This is required if preferred contact method is phone.

--partner-tenant-id

Partner tenant id for Admin On Behalf of (AOBO) scenario. In addition to logging in to the customer tenant, logging in to the partner tenant (PT) using "az login -t PT --allow-no-subscriptions" is required.

--quota-change-payload

Space -separated list of serialized payload of the quota increase request corresponding to regions. Visit https://aka.ms/supportrpquotarequestpayload for details.

--quota-change-regions

Space-separated list of region for which the quota increase request is being made.

--quota-change-subtype

Required for certain quota types when there is a sub type that you are requesting quota increase for. Example: Batch.

--quota-change-version

Quota change request version.

--require-24-by-7-response

Indicates if this requires a 24x7 response from Azure. Default is false.

accepted values: false, true
--start-time

Time in UTC datetime (Y-m-d'T'H:M:S'Z') when the problem started. Default is today.

--technical-resource

This is the resource id of the Azure service resource for which the support ticket is created.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az support tickets list

Lists all the support tickets for an Azure subscription.

az support tickets list [--filters]

Examples

List support tickets for a subscription.

az support tickets list

List support tickets in open state for a subscription.

az support tickets list --filters "Status eq 'Open'"

List support tickets created on or after a certain date and in open state for a subscription.

az support tickets list --filters "CreatedDate ge 2020-01-01 and Status eq 'Open'"

Optional Parameters

--filters

The filter to apply on the operation. We support OData v4.0 semtantics. Filter can be specified on "Status" property using eq operator or on "CreatedDate" using gt/ge. To combine both filters, use the logical and operator. Default is CreatedDate >= one week.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az support tickets show

Gets support ticket details for an Azure subscription.

az support tickets show --ticket-name

Examples

Get details of a subscription ticket.

az support tickets show --ticket-name "TestTicketName"

Required Parameters

--ticket-name

Support ticket name.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az support tickets update

Updates severity level, status and customer contact information for a support ticket.

az support tickets update --ticket-name
                          [--contact-additional-emails]
                          [--contact-country]
                          [--contact-email]
                          [--contact-first-name]
                          [--contact-language]
                          [--contact-last-name]
                          [--contact-method {email, phone}]
                          [--contact-phone-number]
                          [--contact-timezone]
                          [--severity {critical, highestcriticalimpact, minimal, moderate}]
                          [--status {closed, open}]

Examples

Update support ticket severity.

az support tickets update --ticket-name "TestTicketName" --severity "moderate"

Update support ticket status.

az support tickets update --ticket-name "TestTicketName" --status "closed"

Update support ticket customer contact details properties.

az support tickets update --ticket-name "TestTicketName" \
  --contact-additional-emails "xyz@contoso.com" "devs@contoso.com" \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "phone" \
  --contact-phone-number "123-456-7890" \
  --contact-timezone "Pacific Standard Time"

Update support ticket severity, status and customer contact details properties.

az support tickets update --ticket-name "TestTicketName" \
  --status "open" \
  --contact-additional-emails "xyz@contoso.com" "devs@contoso.com" \
  --contact-country "USA" \
  --contact-email "abc@contoso.com" \
  --contact-first-name "Foo" \
  --contact-language "en-US" \
  --contact-last-name "Bar" \
  --contact-method "phone" \
  --contact-phone-number "123-456-7890" \
  --contact-timezone "Pacific Standard Time" \
  --severity "moderate"

Required Parameters

--ticket-name

Support ticket name.

Optional Parameters

--contact-additional-emails

Space-separated list of additional email addresses. Additional email addresses will be copied on any correspondence about the support ticket.

--contact-country

Country of the user. This is the ISO Alpha-3 code.

--contact-email

Primary email address.

--contact-first-name

First Name.

--contact-language

Preferred language of support from Azure. Support languages vary based on the severity you choose for your support ticket. This is the standard country-language code.

--contact-last-name

Last Name.

--contact-method

Preferred contact method.

accepted values: email, phone
--contact-phone-number

Phone number. This is required if preferred contact method is phone.

--contact-timezone

Time zone of the user. This is the name of the time zone from Microsoft Time Zone Index Values.

--severity

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.

accepted values: critical, highestcriticalimpact, minimal, moderate
--status

Status to be updated on the ticket.

accepted values: closed, open
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.