getScanner
- Print
- PDF
getScanner
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Available in VPC
View the scanner that corresponds to a specific scanner ID in the user catalog.
Request
Request URL
GET {DATA_CATALOG API_URL}/catalogs/{catalog-id}/scanners/{scanner-id}
Request parameters
| Parameter name | Required | Type | Restrictions | Description |
|---|---|---|---|---|
| catalogId | Yes | String | Unique catalog ID (See getCatalogs) | |
| scannerId | Yes | String | Unique scanner ID |
Request headers
Request example
curl -X GET "https://datacatalog.apigw.ntruss.com/api/v1/catalogs/{catalog-id}/scanners/{scanner-id}" \
-H "x-ncp-apigw-timestamp: {x-ncp-apigw-timestamp}" \
-H "x-ncp-iam-access-key: {x-ncp-iam-access-key}" \
-H "x-ncp-apigw-signature-v2: {x-ncp-apigw-signature-v2}"
Response
Response body
| Category | Type | Description |
|---|---|---|
| scannerId | Integer | Unique scanner ID |
| name | String | Scanner name |
| description | String | Scanner description |
| type | String | Scanner type |
| status | String | Scanner status (Pending execution/Execution started/Running/Execution ended) |
| location | String | Location to scan |
| schedule | String | cron expression |
| scheduleType | String | Execution cycle (on-demand/daily/weekly/monthly/cron) |
| opAddType | String | (When adding schema) Update table definition, add new columns only, ignore |
| opDelType | String | Fixed value at DEL_NO |
| includePattern | String | Patterns to include in scans |
| excludePattern | String | Patterns to exclude from scans |
| tablePrefixName | String | Prefix character of the data that the scanner will run and output |
| lastExecStartTime | Date | Last execution start time of the scanner |
| lastExecElapsedTime | Integer | Run time (seconds) for the scanner's last execution |
| lastResult | String | Results for the scanner's last execution |
| isSchedulePaused | Integer | Whether to pause the execution cycle |
| catalogId | Integer | Unique user catalog ID |
| connectionId | Integer | Unique connection ID |
| connectionName | String | Connection name |
| classifierResponseList | json | Information about the list of classifiers applied as run options in the scanner |
| databaseName | String | Database of data that the scanner will run and output |
| createTime | Date | Connection creation date and time |
| updateTime | Date | Connection modification date and time |
| lastHistoryUuid | String | Last scan history UUID |
Response example
HTTP
| HTTP status | Description |
|---|---|
| 200 | OK |
JSON
{
"scannerId": 89,
"name": "datacatalog-test-scanner",
"description": "",
"type": "OBJECT_STORAGE",
"status": "SCANNER_IDLE",
"location": "datacatalog-test",
"schedule": "",
"scheduleType": "ON_DEMAND",
"opAddType": "UPDATE_TABLE",
"opDelType": "DEL_NO",
"includePattern": "",
"excludePattern": "",
"tablePrefixName": "",
"lastExecStartTime": "2023-06-16T10:45:54+0900",
"lastExecElapsedTime": 6,
"lastResult": "SUCCESS",
"isSchedulePaused": 0,
"catalogId": 301,
"connectionId": 87,
"connectionName": "datacatalog-test-conn",
"classifierResponseList": [
{
"disabled": false,
"classifierId": 30,
"catalogId": 301,
"name": "datacatalog-json-classier",
"type": "JSON",
"value": "$.store.book[*]",
"createTime": "2022-12-05T10:07:08+0900"
},
{
"disabled": false,
"classifierId": 31,
"catalogId": 301,
"name": "datacatalog-csv-classier",
"type": "CSV",
"value": ",",
"createTime": "2023-04-17T08:14:45+0900"
}
],
"databaseName": "datacatalog-scan-db",
"createTime": "2023-05-19T20:12:26+0900",
"updateTime": "2023-06-16T10:46:15+0900",
"lastHistoryUuid": do5sxpiAs"
}
Was this article helpful?