Связаться с намиПодключиться

Изменение брокера

Статья создана
Улучшена
Обновлена 21 апреля 2025 г.

Примечание

Брокер находится на стадии Preview.

Вы можете изменить имя или описание брокера, а также управлять метками брокера.

Для обращения к брокеру используйте его уникальный идентификатор или имя. Как узнать уникальный идентификатор или имя брокера, читайте в разделе Получение информации о брокере.

Изменить имя брокера

  1. В консоли управления выберите каталог, в котором вы хотите изменить имя брокера.
  2. Выберите сервис IoT Core.
  3. На панели слева выберите Брокеры.
  4. Справа от имени нужного брокера нажмите значок и в выпадающем списке выберите Редактировать.
  5. Измените поле Имя.
  6. Нажмите кнопку Сохранить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --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 позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы изменить имя брокера, созданного с помощью Terraform:

  1. Откройте файл конфигурации 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, см. в документации провайдера.

  2. В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.

  3. Проверьте корректность конфигурационного файла с помощью команды:

    terraform validate

    Если конфигурация является корректной, появится сообщение:

    Success! The configuration is valid.

  4. Выполните команду:

    terraform plan

    В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

  5. Примените изменения конфигурации:

    terraform apply

  6. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

    Проверить измененное имя брокера можно в консоли управления или с помощью команды CLI:

    yc iot broker list

Чтобы изменить имя брокера, воспользуйтесь методом REST API update для ресурса Broker или вызовом gRPC API BrokerService/Update.

Изменить описание брокера

Чтобы изменить описание брокера:

  1. В консоли управления выберите каталог, в котором вы хотите изменить описание брокера.
  2. Выберите сервис IoT Core.
  3. На панели слева выберите Брокеры.
  4. Справа от имени нужного брокера нажмите значок , в выпадающем списке выберите Редактировать.
  5. Измените поле Описание.
  6. Нажмите кнопку Сохранить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

Измените описание брокера:

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 позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы изменить описание брокера, созданного с помощью Terraform:

  1. Откройте файл конфигурации 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, см. в документации провайдера.

  2. В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.

  3. Проверьте корректность конфигурационного файла с помощью команды:

    terraform validate

    Если конфигурация является корректной, появится сообщение:

    Success! The configuration is valid.

  4. Выполните команду:

    terraform plan

    В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

  5. Примените изменения конфигурации:

    terraform apply

  6. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

    Проверить измененное описание брокера можно в консоли управления или с помощью команды CLI:

    yc iot broker get <имя_брокера>

Чтобы изменить описание брокера, воспользуйтесь методом REST API update для ресурса Broker или вызовом gRPC API BrokerService/Update.

Управлять метками брокера

Вы можете выполнять следующие действия с метками брокера:

Добавить метку

  1. В консоли управления выберите каталог, в котором вы хотите добавить метку брокера.
  2. Выберите сервис IoT Core.
  3. На панели слева выберите Брокеры.
  4. Справа от имени нужного брокера нажмите значок и в выпадающем списке выберите Редактировать.
  5. Заполните поля Ключ, Значение и нажмите кнопку Добавить метку.
  6. Нажмите кнопку Сохранить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --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 позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы добавить метку брокеру, созданному с помощью Terraform:

  1. Опишите в конфигурационном файле параметры ресурса, который необходимо создать:

    • 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, см. в документации провайдера.

  2. В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.

  3. Проверьте корректность конфигурационного файла с помощью команды:

    terraform validate

    Если конфигурация является корректной, появится сообщение:

    Success! The configuration is valid.

  4. Выполните команду:

    terraform plan

    В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

  5. Примените изменения конфигурации:

    terraform apply

  6. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

    Проверить метки брокера можно с помощью команды CLI:

    yc iot broker get <имя_брокера>

Чтобы добавить метку брокеру, воспользуйтесь методом REST API update для ресурса Broker или вызовом gRPC API BrokerService/Update.

Изменить метку

  1. В консоли управления выберите каталог, в котором вы хотите изменить метку брокера.
  2. Выберите сервис IoT Core.
  3. На панели слева выберите Брокеры.
  4. Справа от имени нужного брокера нажмите значок и в выпадающем списке выберите Редактировать.
  5. Измените поля Ключ и Значение.
  6. Нажмите кнопку Сохранить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --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 позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы изменить метку брокера, созданного с помощью Terraform:

  1. Откройте файл конфигурации 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, см. в документации провайдера.

  2. В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.

  3. Проверьте корректность конфигурационного файла с помощью команды:

    terraform validate

    Если конфигурация является корректной, появится сообщение:

    Success! The configuration is valid.

  4. Выполните команду:

    terraform plan

    В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

  5. Примените изменения конфигурации:

    terraform apply

  6. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

    Проверить метки брокера можно с помощью команды CLI:

    yc iot broker get <имя_брокера>

Чтобы изменить метку брокера, воспользуйтесь методом REST API update для ресурса Broker или вызовом gRPC API BrokerService/Update.

Удалить метку

  1. В консоли управления выберите каталог, в котором вы хотите удалить метку брокера.
  2. Выберите сервис IoT Core.
  3. На панели слева выберите Брокеры.
  4. Справа от имени нужного брокера нажмите значок и в выпадающем списке выберите Редактировать.
  5. Справа от удаляемой метки нажмите значок .
  6. Нажмите кнопку Сохранить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --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 позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы удалить метку брокера, созданного с помощью Terraform:

  1. Откройте файл конфигурации 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, см. в документации провайдера.

  2. В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.

  3. Проверьте корректность конфигурационного файла с помощью команды:

    terraform validate

    Если конфигурация является корректной, появится сообщение:

    Success! The configuration is valid.

  4. Выполните команду:

    terraform plan

    В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

  5. Примените изменения конфигурации:

    terraform apply

  6. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

    Проверить метки брокера можно с помощью команды CLI:

    yc iot broker get <имя_брокера>

Чтобы удалить метку брокера, воспользуйтесь методом REST API update для ресурса Broker или вызовом gRPC API BrokerService/Update.

Предыдущая
Создание брокера
Следующая
Удаление брокера