Condividi tramite


Virtual Machine Extensions - Get

Operazione per ottenere l'estensione.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse.

subscriptionId
path True

string

Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.

vmExtensionName
path True

string

Nome dell'estensione macchina virtuale.

vmName
path True

string

Nome della macchina virtuale contenente l'estensione.

api-version
query True

string

Versione dell'API client.

$expand
query

string

Espressione di espansione da applicare all'operazione.

Risposte

Nome Tipo Descrizione
200 OK

VirtualMachineExtension

OK

Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

VirtualMachineExtension_Get_MaximumSet_Gen
VirtualMachineExtension_Get_MinimumSet_Gen

VirtualMachineExtension_Get_MaximumSet_Gen

Esempio di richiesta

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

Risposta di esempio

{
  "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

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
ApiError

Errore dell'API.

ApiErrorBase

Base degli errori api.

CloudError

Risposta di errore dal servizio di calcolo.

InnerError

Dettagli dell'errore interno.

InstanceViewStatus

Stato di visualizzazione dell'istanza.

KeyVaultSecretReference

Descrive un riferimento al segreto dell'insieme di credenziali delle chiavi

StatusLevelTypes

Codice a livello.

SubResource
VirtualMachineExtension

Descrive un'estensione macchina virtuale.

VirtualMachineExtensionInstanceView

Visualizzazione dell'istanza di un'estensione macchina virtuale.

ApiError

Errore dell'API.

Nome Tipo Descrizione
code

string

Codice di errore.

details

ApiErrorBase[]

Dettagli dell'errore dell'API

innererror

InnerError

Errore interno dell'API

message

string

Messaggio di errore.

target

string

Destinazione dell'errore specifico.

ApiErrorBase

Base degli errori api.

Nome Tipo Descrizione
code

string

Codice di errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore specifico.

CloudError

Risposta di errore dal servizio di calcolo.

Nome Tipo Descrizione
error

ApiError

Errore dell'API.

InnerError

Dettagli dell'errore interno.

Nome Tipo Descrizione
errordetail

string

Messaggio di errore interno o dump delle eccezioni.

exceptiontype

string

Tipo di eccezione.

InstanceViewStatus

Stato di visualizzazione dell'istanza.

Nome Tipo Descrizione
code

string

Codice di stato.

displayStatus

string

Etichetta localizzabile breve per lo stato.

level

StatusLevelTypes

Codice a livello.

message

string

Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore.

time

string

Ora dello stato.

KeyVaultSecretReference

Descrive un riferimento al segreto dell'insieme di credenziali delle chiavi

Nome Tipo Descrizione
secretUrl

string

URL che fa riferimento a un segreto in un insieme di credenziali delle chiavi.

sourceVault

SubResource

URL relativo dell'insieme di credenziali delle chiavi contenente il segreto.

StatusLevelTypes

Codice a livello.

Nome Tipo Descrizione
Error

string

Info

string

Warning

string

SubResource

Nome Tipo Descrizione
id

string

ID risorsa

VirtualMachineExtension

Descrive un'estensione macchina virtuale.

Nome Tipo Descrizione
id

string

ID risorsa

location

string

Percorso risorsa

name

string

Nome risorsa

properties.autoUpgradeMinorVersion

boolean

Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true.

properties.enableAutomaticUpgrade

boolean

Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione.

properties.forceUpdateTag

string

Come deve essere forzato l'aggiornamento del gestore di estensioni anche se la configurazione dell'estensione non è stata modificata.

properties.instanceView

VirtualMachineExtensionInstanceView

Visualizzazione dell'istanza dell'estensione della macchina virtuale.

properties.protectedSettings

object

L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta.

properties.protectedSettingsFromKeyVault

KeyVaultSecretReference

Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi

properties.provisionAfterExtensions

string[]

Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione.

properties.provisioningState

string

Stato di provisioning, visualizzato solo nella risposta.

properties.publisher

string

Nome del server di pubblicazione del gestore dell'estensione.

properties.settings

object

Impostazioni pubbliche in formato JSON per l'estensione.

properties.suppressFailures

boolean

Indica se gli errori derivanti dall'estensione verranno eliminati (gli errori operativi, ad esempio la mancata connessione alla macchina virtuale, non verranno eliminati indipendentemente da questo valore). Il valore predefinito è false.

properties.type

string

Specifica il tipo di estensione; un esempio è "CustomScriptExtension".

properties.typeHandlerVersion

string

Specifica la versione del gestore di script.

tags

object

Tag delle risorse

type

string

Tipo di risorsa

VirtualMachineExtensionInstanceView

Visualizzazione dell'istanza di un'estensione macchina virtuale.

Nome Tipo Descrizione
name

string

Nome dell'estensione della macchina virtuale.

statuses

InstanceViewStatus[]

Informazioni sullo stato della risorsa.

substatuses

InstanceViewStatus[]

Informazioni sullo stato della risorsa.

type

string

Specifica il tipo di estensione; un esempio è "CustomScriptExtension".

typeHandlerVersion

string

Specifica la versione del gestore di script.