Změna konfigurace nasazení

Asynchronní Change Deployment Configuration operace zahájí změnu konfigurace nasazení.

Žádost

Žádost Change Deployment Configuration může být zadána následujícím způsobem. Nahraďte <subscription-id> ID předplatného, <cloudservice-name> názvem cloudové služby nebo production<deployment-slot>staging nebo <deployment-name> jedinečným názvem vašeho nasazení.

Metoda	Identifikátor URI žádosti
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 identifikátoru URI

Parametr identifikátoru URI	Description
comp=config	Povinná hodnota. Určuje, že musí být provedena změna konfigurace nasazení.

Hlavičky požadavku

Následující tabulka popisuje hlavičky požadavku.

Hlavička požadavku	Description
Content-Type	Povinná hodnota. Nastavte toto záhlaví na application/xml.
x-ms-version	Povinná hodnota. Určuje verzi operace, která se má použít pro tento požadavek. Tato hlavička by měla být nastavená na 2009-10-01 hodnotu nebo vyšší.

Text požadavku

Text požadavku má následující formát:

  
<?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>  
  

Následující tabulka popisuje prvky v textu požadavku.

Název elementu	Popis
Konfigurace	Povinná hodnota. Určuje konfigurační soubor služby s kódováním base-64 pro nasazení.
TreatWarningsAsError	Nepovinný parametr. Označuje, jestli se mají upozornění považovat za chyby. Možné hodnoty: - true - false Pokud není zadán, výchozí hodnota je false. Pokud je tato možnost nastavená na true, aktualizace se při zobrazení upozornění zablokuje. Element TreatWarningsAsError je k dispozici pouze ve verzi 2011-04-01 nebo vyšší.
Mode	Nepovinný parametr. Možné hodnoty: - Auto - Manual - Simultaneous Pokud není zadána, výchozí hodnota je Auto. Pokud je nastavená na Manual, Musí být volána WalkUpgradeDomain , aby se aktualizace použila. Pokud je tato možnost nastavená na Auto, aktualizace se automaticky použije pro každou aktualizační doménu služby. Element Mode je k dispozici pouze ve verzi 2011-08-01 nebo vyšší. Nastavení Simultaneous je k dispozici pouze ve verzi 2013-03-01 nebo vyšší.
Name	Nepovinný parametr. Představuje název rozšířené vlastnosti cloudové služby. Každá rozšířená vlastnost musí mít definovaný název i hodnotu. Můžete mít maximálně 25 dvojic rozšířených názvů vlastností a hodnot. Maximální délka elementu Name je 64 znaků, v názvu jsou platné pouze alfanumerické znaky a podtržítka a musí začínat písmenem. Při pokusu o použití jiných znaků, počínaje znakem bez písmen, nebo zadáním názvu, který je shodný s názvem jiné rozšířené vlastnosti vlastněné stejnou cloudovou službou, se zobrazí stavový kód 400 (Chybný požadavek). Element Name je k dispozici pouze ve verzi 2012-03-01 nebo vyšší.
Hodnota	Nepovinný parametr. Představuje hodnotu vlastnosti rozšířené cloudové služby. Každá rozšířená vlastnost musí mít definovaný název i hodnotu. Můžete mít maximálně 25 dvojic s názvem rozšířené vlastnosti a hodnotou a každá hodnota rozšířené vlastnosti má maximální délku 255 znaků. Rozšířenou vlastnost můžete odstranit nastavením hodnoty na HODNOTU NULL. Element Value je k dispozici pouze ve verzi 2012-03-01 nebo vyšší.
Konfigurace rozšíření	Nepovinný parametr. Představuje rozšíření, které je přidáno do cloudové služby. V Azure může proces běžet jako rozšíření cloudové služby. Před přidáním rozšíření do nasazení během změny konfigurace musíte do cloudové služby přidat rozšíření pomocí možnosti Přidat rozšíření . Element ExtensionConfiguration je k dispozici pouze ve verzi 2013-03-01 nebo vyšší.

Konfigurace rozšíření

Představuje rozšíření, které je přidáno do cloudové služby.

Název elementu	Popis
AllRoles	Nepovinný parametr. Určuje seznam rozšíření, která se použijí pro všechny role v nasazení.
Rozšíření	Povinná hodnota. Představuje rozšíření, které se má nasadit do role v cloudové službě.
Pojmenované role	Nepovinný parametr. Určuje seznam rozšíření, která se použijí na konkrétní role v nasazení.

Rozšíření

Představuje rozšíření, které se má nasadit do role v cloudové službě.

Název elementu	Popis
Id	Povinná hodnota. Identifikátor rozšíření. Identifikátor se vytvoří při přidání rozšíření do cloudové služby. ID rozšíření, které bylo přidáno do cloudové služby, najdete pomocí seznamu rozšíření.
Stav	Nepovinný parametr. Určuje stav rozšíření. Tento prvek platí jenom pro rozšíření nakonfigurovaná ve formátu JSON. Možné hodnoty: - Enable - Disable - Uninstall Výchozí hodnota je Enable. Element State je k dispozici pouze ve verzi 2014-06-01 nebo vyšší.

Pojmenované role

Určuje seznam rozšíření, která se použijí na konkrétní role v nasazení.

Název elementu	Popis
Role	Povinná hodnota. Představuje konkrétní roli, do které je rozšíření přidáno.
RoleName (Název role)	Povinná hodnota. Určuje název role.
Rozšíření	Povinná hodnota. Představuje rozšíření, které se má nasadit do role v cloudové službě.

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Vzhledem k tomu Change Deployment Configuration , že se jedná o asynchronní operaci, musíte volat Získání stavu operace , abyste zjistili, jestli je operace dokončená, selhala nebo stále probíhá.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP.

Hlavička odpovědi	Description
x-ms-request-id	Hodnota, která jednoznačně identifikuje požadavek provedený vůči službě pro správu. U asynchronní operace můžete volat získání stavu operace s hodnotou hlavičky a určit, jestli je operace dokončená, selhala nebo stále probíhá.

Text odpovědi

Žádné