mainframeDatasetConnector

Get all Mainframe Dataset connectors

Securityapi_key
Request
query Parameters
environment_id
integer <int32>

The ID of the environment to get all Mainframe Dataset connectors from

page_number
integer <int64>
Default: 1

The page number for which to get Mainframe Dataset connectors. This will default to the first page if excluded

page_size
integer <int64>

The maximum number of objects to return. This will default to the DefaultApiPageSize setting if not provided

Responses
default

Successful operation

get/mainframe-dataset-connectors
Response samples
application/json
{
  • "_pageInfo": {
    },
  • "responseList": [
    ]
}

Create Mainframe Dataset connector

Securityapi_key
Request
Request Body schema: application/json
required

The Mainframe Dataset connector to create

connectorName
required
string <= 45 characters

The name of the Mainframe Dataset connector.

environmentId
required
integer <int32>

The ID number of the environment that the Mainframe Dataset connector is in. Once the Mainframe Dataset connector is created, this field cannot be changed.

required
object (ConnectionInfo)
Responses
default

Successful operation

post/mainframe-dataset-connectors
Request samples
application/json
{
  • "connectorName": "mainframe_dataset_connector_via_sftp",
  • "environmentId": 123,
  • "connectionInfo": {
    }
}
Response samples
application/json
{
  • "connectorName": "mainframe_dataset_connector_via_sftp",
  • "environmentId": 123,
  • "connectionInfo": {
    }
}

Get Mainframe Dataset connector by ID

Securityapi_key
Request
path Parameters
mainframeDatasetConnectorId
required
integer <int32>

The ID of the Mainframe Dataset connector to get

Responses
200

Successful operation

400

Invalid mainframeDatasetConnectorId supplied

403

Forbidden access

404

Mainframe Dataset Connector not found

get/mainframe-dataset-connectors/{mainframeDatasetConnectorId}
Response samples
application/json
{
  • "connectorName": "mainframe_dataset_connector_via_sftp",
  • "environmentId": 123,
  • "connectionInfo": {
    }
}

Update Mainframe Dataset connector by ID

Securityapi_key
Request
path Parameters
mainframeDatasetConnectorId
required
integer <int32>

The ID of the Mainframe Dataset connector to update

Request Body schema: application/json
required

The updated Mainframe Dataset connector

connectorName
required
string <= 45 characters

The name of the Mainframe Dataset connector.

environmentId
required
integer <int32>

The ID number of the environment that the Mainframe Dataset connector is in. Once the Mainframe Dataset connector is created, this field cannot be changed.

required
object (ConnectionInfo)
Responses
200

Successful operation

400

Invalid mainframeDatasetConnectorId supplied

403

Forbidden access

404

Mainframe Dataset Connector not found

put/mainframe-dataset-connectors/{mainframeDatasetConnectorId}
Request samples
application/json
{
  • "connectorName": "mainframe_dataset_connector_via_sftp",
  • "environmentId": 123,
  • "connectionInfo": {
    }
}
Response samples
application/json
{
  • "connectorName": "mainframe_dataset_connector_via_sftp",
  • "environmentId": 123,
  • "connectionInfo": {
    }
}

Delete Mainframe Dataset connector by ID

Securityapi_key
Request
path Parameters
mainframeDatasetConnectorId
required
integer <int32>

The ID of the Mainframe Dataset connector to delete

Responses
200

Successful operation

400

Invalid mainframeDatasetConnectorId supplied

403

Forbidden access

404

Mainframe Dataset Connector not found

delete/mainframe-dataset-connectors/{mainframeDatasetConnectorId}

Fetch all accessible file names

Note that even the names of files in the directory path that are not readable or writable will be returned

Securityapi_key
Request
path Parameters
mainframeDatasetConnectorId
required
integer <int32>

The ID of the Mainframe Dataset connector to fetch the files for

query Parameters
hideExisting
boolean

This flag specifies fetching only table names that are not already part of a particular ruleset.

rulesetId
integer <int32>

Ruleset ID to check if the file is already added. Required in case of hideExisting is set to true.

Responses
200

Successful operation

400

Invalid mainframeDatasetConnectorId supplied

403

Forbidden access

404

Mainframe Dataset Connector not found

get/mainframe-dataset-connectors/{mainframeDatasetConnectorId}/fetch
Response samples
application/json
[
  • "string"
]

Test Mainframe Dataset connector by ID

WARNING: There is a known bug in the API Client where it is impossible to submit a request with an 'empty' body. As such, only the 'full' body variant of this endpoint can be used through the API Client. To use the 'empty' body variant of this endpoint, please do not use the API Client, but instead use curl or some other method of issuing HTTP requests.

Securityapi_key
Request
path Parameters
mainframeDatasetConnectorId
required
integer <int32>

The ID of the Mainframe Dataset connector to test

Request Body schema: application/json
optional

The Mainframe Dataset connector to test. This field is optional and if no password or sshkey is supplied with the connector then the password associated with the fileConnectorId will be used.

connectorName
required
string <= 45 characters

The name of the Mainframe Dataset connector.

environmentId
required
integer <int32>

The ID number of the environment that the Mainframe Dataset connector is in. Once the Mainframe Dataset connector is created, this field cannot be changed.

required
object (ConnectionInfo)
Responses
200

Successful operation

400

Invalid mainframeDatasetConnectorId supplied

403

Forbidden access

404

Mainframe Dataset Connector not found

post/mainframe-dataset-connectors/{mainframeDatasetConnectorId}/test
Request samples
application/json
{
  • "connectorName": "mainframe_dataset_connector_via_sftp",
  • "environmentId": 123,
  • "connectionInfo": {
    }
}
Response samples
application/json
{
  • "response": "string"
}

Test an unsaved Mainframe Dataset connector

Securityapi_key
Request
Request Body schema: application/json
required

The Mainframe Dataset connector to test

connectorName
required
string <= 45 characters

The name of the Mainframe Dataset connector.

environmentId
required
integer <int32>

The ID number of the environment that the Mainframe Dataset connector is in. Once the Mainframe Dataset connector is created, this field cannot be changed.

required
object (ConnectionInfo)
Responses
200

Success

400

Bad request

403

Forbidden access

404

Not found

post/mainframe-dataset-connectors/test
Request samples
application/json
{
  • "connectorName": "mainframe_dataset_connector_via_sftp",
  • "environmentId": 123,
  • "connectionInfo": {
    }
}
Response samples
application/json
{
  • "response": "string"
}
➔ Next to mainframeDatasetFieldMetadata