Viewing Shapes

Shapes define the compute resources for an instance. You can view the shapes that are available to your tenant. Contact your Oracle Cloud Administrator if you need a shape with a different configuration.

Topics:

Discover Shapes

This API enables you to determine what shapes you have access to in a specific container.

Note:

The discover API calls display the names of the objects in the specified container, not the details about the objects. To list the names of the objects, you must set the Accept header to application/oracle-compute-v3+directory+json. For all other purposes, you must set the Accept header to application/oracle-compute-v3+json.

Method

GET

REST Resource

/shape/container

URI

https://api_endpoint/shape/container

URI Parameter

Parameter	Description
container	(Optional) Hierarchical namespace for shapes

Example URI

https://api.oc.example.com/shape/

Example Response Body

{"result": [
        "/large", 
        "/oc1", 
        "/oc1m", 
        "/oc2m", 
        "/oc3", 
        "/oc3m", 
        "/oc4", 
        "/oc4m", 
        "/oc5", 
        "/oc5m", 
        "/oc6", 
        "/oc7", 
        "/ot1", 
        "/small"]
}

Get Shape

This API enables you to retrieve information for a specific shape.

Method

GET

REST Resource

/shape/name

URI

https://api_endpoint/shape/name

URI Parameter

Parameter	Description
name	Name of the shape

Example URI

https://api.oc.example.com/shape/oc3

Example Response Body

{
  "ram": 7680,
  "cpus": 2.0,
  "uri": "https://api.oc.example.com/shape/oc3",
  "name": "oc3"
}

List Shapes

This API enables you to list information about shapes.

Method

GET

REST Resource

/shape/

URI

https://api_endpoint/shape/

Example URI

https://api.oc.example.com/shape/

Example Response Body

{
  "result": [
    {
      "ram": 7680,
      "cpus": 2.0,
      "uri": "https://api.oc.example.com/shape/oc3",
      "name": "oc3"
    },
    {
      "ram": 15360,
      "cpus": 4.0,
      "uri": "https://api.oc.example.com/shape/oc4",
      "name": "oc4"
    },
    {
      "ram": 30720,
      "cpus": 8.0,
      "uri": "https://api.oc.example.com/shape/oc5",
      "name": "oc5"
    }
  ]
}