Jump to

• Request
• Response
• Examples

Add/Update the trigger details

put

/iam/governance/selfservice/api/v1/scheduler/jobs/{jobName}/trigger

Adds or updates the trigger of a job.

Request

Supported Media Types

• application/json

Path Parameters

• jobName: string
  Name of the job

Body ()

Root Schema : Trigger

Type: object

Show Source

• endTime(optional): string(date-time)
  Format: yyyy-MM-dd'T'HH:mm:ss'Z'
• intervalType(optional): string
• intervalValues(optional): array intervalValues
• jobName(optional): string
• nextFireTime(optional): string(date-time)
  Format: yyyy-MM-dd'T'HH:mm:ss'Z'
• startTime(optional): string(date-time)
  Format: yyyy-MM-dd'T'HH:mm:ss'Z'
• triggerName(optional): string
• triggerType(optional): string
  Allowed Values: [ "Cron", "Periodic", "Single", "None" ]

{
    "type":"object",
    "properties":{
        "triggerName":{
            "type":"string"
        },
        "jobName":{
            "type":"string"
        },
        "startTime":{
            "type":"string",
            "format":"date-time",
            "description":"Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
        },
        "endTime":{
            "type":"string",
            "format":"date-time",
            "description":"Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
        },
        "nextFireTime":{
            "type":"string",
            "format":"date-time",
            "description":"Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
        },
        "triggerType":{
            "type":"string",
            "enum":[
                "Cron",
                "Periodic",
                "Single",
                "None"
            ]
        },
        "intervalType":{
            "type":"string"
        },
        "intervalValues":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    }
}

Nested Schema : intervalValues

Type: array

Show Source

• Array of: string

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

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK

Body ()

Root Schema : Success

Type: object

Show Source

• jobName(optional): string
• status(optional): string
  Status of the executed action

{
    "type":"object",
    "properties":{
        "jobName":{
            "type":"string"
        },
        "status":{
            "type":"string",
            "description":"Status of the executed action"
        }
    }
}

400 Response

Invalid input

Back to Top

Examples

The following example shows how to add or update the trigger of a job by submitting the PUT request using cURL. The information shown here is against a pseudo system and serves as a prototype.

cURL Example

curl -i -X PUT -u username:password /
--header 'Content-Type: application/json' /
--header 'Accept: application/json' /
--header 'X-Requested-By: <anyvalue>' -d @put.json' /
'http://pseudo.com/iam/governance/selfservice/api/v1/scheduler/jobs/Catalog Synchronization Job/trigger/'

Example of PUT Request Body

The following example shows the contents of the request body in JSON format:

{
    "startTime": "2021-11-24T17:44:00Z",
    "intervalType": "MONTHLYWEEKDAYS",
    "triggerType": "Cron",
    "intervalValues": [
        "Fourth Monday"
    ]
}

Example of PUT Response Body

The following example shows the contents of the response body in JSON format:

{
    "jobName": "Catalog Synchronization Job",
    "status": "Trigger add successfull"
}

Back to Top