Zmiana konfiguracji wdrożenia

Artykuł
08/05/2023

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.

Udostępnij za pośrednictwem