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-03-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 |
Un é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 pour 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 |
Ok |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
Virtual |
Virtual |
VirtualMachineImage_Get_MaximumSet_Gen
Sample Request
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-03-01
Sample Response
{
"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
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaaaaaaaa/publishers/aaaaaaaaaaa/artifacttypes/vmimage/offers/aa/skus/aaaaaaaaa/versions/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01
Sample Response
{
"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épréciée. |
Alternative |
Décrit le type de l’autre option. |
Api |
Erreur d’API. |
Api |
Base d’erreurs de l’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 des 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 la dépréciation de l’image status propriétés sur l’image. |
Image |
Décrit l’état de l’image. |
Inner |
Détails internes de l’erreur. |
Operating |
Système d’exploitation de l’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 les fonctionnalités supplémentaires prises en charge par l’image |
Vm |
Types de disques de machine virtuelle qui ne sont pas autorisés. |
AlternativeOption
Décrit l’option alternative spécifiée par le serveur de publication pour cette image lorsque cette image est dépréciée.
Nom | Type | Description |
---|---|---|
type |
Décrit le type de l’autre option. |
|
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 du nom du plan lorsque le type est Plan. |
AlternativeType
Décrit le type de l’autre option.
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 de l’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 des 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 qui ne sont pas 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 la dépréciation de l’image status propriétés 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épréciée. |
|
imageState |
Décrit l’état de l’image. |
|
scheduledDeprecationTime |
string |
Heure, à l’avenir, à laquelle cette image sera marquée comme déprécié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 internes de l’erreur.
Nom | Type | Description |
---|---|---|
errordetail |
string |
Message d’erreur interne ou vidage d’exception. |
exceptiontype |
string |
Type d'exception. |
OperatingSystemTypes
Système d’exploitation de l’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 l’osDiskImage. |
PurchasePlan
Utilisé pour établir le contexte d’achat d’un artefact tiers via MarketPlace.
Nom | Type | Description |
---|---|---|
name |
string |
ID de plan. |
product |
string |
Spécifie le produit de l’image 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 des 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 les fonctionnalités supplémentaires prises en charge par l’image |
|
properties.hyperVGeneration |
Spécifie le type HyperVGeneration |
|
properties.imageDeprecationStatus |
Décrit la dépréciation de l’image status propriétés 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 des balises, consultez Utilisation de balises pour organiser vos ressources Azure. |
VirtualMachineImageFeature
Spécifie les fonctionnalités supplémentaires prises en charge par l’image
Nom | Type | Description |
---|---|---|
name |
string |
Nom de la fonctionnalité. |
value |
string |
Valeur correspondante pour la fonctionnalité. |
VmDiskTypes
Types de disques de machine virtuelle qui ne sont pas autorisés.
Nom | Type | Description |
---|---|---|
None |
string |
|
Unmanaged |
string |