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"
}
}