Start of change

Reject the use of your user ID with a software services template

You can use this operation to reject the use of your user ID with a software services template.

HTTP method and URI path

GET /zosmf/provisioning/rest/<version>/scc/<object-id>/approvals/
<approval-object-id>/actions/reject
In this request:
<version>
Is the URI path variable that identifies the version of the z/OSMF software services template service. The following value is valid: 1.0.
<object-id>
Identifies the software services template that the approval is associated with.
<approval-object-id>
Identifies the approval object to reject.

Query parameters

None.

Description

This operation rejects an approval that is associated with a software services template. Rejecting the approval means that your user ID is not allowed to be used with the software services template.

On successful completion, HTTP status code 204 (Successful) is returned.

The software services template must be in one of the draft states.

Request content

The request content is expected to contain a JSON object that describes the rejection. See Table 1.

Table 1. Request content for the software services template request
Field name Type Required or optional Description
comment String Optional Text describing the rejection.

Authorization requirements

The user's z/OS user ID must be defined as a domain approver or template approver, or be one of the approvers in the approval object.

The user’s z/OS user ID must have READ access to the following resource profile in the ZMFAPLA class: <SAF-prefix>.ZOSMF.PROVISIONING.SOFTWARE_SERVICES.

See Authorization requirements.

HTTP status codes

On successful completion, HTTP status code 204 (Successful) is returned.

Example HTTP interaction

In Figure 1, a request is submitted to reject an approval record for a software services template.
Figure 1. Sample request to reject an approval record for a software services template
POST https://localhost:4444/zosmf/provisioning/rest/1.0/scc/8abd70b5-ac74-4f4a-bc09-266bf7cf8270/approvals/
dacea656-ffbe-48ce-a193-575161ff9d43/actions/reject

{
     "comment":"disagree with this, rework required"
}

End of change