Gallery Images - Create Or Update
Crie ou atualize uma definição de imagem da galeria.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}?api-version=2024-03-03
Parâmetros de URI
Nome | Em | Obrigató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 períodos 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. A ID da assinatura faz parte do URI para cada chamada de serviço. |
api-version
|
query | True |
string |
Versão da API do cliente. |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
location | True |
string |
Local do recurso |
properties.identifier | True |
Esse é 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 essa imagem são "Generalizadas" ou "Especializadas". |
|
properties.osType | True |
Essa propriedade permite que você especifique o tipo do 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 somente a discos do sistema operacional. |
||
properties.description |
string |
A descrição deste recurso de definição de imagem da galeria. Essa propriedade é atualizável. |
|
properties.disallowed |
Descreve os tipos de disco não permitidos. |
||
properties.endOfLifeDate |
string |
A data de término da vida útil da definição de imagem da galeria. Essa propriedade pode ser usada para fins de descomissionamento. Essa propriedade é atualizável. |
|
properties.eula |
string |
O contrato Eula para a definição de 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 somente a discos do sistema operacional. |
||
properties.privacyStatementUri |
string |
O uri da política de privacidade. |
|
properties.purchasePlan |
Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens do marketplace. |
||
properties.recommended |
As propriedades descrevem a configuração de computador recomendada para essa Definição de Imagem. Essas propriedades são atualizáveis. |
||
properties.releaseNoteUri |
string |
O uri da nota de versão. |
|
tags |
object |
Marcas de recurso |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OKEY |
|
201 Created |
Criado |
|
202 Accepted |
Aceitado |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
Create or update a simple gallery image.
Solicitação de exemplo
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 de exemplo
{
"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
Nome | Description |
---|---|
Api |
Erro de API. |
Api |
Base de erros de API. |
Architecture |
A arquitetura da imagem. Aplicável somente a discos do sistema operacional. |
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 da galeria. |
Gallery |
Esse é o identificador de definição de imagem da galeria. |
Gallery |
O estado atual da galeria ou do artefato da galeria. |
Hyper |
A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional. |
Image |
Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens do marketplace. |
Inner |
Detalhes do erro interno. |
Operating |
Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob essa imagem são "Generalizadas" ou "Especializadas". |
Operating |
Essa propriedade permite que você especifique o tipo com suporte 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 computador recomendada para essa Definição de Imagem. Essas propriedades são atualizáveis. |
Resource |
Descreve o intervalo de recursos. |
ApiError
Erro de API.
Nome | 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 de API.
Nome | 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 somente a discos do sistema operacional.
Nome | Tipo | Description |
---|---|---|
Arm64 |
string |
|
x64 |
string |
CloudError
Uma resposta de erro do serviço de computação.
Nome | Tipo | Description |
---|---|---|
error |
Erro de API. |
Disallowed
Descreve os tipos de disco não permitidos.
Nome | 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.
Nome | Tipo | Description |
---|---|---|
id |
string |
ID do recurso |
location |
string |
Local 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 somente a discos do sistema operacional. |
|
properties.description |
string |
A descrição deste recurso de definição de imagem da galeria. Essa propriedade é atualizável. |
properties.disallowed |
Descreve os tipos de disco não permitidos. |
|
properties.endOfLifeDate |
string |
A data de término da vida útil da definição de imagem da galeria. Essa propriedade pode ser usada para fins de descomissionamento. Essa propriedade é atualizável. |
properties.eula |
string |
O contrato Eula para a definição de 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 somente a discos do sistema operacional. |
|
properties.identifier |
Esse é 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 essa imagem são "Generalizadas" ou "Especializadas". |
|
properties.osType |
Essa propriedade permite que você especifique o tipo do 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 |
O uri da política de privacidade. |
properties.provisioningState |
O estado atual da galeria ou do artefato da galeria. |
|
properties.purchasePlan |
Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens do marketplace. |
|
properties.recommended |
As propriedades descrevem a configuração de computador recomendada para essa Definição de Imagem. Essas propriedades são atualizáveis. |
|
properties.releaseNoteUri |
string |
O uri da nota de versão. |
tags |
object |
Marcas de recurso |
type |
string |
Tipo de recurso |
GalleryImageFeature
Um recurso para imagem da galeria.
Nome | Tipo | Description |
---|---|---|
name |
string |
O nome do recurso de imagem da galeria. |
startsAtVersion |
string |
A versão mínima da imagem da galeria que dá suporte a esse recurso. |
value |
string |
O valor do recurso de imagem da galeria. |
GalleryImageIdentifier
Esse é o identificador de definição de imagem da galeria.
Nome | 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 SKU de definição de imagem da galeria. |
GalleryProvisioningState
O estado atual da galeria ou do artefato da galeria.
Nome | 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 somente a discos do sistema operacional.
Nome | Tipo | Description |
---|---|---|
V1 |
string |
|
V2 |
string |
ImagePurchasePlan
Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens do marketplace.
Nome | Tipo | Description |
---|---|---|
name |
string |
A ID do plano. |
product |
string |
A ID do produto. |
publisher |
string |
A ID do editor. |
InnerError
Detalhes do erro interno.
Nome | Tipo | Description |
---|---|---|
errordetail |
string |
A mensagem de erro interna ou o 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 essa imagem são "Generalizadas" ou "Especializadas".
Nome | Tipo | Description |
---|---|---|
Generalized |
string |
|
Specialized |
string |
OperatingSystemTypes
Essa propriedade permite que você especifique o tipo com suporte do sistema operacional para o qual o aplicativo foi criado. Os valores possíveis são: Windows,Linux.
Nome | Tipo | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
RecommendedMachineConfiguration
As propriedades descrevem a configuração de computador recomendada para essa Definição de Imagem. Essas propriedades são atualizáveis.
Nome | Tipo | Description |
---|---|---|
memory |
Descreve o intervalo de recursos. |
|
vCPUs |
Descreve o intervalo de recursos. |
ResourceRange
Descreve o intervalo de recursos.
Nome | Tipo | Description |
---|---|---|
max |
integer |
O número máximo do recurso. |
min |
integer |
O número mínimo do recurso. |