List targets
get
https://EM_HOST:8080/em/api/targets
This api returns a list of targets filtered with the given criteria.
Request
Query Parameters
-
displayName: array[string]
display name of the target
-
displayNameMatches: array[string]
display name pattern of the target
-
exclude: string
an excludeId with comma-separated list of bind variables. This uses a registered sql query to exclude targets from the result set. This is supporting EM console UI.Example:
notThisTypeExcludeId,host
-
include: string
a comma-separated list which indicates if status or total number of results shall be returned. Valid values are targetStatus and total.Example:
targetStatus,total
-
limit: integer(int32)
Minimum Value:
1
Maximum Value:2000
to limit the number of rows returned. If the result set is greater follow the previous and next links in the results.Example:20
-
name: array[string]
name of the target
-
nameMatches: array[string]
name pattern of the targetExample:
my_target_%
-
owner: array[string]
owner of the target
-
page: string
system generated page token used in the self, next and previous links.
-
sort: string
A comma-separated list of sort field and direction. Allowed sort fields are name, type, displayName, typeDisplayName, owner and status. Allowed directions are DESC and ASCExample:
type:ASC,name:DESC
-
status: array[]
the status of the target
-
typeDisplayName: array[string]
type display name in the client locale
-
typeDisplayNameMatches: array[string]
type display name pattern in the client locale
-
typeName: array[string]
type of the target
-
typeNameMatches: array[string]
type pattern
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
OK
Root Schema : TargetCollection
Type:
object
This is the representation of list of target references.
Show Source
-
count(required): integer
the number of items in this pageExample:
20
-
items(required): array
items
the target references
-
links(required): object
links
the result set navigation links
-
total: integer
the total number of resultsExample:
42
Nested Schema : items
Type:
array
the target references
Show Source
-
Array of:
object TargetSummary
This is a target reference.
Nested Schema : TargetSummary
Type:
object
This is a target reference.
Show Source
-
displayName(required): string
the display of the targetExample:
My Database Instance
-
id(required): string
the target ifExample:
D91786E288D35455C3ADA1B329B49BB5
-
links: object
links
the target related links
-
name(required): string
the target nameExample:
my_database
-
owner(required): string
the owner of the targetExample:
scott
-
status: string
Allowed Values:
[ "DOWN", "UP", "METRIC_ERROR", "AGENT_DOWN", "UNREACHABLE", "BLACKOUT", "PENDING", "REMOTE_HOST_UNREACHABLE" ]
This is the representation of a target status. -
typeDisplayName(required): string
the type display name of the targetExample:
Datenbankinstanz
-
typeName: string
the target type nameExample:
oracle_database
Nested Schema : Link
Type:
object
Represents a link(could be self, previous or next)
Show Source
-
href: string
URL for LinkExample:
/em/api/<resources>?page=b2Zmc2V0OjA&limit=0
400 Response
in the case of illegal arguments like unsupported sort direction
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
401 Response
client is not authenticated
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
500 Response
internal error serving the request
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
503 Response
indicates that a required service is not available.
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string