Hitta Azure Marketplace-avbildningsinformation med hjälp av Azure CLI
Varning
Den här artikeln refererar till CentOS, en Linux-distribution som har statusen End Of Life (EOL). Överväg att använda och planera i enlighet med detta. Mer information finns i CentOS End Of Life-vägledningen.
Gäller för: ✔️ Virtuella Linux-datorer ✔️ med virtuella Windows-datorer ✔️ – flexibla skalningsuppsättningar
Det här avsnittet beskriver hur du använder Azure CLI för att hitta VM-avbildningar på Azure Marketplace. Använd den här informationen om du vill ange en Marketplace-avbildning när du skapar en virtuell dator programmatiskt med CLI, Resource Manager-mallar eller andra verktyg.
Du kan också bläddra bland tillgängliga bilder och erbjudanden med hjälp av Azure Marketplace eller Azure PowerShell.
Terminologi
En Marketplace-avbildning i Azure har följande attribut:
- Utgivare: Den organisation som skapade avbildningen. Exempel: Canonical, RedHat, SUSE.
- Erbjudande: Namnet på en grupp relaterade bilder som skapats av en utgivare. Exempel: 0001-com-ubuntu-server-jammy, RHEL, sles-15-sp3.
- SKU: En instans av ett erbjudande, till exempel en större distributionsversion. Exempel: 22_04-lts-gen2, 8-lvm-gen2, gen2.
- Version: Versionsnumret för en avbildnings-SKU.
Dessa värden kan skickas individuellt eller som en avbildnings-URN och kombinera värdena avgränsade med kolonet (:). Exempel: Publisher:Offer:Sku:Version. Du kan ersätta versionsnumret i URN med latest för att använda den senaste versionen av avbildningen.
Om bildutgivaren tillhandahåller extra licens- och köpvillkor måste du godkänna dessa villkor innan du kan använda avbildningen. Mer information finns i Kontrollera köpplansinformationen.
Visa en lista över populära bilder
Du kan köra az vm image list - all för att se alla avbildningar som är tillgängliga för dig, men det kan ta flera minuter att skapa hela listan. Ett snabbare alternativ är att använda az vm image list, utan --all alternativet, för att se en lista över populära VM-avbildningar på Azure Marketplace. Kör till exempel följande kommando för att visa en cachelagrad lista över populära bilder i tabellformat:
az vm image list --output table
Utdata innehåller bild-URN. Om du utelämnar alternativet --all kan du se UrnAlias för varje bild, om det är tillgängligt. UrnAlias är en förkortad version som skapats för populära bilder som Ubuntu2204.
Namn på Linux-avbildningsalias och deras information som matas ut av det här kommandot är:
Architecture Offer Publisher Sku Urn UrnAlias Version
-------------- ---------------------------- ---------------------- ---------------------------------- ------------------------------------------------------------------------------ ----------------------- ---------
x64 CentOS OpenLogic 8_5-gen2 OpenLogic:CentOS:8_5-gen2:latest CentOS85Gen2 latest
x64 Debian11 Debian 11-backports-gen2 Debian:debian-11:11-backports-gen2:latest Debian-11 latest
x64 flatcar-container-linux-free kinvolk stable-gen2 kinvolk:flatcar-container-linux-free:stable-gen2:latest FlatcarLinuxFreeGen2 latest
x64 opensuse-leap-15-4 SUSE gen2 SUSE:opensuse-leap-15-4:gen2:latest OpenSuseLeap154Gen2 latest
x64 RHEL RedHat 8-lvm-gen2 RedHat:RHEL:8-lvm-gen2:latest RHELRaw8LVMGen2 latest
x64 sles-15-sp3 SUSE gen2 SUSE:sles-15-sp3:gen2:latest SLES latest
x64 0001-com-ubuntu-server-jammy Canonical 22_04-lts-gen2 Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest Ubuntu2204 latest
Windows-avbildningens aliasnamn och deras information som matas ut av det här kommandot är:
Architecture Offer Publisher Sku Urn Alias Version
-------------- ---------------------------- ---------------------- ---------------------------------- ------------------------------------------------------------------------------ ----------------------- ---------
x64 WindowsServer MicrosoftWindowsServer 2022-datacenter-azure-edition MicrosoftWindowsServer:WindowsServer:2022-datacenter-azure-edition:latest Win2022AzureEdition latest
x64 WindowsServer MicrosoftWindowsServer 2022-datacenter-azure-edition-core MicrosoftWindowsServer:WindowsServer:2022-datacenter-azure-edition-core:latest Win2022AzureEditionCore latest
x64 WindowsServer MicrosoftWindowsServer 2019-Datacenter MicrosoftWindowsServer:WindowsServer:2019-Datacenter:latest Win2019Datacenter latest
x64 WindowsServer MicrosoftWindowsServer 2016-Datacenter MicrosoftWindowsServer:WindowsServer:2016-Datacenter:latest Win2016Datacenter latest
x64 WindowsServer MicrosoftWindowsServer 2012-R2-Datacenter MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest Win2012R2Datacenter latest
x64 WindowsServer MicrosoftWindowsServer 2012-Datacenter MicrosoftWindowsServer:WindowsServer:2012-Datacenter:latest Win2012Datacenter latest
Söka efter specifika avbildningar
Du kan filtrera listan med bilder efter --publisher eller en annan parameter för att begränsa resultatet.
Följande kommando visar till exempel alla Debian-erbjudanden:
az vm image list --offer Debian --all --output table
Du kan begränsa dina resultat till en enda arkitektur genom att lägga till parametern --architecture . Om du till exempel vill visa alla Arm64-bilder som är tillgängliga från Canonical:
az vm image list --architecture Arm64 --publisher Canonical --all --output table
Titta på alla tillgängliga bilder
Ett annat sätt att hitta en avbildning på en plats är att köra az vm image list-publishers, az vm image list-offers och az vm image list-skus commands in sequence. Med dessa kommandon bestämmer du följande värden:
Visa en lista över avbildningsutfärdare för en plats. I det här exemplet tittar vi på regionen USA , västra.
az vm image list-publishers --location westus --output tableVisa en lista över erbjudanden från en viss utgivare. I det här exemplet lägger vi till RedHat som utgivare.
az vm image list-offers --location westus --publisher RedHat --output tableVisa en lista över SKU:er för ett visst erbjudande. I det här exemplet lägger vi till RHEL som erbjudande.
az vm image list-skus --location westus --publisher RedHat --offer RHEL --output table
Kommentar
Canonical har ändrat de erbjudandenamn som de använder för de senaste versionerna. Före Ubuntu 20.04 är erbjudandenamnet UbuntuServer. För Ubuntu 20.04 är 0001-com-ubuntu-server-focal erbjudandenamnet och för Ubuntu 22.04 är 0001-com-ubuntu-server-jammydet .
För en viss utgivare, erbjudande och SKU visar du alla versioner av avbildningen. I det här exemplet lägger vi till 9_1 som SKU.
az vm image list \ --location westus \ --publisher RedHat \ --offer RHEL \ --sku 9_1 \ --all --output table
Skicka det här värdet för KOLUMNEN URN med parametern --image när du skapar en virtuell dator med kommandot az vm create . Du kan också ersätta versionsnumret i URN med "senaste" för att använda den senaste versionen av avbildningen.
Om du distribuerar en virtuell dator med en Resource Manager-mall anger du avbildningsparametrarna individuellt i imageReference egenskaperna. Se mallreferensen.
Kontrollera köpplansinformationen
Vissa VM-avbildningar på Azure Marketplace har extra licens- och inköpsvillkor som du måste godkänna innan du kan distribuera dem programmatiskt.
Om du vill distribuera en virtuell dator från en sådan avbildning måste du godkänna avbildningens villkor första gången du använder den, en gång per prenumeration. Du måste också ange köpplansparametrar för att distribuera en virtuell dator från avbildningen
Om du vill visa en bilds köpplansinformation kör du kommandot az vm image show med URN för avbildningen. Om egenskapen plan i utdata inte nullär har avbildningen villkor som du måste acceptera före programmatisk distribution.
Till exempel har den kanoniska Ubuntu Server 18.04 LTS-avbildningen plan inte extra villkor, eftersom informationen är null:
az vm image show --location westus --urn Canonical:UbuntuServer:18.04-LTS:latest
Utdata:
{
"dataDiskImages": [],
"id": "/Subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Providers/Microsoft.Compute/Locations/westus/Publishers/Canonical/ArtifactTypes/VMImage/Offers/UbuntuServer/Skus/18.04-LTS/Versions/18.04.201901220",
"location": "westus",
"name": "18.04.201901220",
"osDiskImage": {
"operatingSystem": "Linux"
},
"plan": null,
"tags": null
}
Om du kör ett liknande kommando för RabbitMQ Certified by Bitnami-avbildningen visas följande plan egenskaper: name, productoch publisher. (Vissa bilder har också en promotion code egenskap.)
az vm image show --location westus --urn bitnami:rabbitmq:rabbitmq:latest
Utdata:
{
"dataDiskImages": [],
"id": "/Subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Providers/Microsoft.Compute/Locations/westus/Publishers/bitnami/ArtifactTypes/VMImage/Offers/rabbitmq/Skus/rabbitmq/Versions/3.7.1901151016",
"location": "westus",
"name": "3.7.1901151016",
"osDiskImage": {
"operatingSystem": "Linux"
},
"plan": {
"name": "rabbitmq",
"product": "rabbitmq",
"publisher": "bitnami"
},
"tags": null
}
För att distribuera den här avbildningen måste du godkänna villkoren och ange parametrarna för inköpsplanen när du distribuerar en virtuell dator med den avbildningen.
Acceptera villkoren
Om du vill visa och acceptera licensvillkoren använder du kommandot az vm image terms . När du godkänner villkoren aktiverar du programmatisk distribution i din prenumeration. Du behöver bara acceptera villkor en gång per prenumeration för avbildningen. Till exempel:
az vm image terms show --urn bitnami:rabbitmq:rabbitmq:latest
Utdata innehåller en licenseTextLink till licensvillkoren och anger att värdet accepted för är true:
{
"accepted": true,
"additionalProperties": {},
"id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.MarketplaceOrdering/offertypes/bitnami/offers/rabbitmq/plans/rabbitmq",
"licenseTextLink": "https://storelegalterms.blob.core.windows.net/legalterms/3E5ED_legalterms_BITNAMI%253a24RABBITMQ%253a24RABBITMQ%253a24IGRT7HHPIFOBV3IQYJHEN2O2FGUVXXZ3WUYIMEIVF3KCUNJ7GTVXNNM23I567GBMNDWRFOY4WXJPN5PUYXNKB2QLAKCHP4IE5GO3B2I.txt",
"name": "rabbitmq",
"plan": "rabbitmq",
"privacyPolicyLink": "https://bitnami.com/privacy",
"product": "rabbitmq",
"publisher": "bitnami",
"retrieveDatetime": "2019-01-25T20:37:49.937096Z",
"signature": "XXXXXXLAZIK7ZL2YRV5JYQXONPV76NQJW3FKMKDZYCRGXZYVDGX6BVY45JO3BXVMNA2COBOEYG2NO76ONORU7ITTRHGZDYNJNXXXXXX",
"type": "Microsoft.MarketplaceOrdering/offertypes"
}
Om du vill acceptera villkoren skriver du:
az vm image terms accept --urn bitnami:rabbitmq:rabbitmq:latest
Distribuera en ny virtuell dator med avbildningsparametrarna
Med information om avbildningen kan du distribuera den med hjälp av az vm create kommandot .
Om du vill distribuera en avbildning som inte har planinformation, som den senaste Ubuntu Server 18.04-avbildningen från Canonical, skickar du URN för --image:
az group create --name myURNVM --location westus
az vm create \
--resource-group myURNVM \
--name myVM \
--admin-username azureuser \
--generate-ssh-keys \
--image Canonical:UbuntuServer:18.04-LTS:latest
För en avbildning med köpplansparametrar, till exempel RabbitMQ Certified by Bitnami-avbildningen, skickar du URN för och anger även parametrarna för --image inköpsplanen:
az group create --name myPurchasePlanRG --location westus
az vm create \
--resource-group myPurchasePlanRG \
--name myVM \
--admin-username azureuser \
--generate-ssh-keys \
--image bitnami:rabbitmq:rabbitmq:latest \
--plan-name rabbitmq \
--plan-product rabbitmq \
--plan-publisher bitnami
Om du får ett meddelande om att acceptera villkoren för avbildningen läser du avsnittet Acceptera villkoren. Kontrollera att utdata az vm image accept-terms från returnerar värdet "accepted": true, som visar att du har accepterat villkoren för bilden.
Använda en befintlig virtuell hårddisk med köpplansinformation
Om du har en befintlig virtuell hårddisk från en virtuell dator som skapades med en betald Azure Marketplace-avbildning kan du behöva ge inköpsplansinformationen när du skapar en ny virtuell dator från den virtuella hårddisken.
Om du fortfarande har den ursprungliga virtuella datorn eller en annan virtuell dator som skapats med samma marketplace-avbildning kan du hämta plannamnet, utgivaren och produktinformationen från den med hjälp av az vm get-instance-view. Det här exemplet hämtar en virtuell dator med namnet myVM i resursgruppen myResourceGroup och visar sedan köpplansinformationen.
az vm get-instance-view -g myResourceGroup -n myVM --query plan
Om du inte fick planinformationen innan den ursprungliga virtuella datorn togs bort kan du skicka en supportbegäran. De behöver vm-namnet, prenumerations-ID:t och tidsstämpeln för borttagningsåtgärden.
När du har planinformationen kan du skapa den nya virtuella datorn med hjälp av parametern --attach-os-disk för att ange den virtuella hårddisken.
az vm create \
--resource-group myResourceGroup \
--name myNewVM \
--nics myNic \
--size Standard_DS1_v2 --os-type Linux \
--attach-os-disk myVHD \
--plan-name planName \
--plan-publisher planPublisher \
--plan-product planProduct
Nästa steg
Information om hur du snabbt skapar en virtuell dator med hjälp av avbildningsinformationen finns i Skapa och hantera virtuella Linux-datorer med Azure CLI.