Eliminare un criterio di configurazione per il cliente specificato

Articolo
09/11/2024

Si applica a: Centro per i partner

Come eliminare un criterio di configurazione per un cliente e un identificatore di criteri specificati.

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).
Identificatore di criterio.

C#

Per eliminare un criterio di configurazione per un cliente specificato:

Chiamare il metodo IAggregatePartner.Customers.ById con l'ID cliente per recuperare un'interfaccia per le operazioni sul cliente specificato.
Chiamare il metodo ConfigurationPolicies.ById con l'ID criterio per recuperare un'interfaccia per le operazioni dei criteri di configurazione per i criteri specificati.
Chiamare il metodo Delete o DeleteAsync per eliminare i criteri di configurazione.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedPolicyId;

partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.ById(selectedPolicyId).Delete();

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

Richiesta REST

Sintassi della richiesta

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

Parametri URI

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

Nome	Tipo	Obbligatoria	Descrizione
customer-id	string	Sì	Stringa in formato GUID che identifica il cliente.
policy-id	string	Sì	Stringa con formattazione GUID che identifica il criterio da eliminare.

Intestazioni della richiesta

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

Testo della richiesta

Nessuno

Esempio di richiesta

DELETE https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies/56edf752-ee77-4fd8-b7f5-df1f74a3a9ac HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Length: 0
Content-Type: application/json
Host: api.partnercenter.microsoft.com

Risposta REST

Se ha esito positivo, la risposta restituisce un codice di stato 204 Nessun contenuto.

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 204 No Content
Content-Length: 0
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 76b6f317-1da1-4b61-a6fd-9952439a2c46
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:10:41 GMT

Condividi tramite