Microsoft.Web certificates 2021-01-01
Definición de recursos de Bicep
El tipo de recurso certificates se puede implementar con operaciones que tienen como destino:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Web/certificates, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.Web/certificates@2021-01-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
kind: 'string'
properties: {
canonicalName: 'string'
domainValidationMethod: 'string'
hostNames: [
'string'
]
keyVaultId: 'string'
keyVaultSecretName: 'string'
password: 'string'
pfxBlob: any()
serverFarmId: 'string'
}
}
Valores de propiedad
certificates
| Nombre | Descripción | Value |
|---|---|---|
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 1-260 Caracteres válidos: No puede usar: / No puede terminar con un espacio ni punto. |
| ubicación | Ubicación del recurso. | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| kind | Tipo de recurso. | string |
| properties | Propiedades específicas del recurso de certificado | CertificateProperties |
CertificateProperties
| Nombre | Descripción | Valor |
|---|---|---|
| canonicalName | CNAME del certificado que se va a emitir a través de un certificado gratuito | string |
| domainValidationMethod | Método de validación de dominio para el certificado gratuito | string |
| Nombres | Nombres de host a los que se aplica el certificado. | string[] |
| keyVaultId | Key Vault identificador de recurso de Csm. | string |
| keyVaultSecretName | Key Vault nombre del secreto. | string |
| password | Contraseña del certificado. | string |
| pfxBlob | Blob Pfx. | Para Bicep, puede usar la función any(). |
| serverFarmId | Identificador de recurso del plan de App Service asociado, con formato: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
Creación y asignación de un certificado de App Service estándar |
Crea un certificado App Service estándar, lo comprueba mediante una aplicación de App Service y crea enlaces SSL una vez que el certificado está listo. |
| Creación y asignación de un certificado comodín App Service |
Crea un certificado comodín App Service, lo comprueba mediante un dominio de App Service y crea enlaces SSL en una aplicación App Service una vez que el certificado esté listo. |
| Creación de un certificado administrado de App Services |
Creación de un certificado administrado (gratis) APEX (dominio raíz) para WebApp |
| Certificado SSL para un ASE de ILB o un ASE de ILB v2 |
Configuración del certificado SSL predeterminado para un entorno ASE con ILB o un entorno ASE v2 con ILB |
| Integración de aplicaciones web con Key Vault |
Implementación de un certificado de aplicación web desde Key Vault secreto y usarlo para crear un enlace SSL |
| Aplicación web con un dominio personalizado y un enlace SSL opcional |
Cree una aplicación web y con un dominio personalizado y, opcionalmente, agregue un certificado SSL para el cifrado https. |
Definición de recursos de plantilla de ARM
El tipo de recurso certificates se puede implementar con operaciones que tienen como destino:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Web/certificates, agregue el siguiente json a la plantilla.
{
"type": "Microsoft.Web/certificates",
"apiVersion": "2021-01-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"kind": "string",
"properties": {
"canonicalName": "string",
"domainValidationMethod": "string",
"hostNames": [ "string" ],
"keyVaultId": "string",
"keyVaultSecretName": "string",
"password": "string",
"pfxBlob": {},
"serverFarmId": "string"
}
}
Valores de propiedad
certificates
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | 'Microsoft.Web/certificates' |
| apiVersion | La versión de la API de recursos | '2021-01-01' |
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 1-260 Caracteres válidos: No puede usar: / No puede terminar con un espacio ni punto. |
| ubicación | Ubicación del recurso. | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| kind | Tipo de recurso. | string |
| properties | Propiedades específicas del recurso de certificado | CertificateProperties |
CertificateProperties
| Nombre | Descripción | Valor |
|---|---|---|
| canonicalName | CNAME del certificado que se va a emitir a través de un certificado gratuito | string |
| domainValidationMethod | Método de validación de dominio para un certificado gratuito | string |
| Nombres | Nombres de host a los que se aplica el certificado. | string[] |
| keyVaultId | Key Vault id. de recurso de Csm. | string |
| keyVaultSecretName | Key Vault nombre del secreto. | string |
| password | Contraseña del certificado. | string |
| pfxBlob | Blob Pfx. | |
| serverFarmId | Identificador de recurso del plan de App Service asociado, con formato "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
| Creación y asignación de un certificado de App Service estándar |
Crea un certificado App Service estándar, lo comprueba mediante una aplicación de App Service y crea enlaces SSL una vez que el certificado está listo. |
| Creación y asignación de un certificado de App Service comodín |
Crea un certificado comodín App Service, lo comprueba mediante un dominio de App Service y crea enlaces SSL en una aplicación de App Service una vez que el certificado esté listo. |
| Creación de un certificado administrado de App Services |
Creación de un certificado administrado (gratis) APEX (dominio raíz) para WebApp |
| Certificado SSL para un ASE de ILB o un ASE de ILB v2 |
Configuración del certificado SSL predeterminado para un entorno ASE con ILB o un entorno ASE v2 con ILB |
| Integración de aplicaciones web con Key Vault |
Implementación de un certificado de aplicación web desde Key Vault secreto y usarlo para crear un enlace SSL |
| Aplicación web con un dominio personalizado y un enlace SSL opcional |
Cree una aplicación web y con un dominio personalizado y, opcionalmente, agregue un certificado SSL para el cifrado https. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso certificates se puede implementar con operaciones destinadas a:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Web/certificates, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Web/certificates@2021-01-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
canonicalName = "string"
domainValidationMethod = "string"
hostNames = [
"string"
]
keyVaultId = "string"
keyVaultSecretName = "string"
password = "string"
serverFarmId = "string"
}
kind = "string"
})
}
Valores de propiedad
certificates
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.Web/certificates@2021-01-01" |
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 1-260 Caracteres válidos: No puede usar: / No puede terminar con un espacio ni punto. |
| ubicación | Ubicación del recurso. | string (obligatorio) |
| parent_id | Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. |
| kind | Tipo de recurso. | string |
| properties | Propiedades específicas del recurso de certificado | CertificateProperties |
CertificateProperties
| Nombre | Descripción | Value |
|---|---|---|
| canonicalName | CNAME del certificado que se va a emitir a través de un certificado gratuito | string |
| domainValidationMethod | Método de validación de dominio para el certificado gratuito | string |
| Nombres | Nombres de host a los que se aplica el certificado. | string[] |
| keyVaultId | Key Vault identificador de recurso de Csm. | string |
| keyVaultSecretName | Key Vault nombre del secreto. | string |
| password | Contraseña del certificado. | string |
| pfxBlob | Blob Pfx. | |
| serverFarmId | Identificador de recurso del plan de App Service asociado, con formato: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". | string |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de