map.create

Opis

object map.create(object/array maps)

Ta metoda umożliwia tworzenie nowych map.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w Rolach użytkowników.

Parametry

(object/array) Mapy do utworzenia.

Oprócz standardowych właściwości mapy, metoda akceptuje następujące parametry.

Parametr Typ Opis
links array Łącza mapy do utworzenia na mapie.
selements array Elementy mapy do utworzenia na mapie.
urls array Adresy URL mapy do utworzenia na mapie.
users array Udostępnienia użytkownikowi mapy do utworzenia na mapie.
userGroups array Udostępnienia grupie użytkowników mapy do utworzenia na mapie.
shapes array Kształty mapy do utworzenia na mapie.
lines array Linie mapy do utworzenia na mapie.

Aby utworzyć łącza mapy, należy ustawić selementid elementu mapy na dowolną wartość, a następnie użyć tej wartości do odwołania się do tego elementu we właściwościach łączy selementid1 lub selementid2. Po utworzeniu elementu wartość ta zostanie zastąpiona poprawnym identyfikatorem wygenerowanym przez Zabbix. Zobacz przykład.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory utworzonych map we właściwości sysmapids. Kolejność zwróconych identyfikatorów odpowiada kolejności przekazanych map.

Przykłady

Utwórz pustą mapę

Utwórz mapę bez elementów.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Map",
        "width": 600,
        "height": 600
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "8"
        ]
    },
    "id": 1
}

Utwórz mapę hostów

Utwórz mapę z dwoma elementami hostów i łączem między nimi. Zwróć uwagę na użycie tymczasowych wartości „selementid1” i „selementid2” w obiekcie łącza mapy do odwoływania się do elementów mapy.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Host map",
        "width": 600,
        "height": 600,
        "selements": [
            {
                "selementid": "1",
                "elements": [
                    {"hostid": "1033"}
                ],
                "elementtype": 0,
                "iconid_off": "2"
            },

            {
                "selementid": "2",
                "elements": [
                    {"hostid": "1037"}
                ],
                "elementtype": 0,
                "iconid_off": "2"
            }
        ],
        "links": [
            {
                "selementid1": "1",
                "selementid2": "2"
            }
        ]
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "9"
        ]
    },
    "id": 1
}

Utwórz mapę wyzwalaczy

Utwórz mapę z elementem wyzwalacza, który zawiera dwa wyzwalacze.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Mapa wyzwalaczy",
        "width": 600,
        "height": 600,
        "selements": [
            {
                "elements": [
                    {"triggerid": "12345"},
                    {"triggerid": "67890"}
                ],
                "elementtype": 2,
                "iconid_off": "2"
            }
        ]
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "10"
        ]
    },
    "id": 1
}

Udostępnianie mapy

Utwórz mapę z dwoma typami udostępniania (użytkownik i grupa użytkowników).

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Map sharing",
        "width": 600,
        "height": 600,
        "users": [
            {
                "userid": "4",
                "permission": "3"
            }
        ],
        "userGroups": [
            {
                "usrgrpid": "7",
                "permission": "2"
            }
        ]
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "9"
        ]
    },
    "id": 1
}

Kształty mapy

Utwórz mapę z tytułem będącym nazwą mapy.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Host map",
        "width": 600,
        "height": 600,
        "shapes": [
            {
                "type": 0,
                "x": 0,
                "y": 0,
                "width": 600,
                "height": 11,
                "text": "{MAP.NAME}"
            }
        ]
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "10"
        ]
    },
    "id": 1
}

Linie mapy

Utwórz linię mapy.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Map API lines",
        "width": 500,
        "height": 500,
        "lines": [
            {
                "x1": 30,
                "y1": 10,
                "x2": 100,
                "y2": 50,
                "line_type": 1,
                "line_width": 10,
                "line_color": "009900"
            }
        ]
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "11"
        ]
    },
    "id": 1
}

Zobacz także

Źródło

CMap::create() w ui/include/classes/api/services/CMap.php.