Obter a confirmação da aceitação do Contrato do Microsoft Cloud pelo clienteGet confirmation of customer acceptance of Microsoft Cloud Agreement

Aplica-se aApplies To

  • Partner CenterPartner Center

Observação

O recurso de contrato atualmente tem suporte do Partner Center na nuvem pública da Microsoft.The Agreement resource is currently supported by Partner Center in the Microsoft public cloud only. Não é aplicável a:It isn't applicable to:

  • Partner Center operado pela 21VianetPartner Center operated by 21Vianet
  • Partner Center do Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Partner Center do Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Pré-requisitosPrerequisites

  • Se você estiver usando o SDK do .NET do Partner Center, a versão 1,9 ou mais recente será necessária.If you are using the Partner Center .NET SDK, version 1.9 or newer is required.

  • Se você estiver usando o SDK Java do Partner Center, a versão 1,8 ou mais recente será necessária.If you are using the Partner Center Java SDK, version 1.8 or newer is required.

  • Credenciais, conforme descrito em Autenticação do Partner Center.Credentials as described in Partner Center authentication. Esse cenário oferece suporte apenas à autenticação de aplicativo + usuário.This scenario supports only supports app + user authentication.

  • Uma ID do cliente (customer-tenant-id).A customer ID (customer-tenant-id). Se você não souber a ID do cliente, poderá procurar no painel do Partner Center.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecione CSP no menu do Partner Center e, em seguida, Clientes.Select CSP from the Partner Center menu, followed by Customers. Selecione o cliente na lista de clientes e selecione Conta.Select the customer from the customer list, then select Account. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

.NET (versão 1,4 ou mais recente).NET (version 1.4 or newer)

Para recuperar a (s) confirmação (ões) de aceitação do cliente que foi fornecida anteriormente:To retrieve confirmation(s) of customer acceptance that was previously provided:

  • Use a coleção IAggregatePartner. Customers e chame o método ById com o identificador de cliente especificado.Use the IAggregatePartner.Customers collection and call ById method with the specified customer identifier.

  • Busque a propriedade Agreements e filtre os resultados para Microsoft Cloud acordo chamando o método ByAgreementType .Fetch the Agreements property and filter the results to Microsoft Cloud Agreement by calling ByAgreementType method.

  • Chame o método Get ou getasync .Call Get or GetAsync method.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCloudAgreement";

var cloudAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Um exemplo completo pode ser encontrado na classe GetCustomerAgreements do projeto de aplicativo de teste do console .A complete sample can be found in the GetCustomerAgreements class from the console test app project.

.NET (versão 1,9-1,13).NET (version 1.9 - 1.13)

Para recuperar a confirmação da aceitação do cliente fornecida anteriormente:To retrieve confirmation of customer acceptance provided previously:

Use a coleção IAggregatePartner. Customers e chame o método ById com o identificador do cliente especificado.Use the IAggregatePartner.Customers collection and call the ById method with the specified customer's identifier. Em seguida, obtenha a propriedade Agreements , seguida chamando os métodos Get ou getasync .Then, get the Agreements property, followed by calling the Get or GetAsync methods.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var agreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Get();

JavaJava

O SDK do Java do Partner Center geralmente é usado por parceiros para gerenciar os recursos do Partner Center.The Partner Center Java SDK is commonly used by partners to manage their Partner Center resources. É um projeto de software livre mantido pela comunidade de parceiros.It's an open-source project maintained by the partner community. Esse módulo é mantido pela comunidade de parceiros e, por isso, não tem suporte oficial da Microsoft.Since this module is maintained by the partner community, it isn't officially supported by Microsoft. Caso se depare com um problema, você pode obter ajuda da comunidade ou abrir um problema no GitHub.You can get help from the community or open an issue on GitHub if you experience a problem.

Para recuperar a confirmação da aceitação do cliente fornecida anteriormente:To retrieve confirmation of customer acceptance provided previously:

Use a função IAggregatePartner. GetCustomers e chame a função byId com o identificador do cliente especificado.Use the IAggregatePartner.getCustomers function and call the byId function with the specified customer's identifier. Em seguida, obtenha a função Getagreements , seguida chamando a função Get .Then, get the getAgreements function, followed by calling the get function.

// IAggregatePartner partnerOperations;
// String selectedCustomerId;

ResourceCollection<Agreement> agreements = partnerOperations.getCustomers().byId(selectedCustomerId).getAgreements().get();

Um exemplo completo pode ser encontrado na classe GetCustomerAgreements do projeto de aplicativo de teste do console .A complete sample can be found in the GetCustomerAgreements class from the console test app project.

PowerShellPowerShell

O módulo PowerShell do Partner Center é normalmente usado por parceiros para gerenciar os recursos do Partner Center.The Partner Center PowerShell module is commonly used by partners to manage their Partner Center resources. É um projeto de software livre mantido pela comunidade de parceiros.It's an open-source project maintained by the partner community. Esse módulo é mantido pela comunidade de parceiros e, por isso, não tem suporte oficial da Microsoft.Since this module is maintained by the partner community, it isn't officially supported by Microsoft. Caso se depare com um problema, você pode obter ajuda da comunidade ou abrir um problema no GitHub.You can get help from the community or open an issue on GitHub if you experience a problem.

Para recuperar a confirmação da aceitação do cliente fornecida anteriormente:To retrieve confirmation of customer acceptance provided previously:

Use o comando Get-PartnerCustomerAgreement .Use the Get-PartnerCustomerAgreement command.

Get-PartnerCustomerAgreement -CustomerId '14876998-c0dc-46e6-9d0c-65a57a6c32ec'

Solicitação RESTREST request

Para recuperar a confirmação da aceitação do cliente fornecida anteriormente, consulte as instruções a seguir.To retrieve confirmation of customer acceptance provided previously, see the following instructions.

Crie um novo recurso de contrato com as informações de certificação relevantes.Create a new Agreement resource with the relevant certification information.

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
GETGET {baseURL} /v1/customers/{customer-tenant-id}/agreements HTTP/1.1{baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

Parâmetro do URIURI parameter

Use o parâmetro de consulta a seguir para especificar o cliente que você está confirmando.Use the following query parameter to specify the customer you are confirming.

NomeName TipoType ObrigatórioRequired DescriçãoDescription
CustomerTenantIdCustomerTenantId GUIDGUID SY O valor é um CustomerTenantId formatado de GUID que permite que você especifique um cliente.The value is a GUID formatted CustomerTenantId that allows you to specify a customer.

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, confira Cabeçalhos REST do Partner Center.For more information, see Partner Center REST headers.

Corpo da solicitaçãoRequest body

Nenhum.None.

Exemplo de solicitaçãoRequest example

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

Resposta RESTREST response

Se for bem-sucedido, esse método retornará uma coleção de recursos de contrato no corpo da resposta.If successful, this method returns a collection of Agreement resources in the response body.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter a lista completa, confira Códigos de erro REST do Partner Center.For the full list, see Partner Center REST error codes.

Exemplo de respostaResponse example

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": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2018-07-28T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://docs.microsoft.com/partner-center/agreements"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2017-08-01T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://docs.microsoft.com/partner-center/agreements"
        }
    ]
}