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. You can find the Id of an extension by using List Extensions.
You must make sure that the request that is made to the management service is secure. For additional details, see Authenticating Service Management Requests.
The following table describes required and optional request headers.
Required. Specifies the version of the operation to use for this request. This header must be set to 2013-03-01 or higher. For more information about versioning headers, see Service Management Versioning.
The response includes an HTTP status code, a set of response headers, and a response body.
A successful operation returns status code 200 (OK). For information about status codes, see Service Management Status and Error Codes.
The response for this operation includes the following headers. The response may also include additional standard HTTP headers. All standard headers conform to the HTTP/1.1 protocol specification.
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.
The provider namespace of the extension. The provider namespace for Microsoft Azure extensions is Microsoft.Windows.Azure.Extensions.
Required. The type of the extension.
The identifier of the extension.
The version of the extension.
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.
The thumbprint algorithm of the certificate that is used to encrypt the configuration specified in PrivateConfiguration.
The public configuration that is defined using the schema returned by the List Available Extensions operation.
Indicates whether the extension configuration supports JSON.
Possible values are:
The IsJsonExtension element is only available using version 2014-06-01 or higher.
Indicates whether the extension supports automatically upgrading to new major versions.
The DisallowMajorVersionUpgrade element is only available using version 2014-06-01 or higher.