Udostępnij za pośrednictwem


Galerie Microsoft.Compute

Definicja zasobu Bicep

Typ zasobu galerii 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.

Format zasobu

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

resource symbolicname 'Microsoft.Compute/galleries@2025-03-03' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    description: 'string'
    identifier: {}
    sharingProfile: {
      communityGalleryInfo: {
        eula: 'string'
        publicNamePrefix: 'string'
        publisherContact: 'string'
        publisherUri: 'string'
      }
      permissions: 'string'
    }
    softDeletePolicy: {
      isSoftDeleteEnabled: bool
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Wartości właściwości

Microsoft.Compute/gallerys

Nazwa Opis Wartość
tożsamość Tożsamość galerii, jeśli została skonfigurowana. Tożsamość galerii
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu string

Ograniczenia:
Wzorzec = ^[^_\W][\w-._]{0,79}(?<![-.])$ (wymagane)
Właściwości Opisuje właściwości galerii obrazów udostępnionych. Właściwości galerii
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

SpołecznośćGaleriaInformacje

Nazwa Opis Wartość
Eula Umowa licencyjna użytkownika końcowego dotycząca obrazu galerii społeczności. ciąg
publicNamePrefix Prefiks nazwy galerii, który będzie wyświetlany publicznie. Widoczne dla wszystkich użytkowników. ciąg
wydawcaKontakt Wiadomość e-mail dotycząca wydawcy galerii społeczności. Adres e-mail wydawcy. Widoczne dla wszystkich użytkowników. ciąg
publisherUri (identyfikator publisherUri) Link do witryny sieci Web wydawcy. Widoczne dla wszystkich użytkowników. ciąg

Identyfikator galerii

Nazwa Opis Wartość

Tożsamość galerii

Nazwa Opis Wartość
typ Typ tożsamości używanej dla galerii. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "None" spowoduje usunięcie wszystkich tożsamości z galerii. "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
tożsamości przypisane użytkownikom Lista tożsamości użytkowników skojarzonych z galerią. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". GalleryIdentityUserAssignedIdentities

GalleryIdentityUserAssignedIdentities

Nazwa Opis Wartość

Właściwości galerii

Nazwa Opis Wartość
opis Opis tego zasobu galerii obrazów udostępnionych. Ta właściwość jest aktualizowalna. ciąg
identyfikator Opisuje unikatową nazwę galerii. Identyfikator galerii
sharingProfile (profil udostępniania) Profil udostępniania galerii w subskrypcji lub dzierżawie sharingProfile
softDeletePolicy (polityka miękkości) Zawiera informacje o zasadach usuwania nietrwałego galerii. Miękka polityka usuwania

Profil udostępniania

Nazwa Opis Wartość
społecznośćGalleryInfo Informacje o galerii społeczności, jeśli bieżąca galeria jest udostępniana społeczności. SpołecznośćGaleriaInformacje
uprawnienia Ta właściwość umożliwia określenie uprawnień do udostępniania galerii. Możliwe wartości to: Prywatne, grupyCommunity. "Społeczność"
"Grupy"
"Prywatny"

Miękka polityka usuwania

Nazwa Opis Wartość
isSoftDeleteEnabled (Opcja Miękkie) Umożliwia usuwanie nietrwałe zasobów w tej galerii, co umożliwia ich odzyskanie w czasie przechowywania. Bool

Śledzone tagi zasobów

Nazwa Opis Wartość

UserAssignedIdentitiesValue (Wartość)

Nazwa Opis Wartość

Przykłady użycia

Przykłady Bicep

Podstawowy przykład wdrażania galerii obrazów udostępnionych.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource gallery 'Microsoft.Compute/galleries@2022-03-03' = {
  name: resourceName
  location: location
  properties: {
    description: ''
  }
}

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
Galeria obliczeniowa platformy Azure Moduł zasobów AVM dla galerii obliczeń platformy Azure

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu 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 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.

Format zasobu

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

{
  "type": "Microsoft.Compute/galleries",
  "apiVersion": "2025-03-03",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "description": "string",
    "identifier": {
    },
    "sharingProfile": {
      "communityGalleryInfo": {
        "eula": "string",
        "publicNamePrefix": "string",
        "publisherContact": "string",
        "publisherUri": "string"
      },
      "permissions": "string"
    },
    "softDeletePolicy": {
      "isSoftDeleteEnabled": "bool"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Wartości właściwości

Microsoft.Compute/gallerys

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API '2025-03-03'
tożsamość Tożsamość galerii, jeśli została skonfigurowana. Tożsamość galerii
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu string

Ograniczenia:
Wzorzec = ^[^_\W][\w-._]{0,79}(?<![-.])$ (wymagane)
Właściwości Opisuje właściwości galerii obrazów udostępnionych. Właściwości galerii
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.Compute/gallerys"

SpołecznośćGaleriaInformacje

Nazwa Opis Wartość
Eula Umowa licencyjna użytkownika końcowego dotycząca obrazu galerii społeczności. ciąg
publicNamePrefix Prefiks nazwy galerii, który będzie wyświetlany publicznie. Widoczne dla wszystkich użytkowników. ciąg
wydawcaKontakt Wiadomość e-mail dotycząca wydawcy galerii społeczności. Adres e-mail wydawcy. Widoczne dla wszystkich użytkowników. ciąg
publisherUri (identyfikator publisherUri) Link do witryny sieci Web wydawcy. Widoczne dla wszystkich użytkowników. ciąg

Identyfikator galerii

Nazwa Opis Wartość

Tożsamość galerii

Nazwa Opis Wartość
typ Typ tożsamości używanej dla galerii. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "None" spowoduje usunięcie wszystkich tożsamości z galerii. "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
tożsamości przypisane użytkownikom Lista tożsamości użytkowników skojarzonych z galerią. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". GalleryIdentityUserAssignedIdentities

GalleryIdentityUserAssignedIdentities

Nazwa Opis Wartość

Właściwości galerii

Nazwa Opis Wartość
opis Opis tego zasobu galerii obrazów udostępnionych. Ta właściwość jest aktualizowalna. ciąg
identyfikator Opisuje unikatową nazwę galerii. Identyfikator galerii
sharingProfile (profil udostępniania) Profil udostępniania galerii w subskrypcji lub dzierżawie sharingProfile
softDeletePolicy (polityka miękkości) Zawiera informacje o zasadach usuwania nietrwałego galerii. Miękka polityka usuwania

Profil udostępniania

Nazwa Opis Wartość
społecznośćGalleryInfo Informacje o galerii społeczności, jeśli bieżąca galeria jest udostępniana społeczności. SpołecznośćGaleriaInformacje
uprawnienia Ta właściwość umożliwia określenie uprawnień do udostępniania galerii. Możliwe wartości to: Prywatne, grupyCommunity. "Społeczność"
"Grupy"
"Prywatny"

Miękka polityka usuwania

Nazwa Opis Wartość
isSoftDeleteEnabled (Opcja Miękkie) Umożliwia usuwanie nietrwałe zasobów w tej galerii, co umożliwia ich odzyskanie w czasie przechowywania. Bool

Śledzone tagi zasobów

Nazwa Opis Wartość

UserAssignedIdentitiesValue (Wartość)

Nazwa Opis Wartość

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
Azure Image Builder z programem Azure Windows Baseline

Wdróż na platformie Azure
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

Wdróż na platformie Azure
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 galerii zasobów obliczeniowych platformy Azure

Wdróż na platformie Azure
Ten szablon umożliwia utworzenie galerii zasobów obliczeniowych platformy Azure.
Tworzenie galerii zasobów obliczeniowych platformy Azure

Wdróż na platformie Azure
Ten moduł tworzy zasób galerii obliczeniowej platformy Azure za pomocą interfejsu APIVersion 2019-12-01.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu galerii można wdrożyć przy użyciu operacji docelowych:

  • 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, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries@2025-03-03"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      description = "string"
      identifier = {
      }
      sharingProfile = {
        communityGalleryInfo = {
          eula = "string"
          publicNamePrefix = "string"
          publisherContact = "string"
          publisherUri = "string"
        }
        permissions = "string"
      }
      softDeletePolicy = {
        isSoftDeleteEnabled = bool
      }
    }
  }
}

Wartości właściwości

Microsoft.Compute/gallerys

Nazwa Opis Wartość
tożsamość Tożsamość galerii, jeśli została skonfigurowana. Tożsamość galerii
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu string

Ograniczenia:
Wzorzec = ^[^_\W][\w-._]{0,79}(?<![-.])$ (wymagane)
Właściwości Opisuje właściwości galerii obrazów udostępnionych. Właściwości galerii
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.Compute/galleries@2025-03-03"

SpołecznośćGaleriaInformacje

Nazwa Opis Wartość
Eula Umowa licencyjna użytkownika końcowego dotycząca obrazu galerii społeczności. ciąg
publicNamePrefix Prefiks nazwy galerii, który będzie wyświetlany publicznie. Widoczne dla wszystkich użytkowników. ciąg
wydawcaKontakt Wiadomość e-mail dotycząca wydawcy galerii społeczności. Adres e-mail wydawcy. Widoczne dla wszystkich użytkowników. ciąg
publisherUri (identyfikator publisherUri) Link do witryny sieci Web wydawcy. Widoczne dla wszystkich użytkowników. ciąg

Identyfikator galerii

Nazwa Opis Wartość

Tożsamość galerii

Nazwa Opis Wartość
typ Typ tożsamości używanej dla galerii. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "None" spowoduje usunięcie wszystkich tożsamości z galerii. "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
tożsamości przypisane użytkownikom Lista tożsamości użytkowników skojarzonych z galerią. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". GalleryIdentityUserAssignedIdentities

GalleryIdentityUserAssignedIdentities

Nazwa Opis Wartość

Właściwości galerii

Nazwa Opis Wartość
opis Opis tego zasobu galerii obrazów udostępnionych. Ta właściwość jest aktualizowalna. ciąg
identyfikator Opisuje unikatową nazwę galerii. Identyfikator galerii
sharingProfile (profil udostępniania) Profil udostępniania galerii w subskrypcji lub dzierżawie sharingProfile
softDeletePolicy (polityka miękkości) Zawiera informacje o zasadach usuwania nietrwałego galerii. Miękka polityka usuwania

Profil udostępniania

Nazwa Opis Wartość
społecznośćGalleryInfo Informacje o galerii społeczności, jeśli bieżąca galeria jest udostępniana społeczności. SpołecznośćGaleriaInformacje
uprawnienia Ta właściwość umożliwia określenie uprawnień do udostępniania galerii. Możliwe wartości to: Prywatne, grupyCommunity. "Społeczność"
"Grupy"
"Prywatny"

Miękka polityka usuwania

Nazwa Opis Wartość
isSoftDeleteEnabled (Opcja Miękkie) Umożliwia usuwanie nietrwałe zasobów w tej galerii, co umożliwia ich odzyskanie w czasie przechowywania. Bool

Śledzone tagi zasobów

Nazwa Opis Wartość

UserAssignedIdentitiesValue (Wartość)

Nazwa Opis Wartość

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania galerii obrazów udostępnionych.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "gallery" {
  type      = "Microsoft.Compute/galleries@2022-03-03"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      description = ""
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
Galeria obliczeniowa platformy Azure Moduł zasobów AVM dla galerii obliczeń platformy Azure