Überprüfen des Signaturstatus der Microsoft Partner Network-Vereinbarung für einen indirekten Vertriebspartner
Gilt für: Partner Center | Partner Center für Microsoft Cloud for US Government
Sie können überprüfen, ob ein indirekter Vertriebspartner die Microsoft Partner-Vereinbarung mit seiner PartnerID (PGA/PLA) oder der Cloud Solution Provider (CSP)-Mandanten-ID (Microsoft-ID) signiert hat. Mithilfe der AgreementStatus-API können Sie einen dieser Bezeichner verwenden, um den Signaturstatus der Microsoft Partner-Vereinbarung zu überprüfen.
Voraussetzungen
Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
Die PartnerID (PGA/PLA) oder die CSP-Mandanten-ID (Microsoft-ID) des indirekten Vertriebspartners. Sie müssen einen dieser beiden Bezeichner verwenden.
C#
So rufen Sie den Signaturstatus der Microsoft Partner-Vereinbarung eines indirekten Vertriebspartners ab:
Verwenden Sie Ihre IAggregatePartner.Compliance-Sammlung, um die AgreementSignatureStatus-Eigenschaft aufzurufen.
Rufen Sie die Methode Get() oder GetAsync() auf.
// IAggregatePartner partnerOperations;
var agreementSignatureStatusByMpnId = partnerOperations.Compliance.AgreementSignatureStatus.Get(mpnId:"Enter MPN Id (PGA/PLA)");
var agreementSignatureStatusByTenantId = partnerOperations.Compliance.AgreementSignatureStatus.Get(tenantId: "Enter Tenant Id");
- Beispiel: Konsolentest-App
- Projekt: PartnerCenterSDK.FeaturesSamples
- Klasse: GetAgreementSignatureStatus.cs
REST-Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| GET | {baseURL}/v1/compliance/{ProgramName}/agreementstatus?mpnId={MpnId}&tenantId={TenantId} |
URI-Parameter
Sie müssen einen der beiden folgenden Abfrageparameter bereitstellen, um den Partner zu identifizieren. Wenn Sie keinen dieser beiden Abfrageparameter bereitstellen, erhalten Sie einen Fehler des Typs 400 (Ungültige Anforderung).
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| MpnId | INT | Nein | Eine PartnerID (PGA/PLA), die den indirekten Wiederverkäufer identifiziert. |
| TenantId | GUID | Nein | Eine Microsoft-ID, die das CSP-Konto des indirekten Vertriebspartners identifiziert. |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center – REST-Header.
Beispiele für Anforderungen
Anforderung mit PartnerID (PGA/PLA)
Die folgende Beispielanforderung ruft den Microsoft Partner-Vereinbarung Signierungsstatus des indirekten Händlers mithilfe der PartnerID des indirekten Händlers ab.
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
Anforderung mithilfe der CSP-Mandanten-ID
Die folgende Beispielanforderung ruft den Signierstatus der Microsoft Partner-Vereinbarung für den indirekten Vertriebspartner mithilfe der CSP-Mandanten-ID (Microsoft-ID) des indirekten Vertriebspartners ab.
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-Antwort
Erfolgs- und Fehlercodes der Antwort
Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center – REST-Fehlercodes.
Beispiel für eine Antwort (Erfolg)
Die folgende Beispielantwort gibt erfolgreich zurück, ob der indirekte Vertriebspartner die Microsoft Partner-Vereinbarung signiert hat.
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
}
Antwortbeispiele (Fehler)
Möglicherweise erhalten Sie Antworten ähnlich wie in den folgenden Beispielen, wenn der Signaturstatus der Microsoft Partner-Vereinbarung des indirekten Händlers nicht zurückgegeben werden kann.
Nicht als GUID formatierte CSP-Mandanten-ID
Die folgende Beispielantwort wird zurückgegeben, wenn die CSP-Mandanten-ID, die an die API übergeben wurde, keine GUID ist.
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"
}
Nicht numerische PartnerID
Die folgende Beispielantwort wird zurückgegeben, wenn die PartnerID (PGA/PLA), die Sie an die API übergeben haben, nicht numerisch ist.
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"
}
Keine PartnerID oder CSP-Mandanten-ID
Die folgende Beispielantwort wird zurückgegeben, wenn Sie keine PartnerID (PGA/PLA) oder CSP-Mandanten-ID an die API übergeben haben. Sie müssen einen der beiden ID-Typen an die API übergeben.
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"
}
PartnerID und CSP-Mandanten-ID übergeben
Die folgende Beispielantwort wird zurückgegeben, wenn Sie sowohl die PartnerID (PGA/PLA) als auch die CSP-Mandanten-ID an die API übergeben. Sie dürfen nur einen der beiden Bezeichnertypen an die API übergeben.
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) ist entweder ungültig oder nicht aus Partner Membership Center zu Partner Center migriert.
Die folgende Beispielantwort wird zurückgegeben, wenn die übergebene indirekte PartnerID (PGA/PLA) entweder ungültig ist oder nicht von Partner Membership Center zu Partner Center migriert wird. Weitere Informationen
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"
}
Die Region von CSP Indirect Provider und CSP Indirect Reseller stimmt nicht überein.
Die folgende Beispielantwort wird zurückgegeben, wenn die Region der indirekten Wiederverkäufer-PartnerID (PGA/PLA) nicht mit der Region des indirekten Anbieters übereinstimmt. Weitere Informationen finden Sie unter CSP-Regionen.
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"
}
Das CSP Indirect Reseller-Konto ist zwar im Partner Center vorhanden, allerdings wurde die MPA nicht unterzeichnet.
Die folgende Beispielantwort wird zurückgegeben, wenn die zum CSP Indirect Reseller-Konto gehörige MPA im Partner Center nicht unterzeichnet wurde. Weitere Informationen finden Sie in den häufig gestellten Fragen zum indirekten Anbieter.
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"
}
Es ist kein CSP Indirect Reseller-Konto mit der angegebenen PartnerID verknüpft.
Die folgende Beispielantwort wird zurückgegeben, wenn Partner Center die partnerID (PGA/PLA) erkennen kann, die in der Anforderung übergeben wurde, aber keine CSP-Registrierung mit der angegebenen PartnerID (PGA/PLA) verknüpft ist. Weitere Informationen finden Sie in den häufig gestellten Fragen zum indirekten Anbieter.
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"
}
Ungültige Mandanten-ID
Die folgende Beispielantwort wird zurückgegeben, wenn im Partner Center kein Konto gefunden wurde, das der in der Anforderung übergebenen Mandanten-ID zugeordnet ist.
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"
}
Es wurde keine MPA mit der angegebenen Mandanten-ID gefunden.
Die folgende Beispielantwort wird zurückgegeben, wenn im Partner Center keine unterzeichnete MPA mit der angegebenen Mandanten-ID gefunden wurde. Weitere Informationen finden Sie in den häufig gestellten Fragen zum indirekten Anbieter.
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"
}
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für