IAmazonAppConfig.CreateEnvironment Method (CreateEnvironmentRequest)

Creates an environment. For each application, you define one or more environments. An environment is a deployment group of AppConfig targets, such as applications in a Beta or Production environment. You can also define environments for application subcomponents such as the Web, Mobile and Back-end components for your application. You can configure Amazon CloudWatch alarms for each environment. The system monitors alarms during a configuration deployment. If an alarm is triggered, the system rolls back the configuration.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateEnvironmentAsync.

Namespace: Amazon.AppConfig
Assembly: AWSSDK.AppConfig.dll
Version: 3.x.y.z

Syntax

public abstract CreateEnvironmentResponse CreateEnvironment(
         CreateEnvironmentRequest request
)

Parameters

request: Type: Amazon.AppConfig.Model.CreateEnvironmentRequest

Container for the necessary parameters to execute the CreateEnvironment service method.

Return Value

Type: CreateEnvironmentResponse

The response from the CreateEnvironment service method, as returned by AppConfig.

Exceptions

Exception	Condition
BadRequestException	The input fails to satisfy the constraints specified by an Amazon Web Services service.
InternalServerException	There was an internal failure in the AppConfig service.
ResourceNotFoundException	The requested resource could not be found.
ServiceQuotaExceededException	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.

Examples

The following create-environment example creates an AWS AppConfig environment named Example-Environment using the application you created using create-application

To create an environment


var client = new AmazonAppConfigClient();
var response = client.CreateEnvironment(new CreateEnvironmentRequest 
{
    ApplicationId = "339ohji",
    Name = "Example-Environment"
});

string applicationId = response.ApplicationId;
string id = response.Id;
string name = response.Name;
string state = response.State;

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

IAmazonAppConfig.CreateEnvironment (CreateEnvironmentRequest)

Method