Weryfikowanie stanu podpisania umowy Microsoft Partner Agreement odsprzedawcy pośredniego
Dotyczy: Centrum partnerskie | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA
Możesz sprawdzić, czy odsprzedawca pośredni podpisał umowę partnerską firmy Microsoft przy użyciu identyfikatora partnera (PGA/PLA) lub identyfikatora dzierżawy Dostawca rozwiązań w chmurze (CSP). Możesz użyć jednego z tych identyfikatorów, aby sprawdzić stan podpisywania umowy Microsoft Partner Agreement przy użyciu interfejsu API AgreementStatus .
Wymagania wstępne
Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń aplikacji i użytkownika.
PartnerID (PGA/PLA) lub identyfikator dzierżawy CSP (Identyfikator Microsoft) odsprzedawcy pośredniego. Należy użyć jednego z tych dwóch identyfikatorów.
C#
Aby uzyskać stan podpisu umowy Microsoft Partner Agreement odsprzedawcy pośredniego:
Użyj kolekcji IAggregatePartner.Compliance , aby wywołać właściwość AgreementSignatureStatus .
Wywołaj metodę Get() lub 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");
- Przykład: aplikacja testowa konsoli
- Projekt: PartnerCenterSDK.FeaturesSamples
- Klasa: GetAgreementSignatureStatus.cs
Żądanie REST
Składnia żądania
| Metoda | Identyfikator URI żądania |
|---|---|
| GET | {baseURL}/v1/compliance/{ProgramName}/agreementstatus?mpnId={MpnId}&tenantId={TenantId} |
Parametry identyfikatora URI
Aby zidentyfikować partnera, należy podać jeden z następujących dwóch parametrów zapytania. Jeśli nie podasz jednego z tych dwóch parametrów zapytania, zostanie wyświetlony błąd 400 (Nieprawidłowe żądanie).
| Nazwisko | Type | Wymagania | opis |
|---|---|---|---|
| Identyfikator mpn | int | Nie. | PartnerID (PGA/PLA), który identyfikuje odsprzedawcę pośredniego. |
| Identyfikator dzierżawy | Identyfikator GUID | Nie. | Identyfikator Firmy Microsoft identyfikujący konto dostawcy usług w chmurze odsprzedawcy pośredniego. |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Rest Centrum partnerskiego.
Przykłady żądań
Żądanie przy użyciu identyfikatora PartnerID (PGA/PLA)
Poniższe przykładowe żądanie pobiera stan podpisania umowy Microsoft Partner Agreement odsprzedawcy pośredniego przy użyciu identyfikatora PartnerID odsprzedawcy pośredniego.
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
Żądanie przy użyciu identyfikatora dzierżawy CSP
Poniższe przykładowe żądanie pobiera stan podpisania umowy Microsoft Partner Agreement odsprzedawcy pośredniego przy użyciu identyfikatora dzierżawy dostawcy CSP odsprzedawcy pośredniego (Identyfikator Firmy Microsoft).
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
Odpowiedź REST
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Błąd REST Centrum partnerskiego.
Przykład odpowiedzi (powodzenie)
Następująca przykładowa odpowiedź została pomyślnie zwrócona, czy odsprzedawca pośredni podpisał umowę partnerską firmy Microsoft.
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
}
Przykłady odpowiedzi (niepowodzenie)
Możesz otrzymywać odpowiedzi podobne do poniższych przykładów, gdy nie można zwrócić stanu podpisywania umowy Microsoft Partner Agreement odsprzedawcy pośredniego.
Identyfikator dzierżawy CSP w formacie bez identyfikatora GUID
Poniższa przykładowa odpowiedź jest zwracana, gdy identyfikator dzierżawy dostawcy usług kryptograficznych przekazany do interfejsu API nie jest identyfikatorem 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"
}
Identyfikator partnera nieliczbowego
Następująca przykładowa odpowiedź jest zwracana, gdy identyfikator PartnerID (PGA/PLA), który został przekazany do interfejsu API, jest nieliczbowy.
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"
}
Brak identyfikatora dzierżawy PartnerID ani CSP
Następująca przykładowa odpowiedź jest zwracana, gdy nie przekazano identyfikatora partnera (PGA/PLA) lub identyfikatora dzierżawy dostawcy usług w chmurze do interfejsu API. Musisz przekazać jeden z dwóch typów identyfikatorów do interfejsu API.
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"
}
Przekazano zarówno identyfikator partnera, jak i identyfikator dzierżawy dostawcy usług w chmurze
Poniższa przykładowa odpowiedź jest zwracana po przekazaniu identyfikatora dzierżawy PartnerID (PGA/PLA) do interfejsu API. Do interfejsu API należy przekazać tylko jeden z dwóch typów identyfikatorów.
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"
}
PartnerID odsprzedawcy pośredniego programu CSP (PGA/PLA) jest nieprawidłowy lub nie jest migrowany z Centrum partnerskiego do Centrum partnerskiego
Poniższa przykładowa odpowiedź jest zwracana, gdy przekazany identyfikator partnera pośredniego (PGA/PLA) jest nieprawidłowy lub nie jest migrowany z Centrum członkostwa partnerskiego do Centrum partnerskiego. Dowiedz się więcej
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"
}
Region dostawcy pośredniego CSP i region odsprzedawcy pośredniego dostawcy CSP nie jest zgodny
Poniższa przykładowa odpowiedź jest zwracana, gdy region odsprzedawcy pośredniego PartnerID (PGA/PLA) nie jest zgodny z regionem dostawcy pośredniego. Aby dowiedzieć się więcej, zobacz Regiony 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"
}
Konto CSP Indirect Reseller istnieje w Centrum partnerskim, ale nie podpisało umowy MPA
Następująca przykładowa odpowiedź jest zwracana, gdy konto CSP Indirect Reseller w Centrum partnerskim nie podpisało umowy MPA. Aby dowiedzieć się więcej, zobacz Często zadawane pytania dotyczące dostawcy pośredniego.
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"
}
Żadne konto odsprzedawcy pośredniego dostawcy usług w chmurze nie jest skojarzone z danym identyfikatorem PartnerID
Następująca przykładowa odpowiedź jest zwracana, gdy Centrum partnerskie może rozpoznać identyfikator Partnera (PGA/PLA) przekazany w żądaniu, ale nie ma rejestracji dostawcy CSP skojarzonej z danym PartnerID (PGA/PLA). Aby dowiedzieć się więcej, zobacz Często zadawane pytania dotyczące dostawcy pośredniego.
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"
}
Nieprawidłowy identyfikator dzierżawy
Następująca przykładowa odpowiedź jest zwracana, gdy Centrum partnerskie nie znajdzie żadnego konta skojarzonego z identyfikatorem dzierżawy przekazanym w żądaniu.
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"
}
Nie znaleziono umowy MPA z danym identyfikatorem dzierżawy
Poniższa przykładowa odpowiedź jest zwracana, gdy Centrum partnerskie nie może odnaleźć żadnego podpisu umowy MPA z danym identyfikatorem dzierżawy. Aby dowiedzieć się więcej, zobacz Często zadawane pytania dotyczące dostawcy pośredniego.
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"
}
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla