[comment]: # ({8246351f-8246351f})
# datenpunktprototyp.get

[comment]: # ({/8246351f-8246351f})

[comment]: # ({a7f55ee1-5f97ef4a})
### Beschreibung

`integer/array itemprototype.get(object parameters)`

Mit dieser Methode können Datenpunkt-Prototypen entsprechend den angegebenen
Parametern abgerufen werden.

::: noteclassic
Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen
zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/a7f55ee1-5f97ef4a})

[comment]: # ({3de42ad3-8d6ecc79})
### Parameter

`(object)` Parameter, die die gewünschte Ausgabe definieren.

Die Methode unterstützt die folgenden Parameter.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|discoveryids|ID/array|Gibt nur Datenpunkt-Prototypen zurück, die zu den angegebenen LLD-Regeln gehören.|
|graphids|ID/array|Gibt nur Datenpunkt-Prototypen zurück, die in den angegebenen Graph-Prototypen verwendet werden.|
|hostids|ID/array|Gibt nur Datenpunkt-Prototypen zurück, die zu den angegebenen Hosts gehören.|
|inherited|boolean|Wenn auf `true` gesetzt, werden nur Datenpunkt-Prototypen zurückgegeben, die von einer Vorlage geerbt wurden.|
|itemids|ID/array|Gibt nur Datenpunkt-Prototypen mit den angegebenen IDs zurück.|
|monitored|boolean|Wenn auf `true` gesetzt, werden nur aktivierte Datenpunkt-Prototypen zurückgegeben, die zu überwachten Hosts gehören.|
|templated|boolean|Wenn auf `true` gesetzt, werden nur Datenpunkt-Prototypen zurückgegeben, die zu Vorlagen gehören.|
|templateids|ID/array|Gibt nur Datenpunkt-Prototypen zurück, die zu den angegebenen Vorlagen gehören.|
|triggerids|ID/array|Gibt nur Datenpunkt-Prototypen zurück, die in den angegebenen Auslöser-Prototypen verwendet werden.|
|selectDiscoveryData|query|Gibt eine `discoveryData`-Eigenschaft mit den Objektdaten der Datenpunkt-Prototyp-Erkennung zurück. Das Erkennungsobjekt des Datenpunkt-Prototyps verknüpft einen erkannten Datenpunkt-Prototyp mit einem Datenpunkt-Prototyp, aus dem er erkannt wurde.<br><br>Es hat die folgenden Eigenschaften:<br>`parent_itemid` - `(string)` ID des Datenpunkt-Prototyps, aus dem der Datenpunkt-Prototyp erstellt wurde;<br>`key_` - `(string)` Schlüssel des Datenpunkt-Prototyps;<br>`status` - `(int)` Erkennungsstatus des Datenpunkt-Prototyps:<br>0 - *(Standard)* Datenpunkt-Prototyp wurde erkannt,<br>1 - Datenpunkt-Prototyp wird nicht mehr erkannt;<br>`ts_delete` - `(timestamp)` Zeitpunkt, zu dem ein Datenpunkt-Prototyp, der nicht mehr erkannt wird, gelöscht wird;<br>`ts_disable` - `(timestamp)` Zeitpunkt, zu dem ein Datenpunkt-Prototyp, der nicht mehr erkannt wird, deaktiviert wird;<br>`disable_source` - `(int)` Kennzeichen dafür, ob der Datenpunkt-Prototyp durch eine LLD-Regel oder manuell deaktiviert wurde:<br>0 - *(Standard)* automatisch deaktiviert,<br>1 - durch eine LLD-Regel deaktiviert.|
|selectDiscoveryRule|query|Gibt eine [`discoveryRule`](/manual/api/reference/discoveryrule/object#lld-rule)-Eigenschaft mit der Low-Level-Discovery-Regel zurück, zu der der Datenpunkt-Prototyp gehört.|
|selectDiscoveryRulePrototype|query|Gibt eine [`discoveryRulePrototype`](/manual/api/reference/discoveryruleprototype/object)-Eigenschaft mit dem übergeordneten LLD-Regelprototyp zurück, zu dem der Datenpunkt-Prototyp gehört.|
|selectGraphs|query|Gibt eine [`graphs`](/manual/api/reference/graphprototype/object#graph-prototype)-Eigenschaft mit Graph-Prototypen zurück, in denen der Datenpunkt-Prototyp verwendet wird.<br><br>Unterstützt `count`.|
|selectHosts|query|Gibt eine [`hosts`](/manual/api/reference/host/object)-Eigenschaft mit einem Array von Hosts zurück, zu denen der Datenpunkt-Prototyp gehört.|
|selectInheritedTags|query|Gibt eine [`inheritedTags`](/manual/api/reference/itemprototype/object#item-prototype-tag)-Eigenschaft mit Tags zurück, die auf Vorlage/Host/verknüpften Vorlagen vorhanden sind.|
|selectTags|query|Gibt die Tags des Datenpunkt-Prototyps in der Eigenschaft [`tags`](/manual/api/reference/itemprototype/object#item-prototype-tag) zurück.|
|selectTriggers|query|Gibt eine [`triggers`](/manual/api/reference/triggerprototype/object#trigger-prototype)-Eigenschaft mit Auslöser-Prototypen zurück, in denen der Datenpunkt-Prototyp verwendet wird.<br><br>Unterstützt `count`.|
|selectPreprocessing|query|Gibt eine [`preprocessing`](/manual/api/reference/itemprototype/object#item-prototype-preprocessing)-Eigenschaft mit Vorverarbeitungsoptionen des Datenpunkt-Prototyps zurück.|
|selectValueMap|query|Gibt eine [`valuemap`](/manual/api/reference/valuemap/object)-Eigenschaft mit der Wertezuordnung des Datenpunkt-Prototyps zurück.|
|filter|object|Gibt nur die Ergebnisse zurück, die exakt dem angegebenen Filter entsprechen.<br><br>Akzeptiert ein Objekt, bei dem die Schlüssel Eigenschaftsnamen sind und die Werte entweder ein einzelner Wert oder ein Array von Werten sind, mit denen abgeglichen werden soll.<br><br>Unterstützt keine Eigenschaften vom `text`-[data type](/manual/api/reference_commentary#data-types).<br><br>Unterstützt zusätzliche Eigenschaften:<br>`host` - technischer Name des Hosts, zu dem der Datenpunkt-Prototyp gehört.|
|limitSelects|integer|Begrenzt die Anzahl der von Unterabfragen zurückgegebenen Datensätze.<br><br>Gilt für die folgenden Unterabfragen:<br>`selectGraphs` - Ergebnisse werden nach `name` sortiert;<br>`selectTriggers` - Ergebnisse werden nach `description` sortiert.|
|sortfield|string/array|Sortiert das Ergebnis nach den angegebenen Eigenschaften.<br><br>Mögliche Werte: `itemid`, `name`, `key_`, `delay`, `type`, `status`, `history`, `trends`, `discovered`.|
|countOutput|boolean|Diese Parameter werden in der [Referenzkommentierung](/manual/api/reference_commentary#common-get-method-parameters) beschrieben.|
|editable|boolean|^|
|excludeSearch|boolean|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/3de42ad3-8d6ecc79})

[comment]: # ({7223bab1-7223bab1})
### Rückgabewerte

`(integer/array)` Kann die folgenden Dinge zurück geben:

- ein Array von Objekten;
- die Anzahl der abgerufenen Objekte, wenn der Parameter `countOutput`
verwendet wurde.

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Beispiele

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({637433bd-92651f4c})
#### Abrufen von Datenpunkt-Prototypen aus einer LLD-Regel

Rufen Sie alle Datenpunkt-Prototypen für eine bestimmte LLD-Regel-ID ab.

[Anfrage](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "itemprototype.get",
    "params": {
        "output": "extend",
        "discoveryids": "27426"
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "itemid": "23077",
            "type": "0",
            "snmp_oid": "",
            "hostid": "10079",
            "name": "Incoming network traffic on en0",
            "key_": "net.if.in[en0]",
            "delay": "1m",
            "history": "1w",
            "trends": "365d",
            "status": "0",
            "value_type": "3",
            "trapper_hosts": "",
            "units": "bps",
            "formula": "",
            "logtimefmt": "",
            "templateid": "0",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "2",
            "interfaceid": "0",
            "description": "",
            "inventory_link": "0",
            "lifetime": "7d",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "timeout": "",
            "url": "",
            "query_fields": [],
            "posts": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "http_proxy": "",
            "headers": [],
            "retrieve_mode": "0",
            "request_method": "0",
            "output_format": "0",
            "ssl_cert_file": "",
            "ssl_key_file": "",
            "ssl_key_password": "",
            "verify_peer": "0",
            "verify_host": "0",
            "allow_traps": "0",
            "discover": "0",
            "uuid": "",
            "lifetime_type": "0",
            "enabled_lifetime_type": "2",
            "enabled_lifetime": "0",
            "parameters": []
        },
        {
            "itemid": "10010",
            "type": "0",
            "snmp_oid": "",
            "hostid": "10001",
            "name": "Processor load (1 min average per core)",
            "key_": "system.cpu.load[percpu,avg1]",
            "delay": "1m",
            "history": "1w",
            "trends": "365d",
            "status": "0",
            "value_type": "0",
            "trapper_hosts": "",
            "units": "",
            "formula": "",
            "logtimefmt": "",
            "templateid": "0",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "2",
            "interfaceid": "0",
            "description": "The processor load is calculated as system CPU load divided by number of CPU cores.",
            "inventory_link": "0",
            "lifetime": "7d",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "timeout": "",
            "url": "",
            "query_fields": [],
            "posts": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "http_proxy": "",
            "headers": [],
            "retrieve_mode": "0",
            "request_method": "0",
            "output_format": "0",
            "ssl_cert_file": "",
            "ssl_key_file": "",
            "ssl_key_password": "",
            "verify_peer": "0",
            "verify_host": "0",
            "allow_traps": "0",
            "discover": "0",
            "uuid": "",
            "lifetime_type": "0",
            "enabled_lifetime_type": "2",
            "enabled_lifetime": "0",
            "parameters": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/637433bd-92651f4c})

[comment]: # ({3c8f8511-acb23a7a})
#### Abhängigen Datenpunkt finden

Einen abhängigen Datenpunkt für eine bestimmte Datenpunkt-ID finden.

[Anfrage](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "itemprototype.get",
    "params": {
        "output": "extend",
        "filter": {
            "type": 18,
            "master_itemid": "25545"
        },
        "limit": "1"
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "itemid": "25547",
            "type": "18",
            "snmp_oid": "",
            "hostid": "10116",
            "name": "Seconds",
            "key_": "apache.status.uptime.seconds",
            "delay": "0",
            "history": "90d",
            "trends": "365d",
            "status": "0",
            "value_type": "3",
            "trapper_hosts": "",
            "units": "",
            "formula": "",
            "logtimefmt": "",
            "templateid": "0",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "0",
            "interfaceid": "0",
            "description": "",
            "inventory_link": "0",
            "lifetime": "7d",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "25545",
            "timeout": "",
            "url": "",
            "query_fields": [],
            "posts": "",
            "status_codes": "200",
            "follow_redirects": "1",
            "post_type": "0",
            "http_proxy": "",
            "headers": [],
            "retrieve_mode": "0",
            "request_method": "0",
            "output_format": "0",
            "ssl_cert_file": "",
            "ssl_key_file": "",
            "ssl_key_password": "",
            "verify_peer": "0",
            "verify_host": "0",
            "allow_traps": "0",
            "discover": "0",
            "uuid": "",
            "lifetime_type": "0",
            "enabled_lifetime_type": "2",
            "enabled_lifetime": "0",
            "parameters": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/3c8f8511-acb23a7a})

[comment]: # ({a9e7c7e6-18563427})
#### HTTP-Agent-Datenpunktprototyp finden

HTTP-Agent-Datenpunktprototyp mit der Anfragemethode HEAD für eine bestimmte Host-ID finden.

[Anfrage](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "itemprototype.get",
    "params": {
        "hostids": "10254",
        "filter": {
            "type": 19,
            "request_method": 3
        }
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "itemid": "28257",
            "type": "19",
            "snmp_oid": "",
            "hostid": "10254",
            "name": "discovered",
            "key_": "item[{#INAME}]",
            "delay": "{#IUPDATE}",
            "history": "90d",
            "trends": "30d",
            "status": "0",
            "value_type": "3",
            "trapper_hosts": "",
            "units": "",
            "formula": "",
            "logtimefmt": "",
            "templateid": "28255",
            "valuemapid": "0",
            "params": "",
            "ipmi_sensor": "",
            "authtype": "0",
            "username": "",
            "password": "",
            "publickey": "",
            "privatekey": "",
            "flags": "2",
            "interfaceid": "2",
            "description": "",
            "inventory_link": "0",
            "lifetime": "7d",
            "evaltype": "0",
            "jmx_endpoint": "",
            "master_itemid": "0",
            "timeout": "",
            "url": "{#IURL}",
            "query_fields": [],
            "posts": "",
            "status_codes": "",
            "follow_redirects": "0",
            "post_type": "0",
            "http_proxy": "",
            "headers": [],
            "retrieve_mode": "0",
            "request_method": "3",
            "output_format": "0",
            "ssl_cert_file": "",
            "ssl_key_file": "",
            "ssl_key_password": "",
            "verify_peer": "0",
            "verify_host": "0",
            "allow_traps": "0",
            "discover": "0",
            "uuid": "",
            "lifetime_type": "0",
            "enabled_lifetime_type": "2",
            "enabled_lifetime": "0",
            "parameters": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/a9e7c7e6-18563427})

[comment]: # ({784c3a3e-b9b138b8})
### Siehe auch

-   [Host](/manual/api/reference/host/object#host)
-   [Graph-Prototyp](/manual/api/reference/graphprototype/object#graph-prototype)
-   [Auslöser-Prototyp](/manual/api/reference/triggerprototype/object#trigger-prototype)

[comment]: # ({/784c3a3e-b9b138b8})

[comment]: # ({e1523143-e1523143})
### Quelle

CItemPrototype::get() in
*ui/include/classes/api/services/CItemPrototype.php*.

[comment]: # ({/e1523143-e1523143})