Aktualizowanie zasad konfiguracji dla określonego klienta
Dotyczy: Centrum partnerskie
Jak zaktualizować określone zasady konfiguracji dla określonego klienta.
Wymagania wstępne
Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Identyfikator klienta (
customer-tenant-id
). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim , wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta . Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id
).Identyfikator zasad.
C#
Aby zaktualizować istniejące zasady konfiguracji dla określonego klienta, utwórz wystąpienie nowego obiektu ConfigurationPolicy , jak pokazano w poniższym fragmencie kodu. Wartości w tym nowym obiekcie zastępują odpowiednie wartości w istniejącym obiekcie. Następnie wywołaj metodę IAggregatePartner.Customers.ById z identyfikatorem klienta, aby pobrać interfejs operacji na określonym kliencie. Następnie wywołaj metodę ConfigurationPolicies.ById z identyfikatorem zasad, aby pobrać interfejs operacji zasad konfiguracji dla określonych zasad. Na koniec wywołaj metodę Patch lub PatchAsync , aby zaktualizować zasady konfiguracji.
IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedConfigurationPolicyId;
ConfigurationPolicy configPolicyToBeUpdated = new ConfigurationPolicy()
{
Name= "Test Config Policy",
Id = selectedConfigurationPolicyId,
PolicySettings = new List<PolicySettingsType>() {
PolicySettingsType.OobeUserNotLocalAdmin,
PolicySettingsType.RemoveOemPreinstalls }
};
ConfigurationPolicy updatedConfigurationPolicy =
partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.ById(selectedConfigurationPolicyId).Patch(configPolicyToBeUpdated);
Przykład: aplikacja testowa konsoli. Projekt: Klasa przykładów zestawu SDK Centrum partnerskiego: UpdateConfigurationPolicy.cs
Żądanie REST
Składnia żądania
Metoda | Identyfikator URI żądania |
---|---|
PUT | {baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1 |
Parametr identyfikatora URI
Podczas tworzenia żądania użyj następujących parametrów ścieżki.
Nazwa | Typ | Wymagane | Opis |
---|---|---|---|
customer-id | ciąg | Tak | Ciąg sformatowany przez identyfikator GUID, który identyfikuje klienta. |
identyfikator zasad | ciąg | Tak | Ciąg sformatowany przez identyfikator GUID, który identyfikuje zasady do zaktualizowania. |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.
Treść żądania
Treść żądania musi zawierać obiekt, który dostarcza informacje o zasadach.
Nazwa | Typ | Wymagane | Aktualizowalna | Opis |
---|---|---|---|---|
identyfikator | ciąg | Tak | Nie | Ciąg sformatowany przez identyfikator GUID, który identyfikuje zasady. |
name | ciąg | Tak | Tak | Przyjazna nazwa zasad. |
category | ciąg | Tak | Nie | Kategoria zasad. |
description (opis) | ciąg | Nie | Tak | Opis zasad. |
devicesAssigned | liczba | Nie | Nie | Liczba urządzeń. |
policySettings | tablica ciągów | Tak | Tak | Ustawienia zasad: "none","remove_oem_preinstalls","oobe_user_not_local_admin","skip_express_settings","skip _oem_registration,"skip_eula". |
Przykład żądania
PUT https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies/56edf752-ee77-4fd8-b7f5-df1f74a3a9ac HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: de894e18-f027-4ac0-8b5a-34f0c222af0c
X-Locale: en-US
Content-Length: 256
Content-Type: application/json
Host: api.partnercenter.microsoft.com
{
"id": "56edf752-ee77-4fd8-b7f5-df1f74a3a9ac",
"name": "Windows test policy",
"category": "o_o_b_e",
"description": "Test policy creation from API",
"devicesAssigned": 0,
"policySettings": ["skip_express_settings"]
}
Odpowiedź REST
W przypadku powodzenia treść odpowiedzi zawiera zasób ConfigurationPolicy dla nowych zasad.
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie oraz dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.
Przykład odpowiedzi
HTTP/1.1 200 OK
Content-Length: 421
Content-Type: application/json; charset=utf-8
MS-CorrelationId: f9fd5973-6ad8-4585-aadc-f2b0443fe27b
MS-RequestId: cb1fa1f3-1381-45d9-99c5-511e5d3efa7c
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:10:29 GMT
{
"id": "56edf752-ee77-4fd8-b7f5-df1f74a3a9ac",
"name": "Windows test policy",
"category": "o_o_b_e",
"description": "Test policy creation from API",
"devicesAssigned": 0,
"policySettings": ["skip_express_settings"],
"createdDate": "2017-01-01T00:00:00",
"lastModifiedDate": "2017-07-25T18:10:15",
"attributes": {
"objectType": "ConfigurationPolicy"
}
}