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

# Migrar para o namespace de pipelines de mídia do SDK do Amazon Chime
<a name="migrate-pipelines"></a>

Você usa o `ChimeSdkMediaPipelines` namespace para endereçar os endpoints da API do pipeline de mídia em qualquer AWS região em que eles estejam disponíveis. Use esse namespace se você acabou de começar a usar o SDK do Amazon Chime. Para obter mais informações sobre as regiões, consulte [Regiões da AWS disponíveis para o SDK do Amazon Chime](sdk-available-regions.md) neste guia.

Os aplicativos existentes que usam o namespace [Amazon Chime](https://docs.aws.amazon.com/chime/latest/APIReference/API_Operations_Amazon_Chime.html) devem planejar a migração para o namespace dedicado.

**Topics**
+ [Motivos para migrar seus pipelines](#pipeline-migration-reasons)
+ [Antes de migrar seus pipelines](#migration-prerequisites)

## Motivos para migrar seus pipelines
<a name="pipeline-migration-reasons"></a>

Recomendamos que você migre para o namespace `ChimeSdkMediaPipelines` pelos seguintes motivos:

**Escolha do endpoint de API**  
O namespace Media Capture do SDK do Amazon Chime é o único namespace da API que pode usar endpoints da API em qualquer região que os disponibilize. Para obter mais informações sobre as regiões, consulte [Regiões da AWS disponíveis para o SDK do Amazon Chime](sdk-available-regions.md). Se quiser usar outros endpoints da API diferentes de `us-east-1`, você deve usar o namespace `ChimeSdkMediaPipelines`. Para obter mais informações sobre os endpoints atuais, consulte [Mapeamento de API](migrate-from-chm-namespace.md#name-end-map) neste guia.

**Pipeline de mídia atualizado e novo APIs**  
Só adicionamos ou atualizamos o pipeline de mídia APIs no `ChimeSdkMediaPipelines` namespace.

## Antes de migrar seus pipelines
<a name="migration-prerequisites"></a>

Antes de migrar, observe as diferenças entre os namespaces. A tabela a seguir lista e descreve-os.


| Item | Namespace Pipelines de mídia | Namespace Chime | 
| --- | --- | --- | 
|  Nomes do namespace  |  ChimeSdkMediaPipelines  |  Chime  | 
|  Regiões  |  Vários  |  Somente us-east-1  | 
|  Endpoints  |  https://media-pipelines-chime. *região.amazonaws.com*  |  https://service.chime.aws.amazon.com  | 
|  Entidade principal do serviço  |  mediapipelines.chime.amazonaws.com  |  chime.amazonaws.com  | 
|  APIs  |  Somente APIs para pipelines de mídia  |  APIs para canais de mídia e outras partes do Amazon Chime  | 
|  Reuniões  |  Os pipelines de mídia nas regiões `us-west-2`, `ap-southeast-1` e `eu-central-1` funcionam somente com reuniões criadas no namespace SDK do Amazon Chime Meetings. Os pipelines de mídia na região `us-east-1` funcionam com reuniões criadas por qualquer endpoint de reunião em qualquer namespace.  |  Os pipelines de mídia funcionam com reuniões criadas por qualquer endpoint de reunião em qualquer namespace.  | 
| Pipelines de mídia ativa padrão | 100 na região us-east-1 e 10 nas regiões us-west-2, ap-southeast-1 e eu-central-1.  | 100 somente em us-east-1. | 
|  Perfil vinculado a serviço  |  AWSServiceRoleForAmazonChimeSDKMediaOleodutos  |     | 
|  Tags  |  Disponível  |  Não disponível para o canal de mídia APIs.  | 
| CloudTrail fonte do evento | chime-sdk-media-pipelines.amazonaws.com | chime.amazonaws.com. | 
| Conexão em tempo real | Disponível |  Não disponível para o canal de mídia APIs.  | 
| Composição | Disponível |  Não disponível para o canal de mídia APIs.  | 
| Concatenação | Disponível | Não disponível. | 

A lista a seguir fornece mais informações sobre as diferenças entre o Chime e os AWS ChimeSdkMediaPipelines namespaces.

**Nomes do namespace**  
O namespace SDK do Amazon Chime usa o nome formal `AWS.Chime`. O namespace Pipelines de mídia SDK do Amazon Chime usa o nome formal `AWS.ChimeSDKMediaPipelines`. O formato preciso do nome varia de acordo com a plataforma.  
Por exemplo, essa linha de código Node.js aborda o namespace `chime`:  

```
const chimeMediaPipelines = AWS.Chime();
```
Para migrar para o namespace Pipelines de mídia SDK, atualize esse código com o novo namespace e a região do endpoint.  

```
const chimeMediaPipelines = AWS.ChimeSDKMediaPipelines({ region: "eu-central-1" });
```

**Regiões**  
O namespace Amazon Chime aborda somente os endpoints da API na região US-EAST-1. O namespace Pipelines de mídia SDK do Amazon Chime aborda os endpoints da API do Pipeline de mídia SDK do Amazon Chime em qualquer região que os tenha. Para obter uma lista atual das regiões do pipeline de mídia, consulte [Regiões da AWS disponíveis para o SDK do Amazon Chime](sdk-available-regions.md) neste guia.

**Endpoints**  
Para modificar um pipeline de captura de mídia, você deve usar o mesmo endpoint em que criou o pipeline. Por exemplo, se você criou pipelines por meio de um endpoint em eu-central-1, você deve usar eu-central-1 para interagir com esse pipeline. Para obter mais informações sobre os endpoints atuais, consulte [Mapeamento de API](migrate-from-chm-namespace.md#name-end-map) neste guia.

**Entidade principal do serviço**  
O namespace [Pipeline de mídia SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) usa uma nova entidade principal de serviço: `mediapipelines.chime.amazonaws.com`. Se você tiver um bucket do Amazon S3 ou outras políticas do IAM que concedem acesso aos serviços, você precisa atualizar essas políticas para conceder acesso à nova entidade principal responsável pelo serviço.  
Por exemplo, ao criar pipelines de mídia, você deve adicionar as permissões de política listadas em [Criar um bucket do Amazon S3 para pipelines de captura de mídia do SDK do Amazon Chime](create-s3-bucket.md) à nova entidade principal responsável pelo serviço. Para obter mais informações sobre as políticas, consulte [Elementos de política JSON da AWS: entidade principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) no Guia do usuário do IAM.

**APIs**  
O namespace Media Pipelines do Amazon Chime SDK contém somente aqueles APIs que criam e gerenciam canais de mídia. O namespace Amazon Chime inclui canais APIs de mídia, reuniões e outras partes do serviço Amazon Chime.

**Reuniões**  
Os pipelines de mídia na região IAD funcionam com reuniões criadas por qualquer endpoint de reunião em qualquer namespace.

**Perfil vinculado a serviço**  
Somente para o namespace Pipelines de mídia SDK do Amazon Chime. Crie a função *AWSServiceRoleForAmazonChimeSDKMediaPipelines*.

**Tags**  
O namespace [Pipelines de mídia SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) suporta tags. A função deve ter permissão para chamar a `TagResource` operação ao chamar o [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)ou [CreateMediaLiveConnectorPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html) APIs com uma ou mais tags.