Share via


Get Extension

Get Extension 操作は、クラウド サービスに追加された指定の拡張子に関する情報を取得します。

要求

Get Extension要求は、次のように指定できます。 <subscription-id> を実際のサブスクリプション ID に、<cloudservice-name> をクラウド サービスの名前に、<extensionId> を拡張機能がクラウド サービスに追加されるときに拡張機能に割り当てられた識別子に、それぞれ置き換えます。

Method 要求 URI
GET https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/extensions/<extensionId>

URI パラメーター

なし。

要求ヘッダー

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

要求ヘッダー 説明
x-ms-version 必須。 この要求に使用する操作のバージョンを指定します。 このヘッダーは 以上に設定する 2013-03-01 必要があります。

要求本文

なし。

[応答]

応答には、HTTP 状態コード、一連の応答ヘッダー、および応答本文が含まれています。

状態コード

操作に成功すると、状態コード 200 (OK) が返されます。

レスポンス ヘッダー

この操作の応答には、次のヘッダーが含まれています。 応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。

応答ヘッダー 説明
x-ms-request-id 管理サービスに対して行われた要求を一意に識別する値。

応答本文

応答本文の形式を示す例を次に示します。

  
<?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>  
  

応答本文の要素は次のとおりです。

要素名 説明
ProviderNameSpace 拡張機能のプロバイダーの名前空間。 Microsoft Azure 拡張機能のプロバイダーの名前空間は、Microsoft.Windows.Azure.Extensions です。
Type 必須。 拡張機能の型。
Id 拡張機能の識別子。
バージョン 拡張機能のバージョン。
Thumbprint PrivateConfiguration で指定された構成の暗号化に使用される証明書のサムプリント。 この要素が指定されていない場合、証明書は自動的に生成され、クラウド サービスに追加される場合があります。
ThumbprintAlgorithm PrivateConfiguration で指定された構成の暗号化に使用される証明書のサムプリント アルゴリズム。
PublicConfiguration 使用可能な拡張機能の一覧表示操作によって返されるスキーマを使用して定義されるパブリック構成。
IsJsonExtension 拡張機能で新しいメジャー バージョンへの自動アップグレードがサポートされているかどうかを示します。

次のいずれかの値になります。

- true
- false

IsJsonExtension 要素は、バージョン 01.06.14 以上を使用している場合のみ使用できます。
DisallowMajorVersionUpgrade 拡張機能で新しいメジャー バージョンへの自動アップグレードがサポートされているかどうかを示します。

DisallowMajorVersionUpgrade 要素は、バージョン 01.06.14 以上を使用している場合のみ使用できます。