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.

**APIs de pipeline de mídia novas e atualizadas**  
Só adicionamos ou atualizamos as APIs do pipeline de mídia no namespace `ChimeSdkMediaPipelines`.

## 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 pipelines 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. | 
| Service-linked papel | AWSServiceRoleForAmazonChimeSDKMediaPipelines |   | 
| Tags | Available (Disponível) | Não disponível para as APIs do pipeline de mídia. | 
| CloudTrail fonte do evento | chime-sdk-media-pipelines.amazonaws.com | chime.amazonaws.com. | 
| Conexão em tempo real | Available (Disponível) | Não disponível para as APIs do pipeline de mídia. | 
| Composição | Available (Disponível) | Não disponível para as APIs do pipeline de mídia. | 
| Concatenação | Available (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 Node.js código aborda o `chime` namespace:  

```
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 Pipelines de mídia SDK do Amazon Chime contém somente APIs que criam e gerenciam pipelines de mídia. O namespace Amazon Chime inclui APIs para pipelines 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.

**Service-linked papel**  
Somente para o namespace Pipelines de mídia SDK do Amazon Chime. Crie a função do *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 as [CreateMediaLiveConnectorPipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaLiveConnectorPipeline.html)APIs [CreateMediaCapturePipeline](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaCapturePipeline.html)ou com uma ou mais tags.