From c2934dc12c9504f4661a84aa2fb84c5a8b1f5f31 Mon Sep 17 00:00:00 2001 From: awssdkgo Date: Fri, 15 Jan 2021 19:21:52 +0000 Subject: [PATCH] Release v1.36.28 (2021-01-15) === ### Service Client Updates * `service/sns`: Updates service documentation * Documentation updates for Amazon SNS. --- CHANGELOG.md | 7 +++ aws/version.go | 2 +- models/apis/sns/2010-03-31/docs-2.json | 14 +++--- service/sns/api.go | 63 +++++++++++++++++++++----- service/sns/doc.go | 2 +- 5 files changed, 68 insertions(+), 20 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ceb10384b37..aa5fd794399 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,10 @@ +Release v1.36.28 (2021-01-15) +=== + +### Service Client Updates +* `service/sns`: Updates service documentation + * Documentation updates for Amazon SNS. + Release v1.36.27 (2021-01-14) === diff --git a/aws/version.go b/aws/version.go index 9f4b2453d4e..609aa89c084 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.36.27" +const SDKVersion = "1.36.28" diff --git a/models/apis/sns/2010-03-31/docs-2.json b/models/apis/sns/2010-03-31/docs-2.json index 879a6d70e3f..df85eb165ba 100644 --- a/models/apis/sns/2010-03-31/docs-2.json +++ b/models/apis/sns/2010-03-31/docs-2.json @@ -1,6 +1,6 @@ { "version": "2.0", - "service": "Amazon Simple Notification Service

Amazon Simple Notification Service (Amazon SNS) is a web service that enables you to build distributed web-enabled applications. Applications can use Amazon SNS to easily push real-time notification messages to interested subscribers over multiple delivery protocols. For more information about this product see https://aws.amazon.com/sns. For detailed information about Amazon SNS features and their associated API calls, see the Amazon SNS Developer Guide.

For information on the permissions you need to use this API, see Identity and access management in Amazon SNS in the Amazon SNS Developer Guide.

We also provide SDKs that enable you to access Amazon SNS from your preferred programming language. The SDKs contain functionality that automatically takes care of tasks such as: cryptographically signing your service requests, retrying requests, and handling error responses. For a list of available SDKs, go to Tools for Amazon Web Services.

", + "service": "Amazon Simple Notification Service

Amazon Simple Notification Service (Amazon SNS) is a web service that enables you to build distributed web-enabled applications. Applications can use Amazon SNS to easily push real-time notification messages to interested subscribers over multiple delivery protocols. For more information about this product see the Amazon SNS product page. For detailed information about Amazon SNS features and their associated API calls, see the Amazon SNS Developer Guide.

For information on the permissions you need to use this API, see Identity and access management in Amazon SNS in the Amazon SNS Developer Guide.

We also provide SDKs that enable you to access Amazon SNS from your preferred programming language. The SDKs contain functionality that automatically takes care of tasks such as: cryptographically signing your service requests, retrying requests, and handling error responses. For a list of available SDKs, go to Tools for Amazon Web Services.

", "operations": { "AddPermission": "

Adds a statement to a topic's access control policy, granting access for the specified AWS accounts to the specified actions.

", "CheckIfPhoneNumberIsOptedOut": "

Accepts a phone number and indicates whether the phone holder has opted out of receiving SMS messages from your account. You cannot send SMS messages to a number that is opted out.

To resume sending messages, you can opt in the number by using the OptInPhoneNumber action.

", @@ -28,7 +28,7 @@ "RemovePermission": "

Removes a statement from a topic's access control policy.

", "SetEndpointAttributes": "

Sets the attributes for an endpoint for a device on one of the supported push notification services, such as GCM (Firebase Cloud Messaging) and APNS. For more information, see Using Amazon SNS Mobile Push Notifications.

", "SetPlatformApplicationAttributes": "

Sets the attributes of the platform application object for the supported push notification services, such as APNS and GCM (Firebase Cloud Messaging). For more information, see Using Amazon SNS Mobile Push Notifications. For information on configuring attributes for message delivery status, see Using Amazon SNS Application Attributes for Message Delivery Status.

", - "SetSMSAttributes": "

Use this request to set the default settings for sending SMS messages and receiving daily SMS usage reports.

You can override some of these settings for a single message when you use the Publish action with the MessageAttributes.entry.N parameter. For more information, see Publishing to a mobile phone in the Amazon SNS Developer Guide.

", + "SetSMSAttributes": "

Use this request to set the default settings for sending SMS messages and receiving daily SMS usage reports.

You can override some of these settings for a single message when you use the Publish action with the MessageAttributes.entry.N parameter. For more information, see Publishing to a mobile phone in the Amazon SNS Developer Guide.

To use this operation, you must grant the Amazon SNS service principal (sns.amazonaws.com) permission to perform the s3:ListBucket action.

", "SetSubscriptionAttributes": "

Allows a subscription owner to set an attribute of the subscription to a new value.

", "SetTopicAttributes": "

Allows a topic owner to set an attribute of the topic to a new value.

", "Subscribe": "

Subscribes an endpoint to an Amazon SNS topic. If the endpoint type is HTTP/S or email, or if the endpoint and the topic are not in the same AWS account, the endpoint owner must run the ConfirmSubscription action to confirm the subscription.

You call the ConfirmSubscription action with the token from the subscription response. Confirmation tokens are valid for three days.

This action is throttled at 100 transactions per second (TPS).

", @@ -524,8 +524,8 @@ "SubscriptionAttributesMap": { "base": null, "refs": { - "GetSubscriptionAttributesResponse$Attributes": "

A map of the subscription's attributes. Attributes in this map include the following:

", - "SubscribeInput$Attributes": "

A map of attributes with their corresponding values.

The following lists the names, descriptions, and values of the special request parameters that the SetTopicAttributes action uses:

" + "GetSubscriptionAttributesResponse$Attributes": "

A map of the subscription's attributes. Attributes in this map include the following:

The following attribute applies only to Amazon Kinesis Data Firehose delivery stream subscriptions:

", + "SubscribeInput$Attributes": "

A map of attributes with their corresponding values.

The following lists the names, descriptions, and values of the special request parameters that the SetTopicAttributes action uses:

The following attribute applies only to Amazon Kinesis Data Firehose delivery stream subscriptions:

" } }, "SubscriptionLimitExceededException": { @@ -652,7 +652,7 @@ "attributeName": { "base": null, "refs": { - "SetSubscriptionAttributesInput$AttributeName": "

A map of attributes with their corresponding values.

The following lists the names, descriptions, and values of the special request parameters that this action uses:

", + "SetSubscriptionAttributesInput$AttributeName": "

A map of attributes with their corresponding values.

The following lists the names, descriptions, and values of the special request parameters that this action uses:

The following attribute applies only to Amazon Kinesis Data Firehose delivery stream subscriptions:

", "SetTopicAttributesInput$AttributeName": "

A map of attributes with their corresponding values.

The following lists the names, descriptions, and values of the special request parameters that the SetTopicAttributes action uses:

The following attribute applies only to server-side-encryption:

The following attribute applies only to FIFO topics:

", "SubscriptionAttributesMap$key": null, "TopicAttributesMap$key": null @@ -689,7 +689,7 @@ "endpoint": { "base": null, "refs": { - "SubscribeInput$Endpoint": "

The endpoint that you want to receive notifications. Endpoints vary by protocol:

", + "SubscribeInput$Endpoint": "

The endpoint that you want to receive notifications. Endpoints vary by protocol:

", "Subscription$Endpoint": "

The subscription's endpoint (format depends on the protocol).

" } }, @@ -732,7 +732,7 @@ "protocol": { "base": null, "refs": { - "SubscribeInput$Protocol": "

The protocol you want to use. Supported protocols include:

", + "SubscribeInput$Protocol": "

The protocol that you want to use. Supported protocols include:

", "Subscription$Protocol": "

The subscription's protocol.

" } }, diff --git a/service/sns/api.go b/service/sns/api.go index b916003cbc7..54746a3ebf9 100644 --- a/service/sns/api.go +++ b/service/sns/api.go @@ -2865,6 +2865,9 @@ func (c *SNS) SetSMSAttributesRequest(input *SetSMSAttributesInput) (req *reques // information, see Publishing to a mobile phone (https://docs.aws.amazon.com/sns/latest/dg/sms_publish-to-phone.html) // in the Amazon SNS Developer Guide. // +// To use this operation, you must grant the Amazon SNS service principal (sns.amazonaws.com) +// permission to perform the s3:ListBucket action. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -4590,6 +4593,17 @@ type GetSubscriptionAttributesOutput struct { // * SubscriptionArn – The subscription's ARN. // // * TopicArn – The topic ARN that the subscription is associated with. + // + // The following attribute applies only to Amazon Kinesis Data Firehose delivery + // stream subscriptions: + // + // * SubscriptionRoleArn – The ARN of the IAM role that has the following: + // Permission to write to the Kinesis Data Firehose delivery stream Amazon + // SNS listed as a trusted entity Specifying a valid ARN for this attribute + // is required for Kinesis Data Firehose delivery stream subscriptions. For + // more information, see Fanout to Kinesis Data Firehose delivery streams + // (https://docs.aws.amazon.com/sns/latest/dg/sns-kinesis-subscriber.html) + // in the Amazon SNS Developer Guide. Attributes map[string]*string `type:"map"` } @@ -5991,6 +6005,17 @@ type SetSubscriptionAttributesInput struct { // endpoint becomes unavailable) are held in the dead-letter queue for further // analysis or reprocessing. // + // The following attribute applies only to Amazon Kinesis Data Firehose delivery + // stream subscriptions: + // + // * SubscriptionRoleArn – The ARN of the IAM role that has the following: + // Permission to write to the Kinesis Data Firehose delivery stream Amazon + // SNS listed as a trusted entity Specifying a valid ARN for this attribute + // is required for Kinesis Data Firehose delivery stream subscriptions. For + // more information, see Fanout to Kinesis Data Firehose delivery streams + // (https://docs.aws.amazon.com/sns/latest/dg/sns-kinesis-subscriber.html) + // in the Amazon SNS Developer Guide. + // // AttributeName is a required field AttributeName *string `type:"string" required:"true"` @@ -6194,33 +6219,46 @@ type SubscribeInput struct { // or server errors (for example, when the service that powers the subscribed // endpoint becomes unavailable) are held in the dead-letter queue for further // analysis or reprocessing. + // + // The following attribute applies only to Amazon Kinesis Data Firehose delivery + // stream subscriptions: + // + // * SubscriptionRoleArn – The ARN of the IAM role that has the following: + // Permission to write to the Kinesis Data Firehose delivery stream Amazon + // SNS listed as a trusted entity Specifying a valid ARN for this attribute + // is required for Kinesis Data Firehose delivery stream subscriptions. For + // more information, see Fanout to Kinesis Data Firehose delivery streams + // (https://docs.aws.amazon.com/sns/latest/dg/sns-kinesis-subscriber.html) + // in the Amazon SNS Developer Guide. Attributes map[string]*string `type:"map"` // The endpoint that you want to receive notifications. Endpoints vary by protocol: // // * For the http protocol, the (public) endpoint is a URL beginning with - // http:// + // http://. // // * For the https protocol, the (public) endpoint is a URL beginning with - // https:// + // https://. // - // * For the email protocol, the endpoint is an email address + // * For the email protocol, the endpoint is an email address. // - // * For the email-json protocol, the endpoint is an email address + // * For the email-json protocol, the endpoint is an email address. // // * For the sms protocol, the endpoint is a phone number of an SMS-enabled - // device + // device. // - // * For the sqs protocol, the endpoint is the ARN of an Amazon SQS queue + // * For the sqs protocol, the endpoint is the ARN of an Amazon SQS queue. // // * For the application protocol, the endpoint is the EndpointArn of a mobile // app and device. // - // * For the lambda protocol, the endpoint is the ARN of an Amazon Lambda - // function. + // * For the lambda protocol, the endpoint is the ARN of an AWS Lambda function. + // + // * For the firehose protocol, the endpoint is the ARN of an Amazon Kinesis + // Data Firehose delivery stream. Endpoint *string `type:"string"` - // The protocol you want to use. Supported protocols include: + // The protocol that you want to use. Supported protocols include: // // * http – delivery of JSON-encoded message via HTTP POST // @@ -6235,9 +6273,12 @@ type SubscribeInput struct { // * sqs – delivery of JSON-encoded message to an Amazon SQS queue // // * application – delivery of JSON-encoded message to an EndpointArn for - // a mobile app and device. + // a mobile app and device + // + // * lambda – delivery of JSON-encoded message to an AWS Lambda function // - // * lambda – delivery of JSON-encoded message to an Amazon Lambda function. + // * firehose – delivery of JSON-encoded message to an Amazon Kinesis Data + // Firehose delivery stream. // // Protocol is a required field Protocol *string `type:"string" required:"true"` diff --git a/service/sns/doc.go b/service/sns/doc.go index 45588677de2..714e3b87f6e 100644 --- a/service/sns/doc.go +++ b/service/sns/doc.go @@ -7,7 +7,7 @@ // you to build distributed web-enabled applications. Applications can use Amazon // SNS to easily push real-time notification messages to interested subscribers // over multiple delivery protocols. For more information about this product -// see https://aws.amazon.com/sns (http://aws.amazon.com/sns/). For detailed +// see the Amazon SNS product page (http://aws.amazon.com/sns/). For detailed // information about Amazon SNS features and their associated API calls, see // the Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/). //