Certificates - Create Or Update

Layanan:: App Service

Versi API:: 2026-07-15

Deskripsi untuk Membuat atau memperbarui sertifikat.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
name	path	True	string	Nama sertifikat.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
location	True	string	Lokasi geografis tempat sumber daya berada
kind		string	Jenis sumber daya. Jika sumber daya adalah aplikasi, Anda dapat merujuk ke https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference untuk detail nilai yang didukung untuk jenisnya.
properties.canonicalName		string	CNAME sertifikat yang akan dikeluarkan melalui sertifikat gratis
properties.domainValidationMethod		string	Metode validasi domain untuk sertifikasi gratis
properties.hostNames		string[]	Nama host yang berlaku untuk sertifikat.
properties.keyVaultId		string (arm-id)	Id sumber daya Azure Key Vault Csm.
properties.keyVaultSecretName		string	Nama rahasia Azure Key Vault.
properties.password		string	Kata sandi sertifikat.
properties.pfxBlob		string (byte)	Blob Pfx.
properties.serverFarmId		string (arm-id)	ID Sumber Daya paket App Service terkait.
tags		object	Tag sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	Certificate	Operasi pembaruan 'Sertifikat' sumber daya berhasil
Other Status Codes	DefaultErrorResponse	Respons kesalahan yang tidak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Create Or Update Certificate

Permintaan sampel

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

Respon sampel

Kode status:: 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"
  }
}

Definisi

Nama	Deskripsi
Certificate	Sertifikat SSL untuk aplikasi.
createdByType	Jenis identitas yang membuat sumber daya tersebut.
DefaultErrorResponse	Respons kesalahan App Service.
DefaultErrorResponseError	Model kesalahan.
DefaultErrorResponseErrorDetailsItem	Kesalahan terperinci.
HostingEnvironmentProfile	Spesifikasi untuk App Service Environment yang akan digunakan untuk sumber daya ini.
KeyVaultSecretStatus	Status rahasia Key Vault.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Certificate

Objek

Sertifikat SSL untuk aplikasi.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya lengkap untuk sumber daya tersebut. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Jenis sumber daya. Jika sumber daya adalah aplikasi, Anda dapat merujuk ke https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference untuk detail nilai yang didukung untuk jenisnya.
location	string	Lokasi geografis tempat sumber daya berada
name	string	Nama sumber daya.
properties.canonicalName	string	CNAME sertifikat yang akan dikeluarkan melalui sertifikat gratis
properties.cerBlob	string (byte)	Byte mentah file .cer
properties.domainValidationMethod	string	Metode validasi domain untuk sertifikasi gratis
properties.expirationDate	string (date-time)	Tanggal kedaluwarsa sertifikat.
properties.friendlyName	string	Nama sertifikat yang ramah.
properties.hostNames	string[]	Nama host yang berlaku untuk sertifikat.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Spesifikasi untuk App Service Environment yang akan digunakan untuk sertifikat.
properties.issueDate	string (date-time)	Tanggal penerbitan sertifikat.
properties.issuer	string	Penerbit sertifikat.
properties.keyVaultId	string (arm-id)	Id sumber daya Azure Key Vault Csm.
properties.keyVaultSecretName	string	Nama rahasia Azure Key Vault.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Status rahasia Key Vault.
properties.password	string	Kata sandi sertifikat.
properties.pfxBlob	string (byte)	Blob Pfx.
properties.publicKeyHash	string	Hash kunci umum.
properties.selfLink	string	Tautan mandiri.
properties.serverFarmId	string (arm-id)	ID Sumber Daya paket App Service terkait.
properties.siteName	string	Nama aplikasi.
properties.subjectName	string	Nama subjek sertifikat.
properties.thumbprint	string	Thumbprint sertifikat.
properties.valid	boolean	Apakah sertifikat valid?.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya tersebut.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Objek

Respons kesalahan App Service.

Nama	Jenis	Deskripsi
error	DefaultErrorResponseError	Model kesalahan.

DefaultErrorResponseError

Objek

Model kesalahan.

Nama	Jenis	Deskripsi
code	string	String standar untuk mengidentifikasi kesalahan secara terprogram.
details	DefaultErrorResponseErrorDetailsItem[]	Kesalahan terperinci.
innererror	string	Informasi selengkapnya untuk men-debug kesalahan.
message	string	Deskripsi kesalahan terperinci dan informasi debugging.
target	string	Deskripsi kesalahan terperinci dan informasi debugging.

DefaultErrorResponseErrorDetailsItem

Objek

Kesalahan terperinci.

Nama	Jenis	Deskripsi
code	string	String standar untuk mengidentifikasi kesalahan secara terprogram.
message	string	Deskripsi kesalahan terperinci dan informasi debugging.
target	string	Deskripsi kesalahan terperinci dan informasi debugging.

HostingEnvironmentProfile

Objek

Spesifikasi untuk App Service Environment yang akan digunakan untuk sumber daya ini.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya Lingkungan App Service.
name	string	Nama App Service Environment.
type	string	Jenis sumber daya App Service Environment.

KeyVaultSecretStatus

Enumerasi

Status rahasia Key Vault.

Nilai	Deskripsi
Initialized
WaitingOnCertificateOrder
Succeeded
CertificateOrderFailed
OperationNotPermittedOnKeyVault
AzureServiceUnauthorizedToAccessKeyVault
KeyVaultDoesNotExist
KeyVaultSecretDoesNotExist
UnknownError
ExternalPrivateKey
Unknown

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya tersebut.
createdByType	createdByType	Jenis identitas yang membuat sumber daya tersebut.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir kali mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.