Certificates - Create Or Update

Dienst:: App Service

API-Version:: 2026-07-15

Beschreibung für Erstellen oder Aktualisieren eines Zertifikats.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/certificates/{name}?api-version=2026-07-15

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
name	path	True	string	Name des Zertifikats.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
location	True	string	Der geografische Standort, an dem sich die Ressource befindet
kind		string	Art der Ressource. Wenn es sich bei der Ressource um eine App handelt, können Sie auf https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference für details unterstützte Werte für die Art verweisen.
properties.canonicalName		string	CNAME des Zertifikats, das über ein kostenloses Zertifikat ausgestellt werden soll
properties.domainValidationMethod		string	Methode der Domänenüberprüfung für kostenloses Zertifikat
properties.hostNames		string[]	Hostnamen, für die das Zertifikat gilt.
properties.keyVaultId		string (arm-id)	Azure Key Vault Csm resource Id.
properties.keyVaultSecretName		string	Geheimer Azure Key Vault-Name.
properties.password		string	Zertifikatkennwort.
properties.pfxBlob		string (byte)	Pfx-BLOB.
properties.serverFarmId		string (arm-id)	Ressourcen-ID des zugeordneten App Service-Plans.
tags		object	Ressourcenkennzeichnungen.

Antworten

Name	Typ	Beschreibung
200 OK	Certificate	Die Aktualisierung der Ressource 'Zertifikat' war erfolgreich
Other Status Codes	DefaultErrorResponse	Unerwartete Fehlerantwort.

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	Sich als Ihr Benutzerkonto ausgeben

Beispiele

Create Or Update Certificate

Beispielanforderung

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/certificates/testc6282?api-version=2026-07-15

{
  "location": "East US",
  "properties": {
    "hostNames": [
      "ServerCert"
    ],
    "password": "<password>"
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "testc6282",
  "type": "Microsoft.Web/certificates",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/certificates/testc6282",
  "location": "East US",
  "properties": {
    "expirationDate": "2039-12-31T23:59:59+00:00",
    "friendlyName": "",
    "hostNames": [
      "ServerCert"
    ],
    "issueDate": "2015-11-12T23:40:25+00:00",
    "issuer": "CACert",
    "subjectName": "ServerCert",
    "thumbprint": "FE703D7411A44163B6D32B3AD9B03E175886EBFE"
  }
}

Definitionen

Name	Beschreibung
Certificate	SSL-Zertifikat für eine App.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DefaultErrorResponse	Fehlerantwort des App-Diensts.
DefaultErrorResponseError	Fehlermodell.
DefaultErrorResponseErrorDetailsItem	Detaillierte Fehler.
HostingEnvironmentProfile	Spezifikation für eine App Service-Umgebung, die für diese Ressource verwendet werden soll.
KeyVaultSecretStatus	Status des Key Vault-Geheimnisses.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

Certificate

Objekt

SSL-Zertifikat für eine App.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Art der Ressource. Wenn es sich bei der Ressource um eine App handelt, können Sie auf https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference für details unterstützte Werte für die Art verweisen.
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties.canonicalName	string	CNAME des Zertifikats, das über ein kostenloses Zertifikat ausgestellt werden soll
properties.cerBlob	string (byte)	Unformatierte Bytes .cer Datei
properties.domainValidationMethod	string	Methode der Domänenüberprüfung für kostenloses Zertifikat
properties.expirationDate	string (date-time)	Ablaufdatum des Zertifikats.
properties.friendlyName	string	Anzeigename des Zertifikats.
properties.hostNames	string[]	Hostnamen, für die das Zertifikat gilt.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Spezifikation für die App Service-Umgebung zur Verwendung des Zertifikats.
properties.issueDate	string (date-time)	Zertifikatproblemdatum.
properties.issuer	string	Zertifikataussteller.
properties.keyVaultId	string (arm-id)	Azure Key Vault Csm resource Id.
properties.keyVaultSecretName	string	Geheimer Azure Key Vault-Name.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Status des Key Vault-Geheimnisses.
properties.password	string	Zertifikatkennwort.
properties.pfxBlob	string (byte)	Pfx-BLOB.
properties.publicKeyHash	string	Hash für öffentliche Schlüssel.
properties.selfLink	string	Selbst verlinken.
properties.serverFarmId	string (arm-id)	Ressourcen-ID des zugeordneten App Service-Plans.
properties.siteName	string	App-Name.
properties.subjectName	string	Antragstellername des Zertifikats.
properties.thumbprint	string	Zertifikatfingerabdruck.
properties.valid	boolean	Ist das Zertifikat gültig?.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcenkennzeichnungen.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Objekt

Fehlerantwort des App-Diensts.

Name	Typ	Beschreibung
error	DefaultErrorResponseError	Fehlermodell.

DefaultErrorResponseError

Objekt

Fehlermodell.

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers.
details	DefaultErrorResponseErrorDetailsItem[]	Detaillierte Fehler.
innererror	string	Weitere Informationen zum Debuggen von Fehlern.
message	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.
target	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.

DefaultErrorResponseErrorDetailsItem

Objekt

Detaillierte Fehler.

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers.
message	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.
target	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.

HostingEnvironmentProfile

Objekt

Spezifikation für eine App Service-Umgebung, die für diese Ressource verwendet werden soll.

Name	Typ	Beschreibung
id	string	Ressourcen-ID der App-Dienstumgebung.
name	string	Name der App Service-Umgebung.
type	string	Ressourcentyp der App Service-Umgebung.

KeyVaultSecretStatus

Enumeration

Status des Key Vault-Geheimnisses.

Wert	Beschreibung
Initialized
WaitingOnCertificateOrder
Succeeded
CertificateOrderFailed
OperationNotPermittedOnKeyVault
AzureServiceUnauthorizedToAccessKeyVault
KeyVaultDoesNotExist
KeyVaultSecretDoesNotExist
UnknownError
ExternalPrivateKey
Unknown

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	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 (date-time)	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.