本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 的 MediaConvert 範例 AWS CLI 下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 MediaConvert 來執行動作和實作常見案例。 *Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。 每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。 **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 使用者指南》中的使用 Elemental MediaConvert 任務](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)。 *AWS MediaConvert * + 如需 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` 物件，但需保留在其中的設定子物件。此外，請務必移除下列鍵值對：`LastUpdated`、`Arn`、`Type` 和 `CreatedAt`。您可以在 JSON 檔案或命令列中，指定類別、描述、名稱和佇列。 若要取得您的特定帳戶端點，請使用 `describe-endpoints`，或傳送不含端點的命令。服務會傳回錯誤和您的端點。 如果請求成功，服務會針對您建立的任務範本傳回 JSON 規格。 如需詳細資訊，請參閱《[AWS Elemental MediaConvert 使用者指南》中的使用 Elemental MediaConvert 任務範本](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)。 *AWS MediaConvert * + 如需 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 使用者指南》中的使用 Elemental MediaConvert 任務](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)。 *AWS MediaConvert * + 如需 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 使用者指南》中的使用 Elemental MediaConvert 輸出預設](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html)集。 *AWS MediaConvert * + 如需 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 使用者指南》中的使用 Elemental MediaConvert 佇列](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)。 *AWS MediaConvert * + 如需 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 使用者指南》中的使用 Elemental MediaConvert 任務範本](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)。 *AWS MediaConvert * + 如需 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 使用者指南》中的使用 Elemental MediaConvert 輸出預設](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html)集。 *AWS MediaConvert * + 如需 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 使用者指南》中的使用 Elemental MediaConvert 佇列](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)。 *AWS MediaConvert * + 如需 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 使用者指南》中的使用 Elemental MediaConvert 任務範本](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)。 *AWS MediaConvert * + 如需 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 使用者指南》中的使用 Elemental MediaConvert 任務](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)。 *AWS MediaConvert * + 如需 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 使用者指南》中的使用 Elemental MediaConvert 輸出預設](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html)集。 *AWS MediaConvert * + 如需 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 使用者指南中的使用 Elemental MediaConvert 佇列](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)。 *AWS MediaConvert * + 如需 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 使用者指南》中的使用 Elemental MediaConvert 任務範本](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)。 *AWS MediaConvert * + 如需 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 使用者指南》中的使用 Elemental MediaConvert 任務](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)。 *AWS MediaConvert * + 如需 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": { ...... } }, ...... { "Arn": "arn:aws:mediaconvert:us-east-1:123456789012:presets/System-Xdcam_HD_1080i_29_97fps_35mpbs", "Name": "System-Xdcam_HD_1080i_29_97fps_35mpbs", "CreatedAt": 1568321790, "Description": "XDCAM MPEG HD, 1920x1080i, 29.97fps, 35mbps", "LastUpdated": 1568321790, "Type": "SYSTEM", "Category": "MXF", "Settings": { ...... } } ] } ``` 如需詳細資訊，請參閱《[AWS Elemental MediaConvert 使用者指南》中的使用 Elemental MediaConvert 輸出預設](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html)集。 *AWS MediaConvert * + 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListPresets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-presets.html)。 ### `list-queues` 以下程式碼範例顯示如何使用 `list-queues`。 **AWS CLI** **列出佇列** 下列 `list-queues` 範例列出所有 MediaConvert 佇列。 ``` aws mediaconvert list-queues \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` 輸出： ``` { "Queues": [ { "PricingPlan": "ON_DEMAND", "Type": "SYSTEM", "Status": "ACTIVE", "CreatedAt": 1503451595, "Name": "Default", "SubmittedJobsCount": 0, "ProgressingJobsCount": 0, "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Default", "LastUpdated": 1534549158 }, { "PricingPlan": "ON_DEMAND", "Type": "CUSTOM", "Status": "ACTIVE", "CreatedAt": 1537460025, "Name": "Customer1", "SubmittedJobsCount": 0, "Description": "Jobs we run for our cusotmer.", "ProgressingJobsCount": 0, "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Customer1", "LastUpdated": 1537460025 }, { "ProgressingJobsCount": 0, "Status": "ACTIVE", "Name": "transcode-library", "SubmittedJobsCount": 0, "LastUpdated": 1564066204, "ReservationPlan": { "Status": "ACTIVE", "ReservedSlots": 1, "PurchasedAt": 1564066203, "Commitment": "ONE_YEAR", "ExpiresAt": 1595688603, "RenewalType": "EXPIRE" }, "PricingPlan": "RESERVED", "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/transcode-library", "Type": "CUSTOM", "CreatedAt": 1564066204 } ] } ``` 如需詳細資訊，請參閱 [AWS Elemental MediaConvert 使用者指南中的使用 Elemental MediaConvert 佇列](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)。 *AWS MediaConvert * + 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-queues.html)。 ### `list-tags-for-resource` 以下程式碼範例顯示如何使用 `list-tags-for-resource`。 **AWS CLI** **列出 MediaConvert 佇列、任務範本或輸出預設集上的標籤** 下列 `list-tags-for-resource` 範例列出指定輸出預設集上的標籤。 ``` aws mediaconvert list-tags-for-resource \ --arn arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4 \ --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` 輸出： ``` { "ResourceTags": { "Tags": { "customer": "zippyVideo" }, "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4" } } ``` 如需詳細資訊，請參閱《[AWS Elemental MediaConvert 使用者指南》中的標記 Elemental MediaConvert 佇列、任務範本和輸出預設集](https://docs.aws.amazon.com/mediaconvert/latest/ug/tagging-queues-templates-presets.html)。 *AWS MediaConvert * + 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-tags-for-resource.html)。 ### `update-job-template` 以下程式碼範例顯示如何使用 `update-job-template`。 **AWS CLI** **變更任務範本** 下列 `update-job-template` 範例會將指定自訂任務範本的 JSON 定義，取代為所提供檔案中的 JSON 定義。 aws mediaconvert update-job-template --name File1 --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com --cli-input-json file://\$1/job-template-update.json `job-template-update.json` 的內容： ``` { "Description": "A simple job template that generates a single file output.", "Queue": "arn:aws:mediaconvert:us-east-1:012345678998:queues/Default", "Name": "SimpleFile", "Settings": { "OutputGroups": [ { "Name": "File Group", "Outputs": [ { "ContainerSettings": { "Container": "MP4", "Mp4Settings": { "CslgAtom": "INCLUDE", "FreeSpaceBox": "EXCLUDE", "MoovPlacement": "PROGRESSIVE_DOWNLOAD" } }, "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": 400000, "FramerateControl": "INITIALIZE_FROM_SOURCE", "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": "INITIALIZE_FROM_SOURCE", "NumberBFramesBetweenReferenceFrames": 2, "RepeatPps": "DISABLED", "DynamicSubGop": "STATIC" } }, "AfdSignaling": "NONE", "DropFrameTimecode": "ENABLED", "RespondToAfd": "NONE", "ColorMetadata": "INSERT" }, "AudioDescriptions": [ { "AudioTypeControl": "FOLLOW_INPUT", "CodecSettings": { "Codec": "AAC", "AacSettings": { "AudioDescriptionBroadcasterMix": "NORMAL", "Bitrate": 96000, "RateControlMode": "CBR", "CodecProfile": "LC", "CodingMode": "CODING_MODE_2_0", "RawFormat": "NONE", "SampleRate": 48000, "Specification": "MPEG4" } }, "LanguageCodeControl": "FOLLOW_INPUT" } ] } ], "OutputGroupSettings": { "Type": "FILE_GROUP_SETTINGS", "FileGroupSettings": {} } } ], "AdAvailOffset": 0 }, "StatusUpdateInterval": "SECONDS_60", "Priority": 0 } ``` 即使請求導致錯誤，系統仍會傳回您隨請求一起傳送的 JSON 承載。因此，傳回的 JSON 不一定是新的任務範本定義。 由於 JSON 承載可能很長，您可能需要向上捲動才能查看任何錯誤訊息。 如需詳細資訊，請參閱《[AWS Elemental MediaConvert 使用者指南》中的使用 Elemental MediaConvert 任務範本](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)。 *AWS MediaConvert * + 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-job-template.html)。 ### `update-preset` 以下程式碼範例顯示如何使用 `update-preset`。 **AWS CLI** **變更預設集** 下列 `update-preset` 範例會取代指定預設集的描述。 ``` aws mediaconvert update-preset \ --name Customer1 \ --description "New description text." --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` 此命令不會產生輸出。輸出： ``` { "Preset": { "Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleMP4", "Settings": { ...... }, "Type": "CUSTOM", "LastUpdated": 1568938411, "Description": "New description text.", "Name": "SimpleMP4", "CreatedAt": 1568938240 } } ``` 如需詳細資訊，請參閱《[AWS Elemental MediaConvert 使用者指南》中的使用 Elemental MediaConvert 輸出預設](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html)集。 *AWS MediaConvert * + 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdatePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-preset.html)。 ### `update-queue` 以下程式碼範例顯示如何使用 `update-queue`。 **AWS CLI** **變更佇列** 下列 `update-queue` 範例會將其狀態變更為 `PAUSED`，以暫停指定的佇列。 ``` aws mediaconvert update-queue \ --name Customer1 \ --status PAUSED --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com ``` 輸出： ``` { "Queue": { "LastUpdated": 1568839845, "Status": "PAUSED", "ProgressingJobsCount": 0, "CreatedAt": 1526428516, "Arn": "arn:aws:mediaconvert:us-west-1:123456789012:queues/Customer1", "Name": "Customer1", "SubmittedJobsCount": 0, "PricingPlan": "ON_DEMAND", "Type": "CUSTOM" } } ``` 如需詳細資訊，請參閱《[AWS Elemental MediaConvert 使用者指南》中的使用 Elemental MediaConvert 佇列](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)。 *AWS MediaConvert * + 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/update-queue.html)。