Dps Certificate - Create Or Update

Service:

IoT Hub Device Provisioning Service

API-versie:

2022-12-12

Upload het certificaat naar de inrichtingsservice.
Voeg een nieuw certificaat toe of werk een bestaand certificaat bij.

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

URI-parameters

Name	In	Vereist	Type	Description
certificateName	path	True	string maxLength: 256	De naam van het certificaat maken of bijwerken.
provisioningServiceName	path	True	string	De naam van de inrichtingsservice.
resourceGroupName	path	True	string	Resourcegroep-id.
subscriptionId	path	True	string	De abonnement-ID.
api-version	query	True	string	De versie van de API.

Aanvraagkoptekst

Name	Vereist	Type	Description
If-Match		string	ETag van het certificaat. Dit is vereist om een bestaand certificaat bij te werken en genegeerd tijdens het maken van een gloednieuw certificaat.

Aanvraagbody

Name	Type	Description
properties	CertificateProperties	eigenschappen van een certificaat

Antwoorden

Name	Type	Description
200 OK	CertificateResponse	Als het certificaat al bestaat en de update is geslaagd, retourneert de bewerking de HTTP-statuscode 201 (OK).
Other Status Codes	ErrorDetails	Standaardfoutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

DPSCreateOrUpdateCertificate

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
CertificateProperties	De beschrijving van een X509-CA-certificaat.
CertificateResponse	Het X509-certificaat.
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorDetails	Foutdetails.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

CertificateProperties

Object

De beschrijving van een X509-CA-certificaat.

Name	Type	Description
certificate	string (byte)	base-64-weergave van X509-certificaat .cer bestand of alleen PEM-bestandsinhoud.
created	string (date-time-rfc1123)	De aanmaakdatum en -tijd van het certificaat.
expiry	string (date-time-rfc1123)	De vervaldatum en -tijd van het certificaat.
isVerified	boolean	Bepaalt of het certificaat is geverifieerd.
subject	string	De onderwerpnaam van het certificaat.
thumbprint	string	De vingerafdruk van het certificaat.
updated	string (date-time-rfc1123)	De datum en tijd van de laatste update van het certificaat.

CertificateResponse

Object

Het X509-certificaat.

Name	Type	Description
etag	string	De entiteitstag.
id	string	De resource-id.
name	string	De naam van het certificaat.
properties	CertificateProperties	eigenschappen van een certificaat
systemData	systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
type	string	Het resourcetype.

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
Application
Key
ManagedIdentity
User

ErrorDetails

Object

Foutdetails.

Name	Type	Description
code	integer (int32)	De foutcode.
details	string	De foutdetails.
httpStatusCode	string	De HTTP-statuscode.
message	string	Het foutbericht.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.