次の方法で共有


Virtual Machine Extensions - Get

拡張機能を取得する操作。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/extensions/{vmExtensionName}?api-version=2024-07-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/extensions/{vmExtensionName}?$expand={$expand}&api-version=2024-07-01

URI パラメーター

名前 / 必須 説明
resourceGroupName
path True

string

リソース グループの名前。

subscriptionId
path True

string

Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、すべてのサービス呼び出しの URI の一部を形成します。

vmExtensionName
path True

string

仮想マシン拡張機能の名前。

vmName
path True

string

拡張機能を含む仮想マシンの名前。

api-version
query True

string

クライアント API のバージョン。

$expand
query

string

操作に適用する展開式。

応答

名前 説明
200 OK

VirtualMachineExtension

わかりました

Other Status Codes

CloudError

操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

VirtualMachineExtension_Get_MaximumSet_Gen
VirtualMachineExtension_Get_MinimumSet_Gen

VirtualMachineExtension_Get_MaximumSet_Gen

要求のサンプル

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/extensions/aaaaaaa?$expand=aaaaaa&api-version=2024-07-01

応答のサンプル

{
  "name": "myVMExtension",
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/extensions/myVMExtension",
  "location": "westus",
  "properties": {
    "autoUpgradeMinorVersion": true,
    "provisioningState": "Creating",
    "publisher": "extPublisher",
    "type": "extType",
    "typeHandlerVersion": "1.2",
    "suppressFailures": true,
    "settings": {},
    "forceUpdateTag": "a",
    "enableAutomaticUpgrade": true,
    "protectedSettings": {},
    "instanceView": {
      "name": "aaaaaaaaaaaaaaaaa",
      "type": "aaaaaaaaa",
      "typeHandlerVersion": "aaaaaaaaaaaaaaaaaaaaaaaaaa",
      "substatuses": [
        {
          "code": "aaaaaaaaaaaaaaaaaaaaaaa",
          "level": "Info",
          "displayStatus": "aaaaaa",
          "message": "a",
          "time": "2021-11-30T12:58:26.522Z"
        }
      ],
      "statuses": [
        {
          "code": "aaaaaaaaaaaaaaaaaaaaaaa",
          "level": "Info",
          "displayStatus": "aaaaaa",
          "message": "a",
          "time": "2021-11-30T12:58:26.522Z"
        }
      ]
    }
  },
  "tags": {
    "key9183": "aa"
  }
}

VirtualMachineExtension_Get_MinimumSet_Gen

要求のサンプル

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/myVM/extensions/myVMExtension?api-version=2024-07-01

応答のサンプル

{
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/myVM/extensions/myVMExtension"
}

定義

名前 説明
ApiError

API エラー。

ApiErrorBase

API エラーベース。

CloudError

コンピューティング サービスからのエラー応答。

InnerError

内部エラーの詳細。

InstanceViewStatus

インスタンス ビューの状態。

KeyVaultSecretReference

Key Vault シークレットへの参照について説明します

StatusLevelTypes

レベル コード。

SubResource
VirtualMachineExtension

仮想マシン拡張機能について説明します。

VirtualMachineExtensionInstanceView

仮想マシン拡張機能のインスタンス ビュー。

ApiError

API エラー。

名前 説明
code

string

エラー コード。

details

ApiErrorBase[]

Api エラーの詳細

innererror

InnerError

Api 内部エラー

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

ApiErrorBase

API エラーベース。

名前 説明
code

string

エラー コード。

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

CloudError

コンピューティング サービスからのエラー応答。

名前 説明
error

ApiError

API エラー。

InnerError

内部エラーの詳細。

名前 説明
errordetail

string

内部エラー メッセージまたは例外ダンプ。

exceptiontype

string

例外の種類。

InstanceViewStatus

インスタンス ビューの状態。

名前 説明
code

string

状態コード。

displayStatus

string

状態の短いローカライズ可能なラベル。

level

StatusLevelTypes

レベル コード。

message

string

アラートやエラー メッセージを含む詳細なステータス メッセージ。

time

string

状態の時刻。

KeyVaultSecretReference

Key Vault シークレットへの参照について説明します

名前 説明
secretUrl

string

Key Vault 内のシークレットを参照する URL。

sourceVault

SubResource

シークレットを含む Key Vault の相対 URL。

StatusLevelTypes

レベル コード。

名前 説明
Error

string

Info

string

Warning

string

SubResource

名前 説明
id

string

リソース ID

VirtualMachineExtension

仮想マシン拡張機能について説明します。

名前 説明
id

string

リソース ID

location

string

リソースの場所

name

string

リソース名

properties.autoUpgradeMinorVersion

boolean

展開時に使用可能な場合に、拡張機能で新しいマイナー バージョンを使用する必要があるかどうかを示します。 ただし、デプロイされると、このプロパティが true に設定されていても、再デプロイされない限り、拡張機能はマイナー バージョンをアップグレードしません。

properties.enableAutomaticUpgrade

boolean

使用可能な拡張機能の新しいバージョンがある場合に、拡張機能をプラットフォームによって自動的にアップグレードするかどうかを示します。

properties.forceUpdateTag

string

拡張機能の構成が変更されていない場合でも、拡張機能ハンドラーを強制的に更新する方法。

properties.instanceView

VirtualMachineExtensionInstanceView

仮想マシン拡張機能インスタンス ビュー。

properties.protectedSettings

object

拡張機能には、protectedSettings または protectedSettingsFromKeyVault、または保護された設定をまったく含めなくなります。

properties.protectedSettingsFromKeyVault

KeyVaultSecretReference

参照によって渡され、キー コンテナーから使用される、拡張機能で保護された設定

properties.provisionAfterExtensions

string[]

この拡張機能をプロビジョニングする必要がある拡張機能名のコレクション。

properties.provisioningState

string

プロビジョニング状態。応答にのみ表示されます。

properties.publisher

string

拡張ハンドラーの発行元の名前。

properties.settings

object

拡張機能の Json 形式のパブリック設定。

properties.suppressFailures

boolean

拡張機能に起因するエラーを抑制するかどうかを示します (VM に接続しないなどの操作エラーは、この値に関係なく抑制されません)。 既定値は false です。

properties.type

string

拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。

properties.typeHandlerVersion

string

スクリプト ハンドラーのバージョンを指定します。

tags

object

リソース タグ

type

string

リソースの種類

VirtualMachineExtensionInstanceView

仮想マシン拡張機能のインスタンス ビュー。

名前 説明
name

string

仮想マシン拡張機能の名前。

statuses

InstanceViewStatus[]

リソースの状態情報。

substatuses

InstanceViewStatus[]

リソースの状態情報。

type

string

拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。

typeHandlerVersion

string

スクリプト ハンドラーのバージョンを指定します。