Certificates - Create Or Update

Descrição para Criar ou atualizar um certificado.

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

Parâmetros do URI

Name In Required Type Description
name
path True
  • string

O nome do certificado.

resourceGroupName
path True
  • string

Nome do grupo de recursos a que pertence o recurso.

Regex pattern: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True
  • string

O seu ID de subscrição do Azure. Trata-se de uma corda formatada pelo GUID (por exemplo, 0000000-0000-0000-0000-0000-0000000000000000000).

api-version
query True
  • string

Versão da API

Corpo do Pedido

Name Required Type Description
location True
  • string

Localização de Recursos.

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 cert gratuito

properties.hostNames
  • string[]

Os nomes dos anfitriões a que o certificado se aplica.

properties.keyVaultId
  • string

Key Vault Id de recursos CSM.

properties.keyVaultSecretName
  • string

Key Vault nome secreto.

properties.password
  • string

Senha de certificado.

properties.pfxBlob
  • string

Bolha Pfx.

properties.serverFarmId
  • string

ID de recursos do plano de Serviço de Aplicações associado, formatado como: "/subscrições/{subscriçãoID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".

tags
  • object

Etiquetas de recursos.

Respostas

Name Type Description
200 OK

OK.

Other Status Codes

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

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

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=2022-03-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"
  }
}

Definições

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 um Ambiente do Serviço de Aplicações a utilizar para este recurso.

KeyVaultSecretStatus

O estado do Key Vault segredo.

Certificate

Certificado SSL para uma aplicação.

Name Type Description
id
  • string

Identificação de recursos.

kind
  • string

Tipo de recurso.

location
  • string

Localização de Recursos.

name
  • string

Nome de recurso.

properties.canonicalName
  • string

CNAME do certificado a emitir através de certificado gratuito

properties.cerBlob
  • string

Bytes crus de arquivo .cer

properties.domainValidationMethod
  • string

Método de validação de domínio para cert gratuito

properties.expirationDate
  • string

Data de validade do certificado.

properties.friendlyName
  • string

Nome amigável do certificado.

properties.hostNames
  • string[]

Os nomes dos anfitriões a que o certificado se aplica.

properties.hostingEnvironmentProfile

Especificação para o Ambiente do Serviço de Aplicações a utilizar para o certificado.

properties.issueDate
  • string

Emissão de certificado Data.

properties.issuer
  • string

Emitente de certificado.

properties.keyVaultId
  • string

Key Vault Id de recursos CSM.

properties.keyVaultSecretName
  • string

Key Vault nome secreto.

properties.keyVaultSecretStatus

O estado do Key Vault segredo.

properties.password
  • string

Senha de certificado.

properties.pfxBlob
  • string

Bolha Pfx.

properties.publicKeyHash
  • string

Hash chave pública.

properties.selfLink
  • string

Auto-ligação.

properties.serverFarmId
  • string

ID de recursos do plano de Serviço de Aplicações associado, formatado como: "/subscrições/{subscriçãoID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".

properties.siteName
  • string

Nome da aplicação.

properties.subjectName
  • string

Nome do sujeito do certificado.

properties.thumbprint
  • string

Impressão digital 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 Type Description
error

Modelo de erro.

Details

Name Type Description
code
  • string

Cadeia padronizada para identificar programáticamente o erro.

message
  • string

Descrição detalhada do erro e depuragem de informação.

target
  • string

Descrição detalhada do erro e depuragem de informação.

Error

Modelo de erro.

Name Type Description
code
  • string

Cadeia padronizada para identificar programáticamente o erro.

details

Erros detalhados.

innererror
  • string

Mais informações para depurar erro.

message
  • string

Descrição detalhada do erro e depuragem de informação.

target
  • string

Descrição detalhada do erro e depuragem de informação.

HostingEnvironmentProfile

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

Name Type Description
id
  • string

Identificação de recursos do Ambiente do Serviço de Aplicações.

name
  • string

O nome do Ambiente do Serviço de Aplicações.

type
  • string

Tipo de recurso do Ambiente do Serviço de Aplicações.

KeyVaultSecretStatus

O estado do Key Vault segredo.

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