---
title: "GET /v2/domains/{domainIdentifier}/environments/{identifier}"
method: GET
path: "/v2/domains/{domainIdentifier}/environments/{identifier}"
---

# GET /v2/domains/{domainIdentifier}/environments/{identifier}

`GET /v2/domains/{domainIdentifier}/environments/{identifier}`

Gets an Amazon DataZone environment.

## Path parameters

- `domainIdentifier` string, required
- `identifier` string, required

## Response `200`

Success

- GetEnvironmentOutput
  - `projectId` string, required — The ID of the Amazon DataZone project in which this environment is created.
  - `id` string — The ID of the environment.
  - `domainId` string, required — The ID of the Amazon DataZone domain where the environment exists.
  - `createdBy` string, required — The Amazon DataZone user who created the environment.
  - `createdAt` string, date-time — The timestamp of when the environment was created.
  - `updatedAt` string, date-time — The timestamp of when this environment was updated.
  - `name` string, password, required — The name of the environment.
  - `description` string, password — The description of the environment.
  - `environmentProfileId` string — The ID of the environment profile with which the environment is created.
  - `awsAccountId` string — The ID of the Amazon Web Services account where the environment exists.
  - `awsAccountRegion` string — The Amazon Web Services region where the environment exists.
  - `provider` string, required — The provider of this Amazon DataZone environment.
  - `provisionedResources` Resource[] — The provisioned resources of this Amazon DataZone environment.
    - `provider` string — The provider of a provisioned resource of this Amazon DataZone environment.
    - `name` string — The name of a provisioned resource of this Amazon DataZone environment.
    - `value` string, required — The value of a provisioned resource of this Amazon DataZone environment.
    - `type` string, required — The type of a provisioned resource of this Amazon DataZone environment.
  - `status` 'ACTIVE' | 'CREATING' | 'UPDATING' | 'DELETING' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETE_FAILED' | 'VALIDATION_FAILED' | 'SUSPENDED' | 'DISABLED' | 'EXPIRED' | 'DELETED' | 'INACCESSIBLE' — The status of this Amazon DataZone environment.
  - `environmentActions` ConfigurableEnvironmentAction[] — The actions of the environment.
    - `type` string, required — The type of a configurable action in a Amazon DataZone environment.
    - `auth` 'IAM' | 'HTTPS' — The authentication type of a configurable action of a Amazon DataZone environment.
    - `parameters` ConfigurableActionParameter[], required — The parameters of a configurable action in a Amazon DataZone environment.
      - `key` string — The key of the configurable action parameter.
      - `value` string — The value of the configurable action parameter.
  - `glossaryTerms` GlossaryTermId[] — The business glossary terms that can be used in this environment.
  - `userParameters` CustomParameter[] — The user parameters of this Amazon DataZone environment.
    - `keyName` string, required — The key name of the parameter.
    - `description` string, password — The description of the parameter.
    - `fieldType` string, required — The filed type of the parameter.
    - `defaultValue` string — The default value of the parameter.
    - `isEditable` boolean — Specifies whether the parameter is editable.
    - `isOptional` boolean — Specifies whether the custom parameter is optional.
    - `isUpdateSupported` boolean — Specifies whether a parameter value can be updated after creation.
  - `lastDeployment` object — The details of the last deployment of the environment.
    - `deploymentId` string — The identifier of the last deployment of the environment.
    - `deploymentType` 'CREATE' | 'UPDATE' | 'DELETE' — The type of the last deployment of the environment.
    - `deploymentStatus` 'IN_PROGRESS' | 'SUCCESSFUL' | 'FAILED' | 'PENDING_DEPLOYMENT' — The status of the last deployment of the environment.
    - `failureReason` object — The failure reason of the last deployment of the environment.
      - `code` string — The error code for the failure reason for the environment deployment.
      - `message` string, required — The error message for the failure reason for the environment deployment.
    - `messages` DeploymentMessage[] — The messages of the last deployment of the environment.
    - `isDeploymentComplete` boolean — Specifies whether the last deployment of the environment is complete.
  - `provisioningProperties` object — The provisioning properties of this Amazon DataZone environment.
    - `cloudFormation` object — The cloud formation properties included as part of the provisioning properties of an environment blueprint.
      - `templateUrl` string, required — The template URL of the cloud formation provisioning properties of the environment blueprint.
  - `deploymentProperties` object — The deployment properties of the environment.
    - `startTimeoutMinutes` integer — The start timeout of the environment blueprint deployment.
    - `endTimeoutMinutes` integer — The end timeout of the environment blueprint deployment.
  - `environmentBlueprintId` string — The blueprint with which the environment is created.
  - `environmentConfigurationId` string, password — The configuration ID that is used to create the environment.
  - `environmentConfigurationName` string, password — The configuration name that is used to create the environment.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — ValidationException
- `485` — UnauthorizedException

---

[API](https://skmtc.net/aws/apis/datazone.md) · [All operations](https://skmtc.net/aws/apis/datazone/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/datazone/versions/055599054b53/schema)