Dps Certificate - Create Or Update

Ссылка

Служба:: IoT Hub Device Provisioning Service

Версия API:: 2022-12-12

Отправьте сертификат в службу подготовки.
Добавьте новый сертификат или обновите существующий сертификат.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}?api-version=2022-12-12

Параметры URI

Имя	В	Обязательно	Тип	Описание
certificateName	path	True	string	Имя создания или обновления сертификата.
provisioningServiceName	path	True	string	Имя службы подготовки.
resourceGroupName	path	True	string	Идентификатор группы ресурсов.
subscriptionId	path	True	string	Идентификатор подписки.
api-version	query	True	string	Версия API.

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

Имя	Обязательно	Тип	Описание
If-Match		string	ETag сертификата. Это необходимо для обновления существующего сертификата и игнорируется при создании нового сертификата.

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

Имя	Тип	Описание
properties	CertificateProperties	свойства сертификата

Ответы

Имя	Тип	Описание
200 OK	CertificateResponse	Если сертификат уже существует и обновление прошло успешно, операция возвращает код состояния HTTP 201 (ОК).
Other Status Codes	ErrorDetails	Ответ на ошибку по умолчанию.

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

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

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

Примеры

DPSCreateOrUpdateCertificate

Образец запроса

HTTP

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates/cert?api-version=2022-12-12

{
  "properties": {
    "certificate": "MA=="
  }
}

Пример ответа

Код состояния:: 200

{
  "properties": {
    "subject": "CN=testdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "certificate": "MA==",
    "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/ProvisioningServices/Certificates",
  "etag": "AAAAAAExpNs="
}

Определения

Имя	Описание
CertificateProperties	Описание сертификата ЦС X509.
CertificateResponse	Сертификат X509.
createdByType	Тип удостоверения, создавшего ресурс.
ErrorDetails	Сведения об ошибке.
systemData	Метаданные, относящиеся к созданию и последнему изменению ресурса.

CertificateProperties

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

Имя	Тип	Описание
certificate	string	Представление base-64 сертификата X509 .cer файла или только pem-файла.
created	string	Дата и время создания сертификата.
expiry	string	Дата и время окончания срока действия сертификата.
isVerified	boolean	Определяет, проверен ли сертификат.
subject	string	Имя субъекта сертификата.
thumbprint	string	отпечаток сертификата.
updated	string	Дата и время последнего обновления сертификата.

CertificateResponse

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

Имя	Тип	Описание
etag	string	Тег сущности.
id	string	Идентификатор ресурса.
name	string	Имя сертификата.
properties	CertificateProperties	свойства сертификата
systemData	systemData	Метаданные, относящиеся к созданию и последнему изменению ресурса.
type	string	Тип ресурса.

createdByType

Тип удостоверения, создавшего ресурс.

Имя	Тип	Описание
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

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

Имя	Тип	Описание
code	integer	Код ошибки.
details	string	Сведения об ошибке.
httpStatusCode	string	Код состояния HTTP.
message	string	Сообщение об ошибке.

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя	Тип	Описание
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Удостоверение, которое в последний раз изменял ресурс.
lastModifiedByType	createdByType	Тип удостоверения, изменяющего ресурс в последний раз.

Поделиться через