AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateEnvironment and EndCreateEnvironment.

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

Syntax

C#
public abstract Task<CreateEnvironmentResponse> CreateEnvironmentAsync(
         CreateEnvironmentRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.AppConfig.Model.CreateEnvironmentRequest

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

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


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

Exceptions

ExceptionCondition
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.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also