Registers the callback URL
post
ess/rest/scheduler/v1/requests/{requestId}/subscribe
Registers for the callback URL in case it is not done during request submission.
Request
Path Parameters
- requestId(required): integer(int64) the job request ID
Supported Media Types
- application/json
- application/vnd.oracle.resource+json
Root Schema : schema
Type:
object
The typical set of properties that are required to invoke the callback rest endpoint. These properties need to be specified as per the securityScheme.
Show Source - accessTokenUri: string URL to obtain access tokens from the Identity store. This property is usually required for DIRECT_OAUTH security scheme.
- callbackResourcePath(required): string Property that specifies the relative Path for REST Resource. The base Resource URL is given by callbackUrlPrefix property. This property is required for all the security schemes.
- callbackUrlPrefix(required): string Property that specifies the base URL of a REST Resource that can be used in conjunction with callbackResourcePath property to provide a full URL for the resource. This property is required for all the security schemes.
- clientId: string The clientId issued by OAuth server during client registration that should be added to credential store and provided as a policy parameter before making a call. This property is usually required for OWSM_LPA and DIRECT_OAUTH security schemes.
- clientSecret: string The client secret issued by OAuth server during client registration that should be added to credential store and provided as a policy parameter before making a call. This property is usually required for OWSM_LPA and DIRECT_OAUTH security schemes.
- ouath2ClientCsfKey: string Property to set the client's CSF key. Eg: "idcs.client.credentials". This will be specified in OWSM's ConfigOverride.CO_OAUTH2_CLIENT_CSF_KEY while creating PolicySetFeature. This property is usually required for OWSM_LPA security scheme.
- securityScheme: string Allowed Values:
[ "OWSM_GPA", "OWSM_LPA", "DIRECT_OAUTH" ]
One among "OWSM_GPA", "OWSM_LPA", "DIRECT_OAUTH". If unspecified, the default will be assumed as OWSM_GPA. For OWSM_LPA, the default policy attached from client will be "oracle/http_oauth2_token_client_policy". For "ouath2ClientCsfKey" property of "OWSM_LAP" security scheme, the subscribers need to ensure the password credential is configured in CSF under the csf map "oracle.wsm.security". For "clientId" and "clientSecret" properties of "DIRECT_OAUTH security" scheme, the subscribers need to ensure the clientId and secret is configured in IDCS.
Root Schema : schema
Type:
object
The typical set of properties that are required to invoke the callback rest endpoint. These properties need to be specified as per the securityScheme.
Show Source - accessTokenUri: string URL to obtain access tokens from the Identity store. This property is usually required for DIRECT_OAUTH security scheme.
- callbackResourcePath(required): string Property that specifies the relative Path for REST Resource. The base Resource URL is given by callbackUrlPrefix property. This property is required for all the security schemes.
- callbackUrlPrefix(required): string Property that specifies the base URL of a REST Resource that can be used in conjunction with callbackResourcePath property to provide a full URL for the resource. This property is required for all the security schemes.
- clientId: string The clientId issued by OAuth server during client registration that should be added to credential store and provided as a policy parameter before making a call. This property is usually required for OWSM_LPA and DIRECT_OAUTH security schemes.
- clientSecret: string The client secret issued by OAuth server during client registration that should be added to credential store and provided as a policy parameter before making a call. This property is usually required for OWSM_LPA and DIRECT_OAUTH security schemes.
- ouath2ClientCsfKey: string Property to set the client's CSF key. Eg: "idcs.client.credentials". This will be specified in OWSM's ConfigOverride.CO_OAUTH2_CLIENT_CSF_KEY while creating PolicySetFeature. This property is usually required for OWSM_LPA security scheme.
- securityScheme: string Allowed Values:
[ "OWSM_GPA", "OWSM_LPA", "DIRECT_OAUTH" ]
One among "OWSM_GPA", "OWSM_LPA", "DIRECT_OAUTH". If unspecified, the default will be assumed as OWSM_GPA. For OWSM_LPA, the default policy attached from client will be "oracle/http_oauth2_token_client_policy". For "ouath2ClientCsfKey" property of "OWSM_LAP" security scheme, the subscribers need to ensure the password credential is configured in CSF under the csf map "oracle.wsm.security". For "clientId" and "clientSecret" properties of "DIRECT_OAUTH security" scheme, the subscribers need to ensure the clientId and secret is configured in IDCS.
Response
Supported Media Types
- application/json
- application/vnd.oracle.resource+json
200 Response
Operation initiated
Nested Schema : link
Type:
Show Source object
- href: string (uri) href of the provided link
- rel: string relationship with the returned resourceExample:
self
400 Response
Unsupported request for registration
Root Schema : SimpleExceptionDetail
Type:
Show Source object
- detail: string Detailed error message
- errorCode: string ESS-specific error code. For example ESS-00500.
- status: integer HTTP status code
- title(required): string Summary error message
- type(required): string URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page.
403 Response
Not allowed for this operation
Root Schema : SimpleExceptionDetail
Type:
Show Source object
- detail: string Detailed error message
- errorCode: string ESS-specific error code. For example ESS-00500.
- status: integer HTTP status code
- title(required): string Summary error message
- type(required): string URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page.
404 Response
Request ID not found
Root Schema : SimpleExceptionDetail
Type:
Show Source object
- detail: string Detailed error message
- errorCode: string ESS-specific error code. For example ESS-00500.
- status: integer HTTP status code
- title(required): string Summary error message
- type(required): string URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page.
409 Response
Conflict
Root Schema : SimpleExceptionDetail
Type:
Show Source object
- detail: string Detailed error message
- errorCode: string ESS-specific error code. For example ESS-00500.
- status: integer HTTP status code
- title(required): string Summary error message
- type(required): string URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page.
500 Response
Scheduling sub-system error
Root Schema : SimpleExceptionDetail
Type:
Show Source object
- detail: string Detailed error message
- errorCode: string ESS-specific error code. For example ESS-00500.
- status: integer HTTP status code
- title(required): string Summary error message
- type(required): string URI. It will be beneficial if teams can provide application specific problem types. If not, at least we should link to HTTP error code page.