Partilhar via


Triggers - Create Or Update

Criar ou atualizar um acionador para o modelo de imagem de máquina virtual especificado

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}/triggers/{triggerName}?api-version=2022-07-01

Parâmetros do URI

Name Em Necessário Tipo Description
imageTemplateName
path True

string

O nome do Modelo de imagem

Padrão Regex: ^[A-Za-z0-9-_.]{1,64}$

resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
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.

triggerName
path True

string

O nome do acionador

Padrão Regex: ^[A-Za-z0-9-_.]{1,64}$

api-version
query True

string

Versão da API de Cliente.

Corpo do Pedido

Name Necessário Tipo Description
properties.kind True

string

O tipo de acionador.

Respostas

Name Tipo Description
200 OK

Trigger

OK

201 Created

Trigger

Criado

Other Status Codes

CloudError

Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

Create or update a source image type trigger

Pedido de amostra

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate/triggers/source?api-version=2022-07-01

{
  "properties": {
    "kind": "SourceImage"
  }
}

Resposta da amostra

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate/triggers/source",
  "name": "source",
  "type": "Microsoft.VirtualMachineImages/imageTemplates/triggers",
  "properties": {
    "kind": "SourceImage",
    "status": {
      "code": "Healthy",
      "message": "",
      "time": "2022-07-21T17:32:28Z"
    },
    "provisioningState": "Succeeded"
  }
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.VirtualMachineImages/imageTemplates/myImageTemplate/triggers/source",
  "name": "source",
  "type": "Microsoft.VirtualMachineImages/imageTemplates/triggers",
  "properties": {
    "kind": "SourceImage",
    "status": {
      "code": "Healthy",
      "message": "",
      "time": "2022-07-21T17:32:28Z"
    },
    "provisioningState": "Succeeded"
  }
}

Definições

Name Description
CloudError

Uma resposta de erro do serviço Azure VM Image Builder.

CloudErrorBody

Uma resposta de erro do serviço Azure VM Image Builder.

createdByType

O tipo de identidade que criou o recurso.

ProvisioningState

Estado de aprovisionamento do recurso

systemData

Metadados relativos à criação e última modificação do recurso.

Trigger

Representa um acionador que pode invocar uma compilação de modelo de imagem.

TriggerStatus

Descreve o estado de um acionador

CloudError

Uma resposta de erro do serviço Azure VM Image Builder.

Name Tipo Description
error

CloudErrorBody

Detalhes sobre o erro.

CloudErrorBody

Uma resposta de erro do serviço Azure VM Image Builder.

Name Tipo Description
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.

details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.

message

string

Uma mensagem que descreve o erro, destinada a ser adequada para ser apresentada numa interface de utilizador.

target

string

O destino do erro específico. Por exemplo, o nome da propriedade em erro.

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ProvisioningState

Estado de aprovisionamento do recurso

Name Tipo Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

Trigger

Representa um acionador que pode invocar uma compilação de modelo de imagem.

Name Tipo Description
id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

O nome do recurso

properties.kind

string

O tipo de acionador.

properties.provisioningState

ProvisioningState

Estado de aprovisionamento do recurso

properties.status

TriggerStatus

Estado do acionador

systemData

systemData

O Azure Resource Manager metadados que contêm informações createdBy e modifiedBy.

type

string

O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

TriggerStatus

Descreve o estado de um acionador

Name Tipo Description
code

string

O código de estado.

message

string

A mensagem de estado detalhada, incluindo para alertas e mensagens de erro.

time

string

A hora do estado.