Jump to

• Request
• Response
• Examples

Get Migration Task Categories

get

/rest/v19/migrationTasks/{taskId}/categories

This endpoint retrieves a list of migration task categories for a specified task.

Request

Path Parameters

• taskId(required): number
  The task identifier.

Query Parameters

• expand: string
  Expand the child content.

  Allowed Values: [ "all" ]

Back to Top

Response

Supported Media Types

• application/json

Default Response

List of categories for migration task

Body ()

Root Schema : migrationTaskCategory-collection

Type: object

Show Source

• items: array Migration Task Category list
  Title: Migration Task Category list

  List of migration task sub categories.
• links: array Links to the related objects
  Title: Links to the related objects

  Links to the related objects

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "description":"List of migration task sub categories.",
            "title":"Migration Task Category list",
            "items":{
                "$ref":"#/definitions/migrationTaskCategory"
            }
        },
        "links":{
            "type":"array",
            "description":"Links to the related objects",
            "title":"Links to the related objects",
            "items":{
                "$ref":"#/definitions/referenceLinks"
            }
        }
    }
}

Nested Schema : Migration Task Category list

Type: array

Title: Migration Task Category list

List of migration task sub categories.

Show Source

• Array of: object Migration Task Category Details
  Title: Migration Task Category Details

{
    "type":"array",
    "description":"List of migration task sub categories.",
    "title":"Migration Task Category list",
    "items":{
        "$ref":"#/definitions/migrationTaskCategory"
    }
}

Nested Schema : Links to the related objects

Type: array

Title: Links to the related objects

Links to the related objects

Show Source

• Array of: object referenceLinks
  Reference links for the Parent, Self, Children and Related as applicable

{
    "type":"array",
    "description":"Links to the related objects",
    "title":"Links to the related objects",
    "items":{
        "$ref":"#/definitions/referenceLinks"
    }
}

Nested Schema : Migration Task Category Details

Type: object

Title: Migration Task Category Details

Show Source

• category: string
  Title: category

  Migration task sub category.
• categoryDetails: object Migration Task Category Logs Details
  Title: Migration Task Category Logs Details
• categoryLabel: string
  Title: categoryLabel

  Category display name.
• date: string
  Title: date

  Completed date for migration sub task.
• links: array Links to the related objects
  Title: Links to the related objects

  Links to the related objects
• status: string
  Title: status

  Status of the migration sub task.
• statusLabel: string
  Title: statusLabel

  Status display name.
• statusMessage: string
  Title: statusMessage

  Task Status message.

{
    "type":"object",
    "properties":{
        "category":{
            "type":"string",
            "description":"Migration task sub category.",
            "title":"category"
        },
        "categoryLabel":{
            "type":"string",
            "description":"Category display name.",
            "title":"categoryLabel"
        },
        "date":{
            "type":"string",
            "description":"Completed date for migration sub task.",
            "title":"date"
        },
        "status":{
            "type":"string",
            "description":"Status of the migration sub task.",
            "title":"status"
        },
        "statusLabel":{
            "type":"string",
            "description":"Status display name.",
            "title":"statusLabel"
        },
        "statusMessage":{
            "type":"string",
            "description":"Task Status message.",
            "title":"statusMessage"
        },
        "categoryDetails":{
            "$ref":"#/definitions/migrationTaskCategoryDetails"
        },
        "links":{
            "type":"array",
            "description":"Links to the related objects",
            "title":"Links to the related objects",
            "items":{
                "$ref":"#/definitions/referenceLinks"
            }
        }
    },
    "title":"Migration Task Category Details"
}

Nested Schema : Migration Task Category Logs Details

Type: object

Title: Migration Task Category Logs Details

Show Source

• category: string
  Title: category

  Migration task sub category.
• categoryLabel: string
  Title: categoryLabel

  Category display name.
• events: array Migration Task Sub Category Log Event
  Title: Migration Task Sub Category Log Event

  List of migration task sub category log event.
• logs: array Migration Task Sub Category Logs
  Title: Migration Task Sub Category Logs

  List of migration task sub category logs.

{
    "type":"object",
    "properties":{
        "category":{
            "type":"string",
            "description":"Migration task sub category.",
            "title":"category"
        },
        "categoryLabel":{
            "type":"string",
            "description":"Category display name.",
            "title":"categoryLabel"
        },
        "events":{
            "type":"array",
            "description":"List of migration task sub category log event.",
            "title":"Migration Task Sub Category Log Event",
            "items":{
                "$ref":"#/definitions/migrationTaskCategoryLogEvent"
            }
        },
        "logs":{
            "type":"array",
            "description":"List of migration task sub category logs.",
            "title":"Migration Task Sub Category Logs",
            "items":{
                "$ref":"#/definitions/migrationTaskCategoryLog"
            }
        }
    },
    "title":"Migration Task Category Logs Details"
}

Nested Schema : Links to the related objects

Type: array

Title: Links to the related objects

Links to the related objects

Show Source

• Array of: object referenceLinks
  Reference links for the Parent, Self, Children and Related as applicable

{
    "type":"array",
    "description":"Links to the related objects",
    "title":"Links to the related objects",
    "items":{
        "$ref":"#/definitions/referenceLinks"
    }
}

Nested Schema : Migration Task Sub Category Log Event

Type: array

Title: Migration Task Sub Category Log Event

List of migration task sub category log event.

Show Source

• Array of: object Migration Task Sub Category Log Event
  Title: Migration Task Sub Category Log Event

{
    "type":"array",
    "description":"List of migration task sub category log event.",
    "title":"Migration Task Sub Category Log Event",
    "items":{
        "$ref":"#/definitions/migrationTaskCategoryLogEvent"
    }
}

Nested Schema : Migration Task Sub Category Logs

Type: array

Title: Migration Task Sub Category Logs

List of migration task sub category logs.

Show Source

• Array of: object Migration Task Sub Category Log Messages
  Title: Migration Task Sub Category Log Messages

{
    "type":"array",
    "description":"List of migration task sub category logs.",
    "title":"Migration Task Sub Category Logs",
    "items":{
        "$ref":"#/definitions/migrationTaskCategoryLog"
    }
}

Nested Schema : Migration Task Sub Category Log Event

Type: object

Title: Migration Task Sub Category Log Event

Show Source

• name: string
  Title: name

  Name of the log event.
• status: string
  Title: status

  Status of the event.
• statusLabel: string
  Title: statusLabel

  Event status display name.
• statusMessage: string
  Title: statusMessage

  Event status message.
• timeStamp: string
  Title: timeStamp

  Event completed timestamp.

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the log event.",
            "title":"name"
        },
        "timeStamp":{
            "type":"string",
            "description":"Event completed timestamp.",
            "title":"timeStamp"
        },
        "status":{
            "type":"string",
            "description":"Status of the event.",
            "title":"status"
        },
        "statusLabel":{
            "type":"string",
            "description":"Event status display name.",
            "title":"statusLabel"
        },
        "statusMessage":{
            "type":"string",
            "description":"Event status message.",
            "title":"statusMessage"
        }
    },
    "title":"Migration Task Sub Category Log Event"
}

Nested Schema : Migration Task Sub Category Log Messages

Type: object

Title: Migration Task Sub Category Log Messages

Show Source

• displayName: string
  Title: displayName

  Display Name of the log Messages.
• items: array Migration Task Sub Category Log Messages
  Title: Migration Task Sub Category Log Messages

  List of migration log messages.

{
    "type":"object",
    "properties":{
        "displayName":{
            "type":"string",
            "description":"Display Name of the log Messages.",
            "title":"displayName"
        },
        "items":{
            "type":"array",
            "description":"List of migration log messages.",
            "title":"Migration Task Sub Category Log Messages",
            "items":{
                "$ref":"#/definitions/message"
            }
        }
    },
    "title":"Migration Task Sub Category Log Messages"
}

Nested Schema : Migration Task Sub Category Log Messages

Type: array

Title: Migration Task Sub Category Log Messages

List of migration log messages.

Show Source

• Array of: string
  Title: Message

  Message

{
    "type":"array",
    "description":"List of migration log messages.",
    "title":"Migration Task Sub Category Log Messages",
    "items":{
        "$ref":"#/definitions/message"
    }
}

Nested Schema : referenceLinks

Type: object

Reference links for the Parent, Self, Children and Related as applicable

Show Source

• href: string
  Title: URL to the related object

  URL to the related object
• rel: string
  Title: Link Relationship to the current object

  Link Relationship to the current object

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "description":"Link Relationship to the current object",
            "title":"Link Relationship to the current object"
        },
        "href":{
            "type":"string",
            "description":"URL to the related object",
            "title":"URL to the related object"
        }
    },
    "description":"Reference links for the Parent, Self, Children and Related as applicable"
}

Back to Top

Examples

The following example shows how to retrieve a list of migration task categories for a specified task by submitting a GET request to the REST resource using cURL. For more information about cURL, see Use cURL.

curl -X POST -H "Authorization: Bearer <token>" -H "Content-type: application/json" -H "Accept: application/json"
https://sitename.oracle.com/rest/v19/3023616692/categories

Request Body Sample

{
  "items": [{
      "category": "FILE_MANAGER",
      "categoryLabel": "File Manager",
      "date": "2025-02-12T14:31:58.344Z",
      "status": "Successful",
      "statusLabel": "Successful",
      "links": [{
          "rel": "self",
          "href": "https://sitename.oracle.com/rest/v19/migrationTasks/3023616692/categories/FILE_MANAGER"
        }
      ]
    }, {
      "category": "COMMERCE",
      "categoryLabel": "Commerce",
      "date": "2025-02-12T14:32:04.359Z",
      "status": "Successful",
      "statusLabel": "Successful",
      "statusMessage": "Warning occurred during the migration. Please see the logs for more details.",
      "links": [{
          "rel": "self",
          "href": "https://sitename.oracle.com/rest/v19/migrationTasks/3023616692/categories/COMMERCE"
        }
      ]
    }, {
      "category": "UTIL_LIBRARY",
      "categoryLabel": "Util Library",
      "date": "2025-02-12T14:32:58.887Z",
      "status": "Successful",
      "statusLabel": "Successful",
      "links": [{
          "rel": "self",
          "href": "https://sitename.oracle.com/rest/v19/migrationTasks/3023616692/categories/UTIL_LIBRARY"
        }
      ]
    }, {
      "category": "PACKAGE",
      "categoryLabel": "Package",
      "date": "2025-02-12T14:41:23.738Z",
      "status": "Successful",
      "statusLabel": "Successful",
      "links": [{
          "rel": "self",
          "href": "https://sitename.oracle.com/rest/v19/migrationTasks/3023616692/categories/PACKAGE"
        }
      ]
    }
  ],
  "links": [{
      "rel": "self",
      "href": "https://sitename.oracle.com/rest/v19/migrationTasks/3023616692/categories"
    }
  ]
}

Back to Top