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.

# Actualización de una atribución de métricas de Amazon Personalize
<a name="updating-metric-attribution"></a>

 Al actualizar una atribución de métricas, puede añadir y eliminar métricas, así como modificar su configuración de salida. Puede actualizar la atribución de una métrica con la consola Amazon Personalize o AWS Command Line Interface los AWS SDK. 

**Topics**
+ [Actualización de una atribución de métricas (consola)](#updating-metric-attribution-console)
+ [Actualización de una atribución de métricas (AWS CLI)](#updating-metric-attribution-cli)
+ [Actualizar una atribución de métricas (SDK)AWS](#updating-metric-attribution-sdk)

## Actualización de una atribución de métricas (consola)
<a name="updating-metric-attribution-console"></a>

Para actualizar una atribución de métricas con la consola de Amazon Personalize, realice los cambios en la página **Atribución de métricas**.

**Para actualizar una atribución de métricas**

1. Abre la consola Amazon Personalize en [https://console.aws.amazon.com/personalize/casa](https://console.aws.amazon.com/personalize/home) e inicia sesión en tu cuenta. 

1. Elija su grupo de conjuntos de datos.

1. En el panel de navegación, elija **Métricas**.

1. En la sección inferior, elija la pestaña **Atributos de métricas** o la pestaña **Configuración de atribuciones de métricas** para empezar a realizar cambios.
   + Para añadir o eliminar métricas, seleccione la pestaña **Atributos de métricas** y elija **Editar atributos**. Realice los cambios en la página **Editar atributos de métricas** y elija **Actualizar** para guardar los cambios.
   + Para realizar cambios en el bucket de salida de Amazon S3 o en el rol de servicio de IAM, seleccione la pestaña **Editar configuración de atribución de métricas** y realice los cambios en la página **Editar configuración de atribuciones**. Elija **Actualizar** para guardar los cambios.

## Actualización de una atribución de métricas (AWS CLI)
<a name="updating-metric-attribution-cli"></a>

Después de crear una atribución de métricas, puede usar AWS Command Line Interface (AWS CLI) para añadir y eliminar métricas y modificar su configuración de salida. El código siguiente muestra cómo eliminar métricas con el comando `update-metric-attribution`:

```
aws personalize update-metric-attribution \
--metric-attribution-arn {{metric attribution arn}} \
--remove-metrics {{metricName1}} {{metricName2}}
```

 El siguiente código muestra cómo añadir una métrica adicional y especificar una nueva configuración de salida:

```
aws personalize update-metric-attribution \
--metric-attribution-arn {{metric attribution arn}} \
--metrics-output-config "{\"roleArn\": \"{{new role ARN}}\", \"s3DataDestination\":{\"kmsKeyArn\":\"{{kms key ARN}}\",\"path\":\"s3://{{amzn-s3-demo-bucket2}}/{{new-folder-name}}/\"}}" \
--add-metrics "[{
  \"eventType\": \"{{event type}}\",
  \"expression\": \"{{SUM(DatasetType.COLUMN_NAME)}}\",
  \"metricName\": \"{{metric name}}\"
}]"
```

 Si se ejecuta correctamente, Amazon Personalize devuelve el ARN de la atribución de métricas que ha actualizado. Para obtener un listado completo de todos los parámetros, consulte [UpdateMetricAttribution](API_UpdateMetricAttribution.md).

## Actualizar una atribución de métricas (SDK)AWS
<a name="updating-metric-attribution-sdk"></a>

Después de crear una atribución de métricas, puede agregar o quitar métricas, así como modificar su configuración de salida. El código siguiente muestra cómo eliminar métricas de una atribución de métricas.

------
#### [ SDK for Python (Boto3) ]

```
import boto3
            
personalize = boto3.client('personalize')

metricsToRemove = ["{{metricName1}}", "{{metricName2}}"]
            
response = personalize.update_metric_attribution(
  metricAttributionArn = "{{metric attribution ARN}}",
  removeMetrics = metricsToRemove
)
```

------
#### [ SDK for Java 2.x ]

```
public static void removeMetrics(PersonalizeClient client,
                                 String metricAttributionArn,
                                 String metric1Name,
                                 String metric2Name) {

    ArrayList<String> metricsToRemove = new ArrayList<>(Arrays.asList(metric1Name, metric2Name));
    
    try {
    
        UpdateMetricAttributionRequest request = UpdateMetricAttributionRequest.builder()
                .metricAttributionArn(metricAttributionArn)
                .removeMetrics(metricsToRemove)
                .build();
                
        UpdateMetricAttributionResponse response = client.updateMetricAttribution(request);
        System.out.println(response);
        
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
}
```

------
#### [ SDK for JavaScript v3 ]

```
// Get service clients and commands using ES6 syntax.
import {UpdateMetricAttributionCommand, PersonalizeClient } from
  "@aws-sdk/client-personalize";

// create personalizeClient
const personalizeClient = new PersonalizeClient({
  region: "REGION"
});

// set the update request param
export const updateMetricAttributionParam = {
  metricAttributionArn: "METRIC_ATTRIBUTION_ARN",    /* required */
  removeMetrics: ["METRIC_NAME_1", "METRIC_NAME_2"]    /* specify list of names of metrics to delete */
};
export const run = async () => {
  try {
    const response = await personalizeClient.send(
      new UpdateMetricAttributionCommand(updateMetricAttributionParam)
    );
    console.log("Success", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();
```

------

 El siguiente código muestra cómo añadir una métrica adicional y especificar una nueva configuración de salida:

------
#### [ SDK for Python (Boto3) ]

```
import boto3

personalize = boto3.client('personalize')

newMetrics = [{ 
      "eventType": "{{event type}}",
      "expression": "{{SUM(DatasetType.COLUMN_NAME)}}",
      "metricName": "{{metric name}}"
}]

newOutputConfig = {
  "roleArn": "{{Amazon Personalize service role ARN}}", 
  "s3DataDestination": {
    "kmsKeyArn": "{{key ARN}}", 
    "path": "{{s3://amzn-s3-demo-bucket/<folder>}}"
  }
}

response = personalize.update_metric_attribution(
  metricAttributionArn = "{{metric attribution arn}}",
  metricsOutputConfig = newOutputConfig,
  addMetrics = newMetrics
)
```

------
#### [ SDK for Java 2.x ]

```
public static void addMetricsAndUpdateOutputConfig(PersonalizeClient personalizeClient,
                                                String metricAttributionArn,
                                                String newMetric1EventType,
                                                String newMetric1Expression,
                                                String newMetric1Name,
                                                String newMetric2EventType,
                                                String newMetric2Expression,
                                                String newMetric2Name,
                                                String roleArn,
                                                String s3Path,
                                                String kmsKeyArn) {
    try {
    
        MetricAttribute newAttribute = MetricAttribute.builder()
                .eventType(newMetric1EventType)
                .expression(newMetric1Expression)
                .metricName(newMetric1Name)
                .build();
                
        MetricAttribute newAttribute2 = MetricAttribute.builder()
                .eventType(newMetric2EventType)
                .expression(newMetric2Expression)
                .metricName(newMetric2Name)
                .build();

        ArrayList<MetricAttribute> newAttributes = new ArrayList<>(Arrays.asList(newAttribute, newAttribute2));

        S3DataConfig newDataDestination = S3DataConfig.builder()
                .kmsKeyArn(kmsKeyArn)
                .path(s3Path)
                .build();

        MetricAttributionOutput newOutputConfig = MetricAttributionOutput.builder()
                .roleArn(roleArn)
                .s3DataDestination(newDataDestination)
                .build();
                
        UpdateMetricAttributionRequest request = UpdateMetricAttributionRequest.builder()
                .metricAttributionArn(metricAttributionArn)
                .metricsOutputConfig(newOutputConfig)
                .addMetrics(newAttributes)
                .build();
                
        UpdateMetricAttributionResponse response = personalizeClient.updateMetricAttribution(request);
        System.out.println("New metrics added!");
        System.out.println(response);
        
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
}
```

------
#### [ SDK for JavaScript v3 ]

```
// Get service clients and commands using ES6 syntax.
import {UpdateMetricAttributionCommand, PersonalizeClient } from
  "@aws-sdk/client-personalize";

// create personalizeClient
const personalizeClient = new PersonalizeClient({
  region: "REGION"
});

export const updateMetricAttributionParam = {
  metricAttributionArn: "METRIC_ATTRIBUTION_ARN",
  addMetrics: [
    {
      eventType: "EVENT_TYPE",                      /* required for each metric */
      expression: "SUM(DatasetType.COLUMN_NAME)",   /* required for each metric */
      metricName: "METRIC_NAME",                    /* required for each metric */
    }
  ],
  metricsOutputConfig: {
    roleArn: "ROLE_ARN",                      /* required */
    s3DataDestination: {                
      kmsKeyArn: "KEY_ARN",                                                      /* optional */
      path: "s3://amzn-s3-demo-bucket/<folderName>/",    /* optional */
    },
  }
};

export const run = async () => {
  try {
    const response = await personalizeClient.send(
      new UpdateMetricAttributionCommand(updateMetricAttributionParam)
    );
    console.log("Success", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();
```

------

Si se ejecuta correctamente, Amazon Personalize devuelve el ARN de la atribución de métricas que ha actualizado. Para obtener un listado completo de todos los parámetros, consulte [UpdateMetricAttribution](API_UpdateMetricAttribution.md).