Zmiana konfiguracji wdrożenia

Change Deployment Configuration Operacja asynchroniczna inicjuje zmianę konfiguracji wdrożenia.

Żądanie

Żądanie Change Deployment Configuration można określić w następujący sposób. Zastąp <subscription-id> ciąg identyfikatorem subskrypcji, <cloudservice-name> nazwą usługi <deployment-slot> w chmurze lub stagingproductionnazwą <deployment-name> lub unikatową nazwą wdrożenia.

Metoda	Identyfikator URI żądania
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/

Parametry identyfikatora URI

Parametr identyfikatora URI	Opis
comp=config	Wymagane. Określa, że należy wprowadzić zmianę w konfiguracji wdrożenia.

Nagłówki żądań

W poniższej tabeli opisano nagłówki żądań.

Nagłówek żądania	Opis
Content-Type	Wymagane. Ustaw ten nagłówek na application/xml.
x-ms-version	Wymagane. Określa wersję operacji do użycia dla tego żądania. Ten nagłówek powinien być ustawiony na 2009-10-01 lub wyższy.

Treść żądania

Format treści żądania jest następujący:

  
<?xml version="1.0" encoding="utf-8"?>  
<ChangeConfiguration xmlns="http://schemas.microsoft.com/windowsazure">  
  <Configuration>base-64-encoded-configuration-file</Configuration>  
  <TreatWarningsAsError>warnings-as-errors</TreatWarningsAsError>  
  <Mode>type-of-change</Mode>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>property-name</Name>  
      <Value>property-value</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ExtensionConfiguration>  
    <AllRoles>  
      <Extension>  
        <Id>identifier-of-extension</Id>  
        <State>state-of-extension</State>  
      </Extension>  
    </AllRoles>  
    <NamedRoles>  
      <Role>  
        <RoleName>role_name1</RoleName>  
        <Extensions>  
          <Extension>  
            <Id>identifier-of-extension</Id>  
            <State>state-of-extension</State>  
          </Extension>  
        </Extensions>  
      </Role>  
    </NamedRoles>  
  </ExtensionConfiguration>  
</ChangeConfiguration>  
  

W poniższej tabeli opisano elementy w treści żądania.

Nazwa elementu	Opis
Konfigurowanie	Wymagane. Określa plik konfiguracji usługi zakodowanej w formacie base-64 dla wdrożenia.
TreatWarningsAsError	Opcjonalny. Wskazuje, czy ostrzeżenia powinny być traktowane jako błędy. Możliwe wartości: - true - false Jeśli nie zostanie określony, wartość domyślna to false. Jeśli ustawiono wartość true, aktualizacja zostanie zablokowana po napotkaniu ostrzeżeń. Element TreatWarningsAsError jest dostępny tylko w wersji 2011-04-01 lub nowszej.
Mode	Opcjonalny. Możliwe wartości: - Auto - Manual - Simultaneous Jeśli nie określono wartości domyślnej to Auto. Jeśli ustawiono wartość Manual, element WalkUpgradeDomain musi być wywoływany, aby zastosować aktualizację. Jeśli ustawiono wartość Auto, aktualizacja jest automatycznie stosowana do każdej domeny aktualizacji dla usługi. Element Mode jest dostępny tylko w wersji 2011-08-01 lub nowszej. Ustawienie Simultaneous jest dostępne tylko w wersji 2013-03-01 lub nowszej.
Nazwa	Opcjonalny. Reprezentuje nazwę rozszerzonej właściwości usługi w chmurze. Każda właściwość rozszerzona musi mieć zdefiniowaną nazwę i wartość. Można mieć maksymalnie 25 rozszerzonych par właściwości i par wartości. Maksymalna długość Name elementu to 64 znaki, tylko znaki alfanumeryczne i podkreślenia są prawidłowe w nazwie i muszą zaczynać się literą. Próba użycia innych znaków, począwszy od znaku innego niż litera lub wprowadzenie nazwy identycznej z inną właściwością rozszerzoną należącą do tej samej usługi w chmurze, spowoduje błąd o kodzie stanu 400 (nieprawidłowe żądanie). Element Name jest dostępny tylko w wersji 2012-03-01 lub nowszej.
Wartość	Opcjonalny. Reprezentuje wartość rozszerzonej właściwości usługi w chmurze. Każda właściwość rozszerzona musi mieć zdefiniowaną nazwę i wartość. Można mieć maksymalnie 25 rozszerzonych par właściwości i par wartości, a każda rozszerzona wartość właściwości ma maksymalną długość 255 znaków. Możesz usunąć właściwość rozszerzoną, ustawiając wartość na NULL. Element Value jest dostępny tylko w wersji 2012-03-01 lub nowszej.
ExtensionConfiguration	Opcjonalny. Reprezentuje rozszerzenie dodane do usługi w chmurze. Na platformie Azure proces może działać jako rozszerzenie usługi w chmurze. Należy dodać rozszerzenie do usługi w chmurze przy użyciu polecenia Dodaj rozszerzenie , aby można było go dodać do wdrożenia podczas zmiany konfiguracji. Element ExtensionConfiguration jest dostępny tylko w wersji 2013-03-01 lub nowszej.

ExtensionConfiguration

Reprezentuje rozszerzenie dodane do usługi w chmurze.

Nazwa elementu	Opis
Wszystkierole	Opcjonalny. Określa listę rozszerzeń, które są stosowane do wszystkich ról we wdrożeniu.
Rozszerzenie	Wymagane. Reprezentuje rozszerzenie, które ma zostać wdrożone w roli w usłudze w chmurze.
Nazwanerole	Opcjonalny. Określa listę rozszerzeń, które są stosowane do określonych ról we wdrożeniu.

Rozszerzenie

Reprezentuje rozszerzenie, które ma zostać wdrożone w roli w usłudze w chmurze.

Nazwa elementu	Opis
Id	Wymagane. Identyfikator rozszerzenia. Identyfikator jest tworzony po dodaniu rozszerzenia do usługi w chmurze. Identyfikator rozszerzenia dodanego do usługi w chmurze można znaleźć przy użyciu rozszerzeń listy.
Stan	Opcjonalny. Określa stan rozszerzenia. Ten element dotyczy tylko rozszerzeń skonfigurowanych w formacie JSON. Możliwe wartości: - Enable - Disable - Uninstall Wartość domyślna to Enable. Element State jest dostępny tylko w wersji 2014-06-01 lub nowszej.

Nazwanerole

Określa listę rozszerzeń, które są stosowane do określonych ról we wdrożeniu.

Nazwa elementu	Opis
Rola	Wymagane. Reprezentuje określoną rolę, do której dodawane jest rozszerzenie.
RoleName	Wymagane. Określa nazwę roli.
Rozszerzenie	Wymagane. Reprezentuje rozszerzenie, które ma zostać wdrożone w roli w usłudze w chmurze.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Ponieważ Change Deployment Configuration jest operacją asynchroniczną, należy wywołać metodę Pobierz stan operacji , aby określić, czy operacja została ukończona, zakończyła się niepowodzeniem, czy jest nadal w toku.

Kod stanu

Pomyślna operacja zwraca kod stanu 200 (OK).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP.

Nagłówek odpowiedzi	Opis
x-ms-request-id	Wartość, która jednoznacznie identyfikuje żądanie skierowane do usługi zarządzania. W przypadku operacji asynchronicznej można wywołać metodę Get Operation Status z wartością nagłówka, aby określić, czy operacja została ukończona, zakończyła się niepowodzeniem, czy nadal jest w toku.

Treść odpowiedzi

Brak.