Compartir a través de


Triggers - Create Or Update

Creación o actualización de un desencadenador para la plantilla de imagen de máquina virtual especificada

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
imageTemplateName
path True

string

Nombre de la plantilla de imagen

Patrón de Regex: ^[A-Za-z0-9-_.]{1,64}$

resourceGroupName
path True

string

Nombre del grupo de recursos.

subscriptionId
path True

string

Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada de servicio.

triggerName
path True

string

Nombre del desencadenador

Patrón de Regex: ^[A-Za-z0-9-_.]{1,64}$

api-version
query True

string

Versión de api de cliente.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
properties.kind True

string

Tipo de desencadenador.

Respuestas

Nombre Tipo Description
200 OK

Trigger

Aceptar

201 Created

Trigger

Creado

Other Status Codes

CloudError

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

Create or update a source image type trigger

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

{
  "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"
  }
}

Definiciones

Nombre Description
CloudError

Respuesta de error del servicio Azure VM Image Builder.

CloudErrorBody

Respuesta de error del servicio Azure VM Image Builder.

createdByType

Tipo de identidad que creó el recurso.

ProvisioningState

Estado de aprovisionamiento del recurso

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Trigger

Representa un desencadenador que puede invocar una compilación de plantilla de imagen.

TriggerStatus

Describe el estado de un desencadenador.

CloudError

Respuesta de error del servicio Azure VM Image Builder.

Nombre Tipo Description
error

CloudErrorBody

Detalles sobre el error.

CloudErrorBody

Respuesta de error del servicio Azure VM Image Builder.

Nombre Tipo Description
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.

details

CloudErrorBody[]

Lista de detalles adicionales sobre el error.

message

string

Mensaje que describe el error, diseñado para ser adecuado para su presentación en una interfaz de usuario.

target

string

Destino del error determinado. Por ejemplo, el nombre de la propiedad en error.

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ProvisioningState

Estado de aprovisionamiento del recurso

Nombre Tipo Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.

Trigger

Representa un desencadenador que puede invocar una compilación de plantilla de imagen.

Nombre Tipo Description
id

string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nombre del recurso.

properties.kind

string

Tipo de desencadenador.

properties.provisioningState

ProvisioningState

Estado de aprovisionamiento del recurso

properties.status

TriggerStatus

Estado del desencadenador

systemData

systemData

Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

TriggerStatus

Describe el estado de un desencadenador.

Nombre Tipo Description
code

string

Código de estado.

message

string

Mensaje de estado detallado, incluidas las alertas y los mensajes de error.

time

string

Hora del estado.