Partager via


Dps Certificate - Create Or Update

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
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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

Exemples

DPSCreateOrUpdateCertificate

Exemple de requête

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

Exemple de réponse

{
  "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.