The table below shows the GET configuration for viewing details of the available REST API catalogs.

A sample of the response received is shown below.

{
"items": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/cfw/API/v1",
"description": "API Summary for version V1"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/cfw/API/v2",
"description": "API Summary for version V2"
}
],
"totalResults": 2
}

The table below shows the GET configuration for viewing details of the REST API catalog by user type.

A sample of the response received is shown below.

{
"items": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/API",
"description": "APIs for Self Service Application for version V2",
"type": "SSA"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/API",
"description": "APIs for administrative functions for version V2",
"type": "Admin"
}
],
"goBack":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/cfw/API",
"totalResults": 2
}

The table below shows the GET configuration for viewing details of the user API catalog.

A sample of the response received is shown below.

{
"items": [
{
"totalResults": 5,
"resource": "services",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services",
"method": "GET",
"description": "Get all the service offerings"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services",
"method": "POST",
"description": "Create a service"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{
id}",
"method": "GET",
"templated": true,
"description": "Get details of a service"
},
{
"href":
"https://bxx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{
id}/metadata",
"method": "GET",
"templated": true,
"description": "Get the metadata for a service"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/{
id}/metrics",
"method": "PUT",
"templated": true,
"description": "Get the metrics for a service"
}
]
},
{
"totalResults": 11,
"resource": "userpreferences",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences",
"method": "GET"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/general",
"method": "GET",
"description": "Get the general user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/general/metadata",
"method": "GET",
"description": "Get the metadata for general user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services",
"method": "GET",
"description": "Get the service user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}",
"method": "GET",
"templated": true,
"description": "Get the user preferences for a service family"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/metadata",
"method": "GET",
"templated": true,
"description": "Get the metadata for user preference at family level"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/{service-type}",
"method": "GET",
"templated": true,
"description": "Get the user preferences for a service type"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/{service-type}/metadata",
"method": "GET",
"templated": true,
"description": "Get the metadata for user preference at service type level"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/general",
"method": "PUT",
"description": "Update general user preference"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}",
"method": "PUT",
"templated": true,
"description": "Update family level user preferences"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userprefer
ences/services/{service-family}/{service-type}",
"method": "PUT",
"templated": true,
"description": "Update service type level user preferences"
}
]
},
{
"totalResults": 4,
"resource": "servicerequests",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests",
"method": "GET",
"description": "Get service requests"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests/{id}",
"method": "PUT",
"templated": true,
"description": "Reschedule the request"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests/{id}",
"method": "GET",
"templated": true,
"description": "Get the details of request"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicereq
uests/{id}",
"method": "DELETE",
"templated": true,
"description": "Delete the request"
}
]
},
{
"totalResults": 5,
"resource": "serviceinstances",
"APIs": [
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances",
"method": "GET",
"description": "Get the service instances"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}",
"method": "GET",
"templated": true,
"description": "Get details of a service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}/actions",
"method": "GET",
"templated": true,
"description": "Get actions for a service instance"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}/actions/{action-id}",
"method": "GET",
"templated": true,
"description": "Get metadata details of action"
},
{
"href":
"https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceins
tances/{id}/actions/{action-id}",
"method": "PUT",
"templated": true,
"description": "Perform the action on the service instance"
}
]
}
],
"goBack": "https://xx.idc.example.com:4473/em/websvcs/restful/extws/cloudservices/API",
"totalResults": 4
}

The table below shows the GET configuration for viewing details of Service types.

A sample of the response received is shown below.

{
"name": "Service Types",
"type": "Service Types Collection",
"totalResults": 3,
"cfwItems": [
{
"name": "CFW_SAMPLEXAAS_REMOTESERVER_SERVICE",
"displayName": "Cfw Sample RemoteServer XaaS",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"targetTypes": [
"Cfw_Xaas_DB_Service"
]
},
{
"name": "CFW_SAMPLEXAAS_SERVICE",
"displayName": "Cfw Sample XaaS",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"targetTypes": [
"Cfw_Xaas_DB_Service",
"cfw_xaas_storage_service"
]
},
{
"name": "CFW_SAMPLEXAAS_SERVICE_FOR_NOMEM",
"displayName": "Cfw Sample XaaS - Other Service",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"targetTypes": [
"Cfw_Xaas_DB_Service_for_nomem"
]
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicetypes"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicetypes"
}
}

The table below shows the GET configuration for viewing details of the Services resource.

A sample of the response received is shown below.

{
"name": "Services",
"type": "Service",
"totalResults": 4,
"cfwItems": [
{
"id": "1",
"name": "ORACLE_NIMBULA_ORCHESTRATION_TEMPLATE",
"displayName": "Orchestration",
"guid": "04FA3C08D3F3398AE053CE74B10A52F3",
"serviceType": "ORACLE_NIMBULA_ORCHESTRATION_SERVICE",
"serviceFamily": "NIMBULA_INFRASTRUCTURE",
"description": "Create a set of Oracle VM instances with customized configuration for
multi-tier applications",
"meta":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servies/04FA3C08D3F3398AE053CE74B10A52F3/metadata",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FA3C08D3F3398AE053CE74B10A52F3"
}
},
{
"id": "2",
"name": "ORACLE_NIMBULA_SIMPLE_ORCHESTRATION_TEMPLATE",
"displayName": "Simple Orchestration",
"guid": "04FA3C08D3F6398AE053CE74B10A52F3",
"serviceType": "ORACLE_NIMBULA_ORCHESTRATION_SERVICE",
"serviceFamily": "NIMBULA_INFRASTRUCTURE",
"description": "Create one or more Oracle VM instances with default configuration and minimum inputs",
"meta":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FA3C08D3F6398AE053CE74B10A52F3/metadata",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FA3C08D3F6398AE053CE74B10A52F3"
}
},
{
"id": "44",
"name": "MY DB Schema",
"displayName": "MY DB Schema",
"guid": "04FBAB67376E77D1E053CE74B10A9AA8",
"serviceType": "SCHEMA",
"serviceFamily": "DBAAS",
"description": "My DB Schema",
"meta":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376E77D1E053CE74B10A9AA8/metadata",
"canonicalLink": {
2.3 9
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376E77D1E053CE74B10A9AA8"
}
},
{
"id": "41",
"name": "My WebLogic Template",
"displayName": "My WebLogic Template",
"guid": "04FB7EEED9A03798E053CE74B10A753D",
"serviceType": "WLAAS",
"serviceFamily": "MIDDLEWARE_CFW",
"description": "My Web Logic Template",
"meta":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FB7EEED9A03798E053CE74B10A753D/metadata",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FB7EEED9A03798E053CE74B10A753D"
}
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/"
}
}

The table below shows the GET configuration for viewing details of the Service offering resource.

A sample of the response received is shown below.

{
"id": "42",
"name": "My Xaas Remote Server",
"displayName": "My Xaas Remote Server",
"guid": "04FBAB67376677D1E053CE74B10A9AA8",
"serviceType": "CFW_SAMPLEXAAS_REMOTESERVER_SERVICE",
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"description": "My Xaas Remote Server",
"createdOn": "2014-10-09T10:13:34Z",
"modifiedOn": "2014-10-09T10:13:34Z",
"lastModified": "2014-10-09T10:13:34Z",
"meta":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376677D
1E053CE74B10A9AA8/metadata",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376677D
1E053CE74B10A9AA8"
}
}

The table below shows the GET configuration for viewing details of the Request metadata.

A sample of the response received is shown below.

{
"characteristics": [
{
"displayName": "Self Service Zone",
"name": "ORACLE.SYSMAN.SXAAS.CFW_SAMPLEXAAS_RSRC_POOL",
"possibleValues": [
{
"name": "my_paaszone",
"value": "1C3A932A9089BBEC27A63EF389C7DF24"
}
]
}
],
"configurations": [
{
"name": "temp_param2",
"type": "STRING",
"value": "",
"required": false,
"secret": false
},
{
"name": "USER_NAME",
"type": "STRING",
"description": "User Name (cannot be any of Oracle default accounts) used to login to the requested database",
"value": "",
"required": false,
"secret": false
},
{
"name": "temp_param1",
"type": "STRING",
"value": "",
"required": false,
"secret": false
},
{
"name": "USER_PASSWORD",
"type": "STRING",
"description": "User Password to login to the given User Name database account",
"required": false,
"secret": true
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376677D1E053CE74B10A9AA8/metadata"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/services/04FBAB67376677D1E053CE74B10A9AA8/metadata"
},
"instanceName": "<user-input>"
}

The table below shows the POST configuration for creating a Service instance.

{
"name":"Xaas RemoteServer Request",
"offeringId":"04FBAB67376677D1E053CE74B10A9AA8",
"instanceName":"Xaas RemoteServer",
"schedule": {
"scheduleStartTime":"2015-01-12T16:48:10ZAmerica/Los_Angeles",
"scheduleEndTime":"2015-31-12T16:48:10ZAmerica/Los_Angeles"
},
"characteristics": [
{
"name":"ORACLE.SYSMAN.SXAAS.CFW_SAMPLEXAAS_RSRC_POOL",
"value":"1C3A932A9089BBEC27A63EF389C7DF24"
}
],
"configurations": [
{
"name":"temp_param2",
"value":"val2"
},
{
"name":"USER_NAME",
"value":"user"
},
{
"name": "temp_param1",
"value":"val1"
},
{
"name": "USER_PASSWORD",
"value":"passwords"
}
]
}

A sample of the response received is shown below.

{
"requests":[
{
"id":"16",
"actionName":"CREATE",
"canonicalLink":{
"href":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/1
6"
}
},
{
"id":"17",
"actionName":"DELETE",
"canonicalLink":{
"href":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/1
7"
}
}
]
}

A sample of the response received for v2 is shown below.

{
"name": "Request summary grouped by status",
"totalResults": 17,
"requestSummary": [
{
"status": "NO_QUOTA_ERROR",
"count": 1,
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=NO_QUOTA_ERROR&expanded=true"
},
{
"status": "EXECUTION_ERROR",
"count": 1,
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=EXECUTION_ERROR&expanded=true"
},
{
"status": "SUCCESS",
"count": 5,
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=SUCCESS&expanded=true"
},
{
"status": "CLEANUP_FAILED",
"count": 1,
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=CLEANUP_FAILED&expanded=true"
},
{
"status": "SCHEDULED",
"count": 9,
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=SCHEDULED&expanded=true"
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests"
}
}

A sample of the response received for v1 is shown below.

{           
"name": "Service Requests",
"type": "Service Request","count": 2,
"items": [
   {
    "id": "2",
    "name": "future_Create Sample XaaS Service#2",
    "beginDate": "2015-02-14T08:37:18Z India Standard Time",
    "status": "SCHEDULED",
    "selfLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2",
"canonicalLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2",
     "serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY"
                },
                {
     "id": "1",
     "name": "eadeweqqw_Create Sample XaaS Service#1",
     "beginDate": "2015-02-10T07:49:24Z India Standard Time",
     "status": "EXECUTION_ERROR",
     "selfLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/1",
     "canonicalLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/1",
    "serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY"
                }
            ],
     "selfLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequest?status=ALL",
     "canonicalLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/"
        }

The table below shows the GET configuration for querying the Service requests resource.

A sample of the response received is shown below.

{
"name" : "Request summary grouped by status",
"totalResults" : 5,
"requestSummary" : [ {
"status" : "SUCCESS",
"count" : 3,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS&expanded=true"
}, {
"status" : "SCHEDULED",
"count" : 2,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SCHEDULED&expanded=true"
} ],
"canonicalLink" : {
"href" :
3.4 22
-
-
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS"
}
}

The table below shows the GET configuration for querying the Service requests resource for expanded=true. A similar approach is followed for expanded=false, where the query change is made in the URI.

A sample of the response received for expanded=true is shown below.

{
"name" : "Service Requests",
"type" : "Service Request",
"totalResults" : 5,
"cfwItems" : [ {
"id" : "5",
"name" : "Rst_rpc_14-09-11 09.52.58_11-Sep-14 21:53:06.663",
"startDate" : "2014-09-11T16:23:06Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/5"
},
"displayName" : "Rst_rpc_14-09-11 09.52.58_11-Sep-14 21:53:06.663"
}, {
"id" : "4",
"name" : "Remove Sample XaaS Service_Xaas_Storage__11-Sep-14 21:52:58.553",
"startDate" : "2017-07-12T23:48:10Z",
"status" : "SCHEDULED",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/4"
},
"displayName" : "Remove Sample XaaS Service_Xaas_Storage__11-Sep-14 21:52:58.553"
}, {
"id" : "3",
"name" : "Rst_en_14-09-11 09.52.58_11-Sep-14 21:52:58.363",
"startDate" : "2014-09-11T16:22:58Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/3"
},
"displayName" : "Rst_en_14-09-11 09.52.58_11-Sep-14 21:52:58.363"
}, {
"id" : "2",
"name" : "Rst_st_en_14-09-11 09.52.58_11-Sep-14 21:52:54.187",
"startDate" : "2015-01-13T00:48:10Z",
"status" : "SCHEDULED",
"canonicalLink" : {
"href" :
3.5 23
-
-
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/2"
},
"displayName" : "Rst_st_en_14-09-11 09.52.58_11-Sep-14 21:52:54.187"
}, {
"id" : "1",
"name" : "Rst_14-09-11 09.52.58_11-Sep-14 21:52:49.360",
"startDate" : "2014-09-11T16:22:49Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/1"
},
"displayName" : "Rst_14-09-11 09.52.58_11-Sep-14 21:52:49.360"
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?expanded=true"
}
}

A sample of the response received for expanded=false is shown below.

{
"name" : "Request summary grouped by status",
"totalResults" : 5,
"requestSummary" : [ {
"status" : "SUCCESS",
"count" : 3,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS&expanded=true"
}, {
"status" : "SCHEDULED",
"count" : 2,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests?status=SCHEDULED&expanded=true"
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?expanded=false"

The table below shows the GET configuration for querying the Service requests resource for status=SUCCESS&expanded=false. A similar approach is followed for status=SUCCESS&expanded=true, where the query change is made in the URI.

A sample of the response received for status=SUCCESS&expanded=false is shown below.

{
"name" : "Request summary grouped by status",
"totalResults" : 5,
"requestSummary" : [ {
"status" : "SUCCESS",
"count" : 3,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS&expanded=true"
}, {
"status" : "SCHEDULED",
"count" : 2,
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SCHEDULED&expanded=true"
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS&expanded=false"
}
}

A sample of the response received for status=SUCCESS&expanded=true is shown below.

{
"name" : "Service Requests",
"type" : "Service Request",
"totalResults" : 3,
"cfwItems" : [ {
"id" : "5",
"name" : "Rst_rpc_14-09-11 09.52.58_11-Sep-14 21:53:06.663",
"startDate" : "2014-09-11T16:23:06Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
3.7 "https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere 25
quests/5"
},
"displayName" : "Rst_rpc_14-09-11 09.52.58_11-Sep-14 21:53:06.663"
}, {
"id" : "3",
"name" : "Rst_en_14-09-11 09.52.58_11-Sep-14 21:52:58.363",
"startDate" : "2014-09-11T16:22:58Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/3"
},
"displayName" : "Rst_en_14-09-11 09.52.58_11-Sep-14 21:52:58.363"
}, {
"id" : "1",
"name" : "Rst_14-09-11 09.52.58_11-Sep-14 21:52:49.360",
"startDate" : "2014-09-11T16:22:49Z",
"status" : "SUCCESS",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/1"
},
"displayName" : "Rst_14-09-11 09.52.58_11-Sep-14 21:52:49.360"
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests?status=SUCCESS&expanded=true"
}
}

The GET request configuration for viewing details of a Service request is shown below.

A sample of the response received is shown below.

{
"id": "44",
"name": "dp_2b022961-c#44",
"status": "SUCCESS",
"serviceType": "CFW_SAMPLEXAAS_SERVICE",
"serviceFamily": "Sample Services",
"actionName": "Create Sample XaaS Service",
"startDate": "2014-10-15T09:29:23Z",
"createdOn": "2014-10-15T09:29:23Z",
"createdBy": "SYSMAN",
"owner": "SYSMAN",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/44"
},
"executionLogs":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/44/logs"
}

The DELETE request configuration for deleting a Service request is shown below.

A sample of the response received is shown below.

{
"message" : "[\"Request 31 deleted successfully\"]"
}

The table below shows the PUT request configuration.

{
"beginDate": "2013-10-02T16:14:41ZPST"
}

{"startDate":"2015-08-12T16:48:10ZAmerica/Los_Angeles"}

A sample of the response received for v2 is shown below.

{
"message" : "Request 2 rescheduled successfully."
}

A sample of the response received for v1 is shown below.

Status 200 OK
{
message: "Service request 2 rescheduled successfully."
}

The table below shows the GET request configuration for viewing the Service request logs.

A sample of the response received is shown below.

{
"submittedOn" : "2014-09-12T07:20:38Z",
"steps" : [ {
"stepName" : "CfwRequestInitCommand",
"stepId" : "CfwRequestInitCommand",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid=CfwRequestInitCommand"
}, {
"stepName" : "CfwRequestPreProcessCommand",
"stepId" : "CfwRequestPreProcessCommand",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid=CfwRequestPreProcessCommand"
}, {
"stepName" : "CfwRequestJobInvokerCommand",
"stepId" : "CfwRequestJobInvokerCommand",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid=CfwRequestJobInvokerCommand"
}, {
"stepId" : "",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid="
}, {
"stepName" : "CfwRequestPostProcessCommand",
"stepId" : "CfwRequestPostProcessCommand",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid=CfwRequestPostProcessCommand"
} ],
"id" : "21"
}

The table below shows the GET request configuration for querying the Service request logs.

A sample of the response received is shown below.

{
"id" : "21",
"stepName" : "CfwRequestPreProcessCommand",
"stepId" : "CfwRequestPreProcessCommand",
"data" : "INFO:Request Pre-processing in progress.\nINFO:Preparing the inputs for Request Action:
Create Sample XaaS Service\nINFO:Performing placment checks to identify the appropriate Service-
Provider.\nINFO:Placement checks executed successfully.\nINFO:Request pre-processing successfully
executed.",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicere
quests/21/logs?stepid=CfwRequestPreProcessCommand"
}
}

The table below shows the GET request configuration.

A sample of the response received is shown below.

Status 200 OK
{
name: "Service Requests"
type: "Service Request"
count: 2
items: [2] 
	0:  
	{
id: "2"
name: "request2_14153ee61c5_Create_20130925_123353"
beginDate: "2013-09-25T12:48:50ZAsia/Calcutta"
status: "Scheduled"
lifeCycle: "Create Service Instance"
selfLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2"
canonicalLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2"
serviceFamily: "MWAAS"
	}
 
1:  
	{
id: "1"
name: "request1_14153ea0bb6_Create_20130925_122909"
beginDate: "2013-09-25T12:44:03ZAsia/Calcutta"
status: "Cancelled"
lifeCycle: "Create Service Instance"
selfLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/1"
canonicalLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/1"
serviceFamily: "MWAAS"
	}
 
selfLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests?status=ALL"
canonicalLink: "https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests"
}

The table below shows the GET request configuration.

A sample of the response received is shown below.

{
 "name": "Service Requests",
 "type": "Service Request",
 "count": 1,
 "items": [
 {
  "id": "2",
  "name": "future_Create Sample XaaS Service#2",
  "beginDate": "2015-02-14T08:37:18Z India Standard Time",
  "status": "SCHEDULED",
  "selfLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2",
  "canonicalLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/2",
  "serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY"
   }
  ],
 "selfLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequest?status=SCHEDULED",
 "canonicalLink": "https://cloudcompnay.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/"
}

The table below shows the PUT request configuration.

{
"beginDate": "2013-10-02T16:14:41ZPST"
}

A sample of the response received is shown below.

Status : 400 Bad request {errorMessages: "Error occured while rescheduling. Verify that schedule is not in past and status is scheduled."}

The table below shows the DELETE request configuration.

A sample of the response received is shown below.

Status 200 OK
 {
message: "Service request 1 cancelled successfully."
}

The table below shows the DELETE request configuration.

A sample of the response received is shown below.

Status : 400 Bad request{errorMessages: "Error occured while cancelling. Only request with status SCHEDULED is cancellable."}

The table below shows the GET request configuration.

A sample of the response received is shown below.

{
"name" : "Service Instances Summary",
"totalResults" : 7,
"serviceInstanceSummary" : [ {
"status" : "STATUS_UP",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances?status=STATUS_UP&expanded=true",
"count" : 3
}, {
"status" : "PENDING_CREATION",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances?status=PENDING_CREATION&expanded=true",
"count" : 4
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances"
}
}

The table below shows the GET request configuration for querying the Service instance resource based on the following parameters:

• expanded=true

• expanded=false

• status=STATUS_UP

• servicetype=CFW_SAMPLEXAAS_SERVICE

• expanded=true,status=STATUS_UP

• expanded=false,status=STATUS_UP,servicetype=CFW_SAMPLEXAAS_SERVICE

A sample of the response received for expanded=false is shown below.

{
"name" : "Service Instances Summary",
"totalResults" : 7,
"serviceInstanceSummary" : [ {
"status" : "STATUS_UP",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances?status=STATUS_UP&expanded=true",
"count" : 3
}, {
"status" : "PENDING_CREATION",
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances?status=PENDING_CREATION&expanded=true",
"count" : 4
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances?expanded=false"
}
}

The table below shows the GET request configuration.

A sample of the response received is shown below.

{
"name" : "test",
"targetName" : "test",
"guid" : "CCA88E9507D4A9E2214935F956D83150",
"serviceType" : "CFW_SAMPLEXAAS_SERVICE",
"serviceFamily" : "CFW_SAMPLEXAAS_SERVICEFAMILY",
"status" : "STATUS_UP",
"targetType" : "Cfw_Xaas_DB_Service",
"createdOn" : "2014-11-15T00:00:00ZAsia/Calcutta",
"createdBy" : "SYSMAN",
"owner" : "SYSMAN",
"attributes" : {
"href" :
"https://xx.idc.example.com:14488/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances/CCA88E9507D4A9E2214935F956D83150/attributes"
},
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:14488/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances/CCA88E9507D4A9E2214935F956D83150"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:14488/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicein
stances/CCA88E9507D4A9E2214935F956D83150"
}
}

The table below shows the GET request configuration.

A sample of the response received is shown below.

{
"serviceInstanceGuid" : "CCA88E9507D4A9E2214935F956D83150",
"attributes" : [ {
"name" : "xaasServiceName",
"type" : "STRING",
"value" : "test"
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:14488/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/CCA88E9507D4A9E2214935F956D83150/attributes"
},
"selfLink" : {
"href" :
"https://xx.idc.example.com:14488/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/CCA88E9507D4A9E2214935F956D83150/attributes"
}
}

The table below shows the GET request configuration.

A sample of the response received is shown below.

{
"totalResults" : 6,
"selfLink" : {
"href" :
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/2A2BD0D7C40F7C2814FA6788704E313
A/actions"
},
"cfwItems" : [ {
"name" : "DELETE",
"id" : "82",
"displayName" : "Remove Sample XaaS Service",
"description" : "Removing my Sample XaaS service"
}, {
"name" : "START",
"id" : "84",
"displayName" : "Start Service",
"description" : "Starts this service"
}, {
"name" : "STOP",
"id" : "85",
"displayName" : "Stop Service",
"description" : "Stops this service"
}, {
"name" : "CLEANUP",
"id" : "86",
"displayName" : "Cleanup Sample XaaS Failed Request",
"description" : "Cleanup Sample Xaas Failed Request"
}, {
"name" : "SYNCSTARTSERVICE",
"id" : "87",
"displayName" : "Sync Start Service",
"description" : "Synchronous Action to Start Sample Service"
}, {
"name" : "SYNCSTOPSERVICE",
"id" : "88",
"displayName" : "Sync Stop Service",
"description" : "Synchronous Action to Stop Sample Service"
} ],
"name" : "Actions",
"type" : "Action",
"canonicalLink" : {
"href" :
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/serviceinstances/2A2BD0D7C40F7C2814FA6788704E313
A/actions"
}
}

The table below shows the GET request configuration.

A sample of the response received is shown below.

{
"name" : "START",
"id" : "94",
"displayName" : "START",
"actionInputs" : [ {
"name" : "WorkLoads",
"type" : "VECTOR",
"description" : "WorkLoad Values",
"required" : false,
"secret" : false,
"subvalues" : [ {
"name" : "Small",
"type" : "VECTOR",
"description" : "Configuration Values for Small WorkLoad",
"required" : false,
"secret" : false,
"subvalues" : [ {
"name" : "DEPL_SIZE_IS_DEFAULT_KEY",
"value" : "Y",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "CPU",
"value" : "60",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "MEMORY",
"value" : "4048",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "STORAGE",
"value" : "500",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "XAAS_TEST",
"value" : "NONE",
"type" : "STRING",
"required" : false,
"secret" : false
} ]
}, {
"name" : "Medium",
"type" : "VECTOR",
"description" : "Configuration Values for Medium WorkLoad",
"required" : false,
"secret" : false,
"subvalues" : [ {
"name" : "DEPL_SIZE_IS_DEFAULT_KEY",
"value" : "N",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "CPU",
"value" : "80",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "MEMORY",
"value" : "8088",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "STORAGE",
"value" : "750",
"type" : "STRING",
"required" : false,
"secret" : false
} ]
}, {
"name" : "Large",
"type" : "VECTOR",
"description" : "Configuration Values for Large WorkLoad",
"required" : false,
"secret" : false,
"subvalues" : [ {
"name" : "DEPL_SIZE_IS_DEFAULT_KEY",
"value" : "Y",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "CPU",
"value" : "60",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "MEMORY",
"value" : "40448",
"type" : "STRING",
"required" : false,
"secret" : false
}, {
"name" : "STORAGE",
"value" : "500",
"type" : "STRING",
"required" : false,
"secret" : false
} ]
} ]
} ],
"description" : "Starts this service"
}

The table below shows the PUT request configuration.

{
"actionId":94,
"configurations":[
{
"name":"domainName",
"type":"STRING",
"description":"Domain Name",
"required":true,
"value":"/mwaas_rest_9_SSA_USER1/rest_9_SSA_USER1"
},
{
"name":"applicationName",
"type":"STRING",
"description":"Application Name",
"required":true,
"value":"test1"
}
]
}

A sample of the response received is shown below.

{
"requests": [
{
"id": "4",
"actionName": "STOP",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/servicerequests/4"
}
}
]
}

The table below shows the GET request configuration.

A sample of the response received is shown below.

{
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/"
},
"usages": [
{
"serviceFamily": "CFW_SAMPLEXAAS_SERVICEFAMILY",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/CFW_SAMPLEXAAS_SERVICEFAMILY"
}
},
{
"serviceFamily": "NIMBULA_INFRASTRUCTURE",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/NIMBULA_INFRASTRUCTURE"
}
},
{
"serviceFamily": "DBAAS",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/DBAAS"
}
},
{
"serviceFamily": "MIDDLEWARE_CFW",
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/MIDDLEWARE_CFW"
}
}
],
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/"
}
}

The table below shows the GET request configuration.

A sample of the response received is shown below.

{
"name": "Usages",
"type": "Usages Collection",
"totalResults": 4,
"cfwItems": [
{
"id": "sampleActionOpen",
"name": "Storage",
"type": "Others",
"allowed": "10.0",
"used": "3.0",
"unit": "GB"
},
{
"name": "Cfw Sample XaaS - Other Service",
"type": "Service Instances",
"serviceType": "CFW_SAMPLEXAAS_SERVICE_FOR_NOMEM",
"used": "0"
},
{
"name": "Cfw Sample XaaS",
"type": "Service Instances",
"serviceType": "CFW_SAMPLEXAAS_SERVICE",
"used": "0"
},
{
"name": "Cfw Sample RemoteServer XaaS",
"type": "Service Instances",
"serviceType": "CFW_SAMPLEXAAS_REMOTESERVER_SERVICE",
"used": "0"
}
],
"canonicalLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/CFW_SAMPLEXAAS_SERVICEFAMILY"
},
"selfLink": {
"href":
"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/quotausage/CFW_SAMPLEXAAS_SERVICEFAMILY"
}
}

The table below shows the configuration for the GET request.

A sample of the response received is shown below.

{
"generalPreferences" :
"https://blr2223141.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general",
"servicePreferences" :
"https://blr2223141.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services",
"canonicalLink" : {
"href" :
"https://blr2223141.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences"
}
}

The table below shows the configuration for the GET request.

A sample of the response received is shown below.

{
"name" : "General Preference",
"type" : "General User Preferences",
"preferences" : [ {
"name" : "USER_LOCALE",
"value" : "en",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "English",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"type" : "VECTOR",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "This allows the user to receive notifications for different statuses of the request.",
"required" : false,
"secret" : false
}, {
"name" : "NOTIFICATION_DAYS_1",
"value" : "0",
"type" : "INTEGER",
"defaultValue" : "0",
"description" : "Number of days before the first notification is sent to the user before the expiry date of the service instance.",
"required" : false,
"secret" : false
}, {
"name" : "NOTIFICATION_DAYS_2",
"value" : "0",
"type" : "INTEGER",
"defaultValue" : "0",
"description" : "Number of days before the second notification is sent to the user before the expiry date of the service instance.",
"required" : false,
"secret" : false
}, {
"name" : "DEFAULT_SERVICE",
"value" : "MWAAS",
"type" : "STRING",
"defaultValue" : "DBAAS",
"description" : "This will be used as your default service after successful login to Self Service Portal.",
"required" : false,
"secret" : false
}, {
"name" : "EMAIL",
"type" : "VECTOR",
"description" : "This is the default Email address for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "QUOTA_THRESHOLD",
"value" : "0.0",
"type" : "FLOAT",
"defaultValue" : "0.0",
"description" : "Notifications will be sent to users when resources exceed the defined quota percentage.",
"required" : false,
"secret" : false
}, {
"name" : "QUOTA_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "Receive quota related notification when the quota reaches the specified threshold.",
"required" : false,
"secret" : false
}, {
"name" : "INSTANCE_EXPIRY_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "Enables user to receive notifications for Service Instances that are due to expire based on the notification period.",
"required" : false,
"secret" : false
} ],
"meta" :
"https://blr2223141.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general/metadata",
"canonicalLink" : {
"href" :
"https://blr2223141.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general"
}
}

The table below shows the configuration for the GET request.

A sample of the response received is shown below.

{
"name" : "General Preference",
"type" : "General User Preferences",
"preferences" : [ {
"name" : "USER_LOCALE",
"value" : "en",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "English",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false,
"possibleValues" : [ {
"name" : "USER_LOCALE",
"value" : "es_ES",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Spanish",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "ja",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Japanese",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "fr",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "French",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "ko",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Korean",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "de",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "German",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "zh_TW",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Traditional Chinese",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "zh_CN",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Simplified Chinese",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "en",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "English",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "USER_LOCALE",
"value" : "pt_BR",
"type" : "STRING",
"defaultValue" : "en",
"displayName" : "Brazilian Portuguese",
"description" : "This is the default Locale for receiving cloud notifications.",
"required" : false,
"secret" : false
} ]
}, {
"name" : "REQUEST_STATUS",
"type" : "VECTOR",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false,
"possibleValues" : [ {
"name" : "REQUEST_STATUS",
"value" : "PARTIAL_SUCCEEDED",
"type" : "VECTOR",
"displayName" : "Partially Succeeded",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"value" : "ERROR",
"type" : "VECTOR",
"displayName" : "Error",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"value" : "CANCELLED",
"type" : "VECTOR",
"displayName" : "Cancelled",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"value" : "EXECUTING",
"type" : "VECTOR",
"displayName" : "Running",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"value" : "SUCCESS",
"type" : "VECTOR",
"displayName" : "Success",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
}, {
"name" : "REQUEST_STATUS",
"value" : "SCHEDULED",
"type" : "VECTOR",
"displayName" : "Scheduled",
"description" : "Request Status For Which Notifications Are Enabled",
"required" : false,
"secret" : false
} ]
}, {
"name" : "REQUEST_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "This allows the user to receive notifications for different statuses of the request.",
"required" : false,
"secret" : false
}, {
"name" : "NOTIFICATION_DAYS_1",
"value" : "0",
"type" : "INTEGER",
"defaultValue" : "0",
"description" : "Number of days before the first notification is sent to the user before the expiry date of the service instance.",
"required" : false,
"secret" : false
}, {
"name" : "NOTIFICATION_DAYS_2",
"value" : "0",
"type" : "INTEGER",
"defaultValue" : "0",
"description" : "Number of days before the second notification is sent to the user before the expiry date of the service instance.",
"required" : false,
"secret" : false
}, {
"name" : "DEFAULT_SERVICE",
"value" : "MWAAS",
"type" : "STRING",
"defaultValue" : "DBAAS",
"description" : "This will be used as your default service after successful login to Self Service Portal.",
"required" : false,
"secret" : false
}, {
"name" : "EMAIL",
"type" : "VECTOR",
"description" : "This is the default Email address for receiving cloud notifications.",
"required" : false,
"secret" : false
}, {
"name" : "QUOTA_THRESHOLD",
"value" : "0.0",
"type" : "FLOAT",
"defaultValue" : "0.0",
"description" : "Notifications will be sent to users when resources exceed the defined quota percentage.",
"required" : false,
"secret" : false
}, {
"name" : "QUOTA_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "Receive quota related notification when the quota reaches the specified threshold.",
"required" : false,
"secret" : false
}, {
"name" : "INSTANCE_EXPIRY_NOTIFICATION",
"value" : "false",
"type" : "BOOLEAN",
"defaultValue" : "false",
"description" : "Enables user to receive notifications for Service Instances that are due to expire based on the notification period.",
"required" : false,
"secret" : false
} ],
"canonicalLink" : {
"href" :
"https://xxx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/general/metadata"
}
}

The table below shows the configuration for the PUT request.

{
"preferences":[
{
"value":"MWAAS",
"name":"DEFAULT_SERVICE"
},
{
"value":"false",
"name":"REQUEST_NOTIFICATION"
}
]
}

A sample of the response received is shown below.

{
"message" : "General preferences updated successfully."
}

The table below shows the configuration for the GET request.

A sample of the response received is shown below.

{
"preferences" : [ {
"name" : "MIDDLEWARE_CFW",
"type" : "Service Family User Preferences",
"required" : false,
"secret" : false,
"meta" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/MIDDLEWARE_CFW/metadata",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/MIDDLEWARE_CFW"
}
}, {
"name" : "NIMBULA_INFRASTRUCTURE",
"type" : "Service Family User Preferences",
"required" : false,
"secret" : false,
"meta" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/NIMBULA_INFRASTRUCTURE/metadata",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/NIMBULA_INFRASTRUCTURE"
}
}, {
"name" : "DBAAS",
"type" : "Service Family User Preferences",
"required" : false,
"secret" : false,
"meta" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/DBAAS/metadata",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/DBAAS"
}
}, {
"name" : "CFW_SAMPLEXAAS_SERVICEFAMILY",
"type" : "Service Family User Preferences",
"required" : false,
"secret" : false,
"meta" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/metadata",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY"
}
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services"
}
}

The table below shows the configuration for the GET request.

The table below shows the configuration for the GET request.

A sample of the response received is shown below.

{
"name" : "CFW_SAMPLEXAAS_SERVICEFAMILY",
"type" : "Service Type User Preferences",
"preferences" : [ {
"name" : "SAMPLE_PREFERENCE_1",
"value" : "test",
"type" : "STRING",
"defaultValue" : "Sample Value 1",
"description" : "Type of the Supported Files",
"required" : false,
"secret" : false
} ],
"subPreferences" : [ {
"name" : "CFW_SAMPLEXAAS_SERVICE_FOR_NOMEM",
"type" : "Service Type User Preferences",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/metadata/CFW_SAMPLEXAAS_SERVICE_FOR_NOMEM"
}
}, {
"name" : "CFW_SAMPLEXAAS_SERVICE",
"type" : "Service Type User Preferences",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/metadata/CFW_SAMPLEXAAS_SERVICE"
}
}, {
"name" : "CFW_SAMPLEXAAS_REMOTESERVER_SERVICE",
"type" : "Service Type User Preferences",
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/metadata/CFW_SAMPLEXAAS_REMOTESERVER_SERVICE"
}
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/metadata"
}
}

The table below shows the configuration for the PUT request.

{
"preferences":[
{
"value":"test",
"name":"SAMPLE_PREFERENCE_1"
}
]
}

A sample of the response received is shown below.

{
"message" : "User service preferences updated successfully."
}

The table below shows the configuration for the GET request.

A sample of the response received is shown below.

{
"name" : "CFW_SAMPLEXAAS_SERVICE",
"type" : "Service Type User Preferences",
"preferences" : [ {
"name" : "SAMPLE_PREFERENCE_1",
"value" : "UPD_ST_Rest_14-09-06 11.59.34",
"type" : "STRING",
"defaultValue" : "Sample Value 1",
"description" : "Type of the Supported Files",
"required" : false,
"secret" : false
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/CFW_SAMPLEXAAS_SERVICE"
}
}

The table below shows the configuration for the GET request.

A sample of the response received is shown below.

{
"name" : "CFW_SAMPLEXAAS_SERVICE",
"type" : "Service Type User Preferences",
"preferences" : [ {
"name" : "SAMPLE_PREFERENCE_1",
"value" : "test",
"type" : "STRING",
"defaultValue" : "Sample Value 1",
"description" : "Type of the Supported Files",
"required" : false,
"secret" : false
} ],
"canonicalLink" : {
"href" :
"https://xx.idc.example.com:24503/em/websvcs/restful/extws/cloudservices/ssa/cfw/v2/userpreferences/services/CFW_SAMPLEXAAS_SERVICEFAMILY/CFW_SAMPLEXAAS_SERVICE/metadata"
}
}

The table below shows the configuration for the PUT request.

{
"preferences":[
{
"value":"UPD_ST_Rest_14-09-07 12.03.39",
"name":"SAMPLE_PREFERENCE_1"
}
]
}

A sample of the response received is shown below.

{
"message" : "User service preferences updated successfully."
}

The table below shows the GET request configuration for getting top level view of service preferences for all service families.

A sample of the response received is shown below.

Status 200 OK 

{
DBAAS: {
displayName: "My Database Preferences"
description: "User preferences for Database services"
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/dbaas"
}
MWAAS: {
displayName: "My Middleware Preferences"
description: "User preferences for Middleware services"
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/mwaas"
}
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services"
}

The table below shows the configuration for the GET request.

A sample of the response received is shown below.

Status 200 OK 

{
servicePreferencesMetadata: {
items: 
{
name: "defaultPaasZone"
displayName: "Default PaaS Infrastructure Zone"
description: "Default PaaS Infrastructure Zone"
currentValue: ""
isRequiredAttribute: false
possibleValues: 
{
value: "dbaas_west_coast_zone"
}
}
}
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/dbaas/
metadata"
}

The table below shows the PUT request configuration.

{
  "servicePreferences":
  {
    "items":[
       {
        "name": "defaultPaasZone",
        "value": "dbaas_west_coast_zone"
       }
     ]
  }
}

A sample of the response received is shown below.

Status 200 OK

{
      message: Service Preferences updated successfully."
}

The table below shows the PUT request configuration.

{
  "servicePreferences":
  {
    "items":[
       {
        "name": "defaultPaasZone",
        "value": ""
       }
     ]
  }
}

A sample of the response received is shown below.

Status 200 OK 

{
      message: Service Preferences updated successfully."
}

The table below shows the GET request configuration.

A sample of the response received is shown below.

Status 200 OK 

{
canonicalLink:
"/em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/mypreferences/services/dbaas"
servicePreferences: {
items: {
name: "defaultPaasZone"
value: "dbaas_west_coast_zone"
}
}
}\