Dps Certificate - Create Or Update

Referentie

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	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 abonnements-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 wordt 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 het bijwerken is geslaagd, retourneert de bewerking de HTTP-statuscode 201 (OK).
Other Status Codes	ErrorDetails	Standaardfoutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

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 laatste wijzigen van de resource.

CertificateProperties

De beschrijving van een X509 CA-certificaat.

Name	Type	Description
certificate	string	base-64-weergave van X509-certificaat .cer bestand of alleen .pem-bestandsinhoud.
created	string	De aanmaakdatum en -tijd van het certificaat.
expiry	string	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	De datum en tijd van de laatste update van het certificaat.

CertificateResponse

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 laatste wijzigen van de resource.
type	string	Het resourcetype.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Foutdetails.

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

systemData

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

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

Delen via