

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Aktualisierung einer Amazon Personalize Personalize-Metrikzuweisung
<a name="updating-metric-attribution"></a>

 Wenn Sie eine Metrik-Attribution aktualisieren, können Sie Metriken hinzufügen und entfernen und die Ausgabekonfiguration ändern. Sie können eine Metrikzuweisung mit der Amazon Personalize Personalize-Konsole oder AWS dem AWS Command Line Interface SDKS aktualisieren. 

**Topics**
+ [Aktualisierung einer Metrik-Zuordnung (Konsole)](#updating-metric-attribution-console)
+ [Aktualisierung einer Metrik-Attribution ()AWS CLI](#updating-metric-attribution-cli)
+ [Aktualisierung einer metrischen Zuordnung (AWS SDK)](#updating-metric-attribution-sdk)

## Aktualisierung einer Metrik-Zuordnung (Konsole)
<a name="updating-metric-attribution-console"></a>

Um eine Metrik-Zuordnung mit der Amazon Personalize-Konsole zu aktualisieren, nehmen Sie Ihre Änderungen auf der Seite **Metrik-Zuordnung** vor.

**Um eine Metrik-Zuordnung zu aktualisieren**

1. Öffnen Sie zu [https://console.aws.amazon.com/personalize/Hause](https://console.aws.amazon.com/personalize/home) die Amazon Personalize Personalize-Konsole und melden Sie sich bei Ihrem Konto an. 

1. Wählen Sie Ihre Datensatzgruppe aus.

1. Wählen Sie im Navigationsbereich **Metrische Zuordnung** aus.

1. Wählen Sie im unteren Bereich die Registerkarte **Metrikattribute** oder die Registerkarte **Konfiguration der metrischen Zuordnung** aus, um mit den Änderungen zu beginnen.
   + Um Metriken hinzuzufügen oder zu entfernen, wählen Sie den Tab **Metrikattribute** und dann **Attribute bearbeiten** aus. Nehmen Sie Ihre Änderungen auf der Seite **Metrikattribute bearbeiten** vor und wählen Sie **Aktualisieren**, um Ihre Änderungen zu speichern.
   + Um Änderungen am Amazon S3 S3-Ausgabe-Bucket oder der IAM-Servicerolle vorzunehmen, wählen Sie die Registerkarte **Konfiguration der Metrikzuweisung bearbeiten** und nehmen Sie die Änderungen auf der Seite **Attributionskonfiguration bearbeiten** vor. Wählen Sie **Aktualisieren** aus, um Ihre Änderungen zu speichern.

## Aktualisierung einer Metrik-Attribution ()AWS CLI
<a name="updating-metric-attribution-cli"></a>

Nachdem Sie eine Metrik-Attribution erstellt haben, können Sie die AWS Command Line Interface (AWS CLI) verwenden, um Metriken hinzuzufügen und zu entfernen und die Ausgabekonfiguration zu ändern. Der folgende Code zeigt, wie Sie Metriken mit dem `update-metric-attribution` Befehl entfernen:

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

 Der folgende Code zeigt, wie Sie eine zusätzliche Metrik hinzufügen und eine neue Ausgabekonfiguration angeben:

```
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}}\"
}]"
```

 Bei Erfolg gibt Amazon Personalize den ARN der Metrik-Attribution zurück, die Sie aktualisiert haben. Eine vollständige Liste aller Parameter finden Sie unter. [UpdateMetricAttribution](API_UpdateMetricAttribution.md)

## Aktualisierung einer metrischen Zuordnung (AWS SDK)
<a name="updating-metric-attribution-sdk"></a>

Nachdem Sie eine Metrik-Attribution erstellt haben, können Sie Metriken hinzufügen oder entfernen und deren Ausgabekonfiguration ändern. Der folgende Code zeigt, wie Sie Metriken aus einer Metrik-Attribution entfernen.

------
#### [ 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();
```

------

 Der folgende Code zeigt, wie Sie eine zusätzliche Metrik hinzufügen und eine neue Ausgabekonfiguration angeben:

------
#### [ 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();
```

------

Bei Erfolg gibt Amazon Personalize den ARN der Metrik-Attribution zurück, die Sie aktualisiert haben. Eine vollständige Liste aller Parameter finden Sie unter. [UpdateMetricAttribution](API_UpdateMetricAttribution.md)