Müşterinin niteliğini zaman uyumsuz olarak al

Makale
12/01/2021
Okumak için 2 dakika

Müşterinin niteliklerini zaman uyumsuz olarak elde etmek.

Önkoşullar

kimlik doğrulamasında açıklandığı gibi İş Ortağı Merkezi bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamasını destekler.
Müşteri kimliği ( customer-tenant-id ). Müşterinin kimliğini bilmiyorsanız bu kimliği panoda İş Ortağı Merkezi. İş Ortağı Merkezi menüsünden CSP'yi ve ardından Müşteriler'i seçin. Müşteri listesinden müşteriyi ve ardından Hesap'ı seçin. Müşterinin Hesap sayfasında Müşteri Hesabı Bilgileri bölümünde MicrosoftKimliği'ne bakın. Microsoft Kimliği, müşteri kimliği () ile customer-tenant-id aynıdır.

C#

Müşterinin niteliklerini almak için müşteri tanımlayıcısıyla IAggregatePartner.Customers.ById yöntemini arayın. Ardından Bir ICustomerQualification arabirimi almak için Nitelik özelliğini kullanın. Son olarak müşterinin GetQualifications()GetQualificationsAsync() niteliklerini almak için veya çağrısında bulundur.

// IAggregatePartner partnerOperations;
// string customerId;
var customerQualifications = partnerOperations.Customers.ById(customerId).Qualification.GetQualifications();

Örnek:Konsol Örnek Uygulaması. Project:SdkSamples Sınıfı:GetCustomerQualifications.cs

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
AL	{baseURL}/v1/customers/{customer-tenant-id}/qualifications HTTP/1.1

URI parametresi

Bu tabloda tüm niteliği almak için gerekli sorgu parametresi listelemektedir.

Ad	Tür	Gerekli	Açıklama
customer-tenant-id	string	Yes	Müşteriyi tanımlayan GUID biçimli bir dize.

İstek üst bilgileri

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

Yok.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde bir nitelik koleksiyonu döndürür. Aşağıda, Eğitim niteliğine sahip bir müşteri için GET çağrısı örnekleri verilmiştir.

Yanıt başarı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu gösteren bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. İŞ ORTAĞı MERKEZI REST hata kodları.

Yanıt örnekleri

Onaylandı

HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
[
    {
        "qualification": "Education",
        "vettingStatus": "Approved",
    }
]

Gözden Geçiriliyor

HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
[
    {
        "qualification": "Education",
        "vettingStatus": "InReview",
        "vettingCreatedDate": "2020-12-03T10:37:38.885Z" // UTC
    }
]

Reddedildi

HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
[
    {
        "qualification": "Education",
        "vettingStatus": "Denied",
        "vettingReason": "Not an Education Customer", // example Vetting Reason
        "vettingCreatedDate": "2020-12-03T10:37:38.885Z" // UTC
    }
]

Eyalete Ait Varlık Örnekleri

POST örneği aracılığıyla Eyalete Ait Varlık


//SOE
POST {customer_id}/qualifications
{
“qualification”: “StateOwnedEntity”
}

//

Nitelik Al örneği aracılığıyla Eyalete Ait Varlık


//SOE:
GET {customer_id}/qualifications
[
	{
		“qualification”: “StateOwnedEntity”
	}
]

Eğitimle Nitelik Al aracılığıyla Eyalete Ait Varlık


GET {customer_id}/qualifications
[
	{
		“qualification”: “Education”,
		“vettingStatus”: “Approved”
	},
{
		“qualification”: “StateOwnedEntity”
	}
]

GCC ile Nitelikleri Al aracılığıyla Eyalete Ait Varlık


GET {customer_id}/qualifications
[
	{
		“qualification”: “GovernmentCommunityCloud”,
		“vettingStatus”: “Approved”,
		“vettingCreateDate”: “2021-05-06T19:59:56.6832021+00:00”
	},
{
		“qualification”: “StateOwnedEntity”
	}
]

Müşterinin niteliklerini güncelleştirme