Machine Extensions - List

Riferimento

Servizio:: Hybrid Compute

Versione API:: 2025-01-13

Operazione per ottenere tutte le estensioni di un computer non Azure

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/extensions?api-version=2025-01-13

Con parametri facoltativi:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/extensions?$expand={$expand}&api-version=2025-01-13

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
machineName	path	True	string minLength: 1 maxLength: 54 pattern: ^[a-zA-Z0-9-_\.]{1,54}$	Nome del computer contenente l'estensione.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
$expand	query		string	Espressione di espansione da applicare all'operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	MachineExtensionsListResult	OK
Other Status Codes	ErrorResponse	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

GET all Machine Extensions - List

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/machines/myMachine/extensions?api-version=2025-01-13

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/Machines/myMachine/Extensions/CustomScriptExtension",
      "name": "CustomScriptExtension",
      "location": "eastus2euap",
      "type": "Microsoft.HybridCompute/machines/extensions",
      "properties": {
        "publisher": "Microsoft.Compute",
        "type": "CustomScriptExtension",
        "typeHandlerVersion": "1.10.3",
        "autoUpgradeMinorVersion": false,
        "settings": {
          "commandToExecute": "powershell.exe -c \"Get-Process | Where-Object { $_.CPU -gt 10000 }\""
        },
        "provisioningState": "Succeeded",
        "instanceView": {
          "name": "CustomScriptExtension",
          "type": "CustomScriptExtension",
          "typeHandlerVersion": "1.10.3",
          "status": {
            "code": "success",
            "level": "Information",
            "displayStatus": "Provisioning succeeded",
            "message": "formattedMessage: Finished executing command, StdOut: , StdErr: ",
            "time": "2020-08-13T17:18:57.405Z"
          }
        }
      }
    },
    {
      "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/Machines/myMachine/Extensions/winosupdateextension",
      "name": "winosupdateextension",
      "location": "eastus2euap",
      "type": "Microsoft.HybridCompute/machines/extensions",
      "properties": {
        "publisher": "microsoft.softwareupdatemanagement.test",
        "type": "windowsosupdateextension",
        "typeHandlerVersion": "1.0.0.0",
        "autoUpgradeMinorVersion": false,
        "settings": {},
        "provisioningState": "Creating",
        "instanceView": {
          "name": "winosupdateextension",
          "type": "windowsosupdateextension",
          "typeHandlerVersion": "1.0.0.0",
          "status": {}
        }
      }
    }
  ]
}

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
HotpatchEnablementStatus	Stato dell'abilitazione o della disabilitazione di hotpatch.
MachineExtension	Descrive un'estensione del computer.
MachineExtensionInstanceView	Descrive la visualizzazione dell'istanza dell'estensione del computer.
MachineExtensionProperties	Descrive le proprietà di un'estensione del computer.
MachineExtensionsListResult	Descrive il risultato dell'elenco estensioni computer.
Status	Stato della registrazione o della registrazione delle funzionalità hotpatch.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

HotpatchEnablementStatus

Enumerazione

Stato dell'abilitazione o della disabilitazione di hotpatch.

Valore	Descrizione
ActionRequired
Disabled
Enabled
PendingEvaluation
Unknown

MachineExtension

Object

Descrive un'estensione del computer.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties	MachineExtensionProperties	Descrive le proprietà dell'estensione del computer.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

MachineExtensionInstanceView

Object

Descrive la visualizzazione dell'istanza dell'estensione del computer.

Nome	Tipo	Descrizione
name	string	Nome dell'estensione del computer.
status	Status	Stato di visualizzazione dell'istanza.
type	string	Specifica il tipo di estensione; un esempio è "CustomScriptExtension".
typeHandlerVersion	string	Specifica la versione del gestore di script.

MachineExtensionProperties

Object

Descrive le proprietà di un'estensione del computer.

Nome	Tipo	Descrizione
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.
enableAutomaticUpgrade	boolean	Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente.
forceUpdateTag	string	Come deve essere forzato l'aggiornamento del gestore di estensioni anche se la configurazione dell'estensione non è stata modificata.
instanceView	MachineExtensionInstanceView	Visualizzazione dell'istanza dell'estensione del computer.
protectedSettings		L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta.
provisioningState	string	Stato di provisioning, visualizzato solo nella risposta.
publisher	string	Nome del server di pubblicazione del gestore dell'estensione.
settings		Impostazioni pubbliche in formato JSON per l'estensione.
type	string	Specifica il tipo di estensione; un esempio è "CustomScriptExtension".
typeHandlerVersion	string	Specifica la versione del gestore di script.

MachineExtensionsListResult

Object

Descrive il risultato dell'elenco estensioni computer.

Nome	Tipo	Descrizione
nextLink	string	URI per recuperare la pagina successiva delle estensioni del computer. Chiamare ListNext() con questa opzione per recuperare la pagina successiva delle estensioni.
value	MachineExtension[]	Elenco di estensioni

Status

Object

Stato della registrazione o della registrazione delle funzionalità hotpatch.

Nome	Tipo	Descrizione
error	ErrorDetail	Errori riscontrati durante la registrazione o la registrazione delle funzionalità hotpatch.
hotpatchEnablementStatus	HotpatchEnablementStatus	Indica lo stato corrente del hotpatch abilitato o disabilitato.

systemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Condividi tramite

Machine Extensions - List

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

GET all Machine Extensions - List

Esempio di richiesta

Risposta di esempio

Definizioni

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HotpatchEnablementStatus

MachineExtension

MachineExtensionInstanceView

MachineExtensionProperties

MachineExtensionsListResult

Status

systemData