Triggers - Create Or Update

Service:: Image Builder

API-versie:: 2022-07-01

Een trigger maken of bijwerken voor de opgegeven sjabloon voor de installatiekopieën van virtuele machines

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

URI-parameters

Name	In	Vereist	Type	Description
imageTemplateName	path	True	string pattern: ^[A-Za-z0-9-_.]{1,64}$	De naam van de afbeeldingssjabloon
resourceGroupName	path	True	string	De naam van de resourcegroep.
subscriptionId	path	True	string	Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.
triggerName	path	True	string pattern: ^[A-Za-z0-9-_.]{1,64}$	De naam van de trigger
api-version	query	True	string	Client-API-versie.

Aanvraagbody

Name	Vereist	Type	Description
properties.kind	True	string	Het soort trigger.

Antwoorden

Name	Type	Description
200 OK	Trigger	OK
201 Created	Trigger	Gemaakt
Other Status Codes	CloudError	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Create or update a source image type trigger

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 201

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

Statuscode:: 200

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

Definities

Name	Description
CloudError	Een foutbericht van de Azure VM Image Builder-service.
CloudErrorBody	Een foutbericht van de Azure VM Image Builder-service.
createdByType	Het type identiteit waarmee de resource is gemaakt.
ProvisioningState	Inrichtingsstatus van de resource
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
Trigger	Vertegenwoordigt een trigger die een build van een installatiekopieënsjabloon kan aanroepen.
TriggerStatus	Beschrijft de status van een trigger

CloudError

Object

Een foutbericht van de Azure VM Image Builder-service.

Name	Type	Description
error	CloudErrorBody	Details over de fout.

CloudErrorBody

Object

Een foutbericht van de Azure VM Image Builder-service.

Name	Type	Description
code	string	Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
details	CloudErrorBody[]	Een lijst met aanvullende informatie over de fout.
message	string	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
target	string	Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

ProvisioningState

Inventarisatie

Inrichtingsstatus van de resource

Waarde	Description
Creating
Updating
Succeeded
Failed
Deleting
Canceled

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

Trigger

Object

Vertegenwoordigt een trigger die een build van een installatiekopieënsjabloon kan aanroepen.

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	De naam van de resource
properties.kind	string	Het soort trigger.
properties.provisioningState	ProvisioningState	Inrichtingsstatus van de resource
properties.status	TriggerStatus	Triggerstatus
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
type	string	Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

TriggerStatus

Object

Beschrijft de status van een trigger

Name	Type	Description
code	string	De statuscode.
message	string	Het gedetailleerde statusbericht, inclusief voor waarschuwingen en foutberichten.
time	string (date-time)	Het tijdstip van de status.