Een nieuw configuratiebeleid maken voor de opgegeven klant

Artikel
09/11/2024

Van toepassing op: Partnercentrum

Een nieuw configuratiebeleid maken voor de opgegeven klant.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als App+User-referenties.
Een klant-id (customer-tenant-id). Als u de id van de klant niet weet, kunt u deze opzoeken in partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de klantenlijst en 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).

C#

Een nieuw configuratiebeleid maken voor de opgegeven klant:

Maak een instantie van een nieuw ConfigurationPolicy-object , zoals wordt weergegeven in het volgende codefragment. Roep vervolgens de methode IAggregatePartner.Customers.ById aan met de klant-id om een interface op te halen voor bewerkingen op de opgegeven klant.
Haal de eigenschap ConfigurationPolicies op om een interface op te halen voor configuratiebeleidsverzamelingsbewerkingen.
Roep de methode Create of CreateAsync aan om het configuratiebeleid te maken.

C#-voorbeeld

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var configurationPolicyToCreate = new ConfigurationPolicy
{
    Name = "Test Config Policy",
    Description = "This configuration policy is created by the SDK samples",
    PolicySettings = new List<PolicySettingsType>() {
        PolicySettingsType.OobeUserNotLocalAdmin,
        PolicySettingsType.SkipEula }
};

var createdConfigurationPolicy =
    partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.Create(configurationPolicyToCreate);

Voorbeeld: Consoletest-app. Project: Partner Center SDK-voorbeeldklasse: CreateConfigurationPolicy.cs

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameter

Gebruik de volgende padparameters bij het maken van de aanvraag.

Naam	Type	Vereist	Beschrijving
klant-id	tekenreeks	Ja	Een tekenreeks in GUID-indeling die de klant identificeert.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

De aanvraagbody moet een object bevatten met de configuratiebeleidsgegevens, zoals beschreven in de volgende tabel:

Naam	Type	Vereist	Beschrijving
naam	tekenreeks	Ja	De beschrijvende naam van het beleid.
category	tekenreeks	Ja	De beleidscategorie.
beschrijving	tekenreeks	No	De beleidsbeschrijving.
policySettings	tekenreeksmatrix	Yes	De beleidsinstellingen.

Voorbeeld van aanvraag

POST 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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Length: 212
Content-Type: application/json
Host: api.partnercenter.microsoft.com

{
    "name": "Windows 10 Enterprise E5",
    "category": "o_o_b_e",
    "description": "test policy creation from API",
    "policySettings": ["oobe_user_not_local_admin", "skip_express_settings"]
}

REST-antwoord

Als dit lukt, bevat de antwoordtekst de ConfigurationPolicy-resource voor het nieuwe beleid.

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partner Center REST-foutcodes voor de volledige lijst.

Voorbeeld van antwoord

HTTP/1.1 200 OK
Content-Length: 404
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 0dfadf74-aa66-49ed-9a67-b3b78d9297cc
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:07:36 GMT

{
    "id": "40cdb858-edcc-44d7-9083-d6a36d43bd3f",
    "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-25T18:07:36",
    "lastModifiedDate": "2017-07-25T18:07:36",
    "attributes": {
        "objectType": "ConfigurationPolicy"
    }
}

Delen via