Изменение брокера
Примечание
Брокер находится на стадии Preview.
Вы можете изменить имя или описание брокера, а также управлять метками брокера.
Для обращения к брокеру используйте его уникальный идентификатор или имя. Как узнать уникальный идентификатор или имя брокера, читайте в разделе Получение информации о брокере.
Изменить имя брокера
- В консоли управления
выберите каталог, в котором вы хотите изменить имя брокера. - Выберите сервис IoT Core.
- На панели слева выберите Брокеры.
- Справа от имени нужного брокера нажмите значок
и в выпадающем списке выберите Редактировать. - Измените поле Имя.
- Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Измените имя брокера:
yc iot broker update my-broker --new-name test-broker
Результат:
id: b91ki3851h**********
folder_id: aoek49ghmk**********
created_at: "2019-05-28T11:29:42.420Z"
name: test-broker
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы изменить имя брокера, созданного с помощью Terraform:
-
Откройте файл конфигурации Terraform и измените значение параметра
name
во фрагменте с описанием брокера.Пример описания брокера в конфигурации Terraform:
resource "yandex_iot_core_broker" "my_broker" { name = "test-broker" description = "test broker for terraform provider documentation" } ... }
Более подробную информацию о параметрах ресурса
yandex_iot_core_broker
в Terraform, см. в документации провайдера . -
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.Проверить измененное имя брокера можно в консоли управления
или с помощью команды CLI:yc iot broker list
Чтобы изменить имя брокера, воспользуйтесь методом REST API update для ресурса Broker или вызовом gRPC API BrokerService/Update.
Изменить описание брокера
Чтобы изменить описание брокера:
- В консоли управления
выберите каталог, в котором вы хотите изменить описание брокера. - Выберите сервис IoT Core.
- На панели слева выберите Брокеры.
- Справа от имени нужного брокера нажмите значок
, в выпадающем списке выберите Редактировать. - Измените поле Описание.
- Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
Измените описание брокера:
yc iot broker update my-broker --description "My test broker."
Результат:
id: b91ki3851h**********
folder_id: aoek49ghmk**********
created_at: "2019-05-28T11:29:42.420Z"
name: my-broker
description: My test broker.
labels:
test_label: my_broker_label
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы изменить описание брокера, созданного с помощью Terraform:
-
Откройте файл конфигурации Terraform и измените значение параметра
description
во фрагменте с описанием брокера.Пример описания брокера в конфигурации Terraform:
resource "yandex_iot_core_broker" "my_broker" { name = "test-broker" description = "test broker for terraform provider documentation" } ... }
Более подробную информацию о параметрах ресурса
yandex_iot_core_broker
в Terraform, см. в документации провайдера . -
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.Проверить измененное описание брокера можно в консоли управления
или с помощью команды CLI:yc iot broker get <имя_брокера>
Чтобы изменить описание брокера, воспользуйтесь методом REST API update для ресурса Broker или вызовом gRPC API BrokerService/Update.
Управлять метками брокера
Вы можете выполнять следующие действия с метками брокера:
Добавить метку
- В консоли управления
выберите каталог, в котором вы хотите добавить метку брокера. - Выберите сервис IoT Core.
- На панели слева выберите Брокеры.
- Справа от имени нужного брокера нажмите значок
и в выпадающем списке выберите Редактировать. - Заполните поля Ключ, Значение и нажмите кнопку Добавить метку.
- Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Добавьте метку брокеру:
yc iot broker add-labels my-broker --labels new_label=test_label
Результат:
id: b91ki3851h**********
folder_id: aoek49ghmk**********
created_at: "2019-05-28T11:29:42.420Z"
name: my-broker
labels:
new_label: test_label
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы добавить метку брокеру, созданному с помощью Terraform:
-
Опишите в конфигурационном файле параметры ресурса, который необходимо создать:
yandex_iot_core_broker
— параметры брокера:name
— имя брокера.description
— описание брокера.labels
— метки брокера в форматеключ:значение
.
Пример структуры ресурса в конфигурационном файле:
resource "yandex_iot_core_broker" "my_broker" { name = "test-broker" description = "test broker for terraform provider documentation" labels = { new-label = "test-label" } ... }
Более подробную информацию о параметрах ресурса
yandex_iot_core_broker
в Terraform, см. в документации провайдера . -
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.Проверить метки брокера можно с помощью команды CLI:
yc iot broker get <имя_брокера>
Чтобы добавить метку брокеру, воспользуйтесь методом REST API update для ресурса Broker или вызовом gRPC API BrokerService/Update.
Изменить метку
- В консоли управления
выберите каталог, в котором вы хотите изменить метку брокера. - Выберите сервис IoT Core.
- На панели слева выберите Брокеры.
- Справа от имени нужного брокера нажмите значок
и в выпадающем списке выберите Редактировать. - Измените поля Ключ и Значение.
- Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Измените метку брокера:
Важно
Существующий набор labels
полностью перезаписывается набором, переданным в запросе.
yc iot broker update my-broker --labels test_label=my_broker_label
Результат:
id: b91ki3851h**********
folder_id: aoek49ghmk**********
created_at: "2019-05-28T11:29:42.420Z"
name: my-broker
labels:
test_label: my_broker_label
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы изменить метку брокера, созданного с помощью Terraform:
-
Откройте файл конфигурации Terraform и измените значение метки в блоке
labels
, во фрагменте с описанием брокера.Пример описания брокера в конфигурации Terraform:
resource "yandex_iot_core_broker" "my_broker" { name = "test-broker" description = "test broker for terraform provider documentation" labels = { test-label = "my-broker-label" } ... }
Более подробную информацию о параметрах ресурса
yandex_iot_core_broker
в Terraform, см. в документации провайдера . -
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.Проверить метки брокера можно с помощью команды CLI:
yc iot broker get <имя_брокера>
Чтобы изменить метку брокера, воспользуйтесь методом REST API update для ресурса Broker или вызовом gRPC API BrokerService/Update.
Удалить метку
- В консоли управления
выберите каталог, в котором вы хотите удалить метку брокера. - Выберите сервис IoT Core.
- На панели слева выберите Брокеры.
- Справа от имени нужного брокера нажмите значок
и в выпадающем списке выберите Редактировать. - Справа от удаляемой метки нажмите значок
. - Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Удалите метку брокера:
yc iot broker remove-labels my-broker --labels new_label
Результат:
id: b91ki3851h**********
folder_id: aoek49ghmk**********
created_at: "2019-05-28T11:29:42.420Z"
name: my-broker
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы удалить метку брокера, созданного с помощью Terraform:
-
Откройте файл конфигурации Terraform и удалите значение нужной метки в блоке
labels
, во фрагменте с описанием брокера. Чтобы удалить все метки, удалите блокlabels
целиком.Пример описания брокера в конфигурации Terraform:
resource "yandex_iot_core_broker" "my_broker" { name = "test-broker" description = "test broker for terraform provider documentation" labels = { test-label = "my-broker-label" } ... }
Более подробную информацию о параметрах ресурса
yandex_iot_core_broker
в Terraform, см. в документации провайдера . -
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.Проверить метки брокера можно с помощью команды CLI:
yc iot broker get <имя_брокера>
Чтобы удалить метку брокера, воспользуйтесь методом REST API update для ресурса Broker или вызовом gRPC API BrokerService/Update.