Freigeben über


Dps Certificate - Create Or Update

Laden Sie das Zertifikat in den Bereitstellungsdienst hoch.
Fügen Sie ein neues Zertifikat hinzu, oder aktualisieren Sie ein vorhandenes Zertifikat.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
certificateName
path True

string

Der Name des erstellten oder aktualisierten Zertifikats.

provisioningServiceName
path True

string

Der Name des Bereitstellungsdiensts.

resourceGroupName
path True

string

Ressourcengruppenbezeichner.

subscriptionId
path True

string

Die Abonnement-ID.

api-version
query True

string

Die Version der API.

Anforderungsheader

Name Erforderlich Typ Beschreibung
If-Match

string

ETag des Zertifikats. Dies ist erforderlich, um ein vorhandenes Zertifikat zu aktualisieren, und wird beim Erstellen eines brandneuen Zertifikats ignoriert.

Anforderungstext

Name Typ Beschreibung
properties

CertificateProperties

Eigenschaften eines Zertifikats

Antworten

Name Typ Beschreibung
200 OK

CertificateResponse

Wenn das Zertifikat bereits vorhanden ist und die Aktualisierung erfolgreich war, gibt der Vorgang HTTP-status Code von 201 (OK) zurück.

Other Status Codes

ErrorDetails

Standardfehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

DPSCreateOrUpdateCertificate

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
CertificateProperties

Die Beschreibung eines X509-Zertifizierungsstellenzertifikats.

CertificateResponse

Das X509-Zertifikat.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

ErrorDetails

Fehlerdetails.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

CertificateProperties

Die Beschreibung eines X509-Zertifizierungsstellenzertifikats.

Name Typ Beschreibung
certificate

string

Base64-Darstellung des X509-Zertifikats .cer Datei oder nur PEM-Dateiinhalt.

created

string

Datum und Uhrzeit der Erstellung des Zertifikats.

expiry

string

Das Ablaufdatum und die Uhrzeit des Zertifikats.

isVerified

boolean

Bestimmt, ob das Zertifikat überprüft wurde.

subject

string

Der Antragstellername des Zertifikats.

thumbprint

string

Der Fingerabdruck des Zertifikats.

updated

string

Datum und Uhrzeit der letzten Aktualisierung des Zertifikats.

CertificateResponse

Das X509-Zertifikat.

Name Typ Beschreibung
etag

string

Das Entitätstag.

id

string

Der Ressourcenbezeichner.

name

string

Der Name des Zertifikats.

properties

CertificateProperties

Eigenschaften eines Zertifikats

systemData

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

type

string

Der Ressourcentyp.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorDetails

Fehlerdetails.

Name Typ Beschreibung
code

integer

Der Fehlercode.

details

string

Die Fehlerdetails.

httpStatusCode

string

Der HTTP-Statuscode.

message

string

Die Fehlermeldung.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.