Vytvoření nových zásad konfigurace pro konkrétního zákazníka

Článek
09/11/2024

Platí pro: Partnerské centrum

Postup vytvoření nové zásady 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 Microsoft ID v části Informace o účtu zákazníka . ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

C#

Vytvoření nové 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. Pak zavolejte metodu IAggregatePartner.Customers.ById s ID zákazníka pro načtení rozhraní pro operace u zadaného zákazníka.
Načtením vlastnosti ConfigurationPolicies získáte rozhraní pro operace shromažďování zásad konfigurace.
Voláním metody Create nebo CreateAsync vytvořte zásady konfigurace.

Příklad jazyka C#

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

Ukázka: Testovací aplikace konzoly Project: Partner Center SDK Samples Class: CreateConfigurationPolicy.cs

Požadavek REST

Syntaxe požadavku

Metoda	Identifikátor URI žádosti
POST	{baseURL}/v1/customers/{customer-id}/policies 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
customer-ID	řetězec	Yes	Řetězec ve formátu GUID, který identifikuje zákazníka.

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 s informacemi o zásadách konfigurace, jak je popsáno v následující tabulce:

Název	Typ	Vyžadováno	Popis
name	řetězec	Yes	Popisný název zásady
category	řetězec	Yes	Kategorie zásad.
description	řetězec	No	Popis zásady.
policySettings	pole řetězců	Yes	Nastavení zásad.

Příklad požadavku

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

Odpověď REST

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

Kódy úspěšných odpovědí a chyb

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

Příklad odpovědi

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

Sdílet prostřednictvím