Certificates - Create Or Update

Referência

Service:: App Service

API Version:: 2023-12-01

Descrição para Create ou atualizar um certificado.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
name	path	True	string	Nome do certificado.
resourceGroupName	path	True	string	Nome do grupo de recursos ao qual o recurso pertence. Regex pattern: `^[-\w\._]+[^\.]$`
subscriptionId	path	True	string	O seu ID de subscrição do Azure. Esta é uma cadeia formatada com GUID (por exemplo, 000000000-0000-0000-0000-000000000000).
api-version	query	True	string	Versão da API

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	Localização do Recurso.
kind		string	Tipo de recurso.
properties.canonicalName		string	CNAME do certificado a emitir através de certificado gratuito
properties.domainValidationMethod		string	Método de validação de domínio para certificado gratuito
properties.hostNames		string[]	Nomes de anfitrião a que o certificado se aplica.
properties.keyVaultId		string	Key Vault ID de recurso do CSM.
properties.keyVaultSecretName		string	Key Vault nome do segredo.
properties.password		string	Palavra-passe do certificado.
properties.pfxBlob		string	Blob Pfx.
properties.serverFarmId		string	ID de recurso do plano de Serviço de Aplicações associado, formatado como: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".
tags		object	Etiquetas de recursos.

Respostas

Name	Tipo	Description
200 OK	Certificate	OK.
Other Status Codes	DefaultErrorResponse	Serviço de Aplicações resposta de erro.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Scopes

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

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

Definições

Name	Description
Certificate	Certificado SSL para uma aplicação.
DefaultErrorResponse	Serviço de Aplicações resposta de erro.
Details
Error	Modelo de erro.
HostingEnvironmentProfile	Especificação para uma Ambiente do Serviço de Aplicações a utilizar para este recurso.
KeyVaultSecretStatus	Estado do segredo Key Vault.

Certificate

Certificado SSL para uma aplicação.

Name	Tipo	Description
id	string	ID do Recurso.
kind	string	Tipo de recurso.
location	string	Localização do Recurso.
name	string	Nome do Recurso.
properties.canonicalName	string	CNAME do certificado a emitir através de certificado gratuito
properties.cerBlob	string	Bytes não processados de .cer ficheiro
properties.domainValidationMethod	string	Método de validação de domínio para certificado gratuito
properties.expirationDate	string	Data de expiração do certificado.
properties.friendlyName	string	Nome amigável do certificado.
properties.hostNames	string[]	Nomes de anfitrião a que o certificado se aplica.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Especificação da Ambiente do Serviço de Aplicações a utilizar para o certificado.
properties.issueDate	string	Data do problema do certificado.
properties.issuer	string	Emissor de certificados.
properties.keyVaultId	string	Key Vault ID de recurso do CSM.
properties.keyVaultSecretName	string	Key Vault nome do segredo.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Estado do segredo Key Vault.
properties.password	string	Palavra-passe do certificado.
properties.pfxBlob	string	Blob Pfx.
properties.publicKeyHash	string	Hash chave pública.
properties.selfLink	string	Ligação automática.
properties.serverFarmId	string	ID de recurso do plano de Serviço de Aplicações associado, formatado como: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".
properties.siteName	string	Nome da aplicação.
properties.subjectName	string	Nome do requerente do certificado.
properties.thumbprint	string	Thumbprint do certificado.
properties.valid	boolean	O certificado é válido?
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.

DefaultErrorResponse

Serviço de Aplicações resposta de erro.

Name	Tipo	Description
error	Error	Modelo de erro.

Details

Name	Tipo	Description
code	string	Cadeia padronizada para identificar programaticamente o erro.
message	string	Descrição detalhada do erro e informações de depuração.
target	string	Descrição detalhada do erro e informações de depuração.

Error

Modelo de erro.

Name	Tipo	Description
code	string	Cadeia padronizada para identificar programaticamente o erro.
details	Details[]	Erros detalhados.
innererror	string	Mais informações para depurar o erro.
message	string	Descrição detalhada do erro e informações de depuração.
target	string	Descrição detalhada do erro e informações de depuração.

HostingEnvironmentProfile

Especificação para uma Ambiente do Serviço de Aplicações a utilizar para este recurso.

Name	Tipo	Description
id	string	ID do recurso do Ambiente do Serviço de Aplicações.
name	string	Nome do Ambiente do Serviço de Aplicações.
type	string	Tipo de recurso do Ambiente do Serviço de Aplicações.

KeyVaultSecretStatus

Estado do segredo Key Vault.

Name	Tipo	Description
AzureServiceUnauthorizedToAccessKeyVault	string
CertificateOrderFailed	string
ExternalPrivateKey	string
Initialized	string
KeyVaultDoesNotExist	string
KeyVaultSecretDoesNotExist	string
OperationNotPermittedOnKeyVault	string
Succeeded	string
Unknown	string
UnknownError	string
WaitingOnCertificateOrder	string