Získání potvrzení přijetí Smlouvy o službách Microsoft Cloud ze strany zákazníka

  • Článek

Platí pro: Partnerské centrum

Nevztahuje se na: Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Prostředek smlouvy v současné době podporuje Partnerské centrum pouze ve veřejném cloudu Microsoftu.

Požadavky

  • Pokud používáte sadu .NET SDK partnerského centra, vyžaduje se verze 1.9 nebo novější.

    Důležité

    Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.

    Doporučujeme, aby partneři dál používali rozhraní REST API Partnerského centra.

  • Pokud používáte sadu Java SDK partnerského centra, vyžaduje se verze 1.8 nebo novější.

  • Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje pouze ověřování aplikací a uživatelů.

  • ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

.NET (verze 1.4 nebo novější)

Načtení potvrzení přijetí zákazníka, které bylo dříve poskytnuto:

  • Použijte kolekci IAggregatePartner.Customers a volejte metodu ById se zadaným identifikátorem zákazníka.

  • Načtěte vlastnost Agreements a vyfiltrujte výsledky do smlouvy Microsoft Cloud voláním ByAgreementType metoda.

  • Volání metody Get nebo GetAsync

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCloudAgreement";

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

Úplnou ukázku najdete ve třídě GetCustomerAgreements z projektu testovací aplikace konzoly.

.NET (verze 1.9 – 1.13)

Načtení potvrzení přijetí zákazníka poskytnutého dříve:

Použijte kolekci IAggregatePartner.Customers a volejte metodu ById s identifikátorem zadaného zákazníka. Pak získejte vlastnost Agreements následované voláním Get nebo GetAsync metody.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

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

Java

Sadu Java SDK Partnerského centra je možné použít ke správě prostředků Partnerského centra. Jedná se o opensourcový projekt spravovaný komunitou partnerů, který oficiálně nepodporuje Microsoft. Pokud narazíte na problém, můžete získat pomoc od komunity nebo otevřít problém na GitHubu .

Načtení potvrzení přijetí zákazníka poskytnutého dříve:

Použijte funkci IAggregatePartner.getCustomers a volejte funkci byId s identifikátorem zadaného zákazníka. Pak získejte funkci getAgreements a potom voláním funkce get .

// IAggregatePartner partnerOperations;
// String selectedCustomerId;

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

Úplnou ukázku najdete ve třídě GetCustomerAgreements z projektu testovací aplikace konzoly.

PowerShell

Modul PowerShellu v Partnerském centru se dá použít ke správě prostředků Partnerského centra. Jedná se o opensourcový projekt spravovaný komunitou partnerů, který oficiálně nepodporuje Microsoft. Pokud narazíte na problém, můžete získat pomoc od komunity nebo otevřít problém na GitHubu .

Načtení potvrzení přijetí zákazníka poskytnutého dříve:

Použijte příkaz Get-PartnerCustomerAgreement.

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

Požadavek REST

Pokud chcete načíst potvrzení přijetí zákazníka poskytnutého dříve, přečtěte si následující pokyny.

Vytvořte nový prostředek smlouvy s příslušnými informacemi o certifikaci.

Syntaxe požadavku

metoda Identifikátor URI žádosti
GET {baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

Parametr identifikátoru URI

Pomocí následujícího parametru dotazu zadejte zákazníka, kterého potvrzujete.

Name Type Požadováno Popis
CustomerTenantId Identifikátor GUID Y Hodnota je IDENTIFIKÁTOR GUID formátovaný CustomerTenantId , který umožňuje zadat zákazníka.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Nezaokrouhlovat.

Příklad požadavku

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

Odpověď REST

Pokud je tato metoda úspěšná, vrátí v textu odpovědi kolekci prostředků smlouvy .

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklad odpovědi

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