Modify event notification subscription (PUT /v1.0/{tenantId}/eventnotifications/{subscriptionId})
Modifies parameters for an event notification subscription.
Request URI
{tenantID}
Project ID of the owner of the instance
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
{subscriptionID}
ID of event notification subscription
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Request Parameters
action
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| None | modify |
modify
Modify event notification subscription attributes
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String | 1..1 | action | None |
eventnotification
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| None | enabled eventCategories. sourceType id name |
enabled
Enables event notification
true | false
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| Boolean | 1..1 | eventnotification | None |
eventCategories.
A list containing the SourceType event categories you want to register. The list of assigned SourceType categories can be confirmed from DescribeEventCategories.
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String list | 1..1 | eventnotification | None |
sourceType
The type of source for which an event is generated. For example, to notify an event generated by the DBinstance, specify ""db-instance".
Default: All events will be notified if this specification is omitted.
db-instance | db-snapshot
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String | 0..1 | eventnotification | None |
id
ID of event notification subscription
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String | 0..1 | eventnotification | None |
name
Name of event notification subscription
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String | 1..1 | eventnotification | None |
description
Description of the event notification subscription
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String | 1..1 | eventnotification | None |
Response Headers
Status
Returns the status of the request.
- 400:
- badRequest
- 401:
- unauthorized
- 403:
- forbidden
- 404:
- itemNotFound
- 413:
- overLimit
- 422:
- unprocessableEntity
- 500:
- instanceFault
- 501:
- notImplemented
- 503:
- serviceUnavailable
- 504:
- gatewayTimeout
| Data Type | Cardinality |
|---|---|
| Int | 1.1 |
Response Elements
EventSubscription
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| None | id name enabled eventCategoriesList sourceIdsList sourceType status created |
id
ID of event notification subscription
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String |
name
Name of event notification subscription
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String |
enabled
Flag indicating whether notification is enabled
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| Boolean |
eventCategoriesList
List of event categories to notify
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String list |
sourceIdsList
List of resource IDs that will be the event source to notify
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String list |
sourceType
Type of resource that will be the event source
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String |
status
Status of event notification subscription
creating | modifying | deleting | active |
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String |
created
The creation date and time
| Data Type | Cardinality | Parent Element | Child Element(s) |
|---|---|---|---|
| String |
Example of Request
{
"action" : {
"modify":""
},
"eventnotification":{
"enabled" : true,
"eventCategories" : [
{"eventCategory" : "backup"}
],
"sourceType" : "db-snapshot",
"subscriptionName" : "modsubscription2"
}
}