Compartir a través de


Certificates - Create Or Update

Descripción de Create o actualización de un certificado.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
name
path True

string

Nombre del certificado.

resourceGroupName
path True

string

Nombre del grupo de recursos al que pertenece el recurso.

Patrón de Regex: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True

string

Su identificador de suscripción de Azure. Se trata de una cadena con formato GUID (por ejemplo, 000000000-0000-0000-0000-00000000000000).

api-version
query True

string

Versión de la API

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación del recurso.

kind

string

Tipo de recurso.

properties.canonicalName

string

CNAME del certificado que se va a emitir a través de un certificado gratuito

properties.domainValidationMethod

string

Método de validación de dominio para el certificado gratuito

properties.hostNames

string[]

Nombres de host a los que se aplica el certificado.

properties.keyVaultId

string

Key Vault identificador de recurso de Csm.

properties.keyVaultSecretName

string

Key Vault nombre del secreto.

properties.password

string

Contraseña del certificado.

properties.pfxBlob

string

Blob Pfx.

properties.serverFarmId

string

Identificador de recurso del plan de App Service asociado, con formato: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

Certificate

Aceptar.

Other Status Codes

DefaultErrorResponse

App Service respuesta de error.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

Create Or Update Certificate

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
Certificate

Certificado SSL para una aplicación.

DefaultErrorResponse

App Service respuesta de error.

Details
Error

Modelo de error.

HostingEnvironmentProfile

Especificación de un App Service Environment que se va a usar para este recurso.

KeyVaultSecretStatus

Estado del secreto de Key Vault.

Certificate

Certificado SSL para una aplicación.

Nombre Tipo Description
id

string

Id. de recurso.

kind

string

Tipo de recurso.

location

string

Ubicación del recurso.

name

string

Nombre del recurso.

properties.canonicalName

string

CNAME del certificado que se va a emitir a través de un certificado gratuito

properties.cerBlob

string

Bytes sin formato del archivo de .cer

properties.domainValidationMethod

string

Método de validación de dominio para el certificado gratuito

properties.expirationDate

string

Fecha de expiración del certificado.

properties.friendlyName

string

Nombre descriptivo del certificado.

properties.hostNames

string[]

Nombres de host a los que se aplica el certificado.

properties.hostingEnvironmentProfile

HostingEnvironmentProfile

Especificación del App Service Environment que se va a usar para el certificado.

properties.issueDate

string

Fecha de emisión del certificado.

properties.issuer

string

Emisor de certificados.

properties.keyVaultId

string

Key Vault identificador de recurso de Csm.

properties.keyVaultSecretName

string

Key Vault nombre del secreto.

properties.keyVaultSecretStatus

KeyVaultSecretStatus

Estado del secreto de Key Vault.

properties.password

string

Contraseña del certificado.

properties.pfxBlob

string

Blob Pfx.

properties.publicKeyHash

string

Hash de clave pública.

properties.selfLink

string

Auto link.

properties.serverFarmId

string

Identificador de recurso del plan de App Service asociado, con formato: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".

properties.siteName

string

Nombre de la aplicación.

properties.subjectName

string

Nombre del firmante del certificado.

properties.thumbprint

string

Huella digital del certificado.

properties.valid

boolean

¿Es válido el certificado?

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso.

DefaultErrorResponse

App Service respuesta de error.

Nombre Tipo Description
error

Error

Modelo de error.

Details

Nombre Tipo Description
code

string

Cadena estandarizada para identificar mediante programación el error.

message

string

Descripción detallada del error e información de depuración.

target

string

Descripción detallada del error e información de depuración.

Error

Modelo de error.

Nombre Tipo Description
code

string

Cadena estandarizada para identificar mediante programación el error.

details

Details[]

Errores detallados.

innererror

string

Más información para depurar el error.

message

string

Descripción detallada del error e información de depuración.

target

string

Descripción detallada del error e información de depuración.

HostingEnvironmentProfile

Especificación de un App Service Environment que se va a usar para este recurso.

Nombre Tipo Description
id

string

Identificador de recurso del App Service Environment.

name

string

Nombre del App Service Environment.

type

string

Tipo de recurso del App Service Environment.

KeyVaultSecretStatus

Estado del secreto de Key Vault.

Nombre Tipo Description
AzureServiceUnauthorizedToAccessKeyVault

string

CertificateOrderFailed

string

ExternalPrivateKey

string

Initialized

string

KeyVaultDoesNotExist

string

KeyVaultSecretDoesNotExist

string

OperationNotPermittedOnKeyVault

string

Succeeded

string

Unknown

string

UnknownError

string

WaitingOnCertificateOrder

string