Delen via


Webhook - Create Or Update

Maak de webhook die wordt geïdentificeerd door de naam van de webhook.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/webhooks/{webhookName}?api-version=2015-10-31

URI-parameters

Name In Vereist Type Description
automationAccountName
path True

string

De naam van het Automation-account.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._]+$

Naam van een Azure-resourcegroep.

subscriptionId
path True

string

Hiermee haalt u abonnementsreferenties op die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

webhookName
path True

string

De naam van de webhook.

api-version
query True

string

Client-API-versie.

Aanvraagbody

Name Vereist Type Description
name True

string

Hiermee haalt u de naam van de webhook op of stelt u deze in.

properties.expiryTime

string (date-time)

Hiermee haalt u de verlooptijd op of stelt u deze in.

properties.isEnabled

boolean

Hiermee haalt u de waarde van de ingeschakelde vlag van webhook op of stelt u deze in.

properties.parameters

object

Hiermee haalt u de parameters van de taak op of stelt u deze in.

properties.runOn

string

Hiermee haalt u de naam op van de hybrid worker-groep waarop de webhooktaak wordt uitgevoerd.

properties.runbook

RunbookAssociationProperty

Hiermee haalt u het runbook op of stelt u het in.

properties.uri

string

Hiermee haalt u de URI op of stelt u deze in.

Antwoorden

Name Type Description
200 OK

Webhook

OK

201 Created

Webhook

Geschapen

Other Status Codes

ErrorResponse

Automatiseringsfoutreactie 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 webhook

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/myAutomationAccount33/webhooks/TestWebhook?api-version=2015-10-31

{
  "name": "TestWebhook",
  "properties": {
    "isEnabled": true,
    "uri": "<uri>",
    "expiryTime": "2018-03-29T22:18:13.7002872Z",
    "runbook": {
      "name": "TestRunbook"
    }
  }
}

Voorbeeldrespons

{
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/myAutomationAccount33/webhooks/TestWebhook",
  "name": "TestWebhook",
  "type": "Microsoft.Automation/AutomationAccounts/Webhooks",
  "properties": {
    "isEnabled": true,
    "expiryTime": "2018-03-29T22:18:13.7002872+00:00",
    "runbook": {
      "name": "TestRunbook"
    },
    "lastInvokedTime": null,
    "runOn": null,
    "parameters": null,
    "uri": "",
    "creationTime": "2017-03-29T22:18:14.6651862+00:00",
    "lastModifiedBy": "",
    "lastModifiedTime": "2017-03-29T22:18:14.6651862+00:00"
  }
}
{
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/myAutomationAccount33/webhooks/TestWebhook",
  "name": "TestWebhook",
  "type": "Microsoft.Automation/AutomationAccounts/Webhooks",
  "properties": {
    "isEnabled": true,
    "expiryTime": "2018-03-29T22:18:13.7002872+00:00",
    "runbook": {
      "name": "TestRunbook"
    },
    "lastInvokedTime": null,
    "runOn": null,
    "parameters": null,
    "uri": "",
    "creationTime": "2017-03-29T22:18:14.6651862+00:00",
    "lastModifiedBy": "",
    "lastModifiedTime": "2017-03-29T22:18:14.6651862+00:00"
  }
}

Definities

Name Description
ErrorResponse

Foutreactie van een bewerkingsfout

RunbookAssociationProperty

De runbookeigenschap die is gekoppeld aan de entiteit.

Webhook

Definitie van het webhooktype.

WebhookCreateOrUpdateParameters

De parameters die zijn opgegeven voor de bewerking webhook maken of bijwerken.

ErrorResponse

Foutreactie van een bewerkingsfout

Name Type Description
code

string

Foutcode

message

string

Foutbericht dat aangeeft waarom de bewerking is mislukt.

RunbookAssociationProperty

De runbookeigenschap die is gekoppeld aan de entiteit.

Name Type Description
name

string

Hiermee haalt u de naam van het runbook op of stelt u deze in.

Webhook

Definitie van het webhooktype.

Name Type Default value Description
id

string

Volledig gekwalificeerde resource-id voor de resource

name

string

De naam van de resource

properties.creationTime

string (date-time)

Hiermee haalt u de aanmaaktijd op of stelt u deze in.

properties.description

string

Hiermee haalt u de beschrijving op of stelt u deze in.

properties.expiryTime

string (date-time)

Hiermee haalt u de verlooptijd op of stelt u deze in.

properties.isEnabled

boolean

False

Hiermee haalt u de waarde van de ingeschakelde vlag van de webhook op of stelt u deze in.

properties.lastInvokedTime

string (date-time)

Hiermee wordt de laatst aangeroepen tijd opgehaald of ingesteld.

properties.lastModifiedBy

string

Details van de gebruiker die de webhook voor het laatst heeft gewijzigd

properties.lastModifiedTime

string (date-time)

Hiermee haalt u de laatst gewijzigde tijd op of stelt u deze in.

properties.parameters

object

Hiermee haalt u de parameters op van de taak die wordt gemaakt wanneer de webhook het runbook aanroept waaraan deze is gekoppeld.

properties.runOn

string

Hiermee haalt u de naam op van de hybrid worker-groep waarop de webhooktaak wordt uitgevoerd.

properties.runbook

RunbookAssociationProperty

Hiermee haalt u het runbook op waarmee de webhook is gekoppeld.

properties.uri

string

Hiermee haalt u de webhook-URI op of stelt u deze in.

type

string

Het type resource.

WebhookCreateOrUpdateParameters

De parameters die zijn opgegeven voor de bewerking webhook maken of bijwerken.

Name Type Description
name

string

Hiermee haalt u de naam van de webhook op of stelt u deze in.

properties.expiryTime

string (date-time)

Hiermee haalt u de verlooptijd op of stelt u deze in.

properties.isEnabled

boolean

Hiermee haalt u de waarde van de ingeschakelde vlag van webhook op of stelt u deze in.

properties.parameters

object

Hiermee haalt u de parameters van de taak op of stelt u deze in.

properties.runOn

string

Hiermee haalt u de naam op van de hybrid worker-groep waarop de webhooktaak wordt uitgevoerd.

properties.runbook

RunbookAssociationProperty

Hiermee haalt u het runbook op of stelt u het in.

properties.uri

string

Hiermee haalt u de URI op of stelt u deze in.