Získání metadat smluv pro Smlouvu o službách Microsoft Cloud

  • Článek
  • 2 min ke čtení

Platí pro: Partnerské centrum

Nevztahuje se na: Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud for US Government

Prostředek AgreementMetaData je aktuálně podporován Partnerským centrem 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ší.

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

  • Přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování aplikací a uživatelů.

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

Načtení metadat smlouvy pro Smlouvu o cloudu Microsoftu:

  1. Nejprve načtěte kolekci IAggregatePartner.AgreementDetails .

  2. Voláním metody ByAgreementType vyfiltrujte kolekci podle smlouvy Microsoft Cloud.

  3. Nakonec zavolejte metodu Get nebo GetAsync .

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCloudAgreement";

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

Kompletní ukázku najdete ve třídě GetAgreementDetails z projektu testovací aplikace konzoly .

.NET (verze 1.9 – 1.13)

Načtení metadat smlouvy pro smlouvu s Microsoft Cloudem:

Nejprve načtěte kolekci IAggregatePartner.AgreementDetails a pak volejte metody Get nebo GetAsync . Pak vyhledejte položku v kolekci, která odpovídá smlouvě Microsoft Cloud:

// IAggregatePartner partnerOperations;

var agreements = partnerOperations.AgreementDetails.Get();

AgreementMetaData microsoftCloudAgreement = agreements.Items.FirstOrDefault (agr => agr.AgreementType == AgreementType.MicrosoftCloudAgreement);

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ý microsoft oficiálně nepodporuje. Pokud se setkáte s problémem, můžete získat pomoc od komunity nebo otevřít problém na GitHubu .

Načtení metadat smlouvy pro smlouvu s Microsoft Cloudem:

Nejprve zavolejte funkci IAggregatePartner.getAgreementDetails a pak zavolejte funkci get . Pak vyhledejte položku v kolekci, která odpovídá smlouvě Microsoft Cloud:

// IAggregatePartner partnerOperations;

ResourceCollection<AgreementMetaData> agreements = partnerOperations.getAgreements().get();

AgreementMetaData microsoftCloudAgreement;

for (AgreementMetaData metadata : agreements)
{
    if(metadata.getAgreementType() == AgreementType.MicrosoftCloudAgreement)
    {
        microsoftCloudAgreement = metadata;
    }
}

Kompletní ukázku najdete ve třídě GetAgreementDetails z projektu testovací aplikace konzoly .

PowerShell

Ke správě prostředků Partnerského centra je možné použít modul PowerShell pro Partnerské centrum . Jedná se o opensourcový projekt spravovaný komunitou partnerů, který microsoft oficiálně nepodporuje. Pokud se setkáte s problémem, můžete získat pomoc od komunity nebo otevřít problém na GitHubu .

Načtení metadat smlouvy pro smlouvu s Microsoft Cloudem:

Použijte příkaz Get-PartnerAgreementDetail . Pak vyhledejte položku v kolekci, která odpovídá smlouvě Microsoft Cloud:

Get-PartnerAgreementDetail | Where-Object {$_.AgreementType -eq 'MicrosoftCloudAgreement'} | Select-Object -First 1

Požadavek REST

Pokud chcete načíst metadata smlouvy pro smlouvu Microsoft Cloud, nejprve vytvořte žádost REST o načtení kolekce AgreementMetaData . Pak vyhledejte položku v kolekci, která odpovídá smlouvě Microsoft Cloud.

Syntaxe požadavku

Metoda Identifikátor URI žádosti
GET {baseURL}/v1/agreements HTTP/1.1

Hlavičky požadavku

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

Text požadavku

Žádné

Příklad požadavku

GET https://api.partnercenter.microsoft.com/v1/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

V případě úspěchu tato metoda vrátí kolekci prostředků AgreementMetaData v textu odpovědi.

Úspěšné odpovědi a kódy chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo neúspěch, 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 rozhraní 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": 1,
    "items": [
        {
            "templateId": "998b88de-aa99-4388-a42c-1b3517d49490",
            "agreementType": "MicrosoftCloudAgreement",
            "agreementLink": "https://learn.microsoft.com/partner-center/agreements",
            "versionRank": 0
        }
    ],
    "links": {
        "self": {
            "uri": "/agreements",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

Pokud chcete v odpovědi identifikovat prostředek, který odpovídá smlouvě Microsoft Cloud, vyhledejte prostředek, jehož vlastnost agreementType má hodnotu MicrosoftCloudAgreement.