Creare la distribuzione

Articolo
07/19/2023

L'operazione asincrona Create Deployment carica un nuovo pacchetto del servizio e crea una nuova distribuzione negli ambienti di gestione temporanea o di produzione.

Prima di poter eseguire questa operazione, è necessario completare le attività seguenti:

Creare una sottoscrizione e ottenere il relativo identificatore. È possibile ottenere l'identificatore di sottoscrizione nella pagina Impostazioni del portale di gestione.
Creare e caricare un certificato di gestione per autorizzare l'operazione.
Creare un servizio cloud.
Decidere se distribuire l'applicazione nell'ambiente di gestione temporanea o di produzione.

Richiesta

La Create Deployment richiesta viene specificata come indicato di seguito. Sostituire <subscription-id> con l'ID sottoscrizione, <cloudservice-name> con il nome del servizio cloud e <deployment-slot> con staging or production.

Metodo	URI richiesta
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>`

Parametri dell'URI

Nessuno.

Intestazioni richiesta

La tabella seguente descrive le intestazioni della richiesta.

Intestazione della richiesta	Descrizione
`Content-Type`	Obbligatorio. Impostare questa intestazione su `application/xml`.
`x-ms-version`	Obbligatorio. Specifica la versione dell'operazione da usare per questa richiesta. Questa intestazione deve essere impostata su `2009-10-01` o superiore.

Corpo della richiesta

Il formato del corpo della richiesta è il seguente:

  
<?xml version="1.0" encoding="utf-8"?>  
<CreateDeployment xmlns="http://schemas.microsoft.com/windowsazure">  
  <Name>deployment-name</Name>  
  <PackageUrl>package-url-in-blob-storage</PackageUrl>  
  <Label>base64-encoded-deployment-label</Label>  
  <Configuration>base64-encoded-configuration-file</Configuration>  
  <StartDeployment>start-deployment</StartDeployment>  
  <TreatWarningsAsError>prioritize-warnings</TreatWarningsAsError>  
  <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>  
</CreateDeployment>

Nella tabella indicata di seguito vengono descritti gli elementi nel corpo della richiesta.

Nome dell'elemento	Descrizione
Nome	Obbligatorio. Specifica il nome della distribuzione.
PackageUrl	Obbligatorio. Specifica un URL che fa riferimento alla posizione del pacchetto del servizio nel servizio BLOB. Il pacchetto del servizio può trovarsi in un account di archiviazione nella stessa sottoscrizione o un URI della firma di accesso condiviso da qualsiasi account di archiviazione.
Configurazione	Obbligatorio. Specifica il file di configurazione del servizio con codifica Base 64 per la distribuzione.
Etichetta	Obbligatorio. Specifica un identificatore per la distribuzione con codifica Base 64. L'identificatore può contenere un massimo di 100 caratteri. È consigliabile usare un'etichetta univoca all'interno della sottoscrizione. L'etichetta può essere usata per motivi di rilevamento.
StartDeployment	Facoltativa. Indica se avviare immediatamente la distribuzione appena creata. Il valore predefinito è `false`. Se `false`, il modello del servizio viene ancora distribuito, ma il codice non viene eseguito immediatamente. Il servizio non viene `Suspended` invece chiamato Aggiorna stato distribuzione e imposta lo stato su `Running`, al momento in cui verrà avviato il servizio. Un servizio distribuito comporta comunque addebiti, anche se è sospeso. L'elemento `StartDeployment` è disponibile solo usando la versione 2010-04-01 o successiva.
TreatWarningsAsError	Facoltativa. Indica se considerare gli avvisi di convalida del pacchetto come errori. Il valore predefinito è `false`. Se è impostato su `true`, l'operazione `Created Deployment` ha esito negativo in presenza di avvisi di convalida del pacchetto del servizio. L'elemento `TreatWarningsAsError` è disponibile solo usando la versione 2011-04-01 o successiva.
Nome	Facoltativa. Specifica il nome di una proprietà di distribuzione estesa. Ogni proprietà estesa deve contenere un nome e un valore definiti. È possibile avere un massimo di 25 coppie nome/valore per le proprietà estese. La lunghezza massima dell'elemento Name è di 64 caratteri. Nel nome sono validi solo i caratteri alfanumerici e i caratteri di sottolineatura. Il nome deve iniziare con una lettera. L'elemento `Name` è disponibile solo usando la versione 2012-03-01 o successiva.
Valore	Facoltativa. Specifica il valore di una proprietà estesa del servizio cloud. Ogni proprietà estesa deve contenere un nome e un valore definiti. È possibile avere un massimo di 25 coppie nome/valore per le proprietà estese e il valore di ciascuna proprietà contiene un massimo di 255 caratteri. L'elemento `Value` è disponibile solo usando la versione 2012-03-01 o successiva.
ExtensionConfiguration	Facoltativa. Specifica un'estensione aggiunta al servizio cloud. In Azure un processo può essere eseguito come estensione di un servizio cloud. È necessario aggiungere un'estensione al servizio cloud usando Aggiungi estensione prima di poter essere aggiunta alla distribuzione. L'elemento `ExtensionConfiguration` è disponibile solo se si utilizza la versione 01.03.13 o una versione successiva.

ExtensionConfiguration

Specifica un'estensione aggiunta al servizio cloud.

Nome dell'elemento	Descrizione
AllRoles	Facoltativa. Specifica un elenco di estensioni applicate a tutti i ruoli in una distribuzione.
Estensione	Obbligatorio. Specifica un'estensione che deve essere distribuita in un ruolo in un servizio cloud.
NamedRoles	Facoltativa. Specifica un elenco di estensioni applicate a ruoli specifici in una distribuzione.

Estensione

Specifica un'estensione che deve essere distribuita in un ruolo in un servizio cloud.

Nome dell'elemento	Descrizione
ID	Obbligatorio. Specifica l'identificatore dell'estensione. L'identificatore viene creato quando l'estensione viene aggiunta al servizio cloud. È possibile trovare l'identificatore di un'estensione aggiunta a un servizio cloud usando Estensioni elenco.
State	Facoltativa. Specifica lo stato dell'estensione. Questo elemento si applica a estensioni configurate JSON. I valori possibili sono: - `Enable` - `Disable` - `Uninstall` Il valore predefinito è `Enable`. L'elemento `State` è disponibile solo usando la versione 2014-06-01 o successiva.

NamedRoles

Specifica un elenco di estensioni applicate a ruoli specifici in una distribuzione.

Nome dell'elemento	Descrizione
Ruolo	Obbligatorio. Specifica un determinato ruolo a cui viene aggiunta l'estensione.
RoleName	Obbligatorio. Specifica il nome del ruolo.
Estensione	Obbligatorio. Specifica un'estensione che deve essere distribuita in un ruolo in un servizio cloud.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codice di stato

Un'operazione completata correttamente restituisce 200 (OK).

Intestazioni della risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive.

Intestazione di risposta	Descrizione
`x-ms-request-id`	Valore che identifica in modo univoco una richiesta eseguita nel servizio di gestione. Per un'operazione asincrona, è possibile chiamare Recupera stato operazione con il valore dell'intestazione per determinare se l'operazione è stata completata, ha avuto esito negativo o è ancora in corso.

Corpo della risposta