Skip Headers
Oracle® Enterprise Manager Cloud Administration Guide
12c Release 3 (12.1.0.3)

E28814-10
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

29 Middleware as a Service APIs

This chapter describes the resource model for Java as a Service (JaaS) API and the REST request/response interactions. Application component filtering, which is supported for JaaS zones, templates, is also described.

This chapter contains the following topics:

29.1 Java as a Service Resource Data Models

The following sections describe the resource models that are supported by the Java as a Service family type and provide examples of supported operations. The following resource models are described:

The figure below shows the Java as a Service resource model.

Figure 29-1 JaaS Resource Model

java as a service

29.1.1 Cloud

The following table describes the Cloud [application/oracle.com.cloud.common.Cloud+json] data model.

Table 29-1 Cloud Data Model

Field Type Occurs Description

uri

URI

1

A GET against this URI refreshes the client representation of the resources accessible to this user.

name

String

1

A human readable name. It is a UNICODE string to support different languages.

description

String

0...1

A brief description. This is a UNICODE string to support different languages.

service_template

Collection<ServiceTemplates>

0..1

List of service templates that are accessible to the user.

zones

Collection <Zone>

0..1

List of zones that are supported by the cloud and accessible to the user.

service_family_type

Collection <ServiceFamilyType>

0..1

The list of service family types that are supported by the cloud.

resource_state

ResourceState

0..1

A cloud that is online and running has READY as its state. If this field is not returned, the client can assume the cloud is READY. If the state of the returned field is not READY, the client cannot assume the viability of subsequent interactions into the cloud.

media_type

String

1

The value of this media type with the payload format. For example, application/oracle.com.cloud.common.Cloud+json.

canonicalLink

String

1

GET against this normalized/canonical URI refreshes the client representation of the resources accessible to this user.


29.1.1.1 GET Operation on a Cloud URI to return its representation

The following shows an example of a GET operation on the Cloud URI to return its representation.

Example Request:

GET /em/cloud
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.common.Cloud+json

Example Response:

{
  "uri" : "/em/cloud" ,
  "name" : "Oracle Cloud by Enterprise Manager" ,
  "description" : "This represents the Cloud resource of the Oracle Enterprise Manager Cloud Management solution" ,
  "resource_state" :     {
      "state" : "READY"
    } ,
  "media_type" : "application/oracle.com.cloud.common.Cloud+json" ,
  "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0   
   /ssa/em/cloud" ,
  "zones" :     {
      "media_type" : "application/oracle.com.cloud.common.Zone+json" ,
      "total" : "3" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
            "name" : "Zone1" ,
            "media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
            "service_family_type" : "jaas"
            "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51"
          } ,
          {
            "uri" : "/em/cloud/dbaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
            "name" : "Zone1" ,
            "description" : "Zone for Physical Pool" ,
            "media_type" : "application/oracle.com.cloud.common.DbZone+json" ,
            "type" : "self_service_zone"
            "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51"
          } ,
          {
            "uri" : "/em/cloud/opc/opczone" ,
            "name" : "OPC Zone" ,
            "media_type" : "application/oracle.com.cloud.opc.OpcZone+json" ,
            "service_family_type" : "opc" ,
            "type" : "opc"
            "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/opc"
          }
      ]
    } ,
"service_templates" :     {
      "media_type" : "application/oracle.com.cloud.common.ServiceTemplate+json" ,
      "total" : "5" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
            "name" : "PS4_LowHeapTemplate" ,
            "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
            "service_family_type" : "jaas"
            "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/ D016AADD465462ACE040F20AD18167BA"
          } ,
          {
            "uri" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03030FAE80F6B58E040F20AD1812FE2%3A0.1" ,
            "name" : " rtriddappjul18_Deploy_20120718_051319824" ,
            "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
            "service_family_type" : "jaas"
            "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03030FAE80F6B58E040F20AD1812FE2%3A0.1"
          } ,
          {
            "uri" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03517A824EBFCF9E040F20AD1811CD9%3A0.1" ,
            "name" : "FileUploadFromCode" ,
            "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
            "service_family_type" : "jaas"
            "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03517A824EBFCF9E040F20AD1811CD9%3A0.1" 
          } ,
          {
            "uri" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03EFA365D58A674E040F20AD18134AE%3A0.1" ,
            "name" : "Test_1354864500315" ,
            "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
            "service_family_type" : "jaas"
             "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD03EFA365D58A674E040F20AD18134AE%3A0.1"
          } ,
          {
            "uri" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD1103FE5F6877372E040F20AD1814215%3A0.1" ,
            "name" : "RiddleApp" ,
            "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
            "service_family_type" : "jaas"
             "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD1103FE5F6877372E040F20AD1814215%3A0.1"
          }
      ]
    } ,
"service_family_types" :     {
      "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
      "total" : "4" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/service_family_type/jaas" ,
            "name" : "jaas" ,
            "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
            "type" : "jaas"
            "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas"
          } ,
          {
            "uri" : "/em/cloud/service_family_type/dbaas" ,
            "name" : "dbaas" ,
            "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
            "type" : "dbaas"
             "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/dbaas"
          } ,
          {
            "uri" : "/em/cloud/service_family_type/opc" ,
            "name" : "opc" ,
            "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
            "type" : "opc"
            canonicalLink: "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/opc"
          } ,
          {
            "uri" : "/em/cloud/service_family_type/iaas" ,
            "name" : "iaas" ,
            "media_type" : "application/oracle.com.cloud.iaas.IaasServiceFamilyType+json" ,
            "type" : "iaas"
            "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/iaas"
          }
      ]
    } ,
  "service_requests" :     {
      "media_type" : "application/oracle.com.cloud.common.Request+json" ,
      "total" : "0" ,
      "elements" : 
      [      ]
    }
}

29.1.2 JaaS Service Family Type

Jaas service family type is a category of services that are offered by Java as a Service (JaaS). The following table describes the Jaas ServiceFamilyType [application/oracle.com.cloud.common.ServiceFamilyType+json] data model:

Table 29-2 JaaS Service Family Type

Field Type Occurs Description

uri

URI

1

A GET against this URI refreshes the client representation of the Jaas ServiceFamilyType definition to this user.

name

String

1

Name of the Jaas ServiceFamilyType.

description

String

1

Human readable description of the Service Family Type. Shall be a UNICODE string to support different languages.

resource_state

ResourceState

0..1

The resource state of the resource.

media_type

String

1

The media type of the resource.

service_templates

Collection <ServiceTemplate>

0..1

The collection of service templates that are of this service family type.

zones

Collection <Zone>

0..1

The collection of zones that support service instances of this service family type.

instance_types

Collection <Instance Type>

0..1

The collection of instance types that are supported by this service family type.

canonicalLink

String

1

GET against this normalized/canonical URI refreshes the client representation of the resources accessible to this user.


29.1.2.1 GET on JaaS Service Family Type URI to Return its Representation

The following shows an example of a GET operation on the JaaS Service Family Type URI to return its representation.

Example Request:

GET /em/cloud/service_family_type/jaas
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.common.ServiceFamilyType+json

Example Response:

{
  "uri" : "/em/cloud/service_family_type/jaas" ,
  "name" : "jaas" ,
  "resource_state" :     {
      "state" : "READY"
    } ,
  "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" ,
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas" ,
  "type" : "jaas" ,
  "service_templates" :     {
      "media_type" : "application/oracle.com.cloud.common.ServiceTemplate+json" ,
      "total" : "1" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
            "name" : "PS4_LowHeapTemplate" ,
            "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
            "service_family_type" : "jaas" ,
            "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA"
          }
      ]
    } 
  "zones" :     {
      "media_type" : "application/oracle.com.cloud.common.Zone+json" ,
      "total" : "1" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
            "name" : "Zone1" ,
            "media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
            "service_family_type" : "jaas" ,
            "type" : "jaas" ,
            "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51"
          }
      ]
    } ,
  "instance_types" :     {
      "media_type" : "application/oracle.com.cloud.common.InstanceType+json" ,
      "total" : "0" ,
      "elements" : 
      [      ]
    } ,
  "service_requests" :     {
      "total" : "0" ,
      "elements" : 
      [      ]
    }
}

29.1.2.2 POST on the Jaas Service Family Type URI to Return ApplicationInstanceComponent

ApplicationInstanceComponent can be created using a post request on JaaS. Right now this is being done using a Java Program. The following shows a sample program:

Note:

<<>> : Provides a hint to an appropriate value.
import java.io.File;
import java.io.FileInputStream;
import java.io.PrintWriter;
import java.io.StringWriter;
 
import java.util.ArrayList;
import java.util.List;
import java.util.Properties;
 
import oracle.sysman.emInternalSDK.ssa.cloudapi.client.EMRestService;
 
public class FileUpload {
    static public void main(String[] args)
    throws Exception {
        String emUser = <<JAAS_USER_NAME>>;
        String emPassword = <<password>>";
        String emHost = <<host_machine_name/ip>>;
        String emPort = <<port>>;
        String emLocation = "https://"+emHost+":"+emPort;
        String applicationLocation = <<application_location>>;
        String deployPlanLocation = <<deploy_plan_location>>; 
        File f = new File(applicationLocation+"deploy_app.ear");          StringWriter sw = new StringWriter();
        PrintWriter pw =new PrintWriter(sw);
        pw.println("{");
        String fileName = "MyApplication"+emUser+"_"+System.currentTimeMillis();
        pw.println("\"name\":"+"\""+fileName+"\",");
        pw.println("\"description\":\"Riddles App\",");
        pw.println("\"originate\":\"STREAMING\",");
        pw.println("\"files\":[");
        pw.println("{");
        //pw.println("\"path\":\"swlib_internal_path\",");
        pw.println("\"file_archive_path\":\"swlib_internal_path\",");
        pw.println("\"content_type\":\"application/octet-stream\",");
        pw.println("\"source\":\""+f.getName()+"\"");
        pw.println("}");
        pw.println("]");
        pw.print("}");
        pw.flush();
        pw.close();
        String content = sw.toString();
        System.out.println("CONTENT:\n"+content+"\n");
        //String content = "{\n\"name\":\"STOPPED\"\n}";
        List<EMRestService.MultipartItem> items = new ArrayList<EMRestService.MultipartItem>();
        EMRestService.MultipartItem item1, item2, item3, item4, item5;
        item1 = new EMRestService.MultipartItem("item1", false);
        item1.setContentType("multipart/form-data");
        item1.setContent(content);
        items.add(item1);
        item2 = new EMRestService.MultipartItem("item2", true);
        item2.setFileAlias(f.getName());
        item2.setFile(f);
        items.add(item2);
        File deploymentPlanFile = new File(applicationLocation+"deployment_plan.xml");
        item3 = new EMRestService.MultipartItem("item3", true);
        item3.setFileAlias(deploymentPlanFile.getName());
        item3.setFile(deploymentPlanFile);
        items.add(item3);
        File preDeployFile = new File(deployPlanLocation+" predeploy_script.py");
        item4 = new EMRestService.MultipartItem("item4", true);
        item4.setFileAlias(preDeployFile.getName());
        item4.setFile(preDeployFile);
        items.add(item4);
        File postDeployFile = new File(deployPlanLocation+" postdeploy_script.py");
        item5 = new EMRestService.MultipartItem("item5", true);
        item5.setFileAlias(postDeployFile.getName());
        item5.setFile(postDeployFile);
        items.add(item5);
        
        String uri = emLocation+"/em";
        EMRestService ers = new EMRestService(uri, emUser, emPassword.getBytes());
        ers.setReadTimeout(600*1000);
        Object o = ers.webserviceMultipart(EMRestService.Method.POST, uri+"/cloud/service_family_type/jaas", "application/oracle.com.cloud.jaas.ApplicationInstanceComponent", items);
        System.out.println(o);
    }
}

29.1.3 Zone

The following table describes the Zone [application/oracle.com.cloud.common.Zone+json] data model.

Table 29-3 Zone Data Model

Field Type Occurs Description

uri

URI

1

A GET against this URI refreshes the client representation of the zone definition to this user.

name

String

1

Name of the Zone.

description

String

0...1

Human readable description of the Zone. It is a UNICODE string to support different languages.

context_id

String

1

This is an ID indication the internal reference of the zone

service_instances

Collection <ServiceInstance>

0..1

Collection of the service instances that are in this zone.

service_family_type

String

0..1

The name of the service family type that this zone is associated with.Each Zone is contextualized in the service family type.

resource_state

ResourceState

0..1

The resource state of the resource.

media_type

String

1

The media type of the resource.

canonicalLink

String

1

GET against this normalized/canonical URI refreshes the client representation of the resources accessible to this user.


29.1.3.1 GET Operation on a Zone URI to return its representation

The following shows an example of a GET operation on the Zone URI to return its representation.

Example Request:

GET /em/cloud/jaas/zone/ A1B44A4EBCC4563125D9D0A3AAE4FD51
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.common.Zone+json

Example Response:

{
  "uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
  "name" : "Zone1" ,
  "description" : "Zone for Physical Pool" ,
  "resource_state" :     {
      "state" : "READY"
    } ,
  "context_id" : "A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
  "media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
  "service_family_type" : "jaas" ,
  "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/zone/ A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
  "service_instances" :     {
      "media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
      "total" : "1" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42" ,
            "name" : "MyServer-1" ,
            "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
            "status" : "RUNNING"
            "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42"
          }
      ]
    }
}          

29.1.4 JavaPlatformTemplate

The JavaPlatformTemplate extends the CloudServiceTemplate SDK class. It is permissible to accept the ServiceTemplate media type on an instance of JavaPlatformTemplate. It is a preconfigured deployable entity that realizes a JavaPlatformInstance resource.

The following table describes the JavaPlatformTemplate [application/oracle.com.cloud.jaas.JavaPlatformTemplate+json] data model.

Table 29-4 JavaPlatformTemplate Data Model

Field Type Occurs Description

uri

URI

1

A GET against this URI refreshes the client representation of the resources accessible to this user.

name

String

1

A human readable name given to the template.

description

String

0...1

A brief description given to the template.

created

Timestamp

1

Date and time, in ISO 8601 format, when the template was created/last modified.

zones

Collection <Zone>

1

List of all zones configured for this template.

service_family_type

String

1

Denotes the type of Service Template (for example, "jaas").

resource_state

ResourceState

1

The validity of the fields on a GET should be guaranteed only when the resource state is READY. Otherwise, the client should not assume the validity of the fields.

service_instances

Collection

<JavaPlatformInstance>

0…1

All service instances created based on this JavaPlatformTemplate.

media_type

String

1

The media type of the service template that this type represents.

default_instance_media_type

String

1

Default media type for the request, value "application/oracle.com.cloud.jaas.JavaPlatformInstance+json".

context_id

String

1

This is an ID indication the internal reference of the service template.

canonicalLink

String

1

GET against this normalized/canonical URI refreshes the client representation of the resources accessible to this user.


29.1.4.1 GET Operation Supported on a JavaPlatformTemplate

The following shows an example of a GET operation on the JavaPlatformTemplate URI to return its representation.

Example Request:

GET /em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.JavaPlatformTemplate+json

Example Response:

{
  "uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
  "name" : "PS4_LowHeapTemplate" ,
  "description" : "This is a service template using the CDP CDP_PS4_lowHeap_MWProfile" ,
  "resource_state" :     {
      "state" : "READY"
    } ,
  "context_id" : "D016AADD465462ACE040F20AD18167BA" ,
  "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
  "service_family_type" : "jaas" ,
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/ D016AADD465462ACE040F20AD18167BA" ,
  "created" : "2012-12-04 23:16:10.0" ,
  "default_instance_media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
  "zones" :     {
      "media_type" : "application/oracle.com.cloud.common.Zone+json" ,
      "total" : "1" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
            "name" : "Zone1" ,
            "media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
            "service_family_type" : "jaas"
            "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas"
          }
      ]
    } ,
  "service_instances" :     {
      "media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
      "total" : "1" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42" ,
            "name" : "MyServer-1" ,
            "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
            "status" : "RUNNING"
            "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42"
          }
      ]
    }
}

29.1.4.2 POST Operation on a JavaPlatformTemplate

The following shows a sample POST on the JavaPlatformTemplate URI to create an "empty" JavaPlatformInstance by providing:

  • Name of JavaPlatformInstance in "name" attribute

  • Destination Zone URI in "zone" attribute

Example Request:

POST /em/cloud/jaas/javaplatformtemplate/ D016AADD465462ACE040F20AD18167BA
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json
  Content-Type: application/oracle.com.cloud.jaas.JavaPlatformInstance+json
 {
    "name" : "rtjul17", 
    "zone" : "/em/cloud/jaas/zone/C355810A6"
 }

Example Response (When the operation is in progress):

{
  "uri" : "/em/cloud/jaas/javaplatforminstancerequest/1" ,
  "name" : "rtjul17_Create_20120717_045804697" ,
  "resource_state" :     {
      "state" : "INITIATED" ,
      "messages" : 
        [
                {
                    "text" : "null" ,
                        "date" : "2012-07-17T09:16:13+0000"
               }
       ]
    } ,
 "context_id": "1",
 "media_type": "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
 "service_family_type": "jaas" ,
 "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstancerequest/1" ,
 "status": "SCHEDULED"
 "created" : "2013-05-09T07:06:57+0000"
}

Example Response (After the instance has been created):

{
  "uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
  "name" : "PS4_LowHeapTemplate" ,
  "description" : "This is a service template using the CDP CDP_PS4_lowHeap_MWProfile" ,
  "resource_state" :     {
      "state" : "READY"
    } ,
  "context_id" : "D016AADD465462ACE040F20AD18167BA" ,
  "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
  "service_family_type" : "jaas" ,
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/ D016AADD465462ACE040F20AD18167BA" ,
  "created" : "2012-12-04 23:16:10.0" ,
  "default_instance_media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
  "zones" :     {
      "media_type" : "application/oracle.com.cloud.common.Zone+json" ,
      "total" : "1" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
            "name" : "Zone1" ,
            "media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
            "service_family_type" : "jaas"
            "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas"
          }
      ]
    } ,
  "service_instances" :     {
      "media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
      "total" : "1" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42" ,
            "name" : "MyServer-1" ,
            "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
            "status" : "RUNNING"
            "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42"
          }
      ]
    }
}

29.1.4.3 GET on the Java Platform Request URL

The following shows a sample GET operation on the JavaPlatform Request URL:

Example Request:

GET /em/cloud/jaas/javaplatforminstancerequest/1
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

Example Response (When the operation is in progress):

{
  "uri" : "/em/cloud/jaas/javaplatforminstancerequest/1" ,
  "name" : "rtjul17_Create_20120717_045804697" ,
  "resource_state" :     {
      "state" : "INITIATED" ,
      "messages" : 
        [
                {
                    "text" : "null" ,
                        "date" : "2012-07-17T09:16:13+0000"
               }
       ]
    } ,
 "context_id": "1",
 "media_type": "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
 "service_family_type": "jaas" ,
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstancerequest/1" ,"status": "SCHEDULED
 "created" : "2013-05-09T07:06:57+0000"
}

Example Response (After the instance has been created):

{
  "uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
  "name" : "PS4_LowHeapTemplate" ,
  "description" : "This is a service template using the CDP CDP_PS4_lowHeap_MWProfile" ,
  "resource_state" :     {
      "state" : "READY"
    } ,
  "context_id" : "D016AADD465462ACE040F20AD18167BA" ,
  "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
  "service_family_type" : "jaas" ,
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/ D016AADD465462ACE040F20AD18167BA" ,
  "created" : "2012-12-04 23:16:10.0" ,
  "default_instance_media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
  "zones" :     {
      "media_type" : "application/oracle.com.cloud.common.Zone+json" ,
      "total" : "1" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
            "name" : "Zone1" ,
            "media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
            "service_family_type" : "jaas"
            "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/service_family_type/jaas"
          }
      ]
    } ,
  "service_instances" :     {
      "media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" ,
      "total" : "1" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42" ,
            "name" : "MyServer-1" ,
            "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
            "status" : "RUNNING"
            "canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42"
          }
      ]
    }
}

29.1.5 JavaPlatformInstance

JavaPlatformInstance will extend the ServiceInstance from the Cloud framework resource model. It is linked to an Oracle Composite Application target in Enterprise Manager.

The following table describes the JavaPlatformInstance [application/oracle.com.cloud.jaas.JavaPlatformInstance+json] data model.

Table 29-5 JavaPlatformInstance Data Model

Field Type Occurs Description

uri

URI

1

A GET against this URI refreshes the client representation of the resources accessible to this user.

name

String

1

A human readable name given to the instance.

[POST]

zone

Zone (uri, name, media_type)

1

The Zone to which the instance is deployed.

[POST]

media_type

String

1

Indicates the additional media type that clients can use to perform a GET.

application_instance_deployments

Collection <ApplicationInstanceDeployment>

0…1

This is a list of all the ApplicationInstanceDeployments deployed on the JavaPlatformInstance.

resource_state

ResourceState

1

The validity of the fields on a GET should be guaranteed only when the resource state is READY. Otherwise, the client should not assume the validity of the fields.

based_on

JavaPlatformTemplate

1

JavaPlatformTemplate based on which this instance was created.

jdbc_drivers

String[]

0…1

List of JDBC drivers available to create a data source on this instance.

data_sources

Collection<DataSource>

0…1

This is a list of all the data sources configured for this instance.

status

String

0…1

Indicates the status of the underlying Weblogic cluster

Values are

STOPPED, RUNNING, UNREACHABLE, UNKNOWN

server_count

String

1

Number of Java servers in the Weblogic cluster of the JavaPlatformInstance

[PUT]

service_family_type

String

1

Denotes the type of Service Instance (for example, "jaas").

context_id

String

1

This is an ID indication the internal reference of the service template

canonicalLink

String

1

GET against this normalized/canonical URI refreshes the client representation of the resources accessible to this user.


29.1.5.1 GET Operation Supported on a JavaPlatformInstance

The following shows a sample GET operation on the JavaPlatformInstance URI to return its representation.

Example Request:

GET /em/cloud/jaas/javaplatforminstance/960A4A8244145EC7949303B4ECD650D0
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

Example Response:

{
  "uri" : "/em/cloud/jaas/javaplatforminstance/960A4A8244145EC7949303B4ECD650D0" ,
  "name" : "jb__sd_platform_12_24_2012_13_38_28" ,
  "resource_state" :     {
      "state" : "READY"
    } ,
  "context_id" : "960A4A8244145EC7949303B4ECD650D0" ,
  "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
  "service_family_type" : "jaas" ,
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/960A4A8244145EC7949303B4ECD650D0" ,
  "status" : "RUNNING" ,
  "zone" :     {
      "uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
      "name" : "Zone1" ,
      "context_id" : "A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
      "media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
      "service_family_type" : "jaas"
      "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/zone/ A1B44A4EBCC4563125D9D0A3AAE4FD51" ,      "type" : "jaas"
    } ,
  "based_on" :     {
      "uri" : "/em/cloud/jaas/javaplatformtemplate/D016AADD465462ACE040F20AD18167BA" ,
      "name" : "PS4_LowHeapTemplate" ,
      "context_id" : "D016AADD465462ACE040F20AD18167BA" ,
      "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformTemplate+json" ,
      "service_family_type" : "jaas"
      "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatformtemplate/ D016AADD465462ACE040F20AD18167BA "
    } ,
  "data_sources" :     {
      "media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
      "total" : "0" ,
      "elements" : 
      [      ]
    } ,
      "jdbc_drivers" : 
  [
    "com.ddtek.jdbc.oracle.OracleDriver" ,
    "oracle.jdbc.xa.client.OracleXADataSource" ,
    "oracle.jdbc.OracleDriver" ,
    "com.ddtek.jdbcx.oracle.OracleDataSource"
  ] ,
  "server_count" : "1" ,
  "application_instance_deployments" :     {
      "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
      "total" : "0" ,
      "elements" : 
      [      ]
    }
}

29.1.5.2 DELETE Operation Supported on a JavaPlatformInstance

The following shows a sample DELETE operation on the JavaPlatformInstance URI to retire the service instance.

Example Request:

DELETE /em/cloud/jaas/javaplatforminstance/960A4A8244145EC7949303B4ECD650D0
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

Example Response:

{
  "uri" : "/em/cloud/jaas/javaplatforminstancerequest/121" ,
  "name" : "rtjul17_Delete_20120719_035504227" ,
  "resource_state" :     {
      "state" : "INITIATED" ,
      "messages" : 
         [
                 {
                       "text" : "null" ,
                        "date" : "2012-07-19T09:16:13+0000"
                 }
         ]
      } ,
   "context_id": "121",
   "media_type": "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
   "service_family_type": "jaas" ,
   "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstancerequest/121" ,
   "status": "SCHEDULED"
   "created" : "2013-05-09T09:08:38+0000"
}

29.1.5.3 GET of Java Platform Request URI returned by DELETE operation

Example Request:

GET /em/cloud/jaas/javaplatforminstancerequest/121
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

Example Response (When the operation is in progress):

{
"uri" : "/em/cloud/jaas/javaplatforminstancerequest/121" ,
"name" : "rtjul17_Delete_20120719_035504227" ,
"resource_state" :     {
      "state" : "INITIATED" ,
      "messages" : 
      [
                       {
                          "text" : "null" ,
                "date" : "2012-07-19T09:16:13+0000"
          }
      ]
} ,
"context_id": "121",
"media_type": "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
"service_family_type": "jaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstancerequest/121" ,
"status": "SCHEDULED"
"created" : "2013-05-09T09:08:38+0000"
  }

Example Response (when the operation is complete):

The Status field will show that the resource has been deleted.

29.1.5.4 POST Operations Supported on a JavaPlatformInstance

The following shows a sample POST operation on the JavaPlatformInstance URI to deploy an ApplicationInstanceDeployment.

  • Name of ApplicationInstanceDeployment in the "name" attribute

  • ApplicationInstanceComponent URI in the "application_instance_component" attribute

Example Request:

POST /em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json
  Content-Type: application/oracle.com.cloud.jaas.
  ApplicationInstanceDeployment+json
 {
     "name" : "rtriddappjul18", 
     "application_instance_component" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC414FFB7A0912357E040F10A716015F9%3A0.1"
}

Example Response:

{
"uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/ rtriddappjul18@131" ,
             "name" : " rtriddappjul18_Deploy_20120718_051319824" ,
            "resource_state" :     {
                "state" : "INITIATED" ,
                "messages" : 
                [
                  {
                    "date" : "2012-07-18T12:13:28+0000" ,
                    "text" : "null"
                   }
                ]
            } ,
            "context_id" : "rtriddappjul18@131" ,
           "media_type" :             "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
           "service_family_type" : "jaas" ,
           "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeploymentrequest/ rtriddappjul18@131" ,
           "status" : "SCHEDULED"
}

29.1.5.5 GET of Application Instance Deployment Request

The following shows a sample GET of an Application Instance Deployment Request returned by POST to create Application Instance.

Example Request:

GET /em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul18@131
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

Example Response (When the operation is in progress)

{
"uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/ rtriddappjul18@131" ,
             "name" : " rtriddappjul18_Deploy_20120718_051319824" ,
            "resource_state" :     {
                "state" : "INITIATED" ,
                "messages" : 
                [
                  {
                    "date" : "2012-07-18T12:13:28+0000" ,
                    "text" : "null"
                   }
                ]
            } ,
            "context_id" : "rtriddappjul18@131" ,
           "media_type" :          "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
           "service_family_type" : "jaas" ,
           "status" : "SCHEDULED"
  }

Example Response (When the operation is complete)

{
     "uri" : "/em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3" ,
     "name" : "rtriddappjul19" ,
     "resource_state" :     {
         "state" : "READY"
     } ,
     "context_id" : "9D8868C9632E3" ,
     "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
     "service_family_type" : "jaas" ,
     "status" : "RUNNING" ,
     "http_application_invocation_url" :     {
        "ms_3" : "http://slc02jyq.us.oracle.com:32463/RiddlesWeb" ,
        "ms_4" : "http://slc02jyq.us.oracle.com:40298/RiddlesWeb"
      } ,
     "https_application_invocation_url" :     {
        "ms_3" : "https://slc02jyq.us.oracle.com:3550/RiddlesWeb" ,
        "ms_4" : "https://slc02jyq.us.oracle.com:41467/RiddlesWeb"
      } ,
     "contained_in" :     {
        "uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C" ,
        "name" : "rtjul17" ,
        "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
        "status" : "RUNNING"
      }
}

29.1.5.6 POST on the JavaPlatformInstance URI

The following shows a sample POST operation on the JavaPlatformInstance URI to create a DataSource on the JavaPlatformInstance

  • Name of DataSource in the "name" attribute

  • JNDI Name in "jndi_name" attribute

  • JDBC Driver in "jdbc_driver" attribute

  • Database connect string in "database_connect_string" attribute

  • Database type in "database_type" attribute

  • username and password

Example Request:

POST /em/cloud/jaas/javaplatforminstance/8AF6E65447FBA84E968CCD909BD05D42
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.DataSource+json
  Content-Type: application/oracle.com.cloud.jaas.DataSource+json
{
     "name" : "tarunDS_wthParamchanges" ,
     "jndi_name" : ["jndi_1Paramchanges"] , 
     "jdbc_driver" : "oracle.jdbc.OracleDriver" ,
     "database_connect_string" :   "jdbc:oracle:thin:sysman/sysman@slc04jqf.us.oracle.com:15044:sasdec2" ,
     "database_type" : "Oracle" ,
     "username": "sysman", 
     "password": "sysman"
}

Example Response:

{
        "uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul23@181" ,
        "name" : "rtrepodsjul23_CreateDS_20120722_112705396" ,
        "resource_state" :     {
           "state" : "INITIATED" ,
           "messages" : 
           [
          {
                           "date" : "2012-07-23T06:27:06+0000" ,
                           "text" : "null"
                        }
            ]
         },
        "context_id" : "rtrepodsjul23@181" ,
        "media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
        "service_family_type" : "jaas" ,
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ datasourcerequest/rtrepodsjul23@181" ,
        "status" : "SCHEDULED"
}

29.1.5.7 Get of Data Source Request

The following shows a sample ET of Data Source request returned by POST to create Data Source

Example Request:

GET /em/cloud/jaas/datasourcerequest/rtrepodsjul23@181
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json

Example Response (When the operation is in progress):

{
        "uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul23@181" ,
        "name" : "rtrepodsjul23_CreateDS_20120722_112705396" ,
        "resource_state" :     {
           "state" : "INITIATED" ,
           "messages" : 
           [
          {
                           "date" : "2012-07-23T06:27:06+0000" ,
                           "text" : "null"
                        }
            ]
         },
        "context_id" : "rtrepodsjul23@181" ,
        "media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
        "service_family_type" : "jaas" ,
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ datasourcerequest/rtrepodsjul23@181" ,
        "status" : "SCHEDULED"
}

Example Response (When the operation is complete):

{
     "uri" : "/em/cloud/jaas/datasource/ rtrepodsjul18@CF4339D922C" ,
     "name" : "rtrepodsjul18" ,
     "resource_state" :     {
        "state" : "READY"
      } ,
     "context_id" : " rtrepodsjul18@CF4339D922C" ,
     "media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
     "service_family_type" : "jaas" ,
     "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C " ,
     "jndi_name" : 
     [
       "jndi_1"
     ] ,
     "jdbc_driver" : "oracle.jdbc.OracleDriver" ,
     "username" : "sysam",
     "database_connect_string" : "jdbc:oracle:thin:sysman/sysman@slc02jyq.us.oracle.com:15044:sjuly14" ,
     "contained_in" :     {
        "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
        "context_id" : "CF4339D922C51" ,
        "name" : "rtjul17" ,
        "uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C51"
    }
 
}

29.1.5.8 PUT Operations Supported on a JavaPlatformInstance

The following shows a sample PUT operation on JavaPlatformInstance URI to scale up or scale down the service instance. The final server count is contained in "server_count" attributes. A Scale up or scale down request will be submitted according to Current server count being greater than or lesser than the Final server count.

Example Request:

PUT /em/cloud/jaas/javaplatforminstance/CF4339D922C5
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.JavaPlatformInstance+json
  Content-type: application/oracle.com.cloud.jaas.JavaPlatformInstance+json
{
      "server_count" : "3"
}

Example Response:

{
  "uri" : "/em/cloud/jaas/javaplatforminstancerequest/211" ,
  "name" : "rtjul17_Scaleup_20120719_045804697" ,
  "resource_state" :     {
      "state" : "INITIATED" ,
      "messages" : 
      [
                {
                  "text" : "null" ,
                        "date" : "2012-07-19T09:16:13+0000"
              }
        ]
    } ,
  "context_id": "211",
  "media_type": "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
  "service_family_type": "jaas" ,
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ javaplatforminstancerequest/211" ,
  "status": "SCHEDULED"
  "created" : "2013-05-09T11:46:27+0000"
}

29.1.6 ApplicationInstanceDeployment

This represents the deployment of an Application Instance in a JavaPlatformInstance.

The following table describes the ApplicationInstanceDeployment [application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json] data model.

Table 29-6 ApplicationInstanceDeployment Data Model

Field Type Occurs Description

uri

URI

1

A GET against this URI refreshes the client representation of the resources accessible to this user.

name

String

1

A human readable name given to the instance.

[POST]

application_instance_component

ApplicationInstanceComponent

(uri,name,version)

1

The ApplicationInstanceComponent in the Software library which was used during deployment of this instance.

[POST]

http_application_invocation_url

Map<String,String>

0…1

Map of server name and HTTP URL of the deployed application. Will be populated after the instance has been created.

https_application_invocation_url

Map<String,String>

0…1

Map of server name and HTTPS URL of the deployed application. Will be populated after the instance has been created.

contained_in

JavaPlatformInstance

(uri,name)

1

JavaPlatformInstance on which the application is deployed.

deployment_plan

String

0…1

Vendor specific configuration parameters for this deployment in the prescribed XML format.

[POST]

status

String

0…1

Indicates the status of the ApplicationInstanceDeployment.

Values are

STOPPED, RUNNING, UNREACHABLE, UNKNOWN

[PUT]

metrics

Collection <Metric>

0…1

The list of metrics (uri, name, type current_value) that are pertinent to this service instance.

resource_state

ResourceState

1

The validity of the fields on a GET should be guaranteed only when the resource state is READY. Otherwise, the client should not assume the validity of the fields.

service_family_type

String

1

Denotes the type of ApplicationInstanceDeployment (for example, "jaas").

media_type

String

1

Indicates the additional media type that clients can use to perform a GET.

context_id

String

1

This is an ID indication of the internal reference of the application deployment.

canonicalLink

String

1

GET against this normalized/canonical URI refreshes the client representation of the resources accessible to this user.


29.1.6.1 GET Operation supported on an ApplicationInstanceDeployment

The following shows a sample GET operation on the ApplicationInstanceDeployment URI to return its representation.

Example Request:

GET /em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json

Example Response:

HTTP/1.1 200 OK
  Content-Type: application/oracle.com.cloud.jaas. ApplicationInstanceDeployment+json
  Content-Location: /em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3
  Cache-Control: public
  Content-Length: nnn
{
     "uri" : "/em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3" ,
     "name" : "rtriddappjul19" ,
     "resource_state" :     {
         "state" : "READY"
     } ,
     "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
     "service_family_type" : "jaas" ,
     "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3" ,
     "status" : "RUNNING" ,
     "http_application_invocation_url" :     {
        "ms_3" : "http://slc02jyq.us.oracle.com:32463/RiddlesWeb" ,
        "ms_4" : "http://slc02jyq.us.oracle.com:40298/RiddlesWeb"
      } ,
     "https_application_invocation_url" :     {
        "ms_3" : "https://slc02jyq.us.oracle.com:3550/RiddlesWeb" ,
        "ms_4" : "https://slc02jyq.us.oracle.com:41467/RiddlesWeb"
      } ,
     "contained_in" :     {
        "uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C" ,
        "name" : "rtjul17" ,
        "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
        "status" : "RUNNING"
        "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/javaplatforminstance/ CF4339D922C "
      }
}

29.1.6.2 DELETE Operation supported on an ApplicationInstanceDeployment

The following shows a sample DELETE operation on the ApplicationInstanceDeployment URI which undeploys the application from JavaPlatformInstance.

Example Request:

DELETE /em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json

Example Response:

HTTP/1.1 200 OK
  Content-Type: application/oracle.com.cloud.jaas. ApplicationInstanceDeployment+json
  Content-Location: /em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@184
  Cache-Control: public
  Content-Length: nnn
  {
     "uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@184" ,
     "name" : "rtriddappjul19_Undeploy_20120723_011757881" ,
     "resource_state" :     {
        "state" : "INITIATED" ,
        "messages" : 
        [
            {
              "date" : "2012-07-23T08:18:01+0000" ,
              "text" : "null"
            }
        ]
     } ,
     "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
     "service_family_type" : "jaas" ,
     canonicalLink: "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@184" ,
     "status" : "SCHEDULED"
  }

29.1.6.3 Sample GET on Application Instance Deployment Request

The following shows a sample GET operation on an Application Instance Deployment Request.

Example Request:

GET /em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@184
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json

Example Response: (operation in progress):

{
     "uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@184" ,
     "name" : "rtriddappjul19_Undeploy_20120723_011757881" ,
     "resource_state" :     {
        "state" : "INITIATED" ,
        "messages" : 
        [
            {
              "date" : "2012-07-23T08:18:01+0000" ,
              "text" : "null"
            }
        ]
     } ,
     "context_id" : "rtriddappjul19@184" ,
     "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
     "service_family_type" : "jaas" ,
     canonicalLink: "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@184" ,
     "status" : "SCHEDULED"
  }

Example Response: (operation is complete):

The status field will show that the resource has been deleted.

29.1.6.4 Sample PUT Operation supported on an ApplicationInstanceDeployment

The following shows a sample PUT operation on the ApplicationInstanceDeployment URI to start or stop the instance.

  • STOPPED to RUNNING

    Put on status attribute, value = "START"

  • RUNNING to STOPPED

    Put on status attribute, value = "STOP"

  • REDEPLOY

    Put on status attribute, value = "REDEPLOY" and ApplicationInstanceComponent URI in the "application_instance_component" attribute

Example Request: START/STOP

PUT /em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json
  Content-type: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json
{
   "status" : "STOP"
}

Example Response:

HTTP/1.1 200 OK
  Content-Type: application/oracle.com.cloud.jaas. ApplicationInstanceDeployment+json
  Content-Location: /em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@182
  Cache-Control: public
  Content-Length: nnn
  {
     "uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@182" ,
     "name" : "rtriddappjul19_Stop_20120723_123327380" ,
     "resource_state" :     {
        "state" : "INITIATED" ,
        "messages" : 
        [
          {
            "date" : "2012-07-23T07:33:27+0000" ,
            "text" : "null"
          }
        ]
     } ,
     "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
    "service_family_type" : "jaas" ,
    "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@182" ,
    "status" : "SCHEDULED"
  }

Example Request for REDEPLOY:

PUT /em/cloud/jaas/applicationinstancedeployment/9D8868C9632E3
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json
  Content-type: application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json
{
   "status" : "STOP" , 
    "application_instance_component" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC414FFB7A0912357E040F10A716015F9%3A0.1"
}

Example Response:

 {
     "uri" : "/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@183" ,
     "name" : "rtriddappjul19_Undeploy_20120723_123327380" ,
     "resource_state" :     {
        "state" : "INITIATED" ,
        "messages" : 
        [
          {
            "date" : "2012-07-23T07:33:27+0000" ,
            "text" : "null"
          }
        ]
     } ,
     "context_id" : "rtriddappjul19@183" ,
     "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceDeployment+json" ,
    "service_family_type" : "jaas" , 
    "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancedeploymentrequest/rtriddappjul19@183" ,
    "status" : "SCHEDULED"
  }

29.1.7 DataSource

The DataSource resource model has the following characteristics:

The following table describes the DataSource [application/oracle.com.cloud.jaas.DataSource+json] data model.

Table 29-7 DataSource Data Model

Field Type Occurs Description

uri

URI

1

A GET against this URI refreshes the client representation of the resources accessible to this user.

name

String

1

A human readable name given to the data source.

[POST][PUT]

jndi_name

String[]

1

JNDI path to where this data source will be bound. Applications look up the data source on the JNDI tree by this name when reserving a connection.

[POST][PUT]

database_type

String

0…1

The DBMS of the database that the data source represents.

[POST]

jdbc_driver

String

1

The database driver used to connect to the database.

[POST]

contained_in

JavaPlatformInstance

(uri, name)

1

JavaPlatformInstance on which the data source exists.

resource_state

ResourceState

1

The validity of the fields on a GET should be guaranteed only when the resource state is READY. Otherwise, the client should not assume the validity of the fields.

database_connect_string

String

0…1

Connect String of the database can be provided to create the data source.

[POST][PUT]

service_family_type

String

1

Denotes the type of Data Source (for example, "jaas").

media_type

String

1

Indicates the additional media type that clients can use to perform a GET.

username

String

1

Username of the DB connection.

password

String

1

Password of the DB connection.

context_id

String

1

This is an ID indication the internal reference of the data source.

canonicalLink

String

1

GET against this normalized/canonical URI refreshes the client representation of the resources accessible to this user.


29.1.7.1 GET Operation supported on a DataSource

The following shows a sample GET operation on the DataSource URI to return its representation.

Example Request:

GET /em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.DataSource+json

Example Response:

{
     "uri" : "/em/cloud/jaas/datasource/ rtrepodsjul18@CF4339D922C" ,
     "name" : "rtrepodsjul18" ,
     "resource_state" :     {
        "state" : "READY"
      } ,
     "context_id" : " rtrepodsjul18@CF4339D922C" ,
     "media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
     "service_family_type" : "jaas" ,
     "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C " ,
     "jndi_name" : 
     [
       "jndi_1"
     ] ,
     "jdbc_driver" : "oracle.jdbc.OracleDriver" ,
     "username" : "sysam",
     "database_connect_string" : "jdbc:oracle:thin:sysman/sysman@slc02jyq.us.oracle.com:15044:sjuly14" ,
     "contained_in" :     {
        "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
        "context_id" : "CF4339D922C51" ,
        "name" : "rtjul17" ,
        "uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C51"
    }
 
}

29.1.7.2 DELETE Operation supported on a DataSource

The following shows a sample DELETE operation on the DataSource URI removes it from the JavaPlatformInstance.

Example Request:

DELETE /em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.DataSource+json

Example Response:

HTTP/1.1 200 OK
  Content-Type: application/oracle.com.cloud.jaas.DataSource+json
  Content-Location: /em/cloud/jaas/datasourcerequest/rtrepodsjul18@201
  Cache-Control: public
  Content-Length: nnn
  {
     "uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul18@201" ,
     "name" : "rtrepodsjul18_DeleteDS_20120723_024836692" ,
     "resource_state" :     {
         "state" : "INITIATED" ,
         "messages" : 
         [
            {
               "date" : "2012-07-23T09:48:37+0000" ,
               "text" : "null"
            }
         ]
     } ,
     "media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
     "service_family_type" : "jaas" ,
     "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ datasourcerequest/rtrepodsjul18@201" ,
     "status" : "SCHEDULED"
  }

29.1.7.3 GET on Data source Request

The following shows a sample GET operation on a DataSource request.

Example Request:

DELETE / em/cloud/jaas/datasourcerequest/rtrepodsjul18@201
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.DataSource+json

Example Response: (operation in progress):

  {
     "uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul18@201" ,
     "name" : "rtrepodsjul18_DeleteDS_20120723_024836692" ,
     "resource_state" :     {
         "state" : "INITIATED" ,
         "messages" : 
         [
            {
               "date" : "2012-07-23T09:48:37+0000" ,
               "text" : "null"
            }
         ]
     } ,
     "context_id" : "rtrepodsjul18@201" ,
     "media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
     "service_family_type" : "jaas" ,
     "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ datasourcerequest/rtrepodsjul18@201" ,
     "status" : "SCHEDULED"
  }

Example Response: (operation is complete)

The status field will show that the resource has been deleted.

29.1.7.4 PUT Operation Supported on a DataSource

The following shows a sample PUT operation on the DataSource URI to update the DataSource to add/remove JNDI names and edit the database connect string. An example request for TEST DataSource is also provided.

Example Request:

PUT /em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.DataSource+json
Content-type: application/oracle.com.cloud.jaas.DataSource+json
{
     "jndi_name" : ["jndi_2"],
      "database_connect_string" :    "jdbc:oracle:thin:sysman/sysman@slc02knx.us.oracle.com:15044:sep25cc" ,
      "username" : "sysman",
      "password" : "sysman"
}

Example Response:

{
  "uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul18@CF4339D922C" ,
  "name" : "rtrepodsjul18_UpdateDS_20121216_062909975" ,
  "resource_state" :     {
      "state" : "READY" ,
      "messages" : 
      [
          {
            "date" : "2012-12-16T14:29:16+0000" ,
            "text" : "null"
          }
      ]
    } ,
  "context_id" : "rtrepodsjul18@681" ,
  "media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
  "service_family_type" : "jaas" ,
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/datasourcerequest/rtrepodsjul18@191" ,
  "status" : "SCHEDULED"
}               

Example Request for TEST Data Source

PUT /em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.DataSource+json
  Content-type: application/oracle.com.cloud.jaas.DataSource+json
{
     "status" : "TEST"
}

Example Response

{
     "uri" : "/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C" ,
     "name" : "rtrepodsjul18" ,
     "resource_state" :     {
        "state" : "READY"
      } ,
     "context_id" : " rtrepodsjul18@CF4339D922C" ,
     "media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
     "service_family_type" : "jaas" , 
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C " ,
     "jndi_name" : 
     [
       "jndi_1"
     ] ,
     "jdbc_driver" : "oracle.jdbc.OracleDriver" ,
     "username" : "sysam",
     "database_connect_string" : "jdbc:oracle:thin:sysman/sysman@slc02jyq.us.oracle.com:15044:sjuly14" ,
     "contained_in" :     {
        "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
        "context_id" : "CF4339D922C51" ,
        "name" : "rtjul17" ,
        "uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C51"
    }
}

29.1.7.5 GET on Data source Request

The following shows a sample GET on DataSource request.

Example Request:

DELETE / em/cloud/jaas/datasourcerequest/rtrepodsjul18@201
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.DataSource+json

Example Response (operation in progress):

{
     "uri" : "/em/cloud/jaas/datasourcerequest/rtrepodsjul18@201" ,
     "name" : "rtrepodsjul18_DeleteDS_20120723_024836692" ,
     "resource_state" :     {
         "state" : "INITIATED" ,
         "messages" : 
         [
            {
               "date" : "2012-07-23T09:48:37+0000" ,
               "text" : "null"
            }
         ]
     } ,
     "context_id" : "rtrepodsjul18@201" ,
     "media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
     "service_family_type" : "jaas" ,  
     "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ datasourcerequest/rtrepodsjul18@201" ,
     "status" : "SCHEDULED"
  }

Example Response (operation is complete):

{
     "uri" : "/em/cloud/jaas/datasource/ rtrepodsjul18@CF4339D922C" ,
     "name" : "rtrepodsjul18" ,
     "resource_state" :     {
        "state" : "READY"
      } ,
     "context_id" : " rtrepodsjul18@CF4339D922C" ,
     "media_type" : "application/oracle.com.cloud.jaas.DataSource+json" ,
     "service_family_type" : "jaas" ,
     "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/datasource/rtrepodsjul18@CF4339D922C " ,
     "jndi_name" : 
     [
       "jndi_1"
     ] ,
     "jdbc_driver" : "oracle.jdbc.OracleDriver" ,
     "username" : "sysam",
     "database_connect_string" : "jdbc:oracle:thin:sysman/sysman@slc02jyq.us.oracle.com:15044:sjuly14" ,
     "contained_in" :     {
        "media_type" : "application/oracle.com.cloud.jaas.JavaPlatformInstance+json" ,
        "context_id" : "CF4339D922C51" ,
        "name" : "rtjul17" ,
        "uri" : "/em/cloud/jaas/javaplatforminstance/CF4339D922C51"
    }
 
}

29.1.8 ApplicationInstanceComponent

This represents the application component in the software library. It can be created by POST-ing to the Jaas service type.

The following table describes the ApplicationInstanceComponent [application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json] data model.

Table 29-8 ApplicationInstanceComponent Data Model

Field Type Occurs Description

uri

URI

1

A GET against this URI refreshes the client representation of the resources accessible to this user.

name

String

1

A human readable name given to the instance.

[POST]

creator

String

1

Creator of the ApplicationInstanceComponent in the Software Library.

created

Timestamp

1

Date and time, in ISO 8601 format, when the instance was created.

version

String

1

Version of the ApplicationInstanceComponent in the Software library.

[POST]

resource_state

ResourceState

1

The validity of the fields on a GET should be guaranteed only when the resource state is READY. Otherwise, the client should not assume the validity of the fields.

context_id

String

1

This is an ID indication the internal reference of the ApplicationInstanceComponent.

service_family_type

String

1

Denotes the type of ApplicationInstanceComponent (for example, "jaas").

media_type

String

1

Indicates the additional media type that clients can use to perform a GET.

status

String

1

Status of the ApplicationInstanceComponent in the Software Library.

maturity

String

1

Maturity of the ApplicationInstanceComponent in the Software Library.

componenttype

String

1

Component type of ApplicationInstanceComponent (for example, Java EE Application).

canonicalLink

String

1

GET against this normalized/canonical URI refreshes the client representation of the resources accessible to this user.


29.1.8.1 GET Operation supported on an ApplicationInstanceComponent

The following shows a sample GET operation on the ApplicationInstanceComponent URI to return its representation.

Example Request:

GET /em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json

Example Response:

HTTP/1.1 200 OK
  Content-Type: application/oracle.com.cloud.jaas. ApplicationInstanceComponent+json
  Content-Location: /em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1
  Cache-Control: public
  Content-Length: nnn
{
     "uri" :   "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1" ,
     "name" : "Riddles" ,
     "resource_state" :     {
        "state" : "READY"
     } ,
     "context_id" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_JavaEEApplication:C514D5CF9FC00CD7E040F10A716020D0:0.1" ,
     "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
     "service_family_type" : "jaas" ,
     "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/ applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1" ,
     "created" : "2012-07-17 22:31:33.0" ,
     "version" : "0.1" ,
     "creator" : "SSA_USER_1" ,
     "componenttype" : "Java EE Application" ,
     "status" : "Ready" ,
     "maturity" : "Untested"
}

29.1.8.2 DELETE Operation supported on an ApplicationInstanceComponent

The following shows a sample DELETE operation on the ApplicationInstanceComponent URI.

Example Request:

DELETE /em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json

Example Response:

{
     "uri" :   "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1" ,
      "resource_state" :     {
          "state" : "DESTROYED"
       } ,
       "context_id" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_JavaEEApplication:C514D5CF9FC00CD7E040F10A716020D0:0.1" ,
  "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
  "canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AC514D5CF9FC00CD7E040F10A716020D0%3A0.1"
}

29.2 Application Component Filtering

Application component filtering is supported for JaaS zones, templates, and application components.

29.2.1 Service Template Finds

The filtering attributes supported are name, service_template_type, owner, and media_type. The following are sample requests and responses to Service Template Finds:

Example Request

GET /em/cloud?filters={"filters":{"name":"RiddleApp"}}
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.common.ServiceTemplateFinds+json

Example Response

{
  "uri" : "/em/cloud/finds/service_template/bWVkaWFfdHlwZSUyNTNEYXBwbGljYXRpb24lMjUyRm9yYWNsZS5jb20uY2xvdWQuY29tbW9uLlNl%0AcnZpY2VUZW1wbGF0ZSUyRm5hbWUlMjUzRFJpZGRsZUFwcA%3D%3D" ,
  "name" : "Service Template Finds" ,
  "media_type" : "application/oracle.com.cloud.common.ServiceTemplateFinds+json" ,
  "description" : "This is a Resource Finds for 'Service Template Finds' with media type 'application/oracle.com.cloud.common.ServiceTemplateFinds+json'" ,
  "resource_state" :     {
      "state" : "READY"
    } ,
  "filters" :     {
      "media_type" : "application/oracle.com.cloud.common.ServiceTemplate" ,
      "name" : "RiddleApp"
    } ,
  "finds" :     {
      "media_type" : "application/oracle.com.cloud.common.ServiceTemplate" ,
      "total" : "1" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/applicationinstancecomponent/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3ACOMP_Component%3ASUB_JavaEEApplication%3AD1103FE5F6877372E040F20AD1814215%3A0.1" ,
            "name" : "RiddleApp" ,
            "media_type" : "application/oracle.com.cloud.jaas.ApplicationInstanceComponent+json" ,
            "service_family_type" : "jaas"
          }
      ]
    }
}

29.2.2 Zone Finds

The filtering attributes supported are name, owner, service_family_type, and media_type.

Example Zone Finds GET Request

GET /em/cloud?filters={"filters":{"name":"Zone1"}}
  Host: cloudcompany.com
  Authorization: Basic xxxxxxx
  Accept: application/oracle.com.cloud.common.ZoneFinds+json

Example Zone Finds GET Response

{
  "uri" : "/em/cloud/finds/zone/bWVkaWFfdHlwZSUyNTNEYXBwbGljYXRpb24lMjUyRm9yYWNsZS5jb20uY2xvdWQuY29tbW9uLlpv%0AbmUlMkZuYW1lJTI1M0Rab25lMQ%3D%3D" ,
  "name" : "Zone Finds" ,
  "media_type" : "application/oracle.com.cloud.common.ZoneFinds+json" ,
  "description" : "This is a Resource Finds for 'Zone Finds' with media type 'application/oracle.com.cloud.common.ZoneFinds+json'" ,
  "resource_state" :     {
      "state" : "READY"
    } ,
  "filters" :     {
      "media_type" : "application/oracle.com.cloud.common.Zone" ,
      "name" : "Zone1"
    } ,
  "finds" :     {
      "media_type" : "*/*" ,
      "total" : "1" ,
      "elements" : 
      [
          {
            "uri" : "/em/cloud/jaas/zone/A1B44A4EBCC4563125D9D0A3AAE4FD51" ,
            "name" : "Zone1" ,
            "media_type" : "application/oracle.com.cloud.jaas.Zone+json" ,
            "service_family_type" : "jaas"
          }
      ]
    }
}

29.3 User Preferences

*** ?? ***