SyncSSIDAfterEdit - запустить асинхронный процесс исправления привязок в EMS после переименования SSID.

Общая информация

  1. Команда актуальна, начиная с версии 1.23

  2. Команда предназначена для запуска асинхронных задач по исправлению привязок для указанного SSID после редактирования имени SSID. Для того чтобы запустить исправление только одной привязки, необходимо указать NAS Key (ключ привязки SSID). Во избежание создания дополнительных SSID на точках, необходимо указать старое имя SSID (до переименования).

  3. Чтобы проверить статус процесса исправления привязок в EMS, используйте команду GetAsyncProcessStatus

  4. Если не указывать параметр oldName, команда работает аналогично SyncSSID

Входные параметры

Параметр Значение Формат значения Расшифровка формата

ssidName

Имя SSID

^[ a-zA-Z0-9_\-\.!]{1,32}$

Строка соответствующая регулярному выражению из колонки формат значения

ssidDomain

Домен SSID

FQDN

Домен в формате FQDN

nasKey

Опциональный параметр, ключ привязки SSID

^([0-9a-fA-F]{2}[:-]){0,5}([0-9a-fA-F]{2})$ или (?=^.{1,235}$)(^((?!-||.(__|--).)[a-zA-Z0-9-]{1,63}.)((?!-|_|.(_|--).*)[a-zA-Z0-9-]{1,63})$)

MAC-адрес или префикс MAC-адреса, домен или вложенный домен (например, '.test.root')

oldName

Опциональный параметр, старое имя SSID. Необходим при использовании команды после переименования SSID

Текст

Выходные параметры

Параметр Значение Формат значения

taskId

Идентификатор созданной асинхронной задачи

Положительное целое число или несколько чисел

code

Код ответа

Целое неотрицательное число.

detail

Пояснение к ответу

Текст английскими буквами с пробелами и спецсимволами.

Примеры команд и кодов

Код Описание

0

Успешно

3

Ошибка от сервиса NBI EMS

7

Не найден обязательный параметр запроса 'ssidDomain'

8

Нет домена или домен не соответствует правилам

10

Домен роли не имеет прав на домен SSID

16

SSID не существует

18

В конфигурации неверно настроен адрес EMS NBI или он недоступен

62

Домен не зарегистрирован

227

Имя SSID не задано или не удовлетворяет требованиям

Пример использования

Запрос

Запуск синхронизации привязки SSID ent_10@root в домене root после переименования ent_9 → ent_10.

<soap:Envelope>
   <soap:Header/>
   <soap:Body>
      <nbi:SyncSSIDAfterEdit>
         <nbi:ssidName>ent_10</nbi:ssidName>
         <nbi:ssidDomain>root</nbi:ssidDomain>
         <nbi:nasKey></nbi:nasKey>
         <nbi:oldName>ent_9</nbi:oldName>
      </nbi:SyncSSIDAfterEdit>
   </soap:Body>
</soap:Envelope>
Ответ
<soapenv:Envelope>
   <soapenv:Body>
      <ns:SyncSSIDAfterEditResponse>
            <ax21:code>0</ax21:code>
            <ax21:detail>Success</ax21:detail>
            <ax21:taskId>13</ax21:taskId>
         </ns:return>
      </ns:SyncSSIDAfterEditResponse>
   </soapenv:Body>
</soapenv:Envelope>

См. также

Вернуться к списку команд
Версия 1.29-3249
Дата публикации 21-12-2023 02:50:11