Certificates - Create Or Update

Service:: App Service

Version d’API:: 2026-07-15

Description de Créer ou mettre à jour un certificat.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
name	path	True	string	Nom du certificat.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement géographique où réside la ressource
kind		string	Type de ressource. Si la ressource est une application, vous pouvez faire référence à https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference pour plus d’informations sur les valeurs prises en charge pour le type.
properties.canonicalName		string	CNAME du certificat à émettre via un certificat gratuit
properties.domainValidationMethod		string	Méthode de validation de domaine pour un certificat gratuit
properties.hostNames		string[]	Les noms d’hôte dont le certificat s’applique.
properties.keyVaultId		string (arm-id)	Azure Key Vault Csm resource ID.
properties.keyVaultSecretName		string	Azure Key Vault nom secret.
properties.password		string	Mot de passe du certificat.
properties.pfxBlob		string (byte)	Objet blob Pfx.
properties.serverFarmId		string (arm-id)	ID de ressource du plan App Service associé.
tags		object	Balises de ressources.

Réponses

Nom	Type	Description
200 OK	Certificate	Opération de mise à jour du 'Certificat' de la ressource réussie
Other Status Codes	DefaultErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 d’Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Usurper l’identité de votre compte utilisateur

Exemples

Create Or Update Certificate

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
  }
}

Définitions

Nom	Description
Certificate	Certificat SSL pour une application.
createdByType	Type d’identité qui a créé la ressource.
DefaultErrorResponse	Réponse d’erreur App Service.
DefaultErrorResponseError	Modèle d’erreur.
DefaultErrorResponseErrorDetailsItem	Erreurs détaillées.
HostingEnvironmentProfile	Spécification pour un App Service Environment à utiliser pour cette ressource.
KeyVaultSecretStatus	Statut du secret de Key Vault.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

Certificate

Objet

Certificat SSL pour une application.

Nom	Type	Description
id	string (arm-id)	Identifiant de ressource entièrement qualifié pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
kind	string	Type de ressource. Si la ressource est une application, vous pouvez faire référence à https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference pour plus d’informations sur les valeurs prises en charge pour le type.
location	string	Emplacement géographique où réside la ressource
name	string	nom de la ressource.
properties.canonicalName	string	CNAME du certificat à émettre via un certificat gratuit
properties.cerBlob	string (byte)	Octets bruts du fichier .cer
properties.domainValidationMethod	string	Méthode de validation de domaine pour un certificat gratuit
properties.expirationDate	string (date-time)	Date d’expiration du certificat.
properties.friendlyName	string	Nom convivial du certificat.
properties.hostNames	string[]	Les noms d’hôte dont le certificat s’applique.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Spécification pour l’App Service Environment à utiliser pour le certificat.
properties.issueDate	string (date-time)	Date d’émission du certificat.
properties.issuer	string	Émetteur de certificat.
properties.keyVaultId	string (arm-id)	Azure Key Vault Csm resource ID.
properties.keyVaultSecretName	string	Azure Key Vault nom secret.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Statut du secret de Key Vault.
properties.password	string	Mot de passe du certificat.
properties.pfxBlob	string (byte)	Objet blob Pfx.
properties.publicKeyHash	string	Hachage de clé publique.
properties.selfLink	string	Lien auto-connecté.
properties.serverFarmId	string (arm-id)	ID de ressource du plan App Service associé.
properties.siteName	string	Nom de l’application.
properties.subjectName	string	Nom de l’objet du certificat.
properties.thumbprint	string	Empreinte du certificat.
properties.valid	boolean	Le certificat est-il valide ?.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressources.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Objet

Réponse d’erreur App Service.

Nom	Type	Description
error	DefaultErrorResponseError	Modèle d’erreur.

DefaultErrorResponseError

Objet

Modèle d’erreur.

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
details	DefaultErrorResponseErrorDetailsItem[]	Erreurs détaillées.
innererror	string	Plus d’informations pour déboguer l’erreur.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

DefaultErrorResponseErrorDetailsItem

Objet

Erreurs détaillées.

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

HostingEnvironmentProfile

Objet

Spécification pour un App Service Environment à utiliser pour cette ressource.

Nom	Type	Description
id	string	ID de ressource de l’environnement App Service.
name	string	Nom de l’App Service Environment.
type	string	Type de ressource de l’App Service Environment.

KeyVaultSecretStatus

Énumération

Statut du secret de Key Vault.

Valeur	Description
Initialized
WaitingOnCertificateOrder
Succeeded
CertificateOrderFailed
OperationNotPermittedOnKeyVault
AzureServiceUnauthorizedToAccessKeyVault
KeyVaultDoesNotExist
KeyVaultSecretDoesNotExist
UnknownError
ExternalPrivateKey
Unknown

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.