Het configuratiebeleid van een klant ophalen

Van toepassing op: Partner Center | Partner Center voor Microsoft Cloud Duitsland

Het opgegeven configuratiebeleid voor de opgegeven klant ophalen.

Vereisten

  • Referenties zoals beschreven in Partner Center verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

  • Een klant-id (customer-tenant-id). Als u de id van de klant niet weet, kunt u deze op zoeken in het Partner Center dashboard. Selecteer CSP in het Partner Center menu, gevolgd door Klanten. Selecteer de klant in de lijst met klanten en selecteer vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

  • De beleids-id.

C#

Als u een configuratiebeleid voor de opgegeven klant wilt ophalen, roept u eerst de methode IAggregatePartner.Customers.ById aan met de klant-id om een interface op te halen voor bewerkingen op de opgegeven klant. Roep vervolgens de methode ConfigurationPolicies.ById aan met de beleids-id om een interface op te halen voor configuratiebeleidsbewerkingen voor het opgegeven beleid. Roep ten slotte de methode Get of GetAsync aan om het configuratiebeleid op te halen.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedConfigurationPolicyId;

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

Voorbeeld: Consoletest-app. Project: Partnercentrum-SDK Samples Class: GetConfigurationPolicy.cs

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
TOEVOEGEN {baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

URI-parameter

Gebruik het volgende pad en de queryparameters bij het maken van de aanvraag.

Naam Type Vereist Beschrijving
customer-id tekenreeks Yes Een tekenreeks in GUID-indeling die de klant identificeert.
policy-id tekenreeks Yes Een tekenreeks in GUID-indeling die het beleid identificeert.

Aanvraagheaders

Zie REST-headers Partner Center meer informatie.

Aanvraagbody

Geen

Voorbeeld van aanvraag

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: de894e18-f027-4ac0-8b5a-34f0c222af0c
X-Locale: en-US
Content-Length: 0
Host: api.partnercenter.microsoft.com

REST-antwoord

Als dit lukt, bevat het antwoord de aangevraagde ConfigurationPolicy-resource .

Antwoord geslaagd en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of het is gelukt of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerk traceer om deze code, het fouttype en aanvullende parameters te lezen. Zie REST-foutcodes voor Partner Center lijst.

Voorbeeld van antwoord

HTTP/1.1 200 OK
Content-Length: 443
MS-CorrelationId: abe150cf-c677-435c-b5d5-b34899a6d1ec
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"
    }
}