Description
Returns an object from the database referenced by its name field.
Parameters
Name | Description |
---|---|
includeHA |
Location: query Type: boolean An optional boolean flag for REST calls that sets the level of detail when
retrieving xHA pair server objects. Polling the xHA status of paired servers
during a search can cause delays, or connection timeouts if a server is
unreachable. When the parameter is set to true, the returned
xHA server object will include details for the xHA status of the nodes.
When set to false, the returned xHA server object will include
only basic information without polling xHA status of the servers. The default
value if omitted is true.
|
name |
Location: query Type: string The name of the target object.
|
parentId |
Location: query Type: integer (int64) The ID of the target object’s parent object.
|
type |
Location: query Type: string The type of object returned by the method. This string must be one of the
constants listed in
Object types.
|
Responses
Code | Description |
---|---|
200 |
Type: APIEntity Returns an object that matches the name. If there are multiple objects matching the name, the method returns the first in the list. An object with null values is returned if there are no matching objects.
|