@aws-sdk/client-ivs 3.37.0 → 3.38.0

package/dist-es/protocols/Aws_restJson1.js

@@ -498,9 +498,7 @@ export var serializeAws_restJson1ListTagsForResourceCommand = function (input, c
             case 0: return [4, context.endpoint()];
             case 1:
                 _a = _c.sent(), hostname = _a.hostname, _b = _a.protocol, protocol = _b === void 0 ? "https" : _b, port = _a.port, basePath = _a.path;
-                headers = {
-                    "content-type": "application/json",
-                };
+                headers = {};
                 resolvedPath = "" + ((basePath === null || basePath === void 0 ? void 0 : basePath.endsWith("/")) ? basePath.slice(0, -1) : basePath || "") + "/tags/{resourceArn}";
                 if (input.resourceArn !== undefined) {
                     labelValue = input.resourceArn;
@@ -512,7 +510,6 @@ export var serializeAws_restJson1ListTagsForResourceCommand = function (input, c
                 else {
                     throw new Error("No value provided for input HTTP label: resourceArn.");
                 }
-                body = JSON.stringify(__assign(__assign({}, (input.maxResults !== undefined && input.maxResults !== null && { maxResults: input.maxResults })), (input.nextToken !== undefined && input.nextToken !== null && { nextToken: input.nextToken })));
                 return [2, new __HttpRequest({
                         protocol: protocol,
                         hostname: hostname,
@@ -2299,7 +2296,6 @@ export var deserializeAws_restJson1ListTagsForResourceCommand = function (output
                 }
                 contents = {
                     $metadata: deserializeMetadata(output),
-                    nextToken: undefined,
                     tags: undefined,
                 };
                 _a = __expectNonNull;
@@ -2307,9 +2303,6 @@ export var deserializeAws_restJson1ListTagsForResourceCommand = function (output
                 return [4, parseBody(output.body, context)];
             case 1:
                 data = _a.apply(void 0, [_b.apply(void 0, [_c.sent()]), "body"]);
-                if (data.nextToken !== undefined && data.nextToken !== null) {
-                    contents.nextToken = __expectString(data.nextToken);
-                }
                 if (data.tags !== undefined && data.tags !== null) {
                     contents.tags = deserializeAws_restJson1Tags(data.tags, context);
                 }

package/dist-types/Ivs.d.ts

@@ -30,65 +30,24 @@ import { IvsClient } from "./IvsClient";
  * <p>
  *             <b>Introduction</b>
  *          </p>
- *
  *          <p>The Amazon Interactive Video Service (IVS) API is REST compatible, using a standard HTTP
- *       API and an AWS EventBridge event stream for responses. JSON is used for both requests and
- *       responses, including errors.</p>
- *
- *          <p>The API is an AWS regional service, currently in these regions: us-west-2, us-east-1, and
- *       eu-west-1.</p>
+ *       API and an Amazon Web Services EventBridge event stream for responses. JSON is used for both
+ *       requests and responses, including errors.</p>
+ *          <p>The API is an Amazon Web Services regional service. For a list of supported regions and
+ *       Amazon IVS HTTPS service endpoints, see the <a href="https://docs.aws.amazon.com/general/latest/gr/ivs.html">Amazon IVS page</a> in the
+ *           <i>Amazon Web Services General Reference</i>.</p>
  *          <p>
  *             <i>
  *                <b>All API request parameters and URLs are case sensitive.
  *         </b>
  *             </i>
  *          </p>
- *
  *          <p>For a summary of notable documentation changes in each release, see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/doc-history.html"> Document
  *       History</a>.</p>
  *
  *          <p>
- *             <b>Service Endpoints</b>
- *          </p>
- *          <p>The following are the Amazon IVS service endpoints (all HTTPS): </p>
- *          <p>Region name: US West (Oregon)</p>
- *          <ul>
- *             <li>
- *                <p>Region: <code>us-west-2</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>Endpoint: <code>ivs.us-west-2.amazonaws.com</code>
- *                </p>
- *             </li>
- *          </ul>
- *          <p>Region name: US East (Virginia)</p>
- *          <ul>
- *             <li>
- *                <p>Region: <code>us-east-1</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>Endpoint: <code>ivs.us-east-1.amazonaws.com</code>
- *                </p>
- *             </li>
- *          </ul>
- *          <p>Region name: EU West (Dublin)</p>
- *          <ul>
- *             <li>
- *                <p>Region: <code>eu-west-1</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>Endpoint: <code>ivs.eu-west-1.amazonaws.com</code>
- *                </p>
- *             </li>
- *          </ul>
- *
- *          <p>
  *             <b>Allowed Header Values</b>
  *          </p>
- *
  *          <ul>
  *             <li>
  *                <p>
@@ -109,13 +68,11 @@ import { IvsClient } from "./IvsClient";
  *                   </code>application/json</p>
  *             </li>
  *          </ul>
- *
  *          <p>
  *             <b>Resources</b>
  *          </p>
- *          <p>The following resources contain information about your IVS live stream (see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/getting-started.html"> Getting Started with Amazon
- *         IVS</a>):</p>
- *
+ *          <p>The following resources contain information about your IVS live stream (see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/getting-started.html"> Getting Started with
+ *         Amazon IVS</a>):</p>
  *          <ul>
  *             <li>
  *                <p>Channel — Stores configuration data related to your live stream. You first create a
@@ -143,28 +100,21 @@ import { IvsClient } from "./IvsClient";
  *           configuration. See the Recording Configuration endpoints for more information.</p>
  *             </li>
  *          </ul>
- *
- *
- *
  *          <p>
  *             <b>Tagging</b>
  *          </p>
- *
- *          <p>A <i>tag</i> is a metadata label that you assign to an AWS resource. A tag
- *       comprises a <i>key</i> and a <i>value</i>, both set by you. For
- *       example, you might set a tag as <code>topic:nature</code> to label a particular video
- *       category. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging AWS
- *         Resources</a> for more information, including restrictions that apply to tags.</p>
- *
- *          <p>Tags can help you identify and organize your AWS resources. For example, you can use the
- *       same tag for different resources to indicate that they are related. You can also use tags to
- *       manage access (see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html">
- *         Access Tags</a>). </p>
- *
+ *          <p>A <i>tag</i> is a metadata label that you assign to an Amazon Web Services
+ *       resource. A tag comprises a <i>key</i> and a <i>value</i>, both
+ *       set by you. For example, you might set a tag as <code>topic:nature</code> to label a
+ *       particular video category. See <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services Resources</a> for
+ *       more information, including restrictions that apply to tags.</p>
+ *          <p>Tags can help you identify and organize your Amazon Web Services resources. For example,
+ *       you can use the same tag for different resources to indicate that they are related. You can
+ *       also use tags to manage access (see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html"> Access Tags</a>). </p>
  *          <p>The Amazon IVS API has these tag-related endpoints: <a>TagResource</a>, <a>UntagResource</a>, and <a>ListTagsForResource</a>. The following
  *       resources support tagging: Channels, Stream Keys, Playback Key Pairs, and Recording
  *       Configurations.</p>
- *
+ *          <p>At most 50 tags can be applied to a resource. </p>
  *          <p>
  *             <b>Authentication versus Authorization</b>
  *          </p>
@@ -172,40 +122,39 @@ import { IvsClient } from "./IvsClient";
  *          <ul>
  *             <li>
  *                <p>
- *                   <i>Authentication</i> is about verifying identity. You need to be authenticated to sign Amazon IVS
- *           API requests.</p>
+ *                   <i>Authentication</i> is about verifying identity. You need to be
+ *           authenticated to sign Amazon IVS API requests.</p>
  *             </li>
  *             <li>
  *                <p>
- *                   <i>Authorization</i> is about granting permissions. You need to be authorized to
- *         view <a href="https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html">Amazon IVS private channels</a>. (Private channels are channels that are enabled for
- *           "playback authorization.")</p>
+ *                   <i>Authorization</i> is about granting permissions. You need to be
+ *           authorized to view <a href="https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html">Amazon IVS private channels</a>.
+ *           (Private channels are channels that are enabled for "playback authorization.")</p>
  *             </li>
  *          </ul>
- *
  *          <p>
  *             <b>Authentication</b>
  *          </p>
- *          <p>All Amazon IVS API requests must be authenticated with a signature. The AWS Command-Line
- *       Interface (CLI) and Amazon IVS Player SDKs take care of signing the underlying API calls for
- *       you. However, if your application calls the Amazon IVS API directly, it’s your responsibility
- *       to sign the requests.</p>
- *          <p>You generate a signature using valid AWS credentials that have permission to perform the
- *       requested action. For example, you must sign PutMetadata requests with a signature generated
- *       from an IAM user account that has the <code>ivs:PutMetadata</code> permission.</p>
+ *          <p>All Amazon IVS API requests must be authenticated with a signature. The Amazon Web Services
+ *       Command-Line Interface (CLI) and Amazon IVS Player SDKs take care of signing the underlying
+ *       API calls for you. However, if your application calls the Amazon IVS API directly, it’s your
+ *       responsibility to sign the requests.</p>
+ *          <p>You generate a signature using valid Amazon Web Services credentials that have permission
+ *       to perform the requested action. For example, you must sign PutMetadata requests with a
+ *       signature generated from an IAM user account that has the <code>ivs:PutMetadata</code>
+ *       permission.</p>
  *          <p>For more information:</p>
  *          <ul>
  *             <li>
- *                <p>Authentication and generating signatures — See <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html">Authenticating Requests (AWS Signature Version
- *         4)</a> in the <i>AWS General Reference</i>.</p>
+ *                <p>Authentication and generating signatures — See <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html">Authenticating Requests
+ *               (Amazon Web Services Signature Version 4)</a> in the <i>Amazon Web Services
+ *             General Reference</i>.</p>
  *             </li>
  *             <li>
- *                <p>Managing Amazon IVS permissions — See <a href="https://docs.aws.amazon.com/ivs/latest/userguide/security-iam.html">Identity and Access Management</a> on the Security page of
- *         the <i>Amazon IVS User Guide</i>.</p>
+ *                <p>Managing Amazon IVS permissions — See <a href="https://docs.aws.amazon.com/ivs/latest/userguide/security-iam.html">Identity and Access Management</a> on
+ *           the Security page of the <i>Amazon IVS User Guide</i>.</p>
  *             </li>
  *          </ul>
- *
- *
  *          <p>
  *             <b>Channel Endpoints</b>
  *          </p>
@@ -228,10 +177,10 @@ import { IvsClient } from "./IvsClient";
  *             <li>
  *                <p>
  *                   <a>ListChannels</a> — Gets summary information about all channels in
- *           your account, in the AWS region where the API request is processed. This list can be
- *           filtered to match a specified name or recording-configuration ARN. Filters are mutually
- *           exclusive and cannot be used together. If you try to use both filters, you will get an
- *           error (409 Conflict Exception).</p>
+ *           your account, in the Amazon Web Services region where the API request is processed. This
+ *           list can be filtered to match a specified name or recording-configuration ARN. Filters are
+ *           mutually exclusive and cannot be used together. If you try to use both filters, you will
+ *           get an error (409 Conflict Exception).</p>
  *             </li>
  *             <li>
  *                <p>
@@ -244,7 +193,6 @@ import { IvsClient } from "./IvsClient";
  *                   <a>DeleteChannel</a> — Deletes the specified channel.</p>
  *             </li>
  *          </ul>
- *
  *          <p>
  *             <b>StreamKey Endpoints</b>
  *          </p>
@@ -275,8 +223,6 @@ import { IvsClient } from "./IvsClient";
  *           ARN, so it can no longer be used to stream.</p>
  *             </li>
  *          </ul>
- *
- *
  *          <p>
  *             <b>Stream Endpoints</b>
  *          </p>
@@ -289,7 +235,7 @@ import { IvsClient } from "./IvsClient";
  *             <li>
  *                <p>
  *                   <a>ListStreams</a> — Gets summary information about live streams in
- *           your account, in the AWS region where the API request is processed.</p>
+ *           your account, in the Amazon Web Services region where the API request is processed.</p>
  *             </li>
  *             <li>
  *                <p>
@@ -300,12 +246,12 @@ import { IvsClient } from "./IvsClient";
  *             <li>
  *                <p>
  *                   <a>PutMetadata</a> — Inserts metadata into the active stream of the
- *           specified channel. A maximum of 5 requests per second per channel is allowed, each with a
+ *           specified channel. At most 5 requests per second per channel are allowed, each with a
  *           maximum 1 KB payload. (If 5 TPS is not sufficient for your needs, we recommend batching
- *           your data into a single PutMetadata call.)</p>
+ *           your data into a single PutMetadata call.) At most 155 requests per second per account are
+ *           allowed.</p>
  *             </li>
  *          </ul>
- *
  *          <p>
  *             <b>PlaybackKeyPair Endpoints</b>
  *          </p>
@@ -317,7 +263,7 @@ import { IvsClient } from "./IvsClient";
  *                   <a>ImportPlaybackKeyPair</a> — Imports the public portion of a new
  *           key pair and returns its <code>arn</code> and <code>fingerprint</code>. The
  *             <code>privateKey</code> can then be used to generate viewer authorization tokens, to
- *           grant viewers access to  private channels (channels enabled for playback
+ *           grant viewers access to private channels (channels enabled for playback
  *           authorization).</p>
  *             </li>
  *             <li>
@@ -339,26 +285,25 @@ import { IvsClient } from "./IvsClient";
  *             <code>privateKey</code>.</p>
  *             </li>
  *          </ul>
- *
  *          <p>
  *             <b>RecordingConfiguration Endpoints</b>
  *          </p>
  *          <ul>
  *             <li>
  *                <p>
- *                   <a>CreateRecordingConfiguration</a> — Creates a new recording configuration,
- *           used to enable recording to Amazon S3.</p>
+ *                   <a>CreateRecordingConfiguration</a> — Creates a new recording
+ *           configuration, used to enable recording to Amazon S3.</p>
  *             </li>
  *             <li>
  *                <p>
- *                   <a>GetRecordingConfiguration</a> — Gets the recording-configuration metadata
- *           for the specified ARN.</p>
+ *                   <a>GetRecordingConfiguration</a> — Gets the recording-configuration
+ *           metadata for the specified ARN.</p>
  *             </li>
  *             <li>
  *                <p>
- *                   <a>ListRecordingConfigurations</a> — Gets summary information about all
- *           recording configurations in your account, in the AWS region where the API request is
- *           processed.</p>
+ *                   <a>ListRecordingConfigurations</a> — Gets summary information about
+ *           all recording configurations in your account, in the Amazon Web Services region where the
+ *           API request is processed.</p>
  *             </li>
  *             <li>
  *                <p>
@@ -366,15 +311,14 @@ import { IvsClient } from "./IvsClient";
  *           configuration for the specified ARN.</p>
  *             </li>
  *          </ul>
- *
  *          <p>
- *             <b>AWS Tags Endpoints</b>
+ *             <b>Amazon Web Services Tags Endpoints</b>
  *          </p>
  *          <ul>
  *             <li>
  *                <p>
- *                   <a>TagResource</a> — Adds or updates tags for the AWS resource with
- *           the specified ARN.</p>
+ *                   <a>TagResource</a> — Adds or updates tags for the Amazon Web Services
+ *           resource with the specified ARN.</p>
  *             </li>
  *             <li>
  *                <p>
@@ -383,8 +327,7 @@ import { IvsClient } from "./IvsClient";
  *             </li>
  *             <li>
  *                <p>
- *                   <a>ListTagsForResource</a> — Gets information about AWS tags for the
- *           specified ARN.</p>
+ *                   <a>ListTagsForResource</a> — Gets information about Amazon Web Services tags for the specified ARN.</p>
  *             </li>
  *          </ul>
  */
@@ -410,7 +353,7 @@ export declare class Ivs extends IvsClient {
     /**
      * <p>Creates a new recording configuration, used to enable recording to Amazon S3.</p>
      *          <p>
-     *             <b>Known issue:</b> In the us-east-1 region, if you use the AWS
+     *             <b>Known issue:</b> In the us-east-1 region, if you use the Amazon Web Services
      *       CLI to create a recording configuration, it returns success even if the S3 bucket is in a
      *       different region. In this case, the <code>state</code> of the recording configuration is
      *         <code>CREATE_FAILED</code> (instead of <code>ACTIVE</code>). (In other regions, the CLI
@@ -514,7 +457,7 @@ export declare class Ivs extends IvsClient {
     importPlaybackKeyPair(args: ImportPlaybackKeyPairCommandInput, cb: (err: any, data?: ImportPlaybackKeyPairCommandOutput) => void): void;
     importPlaybackKeyPair(args: ImportPlaybackKeyPairCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ImportPlaybackKeyPairCommandOutput) => void): void;
     /**
-     * <p>Gets summary information about all channels in your account, in the AWS region where the
+     * <p>Gets summary information about all channels in your account, in the Amazon Web Services region where the
      *       API request is processed. This list can be filtered to match a specified name or
      *       recording-configuration ARN. Filters are mutually exclusive and cannot be used together. If
      *       you try to use both filters, you will get an error (409 ConflictException).</p>
@@ -530,7 +473,7 @@ export declare class Ivs extends IvsClient {
     listPlaybackKeyPairs(args: ListPlaybackKeyPairsCommandInput, cb: (err: any, data?: ListPlaybackKeyPairsCommandOutput) => void): void;
     listPlaybackKeyPairs(args: ListPlaybackKeyPairsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListPlaybackKeyPairsCommandOutput) => void): void;
     /**
-     * <p>Gets summary information about all recording configurations in your account, in the AWS
+     * <p>Gets summary information about all recording configurations in your account, in the Amazon Web Services
      *       region where the API request is processed.</p>
      */
     listRecordingConfigurations(args: ListRecordingConfigurationsCommandInput, options?: __HttpHandlerOptions): Promise<ListRecordingConfigurationsCommandOutput>;
@@ -543,26 +486,24 @@ export declare class Ivs extends IvsClient {
     listStreamKeys(args: ListStreamKeysCommandInput, cb: (err: any, data?: ListStreamKeysCommandOutput) => void): void;
     listStreamKeys(args: ListStreamKeysCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListStreamKeysCommandOutput) => void): void;
     /**
-     * <p>Gets summary information about live streams in your account, in the AWS region where the
+     * <p>Gets summary information about live streams in your account, in the Amazon Web Services region where the
      *       API request is processed.</p>
      */
     listStreams(args: ListStreamsCommandInput, options?: __HttpHandlerOptions): Promise<ListStreamsCommandOutput>;
     listStreams(args: ListStreamsCommandInput, cb: (err: any, data?: ListStreamsCommandOutput) => void): void;
     listStreams(args: ListStreamsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListStreamsCommandOutput) => void): void;
     /**
-     * <p>Gets information about AWS tags for the specified ARN.</p>
+     * <p>Gets information about Amazon Web Services tags for the specified ARN.</p>
      */
     listTagsForResource(args: ListTagsForResourceCommandInput, options?: __HttpHandlerOptions): Promise<ListTagsForResourceCommandOutput>;
     listTagsForResource(args: ListTagsForResourceCommandInput, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
     listTagsForResource(args: ListTagsForResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
     /**
-     * <p>Inserts metadata into the active stream of the specified channel. A maximum of 5 requests
-     *       per second per channel is allowed, each with a maximum 1 KB payload. (If 5 TPS is not
-     *       sufficient for your needs, we recommend batching your data into a single PutMetadata call.)
-     *
-     *       Also see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/metadata.html">Embedding Metadata
-     *
-     *         within a Video Stream</a> in the <i>Amazon IVS User Guide</i>.</p>
+     * <p>Inserts metadata into the active stream of the specified channel.  At most 5 requests per
+     *       second per channel are allowed, each with a maximum 1 KB payload. (If 5 TPS is not sufficient
+     *       for your needs, we recommend batching your data into a single PutMetadata call.) At most 155
+     *       requests per second per account are allowed. Also see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/metadata.html">Embedding Metadata within a Video Stream</a> in
+     *       the <i>Amazon IVS User Guide</i>.</p>
      */
     putMetadata(args: PutMetadataCommandInput, options?: __HttpHandlerOptions): Promise<PutMetadataCommandOutput>;
     putMetadata(args: PutMetadataCommandInput, cb: (err: any, data?: PutMetadataCommandOutput) => void): void;
@@ -581,7 +522,7 @@ export declare class Ivs extends IvsClient {
     stopStream(args: StopStreamCommandInput, cb: (err: any, data?: StopStreamCommandOutput) => void): void;
     stopStream(args: StopStreamCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StopStreamCommandOutput) => void): void;
     /**
-     * <p>Adds or updates tags for the AWS resource with the specified ARN.</p>
+     * <p>Adds or updates tags for the Amazon Web Services resource with the specified ARN.</p>
      */
     tagResource(args: TagResourceCommandInput, options?: __HttpHandlerOptions): Promise<TagResourceCommandOutput>;
     tagResource(args: TagResourceCommandInput, cb: (err: any, data?: TagResourceCommandOutput) => void): void;