Virtual Machine Instances - Get

Référence

Service:: Azure Arc enabled SCVMM

Version d'API:: 2024-06-01

Obtient une machine virtuelle.
Récupère des informations sur une instance de machine virtuelle.

GET https://management.azure.com/{resourceUri}/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceUri	path	True	string	Identificateur Azure Resource Manager complet de la ressource.
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	VirtualMachineInstance	L’opération Azure s’est terminée avec succès.
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

VirtualMachineInstances_Get_MaximumSet

VirtualMachineInstances_Get_MinimumSet

VirtualMachineInstances_Get_MaximumSet

Exemple de requête

HTTP

GET https://management.azure.com/gtgclehcbsyave/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

Exemple de réponse

Code d’état:: 200

{
  "properties": {
    "availabilitySets": [
      {
        "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/availabilitySets/availabilitySetResourceName",
        "name": "lwbhaseo"
      }
    ],
    "osProfile": {
      "computerName": "uuxpcxuxcufllc",
      "osType": "Windows",
      "osSku": "cxqnjxgkts",
      "osVersion": "djt",
      "domainName": "vblzsoqxzlrygdulnefexjdezo",
      "domainUsername": "sn",
      "workgroup": "bsqftibgcnnjpvmuxligk",
      "timezone": 4,
      "runOnceCommands": "byxpnluptiwxycbbybsf;qwerty"
    },
    "hardwareProfile": {
      "memoryMB": 5,
      "cpuCount": 22,
      "limitCpuForMigration": "true",
      "dynamicMemoryEnabled": "true",
      "dynamicMemoryMaxMB": 2,
      "dynamicMemoryMinMB": 30,
      "isHighlyAvailable": "true"
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "name": "kvofzqulbjlbtt",
          "displayName": "yoayfd",
          "ipv4Addresses": [
            "eeunirpkpqazzxhsqonkxcfuks"
          ],
          "ipv6Addresses": [
            "pk"
          ],
          "macAddress": "oaeqqegt",
          "virtualNetworkId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualNetworks/virtualNetworkName",
          "networkName": "lqbm",
          "ipv4AddressType": "Dynamic",
          "ipv6AddressType": "Dynamic",
          "macAddressType": "Dynamic",
          "nicId": "roxpsvlo"
        }
      ]
    },
    "storageProfile": {
      "disks": [
        {
          "name": "fgnckfymwdsqnfxkdvexuaobe",
          "displayName": "fgladknawlgjodo",
          "diskId": "ltdrwcfjklpsimhzqyh",
          "diskSizeGB": 30,
          "maxDiskSizeGB": 18,
          "bus": 8,
          "lun": 10,
          "busType": "zu",
          "vhdType": "cnbeeeylrvopigdynvgpkfp",
          "volumeType": "ckkymkuekzzqhexyjueruzlfemoeln",
          "vhdFormatType": "vbcrrmhgahznifudvhxfagwoplcb",
          "templateDiskId": "lcdwrokpyvekqccclf",
          "storageQoSPolicy": {
            "name": "ceiyfrflu",
            "id": "o"
          },
          "createDiffDisk": "true"
        }
      ]
    },
    "infrastructureProfile": {
      "inventoryItemId": "ihkkqmg",
      "vmmServerId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/vmmServers/vmmServerName",
      "cloudId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/clouds/cloudResourceName",
      "templateId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
      "vmName": "qovpayfydhcvfrhe",
      "uuid": "hrpw",
      "lastRestoredVMCheckpoint": {
        "parentCheckpointID": "hqhhzikoxunuqguouw",
        "checkpointID": "wsqmrje",
        "name": "keqn",
        "description": "qurzfrgyflrh"
      },
      "checkpoints": [
        {
          "parentCheckpointID": "hqhhzikoxunuqguouw",
          "checkpointID": "wsqmrje",
          "name": "keqn",
          "description": "qurzfrgyflrh"
        }
      ],
      "checkpointType": "jkbpzjxpeegackhsvikrnlnwqz",
      "generation": 28,
      "biosGuid": "xixivxifyql"
    },
    "powerState": "dbqyxewvrbqcifpwfvxyllwyaffmvm",
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ExtendedLocation/customLocations/customLocationName"
  },
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineInstances/default",
  "name": "uuqpsdoiyvedvqtrwop",
  "type": "zculorteltpvthtzgnpgdpoe",
  "systemData": {
    "createdBy": "p",
    "createdByType": "User",
    "createdAt": "2024-01-29T22:28:00.094Z",
    "lastModifiedBy": "goxcwpyyqlxndquly",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-01-29T22:28:00.095Z"
  }
}

VirtualMachineInstances_Get_MinimumSet

Exemple de requête

HTTP

GET https://management.azure.com/gtgclehcbsyave/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

Exemple de réponse

Code d’état:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineInstances/default",
  "extendedLocation": {}
}

Définitions

Nom	Description
AllocationMethod	Méthode d’allocation d’adresses réseau.
AvailabilitySetListItem	Modèle de groupe à haute disponibilité
Checkpoint	Définit les propriétés de la ressource.
createdByType	Type d’identité qui a créé la ressource.
CreateDiffDisk	Créez un disque de différences.
DynamicMemoryEnabled	Mémoire dynamique activée.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
ExtendedLocation	Emplacement étendu.
HardwareProfile	Définit les propriétés de la ressource.
InfrastructureProfile	Spécifie les paramètres spécifiques de l’infrastructure vmmServer pour l’instance de machine virtuelle.
IsHighlyAvailable	Hautement disponible.
LimitCpuForMigration	Limitez l’UC pour la migration.
NetworkInterface	Modèle d’interface réseau
NetworkProfile	Définit les propriétés de la ressource.
OsProfileForVmInstance	Définit les propriétés de la ressource.
OsType	Type de système d’exploitation de machine virtuelle.
ProvisioningState	État d’approvisionnement de la ressource.
StorageProfile	Définit les propriétés de la ressource.
StorageQosPolicyDetails	Définition StorageQoSPolicyDetails.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
VirtualDisk	Modèle de disque virtuel
VirtualMachineInstance	Définissez virtualMachineInstance.

AllocationMethod

Méthode d’allocation d’adresses réseau.

Nom	Type	Description
Dynamic	string	Adresse allouée dynamiquement.
Static	string	Adresse allouée statiquement.

AvailabilitySetListItem

Modèle de groupe à haute disponibilité

Nom	Type	Description
id	string	Obtient l’ID ARM de la ressource microsoft.scvmm/availabilitySets.
name	string	Obtient ou définit le nom du groupe à haute disponibilité.

Checkpoint

Définit les propriétés de la ressource.

Nom	Type	Description
checkpointID	string	Obtient l’ID du point de contrôle.
description	string	Obtient la description du point de contrôle.
name	string	Obtient le nom du point de contrôle.
parentCheckpointID	string	Obtient l’ID du parent du point de contrôle.

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CreateDiffDisk

Créez un disque de différences.

Nom	Type	Description
false	string	Désactivez la création d’un disque de différences.
true	string	Activez la création d’un disque de différences.

DynamicMemoryEnabled

Mémoire dynamique activée.

Nom	Type	Description
false	string	Désactivez la mémoire dynamique.
true	string	Activez la mémoire dynamique.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

ExtendedLocation

Emplacement étendu.

Nom	Type	Description
name	string	Nom de l’emplacement étendu.
type	string	Type d’emplacement étendu.

HardwareProfile

Définit les propriétés de la ressource.

Nom	Type	Description
cpuCount	integer	Obtient ou définit le nombre de processeurs virtuels pour la machine virtuelle.
dynamicMemoryEnabled	DynamicMemoryEnabled	Obtient ou définit une valeur indiquant s’il faut activer la mémoire dynamique ou non.
dynamicMemoryMaxMB	integer	Obtient ou définit la mémoire dynamique maximale pour la machine virtuelle.
dynamicMemoryMinMB	integer	Obtient ou définit la mémoire dynamique minimale pour la machine virtuelle.
isHighlyAvailable	IsHighlyAvailable	Obtient une propriété hautement disponible.
limitCpuForMigration	LimitCpuForMigration	Obtient ou définit une valeur indiquant s’il faut activer le mode de compatibilité du processeur pour la migration dynamique des machines virtuelles.
memoryMB	integer	MemoryMB est la taille de la mémoire d’une machine virtuelle, en Mo.

InfrastructureProfile

Spécifie les paramètres spécifiques de l’infrastructure vmmServer pour l’instance de machine virtuelle.

Nom	Type	Description
biosGuid	string	Obtient ou définit le guid du bios de la machine virtuelle.
checkpointType	string	Type de point de contrôle pris en charge pour la machine virtuelle.
checkpoints	Checkpoint[]	Points de contrôle dans la machine virtuelle.
cloudId	string	ID ARM de la ressource cloud à utiliser pour le déploiement de la machine virtuelle.
generation	integer	Obtient ou définit la génération de la machine virtuelle.
inventoryItemId	string	Obtient ou définit l’ID d’élément d’inventaire de la ressource.
lastRestoredVMCheckpoint	Checkpoint	Dernier point de contrôle restauré dans la machine virtuelle.
templateId	string	ID ARM de la ressource de modèle à utiliser pour le déploiement de la machine virtuelle.
uuid	string	ID unique de la machine virtuelle.
vmName	string	VMName est le nom de la machine virtuelle sur le serveur SCVmm.
vmmServerId	string	ID ARM de la ressource vmmServer dans laquelle réside cette ressource.

IsHighlyAvailable

Hautement disponible.

Nom	Type	Description
false	string	Désactivez les fonctionnalités hautement disponibles.
true	string	Activez hautement disponible.

LimitCpuForMigration

Limitez l’UC pour la migration.

Nom	Type	Description
false	string	Désactivez la limite du processeur pour la migration.
true	string	Activez la limite du processeur pour la migration.

NetworkInterface

Modèle d’interface réseau

Nom	Type	Description
displayName	string	Obtient le nom complet de l’interface réseau, comme indiqué dans vmmServer. Il s’agit de l’étiquette de secours d’une carte réseau lorsque le nom n’est pas défini.
ipv4AddressType	AllocationMethod	Obtient ou définit le type d’adresse ipv4.
ipv4Addresses	string[]	Obtient les adresses ipv4 de carte réseau.
ipv6AddressType	AllocationMethod	Obtient ou définit le type d’adresse ipv6.
ipv6Addresses	string[]	Obtient les adresses ipv6 de carte réseau.
macAddress	string	Obtient ou définit l’adresse MAC de carte réseau.
macAddressType	AllocationMethod	Obtient ou définit le type d’adresse mac.
name	string	Obtient ou définit le nom de l’interface réseau.
networkName	string	Obtient le nom du réseau virtuel dans vmmServer auquel la carte réseau est connectée.
nicId	string	Obtient ou définit l’ID de carte réseau.
virtualNetworkId	string	Obtient ou définit l’ID ARM de la ressource Microsoft.ScVmm/virtualNetwork pour connecter la carte réseau.

NetworkProfile

Définit les propriétés de la ressource.

Nom	Type	Description
networkInterfaces	NetworkInterface[]	Obtient ou définit la liste des interfaces réseau associées à la machine virtuelle.

OsProfileForVmInstance

Définit les propriétés de la ressource.

Nom	Type	Description
adminPassword	string	Mot de passe administrateur de la machine virtuelle.
computerName	string	Obtient ou définit le nom de l’ordinateur.
domainName	string	Obtient ou définit le nom de domaine.
domainPassword	string	Mot de passe du domaine auquel la machine virtuelle doit se joindre.
domainUsername	string	Obtient ou définit le nom d’utilisateur du domaine.
osSku	string	Obtient la référence sku du système d’exploitation.
osType	OsType	Obtient le type du système d’exploitation.
osVersion	string	Obtient la version du système d’exploitation.
productKey	string	Obtient ou définit la clé de produit. Format d’entrée xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
runOnceCommands	string	Obtient ou définit les commandes à exécuter une seule fois au moment de la création séparée par des points-virgules.
timezone	integer	Obtient ou définit la valeur d’index du fuseau horaire.
workgroup	string	Obtient ou définit le groupe de travail.

OsType

Type de système d’exploitation de machine virtuelle.

Nom	Type	Description
Linux	string	Système d’exploitation Linux.
Other	string	Autre système d’exploitation.
Windows	string	Système d’exploitation Windows.

ProvisioningState

État d’approvisionnement de la ressource.

Nom	Type	Description
Accepted	string	La ressource a été acceptée.
Canceled	string	La création de ressources a été annulée.
Created	string	La ressource a été créée.
Deleting	string	La ressource est en cours de suppression.
Failed	string	Échec de la création de ressources.
Provisioning	string	La ressource est en cours d’approvisionnement.
Succeeded	string	La ressource a été créée.
Updating	string	La ressource est mise à jour.

StorageProfile

Définit les propriétés de la ressource.

Nom	Type	Description
disks	VirtualDisk[]	Obtient ou définit la liste des disques virtuels associés à la machine virtuelle.

StorageQosPolicyDetails

Définition StorageQoSPolicyDetails.

Nom	Type	Description
id	string	ID de la stratégie QoS.
name	string	Nom de la stratégie.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

VirtualDisk

Modèle de disque virtuel

Nom	Type	Description
bus	integer	Obtient ou définit le bus de disque.
busType	string	Obtient ou définit le type de bus de disque.
createDiffDisk	CreateDiffDisk	Obtient ou définit une valeur indiquant le disque de différences.
diskId	string	Obtient ou définit l’ID de disque.
diskSizeGB	integer	Obtient ou définit la taille totale du disque.
displayName	string	Obtient le nom complet du disque virtuel, comme indiqué dans vmmServer. Il s’agit de l’étiquette de secours d’un disque lorsque le nom n’est pas défini.
lun	integer	Obtient ou définit le lun de disque.
maxDiskSizeGB	integer	Obtient la taille maximale du disque.
name	string	Obtient ou définit le nom du disque.
storageQoSPolicy	StorageQosPolicyDetails	Stratégie QoS pour le disque.
templateDiskId	string	Obtient ou définit l’ID de disque dans le modèle.
vhdFormatType	string	Obtient le type de format de disque dur virtuel.
vhdType	string	Obtient ou définit le type de disque dur virtuel.
volumeType	string	Obtient le type de volume de disque.

VirtualMachineInstance

Définissez virtualMachineInstance.

Nom	Type	Description
extendedLocation	ExtendedLocation	Obtient ou définit l’emplacement étendu.
id	string	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name	string	Nom de la ressource
properties.availabilitySets	AvailabilitySetListItem[]	Groupes à haute disponibilité dans la machine virtuelle.
properties.hardwareProfile	HardwareProfile	Propriétés matérielles.
properties.infrastructureProfile	InfrastructureProfile	Obtient le profil d’infrastructure.
properties.networkProfile	NetworkProfile	Propriétés réseau.
properties.osProfile	OsProfileForVmInstance	Propriétés du système d’exploitation.
properties.powerState	string	Obtient l’état d’alimentation de la machine virtuelle.
properties.provisioningState	ProvisioningState	État d’approvisionnement de la ressource.
properties.storageProfile	StorageProfile	Propriétés de stockage.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

Partager via

Virtual Machine Instances - Get

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

VirtualMachineInstances_Get_MaximumSet

Exemple de requête

Exemple de réponse

VirtualMachineInstances_Get_MinimumSet

Exemple de requête

Exemple de réponse

Définitions

AllocationMethod

AvailabilitySetListItem

Checkpoint

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

HardwareProfile

InfrastructureProfile

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

NetworkProfile

OsProfileForVmInstance

OsType

ProvisioningState

StorageProfile

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineInstance

Ressources supplémentaires