Amazon DataZone Datazone Asset Types API
The Datazone Asset Types API from Amazon DataZone — 2 operation(s) for datazone asset types.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-datazone:amazon-datazone-asset-types-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Amazon DataZone Asset Types API
version: '2018-05-10'
description: Generated from AWS's published Smithy model for Amazon DataZone. 3 operation(s).
contact:
name: Amazon Web Services
url: https://aws.amazon.com/contact-us/
license:
name: Apache 2.0
identifier: Apache-2.0
url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://datazone.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
tags:
- name: Asset Types
paths:
/v2/domains/{domainIdentifier}/asset-types/{identifier}:
delete:
operationId: DeleteAssetType
summary: Delete Asset Type
description: 'Deletes an asset type in Amazon DataZone. Prerequisites: The asset type must exist in the domain. You must have DeleteAssetType permission. The asset type must not be in use (e.g., assigned to any asset). If used, deletion will fail. You should retrieve the asset type using get-asset-type to confirm its presence before deletion.'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteAssetTypeOutput'
'403':
description: AccessDeniedException; AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'429':
description: ThrottlingException; ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
'401':
description: UnauthorizedException
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteAssetTypeInput'
tags:
- Asset Types
get:
operationId: GetAssetType
summary: Get Asset Type
description: 'Gets an Amazon DataZone asset type. Asset types define the categories and characteristics of different kinds of data assets within Amazon DataZone.. They determine what metadata fields are required, what operations are possible, and how the asset integrates with other Amazon Web Services services. Asset types can range from built-in types like Amazon S3 buckets and Amazon Web Services Glue tables to custom types defined for specific organizational needs. Understanding asset types is crucial for properly organizing and managing different kinds of data resources. Prerequisites: The asset type with identifier must exist in the domain. ResourceNotFoundException. You must have the GetAssetType permission. Ensure the domain-identifier value is correct and accessible.'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/GetAssetTypeOutput'
'403':
description: AccessDeniedException; AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'404':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
'429':
description: ThrottlingException; ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
'401':
description: UnauthorizedException
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GetAssetTypeInput'
tags:
- Asset Types
/v2/domains/{domainIdentifier}/asset-types:
post:
operationId: CreateAssetType
summary: Create Asset Type
description: 'Creates a custom asset type. Prerequisites: The formsInput field is required, however, can be passed as empty (e.g. -forms-input {}). You must have CreateAssetType permissions. The domain-identifier and owning-project-identifier must be valid and active. The name of the asset type must be unique within the domain — duplicate names will cause failure. JSON input must be valid — incorrect formatting causes Invalid JSON errors.'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAssetTypeOutput'
'403':
description: AccessDeniedException; AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
'409':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
'500':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
'402':
description: ServiceQuotaExceededException
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceQuotaExceededException'
'429':
description: ThrottlingException; ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
'400':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
'401':
description: UnauthorizedException
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedException'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAssetTypeInput'
tags:
- Asset Types
components:
schemas:
CreateAssetTypeOutput:
type: object
properties:
domainId:
type: string
description: The ID of the Amazon DataZone domain in which the asset type was created.
name:
type: string
description: The name of the asset type.
revision:
type: string
description: The revision of the custom asset type.
description:
type: string
description: The description of the custom asset type.
formsOutput:
type: object
additionalProperties:
$ref: '#/components/schemas/FormEntryOutput'
description: The metadata forms that are attached to the asset type.
owningProjectId:
type: string
description: The ID of the Amazon DataZone project that currently owns this asset type.
originDomainId:
type: string
description: The ID of the Amazon DataZone domain where the asset type was originally created.
originProjectId:
type: string
description: The ID of the Amazon DataZone project where the asset type was originally created.
createdAt:
type: string
format: date-time
description: The timestamp of when the asset type is to be created.
createdBy:
type: string
description: The Amazon DataZone user who creates this custom asset type.
updatedAt:
type: string
format: date-time
description: The timestamp of when the custom type was created.
updatedBy:
type: string
description: The Amazon DataZone user that created the custom asset type.
required:
- domainId
- name
- revision
- formsOutput
FormEntryInput:
type: object
properties:
typeIdentifier:
type: string
description: The type ID of the form entry.
typeRevision:
type: string
description: The type revision of the form entry.
required:
type: boolean
description: Specifies whether a form entry is required.
required:
- typeIdentifier
- typeRevision
GetAssetTypeInput:
type: object
properties:
domainIdentifier:
type: string
description: The ID of the Amazon DataZone domain in which the asset type exists.
identifier:
type: string
description: The ID of the asset type.
revision:
type: string
description: The revision of the asset type.
required:
- domainIdentifier
- identifier
CreateAssetTypeInput:
type: object
properties:
domainIdentifier:
type: string
description: The unique identifier of the Amazon DataZone domain where the custom asset type is being created.
name:
type: string
description: The name of the custom asset type.
description:
type: string
description: The descripton of the custom asset type.
formsInput:
type: object
additionalProperties:
$ref: '#/components/schemas/FormEntryInput'
description: The metadata forms that are to be attached to the custom asset type.
owningProjectIdentifier:
type: string
description: The identifier of the Amazon DataZone project that is to own the custom asset type.
required:
- domainIdentifier
- name
- formsInput
- owningProjectIdentifier
ValidationException:
type: object
properties:
message:
type: string
required:
- message
GetAssetTypeOutput:
type: object
properties:
domainId:
type: string
description: The ID of the Amazon DataZone domain in which the asset type exists.
name:
type: string
description: The name of the asset type.
revision:
type: string
description: The revision of the asset type.
description:
type: string
description: The description of the asset type.
formsOutput:
type: object
additionalProperties:
$ref: '#/components/schemas/FormEntryOutput'
description: The metadata forms attached to the asset type.
owningProjectId:
type: string
description: The ID of the Amazon DataZone project that owns the asset type.
originDomainId:
type: string
description: The ID of the Amazon DataZone domain in which the asset type was originally created.
originProjectId:
type: string
description: The ID of the Amazon DataZone project in which the asset type was originally created.
createdAt:
type: string
format: date-time
description: The timestamp of when the asset type was created.
createdBy:
type: string
description: The Amazon DataZone user who created the asset type.
updatedAt:
type: string
format: date-time
description: The timestamp of when the asset type was updated.
updatedBy:
type: string
description: The Amazon DataZone user that updated the asset type.
required:
- domainId
- name
- revision
- formsOutput
- owningProjectId
UnauthorizedException:
type: object
properties:
message:
type: string
required:
- message
ThrottlingException:
type: object
properties:
message:
type: string
required:
- message
InternalServerException:
type: object
properties:
message:
type: string
required:
- message
ResourceNotFoundException:
type: object
properties:
message:
type: string
required:
- message
FormEntryOutput:
type: object
properties:
typeName:
type: string
description: The name of the type of the form entry.
typeRevision:
type: string
description: The type revision of the form entry.
required:
type: boolean
description: Specifies whether a form entry is required.
required:
- typeName
- typeRevision
DeleteAssetTypeInput:
type: object
properties:
domainIdentifier:
type: string
description: The ID of the Amazon DataZone domain in which the asset type is deleted.
identifier:
type: string
description: The identifier of the asset type that is deleted.
required:
- domainIdentifier
- identifier
ServiceQuotaExceededException:
type: object
properties:
message:
type: string
required:
- message
DeleteAssetTypeOutput:
type: object
properties: {}
ConflictException:
type: object
properties:
message:
type: string
required:
- message
AccessDeniedException:
type: object
properties:
message:
type: string
required:
- message
securitySchemes:
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: datazone
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/datazone/service/2018-05-10/datazone-2018-05-10.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)