Como obter seu endpoint específico da região para o MediaConvert - AWS SDK for JavaScript
O cenárioTarefas de pré-requisitoObter o URL do endpoint

O Guia de API referência da AWS SDK for JavaScript V3 descreve detalhadamente todas as API operações da AWS SDK for JavaScript versão 3 (V3).

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

Como obter seu endpoint específico da região para o MediaConvert

JavaScript code example that applies to Node.js execution

Este exemplo de código Node.js mostra:

  • Como recuperar o endpoint específico da região do MediaConvert.

O cenário

Neste exemplo, você usa um módulo Node.js para chamar o MediaConvert e recuperar o endpoint específico da região. Você pode recuperar o URL do seu endpoint a partir do endpoint padrão de serviço e, dessa forma, o endpoint específico por região ainda não será necessário. O código usa o SDK para JavaScript para recuperar esse endpoint usando este método da classe de cliente do MediaConvert:

Tarefas de pré-requisito

Para configurar e executar este exemplo, primeiro conclua estas tarefas:

  • Configure o ambiente do projeto para executar estes exemplos do Node TypeScript e instale os módulos do AWS SDK for JavaScript e de terceiros necessários. Siga as instruções no GitHub.

  • Crie um arquivo de configurações compartilhado com as credenciais de usuário. Para obter mais informações sobre como fornecer um arquivo de credenciais compartilhado, consulte Arquivos de configuração e credenciais compartilhados no Guia de referência de ferramentas e SDKs da AWS.

  • Crie um perfil do IAM que dê ao MediaConvert acesso aos arquivos de entrada e aos buckets do Amazon S3 onde os arquivos de saída são armazenados. Para obter detalhes, consulte Configurar permissões do IAM no Guia do usuário do AWS Elemental MediaConvert.

Importante

Este exemplo usa ECMAScript6 (ES6). Isso requer o Node.js versão 13.x ou superior. Para baixar e instalar a versão mais recente do Node.js, consulte Downloads do Node.js.

No entanto, se você preferir usar a sintaxe CommonJS, consulte Sintaxe ES6/CommonJS de JavaScript.

Obter o URL do endpoint

Crie um diretório libs e um módulo Node.js com o nome do arquivoemcClientGet.js. Copie e cole o código abaixo nele, o que cria o objeto de cliente do MediaConvert. Substitua REGION pela sua região da AWS. 

import { MediaConvertClient } from "@aws-sdk/client-mediaconvert";
// Set the AWS Region.
const REGION = "REGION";
//Set the MediaConvert Service Object
const emcClientGet = new MediaConvertClient({ region: REGION });
export { emcClientGet };

Esse código de exemplo pode ser encontrado aqui no GitHub.

Crie um módulo do Node.js com o nome de arquivo emc_getendpoint.js. Certifique-se de configurar o SDK conforme mostrado anteriormente, incluindo a instalação dos clientes e pacotes necessários.

Crie um objeto a fim de passar os parâmetros de solicitação vazios para o método DescribeEndpointsCommand da classe de cliente do MediaConvert. Depois, chame o método DescribeEndpointsCommand. 

// Import required AWS-SDK clients and commands for Node.js
import { DescribeEndpointsCommand } from "@aws-sdk/client-mediaconvert";
import { emcClientGet } from "./libs/emcClientGet.js";

//set the parameters.
const params = { MaxResults: 0 };

const run = async () => {
  try {
    // Create a new service object and set MediaConvert to customer endpoint
    const data = await emcClientGet.send(new DescribeEndpointsCommand(params));
    console.log("Your MediaConvert endpoint is ", data.Endpoints);
    return data;
  } catch (err) {
    console.log("Error", err);
  }
};
run();

Para executar o exemplo, digite o seguinte no prompt de comando.

node emc_getendpoint.js

Esse código de exemplo pode ser encontrado aqui no GitHub.