Partager via

Vérifier l’état de signature du Contrat Partenaire Microsoft d’un revendeur indirect

S’applique à : Espace partenaires | Espace partenaires de Microsoft Cloud for US Government

Vous pouvez vérifier si un revendeur indirect a signé le Contrat Partenaire Microsoft à l’aide de son ID partenaire (PGA/PLA) ou de l’ID de locataire fournisseur de solutions Cloud (CSP) (ID Microsoft). Vous pouvez utiliser l’un de ces identificateurs pour vérifier l’état de signature du Contrat Partenaire Microsoft à l’aide de l’API AgreementStatus.

Prérequis

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.

  • PartnerID (PGA/PLA) ou l’ID de locataire CSP (ID Microsoft) du revendeur indirect. Vous devez utiliser l’un de ces deux identificateurs.

C#

Pour connaître l’état de signature du Contrat Partenaire Microsoft d’un revendeur indirect :

  1. Utilisez votre collection IAggregatePartner.Compliance pour appeler la propriété AgreementSignatureStatus.

  2. Appelez la méthode Get() ou 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");

Demande REST

Syntaxe de la requête

Méthode URI de demande
GET {baseURL}/v1/compliance/{ProgramName}/agreementstatus?mpnId={MpnId}&tenantId={TenantId}

Paramètres d’URI

Vous devez fournir l’un des deux paramètres de requête suivants pour identifier le partenaire. Si vous ne fournissez pas l’un de ces deux paramètres de requête, vous recevez une erreur 400 (requête incorrecte).

Nom Type Requise Description
MpnId int Non Un PartnerID (PGA/PLA) qui identifie le revendeur indirect.
TenantId GUID Non ID Microsoft identifiant le compte de fournisseur de solutions Cloud du revendeur indirect.

En-têtes de requête

Pour plus d’informations, consultez REST de l’Espace Partenaires.

Exemples de requête

Demande à l’aide de PartnerID (PGA/PLA)

L’exemple de requête suivant obtient l’état de signature Contrat Partenaire Microsoft du revendeur indirect à l’aide de l’ID partenaire du revendeur indirect.

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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Requête avec l’ID de locataire de fournisseur de solutions Cloud

L’exemple de requête suivant obtient l’état de signature du Contrat Partenaire Microsoft du revendeur indirect en utilisant l’ID de locataire de fournisseur de solutions Cloud de ce dernier.

GET https://api.partnercenter.microsoft.com/v1/compliance/csp/agreementstatus?tenantId=aaaabbbb-0000-cccc-1111-dddd2222eeee HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: aa04fb9d-c6b6-4754-8a6a-86e00cdd5ccb
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Réponse REST

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Erreur REST de l’Espace partenaires.

Exemple de réponse (réussite)

L’exemple de réponse suivant indique correctement si le revendeur indirect a signé ou non le Contrat Partenaire Microsoft.

HTTP/1.1 200 OK
Content-Length: 29
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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
}

Exemples de réponse (échecs)

Vous pouvez recevoir des réponses similaires aux exemples suivants lorsque l’état de signature du Contrat Partenaire Microsoft du revendeur indirect ne peut pas être retourné.

ID de locataire de fournisseur de solutions Cloud au format non-GUID

L’exemple de réponse suivant est retourné quand l’ID de locataire de fournisseur de solutions Cloud que vous avez passé à l’API n’est pas un GUID.

HTTP/1.1 400 Bad Request
Content-Length: 105
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}

PartnerID non numérique

L’exemple de réponse suivant est retourné lorsque l’ID partenaire (PGA/PLA) que vous avez passé à l’API n’est pas numérique.

HTTP/1.1 400 Bad Request
Content-Length: 103
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}

Aucun ID de locataire PartnerID ou CSP

L’exemple de réponse suivant est retourné lorsque vous n’avez pas passé d’ID partenaire (PGA/PLA) ou d’ID de locataire CSP à l’API. Vous devez passer l’un de ces deux types d’ID à l’API.

HTTP/1.1 400 Bad Request
Content-Length: 114
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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 de locataire PartnerID et CSP transmis

L’exemple de réponse suivant est retourné lorsque vous passez l’ID partenaire (PGA/PLA) et l’ID de locataire CSP à l’API. Vous devez passer un seul des deux types d’identificateur à l’API.

HTTP/1.1 400 Bad Request
Content-Length: 119
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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) n’est pas valide ou n’est pas migré de l’Espace partenaires vers l’Espace partenaires

L’exemple de réponse suivant est retourné lorsque l’ID partenaire de revendeur indirect (PGA/PLA) passé n’est pas valide ou qu’il n’est pas migré de l’Espace partenaires vers l’Espace partenaires. En savoir plus

HTTP/1.1 400 Bad Request 
Content-Length: 321 
Content-Type: application/json; charset=utf-8 
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee 
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" 
}

La région du CSP Indirect Provider et la région du CSP Indirect Reseller ne correspondent pas

L’exemple de réponse suivant est retourné lorsque la région de l’ID partenaire du revendeur indirect (PGA/PLA) ne correspond pas à la région du fournisseur indirect. Pour plus d’informations, consultez Régions CSP.

HTTP/1.1 400 Bad Request 
Content-Length: 119 
Content-Type: application/json; charset=utf-8 
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd 
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 aaaabbbb-0000-cccc-1111-dddd2222eeee.", 
    "data": [ 

        "/partner-center/mpa-indirect-provider-faq"  
    ], 
    "source": "PartnerFD" 
}

Le compte du CSP Indirect Reseller existe dans l’Espace partenaires, mais n’a pas signé le MPA

L’exemple de réponse suivant est retourné lorsque le compte du CSP Indirect Reseller dans l’Espace partenaires n’a pas signé le MPA. Pour plus d’informations, consultez les FAQ sur les fournisseurs indirects.

HTTP/1.1 400 Bad Request
Content-Length: 321
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
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": [
        "/partner-center/mpa-indirect-provider-faq"
    ],
    "source": "PartnerFD"
}

Aucun compte csp Indirect Reseller n’est associé à l’ID de partenaire donné

L’exemple de réponse suivant est retourné lorsque l’Espace partenaires peut reconnaître l’ID partenaire (PGA/PLA) transmis dans la demande, mais qu’aucune inscription CSP n’est associée à l’ID partenaire donné (PGA/PLA). Pour plus d’informations, consultez les FAQ sur les fournisseurs indirects.

HTTP/1.1 400 Bad Request 
Content-Length: 321 
Content-Type: application/json; charset=utf-8 
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee 
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": [ 

        "/partner-center/mpa-indirect-provider-faq" 
    ], 
    "source": "PartnerFD" 
}

ID de locataire non valide

L’exemple de réponse suivant est retourné lorsque l’Espace partenaires ne trouve pas de compte associé à l’ID de locataire passé dans la demande.

HTTP/1.1 400 Bad Request 
Content-Length: 321 
Content-Type: application/json; charset=utf-8 
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee 
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 'bbbbcccc-1111-dddd-2222-eeee3333ffff'.", 
    "data": [], 
    "source": "PartnerFD" 
}

MPA introuvable avec l’ID de locataire donné

L’exemple de réponse suivant est retourné lorsque l’Espace partenaires ne peut pas trouver de signature MPA avec l’ID de locataire donné. Pour plus d’informations, consultez les FAQ sur les fournisseurs indirects.

HTTP/1.1 400 Bad Request
Content-Length: 321
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
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 bbbbcccc-1111-dddd-2222-eeee3333ffff hasn't signed the agreement",
    "data": [
        "/partner-center/mpa-indirect-provider-faq"
    ],
    "source": "PartnerFD"
}