Package org.apache.syncope.common.rest.api.service

Interface RemediationService

All Superinterfaces:
JAXRSService
@Path("remediations") public interface RemediationService extends JAXRSService
REST operations for remediations.

  • Method Details

    • list

      @GET @Produces({"application/json","application/yaml","application/xml"}) PagedResult<RemediationTO> list(@BeanParam RemediationQuery query)
      Returns a list of all remediations.
      Parameters:
      query - query conditions
      Returns:
      list of all remediations.

    • read

      @GET @Path("{key}") @Produces({"application/json","application/yaml","application/xml"}) RemediationTO read(@NotNull @PathParam("key") @NotNull String key)
      Returns remediation with matching key.
      Parameters:
      key - key of remediation to be read
      Returns:
      remediation with matching key

    • delete

      @DELETE @Path("{key}") @Produces({"application/json","application/yaml","application/xml"}) jakarta.ws.rs.core.Response delete(@NotNull @PathParam("key") @NotNull String key)
      Deletes the remediation matching the given key.
      Parameters:
      key - key for remediation to be deleted
      Returns:
      an empty response if operation was successful

    • remedy

      @POST @Path("{remediationKey}") @Consumes({"application/json","application/yaml","application/xml"}) @Produces({"application/json","application/yaml","application/xml"}) jakarta.ws.rs.core.Response remedy(@NotNull @PathParam("remediationKey") @NotNull String remediationKey, @NotNull @NotNull org.apache.syncope.common.lib.request.AnyCR createReq)
      Perform remediation by creating the provided user, group or any object.
      Parameters:
      remediationKey - key for remediation to act on
      createReq - user, group or any object to create
      Returns:
      Response object featuring Location header of created object as well as the object itself enriched with propagation status information

    • remedy

      @PATCH @Path("{remediationKey}") @Consumes({"application/json","application/yaml","application/xml"}) @Produces({"application/json","application/yaml","application/xml"}) jakarta.ws.rs.core.Response remedy(@NotNull @PathParam("remediationKey") @NotNull String remediationKey, @NotNull @NotNull org.apache.syncope.common.lib.request.AnyUR updateReq)
      Perform remediation by updating the provided user, group or any object.
      Parameters:
      remediationKey - key for remediation to act on
      updateReq - user, group or any object to update
      Returns:
      Response object featuring the updated object enriched with propagation status information

    • remedy

      @DELETE @Path("{remediationKey}/{anyKey}") @Produces({"application/json","application/yaml","application/xml"}) jakarta.ws.rs.core.Response remedy(@NotNull @PathParam("remediationKey") @NotNull String remediationKey, @NotNull @PathParam("anyKey") @NotNull String anyKey)
      Perform remediation by deleting the provided user, group or any object.
      Parameters:
      remediationKey - key for remediation to act on
      anyKey - user's, group's or any object's key to delete
      Returns:
      Response object featuring the deleted object enriched with propagation status information