Start of change

Resource pool services

The resource pool services are an application programming interface (API), which is implemented through industry standard Representational State Transfer (REST) services. These services allow the caller to obtain and release network or WLM resources from the network or WLM resource pool that was defined in support of IBM Cloud Provisioning and Management for z/OS. These REST services are intended to be invoked from a workflow step during cloud provisioning and are not available for general use outside of the scope of cloud provisioning.

Table 1 lists the operations that the resource pool services provide.

Resource pool services

Table 1. z/OSMF resource pool services: operations summary
Operation name HTTP method and URI path
Obtain an IP address
POST /zosmf/resource-mgmt/rest/<version>/rdp/network/ip/obtain
Release an IP address
POST /zosmf/resource-mgmt/rest/<version>/rdp/network/ip/release
Obtain a port
POST /zosmf/resource-mgmt/rest/<version>/rdp/network/port/obtain
Release a port
POST /zosmf/resource-mgmt/rest/<version>/rdp/network/port/release
Obtain a SNA application name
POST /zosmf/resource-mgmt/rest/<version>/rdp/network/snaapplname/actions/obtain
Release a SNA application name
POST /zosmf/resource-mgmt/rest/<version>/rdp/network/snaapplname/release
Add a classification rule
POST /zosmf/resource-mgmt/rest/<version>/rdp/wlm/clrule/actions/add
Remove a classification rule
POST /zosmf/resource-mgmt/rest/<version>/rdp/wlm/classification-rule/actions/remove

Authorization requirements

The user must be a consumer in the tenant, or a network administrator in the domain that the tenant is associated with.

For more information, see Authorization requirements.

HTTP status codes

The following HTTP status codes are valid:
HTTP 200 OK
The request succeeded. A response body is provided, which contains the results of the request.
HTTP 204 No Content
The request succeeded.
HTTP 500 Server error
The server encountered an error when it processed the request.
End of change