Supprimer une stratégie de configuration pour le client spécifié

  • Article

S’applique à : Espace partenaires

Comment supprimer une stratégie de configuration pour un client et un identificateur de stratégie spécifiés.

Prérequis

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec des informations d’identification d’application autonome et d’application+utilisateur.

  • ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace partenaires en sélectionnant l’espace de travail Clients , puis le client dans la liste des clients, puis Compte. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).

  • Identificateur de stratégie.

C#

Pour supprimer une stratégie de configuration pour un client spécifié :

  1. Appelez la méthode IAggregatePartner.Customers.ById avec l’ID client pour récupérer une interface permettant d’effectuer des opérations sur le client spécifié.

  2. Appelez la méthode ConfigurationPolicies.ById avec l’ID de stratégie pour récupérer une interface aux opérations de stratégie de configuration pour la stratégie spécifiée.

  3. Appelez la méthode Delete ou DeleteAsync pour supprimer la stratégie de configuration.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedPolicyId;

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

Exemple : application de test console. Projet : Classe d’exemples sdk de l’Espace partenaires : DeleteConfigurationPolicy.cs

Demande REST

Syntaxe de la requête

Méthode URI de demande
DELETE {baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

Paramètres URI

Utilisez les paramètres de chemin d’accès suivants lors de la création de la demande.

Nom Type Obligatoire Description
customer-id string Oui Chaîne au format GUID qui identifie le client.
id de stratégie string Oui Chaîne au format GUID qui identifie la stratégie à supprimer.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de demande

None

Exemple de requête

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: de894e18-f027-4ac0-8b5a-34f0c222af0c
X-Locale: en-US
Content-Length: 0
Content-Type: application/json
Host: api.partnercenter.microsoft.com

Réponse REST

Si elle réussit, la réponse retourne un code 204 No Content status.

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: cee5caf4-c322-4baa-b1d7-e94afb9891a4
MS-RequestId: 76b6f317-1da1-4b61-a6fd-9952439a2c46
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:10:41 GMT