Megosztás a következőn keresztül:

Egy ügyfél konfigurációs szabályzatának lekérése

  • Cikk

A következőre vonatkozik: Partnerközpont

A megadott ügyfél konfigurációs szabályzatának lekérése.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja a hitelesítést önálló alkalmazással és app+felhasználói hitelesítő adatokkal is.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület, majd az ügyféllista ügyféllistájából, majd a Fiók lehetőség kiválasztásával. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

  • A szabályzat azonosítója.

C#

A megadott ügyfél konfigurációs szabályzatának lekéréséhez először hívja meg az IAggregatePartner.Customers.ById metódust az ügyfélazonosítóval, hogy lekérjen egy felületet a megadott ügyfél műveleteihez. Ezután hívja meg a ConfigurationPolicies.ById metódust a szabályzatazonosítóval, hogy lekérjen egy felületet a megadott szabályzat konfigurációs szabályzatműveleteihez. Végül hívja meg a Get vagy a GetAsync metódust a konfigurációs szabályzat lekéréséhez.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedConfigurationPolicyId;

ConfigurationPolicy retrievedConfigurationPolicy =
    partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.ById(selectedConfigurationPolicyId).Get();

Minta: Konzolteszt alkalmazás. Projekt: Partnerközpont SDK-minták osztálya: GetConfigurationPolicy.cs

REST-kérelem

Kérés szintaxisa

Metódus Kérés URI-ja
GET {baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

URI-paraméter

A kérés létrehozásakor használja az alábbi elérési utat és lekérdezési paramétereket.

Név Típus Kötelező Leírás
ügyfél-azonosító sztring Igen Egy GUID formátumú sztring, amely azonosítja az ügyfelet.
policy-id sztring Igen A szabályzatot azonosító GUID formátumú sztring.

Kérésfejlécek

További információt a Partnerközpont REST-fejlécei című témakörben talál.

A kérés törzse

None

Példa kérésre

GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies/56edf752-ee77-4fd8-b7f5-df1f74a3a9ac HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Length: 0
Host: api.partnercenter.microsoft.com

REST-válasz

Ha sikeres, a válasz tartalmazza a kért ConfigurationPolicy erőforrást .

Sikeres válasz és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. A teljes listát a Partnerközpont REST-hibakódjai című témakörben találja.

Példa válaszra

HTTP/1.1 200 OK
Content-Length: 443
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: ab3abfe7-dce7-46c0-ab20-4fd49bc3e2f7
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:08:27 GMT

{
    "id": "56edf752-ee77-4fd8-b7f5-df1f74a3a9ac",
    "name": "Test policy",
    "category": "o_o_b_e",
    "description": "Test policy creation from API 1",
    "devicesAssigned": 0,
    "policySettings": ["skip_express_settings"],
    "createdDate": "2017-07-25T11:03:03.8457116-07:00",
    "lastModifiedDate": "2017-07-25T11:04:00.8149974-07:00",
    "attributes": {
        "objectType": "ConfigurationPolicy"
    }
}