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.

# CreateMetricAttribution
<a name="API_CreateMetricAttribution"></a>

Crea una atribución de métricas. La atribución de métricas crea informes sobre los datos que importa en Amazon Personalize. En función de cómo haya importado los datos, puede ver los informes en Amazon CloudWatch o Amazon S3. Para obtener más información, consulte [Medición del impacto de las recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html).

## Sintaxis de la solicitud
<a name="API_CreateMetricAttribution_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "metrics": [ 
      { 
         "eventType": "string",
         "expression": "string",
         "metricName": "string"
      }
   ],
   "metricsOutputConfig": { 
      "roleArn": "string",
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "name": "string"
}
```

## Parámetros de la solicitud
<a name="API_CreateMetricAttribution_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-datasetGroupArn"></a>
El Nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos de destino para la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [metrics](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-metrics"></a>
Una lista de atributos de métrica para la atribución de métricas. Cada atributo de métrica especifica un tipo de evento que se debe rastrear y una función. Las funciones disponibles son `SUM()` o `SAMPLECOUNT()`. Para las funciones SUM(), proporcione el tipo de conjunto de datos (interacciones o elementos) y la columna que se va a sumar como parámetro. Por ejemplo, SUM(Items.PRICE).  
Tipo: matriz de objetos [MetricAttribute](API_MetricAttribute.md)  
Miembros de la matriz: número máximo de 10 elementos.  
Obligatorio: sí

 ** [metricsOutputConfig](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-metricsOutputConfig"></a>
Los detalles de configuración de salida para la atribución de métricas.  
Tipo: objeto [MetricAttributionOutput](API_MetricAttributionOutput.md)  
Obligatorio: sí

 ** [name](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-name"></a>
Un nombre para la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateMetricAttribution_ResponseSyntax"></a>

```
{
   "metricAttributionArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateMetricAttribution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [metricAttributionArn](#API_CreateMetricAttribution_ResponseSyntax) **   <a name="personalize-CreateMetricAttribution-response-metricAttributionArn"></a>
El Nombre de recurso de Amazon (ARN) para la nueva atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateMetricAttribution_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateMetricAttribution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateMetricAttribution)