Virtual Machine Images - Get
Obtient une image de machine virtuelle.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/publishers/{publisherName}/artifacttypes/vmimage/offers/{offer}/skus/{skus}/versions/{version}?api-version=2024-07-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
location
|
path | True |
string |
Nom d’une région Azure prise en charge. |
offer
|
path | True |
string |
Offre d’éditeur d’images valide. |
publisher
|
path | True |
string |
Éditeur d’images valide. |
skus
|
path | True |
string |
Référence SKU d’image valide. |
subscription
|
path | True |
string |
Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service. |
version
|
path | True |
string |
Version de référence SKU d’image valide. |
api-version
|
query | True |
string |
Version de l’API cliente. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
D’ACCORD |
|
Other Status Codes |
Réponse d’erreur décrivant pourquoi l’opération a échoué. |
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
Virtual |
Virtual |
VirtualMachineImage_Get_MaximumSet_Gen
Exemple de requête
GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaa/publishers/aaa/artifacttypes/vmimage/offers/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/skus/aaaaaaaaaaaaaaaaaaaaaaaaaaa/versions/aaaaaaaaaaaaaaaaaaa?api-version=2024-07-01
Exemple de réponse
{
"properties": {
"plan": {
"publisher": "aaaaaaaaaaaaaaaaaaa",
"name": "aaaaaaaaa",
"product": "aaaaaaaaaaaaaa"
},
"osDiskImage": {
"operatingSystem": "Windows"
},
"dataDiskImages": [
{
"lun": 17
}
],
"automaticOSUpgradeProperties": {
"automaticOSUpgradeSupported": true
},
"hyperVGeneration": "V1",
"disallowed": {
"vmDiskType": "None"
},
"features": [
{
"name": "aaaaaaaaaaaaaaaaaaaaa",
"value": "aaaaaaaaaaaaaaaaaaaa"
}
],
"imageDeprecationStatus": {
"imageState": "ScheduledForDeprecation",
"scheduledDeprecationTime": "2023-01-13T00:00:00+00:00",
"alternativeOption": {
"type": "Offer",
"value": "aaaaaaa"
}
}
},
"name": "aaaaaaaaa",
"location": "aaaaa",
"tags": {
"key6817": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
},
"extendedLocation": {
"name": "aaaaaaaaaaaaaaaaaaaaa",
"type": "EdgeZone"
},
"id": "aaaaaaaaaaa"
}
VirtualMachineImage_Get_MinimumSet_Gen
Exemple de requête
Exemple de réponse
{
"name": "aaaaaaaaa",
"location": "aaaaa",
"id": "aaaaaaaaaaa"
}
Définitions
Nom | Description |
---|---|
Alternative |
Décrit l’option alternative spécifiée par le serveur de publication pour cette image lorsque cette image est déconseillée. |
Alternative |
Décrit le type de l’option alternative. |
Api |
Erreur d’API. |
Api |
Base d’erreurs d’API. |
Architecture |
Spécifie le type d’architecture |
Automatic |
Décrit les propriétés de mise à niveau automatique du système d’exploitation sur l’image. |
Cloud |
Réponse d’erreur du service de calcul. |
Data |
Contient les informations sur les images de disque de données. |
Disallowed |
Spécifie la configuration non autorisée pour une image de machine virtuelle. |
Extended |
Type complexe de l’emplacement étendu. |
Extended |
Type de l’emplacement étendu. |
Hyper |
Spécifie le type HyperVGeneration |
Image |
Décrit les propriétés d’état de dépréciation de l’image sur l’image. |
Image |
Décrit l’état de l’image. |
Inner |
Détails de l’erreur interne. |
Operating |
Système d’exploitation de osDiskImage. |
OSDisk |
Contient les informations d’image de disque du système d’exploitation. |
Purchase |
Utilisé pour établir le contexte d’achat d’un artefact tiers via MarketPlace. |
Virtual |
Décrit une image de machine virtuelle. |
Virtual |
Spécifie des fonctionnalités supplémentaires prises en charge par l’image |
Vm |
Types de disques de machine virtuelle non autorisés. |
AlternativeOption
Décrit l’option alternative spécifiée par le serveur de publication pour cette image lorsque cette image est déconseillée.
Nom | Type | Description |
---|---|---|
type |
Décrit le type de l’option alternative. |
|
value |
string |
Indique la valeur d’option alternative spécifiée par le serveur de publication. Il s’agit du nom de l’offre lorsque le type est Offre ou le nom du plan lorsque le type est Plan. |
AlternativeType
Décrit le type de l’option alternative.
Nom | Type | Description |
---|---|---|
None |
string |
|
Offer |
string |
|
Plan |
string |
ApiError
Erreur d’API.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur. |
details |
Détails de l’erreur api |
|
innererror |
Erreur interne de l’API |
|
message |
string |
Message d’erreur. |
target |
string |
Cible de l’erreur particulière. |
ApiErrorBase
Base d’erreurs d’API.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur. |
message |
string |
Message d’erreur. |
target |
string |
Cible de l’erreur particulière. |
ArchitectureTypes
Spécifie le type d’architecture
Nom | Type | Description |
---|---|---|
Arm64 |
string |
|
x64 |
string |
AutomaticOSUpgradeProperties
Décrit les propriétés de mise à niveau automatique du système d’exploitation sur l’image.
Nom | Type | Description |
---|---|---|
automaticOSUpgradeSupported |
boolean |
Spécifie si la mise à niveau automatique du système d’exploitation est prise en charge sur l’image. |
CloudError
Réponse d’erreur du service de calcul.
Nom | Type | Description |
---|---|---|
error |
Erreur d’API. |
DataDiskImage
Contient les informations sur les images de disque de données.
Nom | Type | Description |
---|---|---|
lun |
integer |
Spécifie le numéro d’unité logique du disque de données. Cette valeur est utilisée pour identifier les disques de données au sein de la machine virtuelle et doit donc être unique pour chaque disque de données attaché à une machine virtuelle. |
DisallowedConfiguration
Spécifie la configuration non autorisée pour une image de machine virtuelle.
Nom | Type | Description |
---|---|---|
vmDiskType |
Types de disques de machine virtuelle non autorisés. |
ExtendedLocation
Type complexe de l’emplacement étendu.
Nom | Type | Description |
---|---|---|
name |
string |
Nom de l’emplacement étendu. |
type |
Type de l’emplacement étendu. |
ExtendedLocationTypes
Type de l’emplacement étendu.
Nom | Type | Description |
---|---|---|
EdgeZone |
string |
HyperVGenerationTypes
Spécifie le type HyperVGeneration
Nom | Type | Description |
---|---|---|
V1 |
string |
|
V2 |
string |
ImageDeprecationStatus
Décrit les propriétés d’état de dépréciation de l’image sur l’image.
Nom | Type | Description |
---|---|---|
alternativeOption |
Décrit l’option alternative spécifiée par le serveur de publication pour cette image lorsque cette image est déconseillée. |
|
imageState |
Décrit l’état de l’image. |
|
scheduledDeprecationTime |
string |
L’heure, à l’avenir, à laquelle cette image sera marquée comme déconseillée. Cette heure planifiée est choisie par le serveur de publication. |
ImageState
Décrit l’état de l’image.
Nom | Type | Description |
---|---|---|
Active |
string |
|
Deprecated |
string |
|
ScheduledForDeprecation |
string |
InnerError
Détails de l’erreur interne.
Nom | Type | Description |
---|---|---|
errordetail |
string |
Message d’erreur interne ou vidage d’exception. |
exceptiontype |
string |
Type d’exception. |
OperatingSystemTypes
Système d’exploitation de osDiskImage.
Nom | Type | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
OSDiskImage
Contient les informations d’image de disque du système d’exploitation.
Nom | Type | Description |
---|---|---|
operatingSystem |
Système d’exploitation de osDiskImage. |
PurchasePlan
Utilisé pour établir le contexte d’achat d’un artefact tiers via MarketPlace.
Nom | Type | Description |
---|---|---|
name |
string |
ID du plan. |
product |
string |
Spécifie le produit de l’image à partir de la Place de marché. Il s’agit de la même valeur que Offer sous l’élément imageReference. |
publisher |
string |
ID de l’éditeur. |
VirtualMachineImage
Décrit une image de machine virtuelle.
Nom | Type | Description |
---|---|---|
extendedLocation |
Emplacement étendu de la machine virtuelle. |
|
id |
string |
ID de ressource |
location |
string |
Emplacement Azure pris en charge de la ressource. |
name |
string |
Nom de la ressource. |
properties.architecture |
Spécifie le type d’architecture |
|
properties.automaticOSUpgradeProperties |
Décrit les propriétés de mise à niveau automatique du système d’exploitation sur l’image. |
|
properties.dataDiskImages |
Contient les informations sur les images de disque de données. |
|
properties.disallowed |
Spécifie la configuration non autorisée pour virtualMachine créée à partir de l’image |
|
properties.features |
Spécifie des fonctionnalités supplémentaires prises en charge par l’image |
|
properties.hyperVGeneration |
Spécifie le type HyperVGeneration |
|
properties.imageDeprecationStatus |
Décrit les propriétés d’état de dépréciation de l’image sur l’image. |
|
properties.osDiskImage |
Contient les informations d’image de disque du système d’exploitation. |
|
properties.plan |
Utilisé pour établir le contexte d’achat d’un artefact tiers via MarketPlace. |
|
tags |
object |
Spécifie les balises affectées à la machine virtuelle. Pour plus d’informations sur l’utilisation de balises, consultez Utilisation de balises pour organiser vos ressources Azure. |
VirtualMachineImageFeature
Spécifie des fonctionnalités supplémentaires prises en charge par l’image
Nom | Type | Description |
---|---|---|
name |
string |
Nom de la fonctionnalité. |
value |
string |
Valeur correspondante de la fonctionnalité. |
VmDiskTypes
Types de disques de machine virtuelle non autorisés.
Nom | Type | Description |
---|---|---|
None |
string |
|
Unmanaged |
string |