Galleries - Create Or Update
Erstellen oder aktualisieren Sie eine Shared Image Gallery.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}?api-version=2024-03-03
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
gallery
|
path | True |
string pattern: ^[^_\W][\w-._]{0,79}(? |
Der Name der Shared Image Gallery. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
subscription
|
path | True |
string minLength: 1 |
Hierbei handelt es sich um die ID des Zielabonnements. |
|
api-version
|
query | True |
string minLength: 1 |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Anforderungstext
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| location | True |
string |
Der geografische Standort, an dem sich die Ressource befindet |
| identity |
Die Identität des Katalogs, falls konfiguriert. |
||
| properties.description |
string |
Die Beschreibung dieser Ressource für freigegebene Bildergalerie. Diese Eigenschaft ist aktualisierbar. |
|
| properties.identifier |
Beschreibt den eindeutigen Namen des Katalogs. |
||
| properties.sharingProfile |
Profil für die Katalogfreigabe für Abonnement oder Mandant |
||
| properties.softDeletePolicy |
Enthält Informationen zur Richtlinie für das vorläufige Löschen des Katalogs. |
||
| tags |
object |
Ressourcentags. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Der Aktualisierungsvorgang der Ressource "Galerie" war erfolgreich |
|
| 201 Created |
Der Erstellungsvorgang für die Ressource "Galerie" war erfolgreich Header
|
|
| 202 Accepted |
Die Anforderung wurde zur Verarbeitung angenommen, die Verarbeitung ist jedoch noch nicht abgeschlossen. Header
|
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
Create a community gallery.
Beispielanforderung
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2024-03-03
{
"location": "West US",
"properties": {
"description": "This is the gallery description.",
"sharingProfile": {
"permissions": "Community",
"communityGalleryInfo": {
"publisherUri": "uri",
"publisherContact": "pir@microsoft.com",
"eula": "eula",
"publicNamePrefix": "PirPublic"
}
}
}
}
Beispiel für eine Antwort
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Updating",
"sharingProfile": {
"permissions": "Community",
"communityGalleryInfo": {
"publisherUri": "uri",
"publisherContact": "pir@microsoft.com",
"eula": "eula",
"publicNamePrefix": "PirPublic"
}
}
},
"location": "West US",
"name": "myGalleryName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Creating",
"sharingProfile": {
"permissions": "Community",
"communityGalleryInfo": {
"publisherUri": "uri",
"publisherContact": "pir@microsoft.com",
"eula": "eula",
"publicNamePrefix": "PirPublic"
}
}
},
"location": "West US",
"name": "myGalleryName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Updating",
"sharingProfile": {
"permissions": "Community",
"communityGalleryInfo": {
"publisherUri": "uri",
"publisherContact": "pir@microsoft.com",
"eula": "eula",
"publicNamePrefix": "PirPublic"
}
}
},
"location": "West US",
"name": "myGalleryName"
}
Create or update a simple gallery with sharing profile.
Beispielanforderung
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2024-03-03
{
"location": "West US",
"properties": {
"description": "This is the gallery description.",
"sharingProfile": {
"permissions": "Groups"
}
}
}
Beispiel für eine Antwort
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Updating",
"sharingProfile": {
"permissions": "Groups"
}
},
"location": "West US",
"name": "myGalleryName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Creating",
"sharingProfile": {
"permissions": "Groups"
}
},
"location": "West US",
"name": "myGalleryName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Updating",
"sharingProfile": {
"permissions": "Groups"
}
},
"location": "West US",
"name": "myGalleryName"
}
Create or update a simple gallery with soft deletion enabled.
Beispielanforderung
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2024-03-03
{
"location": "West US",
"properties": {
"description": "This is the gallery description.",
"softDeletePolicy": {
"isSoftDeleteEnabled": true
}
}
}
Beispiel für eine Antwort
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Updating",
"softDeletePolicy": {
"isSoftDeleteEnabled": true
}
},
"location": "West US",
"name": "myGalleryName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Creating",
"softDeletePolicy": {
"isSoftDeleteEnabled": true
}
},
"location": "West US",
"name": "myGalleryName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Updating",
"softDeletePolicy": {
"isSoftDeleteEnabled": true
}
},
"location": "West US",
"name": "myGalleryName"
}
Create or update a simple gallery with system-assigned and user-assigned managed identities.
Beispielanforderung
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2024-03-03
{
"location": "West US",
"identity": {
"type": "SystemAssigned, UserAssigned",
"userAssignedIdentities": {
"/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity": {}
}
},
"properties": {
"description": "This is the gallery description."
}
}
Beispiel für eine Antwort
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"identity": {
"type": "SystemAssigned, UserAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000",
"userAssignedIdentities": {
"/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity": {}
}
},
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Updating"
},
"location": "West US",
"name": "myGalleryName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"identity": {
"type": "SystemAssigned, UserAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000",
"userAssignedIdentities": {
"/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity": {}
}
},
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Creating",
"softDeletePolicy": {
"isSoftDeleteEnabled": true
}
},
"location": "West US",
"name": "myGalleryName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName",
"identity": {
"type": "SystemAssigned, UserAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000",
"userAssignedIdentities": {
"/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity": {}
}
},
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Updating",
"softDeletePolicy": {
"isSoftDeleteEnabled": true
}
},
"location": "West US",
"name": "myGalleryName"
}
Create or update a simple gallery.
Beispielanforderung
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName?api-version=2024-03-03
{
"location": "West US",
"properties": {
"description": "This is the gallery description."
}
}
Beispiel für eine Antwort
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Updating"
},
"location": "West US",
"name": "myGalleryName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Creating"
},
"location": "West US",
"name": "myGalleryName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery",
"properties": {
"description": "This is the gallery description.",
"identifier": {
"uniqueName": "{subscription-id}-MYGALLERYNAME"
},
"provisioningState": "Updating"
},
"location": "West US",
"name": "myGalleryName"
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Api |
API-Fehler. |
|
Api |
API-Fehlerbasis. |
|
Cloud |
Eine Fehlerantwort vom Compute-Dienst. |
|
Common. |
|
|
Community |
Informationen zur Community-Galerie, wenn die aktuelle Galerie für die Community freigegeben ist |
|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
| Gallery |
Gibt Informationen über die Shared Image Gallery an, die Sie erstellen oder aktualisieren möchten. |
|
Gallery |
Beschreibt den eindeutigen Namen des Katalogs. |
|
Gallery |
Identität für den virtuellen Computer. |
|
Gallery |
Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird. |
|
Gallery |
Mit dieser Eigenschaft können Sie die Berechtigung des Freigabekatalogs angeben. Mögliche Werte sind: Private,Gruppen,Community. |
|
Inner |
Innere Fehlerdetails. |
|
Regional |
Regionaler Freigabestatus der Galerie |
|
Resource |
Der Identitätstyp, der für den Katalog verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Katalog. |
|
Sharing |
Profil für die Katalogfreigabe für Abonnement oder Mandant |
|
Sharing |
Gruppe des Galerie-Sharing-Profils |
|
Sharing |
Mit dieser Eigenschaft können Sie den Typ der Freigabegruppe angeben. Mögliche Werte sind: Subscriptions,AADTenants. |
|
Sharing |
Der Freigabestatus der Galerie, der nur in der Antwort angezeigt wird. |
|
Sharing |
Freigabestatus der aktuellen Galerie. |
|
Soft |
Enthält Informationen zur Richtlinie für das vorläufige Löschen des Katalogs. |
|
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
ApiError
API-Fehler.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Der Fehlercode. |
| details |
Die Details zum API-Fehler |
|
| innererror |
Der innere API-Fehler |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Ziel des bestimmten Fehlers. |
ApiErrorBase
API-Fehlerbasis.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Der Fehlercode. |
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Ziel des bestimmten Fehlers. |
CloudError
Eine Fehlerantwort vom Compute-Dienst.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
API-Fehler. |
Common.UserAssignedIdentitiesValue
| Name | Typ | Beschreibung |
|---|---|---|
| clientId |
string |
Die Client-ID der vom Benutzer zugewiesenen Identität. |
| principalId |
string |
Die Prinzipal-ID der vom Benutzer zugewiesenen Identität. |
CommunityGalleryInfo
Informationen zur Community-Galerie, wenn die aktuelle Galerie für die Community freigegeben ist
| Name | Typ | Beschreibung |
|---|---|---|
| communityGalleryEnabled |
boolean |
Enthält Informationen darüber, ob die Freigabe von Community-Galerien aktiviert ist. |
| eula |
string |
Lizenzvertrag für Endbenutzer für community gallery image. |
| publicNamePrefix |
string |
Das Präfix des Katalognamens, der öffentlich angezeigt wird. Für alle Benutzer sichtbar. |
| publicNames |
string[] |
Liste der öffentlichen Namen der Community-Galerie. |
| publisherContact |
string |
Support-E-Mail für den Herausgeber der Community-Galerie. Die E-Mail-Adresse des Herausgebers. Für alle Benutzer sichtbar. |
| publisherUri |
string |
Der Link zur Herausgeberwebsite. Für alle Benutzer sichtbar. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
| Wert | Beschreibung |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
Gallery
Gibt Informationen über die Shared Image Gallery an, die Sie erstellen oder aktualisieren möchten.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| identity |
Die Identität des Katalogs, falls konfiguriert. |
|
| location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
| name |
string |
Der Name der Ressource |
| properties.description |
string |
Die Beschreibung dieser Ressource für freigegebene Bildergalerie. Diese Eigenschaft ist aktualisierbar. |
| properties.identifier |
Beschreibt den eindeutigen Namen des Katalogs. |
|
| properties.provisioningState |
Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird. |
|
| properties.sharingProfile |
Profil für die Katalogfreigabe für Abonnement oder Mandant |
|
| properties.sharingStatus |
Freigabestatus der aktuellen Galerie. |
|
| properties.softDeletePolicy |
Enthält Informationen zur Richtlinie für das vorläufige Löschen des Katalogs. |
|
| systemData |
Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen. |
|
| tags |
object |
Ressourcentags. |
| type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
GalleryIdentifier
Beschreibt den eindeutigen Namen des Katalogs.
| Name | Typ | Beschreibung |
|---|---|---|
| uniqueName |
string |
Der eindeutige Name des freigegebenen Bildkatalogs. Dieser Name wird von Azure automatisch generiert. |
GalleryIdentity
Identität für den virtuellen Computer.
| Name | Typ | Beschreibung |
|---|---|---|
| principalId |
string |
Die Haupt-ID der Galerieidentität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt. |
| tenantId |
string |
Die AAD-Mandanten-ID der Katalogidentität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt. |
| type |
Der Identitätstyp, der für den Katalog verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Katalog. |
|
| userAssignedIdentities |
<string,
Common. |
Die Liste der Benutzeridentitäten, die dem Katalog zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
GalleryProvisioningState
Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.
| Wert | Beschreibung |
|---|---|
| Creating | |
| Updating | |
| Failed | |
| Succeeded | |
| Deleting | |
| Migrating |
GallerySharingPermissionTypes
Mit dieser Eigenschaft können Sie die Berechtigung des Freigabekatalogs angeben. Mögliche Werte sind: Private,Gruppen,Community.
| Wert | Beschreibung |
|---|---|
| Private | |
| Groups | |
| Community |
InnerError
Innere Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| errordetail |
string |
Die interne Fehlermeldung oder der Ausnahmedump. |
| exceptiontype |
string |
Der Ausnahmetyp. |
RegionalSharingStatus
Regionaler Freigabestatus der Galerie
| Name | Typ | Beschreibung |
|---|---|---|
| details |
string |
Details zum Fehler bei der regionalen Freigabe von Galerien. |
| region |
string |
Regionsname |
| state |
Status der Katalogfreigabe in der aktuellen Region |
ResourceIdentityType
Der Identitätstyp, der für den Katalog verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Katalog.
| Wert | Beschreibung |
|---|---|
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned, UserAssigned | |
| None |
SharingProfile
Profil für die Katalogfreigabe für Abonnement oder Mandant
| Name | Typ | Beschreibung |
|---|---|---|
| communityGalleryInfo |
Informationen des Communitykatalogs, wenn der aktuelle Katalog für die Community freigegeben wird. |
|
| groups |
Eine Liste von Freigabeprofilgruppen. |
|
| permissions |
Mit dieser Eigenschaft können Sie die Berechtigung des Freigabekatalogs angeben. Mögliche Werte sind: Private,Gruppen,Community. |
SharingProfileGroup
Gruppe des Galerie-Sharing-Profils
| Name | Typ | Beschreibung |
|---|---|---|
| ids |
string[] |
Eine Liste der Abonnement-/Mandanten-IDs, für die der Katalog freigegeben werden soll. |
| type |
Mit dieser Eigenschaft können Sie den Typ der Freigabegruppe angeben. Mögliche Werte sind: Subscriptions,AADTenants. |
SharingProfileGroupTypes
Mit dieser Eigenschaft können Sie den Typ der Freigabegruppe angeben. Mögliche Werte sind: Subscriptions,AADTenants.
| Wert | Beschreibung |
|---|---|
| Subscriptions | |
| AADTenants |
SharingState
Der Freigabestatus der Galerie, der nur in der Antwort angezeigt wird.
| Wert | Beschreibung |
|---|---|
| Succeeded | |
| InProgress | |
| Failed | |
| Unknown |
SharingStatus
Freigabestatus der aktuellen Galerie.
| Name | Typ | Beschreibung |
|---|---|---|
| aggregatedState |
Aggregierter Freigabestatus der aktuellen Galerie. |
|
| summary |
Zusammenfassung des Status aller regionalen Freigaben. |
SoftDeletePolicy
Enthält Informationen zur Richtlinie für das vorläufige Löschen des Katalogs.
| Name | Typ | Beschreibung |
|---|---|---|
| isSoftDeleteEnabled |
boolean |
Ermöglicht das vorläufige Löschen von Ressourcen in diesem Katalog, sodass sie innerhalb der Aufbewahrungszeit wiederhergestellt werden können. |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
| Name | Typ | Beschreibung |
|---|---|---|
| createdAt |
string (date-time) |
Der Zeitstempel der Ressourcenerstellung (UTC). |
| createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
| createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
| lastModifiedAt |
string (date-time) |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
| lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
| lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |