Jump to

• Request
• Response
• Examples

Create or Update an Entity Type

post

/serviceapi/entityModel/uds/entityTypes

Creates or updates an entity type.

In case the payload contains assets that don't exist yet, Oracle Management Cloud will create the missing assets out of a template.

Request

Supported Media Types

• application/json

Body ()

Describes an entity type.

Root Schema : UdsEntityType

Type: object

Describes an entity type.

Show Source

• entityType: string
  The entity type

  Example: my_host
• metrics(optional): array metrics
  The metrics for this entity type
• properties(optional): array properties
  The Properties for this entity type
• typeDisplayName(optional): string
  The entity type display name

  Example: My Host Type

{
    "type":"object",
    "required":[
        "entityType"
    ],
    "properties":{
        "entityType":{
            "type":"string",
            "example":"my_host",
            "description":"The entity type"
        },
        "metrics":{
            "type":"array",
            "description":"The metrics for this entity type",
            "items":{
                "$ref":"#/definitions/UdsMetricType"
            }
        },
        "properties":{
            "type":"array",
            "description":"The Properties for this entity type",
            "items":{
                "$ref":"#/definitions/UdsPropertyType"
            }
        },
        "typeDisplayName":{
            "type":"string",
            "example":"My Host Type",
            "description":"The entity type display name"
        }
    },
    "description":"<p>Describes an entity type.</p>"
}

Nested Schema : metrics

Type: array

The metrics for this entity type

Show Source

• Array of: object UdsMetricType

  Describes a metric type.

{
    "type":"array",
    "description":"The metrics for this entity type",
    "items":{
        "$ref":"#/definitions/UdsMetricType"
    }
}

Nested Schema : properties

Type: array

The Properties for this entity type

Show Source

• Array of: object UdsPropertyType

  Describes a property type.

{
    "type":"array",
    "description":"The Properties for this entity type",
    "items":{
        "$ref":"#/definitions/UdsPropertyType"
    }
}

Nested Schema : UdsMetricType

Type: object

Describes a metric type.

Show Source

• dimensions(optional): array dimensions
  The dimensions of this metric
• group(optional): string
  The metric group name

  Example: cpuUtil
• metric: string
  The metric name

  Example: cpuIdle
• type: string
  The metric type

  Example: NUM

{
    "type":"object",
    "required":[
        "metric",
        "type"
    ],
    "properties":{
        "dimensions":{
            "type":"array",
            "description":"The dimensions of this metric",
            "items":{
                "type":"string"
            }
        },
        "group":{
            "type":"string",
            "example":"cpuUtil",
            "description":"The metric group name"
        },
        "metric":{
            "type":"string",
            "example":"cpuIdle",
            "description":"The metric name"
        },
        "type":{
            "type":"string",
            "example":"NUM",
            "description":"The metric type"
        }
    },
    "description":"<p>Describes a metric type.</p>"
}

Nested Schema : dimensions

Type: array

The dimensions of this metric

Show Source

• Array of: string

{
    "type":"array",
    "description":"The dimensions of this metric",
    "items":{
        "type":"string"
    }
}

Nested Schema : UdsPropertyType

Type: object

Describes a property type.

Show Source

• displayName: string
  The display name of a property

  Example: listen port
• identifyingProperty: boolean
  Default Value: false

  The identifying property

  Example: false
• name: string
  The name of the property

  Example: port

{
    "type":"object",
    "required":[
        "displayName",
        "identifyingProperty",
        "name"
    ],
    "properties":{
        "displayName":{
            "type":"string",
            "example":"listen port",
            "description":"The display name of a property"
        },
        "identifyingProperty":{
            "type":"boolean",
            "example":false,
            "description":"The identifying property",
            "default":false
        },
        "name":{
            "type":"string",
            "example":"port",
            "description":"The name of the property"
        }
    },
    "description":"<p>Describes a property type.</p>"
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Success - An existing type has been updated

201 Response

Success - A new type has been created

Back to Top

Examples

Create or update an entity type:

Payload:

{
  "entityType": "MyHostType",
  "typeDisplayName": "My Host Type",
  "metrics": [
    {
      "metric": "cpuIdle",
      "type": "NUM",
      "dimensions": [
        "cpuId"
      ]
    },
    {
      "metric": "cpuSystem",
      "type": "NUM",
      "dimensions": [
        "cpuId"
      ]
    },
    {
      "metric": "cpuUser",
      "type": "NUM",
      "dimensions": [
        "cpuId"
      ]
    }
  ]
}

curl -u ${OMC_USERNAME}:${PASSWORD} -X POST -H "Content-Type:application/json" -d "@example.json" "https://serverurl/serviceapi/entityModel/uds/entityTypes"

Back to Top