Engines

GET /engines

List all engines.


Example Responses

Response Code: 200


{
  "items": [
    {
      "id": "engine-123",
      "uuid": "54290b71-58cd-463d-bd62-7219d4c4d2d5",
      "type": "VIRTUALIZATION",
      "version": "6.0.7.0",
      "name": "My Favorite Engine",
      "hostname": "eng09.dev.delphix.com",
      "registration_status": "CONNECTED",
      "connection_status": "ONLINE",
      "last_connection_time": "2021-03-29T15:10:00.976Z",
      "boot_storage_capacity": 96000000000,
      "cpu_core_count": 4,
      "cpu_type": "Intel(R) Xeon(R) CPU E5-2690 v3 @ 2.60GHz",
      "memory_size": 16000000000,
      "data_storage_capacity": 100000000000,
      "data_storage_used": 85000000000
    }
  ],
  "errors": [
    {
      "message": "string",
      "object_name": "string"
    }
  ]
}

Responses

StatusMeaningDescriptionSchema
200OKOKInline

Response Schema

Status Code: 200

ListEnginesResponse

NameTypeRequiredRestrictionsDescription
» items[Engine]falsenone[A Delphix Virtualization or Masking Engine.]
»» idstringfalsenoneThe Engine object entity ID.
»» uuidstring¦nullfalsenoneThe unique identifier generated by this engine.
»» typestring¦nullfalsenoneThe type of this engine.
»» versionstring¦nullfalsenoneThe engine version.
»» namestringfalsenoneThe name of this engine.
»» hostnamestringfalsenoneThe hostname of this engine.
»» registration_statusstring¦nullfalsenoneThe registration status of this engine.
»» connection_statusstring¦nullfalsenoneThe connection status of this engine.
»» last_connection_timestring(date-time)¦nullfalsenoneThe last time a connection was established with this engine.
»» boot_storage_capacityinteger(int64)¦nullfalsenoneThe total amount of storage allocated to the engine's boot partition, in bytes.
»» cpu_core_countinteger(int32)¦nullfalsenoneThe total number of CPU cores on this engine.
»» cpu_typestring¦nullfalsenoneThe model of the processors on this engine.
»» memory_sizeinteger(int64)¦nullfalsenoneThe total amount of memory on this engine, in bytes.
»» data_storage_capacityinteger(int64)¦nullfalsenoneThe total amount of storage allocated for engine objects and system metadata, in bytes.
»» data_storage_usedinteger(int64)¦nullfalsenoneThe amount of storage used by engine objects and system metadata, in bytes.
» errors[Error]falsenoneSadly, sometimes requests to the API are not successful. Failures can occur for a wide range of reasons. The Errors object contains information about full or partial failures which might have occurred during the request.
»» messagestringfalseread-onlyMessage providing more detail about the error that occurred, if available.
»» object_namestringfalseread-onlyName of the object affected by the error.

Enumerated Values

PropertyValue
typeVIRTUALIZATION
typeMASKING
typeBOTH
typeUNSET
registration_statusCONNECTED
registration_statusPENDING
connection_statusONLINE
connection_statusOFFLINE

To perform this operation, you must be authenticated by means of one of the following methods: ApiKeyAuth

GET /engines/{engineId}

Returns an engine by ID.

Parameters

Name

In

Type

Required

Description

engineIdpathstringtrueThe ID of the engine.


Example Responses

Response Code: 200

{
  "id": "engine-123",
  "uuid": "54290b71-58cd-463d-bd62-7219d4c4d2d5",
  "type": "VIRTUALIZATION",
  "version": "6.0.7.0",
  "name": "My Favorite Engine",
  "hostname": "eng09.dev.delphix.com",
  "registration_status": "CONNECTED",
  "connection_status": "ONLINE",
  "last_connection_time": "2021-03-29T15:10:00.976Z",
  "boot_storage_capacity": 96000000000,
  "cpu_core_count": 4,
  "cpu_type": "Intel(R) Xeon(R) CPU E5-2690 v3 @ 2.60GHz",
  "memory_size": 16000000000,
  "data_storage_capacity": 100000000000,
  "data_storage_used": 85000000000
}

Responses

Status

Meaning

Description

Schema

200OKOKEngine

To perform this operation, you must be authenticated by means of one of the following methods: ApiKeyAuth

Bookmarks

GET /bookmarks

List all bookmarks.


Example Responses

Response Code: 200

{
  "items": [
    {
      "id": "bookmark-123",
      "name": "my-bookmark-123",
      "creation_date": "2021-07-04T08:51:34.148000+00:00",
      "vdb_ids": [
        "vdb-123",
        "vdb-456"
      ],
      "retention": 365,
      "status": "RESTORED"
    }
  ],
  "errors": [
    {
      "message": "string",
      "object_name": "string"
    }
  ]
}


Responses

Status

Meaning

Description

Schema

200OKOKInline

Response Schema

Status Code: 200

ListBookmarksResponse

Name

Type

Required

Restrictions

Description

» items[Bookmark]falsenone[A Data Control Tower object that references points in time for one or more datasets.]
»» idstringfalseread-onlyThe Bookmark object entity ID.
»» namestringtruenoneThe user-defined name of this bookmark.
»» creation_datestring(date-time)falseread-onlyThe date and time that this bookmark was created.
»» vdb_ids[string]truenoneThe list of VDB IDs associated with this bookmark.
»» retentioninteger(int64)falsenoneThe retention policy for this bookmark, in days. A value of -1 indicates the bookmark should be kept forever.
»» statusstring¦nullfalseread-onlyA message with details about operation progress or state of this bookmark.
» errors[Error]falsenoneSadly, sometimes requests to the API are not successful. Failures can occur for a wide range of reasons. The Errors object contains information about full or partial failures which might have occurred during the request.
»» messagestringfalseread-onlyMessage providing more detail about the error that occurred, if available.
»» object_namestringfalseread-onlyName of the object affected by the error.

To perform this operation, you must be authenticated by means of one of the following methods: ApiKeyAuth