Een configuratiebeleid bijwerken voor de opgegeven klant

Artikel
09/11/2024

Van toepassing op: Partnercentrum

Het bijwerken van het opgegeven configuratiebeleid 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 lijst met klanten 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).
De beleids-id.

C#

Als u een bestaand configuratiebeleid voor de opgegeven klant wilt bijwerken, maakt u een nieuw ConfigurationPolicy-object , zoals wordt weergegeven in het volgende codefragment. De waarden in dit nieuwe object vervangen de bijbehorende waarden in het bestaande object. Roep vervolgens 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 patch - of PatchAsync-methode aan om het configuratiebeleid bij te werken.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedConfigurationPolicyId;

ConfigurationPolicy configPolicyToBeUpdated = new ConfigurationPolicy()
{
    Name= "Test Config Policy",
    Id = selectedConfigurationPolicyId,
    PolicySettings = new List<PolicySettingsType>() {
        PolicySettingsType.OobeUserNotLocalAdmin,
        PolicySettingsType.RemoveOemPreinstalls }
};

ConfigurationPolicy updatedConfigurationPolicy =
    partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.ById(selectedConfigurationPolicyId).Patch(configPolicyToBeUpdated);

Voorbeeld: Console-test-app. Project: Partner Center SDK-voorbeeldklasse: UpdateConfigurationPolicy.cs

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
PUT	{baseURL}/v1/customers/{customer-id}/policies/{policy-id} 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.
policy-id	tekenreeks	Ja	Een tekenreeks met GUID-indeling die het beleid identificeert dat moet worden bijgewerkt.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

De aanvraagbody moet een object bevatten dat de beleidsinformatie levert.

Naam	Type	Vereist	Bijgewerkt	Beschrijving
id	tekenreeks	Ja	Nee	De tekenreeks in GUID-indeling die het beleid identificeert.
naam	tekenreeks	Ja	Ja	De beschrijvende naam van het beleid.
category	tekenreeks	Ja	Nee	De beleidscategorie.
beschrijving	tekenreeks	No	Ja	De beleidsbeschrijving.
devicesAssigned	getal	No	Nee	Het aantal apparaten.
policySettings	tekenreeksmatrix	Ja	Ja	De beleidsinstellingen: "none","remove_oem_preinstalls","oobe_user_not_local_admin","skip_express_settings","skip _oem_registration,"skip_eula".

Voorbeeld van aanvraag

PUT 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: 256
Content-Type: application/json
Host: api.partnercenter.microsoft.com

{
    "id": "56edf752-ee77-4fd8-b7f5-df1f74a3a9ac",
    "name": "Windows test policy",
    "category": "o_o_b_e",
    "description": "Test policy creation from API",
    "devicesAssigned": 0,
    "policySettings": ["skip_express_settings"]
}

REST-antwoord

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

Geslaagde en foutcodes voor antwoorden

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het is gelukt of mislukt 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: 421
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb1fa1f3-1381-45d9-99c5-511e5d3efa7c
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:10:29 GMT

{
    "id": "56edf752-ee77-4fd8-b7f5-df1f74a3a9ac",
    "name": "Windows test policy",
    "category": "o_o_b_e",
    "description": "Test policy creation from API",
    "devicesAssigned": 0,
    "policySettings": ["skip_express_settings"],
    "createdDate": "2017-01-01T00:00:00",
    "lastModifiedDate": "2017-07-25T18:10:15",
    "attributes": {
        "objectType": "ConfigurationPolicy"
    }
}

Delen via