Изменение устройства

Статья создана

Yandex Cloud

Улучшена

kvendingoldo

Обновлена 21 апреля 2025 г.

Изменить имя устройства
Изменить описание устройства

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

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

Изменить имя устройства

Консоль управления

CLI

Terraform

API

Чтобы изменить имя устройства:

В консоли управления выберите каталог, в котором вы хотите изменить имя устройства.
Выберите сервис IoT Core.
Выберите в списке нужный реестр.
В левой части окна выберите раздел Устройства.
Справа от имени нужного устройства нажмите значок , в выпадающем списке выберите Редактировать.
Измените поле Имя.
Нажмите кнопку Сохранить.

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

Измените имя устройства:

yc iot device update my-device --new-name test-device

Результат:

id: b9135goeh1uc********
registry_id: b91ki3851hab********
created_at: "2019-05-28T16:08:30.938Z"
name: test-device

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

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

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

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

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

Откройте файл конфигурации Terraform и измените значение параметра name во фрагменте с описанием устройства:

Пример описания устройства в конфигурации Terraform:
```
resource "yandex_iot_core_device" "my_device" {
  registry_id = "<идентификатор_реестра>"
  name        = "test-device"
  description = "test device for terraform provider documentation"
...
}
```
Более подробную информацию о параметрах ресурса yandex_iot_core_device в Terraform, см. в документации провайдера.
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
Выполните команду:
```
terraform plan
```
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
Примените изменения конфигурации:
```
terraform apply
```
Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

Проверить измененное имя устройства можно в консоли управления или с помощью команды CLI:
```
yc iot device list --registry-id <идентификатор_реестра>
```

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

Изменить описание устройства

Консоль управления

CLI

Terraform

API

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

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

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

Измените описание устройства:

yc iot device update my-device --description "My first device."