

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Cross-Account Lignée de suivi
<a name="xaccount-lineage-tracking"></a>

Amazon SageMaker AI prend en charge le suivi des entités de lignage à partir d'un autre AWS compte. D'autres AWS comptes peuvent partager leurs entités de lignage avec vous et vous pouvez accéder à ces entités de lignage par le biais d'appels d'API directs ou de requêtes de lignage basées sur l' SageMaker IA.

SageMaker Utilisations [AWS Resource Access Manager](https://docs.aws.amazon.com/ram/latest/userguide/what-is.html)de l'IA pour vous aider à partager en toute sécurité les ressources de votre lignée. Vous pouvez partager vos ressources via la [console AWS RAM](https://console.aws.amazon.com/ram/home).



## Configurer le suivi du Cross-Account lignage
<a name="setup-xaccount-lineage-tracking"></a>

Vous pouvez les regrouper et les partager [Entités de suivi de lignée](lineage-tracking-entities.md) par le biais d'un groupe de lignage dans Amazon SageMaker AI. SageMaker L'IA ne prend en charge qu'un seul groupe de lignage par défaut par compte. SageMaker L'IA crée le groupe de lignage par défaut chaque fois qu'une entité de lignage est créée dans votre compte. Chaque entité de lignée détenue par votre compte est affectée à ce groupe de lignées par défaut. Pour partager des entités de lignée avec un autre compte, vous partagez ce groupe de lignées par défaut avec ce compte.

**Note**  
Vous pouvez partager toutes les entités de suivi de lignée dans un groupe de lignées ou aucun.

Créez un partage de ressources pour vos entités de lignée à l'aide de AWS Resource Access Manager la console. Pour plus d’informations, consultez [Partage de vos ressources AWS](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html) dans le *Guide de l’utilisateur AWS Resource Access Manager *.

**Note**  
Une fois le partage de ressources créé, l'association entre la ressource et le principal peut prendre quelques minutes. Une fois l'association définie, le compte partagé reçoit une invitation à rejoindre le partage de ressources. Le compte partagé doit accepter l'invitation pour accéder aux ressources partagées. Pour plus d'informations sur l'acceptation d'une invitation à partager des ressources AWS RAM, consultez la section [Utilisation AWS des ressources partagées](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-shared.html) dans le *guide de l'utilisateur de AWS Resource Access Manager*.

### Votre politique de ressources de suivi de lignée entre comptes
<a name="setup-xaccount-lineage-tracking-resource-policy"></a>

Amazon SageMaker AI ne prend en charge qu'un seul type de politique en matière de ressources. La politique des ressources de l' SageMaker IA doit autoriser toutes les opérations suivantes :

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

**Example Voici une politique de ressources d' SageMaker IA créée à l'aide de AWS Resource Access Manager pour créer un partage de ressources pour un groupe de lignage de comptes.**    
****  

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

## Entités de suivi du Cross-Account lignage
<a name="tracking-lineage-xaccount"></a>

Avec le suivi de lignée entre comptes, vous pouvez associer des entités de lignée à différents comptes à l’aide de la même action d’API `AddAssociation`. Lorsque vous associez deux entités de lignage, l' SageMaker IA vérifie si vous êtes autorisé à effectuer l'action d'`AddAssociation`API sur les deux entités de lignage. SageMaker AI crée ensuite l'association. Si vous n'avez pas les autorisations nécessaires, SageMaker AI *ne crée pas* l'association. Une fois l’association entre comptes établie, vous pouvez accéder à une entité de lignée à partir de l’autre réciproquement via l’action d’API `QueryLineage`. Pour de plus amples informations, veuillez consulter [Interrogation d’entités de lignée](querying-lineage-entities.md).

Outre la création automatique d'entités de lignage par l' SageMaker IA, si vous disposez d'un accès entre comptes, l' SageMaker IA connecte les artefacts qui font référence au même objet ou aux mêmes données. Si les données d'un compte sont utilisées pour le suivi du lignage par différents comptes, l' SageMaker IA crée un artefact dans chaque compte pour suivre ces données. Avec le lignage entre comptes, chaque fois que l' SageMaker IA crée de nouveaux artefacts, SageMaker elle vérifie si d'autres artefacts créés pour les mêmes données sont également partagés avec vous. SageMaker L'IA établit ensuite des associations entre l'artefact nouvellement créé et chacun des artefacts partagés avec vous avec le paramètre `AssociationType` défini sur. `SameAs` Vous pouvez ensuite utiliser l’action d’API `[QueryLineage](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_QueryLineage.html)` pour traverser les entités de lignée de votre propre compte vers des entités de lignage partagées avec vous mais détenues par un autre compte AWS . Pour plus d’informations, consultez [Interrogation d’entités de lignée](querying-lineage-entities.md)

**Topics**
+ [Accès aux ressources de lignée à partir d'un autre compte](#tracking-lineage-xaccount-accessing-resources)
+ [Autorisation d’interrogation d’entités de lignée entre comptes](#tracking-lineage-xaccount-authorization)

### Accès aux ressources de lignée à partir d'un autre compte
<a name="tracking-lineage-xaccount-accessing-resources"></a>

Une fois que l'accès entre comptes pour le partage du lignage a été configuré, vous pouvez appeler les actions d' SageMaker API suivantes directement avec l'ARN pour décrire les entités de lignage partagées depuis un autre compte :
+ [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)

Vous pouvez également gérer les [associations](https://docs.aws.amazon.com/sagemaker/latest/dg/lineage-tracking-entities.html) pour les entités de lignage détenues par différents comptes partagés avec vous, à l'aide des actions d' SageMaker API suivantes : 
+ [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)

[Pour un bloc-notes expliquant comment utiliser les API SageMaker AI Lineage pour interroger le lignage entre les comptes, consultez sagemaker-lineage-cross-account-with-ram.ipynb.](https://github.com/aws/amazon-sagemaker-examples/blob/master/sagemaker-lineage/sagemaker-lineage-cross-account-with-ram.ipynb)

### Autorisation d’interrogation d’entités de lignée entre comptes
<a name="tracking-lineage-xaccount-authorization"></a>

Amazon SageMaker AI doit vérifier que vous êtes autorisé à effectuer l'action d'`QueryLineage`API sur le`StartArns`. Cela est appliqué via la politique de ressources attachée au `LineageGroup`. Le résultat de cette action inclut toutes les entités de lignée auxquelles vous avez accès, qu'elles soient détenues par votre compte ou partagées par un autre compte. Pour de plus amples informations, veuillez consulter [Interrogation d’entités de lignée](querying-lineage-entities.md).