Certificates - Create Or Update

Ссылка

Service:: App Service

API Version:: 2023-12-01

Описание Create или обновления сертификата.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
name	path	True	string	Имя сертификата.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой принадлежит ресурс. Regex pattern: `^[-\w\._]+[^\.]$`
subscriptionId	path	True	string	Идентификатор вашей подписки Azure. Это строка в формате GUID (например, 0000000-0000-0000-0000-0000-000000000000).
api-version	query	True	string	Версия API

Текст запроса

Имя	Обязательно	Тип	Описание
location	True	string	Расположение ресурса.
kind		string	Тип ресурса.
properties.canonicalName		string	CNAME сертификата, выдаваемого с помощью бесплатного сертификата
properties.domainValidationMethod		string	Метод проверки домена для бесплатного сертификата
properties.hostNames		string[]	Имя узла, к которому применяется сертификат.
properties.keyVaultId		string	Key Vault идентификатор ресурса Csm.
properties.keyVaultSecretName		string	Key Vault имя секрета.
properties.password		string	Пароль сертификата.
properties.pfxBlob		string	Большой двоичный объект Pfx.
properties.serverFarmId		string	Идентификатор ресурса связанного плана Служба приложений в формате "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	Certificate	Все в порядке.
Other Status Codes	DefaultErrorResponse	Служба приложений ответ об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

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

Scopes

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Create Or Update Certificate

Sample Request

HTTP

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

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

Sample Response

Status code:: 200

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

Определения

Имя	Описание
Certificate	SSL-сертификат для приложения.
DefaultErrorResponse	Служба приложений ответ об ошибке.
Details
Error	Модель ошибок.
HostingEnvironmentProfile	Спецификация для Среда службы приложений, используемого для этого ресурса.
KeyVaultSecretStatus	Состояние секрета Key Vault.

Certificate

SSL-сертификат для приложения.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
kind	string	Тип ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.canonicalName	string	CNAME сертификата, выдаваемого с помощью бесплатного сертификата
properties.cerBlob	string	Необработанные байты файла .cer
properties.domainValidationMethod	string	Метод проверки домена для бесплатного сертификата
properties.expirationDate	string	Дата окончания срока действия сертификата.
properties.friendlyName	string	Понятное имя сертификата.
properties.hostNames	string[]	Имя узла, к которому применяется сертификат.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Спецификация для Среда службы приложений, используемого для сертификата.
properties.issueDate	string	Дата выдачи сертификата.
properties.issuer	string	Издатель сертификата.
properties.keyVaultId	string	Key Vault идентификатор ресурса Csm.
properties.keyVaultSecretName	string	Key Vault имя секрета.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Состояние секрета Key Vault.
properties.password	string	Пароль сертификата.
properties.pfxBlob	string	Большой двоичный объект Pfx.
properties.publicKeyHash	string	Хэш открытого ключа.
properties.selfLink	string	Ссылка на себя.
properties.serverFarmId	string	Идентификатор ресурса связанного плана Служба приложений в формате "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".
properties.siteName	string	Имя приложения.
properties.subjectName	string	Имя субъекта сертификата.
properties.thumbprint	string	Отпечаток сертификата.
properties.valid	boolean	Является ли сертификат допустимым?.
tags	object	Теги ресурсов.
type	string	Тип ресурса.

DefaultErrorResponse

Служба приложений ответ об ошибке.

Имя	Тип	Описание
error	Error	Модель ошибок.

Details

Имя	Тип	Описание
code	string	Стандартизированная строка для программной идентификации ошибки.
message	string	Подробное описание ошибки и сведения об отладке.
target	string	Подробное описание ошибки и сведения об отладке.

Error

Модель ошибок.

Имя	Тип	Описание
code	string	Стандартизированная строка для программной идентификации ошибки.
details	Details[]	Подробные сведения об ошибках.
innererror	string	Дополнительные сведения об ошибке отладки.
message	string	Подробное описание ошибки и сведения об отладке.
target	string	Подробное описание ошибки и сведения об отладке.

HostingEnvironmentProfile

Спецификация для Среда службы приложений, используемого для этого ресурса.

Имя	Тип	Описание
id	string	Идентификатор ресурса Среда службы приложений.
name	string	Имя Среда службы приложений.
type	string	Тип ресурса Среда службы приложений.

KeyVaultSecretStatus

Состояние секрета Key Vault.

Имя	Тип	Описание
AzureServiceUnauthorizedToAccessKeyVault	string
CertificateOrderFailed	string
ExternalPrivateKey	string
Initialized	string
KeyVaultDoesNotExist	string
KeyVaultSecretDoesNotExist	string
OperationNotPermittedOnKeyVault	string
Succeeded	string
Unknown	string
UnknownError	string
WaitingOnCertificateOrder	string