Creare un nuovo criterio di configurazione per il cliente specificato

Articolo
09/11/2024

Si applica a: Centro per i partner

Come creare un nuovo criterio di configurazione per il cliente specificato.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).

C#

Per creare un nuovo criterio di configurazione per il cliente specificato:

Creare un'istanza di un nuovo oggetto ConfigurationPolicy come illustrato nel frammento di codice seguente. Chiamare quindi il metodo IAggregatePartner.Customers.ById con l'ID cliente per recuperare un'interfaccia alle operazioni sul cliente specificato.
Recuperare la proprietà ConfigurationPolicies per ottenere un'interfaccia per le operazioni di raccolta dei criteri di configurazione.
Chiamare il metodo Create o CreateAsync per creare i criteri di configurazione.

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

Esempio: App di test della console. Progetto: Classe di esempi dell'SDK del Centro per i partner: CreateConfigurationPolicy.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
POST	{baseURL}/v1/customers/{customer-id}/policies HTTP/1.1

Parametro URI

Usare i parametri di percorso seguenti durante la creazione della richiesta.

Nome	Tipo	Obbligatoria	Descrizione
customer-id	string	Sì	Stringa in formato GUID che identifica il cliente.

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Il corpo della richiesta deve contenere un oggetto con le informazioni sui criteri di configurazione, come descritto nella tabella seguente:

Nome	Tipo	Obbligatoria	Descrizione
name	string	Sì	Nome descrittivo del criterio.
category	string	Sì	Categoria di criteri.
description	string	No	Descrizione dei criteri.
policySettings	matrice di stringhe	Sì	Impostazioni dei criteri.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, il corpo della risposta contiene la risorsa ConfigurationPolicy per il nuovo criterio.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Esempio di risposta

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

Condividi tramite