# 使用 AWS CLI 的 MediaConvert 示例
以下代码示例演示如何通过将 AWS Command Line Interface与 MediaConvert 结合使用，来执行操作和实现常见场景。
*操作是大型程序的代码摘录*，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。
每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。
**Topics**
+ [操作](#actions)
## 操作
### `cancel-job`
以下代码示例演示了如何使用 `cancel-job`。
**AWS CLI**
**取消队列中的一个作业**
以下 `cancel-job` 示例取消 ID 为 `1234567891234-abc123` 的作业。如果服务已经开始处理该作业，则无法取消它。
```
aws mediaconvert cancel-job \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1 \
--id 1234567891234-abc123
```
要获取账户特定的端点，请使用 `describe-endpoints`，或发送不带端点的命令。该服务会返回错误和您的端点。
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 作业](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [CancelJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/cancel-job.html)。
### `create-job-template`
以下代码示例演示了如何使用 `create-job-template`。
**AWS CLI**
**创建作业模板**
以下 `create-job-template` 示例使用您的系统上的文件 `job-template.json` 中指定的转码设置创建一个作业模板。
```
aws mediaconvert create-job-template \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1 \
--name JobTemplate1 \
--cli-input-json file://~/job-template.json
```
如果您通过使用 `get-job-template` 然后修改文件的方法来创建作业模板 JSON 文件，则移除 `JobTemplate` 对象，但保留其中的 Settings 子对象。另外，请务必移除以下键-值对：`LastUpdated`、`Arn`、`Type` 和 `CreatedAt`。您可以在 JSON 文件或命令行中指定类别、描述、名称和队列。
要获取账户特定的端点，请使用 `describe-endpoints`，或发送不带端点的命令。该服务会返回错误和您的端点。
如果您的请求成功，则服务会为您创建的作业模板返回 JSON 规范。
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 作业模板](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [CreateJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-job-template.html)。
### `create-job`
以下代码示例演示了如何使用 `create-job`。
**AWS CLI**
**创建作业**
以下 `create-job` 示例使用在位于您发送命令的系统上的文件 `job.json` 中指定的设置创建转码作业。此 JSON 作业规范可以单独指定每个设置，引用作业模板或引用输出预设。
```
aws mediaconvert create-job \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1 \
--cli-input-json file://~/job.json
```
您可以使用 AWS Elemental MediaConvert 控制台生成 JSON 作业规范，方法是：选择您的作业设置，然后选择**作业** 部分底部的**显示作业 JSON**。
要获取账户特定的端点，请使用 `describe-endpoints`，或发送不带端点的命令。该服务会返回错误和您的端点。
如果您的请求成功，则该服务将返回您在请求中发送的 JSON 作业规范。
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 作业](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [CreateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-job.html)。
### `create-preset`
以下代码示例演示了如何使用 `create-preset`。
**AWS CLI**
**创建自定义输出预设**
以下 `create-preset` 示例根据文件 `preset.json` 中指定的输出设置创建自定义输出预设。您可以在 JSON 文件或命令行中指定类别、描述和名称。
```
aws mediaconvert create-preset \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com
--region region-name-1 \
--cli-input-json file://~/preset.json
```
如果您通过使用 `get-preset` 然后修改输出文件的方法来创建预设 JSON 文件，请务必删除以下键-值对：`LastUpdated`、`Arn`、`Type` 和 `CreatedAt`。
要获取账户特定的端点，请使用 `describe-endpoints`，或发送不带端点的命令。该服务会返回错误和您的端点。
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 输出预设](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [CreatePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-preset.html)。
### `create-queue`
以下代码示例演示了如何使用 `create-queue`。
**AWS CLI**
**创建自定义队列**
以下 `create-queue` 示例创建一个自定义转码队列。
```
aws mediaconvert create-queue \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1 \
--name Queue1 \
--description "Keep this queue empty unless job is urgent."
```
要获取账户特定的端点，请使用 `describe-endpoints`，或发送不带端点的命令。该服务会返回错误和您的端点。
输出：
```
{
"Queue": {
"Status": "ACTIVE",
"Name": "Queue1",
"LastUpdated": 1518034928,
"Arn": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1",
"Type": "CUSTOM",
"CreatedAt": 1518034928,
"Description": "Keep this queue empty unless job is urgent."
}
}
```
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 队列](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [CreateQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-queue.html)。
### `delete-job-template`
以下代码示例演示了如何使用 `delete-job-template`。
**AWS CLI**
**删除作业模板**
以下 `delete-job-template` 示例删除指定的自定义作业模板。
```
aws mediaconvert delete-job-template \
--name "DASH Streaming" \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
此命令不生成任何输出。运行 `aws mediaconvert list-job-templates` 来确认您的模板是否被删除。
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 作业模板](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [DeleteJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-job-template.html)。
### `delete-preset`
以下代码示例演示了如何使用 `delete-preset`。
**AWS CLI**
**删除自定义按需队列**
以下 `delete-preset` 示例删除指定自定义预设。
```
aws mediaconvert delete-preset \
--name SimpleMP4 \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
此命令不生成任何输出。运行 `aws mediaconvert list-presets` 来确认您的预设是否被删除。
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 输出预设](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [DeletePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-preset.html)。
### `delete-queue`
以下代码示例演示了如何使用 `delete-queue`。
**AWS CLI**
**删除自定义按需队列**
以下 `delete-queue` 示例删除指定的自定义按需队列。
您无法删除您的默认队列。您无法删除具有活动定价计划或包含未处理作业的预留队列。
```
aws mediaconvert delete-queue \
--name Customer1 \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
此命令不生成任何输出。运行 `aws mediaconvert list-queues` 来确认您的队列是否被删除。
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 队列](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [DeleteQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-queue.html)。
### `describe-endpoints`
以下代码示例演示了如何使用 `describe-endpoints`。
**AWS CLI**
**获取特定账户端点**
以下 `describe-endpoints` 示例检索向服务发送任何其他请求所需的端点。
```
aws mediaconvert describe-endpoints
```
输出：
```
{
"Endpoints": [
{
"Url": "https://abcd1234.mediaconvert.region-name-1.amazonaws.com"
}
]
}
```
有关更多信息，请参阅《AWS Elemental MediaConvert API 参考》**中的[使用 API 的 MediaConvert 入门](https://docs.aws.amazon.com/mediaconvert/latest/apireference/getting-started.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [DescribeEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/describe-endpoints.html)。
### `get-job-template`
以下代码示例演示了如何使用 `get-job-template`。
**AWS CLI**
**获取作业模板的详细信息**
以下 `get-job-template` 示例显示指定的自定义作业模板的 JSON 定义。
```
aws mediaconvert get-job-template \
--name "DASH Streaming" \
--endpoint-url https://abcd1234.mediaconvert.us-east-1.amazonaws.com
```
输出：
```
{
"JobTemplate": {
"StatusUpdateInterval": "SECONDS_60",
"LastUpdated": 1568652998,
"Description": "Create a DASH streaming ABR stack",
"CreatedAt": 1568652998,
"Priority": 0,
"Name": "DASH Streaming",
"Settings": {
......
},
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/DASH Streaming",
"Type": "CUSTOM"
}
}
```
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 作业模板](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [GetJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-job-template.html)。
### `get-job`
以下代码示例演示了如何使用 `get-job`。
**AWS CLI**
**获取特定作业的详细信息**
以下示例请求 ID 为 `1234567890987-1ab2c3` 的作业的信息，在本示例中，该作业以错误结尾。
```
aws mediaconvert get-job \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1 \
--id 1234567890987-1ab2c3
```
要获取账户特定的端点，请使用 `describe-endpoints`，或发送不带端点的命令。该服务会返回错误和您的端点。
如果您的请求成功，该服务将返回一个含作业信息的 JSON 文件，包括作业设置、任何返回的错误以及其他作业数据，如下所示：
```
{
"Job": {
"Status": "ERROR",
"Queue": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1",
"Settings": {
......
},
"ErrorMessage": "Unable to open input file [s3://my-input-bucket/file-name.mp4]: [Failed probe/open: [Failed to read data: AssumeRole failed]]",
"ErrorCode": 1434,
"Role": "arn:aws:iam::012345678998:role/MediaConvertServiceRole",
"Arn": "arn:aws:mediaconvert:us-west-1:012345678998:jobs/1234567890987-1ab2c3",
"UserMetadata": {},
"Timing": {
"FinishTime": 1517442131,
"SubmitTime": 1517442103,
"StartTime": 1517442104
},
"Id": "1234567890987-1ab2c3",
"CreatedAt": 1517442103
}
}
```
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 作业](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)。
+ 有关 API 详细信息，请参阅《*AWS CLI 命令参考*》中的 [GetJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-job.html)。
### `get-preset`
以下代码示例演示了如何使用 `get-preset`。
**AWS CLI**
**获取特定预设的详细信息**
以下 `get-preset` 示例请求指定的自定义预设的 JSON 定义。
```
aws mediaconvert get-preset \
--name SimpleMP4 \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
输出：
```
{
"Preset": {
"Description": "Creates basic MP4 file. No filtering or preproccessing.",
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4",
"LastUpdated": 1568843141,
"Name": "SimpleMP4",
"Settings": {
"ContainerSettings": {
"Mp4Settings": {
"FreeSpaceBox": "EXCLUDE",
"CslgAtom": "INCLUDE",
"MoovPlacement": "PROGRESSIVE_DOWNLOAD"
},
"Container": "MP4"
},
"AudioDescriptions": [
{
"LanguageCodeControl": "FOLLOW_INPUT",
"AudioTypeControl": "FOLLOW_INPUT",
"CodecSettings": {
"AacSettings": {
"RawFormat": "NONE",
"CodecProfile": "LC",
"AudioDescriptionBroadcasterMix": "NORMAL",
"SampleRate": 48000,
"Bitrate": 96000,
"RateControlMode": "CBR",
"Specification": "MPEG4",
"CodingMode": "CODING_MODE_2_0"
},
"Codec": "AAC"
}
}
],
"VideoDescription": {
"RespondToAfd": "NONE",
"TimecodeInsertion": "DISABLED",
"Sharpness": 50,
"ColorMetadata": "INSERT",
"CodecSettings": {
"H264Settings": {
"FramerateControl": "INITIALIZE_FROM_SOURCE",
"SpatialAdaptiveQuantization": "ENABLED",
"Softness": 0,
"Telecine": "NONE",
"CodecLevel": "AUTO",
"QualityTuningLevel": "SINGLE_PASS",
"UnregisteredSeiTimecode": "DISABLED",
"Slices": 1,
"Syntax": "DEFAULT",
"GopClosedCadence": 1,
"AdaptiveQuantization": "HIGH",
"EntropyEncoding": "CABAC",
"InterlaceMode": "PROGRESSIVE",
"ParControl": "INITIALIZE_FROM_SOURCE",
"NumberBFramesBetweenReferenceFrames": 2,
"GopSizeUnits": "FRAMES",
"RepeatPps": "DISABLED",
"CodecProfile": "MAIN",
"FieldEncoding": "PAFF",
"GopSize": 90.0,
"SlowPal": "DISABLED",
"SceneChangeDetect": "ENABLED",
"GopBReference": "DISABLED",
"RateControlMode": "CBR",
"FramerateConversionAlgorithm": "DUPLICATE_DROP",
"FlickerAdaptiveQuantization": "DISABLED",
"DynamicSubGop": "STATIC",
"MinIInterval": 0,
"TemporalAdaptiveQuantization": "ENABLED",
"Bitrate": 400000,
"NumberReferenceFrames": 3
},
"Codec": "H_264"
},
"AfdSignaling": "NONE",
"AntiAlias": "ENABLED",
"ScalingBehavior": "DEFAULT",
"DropFrameTimecode": "ENABLED"
}
},
"Type": "CUSTOM",
"CreatedAt": 1568841521
}
}
```
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 输出预设](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [GetPreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-preset.html)。
### `get-queue`
以下代码示例演示了如何使用 `get-queue`。
**AWS CLI**
**获取队列的详细信息**
以下 `get-queue` 示例检索指定自定义队列的详细信息。
```
aws mediaconvert get-queue \
--name Customer1 \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
输出：
```
{
"Queue": {
"LastUpdated": 1526428502,
"Type": "CUSTOM",
"SubmittedJobsCount": 0,
"Status": "ACTIVE",
"PricingPlan": "ON_DEMAND",
"CreatedAt": 1526428502,
"ProgressingJobsCount": 0,
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Customer1",
"Name": "Customer1"
}
}
```
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 队列](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [GetQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-queue.html)。
### `list-job-templates`
以下代码示例演示了如何使用 `list-job-templates`。
**AWS CLI**
**示例 1：列出您的自定义作业模板**
以下 `list-job-templates` 示例列出当前区域中的所有自定义作业模板。要列出系统作业模板，请参阅下一个示例。
```
aws mediaconvert list-job-templates \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
输出：
```
{
"JobTemplates": [
{
"Description": "Create a DASH streaming ABR stack",
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/DASH Streaming",
"Name": "DASH Streaming",
"LastUpdated": 1568653007,
"Priority": 0,
"Settings": {
......
},
"Type": "CUSTOM",
"StatusUpdateInterval": "SECONDS_60",
"CreatedAt": 1568653007
},
{
"Description": "Create a high-res file",
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/File",
"Name": "File",
"LastUpdated": 1568653007,
"Priority": 0,
"Settings": {
......
},
"Type": "CUSTOM",
"StatusUpdateInterval": "SECONDS_60",
"CreatedAt": 1568653023
}
]
}
```
**示例 2：列出 MediaConvert 系统作业模板**
以下 `list-job-templates` 示例列出所有系统作业模板。
```
aws mediaconvert list-job-templates \
--endpoint-url https://abcd1234.mediaconvert.us-east-1.amazonaws.com \
--list-by SYSTEM
```
输出：
```
{
"JobTemplates": [
{
"CreatedAt": 1568321779,
"Arn": "arn:aws:mediaconvert:us-east-1:123456789012:jobTemplates/System-Generic_Mp4_Hev1_Avc_Aac_Sdr_Qvbr",
"Name": "System-Generic_Mp4_Hev1_Avc_Aac_Sdr_Qvbr",
"Description": "GENERIC, MP4, AVC + HEV1(HEVC,SDR), AAC, SDR, QVBR",
"Category": "GENERIC",
"Settings": {
"AdAvailOffset": 0,
"OutputGroups": [
{
"Outputs": [
{
"Extension": "mp4",
"Preset": "System-Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1280x720p_30Hz_5Mbps_Qvbr_Vq9",
"NameModifier": "_Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1280x720p_30Hz_5000Kbps_Qvbr_Vq9"
},
{
"Extension": "mp4",
"Preset": "System-Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1920x1080p_30Hz_10Mbps_Qvbr_Vq9",
"NameModifier": "_Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1920x1080p_30Hz_10000Kbps_Qvbr_Vq9"
},
{
"Extension": "mp4",
"Preset": "System-Generic_Sd_Mp4_Avc_Aac_16x9_Sdr_640x360p_30Hz_0.8Mbps_Qvbr_Vq7",
"NameModifier": "_Generic_Sd_Mp4_Avc_Aac_16x9_Sdr_640x360p_30Hz_800Kbps_Qvbr_Vq7"
},
{
"Extension": "mp4",
"Preset": "System-Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1280x720p_30Hz_4Mbps_Qvbr_Vq9",
"NameModifier": "_Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1280x720p_30Hz_4000Kbps_Qvbr_Vq9"
},
{
"Extension": "mp4",
"Preset": "System-Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1920x1080p_30Hz_8Mbps_Qvbr_Vq9",
"NameModifier": "_Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1920x1080p_30Hz_8000Kbps_Qvbr_Vq9"
},
{
"Extension": "mp4",
"Preset": "System-Generic_Uhd_Mp4_Hev1_Aac_16x9_Sdr_3840x2160p_30Hz_12Mbps_Qvbr_Vq9",
"NameModifier": "_Generic_Uhd_Mp4_Hev1_Aac_16x9_Sdr_3840x2160p_30Hz_12000Kbps_Qvbr_Vq9"
}
],
"OutputGroupSettings": {
"FileGroupSettings": {
},
"Type": "FILE_GROUP_SETTINGS"
},
"Name": "File Group"
}
]
},
"Type": "SYSTEM",
"LastUpdated": 1568321779
},
......
]
}
```
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 作业模板](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)。
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [ListJobTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-job-templates.html)。
### `list-jobs`
以下代码示例演示了如何使用 `list-jobs`。
**AWS CLI**
**获取某个区域中所有作业的详细信息**
以下示例请求您在指定区域所有作业的信息。
```
aws mediaconvert list-jobs \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1
```
要获取账户特定的端点，请使用 `describe-endpoints`，或发送不带端点的命令。该服务会返回错误和您的端点。
有关更多信息，请参阅《AWS Elemental MediaConvert 用户指南》**中的[使用 AWS Elemental MediaConvert 作业](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)。
+ 有关 API 的详细信息，请参阅《AWS CLI 命令参考》**中的 [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-jobs.html)。
### `list-presets`
以下代码示例演示了如何使用 `list-presets`。
**AWS CLI**
**示例 1：列出您的自定义输出预设**
以下 `list-presets` 示例列出您的自定义输出预设。要列出系统预设，请参阅下一个示例。
```
aws mediaconvert list-presets \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
输出：
```
{
"Presets": [
{
"Name": "SimpleMP4",
"CreatedAt": 1568841521,
"Settings": {
......
},
"Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleMP4",
"Type": "CUSTOM",
"LastUpdated": 1568843141,
"Description": "Creates basic MP4 file. No filtering or preproccessing."
},
{
"Name": "SimpleTS",
"CreatedAt": 1568843113,
"Settings": {
... truncated for brevity ...
},
"Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleTS",
"Type": "CUSTOM",
"LastUpdated": 1568843113,
"Description": "Create a basic transport stream."
}
]
}
```
**示例 2：列出系统输出预设**
以下 `list-presets` 示例列出可用的 MediaConvert 系统预设。要列出您的自定义预设，请参阅前面的示例。
```
aws mediaconvert list-presets \
--list-by SYSTEM \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
输出：
```
{
"Presets": [
{
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/System-Avc_16x9_1080p_29_97fps_8500kbps",
"Name": "System-Avc_16x9_1080p_29_97fps_8500kbps",
"CreatedAt": 1568321789,
"Description": "Wifi, 1920x1080, 16:9, 29.97fps, 8500kbps",
"LastUpdated": 1568321789,
"Type": "SYSTEM",
"Category": "HLS",
"Settings": {
...