Gallery Images - Create Or Update
Criar ou atualizar uma definição de imagem de galeria.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}?api-version=2023-07-03
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
gallery
|
path | True |
string |
O nome da definição de imagem da galeria a criar ou atualizar. Os carateres permitidos são alfabetos e números com pontos, traços e períodos permitidos no meio. O comprimento máximo é de 80 carateres. |
gallery
|
path | True |
string |
O nome do Shared Image Gallery no qual a Definição de Imagem deve ser criada. |
resource
|
path | True |
string |
O nome do grupo de recursos. |
subscription
|
path | True |
string |
Credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço. |
api-version
|
query | True |
string |
Versão da API de Cliente. |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
location | True |
string |
Localização do recurso |
properties.identifier | True |
Este é o identificador de definição de imagem da galeria. |
|
properties.osState | True |
Esta propriedade permite ao utilizador especificar se as máquinas virtuais criadas nesta imagem são "Generalizadas" ou "Especializadas". |
|
properties.osType | True |
Esta propriedade permite-lhe especificar o tipo de SO incluído no disco ao criar uma VM a partir de uma imagem gerida. Os valores possíveis são: Windows,Linux. |
|
properties.architecture |
A arquitetura da imagem. Aplicável apenas a discos do SO. |
||
properties.description |
string |
A descrição deste recurso de definição de imagem da galeria. Esta propriedade é atualizável. |
|
properties.disallowed |
Descreve os tipos de disco não permitidos. |
||
properties.endOfLifeDate |
string |
A data de fim de vida da definição da imagem da galeria. Esta propriedade pode ser utilizada para fins de desativação. Esta propriedade é atualizável. |
|
properties.eula |
string |
O contrato Eula para a definição de imagem da galeria. |
|
properties.features |
Uma lista de funcionalidades de imagens da galeria. |
||
properties.hyperVGeneration |
A geração do hipervisor da Máquina Virtual. Aplicável apenas a discos do SO. |
||
properties.privacyStatementUri |
string |
O URI da declaração de privacidade. |
|
properties.purchasePlan |
Descreve o plano de compra da definição de imagem da galeria. Isto é utilizado por imagens do marketplace. |
||
properties.recommended |
As propriedades descrevem a configuração recomendada do computador para esta Definição de Imagem. Estas propriedades são atualizáveis. |
||
properties.releaseNoteUri |
string |
O URI da nota de versão. |
|
tags |
object |
Etiquetas de recursos |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK |
|
201 Created |
Criado |
|
202 Accepted |
Aceite |
|
Other Status Codes |
Resposta de erro que descreve a razão pela qual a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | representar a sua conta de utilizador |
Exemplos
Create or update a simple gallery image.
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName/images/myGalleryImageName?api-version=2023-07-03
{
"location": "West US",
"properties": {
"osType": "Windows",
"osState": "Generalized",
"hyperVGeneration": "V1",
"identifier": {
"publisher": "myPublisherName",
"offer": "myOfferName",
"sku": "mySkuName"
}
}
}
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
"properties": {
"osType": "Windows",
"osState": "Generalized",
"hyperVGeneration": "V1",
"identifier": {
"publisher": "myPublisherName",
"offer": "myOfferName",
"sku": "mySkuName"
},
"provisioningState": "Updating"
},
"location": "West US",
"name": "myGalleryImageName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
"properties": {
"osType": "Windows",
"osState": "Generalized",
"hyperVGeneration": "V1",
"identifier": {
"publisher": "myPublisherName",
"offer": "myOfferName",
"sku": "mySkuName"
},
"provisioningState": "Creating"
},
"location": "West US",
"name": "myGalleryImageName"
}
{
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
"properties": {
"osType": "Windows",
"osState": "Generalized",
"hyperVGeneration": "V1",
"identifier": {
"publisher": "myPublisherName",
"offer": "myOfferName",
"sku": "mySkuName"
},
"provisioningState": "Updating"
},
"location": "West US",
"name": "myGalleryImageName"
}
Definições
Name | Description |
---|---|
Api |
Erro de API. |
Api |
Base de erros da API. |
Architecture |
A arquitetura da imagem. Aplicável apenas a discos do SO. |
Cloud |
Uma resposta de erro do serviço de Computação. |
Disallowed |
Descreve os tipos de disco não permitidos. |
Gallery |
Especifica informações sobre a definição de imagem da galeria que pretende criar ou atualizar. |
Gallery |
Uma funcionalidade para a imagem da galeria. |
Gallery |
Este é o identificador de definição de imagem da galeria. |
Gallery |
O estado atual da galeria ou artefacto da galeria. |
Hyper |
A geração do hipervisor da Máquina Virtual. Aplicável apenas a discos do SO. |
Image |
Descreve o plano de compra da definição de imagem da galeria. Isto é utilizado por imagens do marketplace. |
Inner |
Detalhes do erro interno. |
Operating |
Esta propriedade permite ao utilizador especificar se as máquinas virtuais criadas nesta imagem são "Generalizadas" ou "Especializadas". |
Operating |
Esta propriedade permite-lhe especificar o tipo suportado do SO para o qual a aplicação foi criada. Os valores possíveis são: Windows,Linux. |
Recommended |
As propriedades descrevem a configuração recomendada do computador para esta Definição de Imagem. Estas propriedades são atualizáveis. |
Resource |
Descreve o intervalo de recursos. |
ApiError
Erro de API.
Name | Tipo | Description |
---|---|---|
code |
string |
O código de erro. |
details |
Os detalhes do erro da API |
|
innererror |
O erro interno da API |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro específico. |
ApiErrorBase
Base de erros da API.
Name | Tipo | Description |
---|---|---|
code |
string |
O código de erro. |
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro específico. |
Architecture
A arquitetura da imagem. Aplicável apenas a discos do SO.
Name | Tipo | Description |
---|---|---|
Arm64 |
string |
|
x64 |
string |
CloudError
Uma resposta de erro do serviço de Computação.
Name | Tipo | Description |
---|---|---|
error |
Erro de API. |
Disallowed
Descreve os tipos de disco não permitidos.
Name | Tipo | Description |
---|---|---|
diskTypes |
string[] |
Uma lista de tipos de disco. |
GalleryImage
Especifica informações sobre a definição de imagem da galeria que pretende criar ou atualizar.
Name | Tipo | Description |
---|---|---|
id |
string |
ID do Recurso |
location |
string |
Localização do recurso |
name |
string |
Nome do recurso |
properties.architecture |
A arquitetura da imagem. Aplicável apenas a discos do SO. |
|
properties.description |
string |
A descrição deste recurso de definição de imagem da galeria. Esta propriedade é atualizável. |
properties.disallowed |
Descreve os tipos de disco não permitidos. |
|
properties.endOfLifeDate |
string |
A data de fim de vida da definição da imagem da galeria. Esta propriedade pode ser utilizada para fins de desativação. Esta propriedade é atualizável. |
properties.eula |
string |
O contrato Eula para a definição de imagem da galeria. |
properties.features |
Uma lista de funcionalidades de imagens da galeria. |
|
properties.hyperVGeneration |
A geração do hipervisor da Máquina Virtual. Aplicável apenas a discos do SO. |
|
properties.identifier |
Este é o identificador de definição de imagem da galeria. |
|
properties.osState |
Esta propriedade permite ao utilizador especificar se as máquinas virtuais criadas nesta imagem são "Generalizadas" ou "Especializadas". |
|
properties.osType |
Esta propriedade permite-lhe especificar o tipo de SO incluído no disco ao criar uma VM a partir de uma imagem gerida. Os valores possíveis são: Windows,Linux. |
|
properties.privacyStatementUri |
string |
O URI da declaração de privacidade. |
properties.provisioningState |
O estado atual da galeria ou artefacto da galeria. |
|
properties.purchasePlan |
Descreve o plano de compra da definição de imagem da galeria. Isto é utilizado por imagens do marketplace. |
|
properties.recommended |
As propriedades descrevem a configuração recomendada do computador para esta Definição de Imagem. Estas propriedades são atualizáveis. |
|
properties.releaseNoteUri |
string |
O URI da nota de versão. |
tags |
object |
Etiquetas de recursos |
type |
string |
Tipo de recurso |
GalleryImageFeature
Uma funcionalidade para a imagem da galeria.
Name | Tipo | Description |
---|---|---|
name |
string |
O nome da funcionalidade de imagem da galeria. |
value |
string |
O valor da funcionalidade de imagem da galeria. |
GalleryImageIdentifier
Este é o identificador de definição de imagem da galeria.
Name | Tipo | Description |
---|---|---|
offer |
string |
O nome da oferta de definição de imagem da galeria. |
publisher |
string |
O nome do publicador de definições de imagem da galeria. |
sku |
string |
O nome do SKU de definição de imagem da galeria. |
GalleryProvisioningState
O estado atual da galeria ou artefacto da galeria.
Name | Tipo | Description |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Migrating |
string |
|
Succeeded |
string |
|
Updating |
string |
HyperVGeneration
A geração do hipervisor da Máquina Virtual. Aplicável apenas a discos do SO.
Name | Tipo | Description |
---|---|---|
V1 |
string |
|
V2 |
string |
ImagePurchasePlan
Descreve o plano de compra da definição de imagem da galeria. Isto é utilizado por imagens do marketplace.
Name | Tipo | Description |
---|---|---|
name |
string |
O ID do plano. |
product |
string |
O ID do produto. |
publisher |
string |
O ID do editor. |
InnerError
Detalhes do erro interno.
Name | Tipo | Description |
---|---|---|
errordetail |
string |
A mensagem de erro interna ou a informação de falha de sistema da exceção. |
exceptiontype |
string |
O tipo de exceção. |
OperatingSystemStateTypes
Esta propriedade permite ao utilizador especificar se as máquinas virtuais criadas nesta imagem são "Generalizadas" ou "Especializadas".
Name | Tipo | Description |
---|---|---|
Generalized |
string |
|
Specialized |
string |
OperatingSystemTypes
Esta propriedade permite-lhe especificar o tipo suportado do SO para o qual a aplicação foi criada. Os valores possíveis são: Windows,Linux.
Name | Tipo | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
RecommendedMachineConfiguration
As propriedades descrevem a configuração recomendada do computador para esta Definição de Imagem. Estas propriedades são atualizáveis.
Name | Tipo | Description |
---|---|---|
memory |
Descreve o intervalo de recursos. |
|
vCPUs |
Descreve o intervalo de recursos. |
ResourceRange
Descreve o intervalo de recursos.
Name | Tipo | Description |
---|---|---|
max |
integer |
O número máximo do recurso. |
min |
integer |
O número mínimo do recurso. |