CreateApplicationCommand

Suggest an Edit

Creates an application. In AppConfig, an application is simply an organizational construct like a folder. This organizational construct has a relationship with some unit of executable code. For example, you could create an application called MyMobileApp to organize and manage configuration data for a mobile application installed by your users.

Example Syntax

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

import { AppConfigClient, CreateApplicationCommand } from "@aws-sdk/client-appconfig"; // ES Modules import
// const { AppConfigClient, CreateApplicationCommand } = require("@aws-sdk/client-appconfig"); // CommonJS import
const client = new AppConfigClient(config);
const input = { // CreateApplicationRequest
  Name: "STRING_VALUE", // required
  Description: "STRING_VALUE",
  Tags: { // TagMap
    "<keys>": "STRING_VALUE",
  },
};
const command = new CreateApplicationCommand(input);
const response = await client.send(command);
// { // Application
//   Id: "STRING_VALUE",
//   Name: "STRING_VALUE",
//   Description: "STRING_VALUE",
// };

Example Usage

// The following create-application example creates an application in AWS AppConfig.
const input = {
"Description": "An application used for creating an example.",
"Name": "example-application"
};
const command = new CreateApplicationCommand(input);
const response = await client.send(command);
/* response ==
{
"Description": "An application used for creating an example.",
"Id": "339ohji",
"Name": "example-application"
}
*\/
// example id: to-create-an-application-1632264511615
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
JavaScriptLn 1, Col 1
Errors: 0 Warnings: 0

CreateApplicationCommand Input

See CreateApplicationCommandInput for more details

Parameter
Type
Description
Name
Required
string | undefined

A name for the application.

Description
string | undefined

A description of the application.

Tags
Record<string, string> | undefined

Metadata to assign to the application. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

CreateApplicationCommand Output

See CreateApplicationCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
Description
string | undefined

The description of the application.

Id
string | undefined

The application ID.

Name
string | undefined

The application name.

Throws

Name
Fault
Details
BadRequestException
client

The input fails to satisfy the constraints specified by an Amazon Web Services service.

InternalServerException
server

There was an internal failure in the AppConfig service.

ServiceQuotaExceededException
client

The number of one more AppConfig resources exceeds the maximum allowed. Verify that your environment doesn't exceed the following service quotas:

Applications: 100 max

Deployment strategies: 20 max

Configuration profiles: 100 max per application

Environments: 20 max per application

To resolve this issue, you can delete one or more resources and try again. Or, you can request a quota increase. For more information about quotas and to request an increase, see Service quotas for AppConfig  in the Amazon Web Services General Reference.

AppConfigServiceException
Base exception class for all service exceptions from AppConfig service.