Agregar extensión

La operación asincrónica Add Extension agrega una extensión disponible al servicio en la nube. En Microsoft Azure, un proceso puede ejecutarse como una extensión de un servicio en la nube.

Request

La solicitud Add Extension 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
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions

Parámetros de identificador URI

Ninguno.

Encabezados de solicitud

La tabla siguiente describe los encabezados de solicitud.

Encabezado de solicitud	Descripción
x-ms-version	Necesario. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debe establecerse 2013-03-01 en o en una versión posterior.

Cuerpo de la solicitud

En el ejemplo siguiente se muestra el formato del cuerpo de la solicitud:

  
<?xml version="1.0" encoding="utf-8"?>  
<Extension xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <ProviderNameSpace>namespace-of-extension</ProviderNameSpace>  
  <Type>type-of-extension</Type>  
  <Id>identifier-of-extension</Id>  
  <Thumbprint>thumbprint-of-encryption-certificate</Thumbprint>  
  <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
  <PublicConfiguration>base-64-encoded-xsd-for-extension-public-configuration</PublicConfiguration>  
  <PrivateConfiguration>base-64-encoded-xsd-for-extension-private-configuration</PrivateConfiguration>  
  <Version>version-of-extension</Version>  
</Extension>  

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

Nombre del elemento	Descripción
ProviderNameSpace	Necesario. Especifica el espacio de nombres del proveedor de la extensión. El espacio de nombres del proveedor para las extensiones de Azure es Microsoft.Windows.Azure.Extensions.
Tipo	Necesario. Especifica el tipo de la extensión.
Identificador	Necesario. Especifica el identificador de la extensión.
Huella digital	Opcional. Especifica la huella digital del certificado usado para cifrar la configuración especificada en PrivateConfiguration. Si no se especifica este elemento, se puede generar y agregar un certificado al servicio en la nube automáticamente.
ThumbprintAlgorithm	Opcional. Especifica el algoritmo de huella digital del certificado usado para cifrar la configuración especificada en PrivateConfiguration.
PublicConfiguration	Opcional. Especifica la configuración pública definida mediante el esquema devuelto por la operación List Available Extensions .
PrivateConfiguration	Opcional. Especifica la configuración privada definida mediante el esquema devuelto por la operación List Available Extensions .
Versión	Opcional. Especifica la versión de la extensión. Si no se especifica este elemento o se usa un asterisco (*) como valor, se usa la versión más reciente de la extensión. Si se especifica el valor con un número de versión principal y un asterisco como el número de versión secundaria (X.*), se selecciona la última versión secundaria de la versión principal especificada. Si se especifica un número de versión principal y un número de versión secundaria (X.Y), se selecciona la versión de la extensión específica. Si se especifica una versión, se realiza una actualización automática en la instancia de rol.

Response

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

Código de estado

Una operación correcta devuelve el código de estado 200 Correcto.

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

Ninguno.