Jump to

• Request
• Response

Modify Purge Schedule

put

/mftapp/rest/v1/purges/schedules/{scheduleName}

Request

Supported Media Types

• application/json

Path Parameters

• scheduleName: string
  name of the Purge Schedule

Query Parameters

• action(optional): string
  Action to modify Purge Schedule

Body ()

Root Schema : mftPurgeScheduleDO

Type: object

Show Source

• comment(optional): string
• endDate(optional): string
• frequency(optional): string
• include(optional): boolean
• instanceStatuses(optional): object instanceStatuses
• retentionPeriod(optional): string
• scheduleTime(optional): string
• startDate(optional): string
• transfers(optional): object transfers

{
    "type":"object",
    "properties":{
        "retentionPeriod":{
            "type":"string"
        },
        "startDate":{
            "type":"string"
        },
        "instanceStatuses":{
            "type":"object",
            "properties":{
                "instanceStatus":{
                    "type":"array",
                    "items":{
                        "type":"string"
                    }
                }
            }
        },
        "include":{
            "type":"boolean"
        },
        "scheduleTime":{
            "type":"string"
        },
        "comment":{
            "type":"string"
        },
        "transfers":{
            "type":"object",
            "properties":{
                "transfer":{
                    "type":"array",
                    "items":{
                        "type":"string"
                    }
                }
            }
        },
        "endDate":{
            "type":"string"
        },
        "frequency":{
            "type":"string"
        }
    }
}

Nested Schema : instanceStatuses

Type: object

Show Source

• instanceStatus(optional): array instanceStatus

{
    "type":"object",
    "properties":{
        "instanceStatus":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    }
}

Nested Schema : transfers

Type: object

Show Source

• transfer(optional): array transfer

{
    "type":"object",
    "properties":{
        "transfer":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    }
}

Nested Schema : instanceStatus

Type: array

Show Source

• [0]: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : transfer

Type: array

Show Source

• [0]: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Example Request (application/json)

{
    "retentionPeriod":"7",
    "startDate":"10-05-2016",
    "instanceStatuses":{
        "instanceStatus":[
            "F",
            "C"
        ]
    },
    "include":true,
    "scheduleTime":"04:32:10",
    "comment":"No Comment",
    "transfers":{
        "transfer":[
            "T1",
            "T2"
        ]
    },
    "endDate":"10-07-2016",
    "frequency":"DAILY"
}

Response

Supported Media Types

• application/json

200 Response

Purge Schedule modification succeeded.

Headers

• location: string
  Relative URL of the Purge Schedule.

500 Response

Something went wrong

Body ()

Root Schema : Error information.

Type: object

Title: Error information.

Show Source

• errorCode(optional): string
  The error code that Oracle Managed File Transfer returns.
• errorKey(optional): string
  The error key that Oracle Managed File Transfer returns.
• errorMessage(optional): string
  A message describing the error that Oracle Managed File Transfer returns.

{
    "title":"Error information.",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"The error code that Oracle Managed File Transfer returns."
        },
        "errorKey":{
            "type":"string",
            "description":"The error key that Oracle Managed File Transfer returns."
        },
        "errorMessage":{
            "type":"string",
            "description":"A message describing the error that Oracle Managed File Transfer returns."
        }
    }
}

Example Response (application/json)

{
    "errorCode":"MFT-5835",
    "errorKey":"MFT_ESS_PURGE_SCHEDULE_DEACTIVATE_EXCEPTION",
    "errorMessage":"Trying to deactivate a non-active Schedule Purge [Default_Purge_Schedule]."
}