EventSubscriptions

Create an event subscription

Asynchronously creates a new event subscription to the specified scope. Existing event subscriptions cannot be updated with this API and should instead use the Update event subscription API.

put/{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}

Path parameters

scopestring required

The scope of the resource to which the event subscription needs to be created. The scope can be a subscription, or a resource group, or a top level resource belonging to a resource provider namespace, or an EventGrid topic. For example, use '/subscriptions/{subscriptionId}/' for a subscription, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for a resource group, and '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}' for a resource, and '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}' for an EventGrid topic.

eventSubscriptionNamestring required

Name of the event subscription to be created. Event subscription names must be between 3 and 64 characters in length and use alphanumeric letters only.

Query parameters

api-versionstring required

Version of the API to be used with the client request.

Request body

idstring

Fully qualified identifier of the resource

namestring

Name of the resource

typestring

Type of the resource

Response

Created

idstring

Fully qualified identifier of the resource

namestring

Name of the resource

typestring

Type of the resource

Changes