Virtual Machine Scale Set VM Extensions - List
Operación para obtener todas las extensiones de una instancia en virtual Machine Scaleset.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}/extensions?api-version=2024-03-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}/extensions?$expand={$expand}&api-version=2024-03-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
instance
|
path | True |
string |
Identificador de instancia de la máquina virtual. |
resource
|
path | True |
string |
Nombre del grupo de recursos. |
subscription
|
path | True |
string |
Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio. |
vm
|
path | True |
string |
Nombre del conjunto de escalado de máquinas virtuales. |
api-version
|
query | True |
string |
Versión de api de cliente. |
$expand
|
query |
string |
Expresión expand que se va a aplicar en la operación. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
List extensions in Vmss instance.
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions?api-version=2024-03-01
Sample Response
{
"value": [
{
"properties": {
"autoUpgradeMinorVersion": true,
"provisioningState": "Succeeded",
"publisher": "extPublisher",
"type": "extType",
"typeHandlerVersion": "1.2",
"settings": {
"UserName": "xyz@microsoft.com"
}
},
"name": "myVMExtension",
"type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
"id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions/myVMExtension"
},
{
"properties": {
"autoUpgradeMinorVersion": true,
"provisioningState": "Succeeded",
"publisher": "extPublisher1",
"type": "extType1",
"typeHandlerVersion": "1.0",
"settings": {
"UserName": "xyz@microsoft.com"
}
},
"name": "myVMExtension1",
"type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
"id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions/myVMExtension1"
}
]
}
Definiciones
Nombre | Description |
---|---|
Api |
Error de api. |
Api |
Base de errores de api. |
Cloud |
Respuesta de error del servicio Compute. |
Inner |
Detalles del error interno. |
Instance |
Estado de la vista de instancia. |
Key |
Describe una referencia al secreto de Key Vault |
Status |
El código de nivel. |
Sub |
|
Virtual |
Vista de instancia de una extensión de máquina virtual. |
Virtual |
Describe una extensión de máquina virtual de VMSS. |
Virtual |
Respuesta de la operación enumerar la extensión de máquina virtual de VMSS |
ApiError
Error de api.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error. |
details |
Detalles del error de api |
|
innererror |
Error interno de api |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error determinado. |
ApiErrorBase
Base de errores de api.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error. |
message |
string |
El mensaje de error. |
target |
string |
Destino del error determinado. |
CloudError
Respuesta de error del servicio Compute.
Nombre | Tipo | Description |
---|---|---|
error |
Error de api. |
InnerError
Detalles del error interno.
Nombre | Tipo | Description |
---|---|---|
errordetail |
string |
Mensaje de error interno o volcado de memoria de excepciones. |
exceptiontype |
string |
Tipo de la excepción. |
InstanceViewStatus
Estado de la vista de instancia.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de estado. |
displayStatus |
string |
Etiqueta localizable corta para el estado. |
level |
El código de nivel. |
|
message |
string |
Mensaje de estado detallado, incluidas las alertas y los mensajes de error. |
time |
string |
Hora del estado. |
KeyVaultSecretReference
Describe una referencia al secreto de Key Vault
Nombre | Tipo | Description |
---|---|---|
secretUrl |
string |
Dirección URL que hace referencia a un secreto en un Key Vault. |
sourceVault |
Dirección URL relativa del Key Vault que contiene el secreto. |
StatusLevelTypes
El código de nivel.
Nombre | Tipo | Description |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResource
Nombre | Tipo | Description |
---|---|---|
id |
string |
Id. de recurso |
VirtualMachineExtensionInstanceView
Vista de instancia de una extensión de máquina virtual.
Nombre | Tipo | Description |
---|---|---|
name |
string |
Nombre de la extensión de máquina virtual. |
statuses |
Información de estado del recurso. |
|
substatuses |
Información de estado del recurso. |
|
type |
string |
Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". |
typeHandlerVersion |
string |
Especifica la versión del controlador de script. |
VirtualMachineScaleSetVMExtension
Describe una extensión de máquina virtual de VMSS.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Id. de recurso |
location |
string |
Ubicación de la extensión. |
name |
string |
Nombre de la extensión. |
properties.autoUpgradeMinorVersion |
boolean |
Indica si la extensión debe usar una versión secundaria más reciente si hay una disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true. |
properties.enableAutomaticUpgrade |
boolean |
Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible. |
properties.forceUpdateTag |
string |
Cómo se debe forzar el controlador de extensión para actualizar incluso si la configuración de la extensión no ha cambiado. |
properties.instanceView |
Vista de instancia de extensión de máquina virtual. |
|
properties.protectedSettings |
object |
La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. |
properties.protectedSettingsFromKeyVault |
Configuración protegida de extensiones que se pasan por referencia y que se consumen desde el almacén de claves. |
|
properties.provisionAfterExtensions |
string[] |
Colección de nombres de extensión después de los cuales se debe aprovisionar esta extensión. |
properties.provisioningState |
string |
Estado de aprovisionamiento, que solo aparece en la respuesta. |
properties.publisher |
string |
Nombre del publicador de controladores de extensión. |
properties.settings |
object |
Configuración pública con formato JSON para la extensión. |
properties.suppressFailures |
boolean |
Indica si los errores derivados de la extensión se suprimirán (los errores operativos, como no conectarse a la máquina virtual, no se suprimirán independientemente de este valor). El valor predeterminado es false. |
properties.type |
string |
Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". |
properties.typeHandlerVersion |
string |
Especifica la versión del controlador de script. |
type |
string |
Tipo de recurso |
VirtualMachineScaleSetVMExtensionsListResult
Respuesta de la operación enumerar la extensión de máquina virtual de VMSS
Nombre | Tipo | Description |
---|---|---|
value |
Lista de extensiones de máquina virtual de VMSS |