Galerie/obrazy Microsoft.Compute
Artykuł 12/21/2024
Współautorzy: 2
Opinia
W tym artykule
Definicja zasobu Bicep
Typ zasobu galerii/obrazów można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian .
Aby utworzyć zasób Microsoft.Compute/gallerys/images, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.Compute/galleries/images@2024-03-03' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
properties: {
allowUpdateImage: bool
architecture: 'string'
description: 'string'
disallowed: {
diskTypes: [
'string'
]
}
endOfLifeDate: 'string'
eula: 'string'
features: [
{
name: 'string'
startsAtVersion: 'string'
value: 'string'
}
]
hyperVGeneration: 'string'
identifier: {
offer: 'string'
publisher: 'string'
sku: 'string'
}
osState: 'string'
osType: 'string'
privacyStatementUri: 'string'
purchasePlan: {
name: 'string'
product: 'string'
publisher: 'string'
}
recommended: {
memory: {
max: int
min: int
}
vCPUs: {
max: int
min: int
}
}
releaseNoteUri: 'string'
}
tags: {
{customized property}: 'string'
}
}
Wartości właściwości
Niedozwolone
Nazwa
Opis
Wartość
diskTypes
Lista typów dysków.
string[]
GalleryImageFeature
Nazwa
Opis
Wartość
nazwa
Nazwa funkcji obrazu galerii.
struna
startsAtVersion
Minimalna wersja obrazu galerii, która obsługuje tę funkcję.
struna
wartość
Wartość funkcji obrazu galerii.
struna
GalleryImageIdentifier
Nazwa
Opis
Wartość
oferta
Nazwa oferty definicji obrazu galerii.
ciąg (wymagany)
wydawca
Nazwa wydawcy definicji obrazu galerii.
ciąg (wymagany)
Numer jednostki magazynowej
Nazwa jednostki SKU definicji obrazu galerii.
ciąg (wymagany)
GalleryImageProperties
Nazwa
Opis
Wartość
allowUpdateImage
Fakultatywny. Należy ustawić wartość true, jeśli funkcje obrazu galerii są aktualizowane.
bool
architektura
Architektura obrazu. Dotyczy tylko dysków systemu operacyjnego.
"Arm64" "x64"
opis
Opis tego zasobu definicji obrazu galerii. Ta właściwość jest aktualizowalna.
struna
Niedozwolone
Opisuje niedozwolone typy dysków.
niedozwolone
endOfLifeDate
Data zakończenia życia definicji obrazu galerii. Tej właściwości można używać do celów likwidowania. Ta właściwość jest aktualizowalna.
struna
Eula
Umowa Licencyjna dotycząca definicji obrazu galerii.
struna
Funkcje
Lista funkcji obrazów galerii.
GalleryImageFeature []
hyperVGeneration
Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.
"V1" "V2"
identyfikator
Jest to identyfikator definicji obrazu galerii.
GalleryImageIdentifier (wymagane)
osState
Ta właściwość umożliwia użytkownikowi określenie, czy maszyny wirtualne utworzone na tym obrazie są "Uogólnione" lub "Wyspecjalizowane".
"Uogólnione" "Wyspecjalizowane" (wymagane)
osType
Ta właściwość umożliwia określenie typu systemu operacyjnego dołączonego do dysku podczas tworzenia maszyny wirtualnej na podstawie obrazu zarządzanego. Możliwe wartości to: Windows, Linux.
"Linux" "Windows" (wymagane)
privacyStatementUri
Identyfikator URI oświadczenia o ochronie prywatności.
struna
purchasePlan
Opisuje plan zakupu definicji obrazu galerii. Jest to używane przez obrazy z witryny Marketplace.
ImagePurchasePlan
Zalecane
Właściwości opisują zalecaną konfigurację maszyny dla tej definicji obrazu. Te właściwości są możliwe do zaktualizowania.
RecommendedMachineConfiguration
releaseNoteUri
Identyfikator URI notatki o wersji.
struna
ImagePurchasePlan
Nazwa
Opis
Wartość
nazwa
Identyfikator planu.
struna
produkt
Identyfikator produktu.
struna
wydawca
Identyfikator wydawcy.
struna
Microsoft.Compute/gallerys/images
Nazwa
Opis
Wartość
lokalizacja
Lokalizacja zasobu
ciąg (wymagany)
nazwa
Nazwa zasobu
ciąg (wymagany)
rodzic
W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym. Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym .
Nazwa symboliczna zasobu typu: galerie
Właściwości
Opisuje właściwości definicji obrazu galerii.
GalleryImageProperties
Tagi
Tagi zasobów
Słownik nazw tagów i wartości. Zobacz tagi w szablonach
Zalecana konfiguracjamachine
ResourceRange
Nazwa
Opis
Wartość
Max
Maksymalna liczba zasobów.
Int
Min
Minimalna liczba zasobów.
Int
Przykłady z przewodnika Szybki start
W poniższych przykładach szybkiego startu wdrożono ten typ zasobu.
Plik Bicep
Opis
Azure Image Builder z programem Azure Windows Baseline
Tworzy środowisko narzędzia Azure Image Builder i tworzy obraz systemu Windows Server z zastosowanymi najnowszymi aktualizacjami systemu Windows i punktem odniesienia platformy Azure.
Konfigurowanie usługi Dev Box
Ten szablon umożliwia utworzenie wszystkich zasobów administracyjnych usługi Dev Box zgodnie z przewodnikiem Szybki start dotyczącym usługi Dev Box (/azure/dev-box/quickstart-create-dev-box). Możesz wyświetlić wszystkie utworzone zasoby lub bezpośrednio przejść do DevPortal.microsoft.com, aby utworzyć pierwsze rozwiązanie Dev Box.
Definicja zasobu szablonu usługi ARM
Typ zasobu galerii/obrazów można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian .
Aby utworzyć zasób Microsoft.Compute/gallerys/images, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.Compute/galleries/images",
"apiVersion": "2024-03-03",
"name": "string",
"location": "string",
"properties": {
"allowUpdateImage": "bool",
"architecture": "string",
"description": "string",
"disallowed": {
"diskTypes": [ "string" ]
},
"endOfLifeDate": "string",
"eula": "string",
"features": [
{
"name": "string",
"startsAtVersion": "string",
"value": "string"
}
],
"hyperVGeneration": "string",
"identifier": {
"offer": "string",
"publisher": "string",
"sku": "string"
},
"osState": "string",
"osType": "string",
"privacyStatementUri": "string",
"purchasePlan": {
"name": "string",
"product": "string",
"publisher": "string"
},
"recommended": {
"memory": {
"max": "int",
"min": "int"
},
"vCPUs": {
"max": "int",
"min": "int"
}
},
"releaseNoteUri": "string"
},
"tags": {
"{customized property}": "string"
}
}
Wartości właściwości
Niedozwolone
Nazwa
Opis
Wartość
diskTypes
Lista typów dysków.
string[]
GalleryImageFeature
Nazwa
Opis
Wartość
nazwa
Nazwa funkcji obrazu galerii.
struna
startsAtVersion
Minimalna wersja obrazu galerii, która obsługuje tę funkcję.
struna
wartość
Wartość funkcji obrazu galerii.
struna
GalleryImageIdentifier
Nazwa
Opis
Wartość
oferta
Nazwa oferty definicji obrazu galerii.
ciąg (wymagany)
wydawca
Nazwa wydawcy definicji obrazu galerii.
ciąg (wymagany)
Numer jednostki magazynowej
Nazwa jednostki SKU definicji obrazu galerii.
ciąg (wymagany)
GalleryImageProperties
Nazwa
Opis
Wartość
allowUpdateImage
Fakultatywny. Należy ustawić wartość true, jeśli funkcje obrazu galerii są aktualizowane.
bool
architektura
Architektura obrazu. Dotyczy tylko dysków systemu operacyjnego.
"Arm64" "x64"
opis
Opis tego zasobu definicji obrazu galerii. Ta właściwość jest aktualizowalna.
struna
Niedozwolone
Opisuje niedozwolone typy dysków.
niedozwolone
endOfLifeDate
Data zakończenia życia definicji obrazu galerii. Tej właściwości można używać do celów likwidowania. Ta właściwość jest aktualizowalna.
struna
Eula
Umowa Licencyjna dotycząca definicji obrazu galerii.
struna
Funkcje
Lista funkcji obrazów galerii.
GalleryImageFeature []
hyperVGeneration
Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.
"V1" "V2"
identyfikator
Jest to identyfikator definicji obrazu galerii.
GalleryImageIdentifier (wymagane)
osState
Ta właściwość umożliwia użytkownikowi określenie, czy maszyny wirtualne utworzone na tym obrazie są "Uogólnione" lub "Wyspecjalizowane".
"Uogólnione" "Wyspecjalizowane" (wymagane)
osType
Ta właściwość umożliwia określenie typu systemu operacyjnego dołączonego do dysku podczas tworzenia maszyny wirtualnej na podstawie obrazu zarządzanego. Możliwe wartości to: Windows, Linux.
"Linux" "Windows" (wymagane)
privacyStatementUri
Identyfikator URI oświadczenia o ochronie prywatności.
struna
purchasePlan
Opisuje plan zakupu definicji obrazu galerii. Jest to używane przez obrazy z witryny Marketplace.
ImagePurchasePlan
Zalecane
Właściwości opisują zalecaną konfigurację maszyny dla tej definicji obrazu. Te właściwości są możliwe do zaktualizowania.
RecommendedMachineConfiguration
releaseNoteUri
Identyfikator URI notatki o wersji.
struna
ImagePurchasePlan
Nazwa
Opis
Wartość
nazwa
Identyfikator planu.
struna
produkt
Identyfikator produktu.
struna
wydawca
Identyfikator wydawcy.
struna
Microsoft.Compute/gallerys/images
Nazwa
Opis
Wartość
apiVersion
Wersja interfejsu API
'2024-03-03'
lokalizacja
Lokalizacja zasobu
ciąg (wymagany)
nazwa
Nazwa zasobu
ciąg (wymagany)
Właściwości
Opisuje właściwości definicji obrazu galerii.
GalleryImageProperties
Tagi
Tagi zasobów
Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ
Typ zasobu
"Microsoft.Compute/gallerys/images"
Zalecana konfiguracjamachine
ResourceRange
Nazwa
Opis
Wartość
Max
Maksymalna liczba zasobów.
Int
Min
Minimalna liczba zasobów.
Int
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
Szablon
Opis
Azure Image Builder z programem Azure Windows Baseline
Tworzy środowisko narzędzia Azure Image Builder i tworzy obraz systemu Windows Server z zastosowanymi najnowszymi aktualizacjami systemu Windows i punktem odniesienia platformy Azure.
Konfigurowanie usługi Dev Box
Ten szablon umożliwia utworzenie wszystkich zasobów administracyjnych usługi Dev Box zgodnie z przewodnikiem Szybki start dotyczącym usługi Dev Box (/azure/dev-box/quickstart-create-dev-box). Możesz wyświetlić wszystkie utworzone zasoby lub bezpośrednio przejść do DevPortal.microsoft.com, aby utworzyć pierwsze rozwiązanie Dev Box.
tworzenie definicji obrazu w galerii obliczeniowej platformy Azure
Ten szablon umożliwia utworzenie prostej definicji obrazu w galerii obliczeniowej platformy Azure. Przed wdrożeniem tego szablonu upewnij się, że został uruchomiony szablon Galerii obrazów udostępnionych 101.
Typ zasobu galerii/obrazów można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian .
Aby utworzyć zasób Microsoft.Compute/gallerys/images, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/galleries/images@2024-03-03"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
allowUpdateImage = bool
architecture = "string"
description = "string"
disallowed = {
diskTypes = [
"string"
]
}
endOfLifeDate = "string"
eula = "string"
features = [
{
name = "string"
startsAtVersion = "string"
value = "string"
}
]
hyperVGeneration = "string"
identifier = {
offer = "string"
publisher = "string"
sku = "string"
}
osState = "string"
osType = "string"
privacyStatementUri = "string"
purchasePlan = {
name = "string"
product = "string"
publisher = "string"
}
recommended = {
memory = {
max = int
min = int
}
vCPUs = {
max = int
min = int
}
}
releaseNoteUri = "string"
}
})
}
Wartości właściwości
Niedozwolone
Nazwa
Opis
Wartość
diskTypes
Lista typów dysków.
string[]
GalleryImageFeature
Nazwa
Opis
Wartość
nazwa
Nazwa funkcji obrazu galerii.
struna
startsAtVersion
Minimalna wersja obrazu galerii, która obsługuje tę funkcję.
struna
wartość
Wartość funkcji obrazu galerii.
struna
GalleryImageIdentifier
Nazwa
Opis
Wartość
oferta
Nazwa oferty definicji obrazu galerii.
ciąg (wymagany)
wydawca
Nazwa wydawcy definicji obrazu galerii.
ciąg (wymagany)
Numer jednostki magazynowej
Nazwa jednostki SKU definicji obrazu galerii.
ciąg (wymagany)
GalleryImageProperties
Nazwa
Opis
Wartość
allowUpdateImage
Fakultatywny. Należy ustawić wartość true, jeśli funkcje obrazu galerii są aktualizowane.
bool
architektura
Architektura obrazu. Dotyczy tylko dysków systemu operacyjnego.
"Arm64" "x64"
opis
Opis tego zasobu definicji obrazu galerii. Ta właściwość jest aktualizowalna.
struna
Niedozwolone
Opisuje niedozwolone typy dysków.
niedozwolone
endOfLifeDate
Data zakończenia życia definicji obrazu galerii. Tej właściwości można używać do celów likwidowania. Ta właściwość jest aktualizowalna.
struna
Eula
Umowa Licencyjna dotycząca definicji obrazu galerii.
struna
Funkcje
Lista funkcji obrazów galerii.
GalleryImageFeature []
hyperVGeneration
Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego.
"V1" "V2"
identyfikator
Jest to identyfikator definicji obrazu galerii.
GalleryImageIdentifier (wymagane)
osState
Ta właściwość umożliwia użytkownikowi określenie, czy maszyny wirtualne utworzone na tym obrazie są "Uogólnione" lub "Wyspecjalizowane".
"Uogólnione" "Wyspecjalizowane" (wymagane)
osType
Ta właściwość umożliwia określenie typu systemu operacyjnego dołączonego do dysku podczas tworzenia maszyny wirtualnej na podstawie obrazu zarządzanego. Możliwe wartości to: Windows, Linux.
"Linux" "Windows" (wymagane)
privacyStatementUri
Identyfikator URI oświadczenia o ochronie prywatności.
struna
purchasePlan
Opisuje plan zakupu definicji obrazu galerii. Jest to używane przez obrazy z witryny Marketplace.
ImagePurchasePlan
Zalecane
Właściwości opisują zalecaną konfigurację maszyny dla tej definicji obrazu. Te właściwości są możliwe do zaktualizowania.
RecommendedMachineConfiguration
releaseNoteUri
Identyfikator URI notatki o wersji.
struna
ImagePurchasePlan
Nazwa
Opis
Wartość
nazwa
Identyfikator planu.
struna
produkt
Identyfikator produktu.
struna
wydawca
Identyfikator wydawcy.
struna
Microsoft.Compute/gallerys/images
Nazwa
Opis
Wartość
lokalizacja
Lokalizacja zasobu
ciąg (wymagany)
nazwa
Nazwa zasobu
ciąg (wymagany)
parent_id
Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu.
Identyfikator zasobu typu: galerie
Właściwości
Opisuje właściwości definicji obrazu galerii.
GalleryImageProperties
Tagi
Tagi zasobów
Słownik nazw tagów i wartości.
typ
Typ zasobu
"Microsoft.Compute/gallerys/images@2024-03-03"
Zalecana konfiguracjamachine
ResourceRange
Nazwa
Opis
Wartość
Max
Maksymalna liczba zasobów.
Int
Min
Minimalna liczba zasobów.
Int