As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Monitorar linhagem entre contas
O Amazon SageMaker AI oferece suporte ao rastreamento de entidades de linhagem a partir de uma AWS conta diferente. Outras AWS contas podem compartilhar suas entidades de linhagem com você e você pode acessar essas entidades de linhagem por meio de chamadas diretas de API ou consultas de linhagem de SageMaker IA.
SageMaker A IA é usada [AWS Resource Access Manager](https://docs.aws.amazon.com/ram/latest/userguide/what-is.html)para ajudar você a compartilhar com segurança seus recursos de linhagem. Você pode compartilhar seus recursos por meio do [console do AWS RAM](https://console.aws.amazon.com/ram/home).
## Configurar o monitoramento de linhagem entre contas
Você pode agrupar e compartilhar seus [Entidades de monitoramento de linhagem](lineage-tracking-entities.md) por meio de um grupo de linhagem na Amazon SageMaker AI. SageMaker A IA oferece suporte a apenas um grupo de linhagem padrão por conta. SageMaker A IA cria o grupo de linhagem padrão sempre que uma entidade de linhagem é criada em sua conta. Cada entidade de linhagem pertencente à sua conta é atribuída a esse grupo de linhagem padrão. Para compartilhar entidades de linhagem com outra conta, você compartilha esse grupo de linhagem padrão com essa conta.
**nota**
Você pode compartilhar todas as entidades de monitoramento de linhagem em um grupo de linhagem ou nenhuma.
Crie um compartilhamento de recursos para suas entidades de linhagem usando o AWS Resource Access Manager console. Para obter mais informações, consulte [Compartilhar seus recursos da AWS](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html) no *Guia do usuário do AWS Resource Access Manager *.
**nota**
Depois que o compartilhamento de recursos for criado, poderá levar alguns minutos para que as associações de recursos e entidades principais sejam concluídas. Depois que a associação for definida, a conta compartilhada receberá um convite para ingressar no compartilhamento de recursos. As contas compartilhadas devem aceitar o convite para obter acesso a todos os recursos compartilhados. Para obter mais informações sobre como aceitar um convite para compartilhamento de recursos AWS RAM, consulte [Usando AWS recursos compartilhados](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-shared.html) no *Guia do Usuário do AWS Resource Access Manager*.
### Sua política de recursos de monitoramento de linhagem entre contas
A Amazon SageMaker AI oferece suporte a apenas um tipo de política de recursos. A política de recursos de SageMaker IA deve permitir todas as seguintes operações:
```
"sagemaker:DescribeAction"
"sagemaker:DescribeArtifact"
"sagemaker:DescribeContext"
"sagemaker:DescribeTrialComponent"
"sagemaker:AddAssociation"
"sagemaker:DeleteAssociation"
"sagemaker:QueryLineage"
```
**Example Veja a seguir uma política de recursos de SageMaker IA criada usando AWS Resource Access Manager para criar um compartilhamento de recursos para um grupo de linhagem de contas.**
****
```
{
"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"
}
]
}
```
## Monitoramento de entidades de linhagem entre contas
Com o monitoramento de linhagem entre contas, você pode associar entidades de linhagem em contas diferentes usando a mesma ação de API `AddAssociation`. Quando você associa duas entidades de linhagem, a SageMaker IA valida se você tem permissões para realizar a ação da `AddAssociation` API em ambas as entidades de linhagem. SageMaker A IA então estabelece a associação. Se você não tiver as permissões, a SageMaker IA *não* cria a associação. Depois que a associação entre contas for estabelecida, você poderá acessar qualquer entidade de linhagem da outra por meio da ação da API `QueryLineage`. Para obter mais informações, consulte [Consultar entidades de linhagem](querying-lineage-entities.md).
Além da SageMaker IA criar automaticamente entidades de linhagem, se você tiver acesso entre contas, a SageMaker IA conecta artefatos que fazem referência ao mesmo objeto ou dados. Se os dados de uma conta forem usados no rastreamento de linhagem por contas diferentes, a SageMaker IA cria um artefato em cada conta para rastrear esses dados. Com a linhagem entre contas, sempre que a SageMaker IA cria novos artefatos, SageMaker ela verifica se há outros artefatos criados para os mesmos dados que também são compartilhados com você. SageMaker A IA então estabelece associações entre o artefato recém-criado e cada um dos artefatos compartilhados com você com o `AssociationType` conjunto. `SameAs` Em seguida, você pode usar a ação da `[QueryLineage](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_QueryLineage.html)` API para atravessar as entidades de linhagem em sua própria conta até entidades de linhagem compartilhadas com você, mas pertencentes a uma conta diferente AWS . Para obter mais informações, consulte [Consultar entidades de linhagem](querying-lineage-entities.md).
**Topics**
+ [Acessando recursos de linhagem de uma conta diferente](#tracking-lineage-xaccount-accessing-resources)
+ [Autorização para consultar entidades de linhagem entre contas](#tracking-lineage-xaccount-authorization)
### Acessando recursos de linhagem de uma conta diferente
Depois que o acesso entre contas para compartilhar linhagem for configurado, você poderá chamar as seguintes ações de SageMaker API diretamente com o ARN para descrever as entidades de linhagem compartilhada de outra conta:
+ [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)
Você também pode gerenciar [associações](https://docs.aws.amazon.com/sagemaker/latest/dg/lineage-tracking-entities.html) para entidades de linhagem pertencentes a contas diferentes que são compartilhadas com você, usando as seguintes ações de SageMaker API:
+ [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 um caderno que demonstra como usar o SageMaker AI Lineage APIs para consultar a linhagem em várias contas, consulte -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)
### Autorização para consultar entidades de linhagem entre contas
A Amazon SageMaker AI deve validar que você tem permissões para realizar a ação `QueryLineage` da API no`StartArns`. Isso é aplicado por meio da política de recursos anexada ao `LineageGroup`. O resultado dessa ação inclui todas as entidades de linhagem às quais você tem acesso, sejam elas de propriedade da sua conta ou compartilhadas por outra conta. Para obter mais informações, consulte [Consultar entidades de linhagem](querying-lineage-entities.md).