Obtener una extensión

La operación Get Extension recupera información sobre una extensión especificada que se agregó a un servicio en la nube.

Request

La solicitud Get Extension se puede especificar como sigue. Reemplace <subscription-id> por el identificador de la suscripción, <cloudservice-name> por el nombre del servicio en la nube y <extensionId> por el identificador que se asignó a la extensión cuando se agregó al servicio en la nube.

Método	URI de solicitud
GET	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions/<extensionId>

Parámetros de identificador URI

Ninguno.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

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 superior.

Cuerpo de la solicitud

Ninguno.

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.

Cuerpo de la respuesta

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

  
<?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>  
  <Version>version-of-extension</Version>  
  <Thumbprint>thumbprint-of-encryption-certificate</Thumbprint>  
  <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
  <PublicConfiguration>base-64-encoded-xsd-for-extension-public-configuration</PublicConfiguration>  
  <IsJsonExtension>indicator-of-json-support</IsJsonExtension>  
  <DisallowMajorVersionUpgrade>indicator-of-allowed-version-upgrades</DisallowMajorVersionUpgrade>  
</Extension>  
  

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

Nombre del elemento	Descripción
ProviderNameSpace	El espacio de nombres del proveedor de la extensión. El espacio de nombres del proveedor para las extensiones de Microsoft Azure es Microsoft.Windows.Azure.Extensions.
Tipo	Necesario. El tipo de extensión.
Identificador	Identificador de la extensión.
Versión	Versión de la extensión.
Huella digital	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	El algoritmo de huella digital del certificado usado para cifrar la configuración especificada en PrivateConfiguration.
PublicConfiguration	Configuración pública definida mediante el esquema devuelto por la operación List Available Extensions .
IsJsonExtension	Indica si la configuración de la extensión admite JSON. Los valores posibles son: - true - false El IsJsonExtension elemento solo está disponible con la versión 2014-06-01 o posterior.
DisallowMajorVersionUpgrade	Indica si la extensión admite la actualización automática a nuevas versiones principales. El DisallowMajorVersionUpgrade elemento solo está disponible con la versión 2014-06-01 o posterior.