---
title: "PUT /v2/domains/{identifier}"
method: PUT
path: "/v2/domains/{identifier}"
---

# PUT /v2/domains/{identifier}

`PUT /v2/domains/{identifier}`

Updates a Amazon DataZone domain.

## Path parameters

- `identifier` string, required

## Query parameters

- `clientToken` string

## Request body

- object
  - `description` string — The description to be updated as part of the <code>UpdateDomain</code> action.
  - `singleSignOn` object — The single sign-on details in Amazon DataZone.
    - `type` 'IAM_IDC' | 'DISABLED' — The type of single sign-on in Amazon DataZone.
    - `userAssignment` 'AUTOMATIC' | 'MANUAL' — The single sign-on user assignment in Amazon DataZone.
    - `idcInstanceArn` string — The ARN of the IDC instance.
  - `domainExecutionRole` string — The domain execution role to be updated as part of the <code>UpdateDomain</code> action.
  - `serviceRole` string — The service role of the domain.
  - `name` string — The name to be updated as part of the <code>UpdateDomain</code> action.

## Response `200`

Success

- UpdateDomainOutput
  - `id` string, required — The identifier of the Amazon DataZone domain.
  - `rootDomainUnitId` string — The ID of the root domain unit.
  - `description` string — The description to be updated as part of the <code>UpdateDomain</code> action.
  - `singleSignOn` object — The single sign-on option of the Amazon DataZone domain.
    - `type` 'IAM_IDC' | 'DISABLED' — The type of single sign-on in Amazon DataZone.
    - `userAssignment` 'AUTOMATIC' | 'MANUAL' — The single sign-on user assignment in Amazon DataZone.
    - `idcInstanceArn` string — The ARN of the IDC instance.
  - `domainExecutionRole` string — The domain execution role to be updated as part of the <code>UpdateDomain</code> action.
  - `serviceRole` string — The service role of the domain.
  - `name` string — The name to be updated as part of the <code>UpdateDomain</code> action.
  - `lastUpdatedAt` string, date-time — Specifies the timestamp of when the domain was last updated.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — ServiceQuotaExceededException
- `485` — ConflictException
- `486` — ValidationException
- `487` — 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)