VENTAS: 1-800-867-1389

Actualizar un servicio en la nube

Actualizado: mayo de 2014

La operación Update Cloud Service actualiza la etiqueta o la descripción de un servicio en la nube.

La solicitud Update Cloud Service se puede especificar como sigue. Reemplace <subscription-id> con el identificador de la suscripción y <cloudservice-name> con el nombre del servicio en la nube.

 

Método URI de solicitud

PUT

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>

Debe asegurarse de que la solicitud que se realice al servicio de administración sea segura. Para obtener detalles adicionales, vea Autenticar solicitudes de administración del servicio.

Ninguna.

La tabla siguiente describe los encabezados de solicitud.

 

Encabezado de solicitud Descripción

Content-Type

Requerido. Establezca este encabezado en application/xml.

x-ms-version

Requerido. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debería establecerse en 28/10/2010 o posterior. Para obtener más información acerca de los encabezados de control de versiones, vea Control de versiones de la administración del servicio.

El formato del cuerpo de la solicitud es el siguiente:

<?xml version="1.0" encoding="utf-8"?>
<UpdateHostedService xmlns="http://schemas.microsoft.com/windowsazure">
  <Label>base64-encoded-label-of-cloud-service</Label>
  <Description>description-of-cloud-service</Description>
  <ExtendedProperties>
    <ExtendedProperty>
      <Name>name-of-property</Name>
      <Value>value-of-property</Value>
    </ExtendedProperty>
  </ExtendedProperties>
  <GuestAgentType>type-of-guest-agent</GuestAgentType
</UpdateHostedService>

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

 

Nombre de elemento Descripción

Etiqueta

Opcional si se especifica Description. Especifica el identificador codificado en base 64 del servicio en la nube. El identificador puede tener una longitud máxima de 100 caracteres. Se recomienda que la etiqueta sea única dentro de la suscripción. La etiqueta se puede usar con fines de seguimiento.

Descripción

Opcional si se especifica Label. Especifica la descripción del servicio en la nube. La descripción puede contener un máximo de 1024 caracteres.

Nombre

Opcional. Especifica el nombre de una propiedad de servicio en la nube extendida. Debe proporcionar un nombre y un valor para cada propiedad. Se permiten 50 propiedades extendidas, como máximo. El nombre puede tener hasta 64 caracteres. El nombre solo puede contener caracteres alfanuméricos y caracteres de subrayado y debe comenzar con una letra.

El elemento Name solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

Valor

Opcional. Especifica el valor de una propiedad de servicio en la nube extendida. Cada propiedad extendida debe tener tanto un nombre como un valor definidos. El valor puede tener una longitud máxima de 255 caracteres. Puede eliminar una propiedad existente estableciendo el valor NULL.

El elemento Value solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

GuestAgentType

Opcional. Especifica el tipo de agente invitado instalado en las implementaciones de roles web y de roles de trabajo.

Los valores posibles son:

  • ProdGA

  • TestGA

GuestAgentType es un elemento restringido que solo puede usarse en las suscripciones autorizadas configuradas para el acceso temprano a las versiones futuras del agente invitado. Cuando GuestAgentType se establece en ProdGA, el agente invitado más reciente que haya sido liberado públicamente se instala en las instancias de los roles web y los roles de trabajo en un servicio en la nube. Cuando GuestAgentType se establece en TestGA, se instala la versión más reciente del agente invitado.

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

Una operación correcta devuelve el código de estado 200 (Correcto). Para obtener información acerca de los códigos de estado, vea Estado y códigos de error de administración del servicio.

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.

 

Encabezado de respuesta Descripción

x-ms-request-id

Valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración.

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2014 Microsoft