Support Tickets - Get

Hizmet:

Support

API Sürümü:

2024-04-01

Azure aboneliği için bilet ayrıntılarını alın. Destek bileti verileri, bilet oluşturulduktan sonra 18 ay boyunca kullanılabilir. 18 aydan uzun bir süre önce bir bilet oluşturulduysa, veri isteği hataya neden olabilir.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}?api-version=2024-04-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
supportTicketName	path	True	string	Destek bileti adı.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	SupportTicketDetails	Destek bileti başarıyla alındı.
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Get details of a subscription ticket

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/132d901f-189d-4381-9214-fe68e27e05a1/providers/Microsoft.Support/supportTickets/testticket?api-version=2024-04-01

Java

/**
 * Samples for SupportTickets Get.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/support/resource-manager/Microsoft.Support/stable/2024-04-01/examples/
     * GetSubscriptionSupportTicketDetails.json
     */
    /**
     * Sample code: Get details of a subscription ticket.
     * 
     * @param manager Entry point to SupportManager.
     */
    public static void getDetailsOfASubscriptionTicket(com.azure.resourcemanager.support.SupportManager manager) {
        manager.supportTickets().getWithResponse("testticket", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.support import MicrosoftSupport

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-support
# USAGE
    python get_subscription_support_ticket_details.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = MicrosoftSupport(
        credential=DefaultAzureCredential(),
        subscription_id="132d901f-189d-4381-9214-fe68e27e05a1",
    )

    response = client.support_tickets.get(
        support_ticket_name="testticket",
    )
    print(response)


# x-ms-original-file: specification/support/resource-manager/Microsoft.Support/stable/2024-04-01/examples/GetSubscriptionSupportTicketDetails.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armsupport_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/support/armsupport"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/106483d9f698ac3b6c0d481ab0c5fab14152e21f/specification/support/resource-manager/Microsoft.Support/stable/2024-04-01/examples/GetSubscriptionSupportTicketDetails.json
func ExampleTicketsClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsupport.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewTicketsClient().Get(ctx, "testticket", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.TicketDetails = armsupport.TicketDetails{
	// 	Name: to.Ptr("testticket"),
	// 	Type: to.Ptr("Microsoft.Support/supportTickets"),
	// 	ID: to.Ptr("/subscriptions/132d901f-189d-4381-9214-fe68e27e05a1/providers/Microsoft.Support/supportTickets/testticket"),
	// 	Properties: &armsupport.TicketDetailsProperties{
	// 		Description: to.Ptr("This is a test - please ignore"),
	// 		AdvancedDiagnosticConsent: to.Ptr(armsupport.ConsentNo),
	// 		ContactDetails: &armsupport.ContactProfile{
	// 			Country: to.Ptr("USA"),
	// 			FirstName: to.Ptr("abc"),
	// 			LastName: to.Ptr("xyz"),
	// 			PreferredContactMethod: to.Ptr(armsupport.PreferredContactMethodEmail),
	// 			PreferredSupportLanguage: to.Ptr("en-US"),
	// 			PreferredTimeZone: to.Ptr("Pacific Standard Time"),
	// 			PrimaryEmailAddress: to.Ptr("abc@contoso.com"),
	// 		},
	// 		CreatedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-03-20T21:36:18.000Z"); return t}()),
	// 		FileWorkspaceName: to.Ptr("6f16735c-1530836f-e9970f1a-2e49-47b7-96cd-9746b83aa066"),
	// 		ModifiedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-03-20T21:36:23.000Z"); return t}()),
	// 		ProblemClassificationDisplayName: to.Ptr("Add or Edit VAT, TAX ID, or PO Number"),
	// 		ProblemClassificationID: to.Ptr("/providers/Microsoft.Support/services/subscription_management_service_guid/problemClassifications/problemClassification_guid"),
	// 		Require24X7Response: to.Ptr(false),
	// 		ServiceDisplayName: to.Ptr("Subscription management"),
	// 		ServiceID: to.Ptr("/providers/Microsoft.Support/services/subscription_management_service_guid"),
	// 		ServiceLevelAgreement: &armsupport.ServiceLevelAgreement{
	// 			ExpirationTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-03-21T17:36:18.000Z"); return t}()),
	// 			SLAMinutes: to.Ptr[int32](240),
	// 			StartTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-03-20T21:36:18.000Z"); return t}()),
	// 		},
	// 		Severity: to.Ptr(armsupport.SeverityLevelMinimal),
	// 		Status: to.Ptr("Open"),
	// 		SupportEngineer: &armsupport.Engineer{
	// 			EmailAddress: to.Ptr("xyz@contoso.com"),
	// 		},
	// 		SupportPlanDisplayName: to.Ptr("Premier"),
	// 		SupportPlanID: to.Ptr("U291cmNlOlNDTSxDbGFyaWZ5SW5zdGFsbGF0aW9uU2l0ZUlkOjcsTGluZUl0ZW1JZDo5ODY1NzIyOSxDb250cmFjdElkOjk4NjU5MTk0LFN1YnNjcmlwdGlvbklkOjc2Y2I3N2ZhLThiMTctNGVhYi05NDkzLWI2NWRhY2U5OTgxMyw="),
	// 		SupportPlanType: to.Ptr("Premier"),
	// 		SupportTicketID: to.Ptr("118032014183770"),
	// 		Title: to.Ptr("Test - please ignore"),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { MicrosoftSupport } = require("@azure/arm-support");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to 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.
 *
 * @summary 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.
 * x-ms-original-file: specification/support/resource-manager/Microsoft.Support/stable/2024-04-01/examples/GetSubscriptionSupportTicketDetails.json
 */
async function getDetailsOfASubscriptionTicket() {
  const subscriptionId =
    process.env["SUPPORT_SUBSCRIPTION_ID"] || "132d901f-189d-4381-9214-fe68e27e05a1";
  const supportTicketName = "testticket";
  const credential = new DefaultAzureCredential();
  const client = new MicrosoftSupport(credential, subscriptionId);
  const result = await client.supportTickets.get(supportTicketName);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Support.Models;
using Azure.ResourceManager.Support;

// Generated from example definition: specification/support/resource-manager/Microsoft.Support/stable/2024-04-01/examples/GetSubscriptionSupportTicketDetails.json
// this example is just showing the usage of "SupportTickets_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SubscriptionSupportTicketResource created on azure
// for more information of creating SubscriptionSupportTicketResource, please refer to the document of SubscriptionSupportTicketResource
string subscriptionId = "132d901f-189d-4381-9214-fe68e27e05a1";
string supportTicketName = "testticket";
ResourceIdentifier subscriptionSupportTicketResourceId = SubscriptionSupportTicketResource.CreateResourceIdentifier(subscriptionId, supportTicketName);
SubscriptionSupportTicketResource subscriptionSupportTicket = client.GetSubscriptionSupportTicketResource(subscriptionSupportTicketResourceId);

// invoke the operation
SubscriptionSupportTicketResource result = await subscriptionSupportTicket.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SupportTicketData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Örnek yanıt

Durum kodu:

200

{
  "id": "/subscriptions/132d901f-189d-4381-9214-fe68e27e05a1/providers/Microsoft.Support/supportTickets/testticket",
  "name": "testticket",
  "type": "Microsoft.Support/supportTickets",
  "properties": {
    "supportTicketId": "118032014183770",
    "description": "This is a test - please ignore",
    "problemClassificationId": "/providers/Microsoft.Support/services/subscription_management_service_guid/problemClassifications/problemClassification_guid",
    "problemClassificationDisplayName": "Add or Edit VAT, TAX ID, or PO Number",
    "severity": "minimal",
    "require24X7Response": false,
    "advancedDiagnosticConsent": "No",
    "supportPlanId": "U291cmNlOlNDTSxDbGFyaWZ5SW5zdGFsbGF0aW9uU2l0ZUlkOjcsTGluZUl0ZW1JZDo5ODY1NzIyOSxDb250cmFjdElkOjk4NjU5MTk0LFN1YnNjcmlwdGlvbklkOjc2Y2I3N2ZhLThiMTctNGVhYi05NDkzLWI2NWRhY2U5OTgxMyw=",
    "fileWorkspaceName": "6f16735c-1530836f-e9970f1a-2e49-47b7-96cd-9746b83aa066",
    "contactDetails": {
      "firstName": "abc",
      "lastName": "xyz",
      "preferredContactMethod": "email",
      "primaryEmailAddress": "abc@contoso.com",
      "preferredTimeZone": "Pacific Standard Time",
      "country": "USA",
      "preferredSupportLanguage": "en-US"
    },
    "serviceLevelAgreement": {
      "startTime": "2020-03-20T21:36:18Z",
      "expirationTime": "2020-03-21T17:36:18Z",
      "slaMinutes": 240
    },
    "supportEngineer": {
      "emailAddress": "xyz@contoso.com"
    },
    "supportPlanType": "Premier",
    "supportPlanDisplayName": "Premier",
    "title": "Test - please ignore",
    "serviceId": "/providers/Microsoft.Support/services/subscription_management_service_guid",
    "serviceDisplayName": "Subscription management",
    "status": "Open",
    "createdDate": "2020-03-20T21:36:18Z",
    "modifiedDate": "2020-03-20T21:36:23Z"
  }
}

Tanımlar

Name	Description
Consent	Destek biletinde güncelleştirilecek gelişmiş tanılama onayı.
ContactProfile	Destek biletiyle ilişkili iletişim bilgileri.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
IsTemporaryTicket	Bu özellik, destek biletinin geçici bir bilet olup olmadığını gösterir.
PreferredContactMethod	Tercih edilen iletişim yöntemi.
QuotaChangeRequest	Bu özellik, bölge ve yeni kota sınırları sağlamak için gereklidir.
QuotaTicketDetails	Belirli kota türleri için kota artışı destek bileti için gereken ek bilgi kümesi, örneğin: Sanal makine çekirdekleri. Kota yükü destek isteği hakkındaki tüm ayrıntıları ve Destek kotası isteği'ndeki örnekleri alın.
SecondaryConsent	Bu özellik, destek bileti için ikincil onayı gösterir.
ServiceLevelAgreement	Destek bileti için Hizmet Düzeyi Sözleşmesi ayrıntıları.
SeverityLevel	Servis talebinin aciliyetini gösteren ve yanıt süresini Azure ile sahip olduğunuz teknik destek planının hizmet düzeyi sözleşmesine göre belirleyen bir değer. Not: Azure portalında 'Acil durum - Ciddi etki' düzeyi olarak da bilinen 'En yüksek kritik etki', yalnızca Premium müşterilerimiz için ayrılmıştır.
SupportEngineer	Destek mühendisi bilgileri.
SupportTicketDetails	SupportTicketDetails kaynağını temsil eden nesne.
TechnicalTicketDetails	Teknik destek bileti için ek bilgiler.
UserConsent	Sağlanan kullanıcı onayı değeri

Consent

Listeleme

Destek biletinde güncelleştirilecek gelişmiş tanılama onayı.

Değer	Description
No
Yes

ContactProfile

Object

Destek biletiyle ilişkili iletişim bilgileri.

Name	Tür	Description
additionalEmailAddresses	string[]	Listelenen ek e-posta adresleri, destek biletiyle ilgili tüm yazışmalara kopyalanır.
country	string	Kullanıcının ülkesi. Bu ISO 3166-1 alfa-3 kodudur.
firstName	string	Ad.
lastName	string	Soyadı.
phoneNumber	string	Telefon numarası. Tercih edilen iletişim yöntemi telefon ise bu gereklidir. Ayrıca 'kritik' veya 'highestcriticalimpact' önem durumlarını gönderirken de gereklidir.
preferredContactMethod	PreferredContactMethod	Tercih edilen iletişim yöntemi.
preferredSupportLanguage	string	Azure tarafından tercih edilen destek dili. Destek dilleri, destek biletiniz için seçtiğiniz önem derecesine göre değişir. azure önem derecesi ve yanıt verme adresinden daha fazla bilgi edinin. Standart dil-ülke kodunu kullanın. Geçerli değerler İngilizce için 'en-us', Çince için 'zh-hans', İspanyolca için 'es-es'fr-fr' Fransızca için 'ja-jp' Japonca için 'ko-kr' , Korece için 'ru-ru' , Portekizce için 'pt-br' , İtalyanca için 'it-it' , Çince için 'zh-tw' ve Almanca için 'de-de' değerleridir.
preferredTimeZone	string	Kullanıcının saat dilimi. Bu, Microsoft Saat Dilimi Dizin Değerleri'nden saat diliminin adıdır.
primaryEmailAddress	string	Birincil e-posta adresi.

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

IsTemporaryTicket

Listeleme

Bu özellik, destek biletinin geçici bir bilet olup olmadığını gösterir.

Değer	Description
No
Yes

PreferredContactMethod

Listeleme

Tercih edilen iletişim yöntemi.

Değer	Description
email
phone

QuotaChangeRequest

Object

Bu özellik, bölge ve yeni kota sınırları sağlamak için gereklidir.

Name	Tür	Description
payload	string	Kota artışı isteğinin yükü.
region	string	Kota artışı isteğinin yapıldığı bölge.

QuotaTicketDetails

Object

Belirli kota türleri için kota artışı destek bileti için gereken ek bilgi kümesi, örneğin: Sanal makine çekirdekleri. Kota yükü destek isteği hakkındaki tüm ayrıntıları ve Destek kotası isteği'ndeki örnekleri alın.

Name	Tür	Description
quotaChangeRequestSubType	string	Kota artışı istediğiniz Batch gibi bir alt tür olduğunda belirli kota türleri için gereklidir.
quotaChangeRequestVersion	string	Kota değişikliği isteği sürümü.
quotaChangeRequests	QuotaChangeRequest[]	Bu özellik, bölge ve yeni kota sınırları sağlamak için gereklidir.

SecondaryConsent

Object

Bu özellik, destek bileti için ikincil onayı gösterir.

Name	Tür	Description
type	string	İkincil onayın sağlandığı hizmet adı. Değerin Sorun Sınıflandırma API'sinin yanıtından alınması gerekir.
userConsent	UserConsent	Sağlanan kullanıcı onayı değeri

ServiceLevelAgreement

Object

Destek bileti için Hizmet Düzeyi Sözleşmesi ayrıntıları.

Name	Tür	Description
expirationTime	string (date-time)	Hizmet düzeyi sözleşmesinin süresinin dolduğu UTC (ISO 8601 biçiminde) saati.
slaMinutes	integer (int32)	Dakikalar içinde Hizmet Düzeyi Sözleşmesi.
startTime	string (date-time)	Hizmet düzeyi sözleşmesinin başladığı UTC (ISO 8601 biçiminde) saat.

SeverityLevel

Listeleme

Servis talebinin aciliyetini gösteren ve yanıt süresini Azure ile sahip olduğunuz teknik destek planının hizmet düzeyi sözleşmesine göre belirleyen bir değer. Not: Azure portalında 'Acil durum - Ciddi etki' düzeyi olarak da bilinen 'En yüksek kritik etki', yalnızca Premium müşterilerimiz için ayrılmıştır.

Değer	Description
critical
highestcriticalimpact
minimal
moderate

SupportEngineer

Object

Destek mühendisi bilgileri.

Name	Tür	Description
emailAddress	string	Destek biletine atanan Azure Destek mühendisinin e-posta adresi.

SupportTicketDetails

Object

SupportTicketDetails kaynağını temsil eden nesne.

Name	Tür	Description
id	string	Kaynağın kimliği.
name	string	Kaynağın adı.
properties.advancedDiagnosticConsent	Consent	Destek biletinde güncelleştirilecek gelişmiş tanılama onayı.
properties.contactDetails	ContactProfile	Destek bileti oluşturmak isteyen kullanıcının iletişim bilgileri.
properties.createdDate	string (date-time)	Destek biletinin oluşturulduğu UTC (ISO 8601 biçiminde) saat.
properties.description	string	Sorunun veya sorunun ayrıntılı açıklaması.
properties.enrollmentId	string	Destek biletiyle ilişkili kayıt kimliği.
properties.fileWorkspaceName	string	Dosya çalışma alanı adı.
properties.isTemporaryTicket	IsTemporaryTicket	Bu özellik, destek biletinin geçici bir bilet olup olmadığını gösterir.
properties.modifiedDate	string (date-time)	Destek biletinin son değiştirildiği UTC (ISO 8601 biçiminde) saati.
properties.problemClassificationDisplayName	string	Sorun sınıflandırmasının yerelleştirilmiş adı.
properties.problemClassificationId	string	Her Azure hizmetinin sorun sınıflandırması olarak da bilinen kendi sorun kategorileri kümesi vardır. Bu parametre, karşılaştığınız sorunun türü için benzersiz kimliktir.
properties.problemScopingQuestions	string	Destek biletiyle ilişkili kapsam belirleme soruları.
properties.problemStartTime	string (date-time)	Sorunun başladığı UTC (ISO 8601 biçiminde) saat.
properties.quotaTicketDetails	QuotaTicketDetails	Kota desteği bilet isteğiyle ilişkili ek bilet ayrıntıları.
properties.require24X7Response	boolean	Bunun Azure'dan 7/24 yanıt gerektip gerektirmediğini gösterir.
properties.secondaryConsent	SecondaryConsent[]	Bu özellik, destek bileti için ikincil onayları gösterir
properties.serviceDisplayName	string	Azure hizmetinin yerelleştirilmiş adı.
properties.serviceId	string	Bu, destek biletiyle ilişkili Azure hizmet kaynağının kaynak kimliğidir.
properties.serviceLevelAgreement	ServiceLevelAgreement	Bu destek bileti için Hizmet Düzeyi Sözleşmesi bilgileri.
properties.severity	SeverityLevel	Servis talebinin aciliyetini gösteren ve yanıt süresini Azure ile sahip olduğunuz teknik destek planının hizmet düzeyi sözleşmesine göre belirleyen bir değer. Not: Azure portalında 'Acil durum - Ciddi etki' düzeyi olarak da bilinen 'En yüksek kritik etki', yalnızca Premium müşterilerimiz için ayrılmıştır.
properties.status	string	Destek biletinin durumu.
properties.supportEngineer	SupportEngineer	Bu destek bileti üzerinde çalışan destek mühendisi hakkında bilgi.
properties.supportPlanDisplayName	string	Destek biletiyle ilişkili destek planı türü.
properties.supportPlanId	string	Destek biletiyle ilişkili destek planı kimliği.
properties.supportPlanType	string	Destek biletiyle ilişkili destek planı türü.
properties.supportTicketId	string	Sistem tarafından oluşturulan ve benzersiz olan destek bileti kimliği.
properties.technicalTicketDetails	TechnicalTicketDetails	Teknik destek bileti isteğiyle ilişkili ek bilet ayrıntıları.
properties.title	string	Destek biletinin başlığı.
type	string	'Microsoft.Support/supportTickets' kaynağının türü.

TechnicalTicketDetails

Object

Teknik destek bileti için ek bilgiler.

Name	Tür	Description
resourceId	string	Bu, destek biletinin oluşturulduğu Azure hizmet kaynağının kaynak kimliğidir (örneğin: Sanal makine kaynağı veya HDInsight kaynağı).

UserConsent

Listeleme

Sağlanan kullanıcı onayı değeri

Değer	Description
No
Yes