[AWS SDK for JavaScript V3 API 참조 안내서](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)는 AWS SDK for JavaScript 버전 3(V3)의 모든 API 작업을 자세히 설명합니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# MediaConvert에서 작업 템플릿 사용
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/ko_kr/sdk-for-javascript/v3/developer-guide/images/nodeicon.png)
**이 Node.js 코드 예제는 다음을 보여 줍니다.**
+ AWS Elemental MediaConvert 작업 템플릿을 생성하는 방법.
+ 작업 템플릿을 사용하여 트랜스코딩 작업을 생성하는 방법.
+ 모든 작업 템플릿의 목록을 표시하는 방법.
+ 작업 템플릿을 삭제하는 방법.
## 시나리오
MediaConvert에서 트랜스코딩 작업을 생성하는 데 필요한 JSON은 많은 수의 설정을 포함하여 세부적입니다. 후속 작업을 생성하는 데 사용할 수 있는 작업 템플릿에 알려진 좋은 설정을 저장하여 작업 생성을 대폭 간소화할 수 있습니다. 이 예에서는 Node.js 모듈을 사용해 MediaConvert를 직접적으로 호출하여 작업 템플릿을 생성, 사용 및 관리합니다. 이 코드는 SDK for JavaScript에서 MediaConvert 클라이언트 클래스의 다음 메서드를 사용하여 이 작업을 수행합니다.
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobTemplateCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobTemplateCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/DeleteJobTemplateCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/DeleteJobTemplateCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/ListJobTemplatesCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/ListJobTemplatesCommand/)
## 사전 필수 작업
이 예제를 설정하고 실행하려면 먼저 다음 작업을 완료합니다.
+ 이러한 노드 TypeScript 예를 실행하도록 프로젝트 환경을 설정하고 필수 AWS SDK for JavaScript 모듈과 타사 모듈을 설치합니다. [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code/mediaconvert/README.md)의 지침을 따릅니다.
+ 사용자 자격 증명을 사용하여 공유 구성 파일을 생성합니다. 공유 보안 인증 파일 제공에 관한 자세한 내용은 *AWS SDK 및 도구 참조 가이드*의 [Shared config and credentials files](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) 단원을 참조하세요.
+ 출력 파일이 저장된 Amazon S3 버킷 및 입력 파일에 대한 액세스 권한을 MediaConvert에 부여하는 IAM 역할을 생성합니다. 자세한 내용은 *AWS Elemental MediaConvert 사용 설명서*의 [Set up IAM permissions](https://docs.aws.amazon.com/mediaconvert/latest/ug/iam-role.html) 단원을 참조하세요.
**중요**
이 예에서는 ECMAScript6(ES6)를 사용합니다. 따라서 Node.js 버전 13.x 이상이 필요합니다. 최신 버전의 Node.js를 다운로드하여 설치하려면 [Node.js downloads](https://nodejs.org/en/download)를 참조하세요.
그러나 CommonJS 구문을 사용하려는 경우 [JavaScript ES6/CommonJS 구문](sdk-example-javascript-syntax.md) 단원을 참조하세요.
## 작업 템플릿 생성
파일 이름이 `emc_create_jobtemplate.js`인 Node.js 모듈을 생성합니다. 필수 클라이언트 및 패키지 설치를 포함하여 앞서 나와 있는 것처럼 SDK를 구성해야 합니다.
템플릿 생성을 위한 파라미터 JSON을 지정합니다. 이전에 성공한 작업에서 대부분의 JSON 파라미터를 사용하여 템플릿에서 `Settings` 값을 지정할 수 있습니다. 이 예제에서는 [MediaConvert에서 트랜스코딩 작업 생성 및 관리](emc-examples-jobs.md)의 작업 설정을 사용합니다.
파라미터를 전달하는 `MediaConvert` 클라이언트 서비스 객체를 간접적으로 호출하기 위한 promise를 생성하여 `CreateJobTemplateCommand` 메서드를 직접적으로 호출합니다.
**참고**
*JOB\$1QUEUE\$1ARN*을 확인할 작업 대기열의 Amazon 리소스 이름(ARN)으로 바꾸고, *BUCKET\$1NAME*을 대상 Amazon S3 버킷의 이름(예: "s3://BUCKET\$1NAME/")으로 바꿉니다.
```
// Import required AWS-SDK clients and commands for Node.js
import { CreateJobTemplateCommand } from "@aws-sdk/client-mediaconvert";
import { emcClient } from "./libs/emcClient.js";
const params = {
Category: "YouTube Jobs",
Description: "Final production transcode",
Name: "DemoTemplate",
Queue: "JOB_QUEUE_ARN", //JOB_QUEUE_ARN
Settings: {
OutputGroups: [
{
Name: "File Group",
OutputGroupSettings: {
Type: "FILE_GROUP_SETTINGS",
FileGroupSettings: {
Destination: "BUCKET_NAME", // BUCKET_NAME e.g., "s3://BUCKET_NAME/"
},
},
Outputs: [
{
VideoDescription: {
ScalingBehavior: "DEFAULT",
TimecodeInsertion: "DISABLED",
AntiAlias: "ENABLED",
Sharpness: 50,
CodecSettings: {
Codec: "H_264",
H264Settings: {
InterlaceMode: "PROGRESSIVE",
NumberReferenceFrames: 3,
Syntax: "DEFAULT",
Softness: 0,
GopClosedCadence: 1,
GopSize: 90,
Slices: 1,
GopBReference: "DISABLED",
SlowPal: "DISABLED",
SpatialAdaptiveQuantization: "ENABLED",
TemporalAdaptiveQuantization: "ENABLED",
FlickerAdaptiveQuantization: "DISABLED",
EntropyEncoding: "CABAC",
Bitrate: 5000000,
FramerateControl: "SPECIFIED",
RateControlMode: "CBR",
CodecProfile: "MAIN",
Telecine: "NONE",
MinIInterval: 0,
AdaptiveQuantization: "HIGH",
CodecLevel: "AUTO",
FieldEncoding: "PAFF",
SceneChangeDetect: "ENABLED",
QualityTuningLevel: "SINGLE_PASS",
FramerateConversionAlgorithm: "DUPLICATE_DROP",
UnregisteredSeiTimecode: "DISABLED",
GopSizeUnits: "FRAMES",
ParControl: "SPECIFIED",
NumberBFramesBetweenReferenceFrames: 2,
RepeatPps: "DISABLED",
FramerateNumerator: 30,
FramerateDenominator: 1,
ParNumerator: 1,
ParDenominator: 1,
},
},
AfdSignaling: "NONE",
DropFrameTimecode: "ENABLED",
RespondToAfd: "NONE",
ColorMetadata: "INSERT",
},
AudioDescriptions: [
{
AudioTypeControl: "FOLLOW_INPUT",
CodecSettings: {
Codec: "AAC",
AacSettings: {
AudioDescriptionBroadcasterMix: "NORMAL",
RateControlMode: "CBR",
CodecProfile: "LC",
CodingMode: "CODING_MODE_2_0",
RawFormat: "NONE",
SampleRate: 48000,
Specification: "MPEG4",
Bitrate: 64000,
},
},
LanguageCodeControl: "FOLLOW_INPUT",
AudioSourceName: "Audio Selector 1",
},
],
ContainerSettings: {
Container: "MP4",
Mp4Settings: {
CslgAtom: "INCLUDE",
FreeSpaceBox: "EXCLUDE",
MoovPlacement: "PROGRESSIVE_DOWNLOAD",
},
},
NameModifier: "_1",
},
],
},
],
AdAvailOffset: 0,
Inputs: [
{
AudioSelectors: {
"Audio Selector 1": {
Offset: 0,
DefaultSelection: "NOT_DEFAULT",
ProgramSelection: 1,
SelectorType: "TRACK",
Tracks: [1],
},
},
VideoSelector: {
ColorSpace: "FOLLOW",
},
FilterEnable: "AUTO",
PsiControl: "USE_PSI",
FilterStrength: 0,
DeblockFilter: "DISABLED",
DenoiseFilter: "DISABLED",
TimecodeSource: "EMBEDDED",
},
],
TimecodeConfig: {
Source: "EMBEDDED",
},
},
};
const run = async () => {
try {
// Create a promise on a MediaConvert object
const data = await emcClient.send(new CreateJobTemplateCommand(params));
console.log("Success!", data);
return data;
} catch (err) {
console.log("Error", err);
}
};
run();
```
예를 실행하려면 명령 프롬프트에서 다음을 입력합니다.
```
node emc_create_jobtemplate.js
```
이 코드 예는 [여기 GitHub에서](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_create_jobtemplate.js) 찾을 수 있습니다.
## 작업 템플릿에서 트랜스코딩 작업 생성
파일 이름이 `emc_template_createjob.js`인 Node.js 모듈을 생성합니다. 필수 클라이언트 및 패키지 설치를 포함하여 앞서 나와 있는 것처럼 SDK를 구성해야 합니다.
사용할 작업 템플릿의 이름, 생성하는 작업에 특정하게 사용할 `Settings`를 포함하여 작업 생성 파라미터 JSON을 생성합니다. 그런 다음, 파라미터를 전달하는 `MediaConvert` 클라이언트 서비스 객체를 간접적으로 호출하기 위한 promise를 생성하여 `CreateJobsCommand` 메서드를 직접적으로 호출합니다.
**참고**
*JOB\$1QUEUE\$1ARN*을 확인할 작업 대기열의 Amazon 리소스 이름(ARN)으로 바꾸고, *KEY\$1PAIR\$1NAME*, *TEMPLATE\$1NAME*, *ROLE\$1ARN*을 역할의 Amazon 리소스 이름(ARN)으로 바꾸고, *INPUT\$1BUCKET\$1AND\$1FILENAME*을 입력 버킷 및 파일 이름(예: "s3://BUCKET\$1NAME/FILE\$1NAME")으로 바꿉니다.
```
// Import required AWS-SDK clients and commands for Node.js
import { CreateJobCommand } from "@aws-sdk/client-mediaconvert";
import { emcClient } from "./libs/emcClient.js";
const params = {
Queue: "QUEUE_ARN", //QUEUE_ARN
JobTemplate: "TEMPLATE_NAME", //TEMPLATE_NAME
Role: "ROLE_ARN", //ROLE_ARN
Settings: {
Inputs: [
{
AudioSelectors: {
"Audio Selector 1": {
Offset: 0,
DefaultSelection: "NOT_DEFAULT",
ProgramSelection: 1,
SelectorType: "TRACK",
Tracks: [1],
},
},
VideoSelector: {
ColorSpace: "FOLLOW",
},
FilterEnable: "AUTO",
PsiControl: "USE_PSI",
FilterStrength: 0,
DeblockFilter: "DISABLED",
DenoiseFilter: "DISABLED",
TimecodeSource: "EMBEDDED",
FileInput: "INPUT_BUCKET_AND_FILENAME", //INPUT_BUCKET_AND_FILENAME, e.g., "s3://BUCKET_NAME/FILE_NAME"
},
],
},
};
const run = async () => {
try {
const data = await emcClient.send(new CreateJobCommand(params));
console.log("Success! ", data);
return data;
} catch (err) {
console.log("Error", err);
}
};
run();
```
예를 실행하려면 명령 프롬프트에서 다음을 입력합니다.
```
node emc_template_createjob.js
```
이 코드 예는 [여기 GitHub에서](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_template_createjob.js) 찾을 수 있습니다.
## 작업 템플릿 목록 표시
파일 이름이 `emc_listtemplates.js`인 Node.js 모듈을 생성합니다. 필수 클라이언트 및 패키지 설치를 포함하여 앞서 나와 있는 것처럼 SDK를 구성해야 합니다.
`listTemplates` 클라이언트 클래스의 `MediaConvert` 메서드에 대한 요청 파라미터를 전달할 객체를 생성합니다. 나열할 템플릿(`NAME`, `CREATION DATE`, `SYSTEM`), 나열할 개수 및 정렬 순서를 결정하는 값을 포함시킵니다. `ListTemplatesCommand` 메서드를 직접적으로 호출하려면 MediaConvert 서비스 객체를 간접적으로 호출하기 위한 promise를 생성하고 파라미터를 전달합니다.
```
// Import required AWS-SDK clients and commands for Node.js
import { ListJobTemplatesCommand } from "@aws-sdk/client-mediaconvert";
import { emcClient } from "./libs/emcClient.js";
const params = {
ListBy: "NAME",
MaxResults: 10,
Order: "ASCENDING",
};
const run = async () => {
try {
const data = await emcClient.send(new ListJobTemplatesCommand(params));
console.log("Success ", data.JobTemplates);
return data;
} catch (err) {
console.log("Error", err);
}
};
run();
```
예를 실행하려면 명령 프롬프트에서 다음을 입력합니다.
```
node emc_listtemplates.js
```
이 코드 예는 [여기 GitHub에서](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_template_createjob.js) 찾을 수 있습니다.
## 작업 템플릿 삭제
파일 이름이 `emc_deletetemplate.js`인 Node.js 모듈을 생성합니다. 필수 클라이언트 및 패키지 설치를 포함하여 앞서 나와 있는 것처럼 SDK를 구성해야 합니다.
삭제하려는 작업 템플릿의 이름을 `DeleteJobTemplateCommand` 클라이언트 클래스의 `MediaConvert` 메서드에 대한 파라미터로 전달할 객체를 생성합니다. `DeleteJobTemplateCommand` 메서드를 직접적으로 호출하려면 MediaConvert 서비스 객체를 간접적으로 호출하기 위한 promise를 생성하고 파라미터를 전달합니다.
```
// Import required AWS-SDK clients and commands for Node.js
import { DeleteJobTemplateCommand } from "@aws-sdk/client-mediaconvert";
import { emcClient } from "./libs/emcClient.js";
// Set the parameters
const params = { Name: "test" }; //TEMPLATE_NAME
const run = async () => {
try {
const data = await emcClient.send(new DeleteJobTemplateCommand(params));
console.log(
"Success, template deleted! Request ID:",
data.$metadata.requestId,
);
return data;
} catch (err) {
console.log("Error", err);
}
};
run();
```
예를 실행하려면 명령 프롬프트에서 다음을 입력합니다.
```
node emc_deletetemplate.js
```
이 코드 예는 [여기 GitHub에서](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_deletetemplate.js) 찾을 수 있습니다.