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

  • Článek

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: de894e18-f027-4ac0-8b5a-34f0c222af0c
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: f9fd5973-6ad8-4585-aadc-f2b0443fe27b
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"
    }
}