Microsoft.Compute/gallerys/images - Bicep, ARM template & Terraform AzAPI reference

Definicja zasobu Bicep

Typ zasobu galerii/obrazów można wdrożyć przy użyciu operacji docelowych:

grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/gallerys/images, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.Compute/galleries/images@2023-07-03' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    architecture: 'string'
    description: 'string'
    disallowed: {
      diskTypes: [
        'string'
      ]
    }
    endOfLifeDate: 'string'
    eula: 'string'
    features: [
      {
        name: '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

galerie/obrazy

Nazwa	Opis	Wartość
nazwa	Nazwa zasobu Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w Bicep.	ciąg (wymagany) Limit znaków: 1–80 Prawidłowe znaki: Alfanumeryczne, podkreślenia, łączniki i kropki. Rozpocznij i zakończ od alfanumeryczne.
lokalizacja	Lokalizacja zasobu	ciąg (wymagany)
Tagi	Tagi zasobów	Słownik nazw tagów i wartości. Zobacz tagi w szablonach
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

GalleryImageProperties

Nazwa	Opis	Wartość
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

Niedozwolone

Nazwa	Opis	Wartość
diskTypes	Lista typów dysków.	string[]

GalleryImageFeature

Nazwa	Opis	Wartość
nazwa	Nazwa funkcji obrazu galerii.	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)

ImagePurchasePlan

Nazwa	Opis	Wartość
nazwa	Identyfikator planu.	struna
produkt	Identyfikator produktu.	struna
wydawca	Identyfikator wydawcy.	struna

Zalecana konfiguracjamachine

Nazwa	Opis	Wartość
pamięć	Opisuje zakres zasobów.	ResourceRange
Procesory wirtualne	Opisuje zakres zasobów.	ResourceRange

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.
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.
Konfigurowanie usługi Dev Box	Ten szablon utworzy wszystkie zasoby administracyjne usługi Dev Box zgodnie z przewodnikiem Szybki start dotyczącym usługi Dev Box (https://learn.microsoft.com/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:

grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/gallerys/images, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.Compute/galleries/images",
  "apiVersion": "2023-07-03",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "architecture": "string",
    "description": "string",
    "disallowed": {
      "diskTypes": [ "string" ]
    },
    "endOfLifeDate": "string",
    "eula": "string",
    "features": [
      {
        "name": "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

galerie/obrazy

Nazwa	Opis	Wartość
typ	Typ zasobu	"Microsoft.Compute/gallerys/images"
apiVersion	Wersja interfejsu API zasobów	'2023-07-03'
nazwa	Nazwa zasobu Zobacz, jak ustawiać nazwy i typy dla zasobów podrzędnych w szablonach usługi ARM JSON.	ciąg (wymagany) Limit znaków: 1–80 Prawidłowe znaki: Alfanumeryczne, podkreślenia, łączniki i kropki. Rozpocznij i zakończ od alfanumeryczne.
lokalizacja	Lokalizacja zasobu	ciąg (wymagany)
Tagi	Tagi zasobów	Słownik nazw tagów i wartości. Zobacz tagi w szablonach
Właściwości	Opisuje właściwości definicji obrazu galerii.	GalleryImageProperties

GalleryImageProperties

Nazwa	Opis	Wartość
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

Niedozwolone

Nazwa	Opis	Wartość
diskTypes	Lista typów dysków.	string[]

GalleryImageFeature

Nazwa	Opis	Wartość
nazwa	Nazwa funkcji obrazu galerii.	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)

ImagePurchasePlan

Nazwa	Opis	Wartość
nazwa	Identyfikator planu.	struna
produkt	Identyfikator produktu.	struna
wydawca	Identyfikator wydawcy.	struna

Zalecana konfiguracjamachine

Nazwa	Opis	Wartość
pamięć	Opisuje zakres zasobów.	ResourceRange
Procesory wirtualne	Opisuje zakres zasobów.	ResourceRange

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.
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.
Konfigurowanie usługi Dev Box	Ten szablon utworzy wszystkie zasoby administracyjne usługi Dev Box zgodnie z przewodnikiem Szybki start dotyczącym usługi Dev Box (https://learn.microsoft.com/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 narzędzia Terraform (dostawcy AzAPI)

Typ zasobu galerii/obrazów można wdrożyć przy użyciu operacji docelowych:

Grupa zasobów:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

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@2023-07-03"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      architecture = "string"
      description = "string"
      disallowed = {
        diskTypes = [
          "string"
        ]
      }
      endOfLifeDate = "string"
      eula = "string"
      features = [
        {
          name = "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

galerie/obrazy

Nazwa	Opis	Wartość
typ	Typ zasobu	"Microsoft.Compute/gallerys/images@2023-07-03"
nazwa	Nazwa zasobu	ciąg (wymagany) Limit znaków: 1–80 Prawidłowe znaki: Alfanumeryczne, podkreślenia, łączniki i kropki. Rozpocznij i zakończ od alfanumeryczne.
lokalizacja	Lokalizacja zasobu	ciąg (wymagany)
parent_id	Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu.	Identyfikator zasobu typu: galerie
Tagi	Tagi zasobów	Słownik nazw tagów i wartości.
Właściwości	Opisuje właściwości definicji obrazu galerii.	GalleryImageProperties

GalleryImageProperties

Nazwa	Opis	Wartość
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" "Wersja 2"
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

Niedozwolone

Nazwa	Opis	Wartość
diskTypes	Lista typów dysków.	string[]

GalleryImageFeature

Nazwa	Opis	Wartość
nazwa	Nazwa funkcji obrazu galerii.	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)

ImagePurchasePlan

Nazwa	Opis	Wartość
nazwa	Identyfikator planu.	struna
produkt	Identyfikator produktu.	struna
wydawca	Identyfikator wydawcy.	struna

Zalecana konfiguracjamachine

Nazwa	Opis	Wartość
pamięć	Opisuje zakres zasobów.	ResourceRange
Procesory wirtualne	Opisuje zakres zasobów.	ResourceRange

ResourceRange

Nazwa	Opis	Wartość
Max	Maksymalna liczba zasobów.	Int
Min	Minimalna liczba zasobów.	Int

Udostępnij za pośrednictwem

Galerie/obrazy Microsoft.Compute

Definicja zasobu Bicep

Format zasobu

Wartości właściwości

galerie/obrazy

GalleryImageProperties

Niedozwolone

GalleryImageFeature

GalleryImageIdentifier

ImagePurchasePlan

Zalecana konfiguracjamachine

ResourceRange

Szablony szybkiego startu

Definicja zasobu szablonu usługi ARM

Format zasobu

Wartości właściwości

galerie/obrazy

GalleryImageProperties

Niedozwolone

GalleryImageFeature

GalleryImageIdentifier

ImagePurchasePlan

Zalecana konfiguracjamachine

ResourceRange

Szablony szybkiego startu

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Format zasobu

Wartości właściwości

galerie/obrazy

GalleryImageProperties

Niedozwolone

GalleryImageFeature

GalleryImageIdentifier

ImagePurchasePlan

Zalecana konfiguracjamachine

ResourceRange

Opinia

Dodatkowe zasoby