Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141891,2951.1 MB

Gets an Amazon DataZone asset.

An asset is the fundamental building block in Amazon DataZone, representing any data resource that needs to be cataloged and managed. It can take many forms, from Amazon S3 buckets and database tables to dashboards and machine learning models. Each asset contains comprehensive metadata about the resource, including its location, schema, ownership, and lineage information. Assets are essential for organizing and managing data resources across an organization, making them discoverable and usable while maintaining proper governance.

Before using the Amazon DataZone GetAsset command, ensure the following prerequisites are met:

  • Domain identifier must exist and be valid

  • Asset identifier must exist

  • User must have the required permissions to perform the action

get/v2/domains/{domainIdentifier}/assets/{identifier}

Path parameters

domainIdentifierstring required

The ID of the Amazon DataZone domain to which the asset belongs.

identifierstring required
<p>The ID of the Amazon DataZone asset.</p> <p>This parameter supports either the value of <code>assetId</code> or <code>externalIdentifier</code> as input. If you are passing the value of <code>externalIdentifier</code>, you must prefix this value with <code>externalIdentifer%2F</code>.</p>

Query parameters

revisionstring

The revision of the Amazon DataZone asset.

Response

Success

idstring required

The ID of the asset.

namestring password required

The name of the asset.

typeIdentifierstring required

The ID of the asset type.

typeRevisionstring required

The revision of the asset type.

externalIdentifierstring

The external ID of the asset.

revisionstring required

The revision of the asset.

descriptionstring password

The description of the Amazon DataZone asset.

createdAtstring date-time

The timestamp of when the asset was created.

createdBystring

The Amazon DataZone user who created the asset.

firstRevisionCreatedAtstring date-time

The timestamp of when the first revision of the asset was created.

firstRevisionCreatedBystring

The Amazon DataZone user who created the first revision of the asset.

glossaryTermsGlossaryTermId[]

The business glossary terms attached to the asset.

governedGlossaryTermsGlossaryTermId[]

The restricted glossary terms attached to an asset.

owningProjectIdstring required

The ID of the project that owns the asset.

domainIdstring required

The ID of the Amazon DataZone domain to which the asset belongs.