Ta bort en konfigurationsprincip för den angivna kunden
Gäller för: Partnercenter
Ta bort en konfigurationsprincip för en angiven kund- och principidentifierare.
Förutsättningar
Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående App- och App+User-autentiseringsuppgifter.
Ett kund-ID (
customer-tenant-id
). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden i kundlistan och sedan Konto. På kundens kontosida letar du upp Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID:t (customer-tenant-id
).Principidentifieraren.
C#
Så här tar du bort en konfigurationsprincip för en angiven kund:
Anropa metoden IAggregatePartner.Customers.ById med kund-ID:t för att hämta ett gränssnitt till åtgärder på den angivna kunden.
Anropa metoden ConfigurationPolicies.ById med princip-ID:t för att hämta ett gränssnitt till konfigurationsprincipåtgärder för den angivna principen.
Anropa metoden Delete eller DeleteAsync för att ta bort konfigurationsprincipen.
IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedPolicyId;
partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.ById(selectedPolicyId).Delete();
Exempel: Konsoltestapp. Projekt: SDK-exempelklass för Partnercenter: DeleteConfigurationPolicy.cs
REST-begäran
Begärandesyntax
Metod | URI för förfrågan |
---|---|
TA BORT | {baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1 |
URI-parametrar
Använd följande sökvägsparametrar när du skapar begäran.
Namn | Typ | Obligatorisk | Beskrivning |
---|---|---|---|
kund-ID | sträng | Ja | En GUID-formaterad sträng som identifierar kunden. |
policy-id | sträng | Ja | En GUID-formaterad sträng som identifierar principen som ska tas bort. |
Begärandehuvuden
Mer information finns i REST-huvuden i Partnercenter.
Begärandetext
Ingen
Exempel på begäran
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-svar
Om det lyckas returnerar svaret statuskoden 204 Inget innehåll.
Svarsframgång och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Partnercenter REST-felkoder.
Exempel på svar
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