Flagged Items Using REST API
List All Flagged Items
List all items from all jobs that have the flagged status. After review, items can be set to retry or ignore on subsequent job runs.
GET {{url}}v1/transfers/items/flaggedSet Single Item to Retry or Ignore
When an item is flagged you can reset the status to either retry or ignore on the next job run.
Set Flagged Item for Retry
PATCH {{url}}v1/transfers/items/{{item_id}}?retry=1Set Flagged Item to Ignore
PATCH {{url}}v1/transfers/items/{{item_id}}?ignore=1Set Multiple Items to Retry or Ignore
When items are flagged you can reset the status to either retry or ignore on multiple items for the next job run using the same filter options available for viewing those items.
Set Flagged Items for Retry
PATCH {{url}}v1/transfers/items?parent={{parentId}}&retrySet Flagged Items to Ignore
PATCH {{url}}v1/transfers/items?id={{itemId}},{{itemId}},{{itemId}}&ignoreSet Flagged Items to Ignore
PATCH {{url}}v1/transfers/items?jobs={{jobId}}&ignoreSet Flagged Items to Ignore
PATCH {{url}}v1/transfers/{{jobdid}}/items?ignoreList All Items Set to Retry or Ignore
List all items from all jobs that are set for retry on subsequent runs.
List All Items Set to Retry
GET {{url}}v1/transfers/items?status=retryList All Items Set to Ignore
GET {{url}}v1/transfers/items?status=skippedShow All Items for Remediation
GET {{url}}v1/transfers/{{job}}/items?status=remediation&include=allShow All System Error Categories
When issues occur during transfer, DryvIQ will categorize the issues based on the error and flag for manual remediation. This allows you to easily identify areas for review.
GET {{url}}v1/transfers/categories?priority=allCreate Custom Error Category by Audit Type
DryvIQ allows you to create your own custom error category by audit type. For example, you could group several error codes together to create a broader category to ignore.
POST {{url}}v1/transfers/categories |
{
"name": "Unknown",
"description": "Items with unknown errors",
"filter": {
"rules": [{
"text": "[audit_type]=5001",
"type": "filter_context"
}]
},
"action": "retry",
"max_retry": 3
} |
Create Custom Error Category by Event Type
DryvIQ allows you to create your own custom error category by event type. For example, you could group several events such as rename and update to create a broader category to retry.
POST {{url}}v1/transfers/categories |
{
"name": "Event Type Rename",
"description": "The event source of the original transfer operation = Rename",
"filter": {
"rules": [{
"text": "[event_type]=rename",
"type": "filter_context"
}]
},
"action": "retry",
"max_retry": 3
} |