Partager via


Triggers - Create Or Update

Créer ou mettre à jour un déclencheur pour le modèle d’image de machine virtuelle spécifié

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

Paramètres URI

Nom Dans Obligatoire Type Description
imageTemplateName
path True

string

Nom du modèle d’image

Modèle d’expression régulière: ^[A-Za-z0-9-_.]{1,64}$

resourceGroupName
path True

string

Nom du groupe de ressources.

subscriptionId
path True

string

Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

triggerName
path True

string

Nom du déclencheur

Modèle d’expression régulière: ^[A-Za-z0-9-_.]{1,64}$

api-version
query True

string

Version de l’API cliente.

Corps de la demande

Nom Obligatoire Type Description
properties.kind True

string

Type de déclencheur.

Réponses

Nom Type Description
200 OK

Trigger

Ok

201 Created

Trigger

Date de création

Other Status Codes

CloudError

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Create or update a source image type trigger

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
CloudError

Réponse d’erreur du service Azure VM Image Builder.

CloudErrorBody

Réponse d’erreur du service Azure VM Image Builder.

createdByType

Type d’identité qui a créé la ressource.

ProvisioningState

État d’approvisionnement de la ressource

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Trigger

Représente un déclencheur qui peut appeler une build de modèle d’image.

TriggerStatus

Décrit la status d’un déclencheur

CloudError

Réponse d’erreur du service Azure VM Image Builder.

Nom Type Description
error

CloudErrorBody

Détails sur l’erreur.

CloudErrorBody

Réponse d’erreur du service Azure VM Image Builder.

Nom Type Description
code

string

Identificateur de l'erreur. Les codes sont invariants et sont destinés à être consommés par programmation.

details

CloudErrorBody[]

Liste des détails supplémentaires sur l’erreur.

message

string

Message décrivant l’erreur, destiné à être affiché dans une interface utilisateur.

target

string

Cible de l’erreur particulière. Par exemple, le nom de la propriété dans l’erreur.

createdByType

Type d’identité qui a créé la ressource.

Nom Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

ProvisioningState

État d’approvisionnement de la ressource

Nom Type Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string

Horodatage de la dernière modification de la ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.

Trigger

Représente un déclencheur qui peut appeler une build de modèle d’image.

Nom Type Description
id

string

ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

nom de la ressource.

properties.kind

string

Type de déclencheur.

properties.provisioningState

ProvisioningState

État d’approvisionnement de la ressource

properties.status

TriggerStatus

État du déclencheur

systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

TriggerStatus

Décrit la status d’un déclencheur

Nom Type Description
code

string

Code d'état.

message

string

Message de status détaillé, y compris pour les alertes et les messages d’erreur.

time

string

Heure du status.