Shared Gallery Images - Get
Obtenga una imagen de galería compartida por identificador de suscripción o identificador de inquilino.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}?api-version=2023-07-03
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
gallery
|
path | True |
string |
Nombre de la definición de imagen de la Galería compartida desde la que se mostrarán las versiones de imagen. |
gallery
|
path | True |
string |
Nombre único de la Galería compartida. |
location
|
path | True |
string |
Ubicación del recurso |
subscription
|
path | True |
string |
Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio. |
api-version
|
query | True |
string |
Versión de api de cliente. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
Get a shared gallery image.
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/myLocation/sharedGalleries/galleryUniqueName/images/myGalleryImageName?api-version=2023-07-03
Sample Response
{
"properties": {
"osType": "Windows",
"osState": "Generalized",
"hyperVGeneration": "V1",
"identifier": {
"publisher": "myPublisherName",
"offer": "myOfferName",
"sku": "mySkuName"
},
"eula": "https://www.microsoft.com/en-us/",
"artifactTags": {
"ShareTag-Official1PGallery": "Official1PGallery"
}
},
"location": "myLocation",
"name": "myGalleryImageName",
"identifier": {
"uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName"
}
}
Definiciones
Nombre | Description |
---|---|
Api |
Error de API. |
Api |
Base de errores de API. |
Architecture |
La arquitectura de la imagen. Solo se aplica a los discos del sistema operativo. |
Cloud |
Respuesta de error del servicio Compute. |
Disallowed |
Describe los tipos de disco no permitidos. |
Gallery |
Una característica para la imagen de la galería. |
Gallery |
Este es el identificador de definición de imagen de la galería. |
Hyper |
Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo. |
Image |
Describe el plan de compra de la definición de imagen de la galería. Las imágenes de Marketplace lo usan. |
Inner |
Detalles del error interno. |
Operating |
Esta propiedad permite al usuario especificar si las máquinas virtuales creadas en esta imagen son "Generalizadas" o "Especializadas". |
Operating |
Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco al crear una máquina virtual a partir de una imagen administrada. Los valores posibles son: Windows,Linux. |
Recommended |
Las propiedades describen la configuración de máquina recomendada para esta definición de imagen. Estas propiedades son actualizables. |
Resource |
Describe el intervalo de recursos. |
Shared |
Especifica información sobre la definición de imagen de la galería que desea crear o actualizar. |
ApiError
Error de API.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error. |
details |
Detalles del error de api |
|
innererror |
Error interno de api |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error concreto. |
ApiErrorBase
Base de errores de API.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error. |
message |
string |
El mensaje de error. |
target |
string |
Destino del error concreto. |
Architecture
La arquitectura de la imagen. Solo se aplica a los discos del sistema operativo.
Nombre | Tipo | Description |
---|---|---|
Arm64 |
string |
|
x64 |
string |
CloudError
Respuesta de error del servicio Compute.
Nombre | Tipo | Description |
---|---|---|
error |
Error de API. |
Disallowed
Describe los tipos de disco no permitidos.
Nombre | Tipo | Description |
---|---|---|
diskTypes |
string[] |
Lista de tipos de disco. |
GalleryImageFeature
Una característica para la imagen de la galería.
Nombre | Tipo | Description |
---|---|---|
name |
string |
Nombre de la característica de imagen de la galería. |
value |
string |
Valor de la característica de imagen de la galería. |
GalleryImageIdentifier
Este es el identificador de definición de imagen de la galería.
Nombre | Tipo | Description |
---|---|---|
offer |
string |
Nombre de la oferta de definición de imagen de la galería. |
publisher |
string |
Nombre del publicador de definiciones de imágenes de la galería. |
sku |
string |
Nombre de la SKU de definición de imagen de la galería. |
HyperVGeneration
Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.
Nombre | Tipo | Description |
---|---|---|
V1 |
string |
|
V2 |
string |
ImagePurchasePlan
Describe el plan de compra de la definición de imagen de la galería. Las imágenes de Marketplace lo usan.
Nombre | Tipo | Description |
---|---|---|
name |
string |
Identificador del plan. |
product |
string |
Id. de producto. |
publisher |
string |
Identificador del publicador. |
InnerError
Detalles del error interno.
Nombre | Tipo | Description |
---|---|---|
errordetail |
string |
Mensaje de error interno o volcado de memoria de excepciones. |
exceptiontype |
string |
Tipo de la excepción. |
OperatingSystemStateTypes
Esta propiedad permite al usuario especificar si las máquinas virtuales creadas en esta imagen son "Generalizadas" o "Especializadas".
Nombre | Tipo | Description |
---|---|---|
Generalized |
string |
|
Specialized |
string |
OperatingSystemTypes
Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco al crear una máquina virtual a partir de una imagen administrada. Los valores posibles son: Windows,Linux.
Nombre | Tipo | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
RecommendedMachineConfiguration
Las propiedades describen la configuración de máquina recomendada para esta definición de imagen. Estas propiedades son actualizables.
Nombre | Tipo | Description |
---|---|---|
memory |
Describe el intervalo de recursos. |
|
vCPUs |
Describe el intervalo de recursos. |
ResourceRange
Describe el intervalo de recursos.
Nombre | Tipo | Description |
---|---|---|
max |
integer |
Número máximo del recurso. |
min |
integer |
Número mínimo del recurso. |
SharedGalleryImage
Especifica información sobre la definición de imagen de la galería que desea crear o actualizar.
Nombre | Tipo | Description |
---|---|---|
identifier.uniqueId |
string |
Identificador único de esta galería compartida. |
location |
string |
Ubicación de los recursos |
name |
string |
Nombre del recurso |
properties.architecture |
La arquitectura de la imagen. Solo se aplica a los discos del sistema operativo. |
|
properties.artifactTags |
object |
Etiquetas de artefacto de un recurso de la galería compartida. |
properties.disallowed |
Describe los tipos de disco no permitidos. |
|
properties.endOfLifeDate |
string |
Fecha de finalización del ciclo de vida de la definición de la imagen de la galería. Esta propiedad se puede usar con fines de retirada. Esta propiedad es actualizable. |
properties.eula |
string |
Contrato de licencia de usuario final para la imagen actual de la galería de la comunidad. |
properties.features |
Una lista de características de imagen de la galería. |
|
properties.hyperVGeneration |
Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo. |
|
properties.identifier |
Este es el identificador de definición de imagen de la galería. |
|
properties.osState |
Esta propiedad permite al usuario especificar si las máquinas virtuales creadas en esta imagen son "Generalizadas" o "Especializadas". |
|
properties.osType |
Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco al crear una máquina virtual a partir de una imagen administrada. Los valores posibles son: Windows,Linux. |
|
properties.privacyStatementUri |
string |
URI de declaración de privacidad para la imagen actual de la galería de la comunidad. |
properties.purchasePlan |
Describe el plan de compra de la definición de imagen de la galería. Las imágenes de Marketplace lo usan. |
|
properties.recommended |
Las propiedades describen la configuración de máquina recomendada para esta definición de imagen. Estas propiedades son actualizables. |