Get Extension
Updated: June 29, 2015
The Get Extension operation retrieves information about a specified extension that was added to a cloud service.
The Get Extension request may be specified as follows. Replace <subscription-id> with your subscription ID, <cloudservice-name> with the name of the cloud service, and <extensionId> with the identifier that was assigned to the extension when it was added to the cloud service.
Method | Request URI |
|---|---|
GET | https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions/<extensionId> |
None.
The following table describes required and optional request headers.
Request Header | Description |
|---|---|
x-ms-version | Required. Specifies the version of the operation to use for this request. This header must be set to 2013-03-01 or higher. |
None.
The response includes an HTTP status code, a set of response headers, and a response body.
A successful operation returns status code 200 (OK).
The response for this operation includes the following headers. The response may also include additional standard HTTP headers.
Response Header | Description |
|---|---|
x-ms-request-id | A value that uniquely identifies a request made against the management service. |
The following example shows the format of the response body:
<?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>
The following table describes the elements of the response body.
Element name | Description |
|---|---|
ProviderNameSpace | The provider namespace of the extension. The provider namespace for Microsoft Azure extensions is Microsoft.Windows.Azure.Extensions. |
Type | Required. The type of the extension. |
Id | The identifier of the extension. |
Version | The version of the extension. |
Thumbprint | The thumbprint of the certificate that is used to encrypt the configuration specified in PrivateConfiguration. If this element is not specified, a certificate may be automatically generated and added to the cloud service. |
ThumbprintAlgorithm | The thumbprint algorithm of the certificate that is used to encrypt the configuration specified in PrivateConfiguration. |
PublicConfiguration | The public configuration that is defined using the schema returned by the List Available Extensions operation. |
IsJsonExtension | Indicates whether the extension configuration supports JSON. Possible values are:
The IsJsonExtension element is only available using version 2014-06-01 or higher. |
DisallowMajorVersionUpgrade | Indicates whether the extension supports automatically upgrading to new major versions. The DisallowMajorVersionUpgrade element is only available using version 2014-06-01 or higher. |