Delen via


Dps Certificate - Create Or Update

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

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

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