Galleries - Create Or Update
Crea o aggiorna una galleria di immagini condivise.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}?api-version=2024-03-03
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
gallery
|
path | True |
string pattern: ^[^_\W][\w-._]{0,79}(? |
Il nome della galleria di immagini condivise. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
subscription
|
path | True |
string minLength: 1 |
ID della sottoscrizione di destinazione. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| location | True |
string |
Posizione geografica in cui risiede la risorsa |
| identity |
Identità della raccolta, se configurata. |
||
| properties.description |
string |
Descrizione della risorsa raccolta immagini condivise. Questa proprietà è aggiornabile. |
|
| properties.identifier |
Descrive il nome univoco della raccolta. |
||
| properties.sharingProfile |
Profilo per la condivisione della raccolta nella sottoscrizione o nel tenant |
||
| properties.softDeletePolicy |
Contiene informazioni sui criteri di eliminazione temporanea della raccolta. |
||
| tags |
object |
Tag di risorsa. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
L'operazione di aggiornamento della risorsa 'Gallery' è riuscita |
|
| 201 Created |
Operazione di creazione della risorsa 'Gallery' riuscita Intestazioni
|
|
| 202 Accepted |
La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è ancora stata completata. Intestazioni
|
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
Create a community gallery.
Esempio di richiesta
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"
}
}
}
}
Risposta di esempio
{
"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.
Esempio di richiesta
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"
}
}
}
Risposta di esempio
{
"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.
Esempio di richiesta
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
}
}
}
Risposta di esempio
{
"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.
Esempio di richiesta
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."
}
}
Risposta di esempio
{
"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.
Esempio di richiesta
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."
}
}
Risposta di esempio
{
"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"
}
Definizioni
| Nome | Descrizione |
|---|---|
|
Api |
Errore API. |
|
Api |
Base di errore API. |
|
Cloud |
Risposta di errore dal servizio di calcolo. |
|
Common. |
|
|
Community |
Informazioni sulla galleria della comunità se la galleria corrente è condivisa con la comunità |
|
created |
Tipo di identità che ha creato la risorsa. |
| Gallery |
Specifica le informazioni sulla raccolta di immagini condivise che si desidera creare o aggiornare. |
|
Gallery |
Descrive il nome univoco della raccolta. |
|
Gallery |
Identità per la macchina virtuale. |
|
Gallery |
Stato di provisioning, visualizzato solo nella risposta. |
|
Gallery |
Questa proprietà consente di specificare l'autorizzazione della raccolta di condivisione. I valori possibili sono: Gruppiprivati,Community. |
|
Inner |
Dettagli dell'errore interno. |
|
Regional |
Stato di condivisione regionale della galleria |
|
Resource |
Tipo di identità usata per la raccolta. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dalla raccolta. |
|
Sharing |
Profilo per la condivisione della raccolta nella sottoscrizione o nel tenant |
|
Sharing |
Gruppo del profilo di condivisione della galleria |
|
Sharing |
Questa proprietà consente di specificare il tipo di gruppo di condivisione. I valori possibili sono: Subscriptions,AADTenants. |
|
Sharing |
Stato di condivisione della galleria, che viene visualizzato solo nella risposta. |
|
Sharing |
Stato di condivisione della galleria corrente. |
|
Soft |
Contiene informazioni sui criteri di eliminazione temporanea della raccolta. |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
ApiError
Errore API.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore Api |
|
| innererror |
L'errore interno dell'API |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore specifico. |
ApiErrorBase
Base di errore API.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Codice di errore. |
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore specifico. |
CloudError
Risposta di errore dal servizio di calcolo.
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Errore API. |
Common.UserAssignedIdentitiesValue
| Nome | Tipo | Descrizione |
|---|---|---|
| clientId |
string |
ID client dell'identità assegnata dall'utente. |
| principalId |
string |
ID principale dell'identità assegnata dall'utente. |
CommunityGalleryInfo
Informazioni sulla galleria della comunità se la galleria corrente è condivisa con la comunità
| Nome | Tipo | Descrizione |
|---|---|---|
| communityGalleryEnabled |
boolean |
Contiene informazioni sull'abilitazione della condivisione della galleria della community. |
| eula |
string |
Contratto di licenza dell'utente finale per l'immagine della raccolta community. |
| publicNamePrefix |
string |
Prefisso del nome della raccolta che verrà visualizzato pubblicamente. Visibile a tutti gli utenti. |
| publicNames |
string[] |
Elenco dei nomi pubblici della galleria della comunità. |
| publisherContact |
string |
L'editore della raccolta community supporta la posta elettronica. Indirizzo di posta elettronica dell'editore. Visibile a tutti gli utenti. |
| publisherUri |
string |
Collegamento al sito Web dell'editore. Visibile a tutti gli utenti. |
createdByType
Tipo di identità che ha creato la risorsa.
| Valore | Descrizione |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
Gallery
Specifica le informazioni sulla raccolta di immagini condivise che si desidera creare o aggiornare.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string |
ID risorsa completo per la risorsa. Ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| identity |
Identità della raccolta, se configurata. |
|
| location |
string |
Posizione geografica in cui risiede la risorsa |
| name |
string |
Nome della risorsa |
| properties.description |
string |
Descrizione della risorsa raccolta immagini condivise. Questa proprietà è aggiornabile. |
| properties.identifier |
Descrive il nome univoco della raccolta. |
|
| properties.provisioningState |
Stato di provisioning, visualizzato solo nella risposta. |
|
| properties.sharingProfile |
Profilo per la condivisione della raccolta nella sottoscrizione o nel tenant |
|
| properties.sharingStatus |
Stato di condivisione della galleria corrente. |
|
| properties.softDeletePolicy |
Contiene informazioni sui criteri di eliminazione temporanea della raccolta. |
|
| systemData |
Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy. |
|
| tags |
object |
Tag di risorsa. |
| type |
string |
Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
GalleryIdentifier
Descrive il nome univoco della raccolta.
| Nome | Tipo | Descrizione |
|---|---|---|
| uniqueName |
string |
Nome univoco della raccolta immagini condivise. Questo nome viene generato automaticamente da Azure. |
GalleryIdentity
Identità per la macchina virtuale.
| Nome | Tipo | Descrizione |
|---|---|---|
| principalId |
string |
L'ID principale dell'identità della galleria. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema. |
| tenantId |
string |
ID tenant AAD dell'identità della raccolta. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema. |
| type |
Tipo di identità usata per la raccolta. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dalla raccolta. |
|
| userAssignedIdentities |
<string,
Common. |
Elenco di identità utente associate alla raccolta. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
GalleryProvisioningState
Stato di provisioning, visualizzato solo nella risposta.
| Valore | Descrizione |
|---|---|
| Creating | |
| Updating | |
| Failed | |
| Succeeded | |
| Deleting | |
| Migrating |
GallerySharingPermissionTypes
Questa proprietà consente di specificare l'autorizzazione della raccolta di condivisione. I valori possibili sono: Gruppiprivati,Community.
| Valore | Descrizione |
|---|---|
| Private | |
| Groups | |
| Community |
InnerError
Dettagli dell'errore interno.
| Nome | Tipo | Descrizione |
|---|---|---|
| errordetail |
string |
Messaggio di errore interno o dump di eccezione. |
| exceptiontype |
string |
Tipo di eccezione. |
RegionalSharingStatus
Stato di condivisione regionale della galleria
| Nome | Tipo | Descrizione |
|---|---|---|
| details |
string |
Dettagli dell'errore di condivisione a livello di area della galleria. |
| region |
string |
Nome della regione |
| state |
Stato di condivisione della galleria nell'area corrente |
ResourceIdentityType
Tipo di identità usata per la raccolta. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dalla raccolta.
| Valore | Descrizione |
|---|---|
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned, UserAssigned | |
| None |
SharingProfile
Profilo per la condivisione della raccolta nella sottoscrizione o nel tenant
| Nome | Tipo | Descrizione |
|---|---|---|
| communityGalleryInfo |
Informazioni della raccolta della community se la raccolta corrente è condivisa nella community. |
|
| groups |
Un elenco di gruppi di profili di condivisione. |
|
| permissions |
Questa proprietà consente di specificare l'autorizzazione della raccolta di condivisione. I valori possibili sono: Gruppiprivati,Community. |
SharingProfileGroup
Gruppo del profilo di condivisione della galleria
| Nome | Tipo | Descrizione |
|---|---|---|
| ids |
string[] |
Un elenco di ID sottoscrizione/tenant con cui si desidera condividere la raccolta. |
| type |
Questa proprietà consente di specificare il tipo di gruppo di condivisione. I valori possibili sono: Subscriptions,AADTenants. |
SharingProfileGroupTypes
Questa proprietà consente di specificare il tipo di gruppo di condivisione. I valori possibili sono: Subscriptions,AADTenants.
| Valore | Descrizione |
|---|---|
| Subscriptions | |
| AADTenants |
SharingState
Stato di condivisione della galleria, che viene visualizzato solo nella risposta.
| Valore | Descrizione |
|---|---|
| Succeeded | |
| InProgress | |
| Failed | |
| Unknown |
SharingStatus
Stato di condivisione della galleria corrente.
| Nome | Tipo | Descrizione |
|---|---|---|
| aggregatedState |
Stato di condivisione aggregato della raccolta corrente. |
|
| summary |
Riepilogo di tutti gli stati di condivisione a livello di area. |
SoftDeletePolicy
Contiene informazioni sui criteri di eliminazione temporanea della raccolta.
| Nome | Tipo | Descrizione |
|---|---|---|
| isSoftDeleteEnabled |
boolean |
Abilita l'eliminazione temporanea per le risorse in questa raccolta, consentendo di recuperarle entro il tempo di conservazione. |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
| createdBy |
string |
Identità che ha creato la risorsa. |
| createdByType |
Tipo di identità che ha creato la risorsa. |
|
| lastModifiedAt |
string (date-time) |
Timestamp dell'ultima modifica della risorsa (UTC) |
| lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
| lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |