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"
}
]
}