Certificates - Create Or Update

Descrizione per Creare o aggiornare un certificato.

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

Parametri dell'URI

Name In Required Type Description
name
path True
  • string

Nome del certificato.

resourceGroupName
path True
  • string

Nome del gruppo di risorse a cui appartiene la risorsa.

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

subscriptionId
path True
  • string

L'ID sottoscrizione di Azure. Si tratta di una stringa con formato GUID (ad esempio 00000000000-0000-0000-0000-00000000000000000000).

api-version
query True
  • string

Versione API

Corpo della richiesta

Name Required Type Description
location True
  • string

Posizione risorsa.

kind
  • string

Tipo di risorsa.

properties.canonicalName
  • string

CNAME del certificato da rilasciare tramite certificato gratuito

properties.domainValidationMethod
  • string

Metodo di convalida del dominio per certificato gratuito

properties.hostNames
  • string[]

Nomi host a cui si applica il certificato.

properties.keyVaultId
  • string

Key Vault ID risorsa Csm.

properties.keyVaultSecretName
  • string

Key Vault nome segreto.

properties.password
  • string

Password del certificato.

properties.pfxBlob
  • string

BLOB Pfx.

properties.serverFarmId
  • string

ID risorsa del piano di servizio app associato, formattato come :"/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".

tags
  • object

Tag di risorse.

Risposte

Name Type Description
200 OK

OK.

Other Status Codes

servizio app risposta di errore.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

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

Definizioni

Certificate

Certificato SSL per un'app.

DefaultErrorResponse

servizio app risposta di errore.

Details
Error

Modello di errore.

HostingEnvironmentProfile

Specifica per un ambiente del servizio app da usare per questa risorsa.

KeyVaultSecretStatus

Stato del segreto Key Vault.

Certificate

Certificato SSL per un'app.

Name Type Description
id
  • string

ID risorsa.

kind
  • string

Tipo di risorsa.

location
  • string

Posizione risorsa.

name
  • string

Nome risorsa.

properties.canonicalName
  • string

CNAME del certificato da rilasciare tramite certificato gratuito

properties.cerBlob
  • string

Byte non elaborati del file cer

properties.domainValidationMethod
  • string

Metodo di convalida del dominio per certificato gratuito

properties.expirationDate
  • string

Data di scadenza del certificato.

properties.friendlyName
  • string

Nome descrittivo del certificato.

properties.hostNames
  • string[]

Nomi host a cui si applica il certificato.

properties.hostingEnvironmentProfile

Specifica per l'ambiente del servizio app da usare per il certificato.

properties.issueDate
  • string

Data del problema del certificato.

properties.issuer
  • string

Autorità di certificazione.

properties.keyVaultId
  • string

Key Vault ID risorsa Csm.

properties.keyVaultSecretName
  • string

Key Vault nome segreto.

properties.keyVaultSecretStatus

Stato del segreto Key Vault.

properties.password
  • string

Password del certificato.

properties.pfxBlob
  • string

BLOB Pfx.

properties.publicKeyHash
  • string

Hash della chiave pubblica.

properties.selfLink
  • string

Collegamento automatico.

properties.serverFarmId
  • string

ID risorsa del piano di servizio app associato, formattato come :"/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".

properties.siteName
  • string

Nome dell'app.

properties.subjectName
  • string

Nome soggetto del certificato.

properties.thumbprint
  • string

Identificazione personale del certificato.

properties.valid
  • boolean

Il certificato è valido?.

tags
  • object

Tag di risorse.

type
  • string

Tipo di risorsa.

DefaultErrorResponse

servizio app risposta di errore.

Name Type Description
error

Modello di errore.

Details

Name Type Description
code
  • string

Stringa standardizzata per identificare a livello di codice l'errore.

message
  • string

Descrizione dettagliata dell'errore e informazioni di debug.

target
  • string

Descrizione dettagliata dell'errore e informazioni di debug.

Error

Modello di errore.

Name Type Description
code
  • string

Stringa standardizzata per identificare a livello di codice l'errore.

details

Errori dettagliati.

innererror
  • string

Altre informazioni per eseguire il debug dell'errore.

message
  • string

Descrizione dettagliata dell'errore e informazioni di debug.

target
  • string

Descrizione dettagliata dell'errore e informazioni di debug.

HostingEnvironmentProfile

Specifica per un ambiente del servizio app da usare per questa risorsa.

Name Type Description
id
  • string

ID risorsa del ambiente del servizio app.

name
  • string

Nome della ambiente del servizio app.

type
  • string

Tipo di risorsa del ambiente del servizio app.

KeyVaultSecretStatus

Stato del segreto 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