feat(client-panorama): Pause and resume camera stream processing with SignalApplicationInstanceNodeInstances. Reboot an appliance with CreateJobForDevices. More application state information in DescribeApplicationInstance response.

Author: awstools

clients/client-panorama/src/Panorama.ts

@@ -143,6 +143,11 @@ import {
   RemoveApplicationInstanceCommandInput,
   RemoveApplicationInstanceCommandOutput,
 } from "./commands/RemoveApplicationInstanceCommand";
+import {
+  SignalApplicationInstanceNodeInstancesCommand,
+  SignalApplicationInstanceNodeInstancesCommandInput,
+  SignalApplicationInstanceNodeInstancesCommandOutput,
+} from "./commands/SignalApplicationInstanceNodeInstancesCommand";
 import { TagResourceCommand, TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import {
   UntagResourceCommand,
@@ -198,7 +203,7 @@ export class Panorama extends PanoramaClient {
   }
 
   /**
-   * <p>Creates a job to run on one or more devices.</p>
+   * <p>Creates a job to run on one or more devices. A job can update a device's software or reboot it.</p>
    */
   public createJobForDevices(
     args: CreateJobForDevicesCommandInput,
@@ -1111,6 +1116,40 @@ export class Panorama extends PanoramaClient {
     }
   }
 
+  /**
+   * <p>Signal camera nodes to stop or resume.</p>
+   */
+  public signalApplicationInstanceNodeInstances(
+    args: SignalApplicationInstanceNodeInstancesCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<SignalApplicationInstanceNodeInstancesCommandOutput>;
+  public signalApplicationInstanceNodeInstances(
+    args: SignalApplicationInstanceNodeInstancesCommandInput,
+    cb: (err: any, data?: SignalApplicationInstanceNodeInstancesCommandOutput) => void
+  ): void;
+  public signalApplicationInstanceNodeInstances(
+    args: SignalApplicationInstanceNodeInstancesCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: SignalApplicationInstanceNodeInstancesCommandOutput) => void
+  ): void;
+  public signalApplicationInstanceNodeInstances(
+    args: SignalApplicationInstanceNodeInstancesCommandInput,
+    optionsOrCb?:
+      | __HttpHandlerOptions
+      | ((err: any, data?: SignalApplicationInstanceNodeInstancesCommandOutput) => void),
+    cb?: (err: any, data?: SignalApplicationInstanceNodeInstancesCommandOutput) => void
+  ): Promise<SignalApplicationInstanceNodeInstancesCommandOutput> | void {
+    const command = new SignalApplicationInstanceNodeInstancesCommand(args);
+    if (typeof optionsOrCb === "function") {
+      this.send(command, optionsOrCb);
+    } else if (typeof cb === "function") {
+      if (typeof optionsOrCb !== "object") throw new Error(`Expect http options but get ${typeof optionsOrCb}`);
+      this.send(command, optionsOrCb || {}, cb);
+    } else {
+      return this.send(command, optionsOrCb);
+    }
+  }
+
   /**
    * <p>Tags a resource.</p>
    */

clients/client-panorama/src/PanoramaClient.ts

@@ -137,6 +137,10 @@ import {
   RemoveApplicationInstanceCommandInput,
   RemoveApplicationInstanceCommandOutput,
 } from "./commands/RemoveApplicationInstanceCommand";
+import {
+  SignalApplicationInstanceNodeInstancesCommandInput,
+  SignalApplicationInstanceNodeInstancesCommandOutput,
+} from "./commands/SignalApplicationInstanceNodeInstancesCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
 import {
@@ -176,6 +180,7 @@ export type ServiceInputTypes =
   | ProvisionDeviceCommandInput
   | RegisterPackageVersionCommandInput
   | RemoveApplicationInstanceCommandInput
+  | SignalApplicationInstanceNodeInstancesCommandInput
   | TagResourceCommandInput
   | UntagResourceCommandInput
   | UpdateDeviceMetadataCommandInput;
@@ -211,6 +216,7 @@ export type ServiceOutputTypes =
   | ProvisionDeviceCommandOutput
   | RegisterPackageVersionCommandOutput
   | RemoveApplicationInstanceCommandOutput
+  | SignalApplicationInstanceNodeInstancesCommandOutput
   | TagResourceCommandOutput
   | UntagResourceCommandOutput
   | UpdateDeviceMetadataCommandOutput;

clients/client-panorama/src/commands/CreateJobForDevicesCommand.ts

@@ -28,7 +28,7 @@ export interface CreateJobForDevicesCommandInput extends CreateJobForDevicesRequ
 export interface CreateJobForDevicesCommandOutput extends CreateJobForDevicesResponse, __MetadataBearer {}
 
 /**
- * <p>Creates a job to run on one or more devices.</p>
+ * <p>Creates a job to run on one or more devices. A job can update a device's software or reboot it.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-panorama/src/commands/SignalApplicationInstanceNodeInstancesCommand.ts

@@ -0,0 +1,110 @@
+// smithy-typescript generated code
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import {
+  SignalApplicationInstanceNodeInstancesRequest,
+  SignalApplicationInstanceNodeInstancesRequestFilterSensitiveLog,
+  SignalApplicationInstanceNodeInstancesResponse,
+  SignalApplicationInstanceNodeInstancesResponseFilterSensitiveLog,
+} from "../models/models_0";
+import { PanoramaClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../PanoramaClient";
+import {
+  deserializeAws_restJson1SignalApplicationInstanceNodeInstancesCommand,
+  serializeAws_restJson1SignalApplicationInstanceNodeInstancesCommand,
+} from "../protocols/Aws_restJson1";
+
+export interface SignalApplicationInstanceNodeInstancesCommandInput
+  extends SignalApplicationInstanceNodeInstancesRequest {}
+export interface SignalApplicationInstanceNodeInstancesCommandOutput
+  extends SignalApplicationInstanceNodeInstancesResponse,
+    __MetadataBearer {}
+
+/**
+ * <p>Signal camera nodes to stop or resume.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { PanoramaClient, SignalApplicationInstanceNodeInstancesCommand } from "@aws-sdk/client-panorama"; // ES Modules import
+ * // const { PanoramaClient, SignalApplicationInstanceNodeInstancesCommand } = require("@aws-sdk/client-panorama"); // CommonJS import
+ * const client = new PanoramaClient(config);
+ * const command = new SignalApplicationInstanceNodeInstancesCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link SignalApplicationInstanceNodeInstancesCommandInput} for command's `input` shape.
+ * @see {@link SignalApplicationInstanceNodeInstancesCommandOutput} for command's `response` shape.
+ * @see {@link PanoramaClientResolvedConfig | config} for PanoramaClient's `config` shape.
+ *
+ */
+export class SignalApplicationInstanceNodeInstancesCommand extends $Command<
+  SignalApplicationInstanceNodeInstancesCommandInput,
+  SignalApplicationInstanceNodeInstancesCommandOutput,
+  PanoramaClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  constructor(readonly input: SignalApplicationInstanceNodeInstancesCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: PanoramaClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<SignalApplicationInstanceNodeInstancesCommandInput, SignalApplicationInstanceNodeInstancesCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "PanoramaClient";
+    const commandName = "SignalApplicationInstanceNodeInstancesCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: SignalApplicationInstanceNodeInstancesRequestFilterSensitiveLog,
+      outputFilterSensitiveLog: SignalApplicationInstanceNodeInstancesResponseFilterSensitiveLog,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  private serialize(
+    input: SignalApplicationInstanceNodeInstancesCommandInput,
+    context: __SerdeContext
+  ): Promise<__HttpRequest> {
+    return serializeAws_restJson1SignalApplicationInstanceNodeInstancesCommand(input, context);
+  }
+
+  private deserialize(
+    output: __HttpResponse,
+    context: __SerdeContext
+  ): Promise<SignalApplicationInstanceNodeInstancesCommandOutput> {
+    return deserializeAws_restJson1SignalApplicationInstanceNodeInstancesCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}

clients/client-panorama/src/commands/index.ts

@@ -29,6 +29,7 @@ export * from "./ListTagsForResourceCommand";
 export * from "./ProvisionDeviceCommand";
 export * from "./RegisterPackageVersionCommand";
 export * from "./RemoveApplicationInstanceCommand";
+export * from "./SignalApplicationInstanceNodeInstancesCommand";
 export * from "./TagResourceCommand";
 export * from "./UntagResourceCommand";
 export * from "./UpdateDeviceMetadataCommand";