Dps Certificate - Create Or Update

Service:

IoT Hub Device Provisioning Service

API Version:

2022-12-12

Chargez le certificat sur le service d’approvisionnement.
Ajoutez un nouveau certificat ou mettez à jour un certificat existant.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
certificateName	path	True	string	Nom de la création ou de la mise à jour du certificat.
provisioningServiceName	path	True	string	Nom du service d’approvisionnement.
resourceGroupName	path	True	string	Identificateur du groupe de ressources.
subscriptionId	path	True	string	Identificateur de l’abonnement.
api-version	query	True	string	Version de l’API.

En-tête de la demande

Nom	Obligatoire	Type	Description
If-Match		string	ETag du certificat. Cela est nécessaire pour mettre à jour un certificat existant et ignoré lors de la création d’un tout nouveau certificat.

Corps de la demande

Nom	Type	Description
properties	CertificateProperties	propriétés d’un certificat

Réponses

Nom	Type	Description
200 OK	CertificateResponse	Si le certificat existe déjà et que la mise à jour a réussi, l’opération retourne http status code 201 (OK).
Other Status Codes	ErrorDetails	Réponse d’erreur par défaut.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

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

Scopes

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

DPSCreateOrUpdateCertificate

Sample Request

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

Sample Response

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

Définitions

Nom	Description
CertificateProperties	Description d’un certificat d’autorité de certification X509.
CertificateResponse	Certificat X509.
createdByType	Type d’identité qui a créé la ressource.
ErrorDetails	Détails de l’erreur.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

CertificateProperties

Description d’un certificat d’autorité de certification X509.

Nom	Type	Description
certificate	string	Représentation en base 64 du certificat X509 .cer fichier ou simplement du contenu du fichier .pem.
created	string	Date et heure de création du certificat.
expiry	string	Date et heure d’expiration du certificat.
isVerified	boolean	Détermine si le certificat a été vérifié.
subject	string	Nom de l’objet du certificat.
thumbprint	string	empreinte numérique du certificat.
updated	string	Date et heure de la dernière mise à jour du certificat.

CertificateResponse

Certificat X509.

Nom	Type	Description
etag	string	Étiquette d’entité.
id	string	Identificateur de ressource.
name	string	Nom du certificat.
properties	CertificateProperties	propriétés d’un certificat
systemData	systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
type	string	Type de ressource.

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Détails de l’erreur.

Nom	Type	Description
code	integer	Code d'erreur.
details	string	Détails de l’erreur.
httpStatusCode	string	Code d’état HTTP.
message	string	Message d’erreur.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string	Horodatage de la dernière modification de la ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la dernière ressource.
lastModifiedByType	createdByType	Type d’identité qui a modifié la dernière ressource.