Amazon Forecast ya no está disponible para nuevos clientes. Los clientes actuales de Amazon Forecast pueden seguir utilizando el servicio con normalidad. [Más información](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Etiquetado de recursos de Amazon Forecast
Una *etiqueta* es una etiqueta que puede definir y asociar de forma opcional a AWS los recursos, incluidos determinados tipos de recursos de Amazon Forecast. Las etiquetas pueden ayudarle a clasificar y administrar recursos de distintas formas, como, por finalidad, propietario, entorno u otros criterios. Por ejemplo, puede usar etiquetas para aplicar políticas o automatización, o bien para identificar recursos que están sujetos a determinados requisitos de conformidad. Puede añadir etiquetas a los siguientes tipos de recursos de Forecast:
+ Grupos de conjuntos de datos
+ Conjuntos de datos
+ Trabajos de importación de conjuntos de datos
+ Predictores
+ Trabajos de exportación de predictores
+ Previsiones
+ Trabajos de exportación de previsiones
+ Análisis condicional
+ Previsiones condicionales
+ Trabajos de exportación de previsiones condicionales
Un recurso puede tener hasta 50 etiquetas.
## Administración de etiquetas
Cada etiqueta está formada por una clave de etiqueta y un valor de etiqueta opcional, ambos definidos por el usuario. Un clave de etiqueta es una etiqueta general que actúa como una categoría para valores de etiqueta más específicos. Un valor de etiqueta actúa como descriptor de una clave de etiqueta. Por ejemplo, si tiene dos versiones de un trabajo de importación de conjuntos de datos de Forecast (una para pruebas internas y otra para producción), podría asignar una clave de etiqueta `Environment` a ambos proyectos. El valor de la clave de etiqueta `Environment` podría ser `Test` para una versión del trabajo de importación de conjuntos de datos y `Production` para la otra versión.
Una clave de etiqueta puede incluir hasta 128 caracteres. Un valor de etiqueta puede incluir hasta 256 caracteres. Los caracteres pueden ser letras Unicode, números, espacios en blanco o uno de los siguientes símbolos: \$1 . : / = \$1 -. Las siguientes restricciones adicionales se aplican a las etiquetas:
+ Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.
+ Para cada recurso asociado, cada clave de etiqueta debe ser única y solo puede tener un valor.
+ No utilice `aws:``AWS:`, ni ninguna combinación de mayúsculas o minúsculas, como un prefijo para las teclas, ya que está reservado para su uso. AWS Las claves de etiquetas que tienen este prefijo no se pueden editar ni eliminar. Los valores pueden tener este prefijo. Si el valor de una etiqueta tiene `aws` como prefijo pero la clave no, Forecast la considera una etiqueta de usuario y se contabilizará en el límite de 50 etiquetas. Las etiquetas que tengan solo el prefijo de clave de `aws` no cuentan para el límite de etiquetas por recurso.
+ No puede actualizar ni eliminar un recurso en función únicamente de sus etiquetas. También debe especificar el ID de recurso o nombre de recurso de Amazon (ARN), dependiendo de la operación que use.
+ Puede asociar etiquetas a recursos públicos o compartidos. Sin embargo, las etiquetas solo están disponibles para usted Cuenta de AWS, no para ninguna otra cuenta que comparta el recurso. Además, las etiquetas solo están disponibles para los recursos que se encuentran en los especificados Región de AWS para usted Cuenta de AWS.
Para agregar, mostrar, actualizar y eliminar claves y valores de etiquetas de los recursos de Forecast, puedes usar AWS Command Line Interface (AWS CLI), la API Forecast o un AWS SDK.
## Uso de etiquetas en políticas de IAM
Después de empezar a implementar etiquetas, puede aplicar permisos de nivel de recursos basados en etiquetas a las políticas de AWS Identity and Access Management (IAM) y las operaciones de API. Esto incluye operaciones que admiten agregar etiquetas a los recursos cuando se crean recursos. Al usar las etiquetas de esta manera, puede implementar un control pormenorizado sobre qué grupos y usuarios Cuenta de AWS tienen permiso para crear y etiquetar recursos, y qué grupos y usuarios tienen permiso para crear, actualizar y eliminar etiquetas de manera más general.
Por ejemplo, puede crear una política que permita a un usuario tener acceso completo a todos los recursos de Forecast en los que su nombre sea un valor en la etiqueta `Owner` del recurso.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "ModifyResourceIfOwner",
"Effect": "Allow",
"Action": "forecast:*",
"Resource": "*",
"Condition": {
"StringEqualsIgnoreCase": {
"aws:ResourceTag/Owner": "${aws:username}"
}
}
}
]
}
```
------
El siguiente ejemplo muestra cómo crear una política para permitir crear y eliminar un conjunto de datos. Estas operaciones solo se permiten si el nombre de dicho usuario es `johndoe`.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"forecast:CreateDataset",
"forecast:DeleteDataset"
],
"Resource": "arn:aws:forecast:*:*:dataset/*",
"Condition": {
"StringEquals": {"aws:username" : "johndoe"}
}
},
{
"Effect": "Allow",
"Action": "forecast:DescribeDataset",
"Resource": "*"
}
]
}
```
------
Si define los permisos de nivel de recurso basados en etiquetas, estos entrarán en vigor inmediatamente. Esto significa que sus recursos están más seguros en cuanto se crean y que puede empezar a aplicar el uso de etiquetas de nuevos recursos rápidamente. También puede usar permisos de nivel de recurso para controlar las claves y valores de etiqueta que se pueden asociar a recursos nuevos y existentes. Para obtener más información, consulte [Control del acceso mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) en la *Guía del usuario de IAM de AWS *.
## Adición de etiquetas a los recursos
En los ejemplos siguientes se muestra cómo agregar una etiqueta a recursos de Forecast mediante la [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) y la Consola de administración de AWS.
------
#### [ AWS CLI ]
Para añadir una etiqueta al crear un nuevo recurso de Forecast con el AWS CLI, utilice el `create` comando correspondiente para el recurso e incluya el `tags` parámetro y los valores. Por ejemplo, el siguiente comando crea un nuevo grupo de conjuntos de datos con el nombre `myDatasetGroup` para el dominio CUSTOM y agrega las siguientes etiquetas: una clave de etiqueta `Environment` con un valor de etiqueta `Test` y una clave de etiqueta `Owner` y un valor `xyzCorp`.
```
aws forecast create-dataset-group \
--dataset-group-name myDatasetGroup \
--dataset-arns arn:aws:forecast:region:acct-id:dataset/dataset_name \
--domain CUSTOM \
--tags Key=Environment,Value=Test Key=Owner,Value=xyzCorp
```
Para obtener información sobre los comandos que puede usar para crear un recurso de Forecast, consulte la [Referencia de AWS CLI comandos de Forecast](https://docs.aws.amazon.com/cli/latest/reference/forecast/).
Para añadir una etiqueta a un recurso existente, utilice el comando `tag-resource` y especifique el ARN del recurso y proporcione la clave y el valor de la etiqueta en el parámetro `tags-model`.
```
aws forecast tag-resource \
--resource-arn resource ARN \
--tags Key=key,Value=value
```
------
#### [ Consola de administración de AWS ]
Al crear un recurso en Forecast, puede añadir etiquetas opcionales. El siguiente ejemplo añade una etiqueta a un grupo de conjuntos de datos. La adición de etiquetas a otros recursos sigue un patrón similar.
**Para agregar etiquetas a un grupo de conjunto de datos nuevo**
1. Inicie sesión en la consola Amazon Forecast Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/forecast/](https://console.aws.amazon.com/forecast/).
1. Elija **Crear grupo de conjuntos de datos**.
1. Para **Nombre del grupo de conjuntos de datos**, escriba un nombre.
1. Para **Dominio de previsión**, elija un dominio.
1. Elija **Añadir nueva etiqueta**.
1. Escriba un valor adecuado para **Clave** y **Valor**.
Por ejemplo, **Environment** y **Test**, respectivamente.
1. Para añadir más etiquetas, elija **Añadir nueva etiqueta**.
Puede agregar hasta 50 etiquetas a un recurso.
1. Seleccione **Siguiente** para seguir creando el recurso.
------
## Información adicional
Para obtener más información sobre el etiquetado, consulte los siguientes recursos.
+ [AWS Los principios de etiquetado](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) en la referencia *AWS general*
+ [AWS Estrategias de etiquetado (PDF](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf) descargable)
+ [AWS El control de acceso](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) en la guía del usuario *AWS de IAM*
+ [AWS Políticas de etiquetado](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html) *en la guía del usuario AWS Organizations *