Aktualizace zásad konfigurace pro konkrétního zákazníka

Článek
09/11/2024

Platí pro: Partnerské centrum

Postup aktualizace zadaných zásad konfigurace pro zadaného zákazníka

Požadavky

Přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
ID zákazníka (customer-tenant-id). Pokud ID zákazníka neznáte, můžete ho vyhledat v Partnerském centru tak, že vyberete pracovní prostor Zákazníci , pak zákazníka ze seznamu zákazníků a pak Účet. Na stránce Účet zákazníka vyhledejte ID Microsoft v části Informace o účtu zákazníka . ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
Identifikátor zásad.

C#

Pokud chcete aktualizovat existující zásady konfigurace pro zadaného zákazníka, vytvořte instanci nového objektu ConfigurationPolicy , jak je znázorněno v následujícím fragmentu kódu. Hodnoty v tomto novém objektu nahradí odpovídající hodnoty v existujícím objektu. Pak zavolejte metodu IAggregatePartner.Customers.ById s ID zákazníka, která načte rozhraní pro operace u zadaného zákazníka. Dále zavolejte metodu ConfigurationPolicies.ById s ID zásady pro načtení rozhraní pro operace zásad konfigurace pro zadanou zásadu. Nakonec zavolejte metodu Patch nebo PatchAsync a aktualizujte zásady konfigurace.

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);

Ukázka: Testovací aplikace konzoly Projekt: Ukázky sady SDK Partnerského centra – třída: UpdateConfigurationPolicy.cs

Požadavek REST

Syntaxe požadavku

Metoda	Identifikátor URI žádosti
PUT	{baseURL}/v1/customers/{id_zákazníka}/policies/{id_zásady} HTTP/1.1

Parametr identifikátoru URI

Při vytváření požadavku použijte následující parametry cesty.

Název	Typ	Vyžadováno	Popis
ID zákazníka	řetězec	Yes	Řetězec ve formátu GUID, který identifikuje zákazníka.
policy-ID	řetězec	Yes	Řetězec ve formátu GUID, který identifikuje zásady, které se mají aktualizovat.

Hlavičky požadavku

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Text požadavku musí obsahovat objekt, který poskytuje informace o zásadách.

Název	Typ	Vyžadováno	Aktualizovatelné	Description
id	řetězec	Yes	No	Řetězec ve formátu GUID, který identifikuje zásadu.
name	řetězec	Yes	Yes	Popisný název zásady
category	řetězec	Yes	No	Kategorie zásad.
description	řetězec	No	Yes	Popis zásad.
zařízeníPřiřazeno	číslo	No	No	Počet zařízení.
policySettings	pole řetězců	Yes	Yes	Nastavení zásad: "none","remove_oem_preinstalls","oobe_user_not_local_admin","skip_express_settings","skip _oem_registration,"skip_eula".

Příklad požadavku

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"]
}

Odpověď REST

V případě úspěchu obsahuje tělo odpovědi prostředek ConfigurationPolicy pro novou zásadu.

Úspěšné odpovědi a kódy chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo neúspěch, a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb rozhraní REST v Partnerském centru.

Příklad odpovědi

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"
    }
}

Sdílet prostřednictvím