- Navigation GuideYou are on a Command (operation) page with structural examples. Use the navigation breadcrumb if you would like to return to the Client landing page.
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
Parameter | Type | Description |
---|
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 |
---|
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 |
---|
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. |