Verificar o status de assinatura de um Contrato de Parceiro da Microsoft de um revendedor indireto
Aplica-se a: Partner Center | Partner Center para o Microsoft Cloud for US Government
Você pode verificar se um revendedor indireto assinou o Contrato de Parceiro da Microsoft usando sua ID de Parceiro (PGA/PLA) ou ID de locatário (ID da Microsoft) do Provedor de Soluções na Nuvem (CSP). Você pode usar um desses identificadores para verificar o status de assinatura do Contrato de Parceiro da Microsoft usando a API AgreementStatus.
Pré-requisitos
Credenciais, conforme descrito em Autenticação do Partner Center. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de usuário.
O PARTNER ID (PGA/PLA) ou o CSP tenant ID (Microsoft ID) do revendedor indireto. Você precisa usar um desses dois identificadores.
C#
Para obter o status de assinatura do Contrato de Parceiro da Microsoft de um revendedor indireto:
Use a coleção IAggregatePartner.Compliance para chamar a propriedade AgreementSignatureStatus.
Chame o método 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");
- Exemplo: Aplicativo de teste de console
- Projeto: PartnerCenterSDK.FeaturesSamples
- Classe: GetAgreementSignatureStatus.cs
Solicitação REST
Sintaxe da solicitação
| Método | URI da solicitação |
|---|---|
| GET | {baseURL}/v1/compliance/{ProgramName}/agreementstatus?mpnId={MpnId}&tenantId={TenantId} |
Parâmetros do URI
Você precisa fornecer um dos dois parâmetros de consulta a seguir para identificar o parceiro. Se você não fornecer um desses dois parâmetros de consulta, receberá um erro 400 (Erro na solicitação).
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| MpnId | int | Não | Um PartnerID (PGA/PLA) que identifica o revendedor indireto. |
| TenantId | GUID | Não | Uma ID da Microsoft que identifica a conta do CSP o revendedor indireto. |
Cabeçalhos da solicitação
Para obter mais informações, confira REST do Partner Center.
Exemplos de solicitação
Solicitação usando PartnerID (PGA/PLA)
A solicitação de exemplo a seguir obtém o status de assinatura do Contrato de Parceiro da Microsoft do revendedor indireto usando o PartnerID do revendedor indireto.
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
Solicitação usando a ID do locatário do CSP
A solicitação de exemplo a seguir obtém o status de assinatura do Contrato de Parceiro da Microsoft do revendedor indireto usando a ID do locatário do CSP (ID da 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
Resposta REST
Códigos de êxito e de erro de resposta
Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Erros do REST do Partner Center.
Exemplo de resposta (êxito)
A resposta de exemplo a seguir retorna com êxito se o revendedor indireto assinou ou não o Contrato de Parceiro da 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
}
Exemplos de resposta (falha)
Você pode receber respostas semelhantes aos exemplos a seguir quando o status de assinatura do Contrato de Parceiro da Microsoft do revendedor indireto não puder ser retornado.
ID de locatário do CSP formatada para não GUID
A resposta de exemplo a seguir é retornada quando a ID do locatário do CSP que você passou para a API não é um 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"
}
ID de parceiro não numérico
A resposta de exemplo a seguir é retornada quando o PartnerID (PGA/PLA) que você passou para a API não é 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"
}
Sem PartnerID ou CSP tenant ID
A resposta de exemplo a seguir é retornada quando você não passou um ID de locatário PartnerID (PGA/PLA) ou CSP para a API. Você precisa passar um dos dois tipos de ID para a 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"
}
O PartnerID e o CSP tenant ID foram aprovados
A resposta de exemplo a seguir é retornada quando você passa o PartnerID (PGA/PLA) e o ID do locatário CSP para a API. Você precisa passar somente um dos dois tipos de identificador para a 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"
}
O CSP Indirect Reseller PartnerID (PGA/PLA) é inválido ou não foi migrado do Partner Membership Center para o Partner Center
A resposta de exemplo a seguir é retornada quando o PartnerID (PGA/PLA) do revendedor indireto passado é inválido ou não é migrado do Partner Membership Center para o Partner Center. Saiba mais
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"
}
A região do CSP Indirect Provider e a região do CSP Indirect Reseller não correspondem
A resposta de exemplo a seguir é retornada quando a região do PartnerID DO REVENDEDOR INDIRETO (PGA/PLA) não corresponde à região do Provedor Indireto. Para saber mais, consulte Regiões 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"
}
A conta do CSP Indirect Reseller existe no Partner Center, mas não assinou o MPA
A resposta de exemplo a seguir será retornada quando a conta do CSP Indirect Reseller no Partner Center não tiver assinado o MPA. Para saber mais, consulte Perguntas frequentes sobre provedores indiretos.
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"
}
Nenhuma conta de Revendedor Indireto CSP está associada ao PartnerID fornecido
A resposta de exemplo a seguir é retornada quando o Partner Center pode reconhecer o PartnerID (PGA/PLA) passado na solicitação, mas não há registro CSP associado ao PartnerID (PGA/PLA) fornecido. Para saber mais, consulte Perguntas frequentes sobre provedores indiretos.
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 locatário inválida
A resposta de exemplo a seguir será retornada quando o Partner Center não localizar nenhuma conta associada à ID de locatário passada na solicitação.
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"
}
Nenhum MPA foi encontrado com a ID de locatário fornecida
A resposta de exemplo a seguir será retornada quando o Partner Center não conseguir encontrar nenhuma assinatura do MPA com a ID de locatário fornecida. Para saber mais, consulte Perguntas frequentes sobre provedores indiretos.
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"
}
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de