Esta es la nueva *Guía de referencia de plantillas de CloudFormation*. Actualice sus marcadores y enlaces. Para obtener ayuda sobre cómo empezar a usar CloudFormation, consulte la [Guía del usuario de AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
# AWSReferencia de tipos de recursos y propiedades de
Esta sección contiene información de referencia para todos los tipos de recursos y propiedades de AWS compatibles con CloudFormation.
Los identificadores del tipo de recursos siempre tienen esta forma:
```
service-provider::service-name::data-type-name
```
**Topics**
+ [Tipos de propiedad compartida](cfn-reference-shared.md)
# Referencia de los tipos de propiedad compartida
Esta sección contiene información de referencia detallada para todos los tipos de propiedades que CloudFormation admite para usar en numerosos tipos de recursos.
**Topics**
+ [Denominación personalizada de recursos de CloudFormation](aws-properties-name.md)
+ [CloudFormationEtiquetado de recursos](aws-properties-resource-tags.md)
# Denominación personalizada de recursos de CloudFormation
Puede asignar nombres personalizados a los tipos de recursos compatibles en su plantilla de CloudFormation para hacerlos más significativos y más fáciles de identificar. De forma predeterminada, CloudFormation genera un ID físico único para nombrar a un recurso. Por ejemplo, CloudFormation podría dar nombre a un bucket de Amazon S3 con el siguiente ID físico `MyStack-MyBucket-abcdefghijk1`. Con nombres personalizados, puede especificar un nombre que sea más fácil de leer e identificar, como `production-app-logs` o `business-metrics`.
No todos los recursos admiten nombres personalizados. Cada servicio de AWS determina de manera independiente qué tipos de recursos admiten nombres personalizados.
Los nombres de recursos debe ser únicos en todas sus pilas activas. Si reutiliza plantillas para crear varias pilas, debe cambiar o eliminar nombres personalizados desde su plantilla. Si no especifica un nombre, CloudFormation genera un ID físico exclusivo para dar nombre al recurso. Los nombres deben empezar por una letra; sólo puede contener letras ASCII, números y guiones; y no terminar con un guion o contienen dos guiones consecutivos.
Además, no administre los recursos de la pila fuera de CloudFormation. Por ejemplo, si cambia el nombre de un recurso que forme parte de una pila sin usar CloudFormation, es posible que aparezca un error cada vez que trate de actualizar o eliminar dicha pila.
**importante**
No se puede realizar una actualización para que provoque la sustitución de un recurso con nombre personalizado. Si debe sustituir el recurso, especifique un nuevo nombre.
## Ejemplo
Si desea utilizar un nombre personalizado, especifique una propiedad de nombre para dicho recurso en su plantilla de CloudFormation. Cada recurso compatible con nombres personalizados tiene su propia propiedad, que se especifica. Por ejemplo, para dar nombre a una tabla de DynamoDB, use la propiedad `TableName`, como se muestra en el siguiente ejemplo:
### JSON
```
"myDynamoDBTable" : {
"Type" : "AWS::DynamoDB::Table",
"Properties" : {
"KeySchema" : {
"HashKeyElement": {
"AttributeName" : "AttributeName1",
"AttributeType" : "S"
},
"RangeKeyElement" : {
"AttributeName" : "AttributeName2",
"AttributeType" : "N"
}
},
"ProvisionedThroughput" : {
"ReadCapacityUnits" : "5",
"WriteCapacityUnits" : "10"
},
"TableName" : "SampleTable"
}
}
```
### YAML
```
myDynamoDBTable:
Type: AWS::DynamoDB::Table
Properties:
KeySchema:
HashKeyElement:
AttributeName: "AttributeName1"
AttributeType: "S"
RangeKeyElement:
AttributeName: "AttributeName2"
AttributeType: "N"
ProvisionedThroughput:
ReadCapacityUnits: "5"
WriteCapacityUnits: "10"
TableName: "SampleTable"
```
# CloudFormationEtiquetado de recursos
Puede aplicar etiquetas a recursos mediante la propiedad `Tags` en su plantilla de CloudFormation, lo cual puede ayudarlo a identificar y categorizar esos recursos.
Para obtener información sobre qué recursos admiten la propiedad `Tags`, consulte los recursos individuales en la [referencia de tipos de recursos y propiedades de AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-template-resource-type-ref.html). Si un recurso aún no admite la propiedad `Tags`, es posible que el servicio del recurso admita el etiquetado mediante sus propias operaciones de API. Para más información, consulte la documentación para ese servicio.
Además de las etiquetas que usted defina, CloudFormation crea automáticamente las siguientes etiquetas en el nivel de pila con el prefijo `aws:`:
+ `aws:cloudformation:logical-id`
+ `aws:cloudformation:stack-id`
+ `aws:cloudformation:stack-name`
El prefijo `aws:` se reserva para uso de AWS. Este prefijo no distingue entre mayúsculas y minúsculas Si utiliza este prefijo en la propiedad `Key` o `Value` no puede actualizar ni eliminar la etiqueta. Las etiquetas con este prefijo no cuentan para el número de etiquetas por recurso.
La propagación de etiquetas de pila a recursos, incluidas las que tienen el prefijo `aws:`, varía según el tipo de recurso. Por ejemplo, las etiquetas no se propagan a volúmenes de Amazon EBS creados a partir de asignaciones de dispositivos de bloques.
**nota**
Algunos recursos requieren una configuración de propagación de etiquetas explícita. Por ejemplo, el recurso `AWS::AutoScaling::AutoScalingGroup` debe tener su propiedad `PropagateAtLaunch` establecida en `true` para propagar las etiquetas a sus instancias de EC2. Sin embargo, las etiquetas a nivel de pila se aplican automáticamente a las instancias de EC2, independientemente de la configuración `PropagateAtLaunch`.
## Sintaxis
### JSON
```
{
"Key" : String,
"Value" : String
}
```
### YAML
```
Key: String
Value: String
```
## Propiedades
`Key`
El nombre de clave de la etiqueta. Puede especificar un valor comprendido entre 1 y 128 caracteres Unicode y no se le puede añadir el prefijo `aws:`. Puede usar cualquiera de los siguientes caracteres: el conjunto de letras Unicode, dígitos, espacios en blanco, `_`, `.`, `:`, `/`, `=`, `+`, `@`, `-` y `"`.
*Obligatorio*: sí
*Tipo:* cadena
`Value`
El valor de la etiqueta. Puede especificar un valor de entre 1 y 256 caracteres de longitud. Puede utilizar cualquiera de los siguientes caracteres: el conjunto de letras Unicode, dígitos, espacio en blanco, `_`, `.`, `/`, `=`, `+` y `-`.
*Obligatorio*: sí
*Tipo:* cadena
## Ejemplo
En este ejemplo se muestra una propiedad `Tags`. Puede especificar esta propiedad dentro de la sección `Properties` de un recurso que la admita. Cuando se crea el recurso, la etiqueta `Environment` se establece dinámicamente mediante un parámetro y la etiqueta `Owner` se establece estáticamente en `MyName`.
### JSON
```
1. "Tags" : [
2. {
3. "Key" : "Environment",
4. "Value" : { "Ref": "Environment" }
5. },
6. {
7. "Key" : "Owner",
8. "Value" : "MyName"
9. }
10. ]
```
### YAML
```
1. Tags:
2. - Key: Environment
3. Value: !Ref Environment
4. - Key: Owner
5. Value: MyName
```
## Véase también
+ [Configurar las opciones de pila](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html#configure-stack-options) en la *Guía del usuario de AWS CloudFormation*
+ [Visualización de los recursos y datos de la pila de CloudFormation en la Consola de administración de AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-view-stack-data-resources.html) en la *Guía del usuario de AWS CloudFormation*