Aviso de fim do suporte: em 20 de maio de 2026, AWS encerrará o suporte para AWS SimSpace Weaver. Depois de 20 de maio de 2026, você não poderá mais acessar o SimSpace Weaver console ou os SimSpace Weaver recursos. Para obter mais informações, consulte [AWS SimSpace Weaver Fim do suporte](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html). 

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á.

# Transferir uma entidade para um domínio espacial
<a name="working-with_app-sdk_ent_transfer"></a>

Depois que um aplicativo personalizado ou de serviço cria uma entidade, deve transferir a entidade para um domínio espacial para que a entidade exista espacialmente na simulação. As entidades em um domínio espacial podem ser lidas por outros aplicativos e atualizadas por um aplicativo espacial. Use a API `ModifyEntityDomain()` para transferir uma entidade para um domínio espacial.

```
AWS_WEAVERRUNTIME_API Result<void> ModifyEntityDomain(Transaction& txn, const Entity& entity, DomainId domainId) noexcept;
```

Se `DomainId` não corresponder à `Partition` atribuída pelo aplicativo de chamada, então `DomainId` deve ser para um `Domain` de `DomainType::Spatial`. A transferência de propriedade para o novo `Domain` ocorre durante `Commit(Transaction&&)`.Parâmetros

`txn`  
A `Transaction` atual.

`entity`  
A `Entity` de destino para a mudança de `Domain`.

`domainId`  
O `DomainId` do `Domain` de destino para a `Entity`.

Essa API retornará `Success` se o domínio da entidade tiver sido alterado com sucesso.