aws-sdk-sns 1.47.0 → 1.48.0

data/lib/aws-sdk-sns/client_api.rb

@@ -17,6 +17,10 @@ module Aws::SNS
     AddPermissionInput = Shapes::StructureShape.new(name: 'AddPermissionInput')
     AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
     AuthorizationErrorException = Shapes::StructureShape.new(name: 'AuthorizationErrorException')
+    BatchEntryIdsNotDistinctException = Shapes::StructureShape.new(name: 'BatchEntryIdsNotDistinctException')
+    BatchRequestTooLongException = Shapes::StructureShape.new(name: 'BatchRequestTooLongException')
+    BatchResultErrorEntry = Shapes::StructureShape.new(name: 'BatchResultErrorEntry')
+    BatchResultErrorEntryList = Shapes::ListShape.new(name: 'BatchResultErrorEntryList')
     Binary = Shapes::BlobShape.new(name: 'Binary')
     CheckIfPhoneNumberIsOptedOutInput = Shapes::StructureShape.new(name: 'CheckIfPhoneNumberIsOptedOutInput')
     CheckIfPhoneNumberIsOptedOutResponse = Shapes::StructureShape.new(name: 'CheckIfPhoneNumberIsOptedOutResponse')
@@ -37,6 +41,7 @@ module Aws::SNS
     DeleteSMSSandboxPhoneNumberInput = Shapes::StructureShape.new(name: 'DeleteSMSSandboxPhoneNumberInput')
     DeleteSMSSandboxPhoneNumberResult = Shapes::StructureShape.new(name: 'DeleteSMSSandboxPhoneNumberResult')
     DeleteTopicInput = Shapes::StructureShape.new(name: 'DeleteTopicInput')
+    EmptyBatchRequestException = Shapes::StructureShape.new(name: 'EmptyBatchRequestException')
     Endpoint = Shapes::StructureShape.new(name: 'Endpoint')
     EndpointDisabledException = Shapes::StructureShape.new(name: 'EndpointDisabledException')
     FilterPolicyLimitExceededException = Shapes::StructureShape.new(name: 'FilterPolicyLimitExceededException')
@@ -53,6 +58,7 @@ module Aws::SNS
     GetTopicAttributesInput = Shapes::StructureShape.new(name: 'GetTopicAttributesInput')
     GetTopicAttributesResponse = Shapes::StructureShape.new(name: 'GetTopicAttributesResponse')
     InternalErrorException = Shapes::StructureShape.new(name: 'InternalErrorException')
+    InvalidBatchEntryIdException = Shapes::StructureShape.new(name: 'InvalidBatchEntryIdException')
     InvalidParameterException = Shapes::StructureShape.new(name: 'InvalidParameterException')
     InvalidParameterValueException = Shapes::StructureShape.new(name: 'InvalidParameterValueException')
     InvalidSecurityException = Shapes::StructureShape.new(name: 'InvalidSecurityException')
@@ -104,6 +110,12 @@ module Aws::SNS
     PhoneNumberString = Shapes::StringShape.new(name: 'PhoneNumberString')
     PlatformApplication = Shapes::StructureShape.new(name: 'PlatformApplication')
     PlatformApplicationDisabledException = Shapes::StructureShape.new(name: 'PlatformApplicationDisabledException')
+    PublishBatchInput = Shapes::StructureShape.new(name: 'PublishBatchInput')
+    PublishBatchRequestEntry = Shapes::StructureShape.new(name: 'PublishBatchRequestEntry')
+    PublishBatchRequestEntryList = Shapes::ListShape.new(name: 'PublishBatchRequestEntryList')
+    PublishBatchResponse = Shapes::StructureShape.new(name: 'PublishBatchResponse')
+    PublishBatchResultEntry = Shapes::StructureShape.new(name: 'PublishBatchResultEntry')
+    PublishBatchResultEntryList = Shapes::ListShape.new(name: 'PublishBatchResultEntryList')
     PublishInput = Shapes::StructureShape.new(name: 'PublishInput')
     PublishResponse = Shapes::StructureShape.new(name: 'PublishResponse')
     RemovePermissionInput = Shapes::StructureShape.new(name: 'RemovePermissionInput')
@@ -137,6 +149,7 @@ module Aws::SNS
     TagValue = Shapes::StringShape.new(name: 'TagValue')
     ThrottledException = Shapes::StructureShape.new(name: 'ThrottledException')
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
+    TooManyEntriesInBatchRequestException = Shapes::StructureShape.new(name: 'TooManyEntriesInBatchRequestException')
     Topic = Shapes::StructureShape.new(name: 'Topic')
     TopicAttributesMap = Shapes::MapShape.new(name: 'TopicAttributesMap')
     TopicLimitExceededException = Shapes::StructureShape.new(name: 'TopicLimitExceededException')
@@ -181,6 +194,20 @@ module Aws::SNS
     AuthorizationErrorException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
     AuthorizationErrorException.struct_class = Types::AuthorizationErrorException
 
+    BatchEntryIdsNotDistinctException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
+    BatchEntryIdsNotDistinctException.struct_class = Types::BatchEntryIdsNotDistinctException
+
+    BatchRequestTooLongException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
+    BatchRequestTooLongException.struct_class = Types::BatchRequestTooLongException
+
+    BatchResultErrorEntry.add_member(:id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Id"))
+    BatchResultErrorEntry.add_member(:code, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Code"))
+    BatchResultErrorEntry.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
+    BatchResultErrorEntry.add_member(:sender_fault, Shapes::ShapeRef.new(shape: boolean, required: true, location_name: "SenderFault"))
+    BatchResultErrorEntry.struct_class = Types::BatchResultErrorEntry
+
+    BatchResultErrorEntryList.member = Shapes::ShapeRef.new(shape: BatchResultErrorEntry)
+
     CheckIfPhoneNumberIsOptedOutInput.add_member(:phone_number, Shapes::ShapeRef.new(shape: PhoneNumber, required: true, location_name: "phoneNumber"))
     CheckIfPhoneNumberIsOptedOutInput.struct_class = Types::CheckIfPhoneNumberIsOptedOutInput
 
@@ -245,6 +272,9 @@ module Aws::SNS
     DeleteTopicInput.add_member(:topic_arn, Shapes::ShapeRef.new(shape: topicARN, required: true, location_name: "TopicArn"))
     DeleteTopicInput.struct_class = Types::DeleteTopicInput
 
+    EmptyBatchRequestException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
+    EmptyBatchRequestException.struct_class = Types::EmptyBatchRequestException
+
     Endpoint.add_member(:endpoint_arn, Shapes::ShapeRef.new(shape: String, location_name: "EndpointArn"))
     Endpoint.add_member(:attributes, Shapes::ShapeRef.new(shape: MapStringToString, location_name: "Attributes"))
     Endpoint.struct_class = Types::Endpoint
@@ -293,6 +323,9 @@ module Aws::SNS
     InternalErrorException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
     InternalErrorException.struct_class = Types::InternalErrorException
 
+    InvalidBatchEntryIdException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
+    InvalidBatchEntryIdException.struct_class = Types::InvalidBatchEntryIdException
+
     InvalidParameterException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
     InvalidParameterException.struct_class = Types::InvalidParameterException
 
@@ -435,6 +468,32 @@ module Aws::SNS
     PlatformApplicationDisabledException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
     PlatformApplicationDisabledException.struct_class = Types::PlatformApplicationDisabledException
 
+    PublishBatchInput.add_member(:topic_arn, Shapes::ShapeRef.new(shape: topicARN, required: true, location_name: "TopicArn"))
+    PublishBatchInput.add_member(:publish_batch_request_entries, Shapes::ShapeRef.new(shape: PublishBatchRequestEntryList, required: true, location_name: "PublishBatchRequestEntries"))
+    PublishBatchInput.struct_class = Types::PublishBatchInput
+
+    PublishBatchRequestEntry.add_member(:id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Id"))
+    PublishBatchRequestEntry.add_member(:message, Shapes::ShapeRef.new(shape: message, required: true, location_name: "Message"))
+    PublishBatchRequestEntry.add_member(:subject, Shapes::ShapeRef.new(shape: subject, location_name: "Subject"))
+    PublishBatchRequestEntry.add_member(:message_structure, Shapes::ShapeRef.new(shape: messageStructure, location_name: "MessageStructure"))
+    PublishBatchRequestEntry.add_member(:message_attributes, Shapes::ShapeRef.new(shape: MessageAttributeMap, location_name: "MessageAttributes"))
+    PublishBatchRequestEntry.add_member(:message_deduplication_id, Shapes::ShapeRef.new(shape: String, location_name: "MessageDeduplicationId"))
+    PublishBatchRequestEntry.add_member(:message_group_id, Shapes::ShapeRef.new(shape: String, location_name: "MessageGroupId"))
+    PublishBatchRequestEntry.struct_class = Types::PublishBatchRequestEntry
+
+    PublishBatchRequestEntryList.member = Shapes::ShapeRef.new(shape: PublishBatchRequestEntry)
+
+    PublishBatchResponse.add_member(:successful, Shapes::ShapeRef.new(shape: PublishBatchResultEntryList, location_name: "Successful"))
+    PublishBatchResponse.add_member(:failed, Shapes::ShapeRef.new(shape: BatchResultErrorEntryList, location_name: "Failed"))
+    PublishBatchResponse.struct_class = Types::PublishBatchResponse
+
+    PublishBatchResultEntry.add_member(:id, Shapes::ShapeRef.new(shape: String, location_name: "Id"))
+    PublishBatchResultEntry.add_member(:message_id, Shapes::ShapeRef.new(shape: messageId, location_name: "MessageId"))
+    PublishBatchResultEntry.add_member(:sequence_number, Shapes::ShapeRef.new(shape: String, location_name: "SequenceNumber"))
+    PublishBatchResultEntry.struct_class = Types::PublishBatchResultEntry
+
+    PublishBatchResultEntryList.member = Shapes::ShapeRef.new(shape: PublishBatchResultEntry)
+
     PublishInput.add_member(:topic_arn, Shapes::ShapeRef.new(shape: topicARN, location_name: "TopicArn"))
     PublishInput.add_member(:target_arn, Shapes::ShapeRef.new(shape: String, location_name: "TargetArn"))
     PublishInput.add_member(:phone_number, Shapes::ShapeRef.new(shape: String, location_name: "PhoneNumber"))
@@ -537,6 +596,9 @@ module Aws::SNS
     ThrottledException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
     ThrottledException.struct_class = Types::ThrottledException
 
+    TooManyEntriesInBatchRequestException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "message"))
+    TooManyEntriesInBatchRequestException.struct_class = Types::TooManyEntriesInBatchRequestException
+
     Topic.add_member(:topic_arn, Shapes::ShapeRef.new(shape: topicARN, location_name: "TopicArn"))
     Topic.struct_class = Types::Topic
 
@@ -990,6 +1052,33 @@ module Aws::SNS
         o.errors << Shapes::ShapeRef.new(shape: InvalidSecurityException)
       end)
 
+      api.add_operation(:publish_batch, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PublishBatch"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: PublishBatchInput)
+        o.output = Shapes::ShapeRef.new(shape: PublishBatchResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: EndpointDisabledException)
+        o.errors << Shapes::ShapeRef.new(shape: PlatformApplicationDisabledException)
+        o.errors << Shapes::ShapeRef.new(shape: AuthorizationErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: BatchEntryIdsNotDistinctException)
+        o.errors << Shapes::ShapeRef.new(shape: BatchRequestTooLongException)
+        o.errors << Shapes::ShapeRef.new(shape: EmptyBatchRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidBatchEntryIdException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyEntriesInBatchRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: KMSDisabledException)
+        o.errors << Shapes::ShapeRef.new(shape: KMSInvalidStateException)
+        o.errors << Shapes::ShapeRef.new(shape: KMSNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: KMSOptInRequired)
+        o.errors << Shapes::ShapeRef.new(shape: KMSThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: KMSAccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidSecurityException)
+      end)
+
       api.add_operation(:remove_permission, Seahorse::Model::Operation.new.tap do |o|
         o.name = "RemovePermission"
         o.http_method = "POST"

data/lib/aws-sdk-sns/errors.rb

@@ -28,10 +28,14 @@ module Aws::SNS
   #
   # ## Error Classes
   # * {AuthorizationErrorException}
+  # * {BatchEntryIdsNotDistinctException}
+  # * {BatchRequestTooLongException}
   # * {ConcurrentAccessException}
+  # * {EmptyBatchRequestException}
   # * {EndpointDisabledException}
   # * {FilterPolicyLimitExceededException}
   # * {InternalErrorException}
+  # * {InvalidBatchEntryIdException}
   # * {InvalidParameterException}
   # * {InvalidParameterValueException}
   # * {InvalidSecurityException}
@@ -50,6 +54,7 @@ module Aws::SNS
   # * {TagLimitExceededException}
   # * {TagPolicyException}
   # * {ThrottledException}
+  # * {TooManyEntriesInBatchRequestException}
   # * {TopicLimitExceededException}
   # * {UserErrorException}
   # * {ValidationException}
@@ -76,6 +81,36 @@ module Aws::SNS
       end
     end
 
+    class BatchEntryIdsNotDistinctException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::SNS::Types::BatchEntryIdsNotDistinctException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
+    class BatchRequestTooLongException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::SNS::Types::BatchRequestTooLongException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class ConcurrentAccessException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -91,6 +126,21 @@ module Aws::SNS
       end
     end
 
+    class EmptyBatchRequestException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::SNS::Types::EmptyBatchRequestException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class EndpointDisabledException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -136,6 +186,21 @@ module Aws::SNS
       end
     end
 
+    class InvalidBatchEntryIdException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::SNS::Types::InvalidBatchEntryIdException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class InvalidParameterException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -406,6 +471,21 @@ module Aws::SNS
       end
     end
 
+    class TooManyEntriesInBatchRequestException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::SNS::Types::TooManyEntriesInBatchRequestException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class TopicLimitExceededException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

data/lib/aws-sdk-sns/platform_application.rb

@@ -36,6 +36,15 @@ module Aws::SNS
 
     # Attributes include the following:
     #
+    # * `AppleCertificateExpiryDate` – The expiry date of the SSL
+    #   certificate used to configure certificate-based authentication.
+    #
+    # * `ApplePlatformTeamID` – The Apple developer account ID used to
+    #   configure token-based authentication.
+    #
+    # * `ApplePlatformBundleID` – The app identifier used to configure
+    #   token-based authentication.
+    #
     # * `EventEndpointCreated` – Topic ARN to which EndpointCreated event
     #   notifications should be sent.
     #
@@ -150,15 +159,34 @@ module Aws::SNS
     #   include the following:
     #
     #   * `PlatformCredential` – The credential received from the notification
-    #     service. For `APNS` and `APNS_SANDBOX`, `PlatformCredential` is
-    #     `private key`. For `GCM` (Firebase Cloud Messaging),
-    #     `PlatformCredential` is `API key`. For `ADM`, `PlatformCredential`
-    #     is `client secret`.
+    #     service.
+    #
+    #     * For ADM, `PlatformCredential`is client secret.
+    #
+    #     * For Apple Services using certificate credentials,
+    #       `PlatformCredential` is private key.
+    #
+    #     * For Apple Services using token credentials, `PlatformCredential`
+    #       is signing key.
+    #
+    #     * For GCM (Firebase Cloud Messaging), `PlatformCredential` is API
+    #       key.
+    #   ^
     #
     #   * `PlatformPrincipal` – The principal received from the notification
-    #     service. For `APNS` and `APNS_SANDBOX`, `PlatformPrincipal` is `SSL
-    #     certificate`. For `GCM` (Firebase Cloud Messaging), there is no
-    #     `PlatformPrincipal`. For `ADM`, `PlatformPrincipal` is `client id`.
+    #     service.
+    #
+    #     * For ADM, `PlatformPrincipal`is client id.
+    #
+    #     * For Apple Services using certificate credentials,
+    #       `PlatformPrincipal` is SSL certificate.
+    #
+    #     * For Apple Services using token credentials, `PlatformPrincipal` is
+    #       signing key ID.
+    #
+    #     * For GCM (Firebase Cloud Messaging), there is no
+    #       `PlatformPrincipal`.
+    #   ^
     #
     #   * `EventEndpointCreated` – Topic ARN to which `EndpointCreated` event
     #     notifications are sent.
@@ -181,6 +209,15 @@ module Aws::SNS
     #
     #   * `SuccessFeedbackSampleRate` – Sample rate percentage (0-100) of
     #     successfully delivered messages.
+    #
+    #   The following attributes only apply to `APNs` token-based
+    #   authentication:
+    #
+    #   * `ApplePlatformTeamID` – The identifier that's assigned to your
+    #     Apple developer account team.
+    #
+    #   * `ApplePlatformBundleID` – The bundle identifier that's assigned to
+    #     your iOS app.
     # @return [EmptyStructure]
     def set_attributes(options = {})
       options = options.merge(platform_application_arn: @arn)

data/lib/aws-sdk-sns/platform_endpoint.rb

@@ -220,7 +220,7 @@ module Aws::SNS
     # @option options [String] :message_deduplication_id
     #   This parameter applies only to FIFO (first-in-first-out) topics. The
     #   `MessageDeduplicationId` can contain up to 128 alphanumeric characters
-    #   (a-z, A-Z, 0-9) and punctuation ``
+    #   `(a-z, A-Z, 0-9)` and punctuation ``
     #   (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
     #
     #   Every message must have a unique `MessageDeduplicationId`, which is a
@@ -234,8 +234,8 @@ module Aws::SNS
     #   `MessageDeduplicationId` overrides the generated one.
     # @option options [String] :message_group_id
     #   This parameter applies only to FIFO (first-in-first-out) topics. The
-    #   `MessageGroupId` can contain up to 128 alphanumeric characters (a-z,
-    #   A-Z, 0-9) and punctuation `` (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
+    #   `MessageGroupId` can contain up to 128 alphanumeric characters `(a-z,
+    #   A-Z, 0-9)` and punctuation `` (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
     #
     #   The `MessageGroupId` is a tag that specifies that a message belongs to
     #   a specific message group. Messages that belong to the same message

data/lib/aws-sdk-sns/subscription.rb

@@ -51,7 +51,8 @@ module Aws::SNS
     #   subscription. For more information, see [Amazon SNS Message
     #   Filtering][1] in the *Amazon SNS Developer Guide*.
     #
-    # * `Owner` – The account ID of the subscription's owner.
+    # * `Owner` – The Amazon Web Services account ID of the subscription's
+    #   owner.
     #
     # * `PendingConfirmation` – `true` if the subscription hasn't been
     #   confirmed. To confirm a pending subscription, call the

data/lib/aws-sdk-sns/topic.rb

@@ -43,7 +43,7 @@ module Aws::SNS
     # * `DisplayName` – The human-readable name used in the `From` field for
     #   notifications to `email` and `email-json` endpoints.
     #
-    # * `Owner` – The account ID of the topic's owner.
+    # * `Owner` – The Amazon Web Services account ID of the topic's owner.
     #
     # * `Policy` – The JSON serialization of the topic's access control
     #   policy.
@@ -151,9 +151,10 @@ module Aws::SNS
     # @option options [required, String] :label
     #   A unique identifier for the new policy statement.
     # @option options [required, Array<String>] :aws_account_id
-    #   The account IDs of the users (principals) who will be given access to
-    #   the specified actions. The users must have account, but do not need to
-    #   be signed up for this service.
+    #   The Amazon Web Services account IDs of the users (principals) who will
+    #   be given access to the specified actions. The users must have Amazon
+    #   Web Services account, but do not need to be signed up for this
+    #   service.
     # @option options [required, Array<String>] :action_name
     #   The action you want to allow for the specified principal(s).
     #
@@ -313,7 +314,7 @@ module Aws::SNS
     # @option options [String] :message_deduplication_id
     #   This parameter applies only to FIFO (first-in-first-out) topics. The
     #   `MessageDeduplicationId` can contain up to 128 alphanumeric characters
-    #   (a-z, A-Z, 0-9) and punctuation ``
+    #   `(a-z, A-Z, 0-9)` and punctuation ``
     #   (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
     #
     #   Every message must have a unique `MessageDeduplicationId`, which is a
@@ -327,8 +328,8 @@ module Aws::SNS
     #   `MessageDeduplicationId` overrides the generated one.
     # @option options [String] :message_group_id
     #   This parameter applies only to FIFO (first-in-first-out) topics. The
-    #   `MessageGroupId` can contain up to 128 alphanumeric characters (a-z,
-    #   A-Z, 0-9) and punctuation `` (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
+    #   `MessageGroupId` can contain up to 128 alphanumeric characters `(a-z,
+    #   A-Z, 0-9)` and punctuation `` (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
     #
     #   The `MessageGroupId` is a tag that specifies that a message belongs to
     #   a specific message group. Messages that belong to the same message