CreateEnvironmentCommand

Create an Amazon DataZone environment.

Example Syntax

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

import { DataZoneClient, CreateEnvironmentCommand } from "@aws-sdk/client-datazone"; // ES Modules import
// const { DataZoneClient, CreateEnvironmentCommand } = require("@aws-sdk/client-datazone"); // CommonJS import
const client = new DataZoneClient(config);
const input = { // CreateEnvironmentInput
  projectIdentifier: "STRING_VALUE", // required
  domainIdentifier: "STRING_VALUE", // required
  description: "STRING_VALUE",
  name: "STRING_VALUE", // required
  environmentProfileIdentifier: "STRING_VALUE", // required
  userParameters: [ // EnvironmentParametersList
    { // EnvironmentParameter
      name: "STRING_VALUE",
      value: "STRING_VALUE",
    },
  ],
  glossaryTerms: [ // GlossaryTerms
    "STRING_VALUE",
  ],
  environmentAccountIdentifier: "STRING_VALUE",
  environmentAccountRegion: "STRING_VALUE",
  environmentBlueprintIdentifier: "STRING_VALUE",
  deploymentOrder: Number("int"),
  environmentConfigurationId: "STRING_VALUE",
};
const command = new CreateEnvironmentCommand(input);
const response = await client.send(command);
// { // CreateEnvironmentOutput
//   projectId: "STRING_VALUE", // required
//   id: "STRING_VALUE",
//   domainId: "STRING_VALUE", // required
//   createdBy: "STRING_VALUE", // required
//   createdAt: new Date("TIMESTAMP"),
//   updatedAt: new Date("TIMESTAMP"),
//   name: "STRING_VALUE", // required
//   description: "STRING_VALUE",
//   environmentProfileId: "STRING_VALUE",
//   awsAccountId: "STRING_VALUE",
//   awsAccountRegion: "STRING_VALUE",
//   provider: "STRING_VALUE", // required
//   provisionedResources: [ // ResourceList
//     { // Resource
//       provider: "STRING_VALUE",
//       name: "STRING_VALUE",
//       value: "STRING_VALUE", // required
//       type: "STRING_VALUE", // required
//     },
//   ],
//   status: "ACTIVE" || "CREATING" || "UPDATING" || "DELETING" || "CREATE_FAILED" || "UPDATE_FAILED" || "DELETE_FAILED" || "VALIDATION_FAILED" || "SUSPENDED" || "DISABLED" || "EXPIRED" || "DELETED" || "INACCESSIBLE",
//   environmentActions: [ // EnvironmentActionList
//     { // ConfigurableEnvironmentAction
//       type: "STRING_VALUE", // required
//       auth: "IAM" || "HTTPS",
//       parameters: [ // ConfigurableActionParameterList // required
//         { // ConfigurableActionParameter
//           key: "STRING_VALUE",
//           value: "STRING_VALUE",
//         },
//       ],
//     },
//   ],
//   glossaryTerms: [ // GlossaryTerms
//     "STRING_VALUE",
//   ],
//   userParameters: [ // CustomParameterList
//     { // CustomParameter
//       keyName: "STRING_VALUE", // required
//       description: "STRING_VALUE",
//       fieldType: "STRING_VALUE", // required
//       defaultValue: "STRING_VALUE",
//       isEditable: true || false,
//       isOptional: true || false,
//     },
//   ],
//   lastDeployment: { // Deployment
//     deploymentId: "STRING_VALUE",
//     deploymentType: "CREATE" || "UPDATE" || "DELETE",
//     deploymentStatus: "IN_PROGRESS" || "SUCCESSFUL" || "FAILED" || "PENDING_DEPLOYMENT",
//     failureReason: { // EnvironmentError
//       code: "STRING_VALUE",
//       message: "STRING_VALUE", // required
//     },
//     messages: [ // DeploymentMessagesList
//       "STRING_VALUE",
//     ],
//     isDeploymentComplete: true || false,
//   },
//   provisioningProperties: { // ProvisioningProperties Union: only one key present
//     cloudFormation: { // CloudFormationProperties
//       templateUrl: "STRING_VALUE", // required
//     },
//   },
//   deploymentProperties: { // DeploymentProperties
//     startTimeoutMinutes: Number("int"),
//     endTimeoutMinutes: Number("int"),
//   },
//   environmentBlueprintId: "STRING_VALUE",
//   environmentConfigurationId: "STRING_VALUE",
// };

CreateEnvironmentCommand Input

See CreateEnvironmentCommandInput for more details

Parameter
Type
Description
domainIdentifier
Required
string | undefined

The identifier of the Amazon DataZone domain in which the environment is created.

environmentProfileIdentifier
Required
string | undefined

The identifier of the environment profile that is used to create this Amazon DataZone environment.

name
Required
string | undefined

The name of the Amazon DataZone environment.

projectIdentifier
Required
string | undefined

The identifier of the Amazon DataZone project in which this environment is created.

deploymentOrder
number | undefined

The deployment order of the environment.

description
string | undefined

The description of the Amazon DataZone environment.

environmentAccountIdentifier
string | undefined

The ID of the account in which the environment is being created.

environmentAccountRegion
string | undefined

The region of the account in which the environment is being created.

environmentBlueprintIdentifier
string | undefined

The ID of the blueprint with which the environment is being created.

environmentConfigurationId
string | undefined

The configuration ID of the environment.

glossaryTerms
string[] | undefined

The glossary terms that can be used in this Amazon DataZone environment.

userParameters
EnvironmentParameter[] | undefined

The user parameters of this Amazon DataZone environment.

CreateEnvironmentCommand Output

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

The Amazon DataZone user who created this environment.

domainId
Required
string | undefined

The identifier of the Amazon DataZone domain in which the environment is created.

name
Required
string | undefined

The name of this environment.

projectId
Required
string | undefined

The ID of the Amazon DataZone project in which this environment is created.

provider
Required
string | undefined

The provider of this Amazon DataZone environment.

awsAccountId
string | undefined

The Amazon Web Services account in which the Amazon DataZone environment is created.

awsAccountRegion
string | undefined

The Amazon Web Services region in which the Amazon DataZone environment is created.

createdAt
Date | undefined

The timestamp of when the environment was created.

deploymentProperties
DeploymentProperties | undefined

The deployment properties of this Amazon DataZone environment.

description
string | undefined

The description of this Amazon DataZone environment.

environmentActions
ConfigurableEnvironmentAction[] | undefined

The configurable actions of this Amazon DataZone environment.

environmentBlueprintId
string | undefined

The ID of the blueprint with which this Amazon DataZone environment was created.

environmentConfigurationId
string | undefined

The configuration ID of the environment.

environmentProfileId
string | undefined

The ID of the environment profile with which this Amazon DataZone environment was created.

glossaryTerms
string[] | undefined

The glossary terms that can be used in this Amazon DataZone environment.

id
string | undefined

The ID of this Amazon DataZone environment.

lastDeployment
Deployment | undefined

The details of the last deployment of this Amazon DataZone environment.

provisionedResources
Resource[] | undefined

The provisioned resources of this Amazon DataZone environment.

provisioningProperties
ProvisioningProperties | undefined

The provisioning properties of this Amazon DataZone environment.

status
EnvironmentStatus | undefined

The status of this Amazon DataZone environment.

updatedAt
Date | undefined

The timestamp of when this environment was updated.

userParameters
CustomParameter[] | undefined

The user parameters of this Amazon DataZone environment.

Throws

Name
Fault
Details
AccessDeniedException
client

You do not have sufficient access to perform this action.

ConflictException
client

There is a conflict while performing this action.

InternalServerException
server

The request has failed because of an unknown error, exception or failure.

ResourceNotFoundException
client

The specified resource cannot be found.

ThrottlingException
client

The request was denied due to request throttling.

ValidationException
client

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

UnauthorizedException
client

You do not have permission to perform this action.

DataZoneServiceException
Base exception class for all service exceptions from DataZone service.