hostgroup.massadd

Opis

object hostgroup.massadd(object parameters)

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

Ta metoda jest dostępna tylko dla typów użytkowników Admin i Super admin. Uprawnienia do wywołania 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 grup hostów do zaktualizowania oraz obiekty do dodania do wszystkich grup hostów.

Metoda akceptuje następujące parametry.

Parametr Type Opis
groups object/array Grupy hostów, które mają zostać zaktualizowane.

Grupy hostów muszą mieć zdefiniowaną tylko właściwość groupid.

Zachowanie parametrów:
- wymagane
hosts object/array Hosty do dodania do wszystkich grup hostów.

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

Zwracane wartości

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

Przykłady

Dodawanie hostów do grup hostów

Dodaj dwa hosty do grup hostów o identyfikatorach 5 i 6.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.massadd",
    "params": {
        "groups": [
            {
                "groupid": "5"
            },
            {
                "groupid": "6"
            }
        ],
        "hosts": [
            {
                "hostid": "30050"
            },
            {
                "hostid": "30001"
            }
        ]
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "5",
            "6"
        ]
    },
    "id": 1
}

Zobacz także

Źródło

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