Udostępnij za pośrednictwem


Microsoft.Compute gallerys/images/versions 2021-07-01

Definicja zasobu Bicep

Galerie/obrazy/wersje typu zasobu można wdrożyć z operacjami docelowymi:

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

Format zasobu

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

resource symbolicname 'Microsoft.Compute/galleries/images/versions@2021-07-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    publishingProfile: {
      endOfLifeDate: 'string'
      excludeFromLatest: bool
      replicaCount: int
      replicationMode: 'string'
      storageAccountType: 'string'
      targetRegions: [
        {
          encryption: {
            dataDiskImages: [
              {
                diskEncryptionSetId: 'string'
                lun: int
              }
            ]
            osDiskImage: {
              diskEncryptionSetId: 'string'
            }
          }
          name: 'string'
          regionalReplicaCount: int
          storageAccountType: 'string'
        }
      ]
    }
    storageProfile: {
      dataDiskImages: [
        {
          hostCaching: 'string'
          lun: int
          source: {
            id: 'string'
            uri: 'string'
          }
        }
      ]
      osDiskImage: {
        hostCaching: 'string'
        source: {
          id: 'string'
          uri: 'string'
        }
      }
      source: {
        id: 'string'
        uri: 'string'
      }
    }
  }
}

Wartości właściwości

galerie/obrazy/wersje

Nazwa Opis Wartość
name Nazwa zasobu

Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w aplikacji Bicep.
ciąg (wymagany)

Limit znaków: 32-bitowa liczba całkowita

Prawidłowe znaki:
Liczby i kropki.
(Każdy segment jest konwertowany na int32. Dlatego każdy segment ma maksymalną wartość 2 147 483 647).
location Lokalizacja zasobu ciąg (wymagany)
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
Nadrzędny W pliku 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: obrazy
properties Opisuje właściwości wersji obrazu galerii. GalleryImageVersionProperties

GalleryImageVersionProperties

Nazwa Opis Wartość
publishingProfile Profil publikowania wersji obrazu galerii. GalleryImageVersionPublishingProfile
storageProfile Jest to profil magazynu wersji obrazu galerii. GalleryImageVersionStorageProfile (wymagane)

GalleryImageVersionPublishingProfile

Nazwa Opis Wartość
endOfLifeDate Data zakończenia życia wersji obrazu galerii. Ta właściwość może być używana do celów likwidacji. Ta właściwość jest aktualizowana. ciąg
excludeFromLatest W przypadku ustawienia wartości true Virtual Machines wdrożone z najnowszej wersji definicji obrazu nie będą używać tej wersji obrazu. bool
replicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. Ta właściwość będzie obowiązywać dla regionu, gdy nie określono parametru regionalReplicaCount. Ta właściwość jest aktualizowana. int
replicationMode Opcjonalny parametr określający tryb, który ma być używany do replikacji. Ta właściwość nie jest aktualizowana. "Pełny"
"Płytkie"
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetRegions Regiony docelowe, do których ma zostać zreplikowana wersja obrazu. Ta właściwość jest aktualizowana. TargetRegion[]

TargetRegion

Nazwa Opis Wartość
Szyfrowanie Opcjonalny. Umożliwia użytkownikom udostępnianie kluczy zarządzanych przez klienta na potrzeby szyfrowania dysków systemu operacyjnego i danych w artefaktie galerii. EncryptionImages
name Nazwa regionu. ciąg (wymagany)
regionalnareplicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. Ta właściwość jest aktualizowana. int
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

EncryptionImages

Nazwa Opis Wartość
dataDiskImages Lista specyfikacji szyfrowania obrazów dysków danych. DataDiskImageEncryption[]
osDiskImage Zawiera ustawienia szyfrowania obrazu dysku systemu operacyjnego. OSDiskImageEncryption

DataDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg
Jednostki lun Ta właściwość określa numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych na maszynie wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej. int (wymagane)

OSDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg

GalleryImageVersionStorageProfile

Nazwa Opis Wartość
dataDiskImages Lista obrazów dysków danych. GalleryDataDiskImage[]
osDiskImage Jest to obraz dysku systemu operacyjnego. GalleryOSDiskImage
source Źródło wersji artefaktu galerii. GalleryArtifactVersionSource

GalleryDataDiskImage

Nazwa Opis Wartość
hostCaching Buforowanie hosta dysku. Prawidłowe wartości to "None", "ReadOnly" i "ReadWrite" "Brak"
"ReadOnly"
"ReadWrite"
Jednostki lun Ta właściwość określa numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych na maszynie wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej. int (wymagane)
source Źródło wersji artefaktu galerii. GalleryArtifactVersionSource

GalleryArtifactVersionSource

Nazwa Opis Wartość
identyfikator Identyfikator źródła wersji artefaktu galerii. Może określić identyfikator URI dysku, identyfikator URI migawki, obraz użytkownika lub zasób konta magazynu. ciąg
Identyfikator uri Identyfikator URI źródła wersji artefaktu galerii. Obecnie służy do określania źródła wirtualnego dysku twardego/obiektu blob. ciąg

GalleryOSDiskImage

Nazwa Opis Wartość
hostCaching Buforowanie hosta dysku. Prawidłowe wartości to "None", "ReadOnly" i "ReadWrite" "Brak"
"ReadOnly"
"ReadWrite"
source Źródło wersji artefaktu galerii. GalleryArtifactVersionSource

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Tworzenie wersji obrazu w galerii obliczeń platformy Azure

Wdróż na platformie Azure
Ten szablon umożliwia utworzenie prostej wersji obrazu w galerii obliczeń platformy Azure. Upewnij się, że przed wdrożeniem szablonu usługi Azure Compute Gallery 101 i szablonu definicji obrazu 101 został uruchomiony.

Definicja zasobu szablonu usługi ARM

Galerie/obrazy/wersje typu zasobu można wdrożyć z operacjami docelowymi:

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

Format zasobu

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

{
  "type": "Microsoft.Compute/galleries/images/versions",
  "apiVersion": "2021-07-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "publishingProfile": {
      "endOfLifeDate": "string",
      "excludeFromLatest": "bool",
      "replicaCount": "int",
      "replicationMode": "string",
      "storageAccountType": "string",
      "targetRegions": [
        {
          "encryption": {
            "dataDiskImages": [
              {
                "diskEncryptionSetId": "string",
                "lun": "int"
              }
            ],
            "osDiskImage": {
              "diskEncryptionSetId": "string"
            }
          },
          "name": "string",
          "regionalReplicaCount": "int",
          "storageAccountType": "string"
        }
      ]
    },
    "storageProfile": {
      "dataDiskImages": [
        {
          "hostCaching": "string",
          "lun": "int",
          "source": {
            "id": "string",
            "uri": "string"
          }
        }
      ],
      "osDiskImage": {
        "hostCaching": "string",
        "source": {
          "id": "string",
          "uri": "string"
        }
      },
      "source": {
        "id": "string",
        "uri": "string"
      }
    }
  }
}

Wartości właściwości

galerie/obrazy/wersje

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Compute/gallerys/images/versions"
apiVersion Wersja interfejsu API zasobów '2021-07-01'
name 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: 32-bitowa liczba całkowita

Prawidłowe znaki:
Liczby i kropki.
(Każdy segment jest konwertowany na int32. Dlatego każdy segment ma maksymalną wartość 2 147 483 647).
location Lokalizacja zasobu ciąg (wymagany)
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
properties Opisuje właściwości wersji obrazu galerii. GalleryImageVersionProperties

GalleryImageVersionProperties

Nazwa Opis Wartość
publishingProfile Profil publikowania wersji obrazu galerii. GalleryImageVersionPublishingProfile
storageProfile Jest to profil magazynu wersji obrazu galerii. GalleryImageVersionStorageProfile (wymagane)

GalleryImageVersionPublishingProfile

Nazwa Opis Wartość
endOfLifeDate Data zakończenia życia wersji obrazu galerii. Ta właściwość może być używana do celów likwidacji. Ta właściwość jest aktualizowana. ciąg
excludeFromLatest W przypadku ustawienia wartości true Virtual Machines wdrożone z najnowszej wersji definicji obrazu nie będą używać tej wersji obrazu. bool
replicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. Ta właściwość będzie obowiązywać dla regionu, gdy nie określono parametru regionalReplicaCount. Ta właściwość jest aktualizowana. int
replicationMode Opcjonalny parametr określający tryb, który ma być używany do replikacji. Ta właściwość nie jest aktualizowana. "Pełny"
"Płytkie"
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetRegions Regiony docelowe, do których ma zostać zreplikowana wersja obrazu. Ta właściwość jest aktualizowana. TargetRegion[]

TargetRegion

Nazwa Opis Wartość
Szyfrowanie Opcjonalny. Umożliwia użytkownikom udostępnianie kluczy zarządzanych przez klienta na potrzeby szyfrowania dysków systemu operacyjnego i danych w artefaktie galerii. EncryptionImages
name Nazwa regionu. ciąg (wymagany)
regionalnareplicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. Ta właściwość jest aktualizowana. int
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

EncryptionImages

Nazwa Opis Wartość
dataDiskImages Lista specyfikacji szyfrowania obrazów dysków danych. DataDiskImageEncryption[]
osDiskImage Zawiera ustawienia szyfrowania obrazu dysku systemu operacyjnego. OSDiskImageEncryption

DataDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg
Jednostki lun Ta właściwość określa numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych na maszynie wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej. int (wymagane)

OSDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg

GalleryImageVersionStorageProfile

Nazwa Opis Wartość
dataDiskImages Lista obrazów dysków danych. GalleryDataDiskImage[]
osDiskImage Jest to obraz dysku systemu operacyjnego. GalleryOSDiskImage
source Źródło wersji artefaktu galerii. GalleryArtifactVersionSource

GalleryDataDiskImage

Nazwa Opis Wartość
hostCaching Buforowanie hosta dysku. Prawidłowe wartości to "None", "ReadOnly" i "ReadWrite" "Brak"
"ReadOnly"
"ReadWrite"
Jednostki lun Ta właściwość określa numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych na maszynie wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej. int (wymagane)
source Źródło wersji artefaktu galerii. GalleryArtifactVersionSource

GalleryArtifactVersionSource

Nazwa Opis Wartość
identyfikator Identyfikator źródła wersji artefaktu galerii. Może określić identyfikator URI dysku, identyfikator URI migawki, obraz użytkownika lub zasób konta magazynu. ciąg
Identyfikator uri Identyfikator URI źródła wersji artefaktu galerii. Obecnie służy do określania źródła wirtualnego dysku twardego/obiektu blob. ciąg

GalleryOSDiskImage

Nazwa Opis Wartość
hostCaching Buforowanie hosta dysku. Prawidłowe wartości to "None", "ReadOnly" i "ReadWrite" "Brak"
"ReadOnly"
"ReadWrite"
source Źródło wersji artefaktu galerii. GalleryArtifactVersionSource

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Tworzenie wersji obrazu w galerii obliczeń platformy Azure

Wdróż na platformie Azure
Ten szablon umożliwia utworzenie prostej wersji obrazu w galerii obliczeń platformy Azure. Upewnij się, że przed wdrożeniem szablonu usługi Azure Compute Gallery 101 i szablonu definicji obrazu 101 został uruchomiony.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Galerie/obrazy/wersje typu zasobu można wdrożyć z operacjami docelowymi:

  • Grupy zasobów

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

Format zasobu

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/images/versions@2021-07-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      publishingProfile = {
        endOfLifeDate = "string"
        excludeFromLatest = bool
        replicaCount = int
        replicationMode = "string"
        storageAccountType = "string"
        targetRegions = [
          {
            encryption = {
              dataDiskImages = [
                {
                  diskEncryptionSetId = "string"
                  lun = int
                }
              ]
              osDiskImage = {
                diskEncryptionSetId = "string"
              }
            }
            name = "string"
            regionalReplicaCount = int
            storageAccountType = "string"
          }
        ]
      }
      storageProfile = {
        dataDiskImages = [
          {
            hostCaching = "string"
            lun = int
            source = {
              id = "string"
              uri = "string"
            }
          }
        ]
        osDiskImage = {
          hostCaching = "string"
          source = {
            id = "string"
            uri = "string"
          }
        }
        source = {
          id = "string"
          uri = "string"
        }
      }
    }
  })
}

Wartości właściwości

galerie/obrazy/wersje

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Compute/gallerys/images/versions@2021-07-01"
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 32-bitowa liczba całkowita

Prawidłowe znaki:
Liczby i kropki.
(Każdy segment jest konwertowany na int32. Dlatego każdy segment ma maksymalną wartość 2 147 483 647).
location Lokalizacja zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: obrazy
tags Tagi zasobów Słownik nazw tagów i wartości.
properties Opisuje właściwości wersji obrazu galerii. GalleryImageVersionProperties

GalleryImageVersionProperties

Nazwa Opis Wartość
publishingProfile Profil publikowania wersji obrazu galerii. GalleryImageVersionPublishingProfile
storageProfile Jest to profil magazynu wersji obrazu galerii. GalleryImageVersionStorageProfile (wymagane)

GalleryImageVersionPublishingProfile

Nazwa Opis Wartość
endOfLifeDate Data zakończenia życia wersji obrazu galerii. Ta właściwość może być używana do celów likwidacji. Ta właściwość jest aktualizowana. ciąg
excludeFromLatest W przypadku ustawienia wartości true Virtual Machines wdrożone z najnowszej wersji definicji obrazu nie będą używać tej wersji obrazu. bool
replicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. Ta właściwość będzie obowiązywać dla regionu, gdy nie określono parametru regionalReplicaCount. Ta właściwość jest aktualizowana. int
replicationMode Opcjonalny parametr określający tryb, który ma być używany do replikacji. Ta właściwość nie jest aktualizowana. "Pełny"
"Płytkie"
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetRegions Regiony docelowe, do których ma zostać zreplikowana wersja obrazu. Ta właściwość jest aktualizowana. TargetRegion[]

TargetRegion

Nazwa Opis Wartość
Szyfrowanie Opcjonalny. Umożliwia użytkownikom udostępnianie kluczy zarządzanych przez klienta na potrzeby szyfrowania dysków systemu operacyjnego i danych w artefaktie galerii. EncryptionImages
name Nazwa regionu. ciąg (wymagany)
regionalnareplicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. Ta właściwość jest aktualizowana. int
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

EncryptionImages

Nazwa Opis Wartość
dataDiskImages Lista specyfikacji szyfrowania obrazów dysków danych. DataDiskImageEncryption[]
osDiskImage Zawiera ustawienia szyfrowania obrazu dysku systemu operacyjnego. OSDiskImageEncryption

DataDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg
Jednostki lun Ta właściwość określa numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych w ramach maszyny wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej. int (wymagane)

OSDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg

GalleryImageVersionStorageProfile

Nazwa Opis Wartość
dataDiskImages Lista obrazów dysków danych. GalleryDataDiskImage[]
osDiskImage Jest to obraz dysku systemu operacyjnego. GalleryOSDiskImage
source Źródło wersji artefaktu galerii. GalleryArtifactVersionSource

GalleryDataDiskImage

Nazwa Opis Wartość
hostCaching Buforowanie hosta dysku. Prawidłowe wartości to "None", "ReadOnly" i "ReadWrite" "Brak"
"ReadOnly"
"ReadWrite"
Jednostki lun Ta właściwość określa numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych w ramach maszyny wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej. int (wymagane)
source Źródło wersji artefaktu galerii. GalleryArtifactVersionSource

GalleryArtifactVersionSource

Nazwa Opis Wartość
identyfikator Identyfikator źródła wersji artefaktu galerii. Może określać identyfikator URI dysku, identyfikator URI migawki, obraz użytkownika lub zasób konta magazynu. ciąg
Identyfikator uri Identyfikator URI źródła wersji artefaktu galerii. Obecnie służy do określania źródła vhd/blob. ciąg

GalleryOSDiskImage

Nazwa Opis Wartość
hostCaching Buforowanie hosta dysku. Prawidłowe wartości to "None", "ReadOnly" i "ReadWrite" "Brak"
"ReadOnly"
"ReadWrite"
source Źródło wersji artefaktu galerii. GalleryArtifactVersionSource