Dela via


Få bekräftelse på kundgodkännande av Microsoft Cloud-avtal

Gäller för: Partnercenter

Gäller inte för: Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Avtalsresursen stöds för närvarande endast av Partnercenter i Microsofts offentliga moln.

Förutsättningar

  • Om du använder .NET SDK för Partnercenter krävs version 1.9 eller senare.

    Viktigt!

    Från och med juni 2023 arkiveras nu den senaste Partner Center .NET SDK-versionen 3.4.0. Du kan ladda ned SDK-versionen från GitHub tillsammans med en readme-fil som innehåller användbar information.

    Partner uppmanas att fortsätta att använda REST-API:er för Partnercenter.

  • Om du använder Java SDK för Partnercenter krävs version 1.8 eller senare.

  • Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast app - och användarautentisering.

  • Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).

.NET (version 1.4 eller senare)

Så här hämtar du bekräftelser på kundgodkännande som tidigare angavs:

  • Använd IAggregatePartner.Customers-samlingen och anropa ById-metoden med den angivna kundidentifieraren.

  • Hämta egenskapen Avtal och filtrera resultatet till Microsoft Cloud Agreement genom att anropa ByAgreementType-metoden.

  • Anropa Get - eller GetAsync-metoden .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCloudAgreement";

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

Ett fullständigt exempel finns i klassen GetCustomerAgreements från konsoltestappprojektet .

.NET (version 1.9 - 1.13)

Så här hämtar du bekräftelse på kundgodkännande som angavs tidigare:

Använd samlingen IAggregatePartner.Customers och anropa metoden ById med den angivna kundens identifierare. Hämta sedan egenskapen Avtal, följt av att anropa get- eller GetAsync-metoderna.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

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

Java

Java SDK för Partnercenter kan användas för att hantera Partnercenter-resurser. Det är ett projekt med öppen källkod som underhålls av partnercommunityn och stöds inte officiellt av Microsoft. Du kan få hjälp från communityn eller öppna ett problem på GitHub om du får problem.

Så här hämtar du bekräftelse på kundgodkännande som angavs tidigare:

Använd funktionen IAggregatePartner.getCustomers och anropa funktionen byId med den angivna kundens identifierare. Hämta sedan funktionen getAgreements följt av att anropa get-funktionen.

// IAggregatePartner partnerOperations;
// String selectedCustomerId;

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

Ett fullständigt exempel finns i klassen GetCustomerAgreements från konsoltestappprojektet .

PowerShell

PowerShell-modulen partnercenter kan användas för att hantera Partnercenter-resurser. Det är ett projekt med öppen källkod som underhålls av partnercommunityn och stöds inte officiellt av Microsoft. Du kan få hjälp från communityn eller öppna ett problem på GitHub om du får problem.

Så här hämtar du bekräftelse på kundgodkännande som angavs tidigare:

Använd kommandot Get-PartnerCustomerAgreement.

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

REST-begäran

Information om hur du hämtar bekräftelse av kundgodkännande som angavs tidigare finns i följande instruktioner.

Skapa en ny avtalsresurs med relevant certifieringsinformation.

Syntax för begäran

Metod URI för förfrågan
GET {baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

URI-parameter

Använd följande frågeparameter för att ange den kund som du bekräftar.

Namn Typ Obligatoriskt Beskrivning
CustomerTenantId GUID Y Värdet är ett GUID-formaterat CustomerTenantId som gör att du kan ange en kund.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Inga.

Exempel på begäran

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: aaaa0000-bb11-2222-33cc-444444dddddd

REST-svar

Om det lyckas returnerar den här metoden en samling avtalsresurser i svarstexten.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och annan felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och andra parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.

Svarsexempel

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "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://learn.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://learn.microsoft.com/partner-center/agreements"
        }
    ]
}