amazonka-rds-2.0: Amazon Relational Database Service SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.RDS.ModifyEventSubscription

Description

Modifies an existing RDS event notification subscription. You can't modify the source identifiers using this call. To change source identifiers for a subscription, use the AddSourceIdentifierToSubscription and RemoveSourceIdentifierFromSubscription calls.

You can see a list of the event categories for a given source type (SourceType) in Events in the Amazon RDS User Guide or by using the DescribeEventCategories operation.

Synopsis

Creating a Request

data ModifyEventSubscription Source #

See: newModifyEventSubscription smart constructor.

Constructors

ModifyEventSubscription' 

Fields

  • enabled :: Maybe Bool

    A value that indicates whether to activate the subscription.

  • eventCategories :: Maybe [Text]

    A list of event categories for a source type (SourceType) that you want to subscribe to. You can see a list of the categories for a given source type in Events in the Amazon RDS User Guide or by using the DescribeEventCategories operation.

  • snsTopicArn :: Maybe Text

    The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

  • sourceType :: Maybe Text

    The type of source that is generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. For RDS Proxy events, specify db-proxy. If this value isn't specified, all events are returned.

    Valid values: db-instance | db-cluster | db-parameter-group | db-security-group | db-snapshot | db-cluster-snapshot | db-proxy

  • subscriptionName :: Text

    The name of the RDS event notification subscription.

Instances

Instances details
ToHeaders ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

ToPath ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

ToQuery ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

AWSRequest ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

Generic ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

Associated Types

type Rep ModifyEventSubscription :: Type -> Type #

Read ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

Show ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

NFData ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

Methods

rnf :: ModifyEventSubscription -> () #

Eq ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

Hashable ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

type AWSResponse ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

type Rep ModifyEventSubscription Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

type Rep ModifyEventSubscription = D1 ('MetaData "ModifyEventSubscription" "Amazonka.RDS.ModifyEventSubscription" "amazonka-rds-2.0-3xXyiLHmAvvCXXUIx1uhpP" 'False) (C1 ('MetaCons "ModifyEventSubscription'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "enabled") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "eventCategories") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text]))) :*: (S1 ('MetaSel ('Just "snsTopicArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "sourceType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "subscriptionName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newModifyEventSubscription Source #

Create a value of ModifyEventSubscription with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

ModifyEventSubscription, modifyEventSubscription_enabled - A value that indicates whether to activate the subscription.

ModifyEventSubscription, modifyEventSubscription_eventCategories - A list of event categories for a source type (SourceType) that you want to subscribe to. You can see a list of the categories for a given source type in Events in the Amazon RDS User Guide or by using the DescribeEventCategories operation.

ModifyEventSubscription, modifyEventSubscription_snsTopicArn - The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

ModifyEventSubscription, modifyEventSubscription_sourceType - The type of source that is generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. For RDS Proxy events, specify db-proxy. If this value isn't specified, all events are returned.

Valid values: db-instance | db-cluster | db-parameter-group | db-security-group | db-snapshot | db-cluster-snapshot | db-proxy

$sel:subscriptionName:ModifyEventSubscription', modifyEventSubscription_subscriptionName - The name of the RDS event notification subscription.

Request Lenses

modifyEventSubscription_enabled :: Lens' ModifyEventSubscription (Maybe Bool) Source #

A value that indicates whether to activate the subscription.

modifyEventSubscription_eventCategories :: Lens' ModifyEventSubscription (Maybe [Text]) Source #

A list of event categories for a source type (SourceType) that you want to subscribe to. You can see a list of the categories for a given source type in Events in the Amazon RDS User Guide or by using the DescribeEventCategories operation.

modifyEventSubscription_snsTopicArn :: Lens' ModifyEventSubscription (Maybe Text) Source #

The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.

modifyEventSubscription_sourceType :: Lens' ModifyEventSubscription (Maybe Text) Source #

The type of source that is generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. For RDS Proxy events, specify db-proxy. If this value isn't specified, all events are returned.

Valid values: db-instance | db-cluster | db-parameter-group | db-security-group | db-snapshot | db-cluster-snapshot | db-proxy

modifyEventSubscription_subscriptionName :: Lens' ModifyEventSubscription Text Source #

The name of the RDS event notification subscription.

Destructuring the Response

data ModifyEventSubscriptionResponse Source #

See: newModifyEventSubscriptionResponse smart constructor.

Constructors

ModifyEventSubscriptionResponse' 

Fields

Instances

Instances details
Generic ModifyEventSubscriptionResponse Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

Associated Types

type Rep ModifyEventSubscriptionResponse :: Type -> Type #

Read ModifyEventSubscriptionResponse Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

Show ModifyEventSubscriptionResponse Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

NFData ModifyEventSubscriptionResponse Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

Eq ModifyEventSubscriptionResponse Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

type Rep ModifyEventSubscriptionResponse Source # 
Instance details

Defined in Amazonka.RDS.ModifyEventSubscription

type Rep ModifyEventSubscriptionResponse = D1 ('MetaData "ModifyEventSubscriptionResponse" "Amazonka.RDS.ModifyEventSubscription" "amazonka-rds-2.0-3xXyiLHmAvvCXXUIx1uhpP" 'False) (C1 ('MetaCons "ModifyEventSubscriptionResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "eventSubscription") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe EventSubscription)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newModifyEventSubscriptionResponse Source #

Create a value of ModifyEventSubscriptionResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:eventSubscription:ModifyEventSubscriptionResponse', modifyEventSubscriptionResponse_eventSubscription - Undocumented member.

$sel:httpStatus:ModifyEventSubscriptionResponse', modifyEventSubscriptionResponse_httpStatus - The response's http status code.

Response Lenses