Certificates - Create Or Update

  • Ссылка
Service:
IoT Hub
API Version:
2018-04-01

Отправьте сертификат в Центр Интернета вещей.
Добавляет новый или заменяет существующий сертификат.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{resourceName}/certificates/{certificateName}?api-version=2018-04-01

Параметры URI

Имя В Обязательно Тип Описание
certificateName
 path True

string

Имя сертификата

Regex pattern: ^[A-Za-z0-9-._]{1,64}$
resourceGroupName
 path True

string

Имя группы ресурсов, содержащей Центр Интернета вещей.
resourceName
 path True

string

Имя Центра Интернета вещей.
subscriptionId
 path True

string

Идентификатор подписки.
api-version
 query True

string

Версия API.

Заголовок запроса

Имя Обязательно Тип Описание
If-Match

string

ETag сертификата. Не указывайте для создания нового сертификата. Требуется для обновления существующего сертификата.

Текст запроса

Имя Тип Описание
certificate

string

Представление base-64 конечного сертификата X509 .cer файла или просто содержимого ФАЙЛА PEM.

Ответы

Имя Тип Описание
200 OK

CertificateDescription

Если сертификат уже существует и обновление прошло успешно, операция возвращает код состояния HTTP 201 (ОК).
201 Created

CertificateDescription

Если создание сертификата не было создано успешно, операция возвращает код состояния HTTP 201 (ОК).
Other Status Codes

ErrorDetails

DefaultErrorResponse

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

Certificates_CreateOrUpdate

Sample Request

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/iothub/certificates/cert?api-version=2018-04-01

{
  "certificate": "############################################"
}

Sample Response

Status code:
201 
{
  "properties": {
    "subject": "CN=testdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
    "isVerified": false,
    "created": "Thu, 12 Oct 2017 19:23:50 GMT",
    "updated": "Thu, 12 Oct 2017 19:23:50 GMT"
  },
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServives/myFirstProvisioningService/certificates/cert",
  "name": "cert",
  "type": "Microsoft.Devices/IotHubs/Certificates",
  "etag": "AAAAAAExpNs="
}
Status code:
200 
{
  "properties": {
    "subject": "CN=testdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
    "isVerified": false,
    "created": "Thu, 12 Oct 2017 19:23:50 GMT",
    "updated": "Thu, 12 Oct 2017 19:23:50 GMT"
  },
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServives/myFirstProvisioningService/certificates/cert",
  "name": "cert",
  "type": "Microsoft.Devices/IotHubs/Certificates",
  "etag": "AAAAAAExpNs="
}

Определения

Имя Описание
CertificateBodyDescription

Сериализованный json сертификат X509.
CertificateDescription

Сертификат X509.
CertificateProperties

Описание сертификата ЦС X509.
ErrorDetails

Сведения об ошибке.

CertificateBodyDescription

Сериализованный json сертификат X509.

Имя Тип Описание
certificate

string

Представление base-64 конечного сертификата X509 .cer файла или просто содержимого ФАЙЛА PEM.

CertificateDescription

Сертификат X509.

Имя Тип Описание
etag

string

Тег сущности.
id

string

Идентификатор ресурса.
name

string

Имя сертификата.
properties

CertificateProperties

Описание сертификата ЦС X509.
type

string

Тип ресурса.

CertificateProperties

Описание сертификата ЦС X509.

Имя Тип Описание
certificate

string

Содержимое сертификата
created

string

Дата и время создания сертификата.
expiry

string

Дата и время окончания срока действия сертификата.
isVerified

boolean

Определяет, проверен ли сертификат.
subject

string

Имя субъекта сертификата.
thumbprint

string

отпечаток сертификата.
updated

string

Дата и время последнего обновления сертификата.

ErrorDetails

Сведения об ошибке.

Имя Тип Описание
code

string

Код ошибки.
details

string

Сведения об ошибке.
httpStatusCode

string

Код состояния HTTP.
message

string

Сообщение об ошибке.