diff --git a/docs/source/1.0/spec/aws/aws-ec2-query-protocol.rst b/docs/source/1.0/spec/aws/aws-ec2-query-protocol.rst index 8002f8320fb..e350be85799 100644 --- a/docs/source/1.0/spec/aws/aws-ec2-query-protocol.rst +++ b/docs/source/1.0/spec/aws/aws-ec2-query-protocol.rst @@ -33,6 +33,11 @@ Value type This protocol does not support document types. +.. important:: + + This protocol only permits the :ref:`httpPayload-trait` to be applied to + members that target structures, documents, strings, blobs, or unions. + .. tabs:: .. code-tab:: smithy diff --git a/docs/source/1.0/spec/aws/aws-json-1_0-protocol.rst b/docs/source/1.0/spec/aws/aws-json-1_0-protocol.rst index 5ef6b030afb..b86fbb616b9 100644 --- a/docs/source/1.0/spec/aws/aws-json-1_0-protocol.rst +++ b/docs/source/1.0/spec/aws/aws-json-1_0-protocol.rst @@ -56,4 +56,9 @@ See } } +.. important:: + + This protocol only permits the :ref:`httpPayload-trait` to be applied to + members that target structures, documents, strings, blobs, or unions. + *TODO: Add specifications, protocol examples, etc.* diff --git a/docs/source/1.0/spec/aws/aws-json-1_1-protocol.rst b/docs/source/1.0/spec/aws/aws-json-1_1-protocol.rst index 67ae826bdba..5cfdcdf6ddf 100644 --- a/docs/source/1.0/spec/aws/aws-json-1_1-protocol.rst +++ b/docs/source/1.0/spec/aws/aws-json-1_1-protocol.rst @@ -56,4 +56,9 @@ See } } +.. important:: + + This protocol only permits the :ref:`httpPayload-trait` to be applied to + members that target structures, documents, strings, blobs, or unions. + *TODO: Add specifications, protocol examples, etc.* diff --git a/docs/source/1.0/spec/aws/aws-query-protocol.rst b/docs/source/1.0/spec/aws/aws-query-protocol.rst index 4689c052d4d..93e1d6a239d 100644 --- a/docs/source/1.0/spec/aws/aws-query-protocol.rst +++ b/docs/source/1.0/spec/aws/aws-query-protocol.rst @@ -62,4 +62,9 @@ See This protocol does not support document types. +.. important:: + + This protocol only permits the :ref:`httpPayload-trait` to be applied to + members that target structures, documents, strings, blobs, or unions. + *TODO: Add specifications, protocol examples, etc.* diff --git a/docs/source/1.0/spec/aws/aws-restjson1-protocol.rst b/docs/source/1.0/spec/aws/aws-restjson1-protocol.rst index d12d87db889..e0675286112 100644 --- a/docs/source/1.0/spec/aws/aws-restjson1-protocol.rst +++ b/docs/source/1.0/spec/aws/aws-restjson1-protocol.rst @@ -169,6 +169,12 @@ that affect serialization: * - :ref:`httpPayload ` - Binds a top-level input or output structure member as the payload of a request or response. + + .. important:: + + This protocol only permits the :ref:`httpPayload-trait` to be applied to + members that target structures, documents, strings, blobs, or unions. + * - :ref:`httpPrefixHeaders ` - Binds a top-level input, output, or error member to a map of prefixed HTTP headers. diff --git a/docs/source/1.0/spec/core/http-traits.rst b/docs/source/1.0/spec/core/http-traits.rst index bc2f2690381..926686bde24 100644 --- a/docs/source/1.0/spec/core/http-traits.rst +++ b/docs/source/1.0/spec/core/http-traits.rst @@ -685,10 +685,11 @@ Summary Trait selector .. code-block:: none - structure > :test(member > :test(string, blob, structure, union, document)) + structure > :test(member > :test(string, blob, structure, union, document, list, set, map)) The ``httpPayload`` trait can be applied to ``structure`` members that - target a ``string``, ``blob``, ``structure``, ``union``, or ``document``. + target a ``string``, ``blob``, ``structure``, ``union``, ``document``, + ``set``, ``map``, or ``list``. Value type Annotation trait. Conflicts with @@ -749,10 +750,10 @@ or :ref:`httpPrefixHeaders-trait`. #. When a string or blob member is referenced, the raw value is serialized as the body of the message. -#. When a :ref:`structure `, :ref:`union `, or - document type is targeted, the shape value is serialized - as a :ref:`protocol-specific ` document that is - sent as the body of the message. +#. When a :ref:`structure `, :ref:`union `, :ref:`list `, + :ref:`set `, :ref:`map `, or document type is targeted, + the shape value is serialized as a :ref:`protocol-specific ` + document that is sent as the body of the message. .. _httpPrefixHeaders-trait: