Enumerar extensiones disponibles

Artículo
07/19/2023

La operación List Available Extensions enumera las extensiones disponibles para agregar 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 List Available Extensions se puede especificar como sigue. Reemplace <subscription-id> con el Id. de suscripción.

Método	URI de solicitud
GET	`https://management.core.windows.net/<subscription-id>/services/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 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"?>  
<ExtensionImages xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <ExtensionImage>  
    <ProviderNameSpace>namespace-of-extension</ProviderNameSpace>  
    <Type>type-of-extension</Type>      
    <Version>version-of-extension</Version>  
    <Label>label-of-extension</Label>  
    <Description>description-of-extension</Description>  
    <HostingResources>role-type</HostingResources>  
    <ThumbprintAlgorithm>thumbprint-algorithm</ThumbprintAlgorithm>  
    <PublicConfigurationSchema>base-64-encoded-xsd-for-extension-settings</PublicConfigurationSchema>  
    <PrivateConfigurationSchema>base-64-encoded-xsd-for-extension-settings</PrivateConfigurationSchema>  
    <SampleConfig>base-64-encoded-sample-XML-for-extension</SampleConfig>  
    <ReplicationCompleted>indicator-of-replication-status</ReplicationCompleted>  
    <Eula> HYPERLINK "http://www.contoso.com/42588280809/eula%3c/Eula" eula-of-extension</Eula>  
    <PrivacyUri>privacy-policy-of-extension</PrivacyUri>  
    <HomepageUri>homepage-of-extension</HomepageUri>  
    <IsJsonExtension>indicator-of-JSON-support</IsJsonExtension>  
    <CompanyName>name-of-publishing-company</CompanyName>  
    <SupportedOS>supported-operating-system</SupportedOS>  
    <PublishedDate>publish-date-of-extension</PublishedDate>  
  </ExtensionImage>  
</ExtensionImages>

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

Nombre del elemento	Descripción
ProviderNameSpace	Especifica el espacio de nombres del proveedor de la extensión. El espacio de nombres del proveedor para las extensiones de Azure es `Microsoft.WindowsAzure.Extensions`.
Tipo	Especifica el tipo de la extensión.
Versión	Especifica la versión de la extensión.
Etiqueta	Especifica la etiqueta que se usa para identificar la extensión.
Descripción	Especifica la descripción de la extensión.
HostingResources	Especifica el tipo de recurso que admite la extensión. Este valor puede ser `WebRole`, `WorkerRole` o `WebRole\|WorkerRole`.
ThumbprintAlgorithm	Especifica el algoritmo de huella digital del certificado que se utiliza para el cifrado.
PublicConfigurationSchema	Especifica el esquema codificado en base 64 de la configuración pública.
PrivateConfigurationSchema	Especifica el esquema codificado en base 64 de la configuración privada.
SampleConfig	Especifica un archivo de configuración de ejemplo para la extensión de recursos. El elemento SampleConfig solamente se encuentra disponible si se utiliza la versión 2013-11-01 o versiones posteriores.
ReplicationCompleted	Indica si la versión de la extensión se ha replicado en todas las regiones. Los valores posibles son: - `true` - `false` `true` si la versión de la extensión se puede usar para crear o actualizar una implementación; de lo contrario, `false` indica que la versión de la extensión no está lista para usarse en todas las regiones. El `ReplicationCompleted` elemento solo está disponible con la versión 2014-04-01 o posterior.
CLUF	Especifica un URI que señala al contrato de licencia del usuario final (CLUF) para la versión de la extensión. El `Eula` elemento solo está disponible con la versión 2014-04-01 o posterior.
PrivacyUri	Especifica un URI que señala a la declaración de privacidad de la versión de la extensión. El `PrivacyUri` elemento solo está disponible con la versión 2014-04-01 o posterior.
HomepageUri	Especifica el URI que señala a la página principal de la versión de la extensión. El `HomepageUri` elemento solo está disponible con la versión 2014-04-01 o posterior.
IsJsonExtension	Indica si la versión de la extensión acepta una configuración basada en JSON. Los valores posibles son: - `true` - `false` `true` si la extensión acepta una configuración basada en JSON; de lo contrario, `false`y la extensión acepta una configuración basada en XML. El `IsJsonExtension` elemento solo está disponible con la versión 2014-04-01 o posterior.
CompanyName	Especifica el nombre de la compañía que ha publicado la extensión. El `CompanyName` elemento solo está disponible con la versión 2014-06-01 o posterior.
SupportedOS	Especifica el sistema operativo en el que se ejecuta la extensión. El `SupportedOS` elemento solo está disponible con la versión 2014-06-01 o posterior.
PublishedDate	Especifica la fecha en la que se ha publicado la extensión. El `PublishedDate` elemento solo está disponible con la versión 2014-06-01 o posterior.

Compartir a través de