Obter metadados de contrato para o Contrato de Cliente Microsoft

  • Artigo
  • 2 minutos para ler

Aplica-se a: Centro de Parceiros

Não se aplica a: Partner Center operado pela 21Vianet | Centro de Parceiros para Microsoft Cloud for US Government

Os metadados do acordo para Contrato de Cliente Microsoft são atualmente suportados pelo Partner Center apenas na nuvem pública da Microsoft.

Deve recuperar os metadados do acordo para o Contrato de Cliente Microsoft antes de poder:

Pré-requisitos

  • Se estiver a utilizar o Partner Center .NET SDK, é necessária a versão 1.14 ou mais recente.

  • Credenciais descritas na autenticação do Partner Center. Este cenário suporta apenas a autenticação app+User.

.NET (versão 1.14 ou mais recente)

Para recuperar os metadados do acordo para Contrato de Cliente Microsoft:

  1. Primeiro, recupere a coleção IAggregatePartner.AgreementDetails .

  2. Ligue para o método ByAgreementType para filtrar a coleção para Contrato de Cliente Microsoft.

  3. Finalmente, ligue para o método Get ou GetAsync .

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();

Uma amostra completa pode ser encontrada na classe GetAgreementDetails do projeto de aplicações de teste de consola .

Pedido de DESCANSO

Para recuperar os metadados do acordo para Contrato de Cliente Microsoft:

  1. Crie um pedido DE REST para recuperar a coleção AgreementMetaData .

  2. Utilize o parâmetro de consulta de acordoso o resultado apenas para o Contrato de Cliente Microsoft.

Solicitar sintaxe

Método URI do pedido
GET {baseURL}/v1/agreements?agreementType={agreement-type} HTTP/1.1

Parâmetros URI

Nome Tipo Necessário Descrição
tipo de acordo cadeia (de carateres) No Utilize este parâmetro para estender a resposta de consulta ao tipo de acordo específico. Os valores suportados são:

MicrosoftCloudAgreement que inclui metadados de acordo apenas do tipo MicrosoftCloudAgreement

MicrosoftCustomerAgreement que inclui metadados de acordo apenas do tipo MicrosoftCustomerAgreement.

* que devolve todos os metadados do acordo. (Não utilize * a menos que o seu código tenha a lógica de tempo de execução necessária para lidar com tipos de acordos desconhecidos porque a Microsoft pode introduzir metadados de acordo com novos tipos de acordo a qualquer momento.)

Nota: Se o parâmetro URI não for especificado, a consulta predefine o MicrosoftCloudAgreement para retrocompatibilidade.

Cabeçalhos do pedido

Para obter mais informações, consulte os cabeçalhos Partner Center REST.

Corpo do pedido

Nenhum.

Exemplo de pedido

GET https://api.partnercenter.microsoft.com/v1/agreements?agreementType=MicrosoftCustomerAgreement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

Resposta do REST

Se for bem sucedido, este método devolve uma coleção de recursos AgreementMetaData no organismo de resposta.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de estado HTTP que indica sucesso ou falha e informações adicionais de depuragem.

Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte os códigos de erro do Partner Center REST.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 1,
    "items": [
        {
            "templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
            "agreementType": "MicrosoftCustomerAgreement",
            "agreementLink": "https://aka.ms/customeragreement",
            "versionRank": 0
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}