Class CreateDeploymentCommandProtected

Creates a Deployment for an API.

Example

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

import { ApiGatewayV2Client, CreateDeploymentCommand } from "@aws-sdk/client-apigatewayv2"; // ES Modules import
// const { ApiGatewayV2Client, CreateDeploymentCommand } = require("@aws-sdk/client-apigatewayv2"); // CommonJS import
const client = new ApiGatewayV2Client(config);
const input = { // CreateDeploymentRequest
  ApiId: "STRING_VALUE", // required
  Description: "STRING_VALUE",
  StageName: "STRING_VALUE",
};
const command = new CreateDeploymentCommand(input);
const response = await client.send(command);
// { // CreateDeploymentResponse
//   AutoDeployed: true || false,
//   CreatedDate: new Date("TIMESTAMP"),
//   DeploymentId: "STRING_VALUE",
//   DeploymentStatus: "PENDING" || "FAILED" || "DEPLOYED",
//   DeploymentStatusMessage: "STRING_VALUE",
//   Description: "STRING_VALUE",
// };

Param

CreateDeploymentCommandInput

Returns

CreateDeploymentCommandOutput

See

• CreateDeploymentCommandInput for command's input shape.
• CreateDeploymentCommandOutput for command's response shape.
• config for ApiGatewayV2Client's config shape.

Throws

BadRequestException (client fault)

The request is not valid, for example, the input is incomplete or incorrect. See the accompanying error message for details.

Throws

ConflictException (client fault)

The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request. See the accompanying error message for details.

Throws

NotFoundException (client fault)

The resource specified in the request was not found. See the message field for more information.

Throws

TooManyRequestsException (client fault)

A limit has been exceeded. See the accompanying error message for details.

Throws

ApiGatewayV2ServiceException

Base exception class for all service exceptions from ApiGatewayV2 service.