---
title: "POST /v2/domains/{domainIdentifier}/assets"
method: POST
path: "/v2/domains/{domainIdentifier}/assets"
---

# POST /v2/domains/{domainIdentifier}/assets

`POST /v2/domains/{domainIdentifier}/assets`

Creates an asset in Amazon DataZone catalog.

Before creating assets, make sure that the following requirements are met:

*   `--domain-identifier` must refer to an existing domain.
    
*   `--owning-project-identifier` must be a valid project within the domain.
    
*   Asset type must be created beforehand using `create-asset-type`, or be a supported system-defined type. For more information, see [create-asset-type](https://docs.aws.amazon.com/cli/latest/reference/datazone/create-asset-type.html).
    
*   `--type-revision` (if used) must match a valid revision of the asset type.
    
*   `formsInput` is required when it is associated as required in the `asset-type`. For more information, see [create-form-type](https://docs.aws.amazon.com/cli/latest/reference/datazone/create-form-type.html).
    
*   Form content must include all required fields as per the form schema (e.g., `bucketArn`).
    

You must invoke the following pre-requisite commands before invoking this API:

*   [CreateFormType](https://docs.aws.amazon.com/datazone/latest/APIReference/API_CreateFormType.html)
    
*   [CreateAssetType](https://docs.aws.amazon.com/datazone/latest/APIReference/API_CreateAssetType.html)

## Path parameters

- `domainIdentifier` string, required

## Request body

- object
  - `name` string, password, required — Asset name.
  - `externalIdentifier` string — <p>The external identifier of the asset.</p> <p>If the value for the <code>externalIdentifier</code> parameter is specified, it must be a unique value.</p>
  - `typeIdentifier` string, required — The unique identifier of this asset's type.
  - `typeRevision` string — The revision of this asset's type.
  - `description` string, password — Asset description.
  - `glossaryTerms` GlossaryTermId[] — Glossary terms attached to the asset.
  - `formsInput` FormInput[] — Metadata forms attached to the asset.
    - `formName` string, required — The name of the metadata form.
    - `typeIdentifier` string — The ID of the metadata form type.
    - `typeRevision` string — The revision of the metadata form type.
    - `content` string — The content of the metadata form.
  - `owningProjectIdentifier` string, required — The unique identifier of the project that owns this asset.
  - `predictionConfiguration` object — The configuration of the prediction.
    - `businessNameGeneration` object — The business name generation mechanism.
      - `enabled` boolean — Specifies whether the business name generation is enabled.
  - `clientToken` string — A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

## Response `201`

Success

- CreateAssetOutput
  - `id` string, required — The unique identifier of the created asset.
  - `name` string, password, required — The name of the created asset.
  - `typeIdentifier` string, required — The identifier of the created asset type.
  - `typeRevision` string, required — The revision type of the asset.
  - `externalIdentifier` string — The external identifier of the asset.
  - `revision` string, required — The revision of the asset.
  - `description` string, password — The description of the created asset.
  - `createdAt` string, date-time — The timestamp of when the asset was created.
  - `createdBy` string — The Amazon DataZone user that created this asset in the catalog.
  - `firstRevisionCreatedAt` string, date-time — The timestamp of when the first revision of the asset took place.
  - `firstRevisionCreatedBy` string — The Amazon DataZone user that made the first revision of the asset.
  - `glossaryTerms` GlossaryTermId[] — The glossary terms that are attached to the created asset.
  - `governedGlossaryTerms` GlossaryTermId[] — The glossary terms in a restricted glossary.
  - `owningProjectId` string, required — The ID of the Amazon DataZone project that owns the created asset.
  - `domainId` string, required — The ID of the Amazon DataZone domain in which the asset was created.
  - `listing` object — The details of an asset published in an Amazon DataZone catalog.
    - `listingId` string, required — The identifier of an asset published in an Amazon DataZone catalog.
    - `listingStatus` 'CREATING' | 'ACTIVE' | 'INACTIVE', required — The status of an asset published in an Amazon DataZone catalog.
  - `formsOutput` FormOutput[], required — The metadata forms that are attached to the created asset.
    - `formName` string, required — The name of the metadata form.
    - `typeName` string, password — The name of the metadata form type.
    - `typeRevision` string — The revision of the metadata form type.
    - `content` string — The content of the metadata form.
  - `readOnlyFormsOutput` FormOutput[] — The read-only metadata forms that are attached to the created asset.
    - `formName` string, required — The name of the metadata form.
    - `typeName` string, password — The name of the metadata form type.
    - `typeRevision` string — The revision of the metadata form type.
    - `content` string — The content of the metadata form.
  - `latestTimeSeriesDataPointFormsOutput` TimeSeriesDataPointSummaryFormOutput[] — The latest data point that was imported into the time series form for the asset.
    - `formName` string, required — The name of the time series data points summary form.
    - `typeIdentifier` string, required — The type ID of the time series data points summary form.
    - `typeRevision` string — The type revision of the time series data points summary form.
    - `timestamp` string, date-time, required — The timestamp of the time series data points summary form.
    - `contentSummary` string — The content of the summary of the time series data points form.
    - `id` string — The ID of the time series data points summary form.
  - `predictionConfiguration` object — The configuration of the automatically generated business-friendly metadata for the asset.
    - `businessNameGeneration` object — The business name generation mechanism.
      - `enabled` boolean — Specifies whether the business name generation is enabled.

## 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)