

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.

# Seguimiento del linaje entre cuentas
<a name="xaccount-lineage-tracking"></a>

Amazon SageMaker AI admite el seguimiento de entidades de linaje desde una AWS cuenta diferente. Otras AWS cuentas pueden compartir sus entidades de linaje con usted y usted puede acceder a estas entidades de linaje mediante llamadas directas a la API o consultas de linaje de SageMaker IA.

SageMaker La IA lo utiliza [AWS Resource Access Manager](https://docs.aws.amazon.com/ram/latest/userguide/what-is.html)para ayudarte a compartir de forma segura tus recursos de linaje. Puede compartir sus recursos a través de la [consola de AWS RAM](https://console.aws.amazon.com/ram/home).



## Configuración del seguimiento del linaje entre cuentas
<a name="setup-xaccount-lineage-tracking"></a>

Puedes agruparlos y compartirlos a [Entidades de seguimiento de linaje](lineage-tracking-entities.md) través de un grupo de linaje en Amazon SageMaker AI. SageMaker La IA solo admite un grupo de linaje predeterminado por cuenta. SageMaker La IA crea el grupo de linaje predeterminado cada vez que se crea una entidad de linaje en tu cuenta. Todas las entidades de linaje propiedad de su cuenta están asignadas a este grupo de linaje predeterminado. Para compartir entidades de linaje con otra cuenta, compartirá este grupo de linaje predeterminado con esa cuenta.

**nota**  
Puede compartir todas las entidades de seguimiento de linaje de un grupo de linaje o ninguna.

Crea un recurso compartido para tus entidades de linaje mediante la consola. AWS Resource Access Manager Para obtener más información, consulte [Cómo compartir los recursos de AWS](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html) en la *Guía del usuario de AWS Resource Access Manager *.

**nota**  
Una vez creado el recurso compartido, las asociaciones de recursos y entidades principales pueden tardar unos minutos en completarse. Una vez que se establece la asociación, la cuenta compartida recibe una invitación para unirse al recurso compartido. La cuenta compartida debe aceptar la invitación para acceder a los recursos compartidos. Para obtener más información sobre cómo aceptar una invitación para compartir recursos AWS RAM, consulte [Uso de AWS recursos compartidos](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-shared.html) en la *Guía del usuario de AWS Resource Access Manager*.

### Su política de recursos para el seguimiento del linaje entre cuentas
<a name="setup-xaccount-lineage-tracking-resource-policy"></a>

Amazon SageMaker AI solo admite un tipo de política de recursos. La política de recursos de SageMaker IA debe permitir todas las operaciones siguientes:

```
"sagemaker:DescribeAction"
"sagemaker:DescribeArtifact"
"sagemaker:DescribeContext"
"sagemaker:DescribeTrialComponent"
"sagemaker:AddAssociation"
"sagemaker:DeleteAssociation"
"sagemaker:QueryLineage"
```

**Example La siguiente es una política de recursos de SageMaker IA creada AWS Resource Access Manager para crear un recurso compartido para un grupo de linaje de cuentas.**    
****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "FullLineageAccess",
      "Effect": "Allow",
      "Principal": {
        "AWS": "111122223333"
      },
      "Action": [
        "sagemaker:DescribeAction",
        "sagemaker:DescribeArtifact",
        "sagemaker:DescribeContext",
        "sagemaker:DescribeTrialComponent",
        "sagemaker:AddAssociation",
        "sagemaker:DeleteAssociation",
        "sagemaker:QueryLineage"
      ],
      "Resource": "arn:aws:sagemaker:us-west-2:111111111111:lineage-group/sagemaker-default-lineage-group"
    }
  ]
}
```

## Seguimiento de entidades de linaje entre cuentas
<a name="tracking-lineage-xaccount"></a>

Con el seguimiento de linaje entre cuentas, puede asociar entidades de linaje en diferentes cuentas mediante la misma acción de la API `AddAssociation`. Al asociar dos entidades de linaje, la SageMaker IA valida si tiene permisos para realizar la acción de la `AddAssociation` API en ambas entidades de linaje. SageMaker A continuación, la IA establece la asociación. Si no tienes los permisos, SageMaker AI *no* crea la asociación. Una vez establecida la asociación entre cuentas, puede acceder a cualquiera de las entidades de linaje desde la otra mediante la acción de la API `QueryLineage`. Para obtener más información, consulte [Consulta de entidades de linaje](querying-lineage-entities.md).

Además de crear automáticamente entidades de linaje, si tienes acceso a varias cuentas, la SageMaker IA conecta artefactos que hacen referencia al mismo objeto o a los mismos datos. SageMaker Si diferentes cuentas utilizan los datos de una cuenta para rastrear el linaje, la SageMaker IA crea un artefacto en cada cuenta para rastrear esos datos. Con el linaje entre cuentas, cada vez que la SageMaker IA crea nuevos artefactos, SageMaker comprueba si se han creado otros artefactos con los mismos datos y que también se han compartido contigo. SageMaker A continuación, la IA establece asociaciones entre el artefacto recién creado y cada uno de los artefactos que hayas compartido contigo con el `AssociationType` conjunto. `SameAs` A continuación, puede utilizar la acción de la API `[QueryLineage](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_QueryLineage.html)` para pasar las entidades de linaje de su propia cuenta a las entidades de linaje compartidas con usted pero que pertenecen a otra cuenta de AWS . Para obtener más información, consulte [Consulta de entidades de linaje](querying-lineage-entities.md)

**Topics**
+ [Acceso a los recursos de linaje desde cuentas diferentes](#tracking-lineage-xaccount-accessing-resources)
+ [Autorización para consultar entidades de linaje entre cuentas](#tracking-lineage-xaccount-authorization)

### Acceso a los recursos de linaje desde cuentas diferentes
<a name="tracking-lineage-xaccount-accessing-resources"></a>

Una vez que se haya configurado el acceso entre cuentas para compartir el linaje, puedes ejecutar las siguientes acciones de la SageMaker API directamente con el ARN para describir las entidades del linaje compartido desde otra cuenta:
+ [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeAction.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeAction.html)
+ [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeArtifact.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeArtifact.html)
+ [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeContext.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeContext.html)
+ [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrialComponent.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrialComponent.html)

También puedes gestionar [las asociaciones](https://docs.aws.amazon.com/sagemaker/latest/dg/lineage-tracking-entities.html) de las entidades de linaje que sean propiedad de distintas cuentas que compartas contigo mediante las siguientes acciones de la API: SageMaker 
+ [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AddAssociation.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AddAssociation.html)
+ [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteAssociation.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DeleteAssociation.html)

[Para ver un cuaderno que muestre cómo usar SageMaker AI Lineage para consultar el linaje de todas APIs las cuentas, consulta -with-ram.ipynb. sagemaker-lineage-cross-account](https://github.com/aws/amazon-sagemaker-examples/blob/master/sagemaker-lineage/sagemaker-lineage-cross-account-with-ram.ipynb)

### Autorización para consultar entidades de linaje entre cuentas
<a name="tracking-lineage-xaccount-authorization"></a>

Amazon SageMaker AI debe validar que tienes permisos para realizar la acción de la `QueryLineage` API en el`StartArns`. Esto se aplica mediante la política de recursos asociada al`LineageGroup`. El resultado de esta acción incluye todas las entidades de linaje a las que tiene acceso, ya sean propiedad de su cuenta o compartidas por otra cuenta. Para obtener más información, consulte [Consulta de entidades de linaje](querying-lineage-entities.md).