host.massadd

Opis

object host.massadd(object parameters)

Ta metoda umożliwia jednoczesne dodanie wielu powiązanych obiektów do wszystkich podanych hostów.

Ta metoda jest dostępna tylko dla typów użytkowników Admin i Super admin. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

(object) Parametry zawierające identyfikatory hostów do zaktualizowania oraz obiekty do dodania do wszystkich hostów.

Metoda akceptuje następujące parametry.

Parametr Type Opis
hosts object/array Hosty do zaktualizowania.

Hosty muszą mieć zdefiniowaną wyłącznie właściwość hostid.

Zachowanie parametrów:
- wymagane
groups object/array Grupy hostów do dodania do podanych hostów.

Grupy hostów muszą mieć zdefiniowaną wyłącznie właściwość groupid.
interfaces object/array Interfejsy hostów do utworzenia dla podanych hostów.
macros object/array Makra użytkownika do utworzenia dla podanych hostów.
templates object/array Szablony do podłączenia do podanych hostów.

Szablony muszą mieć zdefiniowaną wyłącznie właściwość templateid.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych hostów we właściwości hostids.

Przykłady

Dodawanie makr

Dodaj dwa nowe makra do dwóch hostów.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "host.massadd",
    "params": {
        "hosts": [
            {
                "hostid": "10160"
            },
            {
                "hostid": "10167"
            }
        ],
        "macros": [
            {
                "macro": "{$TEST1}",
                "value": "MACROTEST1"
            },
            {
                "macro": "{$TEST2}",
                "value": "MACROTEST2",
                "description": "Opis testowy"
            }
        ]
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10160",
            "10167"
        ]
    },
    "id": 1
}

Zobacz także

Źródło

CHost::massAdd() w ui/include/classes/api/services/CHost.php.