IAMfunción para recuperar recomendaciones de Amazon Personalize - Amazon Pinpoint
Paso 1: Crear la política de IAMPaso 2: Crear el rol de IAM

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.

IAMfunción para recuperar recomendaciones de Amazon Personalize

Puede configurar Amazon Pinpoint para recuperar datos de recomendación de una solución de Amazon Personalize que se haya implementado como campaña de Amazon Personalize. Puede utilizar estos datos para enviar recomendaciones personalizadas a los destinatarios de los mensajes en función de los atributos y el comportamiento de cada destinatario. Para obtener más información, consulte Modelos de machine learning en la Guía del usuario de Amazon Pinpoint.

Antes de poder recuperar los datos de recomendaciones de una campaña de Amazon Personalize, debe crear un rol AWS Identity and Access Management (IAM) que permita a Amazon Pinpoint recuperar los datos de la campaña. Amazon Pinpoint puede crear este rol para usted automáticamente cuando utilice la consola para configurar un modelo de recomendación en Amazon Pinpoint. O bien, puede crear este rol manualmente.

Para crear el rol manualmente, complete IAM API los siguientes pasos:

  1. Cree una IAM política que permita a una entidad (en este caso, Amazon Pinpoint) recuperar los datos de recomendaciones de una campaña de Amazon Personalize.

  2. Cree un IAM rol y IAM asígnele la política.

En este tema se explica cómo completar estos pasos mediante AWS Command Line Interface (AWS CLI). Supone que ya ha creado la solución de Amazon Personalize y la ha implementado como una campaña de Amazon Personalize. Para obtener información sobre cómo crear e implementar una campaña, consulte Creación de una campaña en la Guía para desarrolladores de Amazon Personalize.

En este tema se supone que ya ha instalado y configurado la AWS CLI. Para obtener información sobre la configuración del AWS CLI, consulte Instalación del AWS CLI en la Guía del AWS Command Line Interface usuario.

Paso 1: Crear la política de IAM

Una IAM política define los permisos para una entidad, como una identidad o un recurso. Para crear un rol que permita a Amazon Pinpoint recuperar datos de recomendaciones de una campaña de Amazon Personalize, primero debe crear una IAM política para el rol. Esta política debe permitir a Amazon Pinpoint:

  • Recupere la información de configuración de la solución implementada por la campaña (DescribeSolution).

  • Compruebe el estado de la campaña (DescribeCampaign).

  • Recupere los datos de recomendación de la campaña (GetRecommendations).

En el procedimiento siguiente, la política de ejemplo permite este acceso para una solución de Amazon Personalize concreta implementada por una campaña de Amazon Personalize concreta.

Para crear la política de IAM

  1. En un editor de texto, cree un nuevo archivo. Pegue el código siguiente en el archivo:

    {
    "Version":"2012-10-17",
    "Statement":[
        {
            "Sid":"RetrieveRecommendationsOneCampaign",
            "Effect":"Allow",
            "Action":[
                "personalize:DescribeSolution",
                "personalize:DescribeCampaign",
                "personalize:GetRecommendations"
            ],
            "Resource":[
                "arn:aws:personalize:region:accountId:solution/solutionId",
                "arn:aws:personalize:region:accountId:campaign/campaignId"
            ]
        }
    ]
}

    En el ejemplo anterior, sustituya el italicized texto con su información:

    • region — El nombre de la AWS región que aloja la solución y la campaña Amazon Personalize.

    • accountId — Tu Cuenta de AWS número de identidad.

    • solutionId — El identificador de recurso único de la solución Amazon Personalize que implementa la campaña.

    • campaignId — El identificador de recurso único de la campaña Amazon Personalize desde el que recuperar los datos de las recomendaciones.

  2. Cuando haya terminado, guarde el archivo como RetrieveRecommendationsPolicy.json.

  3. Mediante la interfaz de línea de comandos, desplácese hasta el directorio donde guardó el archivo RetrieveRecommendationsPolicy.json.

  4. Escriba el siguiente comando para crear una política y asígnele el nombre RetrieveRecommendationsPolicy. Para usar un nombre diferente, cámbielo RetrieveRecommendationsPolicy al nombre que desee.

    aws iam create-policy --policy-name RetrieveRecommendationsPolicy --policy-document file://RetrieveRecommendationsPolicy.json
    nota

    Si recibes un mensaje en el que se indica que tu cuenta no está autorizada a realizar la CreatePolicy operación, debes adjuntar una política a tu usuario que te permita crear nuevas IAM políticas y funciones para tu cuenta. Para obtener más información, consulta Cómo añadir y quitar permisos de IAM identidad en la Guía del IAM usuario.

  5. Copie el nombre del recurso de Amazon (ARN) de la política (arn:aws:iam::123456789012:policy/RetrieveRecommendationsPolicyen el ejemplo anterior). Lo necesitará ARN para crear el IAM rol en la siguiente sección.

Paso 2: Crear el rol de IAM

Tras crear la IAM política, puede crear un IAM rol y asociarle la política.

Cada IAM función contiene una política de confianza, que es un conjunto de reglas que especifica qué entidades pueden asumir la función. En esta sección, se crea una política de confianza que permita que Amazon Pinpoint asuma el rol. A continuación, crea el rol en sí. A continuación, asocie la política al rol.

Para crear el rol de IAM

  1. En un editor de texto, cree un nuevo archivo. Pegue el código siguiente en el archivo:

    {
    "Version":"2012-10-17",
    "Statement":[
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "pinpoint.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "AWS:SourceAccount": "accountId"
                },
                "ArnLike": {
                    "AWS:SourceArn": "arn:aws:mobiletargeting:region:accountId:apps/*"
                }
            }
        }
    ]
}

  2. Guarde el archivo como RecommendationsTrustPolicy.json.

  3. Mediante la interfaz de línea de comandos, desplácese hasta el directorio donde guardó el archivo RecommendationsTrustPolicy.json.

  4. Escriba el siguiente comando para crear un nuevo rol y llámelo PinpointRoleforPersonalize. Para usar un nombre diferente, cámbielo PinpointRoleforPersonalize al nombre que desee.

    aws iam create-role --role-name PinpointRoleforPersonalize --assume-role-policy-document file://RecommendationsTrustPolicy.json

  5. Escriba el siguiente comando para asociar la política que creó en la sección anterior al rol que acaba de crear:

    aws iam attach-role-policy --policy-arn arn:aws:iam::123456789012:policy/RetrieveRecommendationsPolicy --role-name PinpointRoleforPersonalize

    En el comando anterior, sustituya arn:aws:iam::123456789012:policy/RetrieveRecommendationsPolicy por ARN la política que creó en la sección anterior. Además, sustituya PinpointRoleforPersonalize con el nombre de la función que especificó en el paso 4, si especificó un nombre diferente para la función.