Gallery Images - Create Or Update
Crie ou atualize 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=2024-03-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 ser criada ou atualizada. Os caracteres permitidos são alfabetos e números com pontos, traços e pontos permitidos no meio. O comprimento máximo é de 80 caracteres. |
gallery
|
path | True |
string |
O nome da Galeria de Imagens Compartilhadas na 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 assinatura que identificam exclusivamente a assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço. |
api-version
|
query | True |
string |
Versão da API do 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 |
Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob esta imagem são 'Generalizadas' ou 'Especializadas'. |
|
properties.osType | True |
Essa propriedade permite especificar o tipo de sistema operacional incluído no disco ao criar uma VM a partir de uma imagem gerenciada. Os valores possíveis são: Windows,Linux. |
|
properties.allowUpdateImage |
boolean |
Opcional. Deve ser definido como true se os recursos de imagem da galeria estiverem sendo atualizados. |
|
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 de galeria. Esta propriedade é atualizável. |
|
properties.disallowed |
Descreve os tipos de disco não permitidos. |
||
properties.endOfLifeDate |
string |
A data de fim da vida útil da definição da imagem da galeria. Esta propriedade pode ser usada para fins de descomissionamento. Esta propriedade é atualizável. |
|
properties.eula |
string |
O acordo Eula para a definição da imagem da galeria. |
|
properties.features |
Uma lista de recursos de imagem da galeria. |
||
properties.hyperVGeneration |
A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO. |
||
properties.privacyStatementUri |
string |
A declaração de privacidade uri. |
|
properties.purchasePlan |
Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens de mercado. |
||
properties.recommended |
As propriedades descrevem a configuração de máquina recomendada para esta definição de imagem. Essas propriedades são atualizáveis. |
||
properties.releaseNoteUri |
string |
A nota de lançamento uri. |
|
tags |
object |
Tags de recursos |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK |
|
201 Created |
Criado |
|
202 Accepted |
Aceito |
|
Other Status Codes |
Resposta de erro descrevendo por que a operação falhou. |
Segurança
azure_auth
Azure Ative Directory OAuth2 Flow
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
Name | Description |
---|---|
user_impersonation | personificar a sua conta de utilizador |
Exemplos
Create or update a simple gallery image.
Pedido de amostra
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName/images/myGalleryImageName?api-version=2024-03-03
{
"location": "West US",
"properties": {
"osType": "Windows",
"osState": "Generalized",
"hyperVGeneration": "V1",
"identifier": {
"publisher": "myPublisherName",
"offer": "myOfferName",
"sku": "mySkuName"
}
}
}
Resposta da amostra
{
"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 erro 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 você deseja criar ou atualizar. |
Gallery |
Um recurso para imagem de galeria. |
Gallery |
Este é o identificador de definição de imagem da galeria. |
Gallery |
O estado atual da galeria ou artefato de galeria. |
Hyper |
A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO. |
Image |
Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens de mercado. |
Inner |
Detalhes do erro interno. |
Operating |
Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob esta imagem são 'Generalizadas' ou 'Especializadas'. |
Operating |
Esta propriedade permite que você especifique o tipo suportado do sistema operacional para o qual o aplicativo foi criado. Os valores possíveis são: Windows,Linux. |
Recommended |
As propriedades descrevem a configuração de máquina recomendada para esta definição de imagem. Essas 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 Api |
|
innererror |
O erro interno da Api |
|
message |
string |
A mensagem de erro. |
target |
string |
O alvo do erro específico. |
ApiErrorBase
Base de erro da api.
Name | Tipo | Description |
---|---|---|
code |
string |
O código de erro. |
message |
string |
A mensagem de erro. |
target |
string |
O alvo 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 você deseja criar ou atualizar.
Name | Tipo | Description |
---|---|---|
id |
string |
ID do recurso |
location |
string |
Localização do recurso |
name |
string |
Nome do recurso |
properties.allowUpdateImage |
boolean |
Opcional. Deve ser definido como true se os recursos de imagem da galeria estiverem sendo atualizados. |
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 de galeria. Esta propriedade é atualizável. |
properties.disallowed |
Descreve os tipos de disco não permitidos. |
|
properties.endOfLifeDate |
string |
A data de fim da vida útil da definição da imagem da galeria. Esta propriedade pode ser usada para fins de descomissionamento. Esta propriedade é atualizável. |
properties.eula |
string |
O acordo Eula para a definição da imagem da galeria. |
properties.features |
Uma lista de recursos de imagem 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 |
Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob esta imagem são 'Generalizadas' ou 'Especializadas'. |
|
properties.osType |
Essa propriedade permite especificar o tipo de sistema operacional incluído no disco ao criar uma VM a partir de uma imagem gerenciada. Os valores possíveis são: Windows,Linux. |
|
properties.privacyStatementUri |
string |
A declaração de privacidade uri. |
properties.provisioningState |
O estado atual da galeria ou artefato de galeria. |
|
properties.purchasePlan |
Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens de mercado. |
|
properties.recommended |
As propriedades descrevem a configuração de máquina recomendada para esta definição de imagem. Essas propriedades são atualizáveis. |
|
properties.releaseNoteUri |
string |
A nota de lançamento uri. |
tags |
object |
Tags de recursos |
type |
string |
Tipo de recurso |
GalleryImageFeature
Um recurso para imagem de galeria.
Name | Tipo | Description |
---|---|---|
name |
string |
O nome do recurso de imagem da galeria. |
startsAtVersion |
string |
A versão mínima da imagem da galeria que suporta este recurso. |
value |
string |
O valor do recurso 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 editor de definição de imagem da galeria. |
sku |
string |
O nome da definição de imagem da galeria SKU. |
GalleryProvisioningState
O estado atual da galeria ou artefato de 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 de definição de imagem da galeria. Isso é usado por imagens de mercado.
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 despejo de exceção. |
exceptiontype |
string |
O tipo de exceção. |
OperatingSystemStateTypes
Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob esta imagem são 'Generalizadas' ou 'Especializadas'.
Name | Tipo | Description |
---|---|---|
Generalized |
string |
|
Specialized |
string |
OperatingSystemTypes
Esta propriedade permite que você especifique o tipo suportado do sistema operacional para o qual o aplicativo foi criado. Os valores possíveis são: Windows,Linux.
Name | Tipo | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
RecommendedMachineConfiguration
As propriedades descrevem a configuração de máquina recomendada para esta definição de imagem. Essas 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. |