PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}/daprSubscriptions/{name}/?api-version=2023-08-01-preview

Creates or updates a Dapr subscription in a Managed Environment.

Servers

Path parameters

Name Type Required Description
name String Yes

Name of the Dapr subscription.

subscriptionId String Yes

The ID of the target subscription. The value must be an UUID.

environmentName String Yes

Name of the Managed Environment.

resourceGroupName String Yes

The name of the resource group. The name is case insensitive.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
properties Object No

Dapr PubSub Event Subscription resource specific properties

properties.scopes[] Array No

Application scopes to restrict the subscription to specific apps.

properties.deadLetterTopic String No

Deadletter topic name

properties.topic String No

Topic name

properties.routes Object No

Dapr PubSub Event Subscription Routes configuration.

properties.routes.rules[] Array No

The list of Dapr PubSub Event Subscription Route Rules.

properties.routes.rules[].match String No

The optional CEL expression used to match the event. If the match is not specified, then the route is considered the default. The rules are tested in the order specified, so they should be define from most-to-least specific. The default route should appear last in the list.

properties.routes.rules[].path String No

The path for events that match this rule

properties.routes.default String No

The default path to deliver events that do not match any of the rules.

properties.bulkSubscribe Object No

Dapr PubSub Bulk Subscription Options.

properties.bulkSubscribe.maxAwaitDurationMs Integer No

Maximum duration in milliseconds to wait before a bulk message is sent to the app.

properties.bulkSubscribe.maxMessagesCount Integer No

Maximum number of messages to deliver in a bulk message.

properties.bulkSubscribe.enabled Boolean No

Enable bulk subscription

Default value: false

properties.metadata Object No

Subscription metadata

properties.pubsubName String No

Dapr PubSub component name

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.