Udostępnij za pośrednictwem


Galleries - Create Or Update

Utwórz lub zaktualizuj galerię obrazów udostępnionych.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}?api-version=2024-03-03

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
galleryName
path True

string

Nazwa galerii obrazów udostępnionych. Dozwolone znaki to alfabety i liczby z kropkami i kropkami dozwolonymi w środku. Maksymalna długość to 80 znaków.

resourceGroupName
path True

string

Nazwa grupy zasobów.

subscriptionId
path True

string

Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

api-version
query True

string

Wersja interfejsu API klienta.

Treść żądania

Nazwa Wymagane Typ Opis
location True

string

Lokalizacja zasobu

identity

GalleryIdentity

Tożsamość galerii, jeśli została skonfigurowana.

properties.description

string

Opis tego zasobu galerii obrazów udostępnionych. Ta właściwość jest aktualizowalna.

properties.identifier

GalleryIdentifier

Opisuje unikatową nazwę galerii.

properties.sharingProfile

SharingProfile

Profil udostępniania galerii w subskrypcji lub dzierżawie

properties.softDeletePolicy

SoftDeletePolicy

Zawiera informacje o zasadach usuwania nietrwałego galerii.

tags

object

Tagi zasobów

Odpowiedzi

Nazwa Typ Opis
200 OK

Gallery

OK

201 Created

Gallery

Utworzono

202 Accepted

Gallery

Akceptowane

Other Status Codes

CloudError

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Create a community gallery.
Create or update a simple gallery with sharing profile.
Create or update a simple gallery with soft deletion enabled.
Create or update a simple gallery with system-assigned and user-assigned managed identities.
Create or update a simple gallery.

Create a community gallery.

Przykładowe żądanie

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"
      }
    }
  }
}

Przykładowa odpowiedź

{
  "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"
}

Przykładowe żądanie

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"
    }
  }
}

Przykładowa odpowiedź

{
  "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"
}

Przykładowe żądanie

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
    }
  }
}

Przykładowa odpowiedź

{
  "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"
}

Przykładowe żądanie

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."
  }
}

Przykładowa odpowiedź

{
  "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.

Przykładowe żądanie

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."
  }
}

Przykładowa odpowiedź

{
  "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"
}

Definicje

Nazwa Opis
ApiError

Błąd interfejsu API.

ApiErrorBase

Baza błędów interfejsu API.

CloudError

Odpowiedź na błąd z usługi Obliczeniowej.

CommunityGalleryInfo

Informacje o galerii społeczności, jeśli bieżąca galeria jest udostępniana społeczności

Gallery

Określa informacje o galerii obrazów udostępnionych, które chcesz utworzyć lub zaktualizować.

GalleryIdentifier

Opisuje unikatową nazwę galerii.

GalleryIdentity

Tożsamość maszyny wirtualnej.

GalleryProvisioningState

Bieżący stan galerii lub artefaktu galerii.

GallerySharingPermissionTypes

Ta właściwość umożliwia określenie uprawnień do udostępniania galerii. Możliwe wartości to: Prywatne, grupyCommunity.

InnerError

Szczegóły błędu wewnętrznego.

RegionalSharingStatus

Stan udostępniania regionalnego galerii

ResourceIdentityType

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.

SharingProfile

Profil udostępniania galerii w subskrypcji lub dzierżawie

SharingProfileGroup

Grupa profilu udostępniania galerii

SharingProfileGroupTypes

Ta właściwość umożliwia określenie typu grupy udostępniania. Możliwe wartości to: Subskrypcje,AADTenants.

SharingState

Stan udostępniania galerii.

SharingStatus

Stan udostępniania bieżącej galerii.

SoftDeletePolicy

Zawiera informacje o zasadach usuwania nietrwałego galerii.

UserAssignedIdentities

Lista tożsamości użytkowników skojarzonych z maszyną wirtualną. 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}".

ApiError

Błąd interfejsu API.

Nazwa Typ Opis
code

string

Kod błędu.

details

ApiErrorBase[]

Szczegóły błędu interfejsu API

innererror

InnerError

Błąd wewnętrzny interfejsu API

message

string

Komunikat o błędzie.

target

string

Element docelowy określonego błędu.

ApiErrorBase

Baza błędów interfejsu API.

Nazwa Typ Opis
code

string

Kod błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy określonego błędu.

CloudError

Odpowiedź na błąd z usługi Obliczeniowej.

Nazwa Typ Opis
error

ApiError

Błąd interfejsu API.

CommunityGalleryInfo

Informacje o galerii społeczności, jeśli bieżąca galeria jest udostępniana społeczności

Nazwa Typ Opis
communityGalleryEnabled

boolean

Zawiera informacje o tym, czy udostępnianie galerii społeczności jest włączone.

eula

string

Umowa licencyjna użytkownika końcowego dotycząca obrazu galerii społeczności.

publicNamePrefix

string

Prefiks nazwy galerii, który będzie wyświetlany publicznie. Widoczne dla wszystkich użytkowników.

publicNames

string[]

Lista nazw publicznych galerii społeczności.

publisherContact

string

Wiadomość e-mail dotycząca wydawcy galerii społeczności. Adres e-mail wydawcy. Widoczne dla wszystkich użytkowników.

publisherUri

string

Link do witryny sieci Web wydawcy. Widoczne dla wszystkich użytkowników.

Określa informacje o galerii obrazów udostępnionych, które chcesz utworzyć lub zaktualizować.

Nazwa Typ Opis
id

string

Identyfikator zasobu

identity

GalleryIdentity

Tożsamość galerii, jeśli została skonfigurowana.

location

string

Lokalizacja zasobu

name

string

Nazwa zasobu

properties.description

string

Opis tego zasobu galerii obrazów udostępnionych. Ta właściwość jest aktualizowalna.

properties.identifier

GalleryIdentifier

Opisuje unikatową nazwę galerii.

properties.provisioningState

GalleryProvisioningState

Bieżący stan galerii lub artefaktu galerii.
Stan aprowizacji, który pojawia się tylko w odpowiedzi.

properties.sharingProfile

SharingProfile

Profil udostępniania galerii w subskrypcji lub dzierżawie

properties.sharingStatus

SharingStatus

Stan udostępniania bieżącej galerii.

properties.softDeletePolicy

SoftDeletePolicy

Zawiera informacje o zasadach usuwania nietrwałego galerii.

tags

object

Tagi zasobów

type

string

Typ zasobu

GalleryIdentifier

Opisuje unikatową nazwę galerii.

Nazwa Typ Opis
uniqueName

string

Unikatowa nazwa galerii obrazów udostępnionych. Ta nazwa jest generowana automatycznie przez platformę Azure.

GalleryIdentity

Tożsamość maszyny wirtualnej.

Nazwa Typ Opis
principalId

string

Identyfikator podmiotu zabezpieczeń tożsamości galerii. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.

tenantId

string

Identyfikator dzierżawy usługi AAD tożsamości galerii. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.

type

ResourceIdentityType

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.

userAssignedIdentities

UserAssignedIdentities

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}".

GalleryProvisioningState

Bieżący stan galerii lub artefaktu galerii.

Nazwa Typ Opis
Creating

string

Deleting

string

Failed

string

Migrating

string

Succeeded

string

Updating

string

GallerySharingPermissionTypes

Ta właściwość umożliwia określenie uprawnień do udostępniania galerii. Możliwe wartości to: Prywatne, grupyCommunity.

Nazwa Typ Opis
Community

string

Groups

string

Private

string

InnerError

Szczegóły błędu wewnętrznego.

Nazwa Typ Opis
errordetail

string

Wewnętrzny komunikat o błędzie lub zrzut wyjątku.

exceptiontype

string

Typ wyjątku.

RegionalSharingStatus

Stan udostępniania regionalnego galerii

Nazwa Typ Opis
details

string

Szczegóły niepowodzenia udostępniania regionalnego galerii.

region

string

Nazwa regionu

state

SharingState

Stan udostępniania galerii.
Stan udostępniania galerii w bieżącym regionie

ResourceIdentityType

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.

Nazwa Typ Opis
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

SharingProfile

Profil udostępniania galerii w subskrypcji lub dzierżawie

Nazwa Typ Opis
communityGalleryInfo

CommunityGalleryInfo

Informacje o galerii społeczności, jeśli bieżąca galeria jest udostępniana społeczności.

groups

SharingProfileGroup[]

Lista grup profilów udostępniania.

permissions

GallerySharingPermissionTypes

Ta właściwość umożliwia określenie uprawnień do udostępniania galerii. Możliwe wartości to: Prywatne, grupyCommunity.

SharingProfileGroup

Grupa profilu udostępniania galerii

Nazwa Typ Opis
ids

string[]

Lista identyfikatorów subskrypcji/dzierżawy, do której ma być udostępniona galeria.

type

SharingProfileGroupTypes

Ta właściwość umożliwia określenie typu grupy udostępniania. Możliwe wartości to: Subskrypcje,AADTenants.

SharingProfileGroupTypes

Ta właściwość umożliwia określenie typu grupy udostępniania. Możliwe wartości to: Subskrypcje,AADTenants.

Nazwa Typ Opis
AADTenants

string

Subscriptions

string

SharingState

Stan udostępniania galerii.

Nazwa Typ Opis
Failed

string

InProgress

string

Succeeded

string

Unknown

string

SharingStatus

Stan udostępniania bieżącej galerii.

Nazwa Typ Opis
aggregatedState

SharingState

Stan udostępniania galerii.
Zagregowany stan udostępniania bieżącej galerii.

summary

RegionalSharingStatus[]

Podsumowanie wszystkich stanu udostępniania regionalnego.

SoftDeletePolicy

Zawiera informacje o zasadach usuwania nietrwałego galerii.

Nazwa Typ Opis
isSoftDeleteEnabled

boolean

Umożliwia usuwanie nietrwałe zasobów w tej galerii, co umożliwia ich odzyskanie w czasie przechowywania.

UserAssignedIdentities

Lista tożsamości użytkowników skojarzonych z maszyną wirtualną. 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}".

Nazwa Typ Opis