Initialize a new publication

Initializes a new publication for publishing metadata. Determines the publication type based on the provided layer IDs. A publication can only consist of layer IDs that have the same layer type. For example, you can have a publication for multiple layers of type versioned, but you cannot have a single publication that publishes to both versioned and volatile layers. In addition, you may only have one versioned publication in process at a time. The body field versionDependencies is optional and is used for versioned layers to declare version dependencies.

billingTagstring

Billing Tag is an optional free-form tag which is used for grouping billing records together. If supplied, it must be between 4 - 16 characters, contain only alpha/numeric ASCII characters [A-Za-z0-9]. Grouping billing records by billing tag will be available in future releases.

Request body

idstring

The ID of the publication.

layerIdsstring[]

catalogVersioninteger

The current version of the catalog. If this is the catalog's first publication, the version is -1. After the first publication, the catalog version becomes 0. Each subsequent publication increments the catalog version by 1.

Example request

{
  "id": "34bc2a16-0373-4157-8ccc-19ba08a6672b",
  "details": {
    "message": "Publication initialized",
    "started": 1523459129829,
    "modified": 1523459129829,
    "expires": 1523459129829
  },
  "layerIds": [
    "my-layer"
  ],
  "catalogVersion": 1,
  "versionDependencies": [
    {
      "hrn": "hrn:here:data:::my-catalog",
      "version": 23
    }
  ]
}

Response

New publication created.