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

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 sirve para definirla y asociarla con recursos de AWS, 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:

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 incluye 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: _ . : / = + -. Las siguientes restricciones adicionales se aplican a las etiquetas:

Para agregar, mostrar, actualizar y quitar claves de etiqueta y valores de los recursos de Forecast, puede usar la AWS Command Line Interface (AWS CLI), la API de Forecast o un SDK de AWS.

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 utilizar las etiquetas de esta manera, puede implementar un control detallado de los grupos y usuarios de su Cuenta de AWS que tienen permiso para crear y etiquetar recursos, y los grupos y usuarios que tienen permiso para crear, actualizar y quitar etiquetas de forma 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.

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

{
    "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 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 y la AWS Management Console.

AWS CLI

Para agregar una etiqueta al crear un nuevo recurso de Forecasta con la AWS CLI, use el comando create adecuado para el recurso e incluya el parámetro tags 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 acerca de los comandos que puede usar para crear un recurso de Forecast, consulte la Referencia de comandos de la AWS CLI de 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

AWS Management Console

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 AWS Management Console y abra la consola de Amazon Forecast en https://console.aws.amazon.com/forecast/.

2. Elija Create dataset group (Crear grupo de conjuntos de datos).

3. Para Nombre del grupo de conjuntos de datos, escriba un nombre.

4. Para Dominio de previsión, elija un dominio.

5. Elija Add new tag (Agregar nueva etiqueta).

6. Escriba un valor adecuado para Clave y Valor.

   Por ejemplo, Environment y Test, respectivamente.

7. Para añadir más etiquetas, elija Añadir nueva etiqueta.

   Puede agregar hasta 50 etiquetas a un recurso.

8. Seleccione Siguiente para seguir creando el recurso.

Información adicional

Para obtener más información sobre el etiquetado, consulte los siguientes recursos.