Löschen einer Konfigurationsrichtlinie für den angegebenen Kunden

Artikel
09/11/2024

Gilt für: Partner Center

Löschen einer Konfigurationsrichtlinie für einen angegebenen Kunden- und Richtlinienbezeichner

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die Kunden-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden und dann den Kunden aus der Kundenliste und dann Konto auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).
Der Richtlinienbezeichner.

C#

So löschen Sie eine Konfigurationsrichtlinie für einen angegebenen Kunden:

Rufen Sie die IAggregatePartner.Customers.ById-Methode mit der Kunden-ID auf, um eine Schnittstelle für Vorgänge für den angegebenen Kunden abzurufen.
Rufen Sie die ConfigurationPolicies.ById-Methode mit der Richtlinien-ID auf, um eine Schnittstelle zu Konfigurationsrichtlinienvorgängen für die angegebene Richtlinie abzurufen.
Rufen Sie die Delete- oder DeleteAsync-Methode auf, um die Konfigurationsrichtlinie zu löschen.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedPolicyId;

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

Beispiel: Konsolentest-App. Projekt: Partner Center SDK-Beispielklasse: DeleteConfigurationPolicy.cs

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
DELETE	{baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

URI-Parameter

Verwenden Sie beim Erstellen der Anforderung die folgenden Pfadparameter.

Name	Typ	Erforderlich	BESCHREIBUNG
Kunden-ID	Zeichenfolge	Ja	Eine GUID-formatierte Zeichenfolge, die den Kunden identifiziert.
policy-id	Zeichenfolge	Ja	Eine GUID-formatierte Zeichenfolge, die die zu löschende Richtlinie identifiziert.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine

Anforderungsbeispiel

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

REST-Antwort

Bei erfolgreicher Ausführung gibt die Antwort den Code 204 No Content status zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Antwortbeispiel

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

Freigeben über