Verificación del estado de la firma del contrato Microsoft Partner Agreement por parte de un revendedor indirecto
Se aplica a: Centro de partners | Centro de partners para Microsoft Cloud for US Government
Puede comprobar si un revendedor indirecto ha firmado el Contrato de partners de Microsoft mediante su PartnerID (PGA/PLA) o Proveedor de soluciones en la nube (CSP) id. de inquilino (Id. de Microsoft). Puedes usar uno de estos identificadores para comprobar el estado de firma del contrato Microsoft Partner Agreement mediante la API AgreementStatus.
Requisitos previos
Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.
PartnerID (PGA/PLA) o el identificador de inquilino de CSP (id. de Microsoft) del revendedor indirecto. Debes usar uno de estos dos identificadores.
C#
Para obtener el estado de firma del contrato Microsoft Partner Agreement de un revendedor indirecto:
Usa la colección IAggregatePartner.Compliance para llamar a la propiedad AgreementSignatureStatus.
Llama al método Get() o 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");
- Ejemplo: Aplicación de prueba de consola
- Proyecto: PartnerCenterSDK.FeaturesSamples
- Clase: GetAgreementSignatureStatus.cs
Solicitud REST
Sintaxis de la solicitud
| Método | URI de solicitud |
|---|---|
| GET | {baseURL}/v1/compliance/{ProgramName}/agreementstatus?mpnId={MpnId}&tenantId={TenantId} |
Parámetros del identificador URI
Debes proporcionar uno de los dos parámetros de consulta siguientes para identificar al partner. Si no proporcionas uno de estos dos parámetros de consulta, recibirás un error 400 (Solicitud incorrecta).
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| MpnId | int | No | PartnerID (PGA/PLA) que identifica al revendedor indirecto. |
| TenantId | GUID | No | Identificador de Microsoft que identifica la cuenta de CSP del revendedor indirecto. |
Encabezados de solicitud
Para obtener más información, consulta REST del Centro de partners.
Ejemplos de solicitud
Solicitud mediante PartnerID (PGA/PLA)
La siguiente solicitud de ejemplo obtiene el estado de firma del Contrato de partners de Microsoft del revendedor indirecto mediante el PartnerID del revendedor indirecto.
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
Solicitud con el identificador de inquilino de CSP
La solicitud de ejemplo siguiente obtiene el estado de firma del contrato Microsoft Partner Agreement del revendedor indirecto mediante el identificador de inquilino de CSP del revendedor indirecto (identificador de 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
Respuesta REST
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulta Error de REST del Centro de partners.
Ejemplo de respuestas (correctas)
La siguiente respuesta de ejemplo se devuelve correctamente si el revendedor indirecto ha firmado el contrato Microsoft Partner Agreement.
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
}
Ejemplos de respuestas (erróneas)
Es posible que reciba respuestas similares a los ejemplos siguientes cuando no se pueda devolver el estado de firma del Contrato de partners de Microsoft del revendedor indirecto.
Identificador de inquilino de CSP con un formato que no es de GUID
La respuesta de ejemplo siguiente se devuelve cuando el identificador de inquilino de CSP que pasaste a la API no es un 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"
}
PartnerID no numérico
La siguiente respuesta de ejemplo se devuelve cuando el PartnerID (PGA/PLA) que ha pasado a la API no es numérico.
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"
}
Ningún id. de inquilino de PartnerID o CSP
La siguiente respuesta de ejemplo se devuelve cuando no se ha pasado un PartnerID (PGA/PLA) o un identificador de inquilino de CSP a la API. Debe pasar uno de los dos tipos de identificador a la 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"
}
Id. de inquilino de PartnerID y CSP pasados
La siguiente respuesta de ejemplo se devuelve cuando se pasan partnerID (PGA/PLA) y el identificador de inquilino de CSP a la API. Solo debes pasar uno de los dos tipos de identificador a la API.
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 de revendedor indirecto de CSP (PGA/PLA) no es válido o no se migra desde el Centro de pertenencia de partners al Centro de partners
La siguiente respuesta de ejemplo se devuelve cuando se pasa partnerID de revendedor indirecto (PGA/PLA) no es válido o no se migra desde el Centro de pertenencia a partners al Centro de partners. Más información
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"
}
La región del proveedor indirecto de CSP y la región del revendedor indirecto de CSP no coinciden
La siguiente respuesta de ejemplo se devuelve cuando la región de PartnerID de revendedor indirecto (PGA/PLA) no coincide con la región del proveedor indirecto. Para más información, consulte Regiones de 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"
}
La cuenta de revendedor indirecto de CSP existe en el Centro de partners, pero no ha firmado el MPA
La siguiente respuesta de ejemplo se devuelve cuando la cuenta del revendedor indirecto de CSP del Centro de partners no ha firmado el MPA. Para más información, consulte Preguntas más frecuentes sobre el proveedor indirecto.
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"
}
No hay ninguna cuenta de revendedor indirecto de CSP asociada con el PartnerID especificado.
La siguiente respuesta de ejemplo se devuelve cuando el Centro de partners puede reconocer el PartnerID (PGA/PLA) pasado en la solicitud, pero no hay ninguna inscripción de CSP asociada al PartnerID (PGA/PLA). Para más información, consulte Preguntas más frecuentes sobre el proveedor indirecto.
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"
}
Id. de inquilino no válido
La siguiente respuesta de ejemplo se devuelve cuando el Centro de partners no encuentra ninguna cuenta asociada al identificador de inquilino que se ha pasado en la solicitud.
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"
}
No se encontró ningún MPA con el identificador de inquilino dado
La siguiente respuesta de ejemplo se devuelve cuando el Centro de partners no encuentra ninguna firma de MPA con el identificador de inquilino dado. Para más información, consulte Preguntas más frecuentes sobre el proveedor indirecto.
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"
}
Comentaris
Properament: al llarg del 2024 eliminarem gradualment GitHub Issues com a mecanisme de retroalimentació del contingut i el substituirem per un nou sistema de retroalimentació. Per obtenir més informació, consulteu: https://aka.ms/ContentUserFeedback.
Envieu i consulteu els comentaris de