Ověření stavu podepisování Smlouva s partnerem Microsoftu nepřímého prodejce
Platí pro: Partnerské centrum | Partnerské centrum pro Microsoft Cloud pro státní správu USA
Pomocí ID tenanta Partnera (PGA/PLA) nebo ID tenanta CSP (Cloud Solution Provider) (Microsoft ID) můžete ověřit, jestli nepřímý prodejce podepsal Smlouva s partnerem Microsoftu. Pomocí jednoho z těchto identifikátorů můžete pomocí rozhraní API AgreementStatus zkontrolovat stav podpisu Smlouva s partnerem Microsoftu.
Požadavky
Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pouze s přihlašovacími údaji aplikace a uživatele.
PARTNERID (PGA/PLA) nebo ID tenanta CSP (Microsoft ID) nepřímého prodejce. Musíte použít jeden z těchto dvou identifikátorů.
C#
Získání Smlouva s partnerem Microsoftu stavu podpisu nepřímého prodejce:
K volání vlastnosti AgreementSignatureStatus použijte kolekci IAggregatePartner.Compliance.
Volejte metodu Get() nebo GetAsync().
// IAggregatePartner partnerOperations;
var agreementSignatureStatusByMpnId = partnerOperations.Compliance.AgreementSignatureStatus.Get(mpnId:"Enter MPN Id (PGA/PLA)");
var agreementSignatureStatusByTenantId = partnerOperations.Compliance.AgreementSignatureStatus.Get(tenantId: "Enter Tenant Id");
- Ukázka: Konzolová testovací aplikace
- Projekt: PartnerCenterSDK.FeaturesSamples
- Třída: GetAgreementSignatureStatus.cs
Požadavek REST
Syntaxe požadavku
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | {baseURL}/v1/compliance/{ProgramName}/agreementstatus?mpnId={MpnId}&tenantId={TenantId} |
Parametry identifikátoru URI
Abyste mohli partnera identifikovat, musíte zadat jeden z následujících dvou parametrů dotazu. Pokud nezadáte jeden z těchto dvou parametrů dotazu, zobrazí se chyba 400 (Chybný požadavek).
| Name | Type | Požadováno | Popis |
|---|---|---|---|
| MpnId | int | No | PartnerID (PGA/PLA), který identifikuje nepřímého prodejce. |
| Id tenanta | Identifikátor GUID | No | ID Microsoftu, které identifikuje účet CSP nepřímého prodejce. |
Záhlaví žádosti
Další informace najdete v tématu REST Partnerského centra.
Příklady požadavků
Žádost o použití PARTNERID (PGA/PLA)
Následující příklad požadavku získá stav podpisu Smlouva s partnerem Microsoftu nepřímého prodejce pomocí ID partnera nepřímého prodejce.
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
Žádost pomocí ID tenanta CSP
Následující příklad požadavku získá stav podpisu Smlouva s partnerem Microsoftu nepřímého prodejce pomocí ID tenanta CSP nepřímého prodejce (Microsoft ID).
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
Odpověď REST
Kódy úspěšnosti a chyb odpovědi
Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Chyba ROZHRANÍ REST Partnerského centra.
Příklad odpovědi (úspěch)
Následující příklad odpovědi úspěšně vrátí, zda nepřímý prodejce podepsal Smlouva s partnerem Microsoftu.
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
}
Příklady odpovědí (selhání)
Pokud se stav podpisu Smlouva s partnerem Microsoftu nepřímého prodejce nedá vrátit, můžou se zobrazit odpovědi podobné následujícím příkladům.
ID tenanta CSP bez guid
Následující příklad odpovědi se vrátí, když ID tenanta CSP, které jste předali rozhraní API, není identifikátor GUID.
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"
}
Nečíselné ID partnera
Následující příklad odpovědi se vrátí, když PARTNERID (PGA/PLA), který jste předali do rozhraní API, není číselné.
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"
}
Žádné ID tenanta PartnerID nebo CSP
Následující příklad odpovědi se vrátí, pokud jste do rozhraní API nepředali ID tenanta PartnerID (PGA/PLA) nebo ID tenanta CSP. Do rozhraní API musíte předat jeden ze dvou typů ID.
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"
}
Id tenanta PartnerID i CSP byly předány.
Následující příklad odpovědi se vrátí, když do rozhraní API předáte ID tenanta PartnerID (PGA/PLA) i ID tenanta CSP. Rozhraní API musí předat pouze jeden ze dvou typů identifikátorů.
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"
}
ID partnera nepřímého prodejce CSP (PGA/PLA) je neplatné nebo se nemigruje z Partnerského centra členství do Partnerského centra.
Následující příklad odpovědi se vrátí, když je ID partnera nepřímého prodejce (PGA/PLA) neplatné nebo se nemigruje z Partnerského centra členství do Partnerského centra. Další informace
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"
}
Oblast nepřímého poskytovatele CSP a oblast nepřímého prodejce CSP se neshoduje
Následující příklad odpovědi se vrátí, když se oblast ID partnera nepřímého prodejce (PGA/PLA) neshoduje s oblastí nepřímého poskytovatele. Další informace najdete v tématu Oblasti CSP.
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"
}
Účet nepřímého prodejce CSP existuje v Partnerském centru, ale nepřihlásil smlouvu MPA.
Následující příklad odpovědi se vrátí, když účet nepřímého prodejce CSP v Partnerském centru nepřihlásil smlouvu MPA. Další informace najdete v nejčastějších dotazech nepřímého poskytovatele.
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"
}
K danému ID partnera není přidružený žádný účet nepřímého prodejce CSP.
Následující příklad odpovědi se vrátí, když Partnerské centrum dokáže rozpoznat ID partnera (PGA/PLA) předávané v požadavku, ale k danému ID partnera (PGA/PLA) není přidružená žádná registrace CSP. Další informace najdete v nejčastějších dotazech nepřímého poskytovatele.
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"
}
Neplatné ID tenanta
Následující příklad odpovědi se vrátí, když Partnerské centrum nenajde žádný účet přidružený k ID tenanta předaného v požadavku.
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"
}
Nebyla nalezena žádná smlouva MPA s daným ID tenanta.
Následující příklad odpovědi se vrátí, když Partnerské centrum nemůže najít žádný podpis MPA s daným ID tenanta. Další informace najdete v nejčastějších dotazech nepřímého poskytovatele.
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"
}
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro