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

Egy ügyfél szabályzati listájának lekérése

  • Cikk

A következőre vonatkozik: Partnerközpont

Ez a cikk bemutatja, hogyan kérhető le a megadott ügyfél konfigurációs szabályzatainak gyűjteménye.

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, keresse meg a Partnerközpontban. Válassza az Ügyfelek munkaterületet a Partnerközpont kezdőlapján. Válassza ki az ügyfelet az Ügyfél listából, majd válassza a Fiók lehetőséget. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók részletei szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

C#

Az ügyfél összes szabályzatának lekérése:

  1. 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.

  2. A ConfigurationPolicies tulajdonság lekérésével lekérheti a konfigurációs házirend-gyűjtési műveletek felületét.

  3. Hívja meg a Get vagy a GetAsync metódust a szabályzatok gyűjteményének lekéréséhez.

IAggregatePartner partnerOperations;
string selectedCustomerId;

var configPolicies = partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.Get();

Példaként tekintse meg a következőket:

REST-kérelem

Kérés szintaxisa

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

URI-paraméter

A kérés létrehozásakor használja a következő elérésiút-paramétert:

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.

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 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: de894e18-f027-4ac0-8b5a-34f0c222af0c
Content-Length:0
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-válasz

Ha sikeres, a válasz törzse tartalmazza a ConfigurationPolicy-erőforrások gyűjteményét.

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: 1221
Content-Type: application/json; charset=utf-8
MS-CorrelationId: d5ff2573-3ef8-4553-aac4-4b73d97dce1b
MS-RequestId: 6eb7383d-eeb5-44d7-8570-e0ed12c0547a
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:07:49 GMT

{
    "totalCount": 3,
    "items": [{
            "id": "8c7d25aa-2dbb-409c-a1f0-f55bd9108fa9",
            "name": "Windows 10 Enterprise E3",
            "category": "o_o_b_e",
            "description": "P462017 description",
            "devicesAssigned": 0,
            "policySettings": ["oobe_user_not_local_admin", "skip_express_settings"],
            "createdDate": "2017-04-27T11:30:34.1944704-07:00",
            "lastModifiedDate": "2017-04-27T11:30:34.1944704-07:00",
            "attributes": {
                "objectType": "ConfigurationPolicy"
            }
        }, {
            "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.8457088-07:00",
            "lastModifiedDate": "2017-07-25T11:04:00.8150016-07:00",
            "attributes": {
                "objectType": "ConfigurationPolicy"
            }
        }, {
            "id": "a96b5fd9-0f3a-419a-b55c-a8aecd6b1f00",
            "name": "Windows 10 Enterprise E5",
            "category": "o_o_b_e",
            "description": "test policy creation from API",
            "devicesAssigned": 0,
            "policySettings": ["oobe_user_not_local_admin", "skip_express_settings"],
            "createdDate": "2017-07-25T11:07:36.1501184-07:00",
            "lastModifiedDate": "2017-07-25T11:07:36.1501184-07:00",
            "attributes": {
                "objectType": "ConfigurationPolicy"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}