Dps Certificate - Create Or Update

Servicio:

IoT Hub Device Provisioning Service

Versión de la API:

2022-12-12

Cargue el certificado en el servicio de aprovisionamiento.
Agregue un nuevo certificado o actualice un certificado existente.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
certificateName	path	True	string maxLength: 256	Nombre del certificado que crea o actualiza.
provisioningServiceName	path	True	string	Nombre del servicio de aprovisionamiento.
resourceGroupName	path	True	string	Identificador del grupo de recursos.
subscriptionId	path	True	string	Identificador de la suscripción.
api-version	query	True	string	Versión de la API.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
If-Match		string	ETag del certificado. Esto es necesario para actualizar un certificado existente y se omite al crear un certificado nuevo.

Cuerpo de la solicitud

Nombre	Tipo	Description
properties	CertificateProperties	propiedades de un certificado

Respuestas

Nombre	Tipo	Description
200 OK	CertificateResponse	Si el certificado ya existe y la actualización se realizó correctamente, la operación devuelve el código de estado HTTP de 201 (Correcto).
Other Status Codes	ErrorDetails	Respuesta de error predeterminada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

DPSCreateOrUpdateCertificate

Solicitud de ejemplo

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=="
  }
}

Respuesta de muestra

status code:

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="
}

Definiciones

Nombre	Description
CertificateProperties	Descripción de un certificado de entidad de certificación X509.
CertificateResponse	Certificado X509.
createdByType	Tipo de identidad que creó el recurso.
ErrorDetails	Detalles del error.
systemData	Metadatos relativos a la creación y última modificación del recurso.

CertificateProperties

Object

Descripción de un certificado de entidad de certificación X509.

Nombre	Tipo	Description
certificate	string (byte)	representación base-64 del certificado X509 .cer archivo o solo contenido del archivo .pem.
created	string (date-time-rfc1123)	Fecha y hora de creación del certificado.
expiry	string (date-time-rfc1123)	Fecha y hora de expiración del certificado.
isVerified	boolean	Determina si se ha comprobado el certificado.
subject	string	Nombre del firmante del certificado.
thumbprint	string	Huella digital del certificado.
updated	string (date-time-rfc1123)	Fecha y hora de la última actualización del certificado.

CertificateResponse

Object

Certificado X509.

Nombre	Tipo	Description
etag	string	Etiqueta de entidad.
id	string	Identificador de recurso.
name	string	Nombre del certificado.
properties	CertificateProperties	propiedades de un certificado
systemData	systemData	Metadatos relativos a la creación y última modificación del recurso.
type	string	Tipo de recurso.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User

ErrorDetails

Object

Detalles del error.

Nombre	Tipo	Description
code	integer (int32)	Código de error.
details	string	Detalles del error.
httpStatusCode	string	Código de estado HTTP.
message	string	Mensaje de error.

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.