Skip to content

Latest commit

 

History

History
343 lines (179 loc) · 8.04 KB

asset.schema.md

File metadata and controls

343 lines (179 loc) · 8.04 KB

Asset Schema

http://ns.adobe.com/adobecloud/core/1.0/asset

An asset in Adobe Cloud Platform. It is not neccessarily a Digital Asset in the sense of Digital Asset Management, but a piece of content or data that can be represented in the form of a file.

Abstract Extensible Status Identifiable Custom Properties Additional Properties Defined In
Can be instantiated Yes Experimental No Forbidden Permitted external/repo/asset.schema.json

Schema Hierarchy

  • Asset http://ns.adobe.com/adobecloud/core/1.0/asset

Asset Example

{
  "repo:id": "urn:aaid:a:b:01234578-0123-ABCD-abcd-0123456789ab",
  "repo:createdDate": "2017-09-26T15:52:25+00:00",
  "repo:lastModifiedDate": "2017-09-26T15:52:25+00:00",
  "repo:version": "15",
  "repo:size": 1632418,
  "repo:path": "here",
  "repo:name": "example.png",
  "repo:etag": "15",
  "dc:format": "image/png"
}

Asset Properties

Property Type Required Defined by
_embedded object Optional HAL Resource
_links object Optional HAL Resource
dc:format string Required Common Properties
repo:createDate string Optional Common Properties
repo:etag string Required Asset (this schema)
repo:id string Required Asset (this schema)
repo:lastModifiedDate string Required Common Properties
repo:name string Required Common Properties
repo:path string Required Common Properties
repo:size integer Required Asset (this schema)
repo:version string Required Asset (this schema)
tiff:imageLength integer Optional Asset (this schema)
tiff:imageWidth integer Optional Asset (this schema)
* any Additional this schema allows additional properties

_embedded

It is an object whose property names are link relation types (as defined by RFC5988) and values are either a Resource Object or an array of Resource Objects.\n\nEmbedded Resources MAY be a full, partial, or inconsistent version of the representation served from the target URI.

_embedded

_embedded Type

object with following properties:

Property Type Required

_links

It is an object whose property names are link relation types (as defined by RFC5988 and values are either a Link Object or an array of Link Objects. The subject resource of these links is the Resource Object of which the containing _links object is a property.

_links

_links Type

object with following properties:

Property Type Required

dc:format

Format

The physical or digital manifestation of the resource. Typically, Format should include the media-type of the resource. Format may be used to determine the software, hardware or other equipment needed to display or operate the resource. Recommended best practice is to select a value from a controlled vocabulary (for example, the list of [Internet Media Types](http://www.iana.org/ assignments/media-types/) defining computer media formats).

dc:format

  • is required
  • type: string
  • defined in Common Properties

dc:format Type

string

All instances must conform to this regular expression

\w+\/[-.\w]+(?:\+[-.\w]+)?

dc:format Example

"application/vnd.adobe.photoshop"

repo:createDate

The server date and time when the resource was created in the repository, such as when an asset file is first uploaded or a directory is created by the server as the parent of a new asset. The Date Time property should conform to ISO 8601 standard. An example form is "2004-10-23T12:00:00-06:00".

repo:createDate

  • is optional
  • type: string
  • defined in Common Properties

repo:createDate Type

string

repo:createDate Example

"2004-10-23T12:00:00-06:00"

repo:etag

ETag

An ETag is an HTTP response header returned by an HTTP/1.1 compliant web server used to determine change in content of a resource at a given URL.

repo:etag

  • is required
  • type: string
  • defined in this schema

repo:etag Type

string

repo:id

A unique identifier given to every addressable asset in a given repository.

repo:id

  • is required
  • type: string
  • defined in this schema

repo:id Type

string

repo:id Example

"urn:aaid:sc:US:6dc33479-13ca-4b19-b25d-c805eff8a69e"

repo:lastModifiedDate

The server date and time when the resource was most recently modified in the repository, such as when a new version of an asset is uploaded or a directory's child resource is added or removed. The Date Time property should conform to ISO 8601 standard. An example form is "2004-10-23T12:00:00-06:00".

repo:lastModifiedDate

  • is required
  • type: string
  • defined in Common Properties

repo:lastModifiedDate Type

string

repo:lastModifiedDate Example

"2004-10-23T12:00:00-06:00"

repo:name

repo:name

  • is required
  • type: string
  • defined in Common Properties

repo:name Type

string

repo:path

repo:path

  • is required
  • type: string
  • defined in Common Properties

repo:path Type

string

repo:size

Size

Size of the asset in bytes.

repo:size

  • is required
  • type: integer
  • defined in this schema

repo:size Type

integer

repo:version

The version ID of the piece of content. It will be generated both on explicit and implicit save or upload.

repo:version

  • is required
  • type: string
  • defined in this schema

repo:version Type

string

tiff:imageLength

Length

Height in pixels. To maintain continuity with the XMP and TIFF standards, the height of an image or video is specified in the property imageLength. The duration of the video (also commonly called length) is specified in the property extent

tiff:imageLength

  • is optional
  • type: integer
  • defined in this schema

tiff:imageLength Type

integer

  • minimum value: 0

tiff:imageWidth

Width

Width in pixels

tiff:imageWidth

  • is optional
  • type: integer
  • defined in this schema

tiff:imageWidth Type

integer

  • minimum value: 0