Support Tickets - Get
取得 Azure 訂閱的工單詳情。 支援票證數據可在票證建立后的18個月內取得。 如果票證是在18個多月前建立的,則要求數據可能會導致錯誤。
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}?api-version=2026-07-01
URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
subscription
|
path | True |
string (uuid) |
目標訂用帳戶的標識碼。 此值必須是 UUID。 |
|
support
|
path | True |
string |
SupportTicketDetails 的名稱 |
|
api-version
|
query | True |
string minLength: 1 |
用於此作業的 API 版本。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
Azure 運作順利完成。 |
|
| Other Status Codes |
未預期的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
| 名稱 | Description |
|---|---|
| user_impersonation | 冒用您的使用者帳戶 |
範例
Get details of a subscription ticket
範例要求
GET https://management.azure.com/subscriptions/132d901f-189d-4381-9214-fe68e27e05a1/providers/Microsoft.Support/supportTickets/testticket?api-version=2026-07-01
範例回覆
{
"name": "testticket",
"type": "Microsoft.Support/supportTickets",
"id": "/subscriptions/132d901f-189d-4381-9214-fe68e27e05a1/providers/Microsoft.Support/supportTickets/testticket",
"properties": {
"description": "This is a test - please ignore",
"advancedDiagnosticConsent": "No",
"communityForumPost": "https://learn.microsoft.com/en-us/answers/questions/2283704/unverified-app-listed-under-applications-from-pers",
"contactDetails": {
"country": "USA",
"firstName": "abc",
"lastName": "xyz",
"preferredContactMethod": "email",
"preferredSupportLanguage": "en-US",
"preferredTimeZone": "Pacific Standard Time",
"primaryEmailAddress": "abc@contoso.com"
},
"createdDate": "2020-03-20T21:36:18Z",
"directConnectEscalation": {
"azureEEStatus": "EscalationUnavailable"
},
"fileWorkspaceName": "6f16735c-1530836f-e9970f1a-2e49-47b7-96cd-9746b83aa066",
"modifiedDate": "2020-03-20T21:36:23Z",
"problemClassificationDisplayName": "Add or Edit VAT, TAX ID, or PO Number",
"problemClassificationId": "/providers/Microsoft.Support/services/subscription_management_service_guid/problemClassifications/problemClassification_guid",
"require24X7Response": false,
"serviceDisplayName": "Subscription management",
"serviceId": "/providers/Microsoft.Support/services/subscription_management_service_guid",
"serviceLevelAgreement": {
"expirationTime": "2020-03-21T17:36:18Z",
"slaMinutes": 240,
"startTime": "2020-03-20T21:36:18Z"
},
"severity": "minimal",
"status": "Open",
"supportEngineer": {
"emailAddress": "xyz@contoso.com"
},
"supportPlanDisplayName": "Premier",
"supportPlanId": "U291cmNlOlNDTSxDbGFyaWZ5SW5zdGFsbGF0aW9uU2l0ZUlkOjcsTGluZUl0ZW1JZDo5ODY1NzIyOSxDb250cmFjdElkOjk4NjU5MTk0LFN1YnNjcmlwdGlvbklkOjc2Y2I3N2ZhLThiMTctNGVhYi05NDkzLWI2NWRhY2U5OTgxMyw=",
"supportPlanType": "Premier",
"supportTicketId": "118032014183770",
"title": "Test - please ignore",
"supportChannel": "Email",
"chatConversationStatus": "None"
}
}
定義
| 名稱 | Description |
|---|---|
|
Chat |
與客服工單相關的聊天對話狀態。 |
| Consent |
在支援票證上更新進階診斷同意。 |
|
Contact |
與支援票證相關聯的連絡資訊。 |
|
created |
建立此資源的身分識別類型。 |
|
Direct |
支援單的直接連線升級細節。 |
|
Error |
資源管理錯誤其他資訊。 |
|
Error |
錯誤詳細資料。 |
|
Error |
錯誤回應 |
|
Escalation |
直接連線升級狀態。 |
|
Is |
此屬性表示支援票證是否為暫時票證。 |
|
Preferred |
慣用的連絡方法。 |
|
Quota |
提供區域和新的配額限制需要這個屬性。 |
|
Quota |
某些配額類型增加支援票證所需的額外資訊集,例如:虛擬機核心。 取得配額承載支援要求的完整詳細數據,以及 支援配額要求的範例。 |
|
Secondary |
此屬性表示支援票證的次要同意。 |
|
Service |
支援票證的服務等級協議詳細數據。 |
|
Severity |
值,指出案例的緊迫性,接著會根據您與 Azure 擁有之技術支援方案的服務等級協議來決定回應時間。 注意:「最高重大影響」,也稱為 Azure 入口網站中的「緊急 - 嚴重影響」層級,只會保留給進階客戶。 |
|
Support |
支援工單的支援頻道類型。 |
|
Support |
支持工程師資訊。 |
|
Support |
代表 SupportTicketDetails 資源的物件。 |
|
system |
與建立和上次修改資源相關的元數據。 |
|
Technical |
技術支援票證的其他資訊。 |
|
User |
提供的使用者同意值 |
ChatConversationStatus
與客服工單相關的聊天對話狀態。
| 值 | Description |
|---|---|
| Active |
聊天聊天目前仍在進行中。 |
| Closed |
聊天對話已關閉。 |
Consent
在支援票證上更新進階診斷同意。
| 值 | Description |
|---|---|
| Yes | |
| No |
ContactProfile
與支援票證相關聯的連絡資訊。
| 名稱 | 類型 | Description |
|---|---|---|
| additionalEmailAddresses |
string[] |
系統會在任何有關支援票證的信件上複製列出的其他電子郵件位址。 |
| country |
string |
用戶的國家/地區。 這是 ISO 3166-1 alpha-3 程式代碼。 |
| firstName |
string |
名字。 |
| lastName |
string |
姓。 |
| phoneNumber |
string |
電話號碼。 如果慣用的連絡方法是電話,則需要此專案。 提交「重大」或「最高關鍵」嚴重性案例時,也需要此案例。 |
| preferredContactMethod |
慣用的連絡方法。 |
|
| preferredSupportLanguage |
string |
Azure 中慣用的支持語言。 支援語言會根據您為支援票證選擇的嚴重性而有所不同。 若要深入瞭解,請參閱 Azure 嚴重性和回應性。 使用標準語言國家/地區代碼。 有效值為英文的 『en-us』、適用於中文的 『zh-hans』、西班牙文的 『es-es』fr-fr』、日文的『ja-jp』、韓文的『ko-kr』、俄文的『ru-ru』、葡萄牙文的『pt-br』、義大利文的『it-it』、中文的『zh-tw』、德文的『de-de』。 |
| preferredTimeZone |
string |
用戶的時區。 這是時區 Microsoft時區索引值的名稱。 |
| primaryEmailAddress |
string |
主要電子郵件位址。 |
createdByType
建立此資源的身分識別類型。
| 值 | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DirectConnectEscalation
支援單的直接連線升級細節。
| 名稱 | 類型 | Description |
|---|---|---|
| allowedSeverities |
一個包含直接連線升級允許嚴重度的陣列。 |
|
| azureEEStatus |
直接連線升級狀態。 |
|
| reasonForEscalation |
string |
升級的原因/業務影響。 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
| 名稱 | 類型 | Description |
|---|---|---|
| info |
object |
其他資訊。 |
| type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細資料。
| 名稱 | 類型 | Description |
|---|---|---|
| additionalInfo |
錯誤的其他資訊。 |
|
| code |
string |
錯誤碼。 |
| details |
錯誤詳情 |
|
| message |
string |
錯誤訊息。 |
| target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
| 名稱 | 類型 | Description |
|---|---|---|
| error |
error 物件。 |
EscalationStatus
直接連線升級狀態。
| 值 | Description |
|---|---|
| EscalationAvailable |
升級服務是可行且未被啟動的 |
| EscalationInitiated |
升級服務無法啟動,已啟動 |
| EscalationProcessed |
升級無法使用,且在啟動後已完成處理 |
| EscalationUnsupported |
由於本產品或主題不支援直接升級,無法啟動升級服務 |
| EscalationUnavailable |
由於客戶未直接註冊升級,無法啟動升級服務 |
IsTemporaryTicket
此屬性表示支援票證是否為暫時票證。
| 值 | Description |
|---|---|
| Yes | |
| No |
PreferredContactMethod
慣用的連絡方法。
| 值 | Description |
|---|---|
| phone |
QuotaChangeRequest
提供區域和新的配額限制需要這個屬性。
| 名稱 | 類型 | Description |
|---|---|---|
| payload |
string |
增加配額要求的承載。 |
| region |
string |
正在提出配額增加要求的區域。 |
QuotaTicketDetails
某些配額類型增加支援票證所需的額外資訊集,例如:虛擬機核心。 取得配額承載支援要求的完整詳細數據,以及 支援配額要求的範例。
| 名稱 | 類型 | Description |
|---|---|---|
| quotaChangeRequestSubType |
string |
當您要求增加配額時,某些配額類型需要某些配額類型,例如 Batch。 |
| quotaChangeRequestVersion |
string |
配額變更要求版本。 |
| quotaChangeRequests |
提供區域和新的配額限制需要這個屬性。 |
SecondaryConsent
此屬性表示支援票證的次要同意。
| 名稱 | 類型 | Description |
|---|---|---|
| type |
string |
提供次要同意的服務名稱。 值必須從問題分類 API 回應中擷取。 |
| userConsent |
提供的使用者同意值 |
ServiceLevelAgreement
支援票證的服務等級協議詳細數據。
| 名稱 | 類型 | Description |
|---|---|---|
| expirationTime |
string (date-time) |
服務等級協定到期時,UTC 時間(ISO 8601 格式)。 |
| slaMinutes |
integer (int32) |
服務等級協定以分鐘為單位。 |
| startTime |
string (date-time) |
服務等級協議啟動時的時間 UTC (ISO 8601 格式)。 |
SeverityLevel
值,指出案例的緊迫性,接著會根據您與 Azure 擁有之技術支援方案的服務等級協議來決定回應時間。 注意:「最高重大影響」,也稱為 Azure 入口網站中的「緊急 - 嚴重影響」層級,只會保留給進階客戶。
| 值 | Description |
|---|---|
| minimal | |
| moderate | |
| critical | |
| highestcriticalimpact |
SupportChannel
支援工單的支援頻道類型。
| 值 | Description |
|---|---|
| Chat |
聊天支援頻道。 |
| Web |
網路支援頻道。 |
SupportEngineer
支持工程師資訊。
| 名稱 | 類型 | Description |
|---|---|---|
| emailAddress |
string |
指派給支援票證的 Azure 支援工程師電子郵件位址。 |
SupportTicketDetails
代表 SupportTicketDetails 資源的物件。
| 名稱 | 類型 | Description |
|---|---|---|
| id |
string (arm-id) |
資源的完整資源標識碼。 例如,“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}” |
| name |
string |
資源的名稱 |
| properties.advancedDiagnosticConsent |
在支援票證上更新進階診斷同意。 |
|
| properties.chatConversationStatus |
與客服工單相關的聊天對話狀態。 |
|
| properties.communityForumPost |
string |
包含社群論壇貼文連結。 |
| properties.contactDetails |
要求建立支援票證之使用者的連絡資訊。 |
|
| properties.createdDate |
string (date-time) |
建立支援票證的時間 UTC (ISO 8601 格式)。 |
| properties.description |
string |
問題或問題的詳細描述。 |
| properties.directConnectEscalation |
支援單的直接連線升級細節。 |
|
| properties.enrollmentId |
string |
與支援票證相關聯的註冊標識碼。 |
| properties.fileWorkspaceName |
string |
檔案工作區名稱。 |
| properties.isTemporaryTicket |
此屬性表示支援票證是否為暫時票證。 |
|
| properties.modifiedDate |
string (date-time) |
上次修改支援票證的時間 UTC (ISO 8601 格式)。 |
| properties.problemClassificationDisplayName |
string |
問題分類的當地語系化名稱。 |
| properties.problemClassificationId |
string |
每個 Azure 服務都有自己的一組問題類別,也稱為問題分類。 此參數是您遇到的問題類型的唯一標識碼。 |
| properties.problemScopingQuestions |
string |
問題範圍界定與支援票證相關聯的問題。 |
| properties.problemStartTime |
string (date-time) |
問題開始時的 UTC 時間(ISO 8601 格式)。 |
| properties.quotaTicketDetails |
與配額支援票證要求相關聯的其他票證詳細數據。 |
|
| properties.require24X7Response |
boolean |
指出這是否需要來自 Azure 的 24x7 回應。 |
| properties.secondaryConsent |
此屬性表示支援票證的次要同意 |
|
| properties.serviceDisplayName |
string |
Azure 服務的當地語系化名稱。 |
| properties.serviceId |
string |
這是與支援票證相關聯的 Azure 服務資源資源資源標識碼。 |
| properties.serviceLevelAgreement |
此支援票證的服務等級協議資訊。 |
|
| properties.severity |
值,指出案例的緊迫性,接著會根據您與 Azure 擁有之技術支援方案的服務等級協議來決定回應時間。 注意:「最高重大影響」,也稱為 Azure 入口網站中的「緊急 - 嚴重影響」層級,只會保留給進階客戶。 |
|
| properties.status |
string |
支援票證的狀態。 |
| properties.supportChannel |
支援工單的支援頻道類型。 |
|
| properties.supportEngineer |
支持工程師在此支援票證上工作的相關信息。 |
|
| properties.supportPlanDisplayName |
string |
與支援票證相關聯的支援方案類型。 |
| properties.supportPlanId |
string |
與支援票證相關聯的支援方案標識碼。 |
| properties.supportPlanType |
string |
與支援票證相關聯的支援方案類型。 |
| properties.supportTicketId |
string |
系統產生的支援票證標識碼是唯一的。 |
| properties.technicalTicketDetails |
與技術支援票證要求相關聯的其他票證詳細數據。 |
|
| properties.title |
string |
支援票證的標題。 |
| systemData |
包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。 |
|
| type |
string |
資源的類型。 例如:「Microsoft.Compute/virtualMachines」或「Microsoft.Storage/storageAccounts」 |
systemData
與建立和上次修改資源相關的元數據。
| 名稱 | 類型 | Description |
|---|---|---|
| createdAt |
string (date-time) |
資源建立的時間戳(UTC)。 |
| createdBy |
string |
建立此資源的身分。 |
| createdByType |
建立此資源的身分識別類型。 |
|
| lastModifiedAt |
string (date-time) |
上次修改的資源時間戳 (UTC) |
| lastModifiedBy |
string |
上次修改資源的身分識別。 |
| lastModifiedByType |
上次修改資源的身分識別類型。 |
TechnicalTicketDetails
技術支援票證的其他資訊。
| 名稱 | 類型 | Description |
|---|---|---|
| resourceId |
string |
這是 Azure 服務資源的資源識別碼(例如:建立支援票證的虛擬機資源或 HDInsight 資源)。 |
UserConsent
提供的使用者同意值
| 值 | Description |
|---|---|
| Yes | |
| No |