MediaConvertClient#
Index > MediaConvert > MediaConvertClient
Auto-generated documentation for MediaConvert type annotations stubs module types-boto3-mediaconvert.
MediaConvertClient#
Type annotations and code completion for boto3.client("mediaconvert").
boto3 documentation
# MediaConvertClient usage example
from boto3.session import Session
from types_boto3_mediaconvert.client import MediaConvertClient
def get_mediaconvert_client() -> MediaConvertClient:
return Session().client("mediaconvert")
Exceptions#
boto3 client exceptions are generated in runtime.
This class provides code completion for boto3.client("mediaconvert").exceptions structure.
# Exceptions.exceptions usage example
client = boto3.client("mediaconvert")
try:
do_something(client)
except (
client.exceptions.BadRequestException,
client.exceptions.ClientError,
client.exceptions.ConflictException,
client.exceptions.ForbiddenException,
client.exceptions.InternalServerErrorException,
client.exceptions.NotFoundException,
client.exceptions.ServiceQuotaExceededException,
client.exceptions.TooManyRequestsException,
) as e:
print(e)
# Exceptions.exceptions type checking example
from types_boto3_mediaconvert.client import Exceptions
def handle_error(exc: Exceptions.BadRequestException) -> None:
...
Methods#
can_paginate#
Type annotations and code completion for boto3.client("mediaconvert").can_paginate method.
boto3 documentation
# can_paginate method definition
def can_paginate(
self,
operation_name: str,
) -> bool:
...
generate_presigned_url#
Type annotations and code completion for boto3.client("mediaconvert").generate_presigned_url method.
boto3 documentation
# generate_presigned_url method definition
def generate_presigned_url(
self,
ClientMethod: str,
Params: Mapping[str, Any] = ...,
ExpiresIn: int = 3600,
HttpMethod: str = ...,
) -> str:
...
associate_certificate#
Associates an AWS Certificate Manager (ACM) Amazon Resource Name (ARN) with AWS Elemental MediaConvert.
Type annotations and code completion for boto3.client("mediaconvert").associate_certificate method.
boto3 documentation
# associate_certificate method definition
def associate_certificate(
self,
*,
Arn: str,
) -> Dict[str, Any]:
...
# associate_certificate method usage example with argument unpacking
kwargs: AssociateCertificateRequestTypeDef = { # (1)
"Arn": ...,
}
parent.associate_certificate(**kwargs)
cancel_job#
Permanently cancel a job.
Type annotations and code completion for boto3.client("mediaconvert").cancel_job method.
boto3 documentation
# cancel_job method definition
def cancel_job(
self,
*,
Id: str,
) -> Dict[str, Any]:
...
# cancel_job method usage example with argument unpacking
kwargs: CancelJobRequestTypeDef = { # (1)
"Id": ...,
}
parent.cancel_job(**kwargs)
create_job#
Create a new transcoding job.
Type annotations and code completion for boto3.client("mediaconvert").create_job method.
boto3 documentation
# create_job method definition
def create_job(
self,
*,
Role: str,
Settings: JobSettingsUnionTypeDef, # (1)
AccelerationSettings: AccelerationSettingsTypeDef = ..., # (2)
BillingTagsSource: BillingTagsSourceType = ..., # (3)
ClientRequestToken: str = ...,
HopDestinations: Sequence[HopDestinationTypeDef] = ..., # (4)
JobEngineVersion: str = ...,
JobTemplate: str = ...,
Priority: int = ...,
Queue: str = ...,
SimulateReservedQueue: SimulateReservedQueueType = ..., # (5)
StatusUpdateInterval: StatusUpdateIntervalType = ..., # (6)
Tags: Mapping[str, str] = ...,
UserMetadata: Mapping[str, str] = ...,
) -> CreateJobResponseTypeDef: # (7)
...
- See JobSettingsUnionTypeDef
- See AccelerationSettingsTypeDef
- See BillingTagsSourceType
- See
Sequence[HopDestinationTypeDef] - See SimulateReservedQueueType
- See StatusUpdateIntervalType
- See CreateJobResponseTypeDef
# create_job method usage example with argument unpacking
kwargs: CreateJobRequestTypeDef = { # (1)
"Role": ...,
"Settings": ...,
}
parent.create_job(**kwargs)
create_job_template#
Create a new job template.
Type annotations and code completion for boto3.client("mediaconvert").create_job_template method.
boto3 documentation
# create_job_template method definition
def create_job_template(
self,
*,
Name: str,
Settings: JobTemplateSettingsUnionTypeDef, # (1)
AccelerationSettings: AccelerationSettingsTypeDef = ..., # (2)
Category: str = ...,
Description: str = ...,
HopDestinations: Sequence[HopDestinationTypeDef] = ..., # (3)
Priority: int = ...,
Queue: str = ...,
StatusUpdateInterval: StatusUpdateIntervalType = ..., # (4)
Tags: Mapping[str, str] = ...,
) -> CreateJobTemplateResponseTypeDef: # (5)
...
- See JobTemplateSettingsUnionTypeDef
- See AccelerationSettingsTypeDef
- See
Sequence[HopDestinationTypeDef] - See StatusUpdateIntervalType
- See CreateJobTemplateResponseTypeDef
# create_job_template method usage example with argument unpacking
kwargs: CreateJobTemplateRequestTypeDef = { # (1)
"Name": ...,
"Settings": ...,
}
parent.create_job_template(**kwargs)
create_preset#
Create a new preset.
Type annotations and code completion for boto3.client("mediaconvert").create_preset method.
boto3 documentation
# create_preset method definition
def create_preset(
self,
*,
Name: str,
Settings: PresetSettingsUnionTypeDef, # (1)
Category: str = ...,
Description: str = ...,
Tags: Mapping[str, str] = ...,
) -> CreatePresetResponseTypeDef: # (2)
...
# create_preset method usage example with argument unpacking
kwargs: CreatePresetRequestTypeDef = { # (1)
"Name": ...,
"Settings": ...,
}
parent.create_preset(**kwargs)
create_queue#
Create a new transcoding queue.
Type annotations and code completion for boto3.client("mediaconvert").create_queue method.
boto3 documentation
# create_queue method definition
def create_queue(
self,
*,
Name: str,
ConcurrentJobs: int = ...,
Description: str = ...,
PricingPlan: PricingPlanType = ..., # (1)
ReservationPlanSettings: ReservationPlanSettingsTypeDef = ..., # (2)
Status: QueueStatusType = ..., # (3)
Tags: Mapping[str, str] = ...,
) -> CreateQueueResponseTypeDef: # (4)
...
- See PricingPlanType
- See ReservationPlanSettingsTypeDef
- See QueueStatusType
- See CreateQueueResponseTypeDef
# create_queue method usage example with argument unpacking
kwargs: CreateQueueRequestTypeDef = { # (1)
"Name": ...,
}
parent.create_queue(**kwargs)
create_resource_share#
Create a new resource share request for MediaConvert resources with AWS Support.
Type annotations and code completion for boto3.client("mediaconvert").create_resource_share method.
boto3 documentation
# create_resource_share method definition
def create_resource_share(
self,
*,
JobId: str,
SupportCaseId: str,
) -> Dict[str, Any]:
...
# create_resource_share method usage example with argument unpacking
kwargs: CreateResourceShareRequestTypeDef = { # (1)
"JobId": ...,
"SupportCaseId": ...,
}
parent.create_resource_share(**kwargs)
delete_job_template#
Permanently delete a job template you have created.
Type annotations and code completion for boto3.client("mediaconvert").delete_job_template method.
boto3 documentation
# delete_job_template method definition
def delete_job_template(
self,
*,
Name: str,
) -> Dict[str, Any]:
...
# delete_job_template method usage example with argument unpacking
kwargs: DeleteJobTemplateRequestTypeDef = { # (1)
"Name": ...,
}
parent.delete_job_template(**kwargs)
delete_policy#
Permanently delete a policy that you created.
Type annotations and code completion for boto3.client("mediaconvert").delete_policy method.
boto3 documentation
# delete_policy method definition
def delete_policy(
self,
) -> Dict[str, Any]:
...
delete_preset#
Permanently delete a preset you have created.
Type annotations and code completion for boto3.client("mediaconvert").delete_preset method.
boto3 documentation
# delete_preset method definition
def delete_preset(
self,
*,
Name: str,
) -> Dict[str, Any]:
...
# delete_preset method usage example with argument unpacking
kwargs: DeletePresetRequestTypeDef = { # (1)
"Name": ...,
}
parent.delete_preset(**kwargs)
delete_queue#
Permanently delete a queue you have created.
Type annotations and code completion for boto3.client("mediaconvert").delete_queue method.
boto3 documentation
# delete_queue method definition
def delete_queue(
self,
*,
Name: str,
) -> Dict[str, Any]:
...
# delete_queue method usage example with argument unpacking
kwargs: DeleteQueueRequestTypeDef = { # (1)
"Name": ...,
}
parent.delete_queue(**kwargs)
describe_endpoints#
Send a request with an empty body to the regional API endpoint to get your account API endpoint.
Type annotations and code completion for boto3.client("mediaconvert").describe_endpoints method.
boto3 documentation
# describe_endpoints method definition
def describe_endpoints(
self,
*,
MaxResults: int = ...,
Mode: DescribeEndpointsModeType = ..., # (1)
NextToken: str = ...,
) -> DescribeEndpointsResponseTypeDef: # (2)
...
# describe_endpoints method usage example with argument unpacking
kwargs: DescribeEndpointsRequestTypeDef = { # (1)
"MaxResults": ...,
}
parent.describe_endpoints(**kwargs)
disassociate_certificate#
Removes an association between the Amazon Resource Name (ARN) of an AWS Certificate Manager (ACM) certificate and an AWS Elemental MediaConvert resource.
Type annotations and code completion for boto3.client("mediaconvert").disassociate_certificate method.
boto3 documentation
# disassociate_certificate method definition
def disassociate_certificate(
self,
*,
Arn: str,
) -> Dict[str, Any]:
...
# disassociate_certificate method usage example with argument unpacking
kwargs: DisassociateCertificateRequestTypeDef = { # (1)
"Arn": ...,
}
parent.disassociate_certificate(**kwargs)
get_job#
Retrieve the JSON for a specific transcoding job.
Type annotations and code completion for boto3.client("mediaconvert").get_job method.
boto3 documentation
# get_job method definition
def get_job(
self,
*,
Id: str,
) -> GetJobResponseTypeDef: # (1)
...
# get_job method usage example with argument unpacking
kwargs: GetJobRequestTypeDef = { # (1)
"Id": ...,
}
parent.get_job(**kwargs)
get_job_template#
Retrieve the JSON for a specific job template.
Type annotations and code completion for boto3.client("mediaconvert").get_job_template method.
boto3 documentation
# get_job_template method definition
def get_job_template(
self,
*,
Name: str,
) -> GetJobTemplateResponseTypeDef: # (1)
...
# get_job_template method usage example with argument unpacking
kwargs: GetJobTemplateRequestTypeDef = { # (1)
"Name": ...,
}
parent.get_job_template(**kwargs)
get_jobs_query_results#
Retrieve a JSON array of up to twenty of your most recent jobs matched by a jobs query.
Type annotations and code completion for boto3.client("mediaconvert").get_jobs_query_results method.
boto3 documentation
# get_jobs_query_results method definition
def get_jobs_query_results(
self,
*,
Id: str,
) -> GetJobsQueryResultsResponseTypeDef: # (1)
...
# get_jobs_query_results method usage example with argument unpacking
kwargs: GetJobsQueryResultsRequestTypeDef = { # (1)
"Id": ...,
}
parent.get_jobs_query_results(**kwargs)
get_policy#
Retrieve the JSON for your policy.
Type annotations and code completion for boto3.client("mediaconvert").get_policy method.
boto3 documentation
# get_policy method definition
def get_policy(
self,
) -> GetPolicyResponseTypeDef: # (1)
...
get_preset#
Retrieve the JSON for a specific preset.
Type annotations and code completion for boto3.client("mediaconvert").get_preset method.
boto3 documentation
# get_preset method definition
def get_preset(
self,
*,
Name: str,
) -> GetPresetResponseTypeDef: # (1)
...
# get_preset method usage example with argument unpacking
kwargs: GetPresetRequestTypeDef = { # (1)
"Name": ...,
}
parent.get_preset(**kwargs)
get_queue#
Retrieve the JSON for a specific queue.
Type annotations and code completion for boto3.client("mediaconvert").get_queue method.
boto3 documentation
# get_queue method definition
def get_queue(
self,
*,
Name: str,
) -> GetQueueResponseTypeDef: # (1)
...
# get_queue method usage example with argument unpacking
kwargs: GetQueueRequestTypeDef = { # (1)
"Name": ...,
}
parent.get_queue(**kwargs)
list_job_templates#
Retrieve a JSON array of up to twenty of your job templates.
Type annotations and code completion for boto3.client("mediaconvert").list_job_templates method.
boto3 documentation
# list_job_templates method definition
def list_job_templates(
self,
*,
Category: str = ...,
ListBy: JobTemplateListByType = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
Order: OrderType = ..., # (2)
) -> ListJobTemplatesResponseTypeDef: # (3)
...
# list_job_templates method usage example with argument unpacking
kwargs: ListJobTemplatesRequestTypeDef = { # (1)
"Category": ...,
}
parent.list_job_templates(**kwargs)
list_jobs#
Retrieve a JSON array of up to twenty of your most recently created jobs.
Type annotations and code completion for boto3.client("mediaconvert").list_jobs method.
boto3 documentation
# list_jobs method definition
def list_jobs(
self,
*,
MaxResults: int = ...,
NextToken: str = ...,
Order: OrderType = ..., # (1)
Queue: str = ...,
Status: JobStatusType = ..., # (2)
) -> ListJobsResponseTypeDef: # (3)
...
- See OrderType
- See JobStatusType
- See ListJobsResponseTypeDef
# list_jobs method usage example with argument unpacking
kwargs: ListJobsRequestTypeDef = { # (1)
"MaxResults": ...,
}
parent.list_jobs(**kwargs)
list_presets#
Retrieve a JSON array of up to twenty of your presets.
Type annotations and code completion for boto3.client("mediaconvert").list_presets method.
boto3 documentation
# list_presets method definition
def list_presets(
self,
*,
Category: str = ...,
ListBy: PresetListByType = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
Order: OrderType = ..., # (2)
) -> ListPresetsResponseTypeDef: # (3)
...
- See PresetListByType
- See OrderType
- See ListPresetsResponseTypeDef
# list_presets method usage example with argument unpacking
kwargs: ListPresetsRequestTypeDef = { # (1)
"Category": ...,
}
parent.list_presets(**kwargs)
list_queues#
Retrieve a JSON array of up to twenty of your queues.
Type annotations and code completion for boto3.client("mediaconvert").list_queues method.
boto3 documentation
# list_queues method definition
def list_queues(
self,
*,
ListBy: QueueListByType = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
Order: OrderType = ..., # (2)
) -> ListQueuesResponseTypeDef: # (3)
...
- See QueueListByType
- See OrderType
- See ListQueuesResponseTypeDef
# list_queues method usage example with argument unpacking
kwargs: ListQueuesRequestTypeDef = { # (1)
"ListBy": ...,
}
parent.list_queues(**kwargs)
list_tags_for_resource#
Retrieve the tags for a MediaConvert resource.
Type annotations and code completion for boto3.client("mediaconvert").list_tags_for_resource method.
boto3 documentation
# list_tags_for_resource method definition
def list_tags_for_resource(
self,
*,
Arn: str,
) -> ListTagsForResourceResponseTypeDef: # (1)
...
# list_tags_for_resource method usage example with argument unpacking
kwargs: ListTagsForResourceRequestTypeDef = { # (1)
"Arn": ...,
}
parent.list_tags_for_resource(**kwargs)
list_versions#
Retrieve a JSON array of all available Job engine versions and the date they expire.
Type annotations and code completion for boto3.client("mediaconvert").list_versions method.
boto3 documentation
# list_versions method definition
def list_versions(
self,
*,
MaxResults: int = ...,
NextToken: str = ...,
) -> ListVersionsResponseTypeDef: # (1)
...
# list_versions method usage example with argument unpacking
kwargs: ListVersionsRequestTypeDef = { # (1)
"MaxResults": ...,
}
parent.list_versions(**kwargs)
probe#
Use Probe to obtain detailed information about your input media files.
Type annotations and code completion for boto3.client("mediaconvert").probe method.
boto3 documentation
# probe method definition
def probe(
self,
*,
InputFiles: Sequence[ProbeInputFileTypeDef] = ..., # (1)
) -> ProbeResponseTypeDef: # (2)
...
- See
Sequence[ProbeInputFileTypeDef] - See ProbeResponseTypeDef
# probe method usage example with argument unpacking
kwargs: ProbeRequestTypeDef = { # (1)
"InputFiles": ...,
}
parent.probe(**kwargs)
put_policy#
Create or change your policy.
Type annotations and code completion for boto3.client("mediaconvert").put_policy method.
boto3 documentation
# put_policy method definition
def put_policy(
self,
*,
Policy: PolicyTypeDef, # (1)
) -> PutPolicyResponseTypeDef: # (2)
...
# put_policy method usage example with argument unpacking
kwargs: PutPolicyRequestTypeDef = { # (1)
"Policy": ...,
}
parent.put_policy(**kwargs)
search_jobs#
Retrieve a JSON array that includes job details for up to twenty of your most recent jobs.
Type annotations and code completion for boto3.client("mediaconvert").search_jobs method.
boto3 documentation
# search_jobs method definition
def search_jobs(
self,
*,
InputFile: str = ...,
MaxResults: int = ...,
NextToken: str = ...,
Order: OrderType = ..., # (1)
Queue: str = ...,
Status: JobStatusType = ..., # (2)
) -> SearchJobsResponseTypeDef: # (3)
...
- See OrderType
- See JobStatusType
- See SearchJobsResponseTypeDef
# search_jobs method usage example with argument unpacking
kwargs: SearchJobsRequestTypeDef = { # (1)
"InputFile": ...,
}
parent.search_jobs(**kwargs)
start_jobs_query#
Start an asynchronous jobs query using the provided filters.
Type annotations and code completion for boto3.client("mediaconvert").start_jobs_query method.
boto3 documentation
# start_jobs_query method definition
def start_jobs_query(
self,
*,
FilterList: Sequence[JobsQueryFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
Order: OrderType = ..., # (2)
) -> StartJobsQueryResponseTypeDef: # (3)
...
- See
Sequence[JobsQueryFilterTypeDef] - See OrderType
- See StartJobsQueryResponseTypeDef
# start_jobs_query method usage example with argument unpacking
kwargs: StartJobsQueryRequestTypeDef = { # (1)
"FilterList": ...,
}
parent.start_jobs_query(**kwargs)
tag_resource#
Add tags to a MediaConvert queue, preset, or job template.
Type annotations and code completion for boto3.client("mediaconvert").tag_resource method.
boto3 documentation
# tag_resource method definition
def tag_resource(
self,
*,
Arn: str,
Tags: Mapping[str, str],
) -> Dict[str, Any]:
...
# tag_resource method usage example with argument unpacking
kwargs: TagResourceRequestTypeDef = { # (1)
"Arn": ...,
"Tags": ...,
}
parent.tag_resource(**kwargs)
untag_resource#
Remove tags from a MediaConvert queue, preset, or job template.
Type annotations and code completion for boto3.client("mediaconvert").untag_resource method.
boto3 documentation
# untag_resource method definition
def untag_resource(
self,
*,
Arn: str,
TagKeys: Sequence[str] = ...,
) -> Dict[str, Any]:
...
# untag_resource method usage example with argument unpacking
kwargs: UntagResourceRequestTypeDef = { # (1)
"Arn": ...,
}
parent.untag_resource(**kwargs)
update_job_template#
Modify one of your existing job templates.
Type annotations and code completion for boto3.client("mediaconvert").update_job_template method.
boto3 documentation
# update_job_template method definition
def update_job_template(
self,
*,
Name: str,
AccelerationSettings: AccelerationSettingsTypeDef = ..., # (1)
Category: str = ...,
Description: str = ...,
HopDestinations: Sequence[HopDestinationTypeDef] = ..., # (2)
Priority: int = ...,
Queue: str = ...,
Settings: JobTemplateSettingsUnionTypeDef = ..., # (3)
StatusUpdateInterval: StatusUpdateIntervalType = ..., # (4)
) -> UpdateJobTemplateResponseTypeDef: # (5)
...
- See AccelerationSettingsTypeDef
- See
Sequence[HopDestinationTypeDef] - See JobTemplateSettingsUnionTypeDef
- See StatusUpdateIntervalType
- See UpdateJobTemplateResponseTypeDef
# update_job_template method usage example with argument unpacking
kwargs: UpdateJobTemplateRequestTypeDef = { # (1)
"Name": ...,
}
parent.update_job_template(**kwargs)
update_preset#
Modify one of your existing presets.
Type annotations and code completion for boto3.client("mediaconvert").update_preset method.
boto3 documentation
# update_preset method definition
def update_preset(
self,
*,
Name: str,
Category: str = ...,
Description: str = ...,
Settings: PresetSettingsUnionTypeDef = ..., # (1)
) -> UpdatePresetResponseTypeDef: # (2)
...
# update_preset method usage example with argument unpacking
kwargs: UpdatePresetRequestTypeDef = { # (1)
"Name": ...,
}
parent.update_preset(**kwargs)
update_queue#
Modify one of your existing queues.
Type annotations and code completion for boto3.client("mediaconvert").update_queue method.
boto3 documentation
# update_queue method definition
def update_queue(
self,
*,
Name: str,
ConcurrentJobs: int = ...,
Description: str = ...,
ReservationPlanSettings: ReservationPlanSettingsTypeDef = ..., # (1)
Status: QueueStatusType = ..., # (2)
) -> UpdateQueueResponseTypeDef: # (3)
...
# update_queue method usage example with argument unpacking
kwargs: UpdateQueueRequestTypeDef = { # (1)
"Name": ...,
}
parent.update_queue(**kwargs)
get_paginator#
Type annotations and code completion for boto3.client("mediaconvert").get_paginator method with overloads.
client.get_paginator("describe_endpoints")-> DescribeEndpointsPaginatorclient.get_paginator("list_job_templates")-> ListJobTemplatesPaginatorclient.get_paginator("list_jobs")-> ListJobsPaginatorclient.get_paginator("list_presets")-> ListPresetsPaginatorclient.get_paginator("list_queues")-> ListQueuesPaginatorclient.get_paginator("list_versions")-> ListVersionsPaginatorclient.get_paginator("search_jobs")-> SearchJobsPaginator