This is a translation of the original English documentation page. Help us make it better.

פריט.קבל

תיאור

integer/array item.get(object parameters)

השיטה מאפשרת לשלוף פריטים לפי הפרמטרים הנתונים.

שיטה זו זמינה למשתמשים מכל סוג. הרשאות כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה משתמש תפקידים למידע נוסף.

תיאור

integer/array item.get(object parameters)

השיטה מאפשרת לשלוף פריטים לפי הפרמטרים הנתונים.

שיטה זו זמינה למשתמשים מכל סוג. הרשאות כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה משתמש תפקידים למידע נוסף.

החזר ערכים

(מספר שלם/מערך) מחזיר אחד:

  • מערך של חפצים;
  • ספירת האובייקטים שאוחזרו, אם יש לפרמטר countOutput נעשה שימוש.

דוגמאות

החזר ערכים

(מספר שלם/מערך) מחזיר אחד:

  • מערך של חפצים;
  • ספירת האובייקטים שאוחזרו, אם יש לפרמטר countOutput נעשה שימוש.

מציאת פריטים תלויים לפי מפתח

אחזר את כל הפריטים התלויים מהמארח עם המזהה "10116" עם המילה "apache" במפתח.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "item.get",
            "params": {
                "output": "להרחיב",
                "hostids": "10116",
                "לחפש": {
                    "key_": "apache"
                },
                "מסנן": {
                    "סוג": 18
                }
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": [
                {
                    "itemid": "25550",
                    "type": "18",
                    "snmp_oid": "",
                    "hostid": "10116",
                    "name": "ימים",
                    "key_": "apache.status.uptime.days",
                    "delay": "0",
                    "history": "90d",
                    "trends": "365d",
                    "status": "0",
                    "value_type": "3",
                    "trapper_hosts": "",
                    "יחידות": "",
                    "logtimefmt": "",
                    "templateid": "0",
                    "valuemapid": "0",
                    "params": "",
                    "ipmi_sensor": "",
                    "authtype": "0",
                    "שם משתמש": "",
                    "סיסמה": "",
                    "מפתח ציבורי": "",
                    "מפתח פרטי": "",
                    "flags": "0",
                    "interfaceid": "0",
                    "תיאור": "",
                    "inventory_link": "0",
                    "evaltype": "0",
                    "jmx_endpoint": "",
                    "master_itemid": "25545",
                    "timeout": "3 שניות",
                    "url": "",
                    "query_fields": [],
                    "פוסטים": "",
                    "status_codes": "200",
                    "follow_redirects": "1",
                    "post_type": "0",
                    "http_proxy": "",
                    "כותרות": [],
                    "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",
                    "uuid": "",
                    "state": "0",
                    "error": "",
                    "פרמטרים": [],
                    "lastclock": "0",
                    "lastns": "0",
                    "lastvalue": "0",
                    "prevvalue": "0"
                },
                {
                    "itemid": "25555",
                    "type": "18",
                    "snmp_oid": "",
                    "hostid": "10116",
                    "name": "שעות",
                    "key_": "apache.status.uptime.hours",
                    "delay": "0",
                    "history": "90d",
                    "trends": "365d",
                    "status": "0",
                    "value_type": "3",
                    "trapper_hosts": "",
                    "יחידות": "",
                    "logtimefmt": "",
                    "templateid": "0",
                    "valuemapid": "0",
                    "params": "",
                    "ipmi_sensor": "",
                    "authtype": "0",
                    "שם משתמש": "",
                    "סיסמה": "",
                    "מפתח ציבורי": "",
                    "מפתח פרטי": "",
                    "flags": "0",
                    "interfaceid": "0",
                    "תיאור": "",
                    "inventory_link": "0",
                    "evaltype": "0",
                    "jmx_endpoint": "",
                    "master_itemid": "25545",
                    "timeout": "3 שניות",
                    "url": "",
                    "query_fields": [],
                    "פוסטים": "",
                    "status_codes": "200",
                    "follow_redirects": "1",
                    "post_type": "0",
                    "http_proxy": "",
                    "כותרות": [],
                    "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",
                    "uuid": "",
                    "state": "0",
                    "error": "",
                    "פרמטרים": [],
                    "lastclock": "0",
                    "lastns": "0",
                    "lastvalue": "0",
                    "prevvalue": "0"
                }
            ],
            "מזהה": 1
       }

מצא פריט סוכן HTTP

מצא פריט סוכן HTTP עם סוג גוף הפוסט XML עבור מזהה מארח ספציפי.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "item.get",
            "params": {
                "hostids": "10255",
                "מסנן": {
                    "סוג": 19,
                    "post_type": 3
                }
            },
            "מזהה": 3,
            "auth": "d678e0b85688ce578ff061bd29a20d3b"
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": [
                {
                    "itemid": "28252",
                    "type": "19",
                    "snmp_oid": "",
                    "hostid": "10255",
                    "name": "פריט תבנית",
                    "key_": "ti",
                    "delay": "30s",
                    "history": "90d",
                    "trends": "365d",
                    "status": "0",
                    "value_type": "3",
                    "trapper_hosts": "",
                    "יחידות": "",
                    "logtimefmt": "",
                    "templateid": "0",
                    "valuemapid": "0",
                    "params": "",
                    "ipmi_sensor": "",
                    "authtype": "0",
                    "שם משתמש": "",
                    "סיסמה": "",
                    "מפתח ציבורי": "",
                    "מפתח פרטי": "",
                    "flags": "0",
                    "interfaceid": "0",
                    "תיאור": "",
                    "inventory_link": "0",
                    "evaltype": "0",
                    "jmx_endpoint": "",
                    "master_itemid": "0",
                    "timeout": "3 שניות",
                    "url": "localhost",
                    "query_fields": [
                        {
                            "mode": "xml"
                        }
                    ],
                    "posts": "<body>\r\n<![CDATA[{$MACRO}<foo></bar>]]>\r\n</body>",
                    "status_codes": "200",
                    "follow_redirects": "0",
                    "post_type": "3",
                    "http_proxy": "",
                    "כותרות": [],
                    "retrieve_mode": "1",
                    "request_method": "3",
                    "output_format": "0",
                    "ssl_cert_file": "",
                    "ssl_key_file": "",
                    "ssl_key_password": "",
                    "verify_peer": "0",
                    "verify_host": "0",
                    "allow_traps": "0",
                    "uuid": "",
                    "state": "0",
                    "error": "",
                    "פרמטרים": [],
                    "lastclock": "0",
                    "lastns": "0",
                    "lastvalue": "",
                    "prevvalue": ""
                }
            ],
            "מזהה": 3
       }

אחזור פריטים עם כללי עיבוד מקדים

אחזר את כל הפריטים וכללי העיבוד המקדים שלהם עבור מזהה מארח ספציפי.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "item.get",
            "params": {
                "output": ["itemid", "name", "key_"],
                "selectPreprocessing": "להרחיב",
                "hostids": "10254"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "itemid": "23865",
                "name": "דוגמה לסוכן HTTP JSON",
                "key_": "json",
                "עיבוד מקדים": [
                    {
                        "type": "12",
                        "params": "$.random",
                        "error_handler": "1",
                        "error_handler_params": ""
                    }
                ]
            },
            "מזהה": 1
       }

מידע נוסף

מקור

CItem::get()‎ בתוך ui/include/classes/api/services/CItem.php.