Define Namespace

NOTE For Sentinel LDK, this step is not relevant. In Sentinel LDK, a namespace is known as batch code that represents a company's unique vendor code. You need to use the vendor-specific namespace provisioned by Thales (which is written to the keys before dispatch and printed on the outside of each Sentinel HL key). The namespace for Sentinel protection keys with a demo vendor code is DEMOMA.

You can define a namespace to create a workspace for catalog items, such as features and products. Let us create a namespace with the name Zone-A.

You can create a namespace by using the following API endpoint:

POST /ems/api/v5/namespaces

The mandatory JSON elements used in the API endpoint are:

JSON Element	Description	Type
name	Unique name of the namespace. You can specify up to 200 alphanumeric characters. The following special characters are not allowed: % ^ & [ ] " < >	String

JSON Element

Description

Type

name

Unique name of the namespace. You can specify up to 200 alphanumeric characters.

The following special characters are not allowed: % ^ & [ ] " < >

String

Sample Input

{
  "namespace": {
    "name": "Zone-A"
  }
}

Sample Response (Success)

Response Body

{
  "namespace": {
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "Zone-A",
    "description": "",
    "state": "DRAFT",
    "refId1": "",
    "refId2": ""
  }
}

HTTP Status Code

201 (Created)

Response Header

The auto-generated unique identifier (id) of the new namespace is returned in the response header. For example:

location: /api/v5/namespaces/xxxxx-xxxxx-xxxxx-xxxxx