Certificates - Create Or Update

Služba:: App Service

Verze rozhraní API:: 2026-07-15

Popis pro Vytvoření nebo aktualizaci certifikátu.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
name	path	True	string	Název certifikátu.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny zdrojů. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
location	True	string	Geografické umístění, ve kterém se nachází zdroj
kind		string	Druh prostředku. Pokud se jedná o prostředek aplikace, můžete se podívat na https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference, kde najdete podrobnosti o podporovaných hodnotách.
properties.canonicalName		string	CNAME certifikátu, který má být vydán prostřednictvím bezplatného certifikátu
properties.domainValidationMethod		string	Metoda ověření domény pro bezplatný certifikát
properties.hostNames		string[]	Názvy hostitelů, na které se certifikát vztahuje.
properties.keyVaultId		string (arm-id)	Azure Key Vault CSM resource Id.
properties.keyVaultSecretName		string	Azure Key Vault secret name.
properties.password		string	Heslo certifikátu.
properties.pfxBlob		string (byte)	Objekt blob Pfx.
properties.serverFarmId		string (arm-id)	ID prostředku přidruženého plánu služby App Service.
tags		object	Štítky prostředků

Odpovědi

Name	Typ	Description
200 OK	Certificate	Aktualizace resource 'Certificate' byla úspěšná
Other Status Codes	DefaultErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 služby Azure Active Directory.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	vydávat se za svůj uživatelský účet

Příklady

Create Or Update Certificate

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
  }
}

Definice

Name	Description
Certificate	SSL certifikát pro aplikaci.
createdByType	Typ identity, která prostředek vytvořila.
DefaultErrorResponse	Odpověď na chybu služby App Service
DefaultErrorResponseError	Chybový model
DefaultErrorResponseErrorDetailsItem	Podrobné chyby.
HostingEnvironmentProfile	Specifikace pro App Service Environment pro použití pro tento zdroj.
KeyVaultSecretStatus	Stav tajemství Key Vault.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

Certificate

Objekt

SSL certifikát pro aplikaci.

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Druh prostředku. Pokud se jedná o prostředek aplikace, můžete se podívat na https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference, kde najdete podrobnosti o podporovaných hodnotách.
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties.canonicalName	string	CNAME certifikátu, který má být vydán prostřednictvím bezplatného certifikátu
properties.cerBlob	string (byte)	Nezpracované bajty souboru .cer
properties.domainValidationMethod	string	Metoda ověření domény pro bezplatný certifikát
properties.expirationDate	string (date-time)	Datum vypršení platnosti certifikátu
properties.friendlyName	string	Popisný název certifikátu.
properties.hostNames	string[]	Názvy hostitelů, na které se certifikát vztahuje.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Specifikace pro App Service Environment pro použití pro certifikát.
properties.issueDate	string (date-time)	Datum vydání certifikátu.
properties.issuer	string	Vystavitel certifikátu.
properties.keyVaultId	string (arm-id)	Azure Key Vault CSM resource Id.
properties.keyVaultSecretName	string	Azure Key Vault secret name.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Stav tajemství Key Vault.
properties.password	string	Heslo certifikátu.
properties.pfxBlob	string (byte)	Objekt blob Pfx.
properties.publicKeyHash	string	Hodnota hash veřejného klíče.
properties.selfLink	string	Vlastní odkaz.
properties.serverFarmId	string (arm-id)	ID prostředku přidruženého plánu služby App Service.
properties.siteName	string	Název aplikace.
properties.subjectName	string	Název subjektu certifikátu.
properties.thumbprint	string	Kryptografický otisk certifikátu
properties.valid	boolean	Je certifikát platný?
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Štítky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Objekt

Odpověď na chybu služby App Service

Name	Typ	Description
error	DefaultErrorResponseError	Chybový model

DefaultErrorResponseError

Objekt

Chybový model

Name	Typ	Description
code	string	Standardizovaný řetězec pro programovou identifikaci chyby.
details	DefaultErrorResponseErrorDetailsItem[]	Podrobné chyby.
innererror	string	Další informace k chybě ladění.
message	string	Podrobný popis chyby a informace o ladění.
target	string	Podrobný popis chyby a informace o ladění.

DefaultErrorResponseErrorDetailsItem

Objekt

Podrobné chyby.

Name	Typ	Description
code	string	Standardizovaný řetězec pro programovou identifikaci chyby.
message	string	Podrobný popis chyby a informace o ladění.
target	string	Podrobný popis chyby a informace o ladění.

HostingEnvironmentProfile

Objekt

Specifikace pro App Service Environment pro použití pro tento zdroj.

Name	Typ	Description
id	string	ID prostředku služby App Service Environment
name	string	Název App Service Environment.
type	string	Typ zdroje App Service Environment.

KeyVaultSecretStatus

Výčet

Stav tajemství Key Vault.

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

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.