Skip to content

Create Asset Revision

datazone_create_asset_revision R Documentation

Creates a revision of the asset

Description

Creates a revision of the asset.

Asset revisions represent new versions of existing assets, capturing changes to either the underlying data or its metadata. They maintain a historical record of how assets evolve over time, who made changes, and when those changes occurred. This versioning capability is crucial for governance and compliance, allowing organizations to track changes, understand their impact, and roll back if necessary.

Prerequisites:

  • Asset must already exist in the domain with identifier.

  • formsInput is required when asset has the form type. typeRevision should be the latest version of form type.

  • The form content must include all required fields (e.g., bucketArn for S3ObjectCollectionForm).

  • The owning project of the original asset must still exist and be active.

  • User must have write access to the project and domain.

Usage

datazone_create_asset_revision(name, domainIdentifier, identifier,
  typeRevision, description, glossaryTerms, formsInput,
  predictionConfiguration, clientToken)

Arguments

name

[required] Te revised name of the asset.

domainIdentifier

[required] The unique identifier of the domain where the asset is being revised.

identifier

[required] The identifier of the asset.

typeRevision

The revision type of the asset.

description

The revised description of the asset.

glossaryTerms

The glossary terms to be attached to the asset as part of asset revision.

formsInput

The metadata forms to be attached to the asset as part of asset revision.

predictionConfiguration

The configuration of the automatically generated business-friendly metadata for the asset.

clientToken

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

Value

A list with the following syntax:

list(
  id = "string",
  name = "string",
  typeIdentifier = "string",
  typeRevision = "string",
  externalIdentifier = "string",
  revision = "string",
  description = "string",
  createdAt = as.POSIXct(
    "2015-01-01"
  ),
  createdBy = "string",
  firstRevisionCreatedAt = as.POSIXct(
    "2015-01-01"
  ),
  firstRevisionCreatedBy = "string",
  glossaryTerms = list(
    "string"
  ),
  governedGlossaryTerms = list(
    "string"
  ),
  owningProjectId = "string",
  domainId = "string",
  listing = list(
    listingId = "string",
    listingStatus = "CREATING"|"ACTIVE"|"INACTIVE"
  ),
  formsOutput = list(
    list(
      formName = "string",
      typeName = "string",
      typeRevision = "string",
      content = "string"
    )
  ),
  readOnlyFormsOutput = list(
    list(
      formName = "string",
      typeName = "string",
      typeRevision = "string",
      content = "string"
    )
  ),
  latestTimeSeriesDataPointFormsOutput = list(
    list(
      formName = "string",
      typeIdentifier = "string",
      typeRevision = "string",
      timestamp = as.POSIXct(
        "2015-01-01"
      ),
      contentSummary = "string",
      id = "string"
    )
  ),
  predictionConfiguration = list(
    businessNameGeneration = list(
      enabled = TRUE|FALSE
    )
  )
)

Request syntax

svc$create_asset_revision(
  name = "string",
  domainIdentifier = "string",
  identifier = "string",
  typeRevision = "string",
  description = "string",
  glossaryTerms = list(
    "string"
  ),
  formsInput = list(
    list(
      formName = "string",
      typeIdentifier = "string",
      typeRevision = "string",
      content = "string"
    )
  ),
  predictionConfiguration = list(
    businessNameGeneration = list(
      enabled = TRUE|FALSE
    )
  ),
  clientToken = "string"
)