Creazione di un servizio cloud

Articolo
08/05/2023

Tramite l'operazione asincrona Create Cloud Service viene creato un nuovo servizio cloud in Microsoft Azure.

Richiesta

La Create Cloud Service richiesta viene specificata nel modo seguente. Sostituire <subscription-id> con l'ID della sottoscrizione.

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

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. Il valore di questa intestazione deve essere impostato su `2010-10-28` o superiore.

Corpo della richiesta

Il formato del corpo della richiesta è il seguente:

<?xml version="1.0" encoding="utf-8"?>  
<CreateHostedService xmlns="http://schemas.microsoft.com/windowsazure">  
  <ServiceName>name-of-cloud-service</ServiceName>  
  <Label>base64-encoded-label-of-cloud-service</Label>  
  <Description>description-of-cloud-service</Description>  
  <Location>location-of-cloud-service</Location>  
  <AffinityGroup>name-of-affinity-group</AffinityGroup>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>name-of-property</Name>  
      <Value>value-of-property</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
</CreateHostedService>

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

Nome dell'elemento	Descrizione
ServiceName	Obbligatorio. Specifica il nome per il servizio cloud. Il nome deve essere univoco in Azure. Questo nome è il nome del prefisso DNS usato per accedere al servizio. Per verificare la disponibilità di un nome, è possibile usare Verifica disponibilità nome servizio cloud.
Etichetta	Obbligatorio. Specifica l'identificatore con codifica Base 64 del servizio cloud. L'identificatore può essere costituito da un massimo di 100 caratteri. L'etichetta può essere usata per motivi di rilevamento.
Descrizione	Facoltativa. Specifica la descrizione del servizio cloud. La descrizione può contenere fino a 1024 caratteri.
Posizione	Obbligatorio se `AffinityGroup` non viene specificato. Specifica la posizione in cui viene creato il servizio cloud. È necessario specificare `Location` o `AffinityGroup`, ma non entrambi. Per visualizzare le posizioni disponibili, è possibile usare Posizioni elenco.
AffinityGroup	Obbligatorio se `Location` non viene specificato. Specifica il nome di un gruppo di affinità esistente associato alla sottoscrizione. È necessario specificare `Location` o `AffinityGroup`, ma non entrambi. Per visualizzare i gruppi di affinità disponibili, è possibile usare List Affinity Groups .To see the available affinity groups, you can use List Affinity Groups.
Nome	Facoltativa. Specifica il nome di una proprietà estesa del servizio cloud. Il nome può contenere un massimo di 64 caratteri, deve iniziare con una lettera e supporta unicamente i caratteri alfanumerici e i caratteri di sottolineatura. Ogni proprietà estesa deve contenere un nome e un valore definiti. È possibile definire un massimo di 50 proprietà estese. L'elemento `Name` è disponibile solo con la versione 2012-03-01 o successiva.
Valore	Facoltativa. Specifica il valore di una proprietà estesa del servizio cloud. Il valore della proprietà estesa può avere una lunghezza massima di 255 caratteri. L'elemento `Value` è disponibile solo con la versione 2012-03-01 o successiva.
ReverseDnsFqdn	Facoltativa. Specifica l'indirizzo DNS in cui l'indirizzo IP del servizio viene risolto quando viene sottoposto a query mediante una query DNS inversa. L'elemento `ReverseDnsFqdn` è disponibile solo con la versione 2014-06-01 o successiva.

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 il codice di stato 201 (Creato).

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 Get Operation Status con il valore dell'intestazione per determinare se l'operazione è stata completata, ha avuto esito negativo o è ancora in corso.

Corpo della risposta