Page Comparison

...

	Description
URI	http://host_name/uc/resources/virtual
HTTP Method	POST
Description	Creates a Virtual Resource.
Example URI	http://localhost:8080/uc/resources/virtual
Consumes Content-Type	application/xml, application/json
Produces Content-Type	n/a
Example	See Virtual Resource: XML and JSON Examples.
Properties	See Virtual Resource: Properties.
Example Response	Status 200 /OK Successfully created the Business Service with sysId {sysId}. Status 400 /Bad Request Create virtual resource failed. Resource Name must be defined.

Anchor
Virtual Resource XML and JSON Examples
Virtual Resource XML and JSON Examples
Virtual Resource: XML and JSON Examples

The excludeRelated and retainsSysIds properties are specified as attributes in the XML.

XML

JSON

Expand

title	XML

<virtualResource exportReleaseLevel="7.2.0.0" exportTable="ops_virtual_resource" retainSysIds="true">
  <limit>1</limit>
  <name>test</name>
  <opswiseGroups>
     <opswiseGroup>1</opswiseGroup>
  </opswiseGroups>
  <summary>Resource with limit of only 1.</summary>
  <sysId>416d78bac0a801c901de14704e00fa75</sysId>
  <type>Renewable</type>
</virtualResource>

Expand

title	JSON

{
  "exportReleaseLevel": "7.2.0.0",
  "exportTable": "ops_virtual_resource",
  "limit": 5,
  "name": "test",
  "opswiseGroups": [
    "1"
  ],
  "retainSysIds": true,
  "summary": "Resource with limit of only 1.",
  "sysId": "416d78bac0a801c901de14704e00fa75",
  "type": "Renewable"
 }

Anchor
Virtual Resource Properties
Virtual Resource Properties
Virtual Resource Properties

Property

UI Field Name

Description

Specifications

Required

Anchor

	exportReleaseLevel - CVR
	exportReleaseLevel - CVR

exportReleaseLevel

n/a

Universal Controller release that the record was exported from.

read only

N

Anchor

	exportTable - CVR
	exportTable - CVR

exportTable

n/a

Record table information.

read only

N

Anchor

	limit - CVR
	limit - CVR

limit

Resource Limit

Number of resources available for the specific resource type.

Integer; Default is 10.

N

Anchor

	name - CVR
	name - CVR

name

Name

Name used within the Controller to identify this Virtual Resource.

Contains a maximum of 40 alphanumerics.

Y

Anchor

	opswiseGroups - CVR
	opswiseGroups - CVR

opswiseGroups

Member of Business Services

Business Services that this record belongs to.

XML

Panel
<opswiseGroups> <opswiseGroup>group1</opswiseGroup> <opswiseGroup>group2</opswiseGroup> </opswiseGroups>

JSON

Panel
"opswiseGroups": ["group1","group2"]

N

Anchor

	retainSysIds - CVR
	retainSysIds - CVR

retainSysIds

n/a

For Create web services; specification for whether or not the web service should persist the sysId property.

If retainSysIds is true and sysId is included in the request/response, sysId will be persisted to the database.
If retainSysIds is false and sysId is included in the request/response, sysId will be ignored; it will be autogenerated by the Controller.

Note

title	Note

In XML, retainSysIds is specified as an attribute in the <virtualResource> element.

Valid values: true/false (default is true).

N

Anchor

	summary - CVR
	summary - CVR

summary

Description

User-defined; description of this record.

N

Anchor

	sysId - CVR
	sysId - CVR

sysId

N/A

System ID field in the database for a record.

Persisted only if retainSysIds is set to true.

N

Anchor

	type - CVR
	type - CVR

type

Resource Type

Type of Virtual Resource.

Valid values:

As String = Renewable, As Value = 1
As String = Boundary, As Value = 2
As String = Depletable, As Value = 3

Default is Renewable (1).

N

Anchor

	version - CVR
	version - CVR

version

n/a

For Read and List web services; specification of the version being read or listed.

Note

title	Note

In XML web services, version is specified as an attribute in the <virtualResource> element.

Yes

...

	Description
URI	http://host_name/uc/resources/virtual
HTTP Method	DELETE
Description	Deletes a Virtual Resource.
URI Parameters	See Delete a Virtual Resource: URI Parameters.
Example URI	http://localhost:8080/uc/resources/virtual?resourceid=77171434c0a801c9016d5b2b5d17ddee
Example Response	Status 200 /OK Virtual Resource deleted successfully. Status 400 /Bad Request Mutual exclusion violation. Cannot specify `resourcename` and `resourceid` at the same time. Status 404 /Not Found A virtual resource with {name/id} "test" does not exist.

...

	Description
URI	http://host_name/uc/resources/virtual/list
HTTP Method	GET
Description	Retrieves information on all Virtual Resources.
URI Parameters	See List Virtual Resources: URI Parameters.
Example URI	http://localhost:8080/uc/resources/virtual/list?name=test*&type=renewable
Authentication	HTTP Basic
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Response Example	See List Virtual Resources: XML and JSON Response Examples.
Response Properties	See List Virtual Resources: Response Properties.

Anchor
List Virtual Resources: URI Parameters
List Virtual Resources: URI Parameters
List Virtual Resources: URI Parameters

Parameter	Description	Specifications	Required	Mutually Exclusive With
`name`	Name of this Virtual Resource.	String; URI wild card parameter (that is, `test*`).	N	`resourcename`
`resourcename`	Name of the resource.	Wildcards are supported.	N	`name`
`type`	Type of this Virtual Resource.	Valid Values: As String = Renewable, As Value = 1 As String = Boundary, As Value = 2 As String = Depletable, As Value = 3 If `type` is not specified, it defaults to all types.	N

...

XML

JSON

Expand

title	XML

<virtual-resources>
   <virtual-resource>
      <limit>8</limit>
      <name>test1</name>
      <sysId>416d78bac0a801c901de14704e00fa75</sysId>
      <type>Renewable</type>
      <used>1</used>
      <used-by-tasks>
         <task>
             <amount>1</amount>
             <taskInstanceName>uc - Sleep 60</taskInstanceName>
         </task>
      </used-by-tasks>
      <version>1</version>
   </virtual-resource>
   <virtual-resource>
      <limit>10</limit>
      <name>test2</name>
      <sysId>416d78bac0a801c901de14704e00fa76</sysId>
      <type>Renewable</type>
      <used>1</used>
      <used-by-tasks>
         <task>
             <amount>1</amount>
             <taskInstanceName>uc - Sleep 60</taskInstanceName>
         </task>
      </used-by-tasks>
      <version>1</version>
   </virtual-resource>
</virtual-resources>

Expand

title	JSON

[ {
  "limit": 8,
  "name": "test",
  "sysId": "416d78bac0a801c901de14704e00fa75",
  "type": "Renewable",
  "used": 1,
  "usedByTasks": [ {
    "amount": 1,
    "taskInstanceName": "uc - Sleep 60"
  } ],
  "version": 1
  },
  {
  "limit": 10,
  "name": "test2",
  "sysId": "416d78bac0a801c901de14704e00fa76",
  "type": "Renewable",
  "used": 1,
  "usedByTasks": [ {
    "amount": 1,
    "taskInstanceName": "uc - Sleep 60"
  } ],
  "version": 1
  }
]

Anchor
List Virtual Resources Response Properties
List Virtual Resources Response Properties
List Virtual Resources: Response Properties

...

	Description
URI	http://host_name/uc/resources/virtual/listadv
HTTP Method	GET
Description	Retrieves information on all Virtual Resources.
URI Parameters	See List Virtual Resources Details: URI Parameters.
Example URI	http://localhost:8080/uc/resources/virtual/listadv?resourcename=test*&type=renewable&businessServices=A
Authentication	HTTP Basic
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Response Example	See List Virtual Resources - Advanced: XML and JSON Response Examples.

Anchor
List Virtual Resources - Advanced: URI Parameters
List Virtual Resources - Advanced: URI Parameters
List Virtual Resources - Advanced: URI Parameters

...

XML

JSON

Expand

title	XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<virtualResources>
    <virtualResource exportReleaseLevel="7.2.0.0" exportTable="ops_virtual_resource" retainSysIds="true" version="3">
        <limit>1</limit>
        <name>VR-1</name>
        <opswiseGroups>
            <opswiseGroup>A</opswiseGroup>
        </opswiseGroups>
        <summary>VR test 1</summary>
        <sysId>10e1664d8fe44a4482c6b6d6a64ecc05</sysId>
        <type>Renewable</type>
    </virtualResource>
    <virtualResource retainSysIds="true" version="2">
        <limit>1</limit>
        <name>VR-2</name>
        <opswiseGroups>
            <opswiseGroup>B</opswiseGroup>
        </opswiseGroups>
        <summary>VR test 2</summary>
        <sysId>459020efeff3476682be1a6c8df8f799</sysId>
        <type>Boundary</type>
    </virtualResource>
    <virtualResource exportReleaseLevel="7.2.0.0" exportTable="ops_virtual_resource" retainSysIds="true" version="1">
        <limit>1</limit>
        <name>VR-3</name>
        <opswiseGroups>
            <opswiseGroup>C</opswiseGroup>
        </opswiseGroups>
        <summary>test 3</summary>
        <sysId>f4bfd4882af24948b6f7abd7baad91b1</sysId>
        <type>Depletable</type>
    </virtualResource>
</virtualResources>

Expand

title	JSON

[
    {
        "exportReleaseLevel": "7.2.0.0",
        "exportTable": "ops_virtual_resource",
        "limit": 1,
        "name": "VR-1",
        "opswiseGroups": [
            "A"
        ],
        "retainSysIds": true,
        "summary": "VR test 1",
        "sysId": "10e1664d8fe44a4482c6b6d6a64ecc05",
        "type": "Renewable",
        "version": 3
    },
    {
        "exportReleaseLevel": "7.2.0.0",
        "exportTable": "ops_virtual_resource",
        "limit": 1,
        "name": "VR-2",
        "opswiseGroups": [
            "B"
        ],
        "retainSysIds": true,
        "summary": "VR test 2",
        "sysId": "459020efeff3476682be1a6c8df8f799",
        "type": "Boundary",
        "version": 2
    },
    {
        "exportReleaseLevel": "7.2.0.0",
        "exportTable": "ops_virtual_resource",
        "limit": 1,
        "name": "VR-3",
        "opswiseGroups": [
            "C"
        ],
        "retainSysIds": true,
        "summary": "test 3",
        "sysId": "f4bfd4882af24948b6f7abd7baad91b1",
        "type": "Depletable",
        "version": 1
    }
]

...

	Description
URI	http://host_name/uc/resources/virtual
HTTP Method	PUT
Description	Modifies the Virtual Resource specified by the `sysId`.
Example URI	http://localhost:8080/uc/resources/virtual
Consumes Content-Type	application/xml, application/json
Produces Content-Type	n/a
Example	See Virtual Resource: XML and JSON Examples.
Properties	See Virtual Resource: Properties.
Example Response	Status 200 /OK Successfully updated the virtual resource with sysId <sysId> to version <version>.

...

	Description
URI	http://host_name/uc/resources/virtual
HTTP Method	GET
Description	Retrieves information on a specified Virtual Resource.
Example URI	http://localhost:8080/uc/resources/virtual?resourcename=test
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Example	See Virtual Resource: XML and JSON Examples.
Properties	See Virtual Resource: Properties.

Anchor
Read a Virtual Resource: URI Parameters
Read a Virtual Resource: URI Parameters
Read a Virtual Resource: URI Parameters

...

	Description
URI	http://host_name/uc/resources/virtual/ops-update-resource-limit
HTTP Method	POST
Description	Updates resource limit for virtual resources.
Example URI	http://localhost:8080/uc/resources/virtual/ops-update-resource-limit
Authentication	HTTP Basic
Consumes Content-Type	application/xml, application/json
Produces Content-Type	application/xml, application/json
Example Request	See Set Limit on a Virtual Resource: XML and JSON Examples.
Request Properties	See Set Limit on a Virtual Resource: Request Properties.
Example Response	See Set Limit on a Virtual Resource: XML and JSON Examples.

Anchor
Set Limit on a Virtual Resource XML and JSON Examples
Set Limit on a Virtual Resource XML and JSON Examples
Set Limit on a Virtual Resource: XML and JSON Examples

Example

XML

JSON

Example Request

Expand

title	XML

<virtual-resource>
      <name>uc - Solo</name>
      <limit>1</limit>
</virtual-resource>

Expand

title	JSON

{
  "name": "uc - Solo",
  "limit": 1
}

Example Response

Expand

title	XML

<command-response>
    <type>update_resource_limit</type>
    <success>true</success>
    <info>Successfully updated the virtual resource.</info>
    <errors />
</command-response>

Expand

title	JSON

{
    "type": "update_resource_limit",
    "success": true,
    "info": "Successfully updated virtual resource "uc - Solo" with limit 1. ",
    "errors": ""
}

...

Versions Compared

Old Version 4

New Version Current

Key

Anchor
Virtual Resource XML and JSON Examples
Virtual Resource XML and JSON Examples
Virtual Resource: XML and JSON Examples

Anchor
Virtual Resource Properties
Virtual Resource Properties
Virtual Resource Properties

Anchor
List Virtual Resources: URI Parameters
List Virtual Resources: URI Parameters
List Virtual Resources: URI Parameters

Anchor
List Virtual Resources Response Properties
List Virtual Resources Response Properties
List Virtual Resources: Response Properties

Anchor
List Virtual Resources - Advanced: URI Parameters
List Virtual Resources - Advanced: URI Parameters
List Virtual Resources - Advanced: URI Parameters

Anchor
Read a Virtual Resource: URI Parameters
Read a Virtual Resource: URI Parameters
Read a Virtual Resource: URI Parameters

Anchor
Set Limit on a Virtual Resource XML and JSON Examples
Set Limit on a Virtual Resource XML and JSON Examples
Set Limit on a Virtual Resource: XML and JSON Examples

Page Comparison

Versions Compared

Old Version 4

New Version Current

Key

AnchorVirtual Resource XML and JSON ExamplesVirtual Resource XML and JSON ExamplesVirtual Resource: XML and JSON Examples

AnchorVirtual Resource PropertiesVirtual Resource PropertiesVirtual Resource Properties

AnchorList Virtual Resources: URI ParametersList Virtual Resources: URI ParametersList Virtual Resources: URI Parameters

AnchorList Virtual Resources Response PropertiesList Virtual Resources Response PropertiesList Virtual Resources: Response Properties

AnchorList Virtual Resources - Advanced: URI ParametersList Virtual Resources - Advanced: URI ParametersList Virtual Resources - Advanced: URI Parameters

AnchorRead a Virtual Resource: URI ParametersRead a Virtual Resource: URI ParametersRead a Virtual Resource: URI Parameters

AnchorSet Limit on a Virtual Resource XML and JSON ExamplesSet Limit on a Virtual Resource XML and JSON ExamplesSet Limit on a Virtual Resource: XML and JSON Examples

Anchor
Virtual Resource XML and JSON Examples
Virtual Resource XML and JSON Examples
Virtual Resource: XML and JSON Examples

Anchor
Virtual Resource Properties
Virtual Resource Properties
Virtual Resource Properties

Anchor
List Virtual Resources: URI Parameters
List Virtual Resources: URI Parameters
List Virtual Resources: URI Parameters

Anchor
List Virtual Resources Response Properties
List Virtual Resources Response Properties
List Virtual Resources: Response Properties

Anchor
List Virtual Resources - Advanced: URI Parameters
List Virtual Resources - Advanced: URI Parameters
List Virtual Resources - Advanced: URI Parameters

Anchor
Read a Virtual Resource: URI Parameters
Read a Virtual Resource: URI Parameters
Read a Virtual Resource: URI Parameters

Anchor
Set Limit on a Virtual Resource XML and JSON Examples
Set Limit on a Virtual Resource XML and JSON Examples
Set Limit on a Virtual Resource: XML and JSON Examples