Certificates - Create Or Update

Description de la création ou de la mise à jour d’un certificat.

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

Paramètres URI

Name In Required Type Description
name
path True
  • string

Nom du certificat.

resourceGroupName
path True
  • string

Nom du groupe de ressources auquel appartient la ressource.

Regex pattern: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True
  • string

Votre ID d’abonnement Azure. Il s’agit d’une chaîne au format GUID (par exemple, 00000000-0000-0000-0000-00000000000000000000000000000000000000000000000000000000000000000000000000000000000).

api-version
query True
  • string

Version d'API

Corps de la demande

Name Required Type Description
location True
  • string

Emplacement de la ressource.

kind
  • string

Type de ressource.

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

Key Vault ID de ressource Csm.

properties.keyVaultSecretName
  • string

Key Vault nom du secret.

properties.password
  • string

Mot de passe du certificat.

properties.pfxBlob
  • string

Objet blob Pfx.

properties.serverFarmId
  • string

ID de ressource du plan de App Service associé, mis en forme comme : « /abonnements/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName} ».

tags
  • object

Balises de ressource.

Réponses

Name Type Description
200 OK

OK.

Other Status Codes

App Service réponse d’erreur.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation emprunt d’identité de votre compte d’utilisateur

Exemples

Create Or Update Certificate

Sample Request

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

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

Sample Response

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

Définitions

Certificate

Certificat SSL pour une application.

DefaultErrorResponse

App Service réponse d’erreur.

Details
Error

Modèle d’erreur.

HostingEnvironmentProfile

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

KeyVaultSecretStatus

État du secret Key Vault.

Certificate

Certificat SSL pour une application.

Name Type Description
id
  • string

ID de ressource.

kind
  • string

Type de ressource.

location
  • string

Emplacement de la ressource.

name
  • string

Nom de la ressource.

properties.canonicalName
  • string

CNAME du certificat à émettre via un certificat gratuit

properties.cerBlob
  • string

Octets bruts du fichier .cer

properties.domainValidationMethod
  • string

Méthode de validation de domaine pour un certificat gratuit

properties.expirationDate
  • string

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

Spécification de la App Service Environment à utiliser pour le certificat.

properties.issueDate
  • string

Date du problème du certificat.

properties.issuer
  • string

Émetteur de certificat.

properties.keyVaultId
  • string

Key Vault ID de ressource Csm.

properties.keyVaultSecretName
  • string

Key Vault nom du secret.

properties.keyVaultSecretStatus

État du secret Key Vault.

properties.password
  • string

Mot de passe du certificat.

properties.pfxBlob
  • string

Objet blob Pfx.

properties.publicKeyHash
  • string

Hachage de clé publique.

properties.selfLink
  • string

Lien automatique.

properties.serverFarmId
  • string

ID de ressource du plan de App Service associé, mis en forme comme : « /abonnements/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName} ».

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 ?.

tags
  • object

Balises de ressource.

type
  • string

Type de ressource.

DefaultErrorResponse

App Service réponse d’erreur.

Name Type Description
error

Modèle d’erreur.

Details

Name Type Description
code
  • string

Chaîne standardisée pour identifier par programmation l’erreur.

message
  • string

Description détaillée des erreurs et informations de débogage.

target
  • string

Description détaillée des erreurs et informations de débogage.

Error

Modèle d’erreur.

Name Type Description
code
  • string

Chaîne standardisée pour identifier par programmation l’erreur.

details

Erreurs détaillées.

innererror
  • string

Plus d’informations sur l’erreur de débogage.

message
  • string

Description détaillée des erreurs et informations de débogage.

target
  • string

Description détaillée des erreurs et informations de débogage.

HostingEnvironmentProfile

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

Name Type Description
id
  • string

ID de ressource du App Service Environment.

name
  • string

Nom du App Service Environment.

type
  • string

Type de ressource du App Service Environment.

KeyVaultSecretStatus

État du secret Key Vault.

Name Type Description
AzureServiceUnauthorizedToAccessKeyVault
  • string
CertificateOrderFailed
  • string
ExternalPrivateKey
  • string
Initialized
  • string
KeyVaultDoesNotExist
  • string
KeyVaultSecretDoesNotExist
  • string
OperationNotPermittedOnKeyVault
  • string
Succeeded
  • string
Unknown
  • string
UnknownError
  • string
WaitingOnCertificateOrder
  • string