feat(client-mediapackagev2): This release adds the ResetChannelState and ResetOriginEndpointState operation to reset MediaPackage V2 channel and origin endpoint. This release also adds a new field, UrlEncodeChildManifest, for HLS/LL-HLS to allow URL-encoding child manifest query string based on the requirements of AWS SigV4.

Author: awstools

clients/client-mediapackagev2/README.md

@@ -397,6 +397,22 @@ PutOriginEndpointPolicy
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/mediapackagev2/command/PutOriginEndpointPolicyCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediapackagev2/Interface/PutOriginEndpointPolicyCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediapackagev2/Interface/PutOriginEndpointPolicyCommandOutput/)
 
+</details>
+<details>
+<summary>
+ResetChannelState
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/mediapackagev2/command/ResetChannelStateCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediapackagev2/Interface/ResetChannelStateCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediapackagev2/Interface/ResetChannelStateCommandOutput/)
+
+</details>
+<details>
+<summary>
+ResetOriginEndpointState
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/mediapackagev2/command/ResetOriginEndpointStateCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediapackagev2/Interface/ResetOriginEndpointStateCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediapackagev2/Interface/ResetOriginEndpointStateCommandOutput/)
+
 </details>
 <details>
 <summary>

clients/client-mediapackagev2/src/MediaPackageV2.ts

@@ -113,6 +113,16 @@ import {
   PutOriginEndpointPolicyCommandInput,
   PutOriginEndpointPolicyCommandOutput,
 } from "./commands/PutOriginEndpointPolicyCommand";
+import {
+  ResetChannelStateCommand,
+  ResetChannelStateCommandInput,
+  ResetChannelStateCommandOutput,
+} from "./commands/ResetChannelStateCommand";
+import {
+  ResetOriginEndpointStateCommand,
+  ResetOriginEndpointStateCommandInput,
+  ResetOriginEndpointStateCommandOutput,
+} from "./commands/ResetOriginEndpointStateCommand";
 import { TagResourceCommand, TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import {
   UntagResourceCommand,
@@ -160,6 +170,8 @@ const commands = {
   ListTagsForResourceCommand,
   PutChannelPolicyCommand,
   PutOriginEndpointPolicyCommand,
+  ResetChannelStateCommand,
+  ResetOriginEndpointStateCommand,
   TagResourceCommand,
   UntagResourceCommand,
   UpdateChannelCommand,
@@ -524,6 +536,40 @@ export interface MediaPackageV2 {
     cb: (err: any, data?: PutOriginEndpointPolicyCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ResetChannelStateCommand}
+   */
+  resetChannelState(
+    args: ResetChannelStateCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ResetChannelStateCommandOutput>;
+  resetChannelState(
+    args: ResetChannelStateCommandInput,
+    cb: (err: any, data?: ResetChannelStateCommandOutput) => void
+  ): void;
+  resetChannelState(
+    args: ResetChannelStateCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ResetChannelStateCommandOutput) => void
+  ): void;
+
+  /**
+   * @see {@link ResetOriginEndpointStateCommand}
+   */
+  resetOriginEndpointState(
+    args: ResetOriginEndpointStateCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ResetOriginEndpointStateCommandOutput>;
+  resetOriginEndpointState(
+    args: ResetOriginEndpointStateCommandInput,
+    cb: (err: any, data?: ResetOriginEndpointStateCommandOutput) => void
+  ): void;
+  resetOriginEndpointState(
+    args: ResetOriginEndpointStateCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ResetOriginEndpointStateCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link TagResourceCommand}
    */

clients/client-mediapackagev2/src/MediaPackageV2Client.ts

@@ -100,6 +100,11 @@ import {
   PutOriginEndpointPolicyCommandInput,
   PutOriginEndpointPolicyCommandOutput,
 } from "./commands/PutOriginEndpointPolicyCommand";
+import { ResetChannelStateCommandInput, ResetChannelStateCommandOutput } from "./commands/ResetChannelStateCommand";
+import {
+  ResetOriginEndpointStateCommandInput,
+  ResetOriginEndpointStateCommandOutput,
+} from "./commands/ResetOriginEndpointStateCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
 import { UpdateChannelCommandInput, UpdateChannelCommandOutput } from "./commands/UpdateChannelCommand";
@@ -146,6 +151,8 @@ export type ServiceInputTypes =
   | ListTagsForResourceCommandInput
   | PutChannelPolicyCommandInput
   | PutOriginEndpointPolicyCommandInput
+  | ResetChannelStateCommandInput
+  | ResetOriginEndpointStateCommandInput
   | TagResourceCommandInput
   | UntagResourceCommandInput
   | UpdateChannelCommandInput
@@ -179,6 +186,8 @@ export type ServiceOutputTypes =
   | ListTagsForResourceCommandOutput
   | PutChannelPolicyCommandOutput
   | PutOriginEndpointPolicyCommandOutput
+  | ResetChannelStateCommandOutput
+  | ResetOriginEndpointStateCommandOutput
   | TagResourceCommandOutput
   | UntagResourceCommandOutput
   | UpdateChannelCommandOutput

clients/client-mediapackagev2/src/commands/CreateOriginEndpointCommand.ts

@@ -95,6 +95,7 @@ export interface CreateOriginEndpointCommandOutput extends CreateOriginEndpointR
  *         TimeDelaySeconds: Number("int"),
  *         ClipStartTime: new Date("TIMESTAMP"),
  *       },
+ *       UrlEncodeChildManifest: true || false,
  *     },
  *   ],
  *   LowLatencyHlsManifests: [ // CreateLowLatencyHlsManifests
@@ -117,6 +118,7 @@ export interface CreateOriginEndpointCommandOutput extends CreateOriginEndpointR
  *         TimeDelaySeconds: Number("int"),
  *         ClipStartTime: new Date("TIMESTAMP"),
  *       },
+ *       UrlEncodeChildManifest: true || false,
  *     },
  *   ],
  *   DashManifests: [ // CreateDashManifests
@@ -221,6 +223,7 @@ export interface CreateOriginEndpointCommandOutput extends CreateOriginEndpointR
  * //         TimeOffset: Number("float"), // required
  * //         Precise: true || false,
  * //       },
+ * //       UrlEncodeChildManifest: true || false,
  * //     },
  * //   ],
  * //   LowLatencyHlsManifests: [ // GetLowLatencyHlsManifests
@@ -244,6 +247,7 @@ export interface CreateOriginEndpointCommandOutput extends CreateOriginEndpointR
  * //         TimeOffset: Number("float"), // required
  * //         Precise: true || false,
  * //       },
+ * //       UrlEncodeChildManifest: true || false,
  * //     },
  * //   ],
  * //   DashManifests: [ // GetDashManifests

clients/client-mediapackagev2/src/commands/GetChannelCommand.ts

@@ -47,6 +47,7 @@ export interface GetChannelCommandOutput extends GetChannelResponse, __MetadataB
  * //   ChannelGroupName: "STRING_VALUE", // required
  * //   CreatedAt: new Date("TIMESTAMP"), // required
  * //   ModifiedAt: new Date("TIMESTAMP"), // required
+ * //   ResetAt: new Date("TIMESTAMP"),
  * //   Description: "STRING_VALUE",
  * //   IngestEndpoints: [ // IngestEndpointList
  * //     { // IngestEndpoint

clients/client-mediapackagev2/src/commands/GetOriginEndpointCommand.ts

@@ -82,6 +82,7 @@ export interface GetOriginEndpointCommandOutput extends GetOriginEndpointRespons
  * //   },
  * //   CreatedAt: new Date("TIMESTAMP"), // required
  * //   ModifiedAt: new Date("TIMESTAMP"), // required
+ * //   ResetAt: new Date("TIMESTAMP"),
  * //   Description: "STRING_VALUE",
  * //   StartoverWindowSeconds: Number("int"),
  * //   HlsManifests: [ // GetHlsManifests
@@ -105,6 +106,7 @@ export interface GetOriginEndpointCommandOutput extends GetOriginEndpointRespons
  * //         TimeOffset: Number("float"), // required
  * //         Precise: true || false,
  * //       },
+ * //       UrlEncodeChildManifest: true || false,
  * //     },
  * //   ],
  * //   LowLatencyHlsManifests: [ // GetLowLatencyHlsManifests
@@ -128,6 +130,7 @@ export interface GetOriginEndpointCommandOutput extends GetOriginEndpointRespons
  * //         TimeOffset: Number("float"), // required
  * //         Precise: true || false,
  * //       },
+ * //       UrlEncodeChildManifest: true || false,
  * //     },
  * //   ],
  * //   DashManifests: [ // GetDashManifests

clients/client-mediapackagev2/src/commands/ListChannelGroupsCommand.ts

@@ -28,7 +28,7 @@ export interface ListChannelGroupsCommandInput extends ListChannelGroupsRequest
 export interface ListChannelGroupsCommandOutput extends ListChannelGroupsResponse, __MetadataBearer {}
 
 /**
- * <p>Retrieves all channel groups that are configured in AWS Elemental MediaPackage, including the channels and origin endpoints that are associated with it.</p>
+ * <p>Retrieves all channel groups that are configured in Elemental MediaPackage.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-mediapackagev2/src/commands/ResetChannelStateCommand.ts

@@ -0,0 +1,115 @@
+// smithy-typescript generated code
+import { getEndpointPlugin } from "@smithy/middleware-endpoint";
+import { getSerdePlugin } from "@smithy/middleware-serde";
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+
+import { commonParams } from "../endpoint/EndpointParameters";
+import { MediaPackageV2ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../MediaPackageV2Client";
+import { ResetChannelStateRequest, ResetChannelStateResponse } from "../models/models_0";
+import { de_ResetChannelStateCommand, se_ResetChannelStateCommand } from "../protocols/Aws_restJson1";
+
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link ResetChannelStateCommand}.
+ */
+export interface ResetChannelStateCommandInput extends ResetChannelStateRequest {}
+/**
+ * @public
+ *
+ * The output of {@link ResetChannelStateCommand}.
+ */
+export interface ResetChannelStateCommandOutput extends ResetChannelStateResponse, __MetadataBearer {}
+
+/**
+ * <p>Resetting the channel can help to clear errors from misconfigurations in the encoder. A reset refreshes the ingest stream and removes previous content. </p>
+ *          <p> Be sure to stop the encoder before you reset the channel, and wait at least 30 seconds before you restart the encoder. </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { MediaPackageV2Client, ResetChannelStateCommand } from "@aws-sdk/client-mediapackagev2"; // ES Modules import
+ * // const { MediaPackageV2Client, ResetChannelStateCommand } = require("@aws-sdk/client-mediapackagev2"); // CommonJS import
+ * const client = new MediaPackageV2Client(config);
+ * const input = { // ResetChannelStateRequest
+ *   ChannelGroupName: "STRING_VALUE", // required
+ *   ChannelName: "STRING_VALUE", // required
+ * };
+ * const command = new ResetChannelStateCommand(input);
+ * const response = await client.send(command);
+ * // { // ResetChannelStateResponse
+ * //   ChannelGroupName: "STRING_VALUE", // required
+ * //   ChannelName: "STRING_VALUE", // required
+ * //   Arn: "STRING_VALUE", // required
+ * //   ResetAt: new Date("TIMESTAMP"), // required
+ * // };
+ *
+ * ```
+ *
+ * @param ResetChannelStateCommandInput - {@link ResetChannelStateCommandInput}
+ * @returns {@link ResetChannelStateCommandOutput}
+ * @see {@link ResetChannelStateCommandInput} for command's `input` shape.
+ * @see {@link ResetChannelStateCommandOutput} for command's `response` shape.
+ * @see {@link MediaPackageV2ClientResolvedConfig | config} for MediaPackageV2Client's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see Access Management in the IAM User Guide.</p>
+ *
+ * @throws {@link ConflictException} (client fault)
+ *  <p>Updating or deleting this resource can cause an inconsistent state.</p>
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p>Indicates that an error from the service occurred while trying to process a request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>The specified resource doesn't exist.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request throughput limit was exceeded.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>The input failed to meet the constraints specified by the AWS service.</p>
+ *
+ * @throws {@link MediaPackageV2ServiceException}
+ * <p>Base exception class for all service exceptions from MediaPackageV2 service.</p>
+ *
+ * @public
+ */
+export class ResetChannelStateCommand extends $Command
+  .classBuilder<
+    ResetChannelStateCommandInput,
+    ResetChannelStateCommandOutput,
+    MediaPackageV2ClientResolvedConfig,
+    ServiceInputTypes,
+    ServiceOutputTypes
+  >()
+  .ep(commonParams)
+  .m(function (this: any, Command: any, cs: any, config: MediaPackageV2ClientResolvedConfig, o: any) {
+    return [
+      getSerdePlugin(config, this.serialize, this.deserialize),
+      getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+    ];
+  })
+  .s("mediapackagev2", "ResetChannelState", {})
+  .n("MediaPackageV2Client", "ResetChannelStateCommand")
+  .f(void 0, void 0)
+  .ser(se_ResetChannelStateCommand)
+  .de(de_ResetChannelStateCommand)
+  .build() {
+  /** @internal type navigation helper, not in runtime. */
+  protected declare static __types: {
+    api: {
+      input: ResetChannelStateRequest;
+      output: ResetChannelStateResponse;
+    };
+    sdk: {
+      input: ResetChannelStateCommandInput;
+      output: ResetChannelStateCommandOutput;
+    };
+  };
+}