REST API for Oracle Enterprise Manager

Get metric group details for a target

get

http://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/targets/{targetId}/metricGroups/{metricGroupName}

Returns details of the specified metric group and its metrics for the target.

Request

Path Parameters

metricGroupName(required): string
Metric Group Name
Example:
```
Filesystems
```
targetId(required): string
Target ID (.i.e, Target GUID)
Example:
```
CF99A10F233254B78ED96ED1B5C15140
```

There's no request body for this operation.

Response

Supported Media Types

application/json

200 Response

Root Schema : MetricGroup

Type: object

Metric group metadata

Show Source

displayName(required): string

Localized Metric group name

Example: File Systems
id(required): string

Maximum Length: 32

Metric group ID

Example: 34E542C4F1CF2743327ED2F8563D1E4B
isMetricExtension(required): boolean

Default Value: false

True if this is a metric extension, false otherwise
keys: array keys

(Optional) List of keys for this metric group, if present. Included if query parameter include=metrics is specified.
links(required): object links

Navigations links
metrics: array metrics

(Optional) List of metrics present in this metric group. Included if query parameter include=metrics is specified.
name(required): string

Maximum Length: 64

Metric group name

Example: Filesystems

{
    "description":"Metric group metadata",
    "type":"object",
    "required":[
        "id",
        "name",
        "displayName",
        "isMetricExtension",
        "links"
    ],
    "properties":{
        "id":{
            "type":"string",
            "maxLength":32,
            "description":"Metric group ID",
            "example":"34E542C4F1CF2743327ED2F8563D1E4B"
        },
        "name":{
            "type":"string",
            "maxLength":64,
            "description":"Metric group name",
            "example":"Filesystems"
        },
        "displayName":{
            "type":"string",
            "description":"Localized Metric group name",
            "example":"File Systems"
        },
        "isMetricExtension":{
            "type":"boolean",
            "default":false,
            "description":"True if this is a metric extension, false otherwise"
        },
        "links":{
            "type":"object",
            "description":"Navigations links",
            "properties":{
                "self":{
                    "type":"object",
                    "allOf":[
                        {
                            "$ref":"#/components/schemas/Link"
                        }
                    ]
                }
            },
            "example":{
                "self":{
                    "href":"/em/api/targets/CF99A10F233254B78ED96ED1B5C15140/metricGroups/Filesystems"
                }
            }
        },
        "keys":{
            "type":"array",
            "description":"(Optional) List of keys for this metric group, if present. Included if query parameter include=metrics is specified.",
            "items":{
                "$ref":"#/components/schemas/MetricKey"
            },
            "example":[
                {
                    "name":"mountPoint",
                    "displayName":"Mount Point"
                }
            ]
        },
        "metrics":{
            "type":"array",
            "description":"(Optional) List of metrics present in this metric group. Included if query parameter include=metrics is specified.",
            "items":{
                "$ref":"#/components/schemas/Metric"
            },
            "example":[
                {
                    "id":"6E65075DA52ACA744B4B8C3FCB018289",
                    "name":"pctAvailable",
                    "displayName":"Filesystem Space Available (%)",
                    "dataType":"NUMBER",
                    "categoryName":"Utilization",
                    "unitDisplayName":"%"
                },
                {
                    "id":"162045AD9191652427CAC47D8BA40671",
                    "name":"size",
                    "displayName":"Filesystem Size (MB)",
                    "dataType":"NUMBER",
                    "unitDisplayName":"MB"
                },
                {
                    "id":"E8838C71E687BF0A9E02FFACC0C9AC80",
                    "name":"available",
                    "displayName":"Filesystem Space Available (MB)",
                    "dataType":"NUMBER",
                    "categoryName":"Utilization",
                    "unitDisplayName":"MB"
                },
                {
                    "id":"C80F6EAA9145C76D30DE8705346D5AAA",
                    "name":"fileSystem",
                    "displayName":"Filesystem",
                    "dataType":"STRING"
                }
            ]
        }
    }
}

Nested Schema : keys

Type: array

(Optional) List of keys for this metric group, if present. Included if query parameter include=metrics is specified.

Show Source

Array of: object MetricKey

Metric key metadata

{
    "type":"array",
    "description":"(Optional) List of keys for this metric group, if present. Included if query parameter include=metrics is specified.",
    "items":{
        "$ref":"#/components/schemas/MetricKey"
    },
    "example":[
        {
            "name":"mountPoint",
            "displayName":"Mount Point"
        }
    ]
}

Example:

[
    {
        "name":"mountPoint",
        "displayName":"Mount Point"
    }
]

Nested Schema : links

Type: object

Navigations links

Show Source

self: object self

{
    "type":"object",
    "description":"Navigations links",
    "properties":{
        "self":{
            "type":"object",
            "allOf":[
                {
                    "$ref":"#/components/schemas/Link"
                }
            ]
        }
    },
    "example":{
        "self":{
            "href":"/em/api/targets/CF99A10F233254B78ED96ED1B5C15140/metricGroups/Filesystems"
        }
    }
}

Example:

{
    "self":{
        "href":"/em/api/targets/CF99A10F233254B78ED96ED1B5C15140/metricGroups/Filesystems"
    }
}

Nested Schema : metrics

Type: array

(Optional) List of metrics present in this metric group. Included if query parameter include=metrics is specified.

Show Source

Array of: object Metric

Metric metadata

{
    "type":"array",
    "description":"(Optional) List of metrics present in this metric group. Included if query parameter include=metrics is specified.",
    "items":{
        "$ref":"#/components/schemas/Metric"
    },
    "example":[
        {
            "id":"6E65075DA52ACA744B4B8C3FCB018289",
            "name":"pctAvailable",
            "displayName":"Filesystem Space Available (%)",
            "dataType":"NUMBER",
            "categoryName":"Utilization",
            "unitDisplayName":"%"
        },
        {
            "id":"162045AD9191652427CAC47D8BA40671",
            "name":"size",
            "displayName":"Filesystem Size (MB)",
            "dataType":"NUMBER",
            "unitDisplayName":"MB"
        },
        {
            "id":"E8838C71E687BF0A9E02FFACC0C9AC80",
            "name":"available",
            "displayName":"Filesystem Space Available (MB)",
            "dataType":"NUMBER",
            "categoryName":"Utilization",
            "unitDisplayName":"MB"
        },
        {
            "id":"C80F6EAA9145C76D30DE8705346D5AAA",
            "name":"fileSystem",
            "displayName":"Filesystem",
            "dataType":"STRING"
        }
    ]
}

Example:

[
    {
        "id":"6E65075DA52ACA744B4B8C3FCB018289",
        "name":"pctAvailable",
        "displayName":"Filesystem Space Available (%)",
        "dataType":"NUMBER",
        "categoryName":"Utilization",
        "unitDisplayName":"%"
    },
    {
        "id":"162045AD9191652427CAC47D8BA40671",
        "name":"size",
        "displayName":"Filesystem Size (MB)",
        "dataType":"NUMBER",
        "unitDisplayName":"MB"
    },
    {
        "id":"E8838C71E687BF0A9E02FFACC0C9AC80",
        "name":"available",
        "displayName":"Filesystem Space Available (MB)",
        "dataType":"NUMBER",
        "categoryName":"Utilization",
        "unitDisplayName":"MB"
    },
    {
        "id":"C80F6EAA9145C76D30DE8705346D5AAA",
        "name":"fileSystem",
        "displayName":"Filesystem",
        "dataType":"STRING"
    }
]

Nested Schema : MetricKey

Type: object

Metric key metadata

Show Source

displayName(required): string

Key display name

Example: Mount Point
name(required): string

Maximum Length: 64

Key name

Example: mountPoint

{
    "type":"object",
    "description":"Metric key metadata",
    "required":[
        "name",
        "displayName"
    ],
    "properties":{
        "name":{
            "type":"string",
            "maxLength":64,
            "description":"Key name",
            "example":"mountPoint"
        },
        "displayName":{
            "type":"string",
            "description":"Key display name",
            "example":"Mount Point"
        }
    }
}

Nested Schema : self

Type: object

Match All

Show Source

object Link

A link

{
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/Link"
        }
    ]
}

Nested Schema : Link

Type: object

A link

Show Source

href(required): string

URL for link

{
    "description":"A link",
    "type":"object",
    "required":[
        "href"
    ],
    "properties":{
        "href":{
            "type":"string",
            "description":"URL for link"
        }
    }
}

Nested Schema : Metric

Type: object

Metric metadata

Show Source

categoryDisplayName: string

Metric Category Display Name

Example: Utilization
categoryName: string

Metric Category Name

Example: Utilization
dataType(required): string

Allowed Values: [ "NUMBER", "STRING" ]

Metric Data type. Its enumerated values could be expanded over time. If an unknown value is encountered, treat it as STRING for compatibility.

Example: NUMBER
displayName(required): string

Metric Display Name

Example: Filesystem Size (MB)
id(required): string

Maximum Length: 32

Metric ID

Example: E8838C71E687BF0A9E02FFACC0C9AC80
name(required): string

Maximum Length: 64

Metric Name

Example: size
unitDisplayName: string

Metric Unit Display Name

Example: MB

{
    "type":"object",
    "description":"Metric metadata",
    "required":[
        "id",
        "name",
        "displayName",
        "dataType"
    ],
    "properties":{
        "id":{
            "type":"string",
            "maxLength":32,
            "description":"Metric ID",
            "example":"E8838C71E687BF0A9E02FFACC0C9AC80"
        },
        "name":{
            "type":"string",
            "maxLength":64,
            "description":"Metric Name",
            "example":"size"
        },
        "displayName":{
            "type":"string",
            "description":"Metric Display Name",
            "example":"Filesystem Size (MB)"
        },
        "categoryName":{
            "type":"string",
            "description":"Metric Category Name",
            "example":"Utilization"
        },
        "categoryDisplayName":{
            "type":"string",
            "description":"Metric Category Display Name",
            "example":"Utilization"
        },
        "dataType":{
            "type":"string",
            "description":"Metric Data type. Its enumerated values could be expanded over time. If an unknown value is encountered, treat it as STRING for compatibility.",
            "enum":[
                "NUMBER",
                "STRING"
            ],
            "example":"NUMBER"
        },
        "unitDisplayName":{
            "type":"string",
            "description":"Metric Unit Display Name",
            "example":"MB"
        }
    }
}

Examples

400 Response

Bad Request

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an Error

Show Source

code(required): string

customer facing error code
details: array details

(Optional) List of additional details for the errors found.
message(required): string

customer facing error description

{
    "description":"Response sent back in the case of an Error",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"customer facing error code"
        },
        "message":{
            "type":"string",
            "description":"customer facing error description"
        },
        "details":{
            "type":"array",
            "description":"(Optional) List of additional details for the errors found.",
            "items":{
                "$ref":"#/components/schemas/ErrorDetail"
            }
        }
    }
}

Nested Schema : details

Type: array

(Optional) List of additional details for the errors found.

Show Source

Array of: object ErrorDetail

listed as part of ErrorResponse

{
    "type":"array",
    "description":"(Optional) List of additional details for the errors found.",
    "items":{
        "$ref":"#/components/schemas/ErrorDetail"
    }
}

Nested Schema : ErrorDetail

Type: object

listed as part of ErrorResponse

Show Source

message(required): string

specific error description

{
    "description":"listed as part of ErrorResponse",
    "type":"object",
    "required":[
        "message"
    ],
    "properties":{
        "message":{
            "type":"string",
            "description":"specific error description"
        }
    }
}

401 Response

Client is not authenticated

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an Error

Show Source

code(required): string

customer facing error code
details: array details

(Optional) List of additional details for the errors found.
message(required): string

customer facing error description

{
    "description":"Response sent back in the case of an Error",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"customer facing error code"
        },
        "message":{
            "type":"string",
            "description":"customer facing error description"
        },
        "details":{
            "type":"array",
            "description":"(Optional) List of additional details for the errors found.",
            "items":{
                "$ref":"#/components/schemas/ErrorDetail"
            }
        }
    }
}

Nested Schema : details

Type: array

(Optional) List of additional details for the errors found.

Show Source

Array of: object ErrorDetail

listed as part of ErrorResponse

{
    "type":"array",
    "description":"(Optional) List of additional details for the errors found.",
    "items":{
        "$ref":"#/components/schemas/ErrorDetail"
    }
}

Nested Schema : ErrorDetail

Type: object

listed as part of ErrorResponse

Show Source

message(required): string

specific error description

{
    "description":"listed as part of ErrorResponse",
    "type":"object",
    "required":[
        "message"
    ],
    "properties":{
        "message":{
            "type":"string",
            "description":"specific error description"
        }
    }
}

404 Response

Resource not found or not authorized for access

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an Error

Show Source

code(required): string

customer facing error code
details: array details

(Optional) List of additional details for the errors found.
message(required): string

customer facing error description

{
    "description":"Response sent back in the case of an Error",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"customer facing error code"
        },
        "message":{
            "type":"string",
            "description":"customer facing error description"
        },
        "details":{
            "type":"array",
            "description":"(Optional) List of additional details for the errors found.",
            "items":{
                "$ref":"#/components/schemas/ErrorDetail"
            }
        }
    }
}

Nested Schema : details

Type: array

(Optional) List of additional details for the errors found.

Show Source

Array of: object ErrorDetail

listed as part of ErrorResponse

{
    "type":"array",
    "description":"(Optional) List of additional details for the errors found.",
    "items":{
        "$ref":"#/components/schemas/ErrorDetail"
    }
}

Nested Schema : ErrorDetail

Type: object

listed as part of ErrorResponse

Show Source

message(required): string

specific error description

{
    "description":"listed as part of ErrorResponse",
    "type":"object",
    "required":[
        "message"
    ],
    "properties":{
        "message":{
            "type":"string",
            "description":"specific error description"
        }
    }
}

500 Response

Internal Server Error

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an Error

Show Source

code(required): string

customer facing error code
details: array details

(Optional) List of additional details for the errors found.
message(required): string

customer facing error description

{
    "description":"Response sent back in the case of an Error",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"customer facing error code"
        },
        "message":{
            "type":"string",
            "description":"customer facing error description"
        },
        "details":{
            "type":"array",
            "description":"(Optional) List of additional details for the errors found.",
            "items":{
                "$ref":"#/components/schemas/ErrorDetail"
            }
        }
    }
}

Nested Schema : details

Type: array

(Optional) List of additional details for the errors found.

Show Source

Array of: object ErrorDetail

listed as part of ErrorResponse

{
    "type":"array",
    "description":"(Optional) List of additional details for the errors found.",
    "items":{
        "$ref":"#/components/schemas/ErrorDetail"
    }
}

Nested Schema : ErrorDetail

Type: object

listed as part of ErrorResponse

Show Source

message(required): string

specific error description

{
    "description":"listed as part of ErrorResponse",
    "type":"object",
    "required":[
        "message"
    ],
    "properties":{
        "message":{
            "type":"string",
            "description":"specific error description"
        }
    }
}

503 Response

Indicates that a required service is not available

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an Error

Show Source

code(required): string

customer facing error code
details: array details

(Optional) List of additional details for the errors found.
message(required): string

customer facing error description

{
    "description":"Response sent back in the case of an Error",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"customer facing error code"
        },
        "message":{
            "type":"string",
            "description":"customer facing error description"
        },
        "details":{
            "type":"array",
            "description":"(Optional) List of additional details for the errors found.",
            "items":{
                "$ref":"#/components/schemas/ErrorDetail"
            }
        }
    }
}

Nested Schema : details

Type: array

(Optional) List of additional details for the errors found.

Show Source

Array of: object ErrorDetail

listed as part of ErrorResponse

{
    "type":"array",
    "description":"(Optional) List of additional details for the errors found.",
    "items":{
        "$ref":"#/components/schemas/ErrorDetail"
    }
}

Nested Schema : ErrorDetail

Type: object

listed as part of ErrorResponse

Show Source

message(required): string

specific error description

{
    "description":"listed as part of ErrorResponse",
    "type":"object",
    "required":[
        "message"
    ],
    "properties":{
        "message":{
            "type":"string",
            "description":"specific error description"
        }
    }
}