Implementatie upgraden

Artikel
08/05/2023

De Upgrade Deployment asynchrone bewerking initieert een update van rolinstanties in een implementatie met behulp van het pakket en de configuratie die u opgeeft.

Aanvraag

De Upgrade Deployment aanvraag kan als volgt worden opgegeven. Vervang door de abonnements-id <subscription-id> , <cloudservice-name> door de naam van de cloudservice, <deployment-slot> door staging of production, of <deployment-name> door de naam van de implementatie.

Methode	Aanvraag-URI
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>/`

URI-parameters

URI-parameter	Beschrijving
`comp=upgrade`	Vereist. Hiermee geeft u op dat de implementatie moet worden bijgewerkt.

Aanvraagheaders

In de volgende tabel worden de aanvraagheaders beschreven.

Aanvraagkoptekst	Beschrijving
`Content-Type`	Vereist. Stel deze header in op `application/xml`.
`x-ms-version`	Vereist. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Deze header moet worden ingesteld op `2009-10-01` of hoger.

Aanvraagbody

De indeling van de aanvraagbody is als volgt:

  
<?xml version="1.0" encoding="utf-8"?>  
<UpgradeDeployment xmlns="http://schemas.microsoft.com/windowsazure">  
  <Mode>type-of-upgrade</Mode>  
  <PackageUrl>url-to-package</PackageUrl>  
  <Configuration>base64-encoded-config-file</Configuration>  
  <Label>base-64-encoded-label</Label>  
  <RoleToUpgrade>role-name</RoleToUpgrade>  
  <Force>true|false</Force>  
  <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>  
</UpgradeDeployment>

In de volgende tabel worden de elementen in de aanvraagbody beschreven.

Elementnaam	Beschrijving
Modus	Vereist. Hiermee geeft u het type update te starten. Rolinstanties worden toegewezen aan updatedomeinen wanneer de service wordt geïmplementeerd. Updates kan handmatig worden gestart in elk updatedomein of automatisch worden gestart in alle updatedomeinen. Mogelijke waarden zijn: - `Auto` - `Manual` - `Simultaneous` Als dit niet is opgegeven, is `Auto`de standaardwaarde . Als dit is ingesteld op `Manual`, moet WalkUpgradeDomain worden aangeroepen om de update toe te passen. Als dit is ingesteld op `Auto`, wordt de update automatisch toegepast op elk updatedomein in de volgorde. De `Simultaneous` instelling is alleen beschikbaar in versie 2012-12-01 of hoger.
PackageUrl	Vereist. Hiermee geeft u een URL op die verwijst naar de locatie van het servicepakket in de Blob-service. Het servicepakket kan zich bevinden in een opslagaccount onder hetzelfde abonnement of in een SAS-URI (Shared Access Signature) van elk opslagaccount. Zie Delegating Access with a Shared Access Signature (Toegang delegeren met een Shared Access Signature) voor meer informatie over Shared Access Signatures.
Configuratie	Vereist. Hiermee geeft u het met base 64 gecodeerde serviceconfiguratiebestand voor de implementatie.
Label	Vereist. Hiermee geeft u de naam voor de cloudservice die is gecodeerd met base-64. De naam mag maximaal 100 tekens lang zijn. Het wordt aanbevolen dat het label uniek is binnen het abonnement. De naam kan worden gebruikt om de cloudservice te identificeren voor uw traceringsdoeleinden.
RoleToUpgrade	Optioneel. Hiermee geeft u de naam van de specifieke rolinstantie die moet worden bijgewerkt. Bij een upgrade met één rol kunnen alle andere rollen nog steeds worden gerecycled als er een interne Azure-upgrade is gepland. Het updatedomein is gegarandeerd in dit scenario.
Force	Vereist. Hiermee wordt aangegeven of de update moet worden voortgezet, zelfs wanneer lokale gegevens verloren gaan van sommige rolinstanties. `True` als de update moet worden voortgezet; anders `false`. Het `Force` element is alleen beschikbaar met versie 2011-10-01 of hoger.
Naam	Optioneel. Hiermee geeft u de naam van een uitgebreide cloudservice-eigenschap. Elke uitgebreide eigenschap moet zowel een gedefinieerde naam als een waarde hebben. U kunt maximaal 25 uitgebreide eigenschapsnaam- en waardeparen hebben. De maximale lengte van het `Name` element is 64 tekens, alleen alfanumerieke tekens en onderstrepingstekens zijn geldig in de naam en de naam moet beginnen met een letter. Als u andere tekens probeert te gebruiken, te beginnen met een niet-letterteken of een naam invoert die identiek is aan die van een andere uitgebreide eigenschap die eigendom is van dezelfde cloudservice, resulteert dit in een statuscode 400-fout (Ongeldige aanvraag). Het `Name` element is alleen beschikbaar met versie 2012-03-01 of hoger.
Waarde	Optioneel. Hiermee geeft u de waarde van een uitgebreide cloudservice-eigenschap. Elke uitgebreide eigenschap moet zowel een gedefinieerde naam als een waarde hebben. U kunt maximaal 25 uitgebreide eigenschapsnaam- en waardeparen hebben en elke uitgebreide eigenschapswaarde heeft een maximale lengte van 255 tekens. U verwijdert een uitgebreide eigenschap door de waarde in te stellen op NULL. Het `Value` element is alleen beschikbaar met versie 2012-03-01 of hoger.
ExtensionConfiguration	Optioneel. Hiermee geeft u een extensie die wordt toegevoegd aan de cloudservice. In Azure kan een proces worden uitgevoerd als een uitbreiding van een cloudservice. U moet een extensie toevoegen aan de cloudservice met behulp van Extensie toevoegen voordat deze tijdens een update kan worden toegevoegd aan de implementatie. Het `ExtensionConfiguration` element is alleen beschikbaar met versie 2013-03-01 of hoger.

ExtensionConfiguration

Hiermee geeft u een extensie die wordt toegevoegd aan de cloudservice.

Elementnaam	Beschrijving
AllRoles	Optioneel. Hiermee geeft u een lijst met extensies die worden toegepast op alle rollen in een implementatie.
Extensie	Vereist. Hiermee geeft u een extensie op die moet worden geïmplementeerd voor een rol in een cloudservice.
NamedRoles	Optioneel. Hiermee geeft u een lijst met extensies die worden toegepast op specifieke rollen in een implementatie.

Extensie

Hiermee geeft u een extensie op die moet worden geïmplementeerd voor een rol in een cloudservice.

Elementnaam	Beschrijving
Id	Vereist. Hiermee geeft u de id van de extensie. De id wordt gemaakt wanneer de extensie wordt toegevoegd aan de cloudservice. U vindt de id van een extensie die is toegevoegd aan een cloudservice met behulp van Lijstextensies.
Staat	Optioneel. Hiermee geeft u de status van de extensie op. Dit element is alleen van toepassing op met JSON geconfigureerde extensies. Mogelijke waarden zijn: - `Enable` - `Disable` - `Uninstall` De standaardwaarde is `Enable`. Het `State` element is alleen beschikbaar met versie 2014-06-01 of hoger.

NamedRoles

Hiermee geeft u een lijst met extensies op die worden toegepast op specifieke rollen in een implementatie.

Elementnaam	Beschrijving
Rol	Vereist. Hiermee geeft u een specifieke rol waaraan de extensie wordt toegevoegd.
RoleName	Vereist. Hiermee geeft u de naam van de rol.
Extensie	Vereist. Hiermee geeft u een extensie op die moet worden geïmplementeerd voor een rol in een cloudservice.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK).

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard-HTTP-headers bevatten.

Reactieheader	Beschrijving
`x-ms-request-id`	Een waarde die een aanvraag die is ingediend bij de beheerservice uniek identificeert. Voor een asynchrone bewerking kunt u Bewerkingsstatus ophalen aanroepen met de waarde van de header om te bepalen of de bewerking is voltooid, is mislukt of nog wordt uitgevoerd.

Hoofdtekst van antwoord

Geen.

Opmerkingen

Als u een automatische update van een implementatie wilt uitvoeren, roept u Implementatie upgraden of Implementatieconfiguratie wijzigen aan met het Mode element ingesteld op automatic. De update gaat vanaf dat punt verder zonder dat er verdere invoer nodig is. U kunt Bewerkingsstatus ophalen aanroepen om te bepalen wanneer de update is voltooid.

Als u een handmatige update wilt uitvoeren, roept u eerst Upgrade-implementatie aan met het Mode element ingesteld op manual. Roep vervolgens WalkUpgradeDomain aan om elk domein binnen de implementatie bij te werken. Zorg ervoor dat de bewerking is voltooid door Bewerkingsstatus ophalen aan te roepen voordat u het volgende domein bijwerkt.

Een update die rolinstanties toevoegt of verwijdert, resulteert in een configuratie-update voor alle rollen die zijn geïmplementeerd in de cloudservice. Bestaande rolinstanties moeten op de hoogte worden gesteld van nieuwe rolinstanties, zodat alle rolinstanties samen kunnen communiceren in de cloudservice.

Standaard wordt een cloudservice geïmplementeerd met vijf updatedomeinen, die één voor één worden bijgewerkt tijdens een in-place update.

Gebruik UpdateDomain de eigenschap van de RoleInstance klasse om het updatedomein te bepalen waarin een bepaald exemplaar wordt uitgevoerd.

Delen via