Condividi tramite


Marketplace Gallery Images - Get

Ottiene un'immagine della raccolta del marketplace

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/marketplaceGalleryImages/{marketplaceGalleryImageName}?api-version=2024-01-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
marketplaceGalleryImageName
path True

string

Nome dell'immagine della raccolta del marketplace

Criterio di espressione regolare: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[a-zA-Z0-9]$

resourceGroupName
path True

string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

subscriptionId
path True

string

ID della sottoscrizione di destinazione.

api-version
query True

string

Versione dell'API da usare per questa operazione.

Risposte

Nome Tipo Descrizione
200 OK

MarketplaceGalleryImages

OK

Other Status Codes

ErrorResponse

Risposta di errore che descrive perché l'operazione non è riuscita.

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

GetMarketplaceGalleryImage

Esempio di richiesta

GET https://management.azure.com/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/marketplaceGalleryImages/test-marketplace-gallery-image?api-version=2024-01-01

Risposta di esempio

{
  "id": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/marketplaceGalleryImages/test-marketplace-gallery-image",
  "name": "test-marketplace-gallery-image",
  "type": "Microsoft.AzureStackHCI/marketplaceGalleryImages",
  "location": "West US2",
  "extendedLocation": {
    "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
    "type": "CustomLocation"
  },
  "properties": {
    "provisioningState": "Accepted",
    "containerId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storageContainers/test-storage-container",
    "osType": "Windows",
    "cloudInitDataSource": "NoCloud",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "version": {
      "name": "1.0.0",
      "properties": {
        "storageProfile": {
          "osDiskImage": {
            "sizeInMB": 30270
          }
        }
      }
    },
    "status": {
      "provisioningStatus": {
        "operationId": "79cfc696-44f5-4a68-a620-21850f7e9fb0",
        "status": "Succeeded"
      },
      "progressPercentage": 100,
      "downloadStatus": {
        "downloadSizeInMB": 9383
      }
    }
  }
}

Definizioni

Nome Descrizione
CloudInitDataSource

Origine dati per l'immagine della raccolta durante il provisioning con cloud-init [NoCloud, Azure]

createdByType

Tipo di identità che ha creato la risorsa.

DownloadStatus

Stato di download dell'immagine della raccolta

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

ExtendedLocation

Tipo complesso della posizione estesa.

ExtendedLocationTypes

Tipo della posizione estesa.

GalleryImageIdentifier

Si tratta dell'identificatore di definizione dell'immagine della raccolta.

GalleryImageVersion

Specifica informazioni sulla versione dell'immagine della raccolta da creare o aggiornare.

GalleryImageVersionStorageProfile

Si tratta del profilo di archiviazione di una versione dell'immagine della raccolta.

GalleryOSDiskImage

Si tratta dell'immagine del disco del sistema operativo.

HyperVGeneration

Generazione di hypervisor della macchina virtuale [V1, V2]

MarketplaceGalleryImages

Definizione della risorsa delle risorse della raccolta del marketplace.

OperatingSystemTypes

Tipo di sistema operativo usato dall'immagine della raccolta [Windows, Linux]

ProvisioningStateEnum

Stato di provisioning dell'immagine della raccolta del marketplace.

ProvisioningStatus
Status

Stato dell'operazione eseguita sull'immagine della raccolta [Successed, Failed, InProgress]

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

CloudInitDataSource

Origine dati per l'immagine della raccolta durante il provisioning con cloud-init [NoCloud, Azure]

Nome Tipo Descrizione
Azure

string

NoCloud

string

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

DownloadStatus

Stato di download dell'immagine della raccolta

Nome Tipo Descrizione
downloadSizeInMB

integer

Dimensioni scaricate dell'immagine in MB

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

ExtendedLocation

Tipo complesso della posizione estesa.

Nome Tipo Descrizione
name

string

Nome della posizione estesa.

type

ExtendedLocationTypes

Tipo della posizione estesa.

ExtendedLocationTypes

Tipo della posizione estesa.

Nome Tipo Descrizione
CustomLocation

string

GalleryImageIdentifier

Si tratta dell'identificatore di definizione dell'immagine della raccolta.

Nome Tipo Descrizione
offer

string

Nome dell'offerta di definizione dell'immagine della raccolta.

publisher

string

Nome dell'editore di definizione dell'immagine della raccolta.

sku

string

Nome dello SKU di definizione dell'immagine della raccolta.

GalleryImageVersion

Specifica informazioni sulla versione dell'immagine della raccolta da creare o aggiornare.

Nome Tipo Descrizione
name

string

Questa è la versione dell'immagine della raccolta.

properties.storageProfile

GalleryImageVersionStorageProfile

Si tratta del profilo di archiviazione di una versione dell'immagine della raccolta.

GalleryImageVersionStorageProfile

Si tratta del profilo di archiviazione di una versione dell'immagine della raccolta.

Nome Tipo Descrizione
osDiskImage

GalleryOSDiskImage

Si tratta dell'immagine del disco del sistema operativo.

GalleryOSDiskImage

Si tratta dell'immagine del disco del sistema operativo.

Nome Tipo Descrizione
sizeInMB

integer

Questa proprietà indica la dimensione del disco rigido virtuale da creare.

HyperVGeneration

Generazione di hypervisor della macchina virtuale [V1, V2]

Nome Tipo Descrizione
V1

string

V2

string

MarketplaceGalleryImages

Definizione della risorsa delle risorse della raccolta del marketplace.

Nome Tipo Descrizione
extendedLocation

ExtendedLocation

EstensioneLocation della risorsa.

id

string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Posizione geografica in cui vive la risorsa

name

string

nome della risorsa.

properties.cloudInitDataSource

CloudInitDataSource

Origine dati per l'immagine della raccolta durante il provisioning con cloud-init [NoCloud, Azure]

properties.containerId

string

Contenitore di archiviazione del contenitore di archiviazione da usare per l'immagine della raccolta del marketplace

properties.hyperVGeneration

HyperVGeneration

Generazione di hypervisor della macchina virtuale [V1, V2]

properties.identifier

GalleryImageIdentifier

Si tratta dell'identificatore di definizione dell'immagine della raccolta.

properties.osType

OperatingSystemTypes

Tipo di sistema operativo usato dall'immagine della raccolta [Windows, Linux]

properties.provisioningState

ProvisioningStateEnum

Stato di provisioning dell'immagine della raccolta del marketplace.

properties.status.downloadStatus

DownloadStatus

Stato di download dell'immagine della raccolta

properties.status.errorCode

string

Codice di errore del provisioning marketplaceGalleryImage

properties.status.errorMessage

string

Messaggio di errore descrittivo

properties.status.progressPercentage

integer

Stato dell'operazione in percentuale

properties.status.provisioningStatus

ProvisioningStatus

properties.version

GalleryImageVersion

Specifica informazioni sulla versione dell'immagine della raccolta da creare o aggiornare.

systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createBy e modificateBy.

tags

object

Tag di risorse.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

OperatingSystemTypes

Tipo di sistema operativo usato dall'immagine della raccolta [Windows, Linux]

Nome Tipo Descrizione
Linux

string

Windows

string

ProvisioningStateEnum

Stato di provisioning dell'immagine della raccolta del marketplace.

Nome Tipo Descrizione
Accepted

string

Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

ProvisioningStatus

Nome Tipo Descrizione
operationId

string

ID dell'operazione eseguita nell'immagine della raccolta

status

Status

Stato dell'operazione eseguita sull'immagine della raccolta [Successed, Failed, InProgress]

Status

Stato dell'operazione eseguita sull'immagine della raccolta [Successed, Failed, InProgress]

Nome Tipo Descrizione
Failed

string

InProgress

string

Succeeded

string

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima risorsa.