Crear Servicios en la nube

Artículo
07/19/2023

La operación asincrónica Create Cloud Service crea un nuevo servicio en la nube en Microsoft Azure.

Request

La solicitud Create Cloud Service se especifica como sigue. Reemplace <subscription-id> con el Id. de suscripción.

Método	URI de solicitud
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices`

Parámetros de identificador URI

Ninguno.

Encabezados de solicitud

La tabla siguiente describe los encabezados de solicitud.

Encabezado de solicitud	Descripción
`Content-Type`	Necesario. Establezca este encabezado en `application/xml`.
`x-ms-version`	Necesario. Especifica la versión de la operación que se utiliza para esta solicitud. El valor de este encabezado debe establecerse `2010-10-28` en o superior.

Cuerpo de la solicitud

El formato del cuerpo de la solicitud es el siguiente:

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

En la tabla siguiente se describen los elementos del cuerpo de la solicitud.

Nombre del elemento	Descripción
ServiceName	Necesario. Especifica el nombre del servicio en la nube. Este nombre debe ser único dentro de Azure. Este nombre es el nombre del prefijo DNS que se utiliza para tener acceso al servicio. Para comprobar la disponibilidad de un nombre, puede usar Comprobar la disponibilidad del nombre del servicio en la nube.
Etiqueta	Necesario. Especifica el identificador codificado en base 64 del servicio en la nube. El identificador puede tener una longitud máxima de 100 caracteres. La etiqueta se puede usar con fines de seguimiento.
Descripción	Opcional. Especifica la descripción del servicio en la nube. La descripción puede contener un máximo de 1024 caracteres.
Location	Es necesario si `AffinityGroup` no se especifica. Especifica la ubicación en la que se crea el servicio en la nube. Debe especificar `Location` o `AffinityGroup`, pero no ambos. Para ver las ubicaciones disponibles, puede usar Ubicaciones de lista.
AffinityGroup	Es necesario si `Location` no se especifica. Especifica el nombre de un grupo de afinidad existente que está asociado a la suscripción. Debe especificar `Location` o `AffinityGroup`, pero no ambos. Para ver los grupos de afinidad disponibles, puede usar Grupos de afinidad de lista.
Nombre	Opcional. Especifica el nombre de una propiedad de servicio en la nube extendida. El nombre puede tener una longitud máxima de 64 caracteres, solo son válidos los caracteres alfanuméricos y caracteres de subrayado, y debe comenzar por una letra. Cada propiedad extendida debe tener tanto un nombre como un valor definidos. Puede definir 50 propiedades extendidas, como máximo. El `Name` elemento solo está disponible con la versión 2012-03-01 o posterior.
Value	Opcional. Especifica el valor de una propiedad de servicio en la nube extendida. El valor de la propiedad extendida puede tener una longitud máxima de 255 caracteres. El `Value` elemento solo está disponible con la versión 2012-03-01 o posterior.
ReverseDnsFqdn	Opcional. Especifica la dirección DNS en la que se resuelve la dirección IP del servicio en la nube cuando se envía una consulta mediante una consulta de DNS inversa. El `ReverseDnsFqdn` elemento solo está disponible con la versión 2014-06-01 o posterior.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Código de estado

Una operación correcta devuelve el código de estado 201 (Creado).

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar.

Encabezado de respuesta	Descripción
`x-ms-request-id`	Valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración. Para una operación asincrónica, puede llamar a Get Operation Status con el valor del encabezado para determinar si la operación se ha completado, ha producido un error o sigue en curso.

Cuerpo de la respuesta