KSC API, как изменить тег на устройстве?

[Александр Мелёшкин]

Привет! Пытаюсь автоматизировать удаление тегов с выводящихся из эксплуатации устройств и не получается. Использую описание https://support.kaspersky.com/help/KSC/14.2/KSCAPI/a00538_adf01d37bd62ad12a67d62d536cbad430.html#adf01d37bd62ad12a67d62d536cbad430

Выполняю HTTP POST запрос к ".../api/v1.0/HostsTags.ListTags.SetTags" с содержимым тела

{
    "pListItemsTags":  [
                           {
                               "value":  {
                                             "KLTAGS_TAGS":  {
                                                                 "value":  [
                                                                               {
                                                                                   "KLTAGS_VALUE":  "Notebook",
                                                                                   "KLTAGS_SET":  "false"
                                                                               }
                                                                           ],
                                                                 "type":  "params"
                                                             },
                                             "KLTAGS_ITEM_ID":  "4a3e66be-0a81-4b1d-b4e0-fbb5f823bbc7"
                                         },
                               "type":  "params"
                           }
                       ]
}

А в ответ получаю ошибку:

code    : 1192
file    : c:\a\c\g_a9ez0wzv\s\product\osmp\ksc\dev\kloapi\contentstream\sax_handler.cpp
line    : 314
message : Field 'type' is not found for the value with name:
module  : KLSTD
subcode : 0

Что я делаю не так?

Спасибо.

[Aleksey Klenin]

Добрый день!

Столкнулся с точно такой же проблемой. Не нашли решение?
 

У меня структура немного другая, но результат такой же.

Имхо, вы структуру не ту указали "KLTAGS_TAGS" - там обычный params, а не paramPapams, поэтому не надо указывать type-value.

{
  "pListItemsTags": [
    {
      "value": {
        "KLTAGS_TAGS": [
          {
            "KLTAGS_SET": "True",
            "KLTAGS_VALUE": "EXCLUDED"
          }
        ],
        "KLTAGS_ITEM_ID": "345235BDC693C2CCD9174F1ECC68105C"
      },
      "type": "params"
    }
  ]
}

[Александр Мелёшкин]

Алексей, я пошёл другим путём: настроил правила автоматического назначения группы администрирования для компьютера (Выполнять один раз для каждого устройства и при каждой установке Агента) и удаляю компьютер с сервера. Удалять надо 2 раза, т.к. в первый раз УЗ компа падает в Нераспределённые (если уже был в Нераспределённых, то он удаляется), а со второго раза удаляется.

[Aleksey Klenin]

Александр, спасибо!

Да, так тоже можно, но я попробую API победить все-таки. В ТП запрос кинул.
Если найду решение - отпишусь, для закрытия гештальта.

[Aleksey Klenin]

Решение нашлось, пришлось внимательно посмотреть исходники на Python, налицо несоответствие в документации, там для KLTAGS_TAGS указан тип params, а не paramParams.
Рабочий Body:

{
  "pListItemsTags": [
    {
      "type": "params",
      "value": {
        "KLTAGS_ITEM_ID": "345235BDC693C2CCD9174F1ECC68105C",
        "KLTAGS_TAGS": [
          {
            "type": "params",
            "value": {
              "KLTAGS_VALUE": "TagName",
              "KLTAGS_SET": true
            }
          }
        ]
      }
    }
  ]
}

Или на Powershell:

 $body = @{

        "pListItemsTags" = @(

            @{

                "value" = @{

                    "KLTAGS_ITEM_ID" = "$HostName"

                    "KLTAGS_TAGS"    = @(

                        @{

                            "value" = @{

                                "KLTAGS_VALUE" = "$Tag"

                                "KLTAGS_SET"   = $true

                            }

                            "type"  = "params"

                        }

                    )

                }

                "type"  = "params"

            }

        )

    } | ConvertTo-Json -Depth 6

[Demiad]

@Aleksey Klenin, добрый день. Спасибо, Георгий дополнительно переслал мне сообщение от вас, справку коллеги поправят, обращение на это зарегистрировал.

[Aleksey Klenin]

Уточню информацию по поводу запросов, отправляемых из Powershell, поскольку столкнулся с периодически отображаемыми ошибками:
@{code=1192; file=/home/builder/a/c/d_00000000/s/product/osmp/ksc/dev/kloapi/contentstream/sax_handler.cpp; line=316; message=Field 'type' is not found for the value with name: value; module=KLSTD; subcode=0}

Для KSC Open API важен порядок следования полей для объекта типа paramParams.
Требуется, чтобы сперва шло поле type, а лишь затем value.
Поэтому, необходимо указать их именно в такой последовательности, а также для хеш-таблиц указать атрибут [ordered] (по умолчанию хеш-таблицы без сортировки), иначе после конвертации в Json порядок следования полей может меняться:

    $body = @{

        "pListItemsTags" = @(

            [ordered]@{

                "type"  = "params"

                "value" = @{

                    "KLTAGS_ITEM_ID" = "$HostName"

                    "KLTAGS_TAGS"    = @(

                        [ordered]@{

                            "type"  = "params"

                            "value" = @{

                                "KLTAGS_VALUE" = "$Tag"

                                "KLTAGS_SET"   = $true

                            }

                        }

                    )

                }  

            }

        )

    } | ConvertTo-Json -Depth 6