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=2019-08-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 in formato GUID ,ad esempio 00000000-0000-0000-0000-00000000000000000.

api-version
query True
  • string

Versione API

Corpo della richiesta

Name Required Type Description
location True
  • string

Percorso della risorsa.

properties.password True
  • string

Password del certificato.

kind
  • string

Tipo di risorsa.

properties.canonicalName
  • string

CNAME del certificato da emesso tramite 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 del segreto.

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 delle risorse.

Risposte

Name Type Description
200 OK

OK.

Other Status Codes

Risposta di errore del servizio app.

Sicurezza

azure_auth

Azure Active Directory flusso OAuth2

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=2019-08-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",
    "password": "<password>"
  }
}

Definizioni

Certificate

Certificato SSL per un'app.

DefaultErrorResponse

Risposta di errore del servizio app.

Details
Error

Modello di errore.

HostingEnvironmentProfile

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

KeyVaultSecretStatus

Stato del Key Vault segreto.

Certificate

Certificato SSL per un'app.

Name Type Description
id
  • string

ID risorsa.

kind
  • string

Tipo di risorsa.

location
  • string

Percorso della risorsa.

name
  • string

Nome risorsa.

properties.canonicalName
  • string

CNAME del certificato da emesso tramite certificato gratuito

properties.cerBlob
  • string

Byte non elaborati del file con estensione cer

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 il ambiente del servizio app da usare per il certificato.

properties.issueDate
  • string

Data di rilascio del certificato.

properties.issuer
  • string

Autorità di certificazione.

properties.keyVaultId
  • string

Key Vault ID risorsa Csm.

properties.keyVaultSecretName
  • string

Key Vault nome del segreto.

properties.keyVaultSecretStatus

Stato del Key Vault segreto.

properties.password
  • string

Password del certificato.

properties.pfxBlob
  • string

BLOB Pfx.

properties.publicKeyHash
  • string

Hash della chiave pubblica.

properties.selfLink
  • string

Collegamento self-service.

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 delle risorse.

type
  • string

Tipo di risorsa.

DefaultErrorResponse

Risposta di errore del servizio app.

Name Type Description
error

Modello di errore.

Details

Name Type Description
code
  • string

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

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 l'errore a livello di codice.

details

Errori dettagliati.

innererror
  • string

Altre informazioni per eseguire il debug degli errori.

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 dell'ambiente del servizio app.

name
  • string

Nome del ambiente del servizio app.

type
  • string

Tipo di risorsa dell'ambiente del servizio app.

KeyVaultSecretStatus

Stato del Key Vault segreto.

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