Создание Центра Интернета вещей с помощью REST API поставщика ресурсов (.NET)
Для создания Центров Интернета вещей Azure и управления ими программными средствами можно использовать REST API ресурсов Центр Интернета вещей. В этой статье показано, как использовать ресурс Центр Интернета вещей для создания Центра Интернета вещей с помощью Postman. Кроме того, можно использовать cURL. Если какая-либо из этих команд REST завершается сбоем, найдите справку по Центр Интернета вещей api распространенных кодов ошибок.
Примечание
Для взаимодействия с Azure рекомендуется использовать модуль Azure Az PowerShell. Чтобы начать работу, см. статью Установка Azure PowerShell. Дополнительные сведения см. в статье Перенос Azure PowerShell с AzureRM на Az.
Предварительные требования
Получение маркера доступа Azure
В командлете Azure PowerShell или azure Cloud Shell выполните вход и получите маркер с помощью следующей команды. Если вы используете Cloud Shell уже выполнили вход, пропустите этот шаг.
az account get-access-token --resource https://management.azure.comВ консоли должен появиться ответ, аналогичный следующему коду JSON (за исключением того, что маркер доступа длинный):
{ "accessToken": "eyJ ... pZA", "expiresOn": "2022-09-16 20:57:52.000000", "subscription": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "tokenType": "Bearer" }В новом запросе Postman на вкладке Проверка подлинности выберите раскрывающийся список Тип и выберите Токен носителя.
Вставьте маркер доступа в поле с меткой Токен.
Помните, что срок действия маркера доступа истекает через 5–60 минут, поэтому может потребоваться создать еще один маркер доступа.
Создание Центра Интернета вещей
Выберите раскрывающийся список команды REST и выберите команду PUT. Скопируйте приведенный ниже URL-адрес, заменив значения в свойстве
{}собственными значениями. Значение{resourceName}— это имя, которое вы хотите использовать для нового центра Интернета вещей. Вставьте URL-адрес в поле рядом с командой PUT.PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2021-04-12
На вкладке Текст выберите raw и JSON из раскрывающихся списков.
Скопируйте следующий код JSON, заменив значения в
<>на собственные. Вставьте JSON в поле Postman на вкладке Текст . Убедитесь, что имя центра Интернета вещей совпадает с именем в URL-адресе PUT. Измените расположение на свое расположение (расположение, назначенное вашей группе ресурсов).{ "name": "<my-iot-hub>", "location": "<region>", "tags": {}, "properties": {}, "sku": { "name": "S1", "tier": "Standard", "capacity": 1 } }Выберите Отправить , чтобы отправить запрос и создать центр Интернета вещей. Успешный запрос вернет ответ 201 Created с распечаткой JSON спецификаций Центра Интернета вещей. Вы можете сохранить запрос, если используете Postman.
Просмотр Центра Интернета вещей
Чтобы просмотреть все спецификации нового Центра Интернета вещей, используйте запрос GET. Можно использовать тот же URL-адрес, который использовался с запросом PUT, но необходимо удалить текст этого запроса (если он еще не пуст), так как запрос GET не может содержать текст. Ниже приведен шаблон запроса GET:
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2018-04-01
См. команду GET в ресурсе Центр Интернета вещей.
Обновление Центра Интернета вещей
Обновить так же просто, как использовать тот же запрос PUT, что и при создании Центра Интернета вещей, и изменить текст JSON, чтобы он содержал выбранные параметры. Измените текст запроса, добавив свойство tags , а затем выполните запрос PUT.
{
"name": "<my-iot-hub>",
"location": "westus2",
"tags": {
"Animal": "Cat"
},
"properties": {},
"sku": {
"name": "S1",
"tier": "Standard",
"capacity": 1
}
}
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2018-04-01
В ответе будет отображаться новый тег, добавленный в консоль. Помните, что может потребоваться обновить маркер доступа, если с момента последнего создания маркера доступа прошло слишком много времени.
См. команду PUT в ресурсе Центр Интернета вещей.
Кроме того, используйте команду PATCH в ресурсе Центр Интернета вещей для обновления тегов.
Удаление Центра Интернета вещей
Если вы только тестируете, вы можете очистить ресурсы и удалить новый Центр Интернета вещей, отправив запрос DELETE. не забудьте заменить значения в {} собственными значениями. Значение {resourceName} — это имя центра Интернета вещей.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}?api-version=2018-04-01
См. команду DELETE в ресурсе Центр Интернета вещей.
Дальнейшие действия
После развертывания центра Интернета вещей с использованием REST API поставщика ресурсов вам могут понадобиться дополнительные сведения:
Ознакомьтесь с возможностями REST API поставщика ресурсов Центра Интернета вещей.
Сведения о возможностях Azure Resource Manager см. в статье Общие сведения об Azure Resource Manager.
Дополнительные сведения о разработке для Центра Интернета вещей см. в следующих статьях:
Для дальнейшего изучения возможностей Центра Интернета вещей см. следующие статьи: