Dolaylı satıcının Microsoft İş Ortağı Sözleşmesi imzalama durumunu doğrulama
Şunlar için geçerlidir: İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi
Dolaylı bir satıcının Microsoft İş Ortağı Sözleşmesi İş Ortağı Kimliği (PGA/PLA) veya Bulut Çözümü Sağlayıcısı (CSP) kiracı kimliğini (Microsoft Kimliği) kullanarak imzalayıp imzalamadığını doğrulayabilirsiniz. AgreementStatus API'sini kullanarak Microsoft İş Ortağı Sözleşmesi imzalama durumunu denetlemek için bu tanımlayıcılardan birini kullanabilirsiniz.
Önkoşullar
İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Dolaylı bayinin İş Ortağı Kimliği (PGA/PLA) veya CSP kiracı kimliği (Microsoft Kimliği). Bu iki tanımlayıcıdan birini kullanmanız gerekir.
C#
Dolaylı bir satıcının Microsoft İş Ortağı Sözleşmesi imza durumunu almak için:
AgreementSignatureStatus özelliğini çağırmak için IAggregatePartner.Compliance koleksiyonunuzu kullanın.
Get() veya GetAsync() yöntemini çağırın.
// IAggregatePartner partnerOperations;
var agreementSignatureStatusByMpnId = partnerOperations.Compliance.AgreementSignatureStatus.Get(mpnId:"Enter MPN Id (PGA/PLA)");
var agreementSignatureStatusByTenantId = partnerOperations.Compliance.AgreementSignatureStatus.Get(tenantId: "Enter Tenant Id");
- Örnek: Konsol test uygulaması
- Proje: PartnerCenterSDK.FeaturesSamples
- Sınıf: GetAgreementSignatureStatus.cs
REST isteği
İstek söz dizimi
| Metot | İstek URI'si |
|---|---|
| GET | {baseURL}/v1/compliance/{ProgramName}/agreementstatus?mpnId={MpnId}&tenantId={TenantId} |
URI parametreleri
İş ortağını tanımlamak için aşağıdaki iki sorgu parametresinden birini sağlamanız gerekir. Bu iki sorgu parametresinden birini sağlamazsanız 400 (Hatalı istek) hatası alırsınız.
| Adı | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| MpnId | int | Hayır | Dolaylı kurumsal bayiyi tanımlayan bir PartnerID (PGA/PLA). |
| Kiracı Kimliği | GUID | Hayır | Dolaylı kurumsal bayinin CSP hesabını tanımlayan bir Microsoft kimliği. |
İstek üst bilgileri
Daha fazla bilgi için bkz . İş Ortağı Merkezi REST.
İstek örnekleri
İş Ortağı Kimliği (PGA/PLA) kullanarak istek
Aşağıdaki örnek istek, dolaylı bayinin PartnerID değerini kullanarak dolaylı satıcının Microsoft İş Ortağı Sözleşmesi imzalama durumunu alır.
GET https://api.partnercenter.microsoft.com/v1/compliance/csp/agreementstatus?mpnid=1234567 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: aa04fb9d-c6b6-4754-8a6a-86e00cdd5ccb
MS-CorrelationId: b4e67a78-0692-45d1-b408-04b9178a8ac6
X-Locale: en-US
Host: api.partnercenter.microsoft.com
CSP kiracı kimliğini kullanma isteği
Aşağıdaki örnek istek, dolaylı satıcının CSP kiracı kimliğini (Microsoft Kimliği) kullanarak dolaylı satıcının Microsoft İş Ortağı Sözleşmesi imzalama durumunu alır.
GET https://api.partnercenter.microsoft.com/v1/compliance/csp/agreementstatus?tenantId=a2898e3a-06ca-454e-a0d0-c73b0ee36bba HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: aa04fb9d-c6b6-4754-8a6a-86e00cdd5ccb
MS-CorrelationId: b4e67a78-0692-45d1-b408-04b9178a8ac6
X-Locale: en-US
Host: api.partnercenter.microsoft.com
REST yanıtı
Yanıt başarısı ve hata kodları
Her yanıt, başarılı veya başarısız olduğunu belirten 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 hatası.
Yanıt örneği (başarılı)
Aşağıdaki örnek yanıt, dolaylı satıcının Microsoft İş Ortağı Sözleşmesi imzalayıp imzalamadığını başarıyla döndürür.
HTTP/1.1 200 OK
Content-Length: 29
Content-Type: application/json; charset=utf-8
MS-CorrelationId: b4e67a78-0692-45d1-b408-04b9178a8ac6
MS-RequestId: aa04fb9d-c6b6-4754-8a6a-86e00cdd5ccb
MS-CV: jn3r+1wpE06nCt/0.0
MS-ServerId: 0000005B
Date: Tue, 15 Oct 2019 12:44:34 GMT
Connection: close
{
"isAgreementSigned": true
}
Yanıt örnekleri (hata)
Dolaylı satıcının Microsoft İş Ortağı Sözleşmesi imzalama durumu döndürülemiyorsa aşağıdaki örneklere benzer yanıtlar alabilirsiniz.
GUID biçimli olmayan CSP kiracı kimliği
AŞAĞıDAKI örnek yanıt, API'ye geçirdiğiniz CSP kiracı kimliği GUID olmadığında döndürülür.
HTTP/1.1 400 Bad Request
Content-Length: 105
Content-Type: application/json; charset=utf-8
MS-CorrelationId: b4e67a78-0692-45d1-b408-04b9178a8ac6
MS-RequestId: aa04fb9d-c6b6-4754-8a6a-86e00cdd5ccb
MS-CV: rbuZl5lbAkyq8WGK.0
MS-ServerId: 00000055
Date: Wed, 16 Oct 2019 08:55:23 GMT
Connection: close
{
"code": 2000,
"description": "Tenant Id must be a GUID.",
"data": [],
"source": "PartnerApiServiceControllers"
}
Sayısal olmayan İş Ortağı Kimliği
AŞAĞıDAKI örnek yanıt, API'ye geçirdiğiniz İş Ortağı Kimliği (PGA/PLA) sayısal olmadığında döndürülür.
HTTP/1.1 400 Bad Request
Content-Length: 103
Content-Type: application/json; charset=utf-8
MS-CorrelationId: b4e67a78-0692-45d1-b408-04b9178a8ac6
MS-RequestId: aa04fb9d-c6b6-4754-8a6a-86e00cdd5ccb
MS-CV: cP5JiS4sv0GJxlJ9.0
MS-ServerId: 0000005B
Date: Wed, 16 Oct 2019 08:58:45 GMT
Connection: close
{
"code": 2000,
"description": "MPN Id must be numeric.",
"data": [],
"source": "PartnerApiServiceControllers"
}
İş Ortağı Kimliği veya CSP kiracı kimliği yok
Api'ye bir PartnerID (PGA/PLA) veya CSP kiracı kimliği geçirmezseniz aşağıdaki örnek yanıt döndürülür. API'ye iki kimlik türünden birini geçirmeniz gerekir.
HTTP/1.1 400 Bad Request
Content-Length: 114
Content-Type: application/json; charset=utf-8
MS-CorrelationId: b4e67a78-0692-45d1-b408-04b9178a8ac6
MS-RequestId: aa04fb9d-c6b6-4754-8a6a-86e00cdd5ccb
MS-CV: hEV736v4qk6joDMR.0
MS-ServerId: 00000055
Date: Wed, 16 Oct 2019 09:00:30 GMT
Connection: close
{
"code": 2001,
"description": "Both MPN Id and Tenant Id cannot be empty.",
"data": [],
"source": "ComplianceController"
}
Hem İş Ortağı Kimliği hem de CSP kiracı kimliği geçirildi
Api'ye hem PartnerID (PGA/PLA) hem de CSP kiracı kimliğini geçirdiğinizde aşağıdaki örnek yanıt döndürülür. API'ye iki tanımlayıcı türünden yalnızca birini geçirmeniz gerekir.
HTTP/1.1 400 Bad Request
Content-Length: 119
Content-Type: application/json; charset=utf-8
MS-CorrelationId: b4e67a78-0692-45d1-b408-04b9178a8ac6
MS-RequestId: aa04fb9d-c6b6-4754-8a6a-86e00cdd5ccb
MS-CV: WTsLWK5UlUW9sZjH.0
MS-ServerId: 0000005B
Date: Wed, 16 Oct 2019 09:02:30 GMT
Connection: close
{
"code": 2000,
"description": "Both MPN Id and Tenant Id should not be passed.",
"data": [],
"source": "ComplianceController"
}
CSP Indirect Reseller PartnerID (PGA/PLA) geçersiz veya İş Ortağı Üyelik Merkezi'nden İş Ortağı Merkezi'ne geçirilmedi
Aşağıdaki örnek yanıt, Indirect reseller PartnerID (PGA/PLA) geçirildiğinde geçersiz olduğunda veya İş Ortağı Üyelik Merkezi'nden İş Ortağı Merkezi'ne geçirilmediğinde döndürülür. Daha Fazla Bilgi
HTTP/1.1 400 Bad Request
Content-Length: 321
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 9240230a-413f-4880-acbd-96d59a165474
MS-RequestId: 92caacb1-8c9e-49af-8f85-83f271c85056
MS-CV: V8eVMXvaBE6LHyq6.0
MS-ServerId: 0000005B
Date: Fri, 24 Jul 2020 11:56:46 GMT
Connection: close
{
"code": 2200,
"description": "Requested MPN Id 123456 is either invalid or does not exist in Partner Center.",
"data": [
"https://partner.microsoft.com/resources/detail/migrate-pmc-pc-mpa-guide-pptx"
],
"source": "PartnerFD"
}
CSP Dolaylı Sağlayıcı bölgesi ve CSP Dolaylı Kurumsal Bayi bölgesi eşleşmiyor
Dolaylı bayi PartnerID (PGA/PLA) bölgesi Dolaylı Sağlayıcının bölgesiyle eşleşmediğinde aşağıdaki örnek yanıt döndürülür. Daha fazla bilgi edinmek için bkz . CSP Bölgeleri.
HTTP/1.1 400 Bad Request
Content-Length: 119
Content-Type: application/json; charset=utf-8
MS-CorrelationId: b4e67a78-0692-45d1-b408-04b9178a8ac6
MS-RequestId: aa04fb9d-c6b6-4754-8a6a-86e00cdd5ccb
MS-CV: WTsLWK5UlUW9sZjH.0
MS-ServerId: 0000005B
Date: Wed, 16 Oct 2019 09:02:30 GMT
Connection: close
{
"code": 2201,
"description": "The CSP region of the requested PartnerID 123456 is India and doesn't match the CSP region United States of Indirect Provider with Tenant id a2898e3a-06ca-454e-a0d0-c73b0ee36bba.",
"data": [
"https://learn.microsoft.com/partner-center/mpa-indirect-provider-faq"
],
"source": "PartnerFD"
}
CSP Indirect Reseller hesabı İş Ortağı Merkezi'nde var ancak MPA'ya imza vermedi
İş Ortağı Merkezi'ndeki CSP Indirect Reseller hesabı MPA'yi imzalamadığında aşağıdaki örnek yanıt döndürülür. Daha fazla bilgi edinmek için bkz . Dolaylı sağlayıcı hakkında SSS.
HTTP/1.1 400 Bad Request
Content-Length: 321
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 9240230a-413f-4880-acbd-96d59a165474
MS-RequestId: 92caacb1-8c9e-49af-8f85-83f271c85056
MS-CV: V8eVMXvaBE6LHyq6.0
MS-ServerId: 0000005B
Date: Fri, 24 Jul 2020 11:56:46 GMT
Connection: close
{
"code": 2203,
"description": "MPN Id 123456 has not signed Microsoft Partner Agreement (MPA) for the CSP region where the order is being placed. Please advise your reseller to sign MPA to continue with the order.",
"data": [
"https://learn.microsoft.com/partner-center/mpa-indirect-provider-faq"
],
"source": "PartnerFD"
}
Verilen İş Ortağı Kimliği ile ilişkili CSP Dolaylı Kurumsal Bayi hesabı yok
aşağıdaki örnek yanıt, İş Ortağı Merkezi istekte geçirilen İş Ortağı Kimliği'ni (PGA/PLA) tanıyabildiğinde ancak verilen İş Ortağı Kimliği (PGA/PLA) ile ilişkili CSP kaydı olmadığında döndürülür. Daha fazla bilgi edinmek için bkz . Dolaylı sağlayıcı hakkında SSS.
HTTP/1.1 400 Bad Request
Content-Length: 321
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 9240230a-413f-4880-acbd-96d59a165474
MS-RequestId: 92caacb1-8c9e-49af-8f85-83f271c85056
MS-CV: V8eVMXvaBE6LHyq6.0
MS-ServerId: 0000005B
Date: Fri, 24 Jul 2020 11:56:46 GMT
Connection: close
{
"code": 2204,
"description": "Requested MPN Id 123456 is not associated with any CSP Indirect Reseller account in Partner Center. Please advise your reseller to enroll into the CSP program as an indirect reseller in Partner Center to be compliant.",
"data": [
"https://learn.microsoft.com/partner-center/mpa-indirect-provider-faq"
],
"source": "PartnerFD"
}
Geçersiz Kiracı Kimliği
aşağıdaki örnek yanıt, İş Ortağı Merkezi istekte geçirilen Kiracı Kimliği ile ilişkilendirilmiş bir hesap bulamadıysa döndürülür.
HTTP/1.1 400 Bad Request
Content-Length: 321
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 9240230a-413f-4880-acbd-96d59a165474
MS-RequestId: 92caacb1-8c9e-49af-8f85-83f271c85056
MS-CV: V8eVMXvaBE6LHyq6.0
MS-ServerId: 0000005B
Date: Fri, 24 Jul 2020 11:56:46 GMT
Connection: close
{
"code": 2205,
"description": "Could not find account with id '12345678-ACBD-1234-ABCD-123456789ABC'.",
"data": [],
"source": "PartnerFD"
}
Verilen Kiracı Kimliği ile MPA bulunamadı
İş Ortağı Merkezi verilen Kiracı Kimliğine sahip MPA imzası bulamadıysa aşağıdaki örnek yanıt döndürülür. Daha fazla bilgi edinmek için bkz . Dolaylı sağlayıcı hakkında SSS.
HTTP/1.1 400 Bad Request
Content-Length: 321
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 9240230a-413f-4880-acbd-96d59a165474
MS-RequestId: 92caacb1-8c9e-49af-8f85-83f271c85056
MS-CV: V8eVMXvaBE6LHyq6.0
MS-ServerId: 0000005B
Date: Fri, 24 Jul 2020 11:56:46 GMT
Connection: close
{
"code": 2206,
"description": "Parnter Center Account associated to Tenant Id 12345678-ACBD-1234-ABCD-123456789ABC hasn't signed the agreement",
"data": [
"https://learn.microsoft.com/partner-center/mpa-indirect-provider-faq"
],
"source": "PartnerFD"
}
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin