Help Center> EventGrid> User Guide> Event Subscriptions> Editing an Event Subscription

Updated on 2023-10-26 GMT+08:00

View PDF

Editing an Event Subscription

Modify the description, status, event source, and event target of a subscription.

Modifying the Description

Log in to the EG console.
In the navigation pane, choose Event Subscriptions.
Click Configure in the row that contains the desired subscription to go to the details page.
Click the edit icon next to the default subscription name.
Modify the description and click OK.

Changing the Status

Log in to the EG console.
In the navigation pane, choose Event Subscriptions.
Click Disable or Enable in the row that contains the desired subscription.

Changing the Event Source

Log in to the EG console.
In the navigation pane, choose Event Subscriptions.
Click the name of the desired subscription to go to the details page.
Click the event source card.

Modify the event source parameters.

The event source provider cannot be changed.

When selecting Huawei Cloud, set the parameters listed in Table 1.

**Table 1** Cloud service event source parameters
Parameter	Description
Event Source	Select a cloud service event source.
Event Type	(Optional) Select a predefined event type.
Filter Rule	Enter an event filter rule. Only events that match these filter rules will be routed to the associated targets. For more information about filter rules, see Filter Rule Parameters and Example Filter Rules.

Figure 1 Configuring a cloud service event source
Click to enlarge

When selecting Custom, set the parameters listed in Table 2.

The bound custom event channel cannot be changed.

**Table 2** Custom event source parameters
Parameter	Description
Event Source
Type	Two types are available: Existing: Select a custom event source associated with the custom event channel. New: Create an event source.
Event Source	If Type is set to Existing, select a custom event source associated with the custom event channel specified in the Channel area. If Type is set to New, enter a source name.
Description	Set this parameter only when Type is set to New. Describe the custom event source.
Filter Rule	Enter an event filter rule. Only events that match these filter rules will be routed to the associated targets. For more information about filter rules, see Filter Rule Parameters and Example Filter Rules.

Figure 2 Configuring a custom event source
Click to enlarge

Click OK.
Click Save.

Changing the Event Target

Log in to the EG console.
In the navigation pane, choose Event Subscriptions.
Click the name of the desired subscription to go to the details page.
Change the event target or add another one.
- Click the event target card to change the event target.
- Click to add an event target.
- Click to delete an event target.

Set the event target provider and relevant parameters.

When selecting Huawei Cloud, set the following parameters.

Event Target: Select an event target.

If you set Event Target to FunctionGraph (function computing):

Function: Select the function to trigger. If no function is available, create one by referring to Creating a Function.
Version/Alias: Choose to specify a version or alias.
Version: Select a version of the function. By default, latest is selected.
Alias: Select an alias of the function.
Execute: Select Asynchronously or Synchronously.

Function invocation mode. Default: Asynchronously.

Asynchronously: Immediate responses of function invocation are not required.

Synchronously: Immediate responses of function invocation are required.
Agency: Select an agency. If no agency is available, click Create Agency to generate one named EG_TARGET_AGENCY.
1. Only agencies with EG as the delegated cloud service are displayed.
2. Select an agency with the permission functiongraph:function:invoke*.

If you set Event Target to Distributed Message Service (DMS) for Kafka:

Connection: Select a DMS for Kafka connection.
Topic: Select a message topic.
Enable: Whether to enable the message key function.
Transform Type: Defines how message keys are used. There are two options:
- Variables: Keys are variable values from CloudEvents-compliant events.
- Constants: Keys are specified constants. All messages will be sent to the same partition.
For more information about the transform types, see Event Content Transformation.

If you set Event Target to EventGrid (EG):

An event can be transmitted three times in an EG channel.

Account Type: Select Current or Other. The following table lists the parameters.

**Table 3** Event target parameters
Current	Other	Description
Region	Region	CN North-Beijing4 NOTE: Coming soon in more regions.
Project ID	Project ID	Enter the project ID of the target channel.
Channel	Channel	Enter the target channel ID. NOTE: Current account and same region: Select a channel in the current account. Other account: Specify a channel ID. The channel you select must be associated with a subscription to consume messages published to it. If you select Current, select a different channel from the subscription. Do not select the default channel.
Agency	Agency	Select an agency. NOTE: If no agency is available, click Create Agency to generate one named EG_TARGET_AGENCY. Only agencies with EG as the delegated cloud service are displayed. Select an agency with the permission eg:channels:putEvents.

Rule:

Transform Type: EG transforms CloudEvents-compliant events for targets.
- Pass-through: Directly route CloudEvents-compliant events to the target.
For more information about the transform types, see Event Content Transformation.

If you set Event Target to Simple Message Notification (SMN):

Topic: Select a message topic.
Agency: Select an agency. If no agency is available, click Create Agency to generate one named EG_SMN_PUBLISHER_AGENCY.
- Only agencies with EG as the delegated cloud service are displayed.
- Select an agency with the permission smn:topic:publish.
Message Subject: Configure the subject through constants or variables.
Type: Type of the message subject. Two types are available:
- Constants: The subject does not change from specified. All messages will use the same subject.
- Variables: The subject in the template is a variable value from CloudEvents-compliant events. Max.: 512 characters.
  
  The Subject parameter is optional.

Rule:

Transform Type: EG transforms CloudEvents-compliant events for targets. The following three types are supported:
- Pass-through: Directly route CloudEvents-compliant events to the target.
- Variables: Route variables in CloudEvents-compliant events to the target.
- Constants: Route constants in events to the target.
For more information about the transform types, see Event Content Transformation.

Figure 3 Configuring a Huawei Cloud service event target
Click to enlarge

When selecting Custom, set the following parameters.

URL: Enter the URL of an event target.
Connection: Select a custom or the default connection.
Headers Parameters
- Enter a request header.
- Enter a value.
- Specify whether to encrypt the header.
  Figure 4 Header parameters
  - For custom HTTPS events, add authorization configurations for the event target to improve security.
  - If the request header and value are invalid, the encryption option is unavailable.
  - Key: Max. 256 characters starting and ending with a letter. Only letters and hyphen (-) are allowed.
  - Value: Max. 1024 characters, including letters, hyphens (-), underscores (_), spaces, and special characters (~!@#$%^&*()=+|[{}];:'",<.>/?).
Transform Type: EG transforms CloudEvents-compliant events for targets. The following three types are supported:
- Pass-through: Directly route CloudEvents-compliant events to the target.
- Variables: Route variables in CloudEvents-compliant events to the target.
- Constants: Route constants in events to the target.
For more information about the transform types, see Event Content Transformation.