ListAppVersionsCommand

Lists the different versions for the Resilience Hub applications.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { ResiliencehubClient, ListAppVersionsCommand } from "@aws-sdk/client-resiliencehub"; // ES Modules import
// const { ResiliencehubClient, ListAppVersionsCommand } = require("@aws-sdk/client-resiliencehub"); // CommonJS import
const client = new ResiliencehubClient(config);
const input = { // ListAppVersionsRequest
  appArn: "STRING_VALUE", // required
  nextToken: "STRING_VALUE",
  maxResults: Number("int"),
  startTime: new Date("TIMESTAMP"),
  endTime: new Date("TIMESTAMP"),
};
const command = new ListAppVersionsCommand(input);
const response = await client.send(command);
// { // ListAppVersionsResponse
//   appVersions: [ // AppVersionList // required
//     { // AppVersionSummary
//       appVersion: "STRING_VALUE", // required
//       identifier: Number("long"),
//       creationTime: new Date("TIMESTAMP"),
//       versionName: "STRING_VALUE",
//     },
//   ],
//   nextToken: "STRING_VALUE",
// };

ListAppVersionsCommand Input

See ListAppVersionsCommandInput for more details

Parameter
Type
Description
appArn
Required
string | undefined

Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id. For more information about ARNs, see Amazon Resource Names (ARNs)  in the Amazon Web Services General Reference guide.

endTime
Date | undefined

Upper limit of the time range to filter the application versions.

maxResults
number | undefined

Maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.

nextToken
string | undefined

Null, or the token from a previous call to get the next set of results.

startTime
Date | undefined

Lower limit of the time range to filter the application versions.

ListAppVersionsCommand Output

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
appVersions
Required
AppVersionSummary[] | undefined

The version of the application.

nextToken
string | undefined

Token for the next set of results, or null if there are no more results.

Throws

Name
Fault
Details
AccessDeniedException
client

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.

InternalServerException
server

This exception occurs when there is an internal failure in the Resilience Hub service.

ResourceNotFoundException
client

This exception occurs when the specified resource could not be found.

ValidationException
client

This exception occurs when a request is not valid.

ResiliencehubServiceException
Base exception class for all service exceptions from Resiliencehub service.