すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo Media Processing:MPS キューの管理

最終更新日:Jan 12, 2025

ApsaraVideo Media Processing(MPS)キューは、ジョブを処理するためのキューです。非同期ジョブを送信すると、ジョブの優先順位とジョブが送信された順序に基づいて、ジョブは実行待ちのキューに入れられます。 このトピックでは、Python 用 MPS SDK V2.0 にカプセル化されている API オペレーションを使用して、MPS キューの作成、更新、削除、照会などの MPS キューを管理する方法の例を示します。

特定の状態の MPS キューを照会する

SearchPipeline オペレーションを呼び出して、特定の状態の MPS キューを照会できます。

import os
import sys

from typing import List

from alibabacloud_mts20140618.client import Client as Mts20140618Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_mts20140618 import models as mts_20140618_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient


class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client() -> Mts20140618Client:
        """
        AccessKey ID と AccessKey シークレットを使用してクライアントを初期化します。
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            # 必須。 ALIBABA_CLOUD_ACCESS_KEY_ID 環境変数が設定されていることを確認してください。
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # 必須。 ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
            access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
        )
        config.endpoint = f'mts.cn-hangzhou.aliyuncs.com'
        return Mts20140618Client(config)

    @staticmethod
    def main(
        args: List[str],
    ) -> None:
        client = Sample.create_client()
        search_pipeline_request = mts_20140618_models.SearchPipelineRequest(
            # 照会する MPS キューのステータス。
            state='Paused',
            # 1 ページあたりのエントリ数。
            page_size=10,
            # ページ番号。
            page_number=1
        )
        runtime = util_models.RuntimeOptions()
        try:
            # サンプルコードをコピーして実行する場合は、API オペレーションのレスポンスを表示するための独自のコードを記述してください。
            client.search_pipeline_with_options(search_pipeline_request, runtime)
        except Exception as error:
            # 実際のビジネスシナリオに基づいて例外を慎重に処理し、プロジェクトで例外を無視しないでください。 この例に表示されているエラーメッセージは参照用です。
            # エラーメッセージを表示します。
            print(error.message)
            # トラブルシューティング用の URL を提供します。
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)

    @staticmethod
    async def main_async(
        args: List[str],
    ) -> None:
        client = Sample.create_client()
        search_pipeline_request = mts_20140618_models.SearchPipelineRequest(
            # 照会する MPS キューのステータス。
            state='Paused',
            # 1 ページあたりのエントリ数。
            page_size=10,
            # ページ番号。
            page_number=1
        )
        runtime = util_models.RuntimeOptions()
        try:
            # サンプルコードをコピーして実行する場合は、API オペレーションのレスポンスを表示するための独自のコードを記述してください。
            await client.search_pipeline_with_options_async(search_pipeline_request, runtime)
        except Exception as error:
            # 実際のビジネスシナリオに基づいて例外を慎重に処理し、プロジェクトで例外を無視しないでください。 この例に表示されているエラーメッセージは参照用です。
            # エラーメッセージを表示します。
            print(error.message)
            # トラブルシューティング用の URL を提供します。
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)


if __name__ == '__main__':
    Sample.main(sys.argv[1:])

キュー ID に基づいて MPS キューを照会する

QueryPipelineList オペレーションを呼び出して、MPS キュー ID に基づいて 1 つ以上の MPS キューを照会できます。

import os
import sys

from typing import List

from alibabacloud_mts20140618.client import Client as Mts20140618Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_mts20140618 import models as mts_20140618_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient


class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client() -> Mts20140618Client:
        """
        AccessKey ID と AccessKey シークレットを使用してクライアントを初期化します。
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            # 必須。 ALIBABA_CLOUD_ACCESS_KEY_ID 環境変数が設定されていることを確認してください。
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # 必須。 ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
            access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
        )
        config.endpoint = f'mts.cn-hangzhou.aliyuncs.com'
        return Mts20140618Client(config)

    @staticmethod
    def main(
        args: List[str],
    ) -> None:
        client = Sample.create_client()
        query_pipeline_list_request = mts_20140618_models.QueryPipelineListRequest(
            # 照会する MPS キューの ID。
            pipeline_ids='d1ce4d3efcb549419193f50f1fcd****,72dfa5e679ab4be9a3ed9974c736****'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # サンプルコードをコピーして実行する場合は、API オペレーションのレスポンスを表示するための独自のコードを記述してください。
            client.query_pipeline_list_with_options(query_pipeline_list_request, runtime)
        except Exception as error:
            # 実際のビジネスシナリオに基づいて例外を慎重に処理し、プロジェクトで例外を無視しないでください。 この例に表示されているエラーメッセージは参照用です。
            # エラーメッセージを表示します。
            print(error.message)
            # トラブルシューティング用の URL を提供します。
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)

    @staticmethod
    async def main_async(
        args: List[str],
    ) -> None:
        client = Sample.create_client()
        query_pipeline_list_request = mts_20140618_models.QueryPipelineListRequest(
            # 照会する MPS キューの ID。
            pipeline_ids='d1ce4d3efcb549419193f50f1fcd****,72dfa5e679ab4be9a3ed9974c736****'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # サンプルコードをコピーして実行する場合は、API オペレーションのレスポンスを表示するための独自のコードを記述してください。
            await client.query_pipeline_list_with_options_async(query_pipeline_list_request, runtime)
        except Exception as error:
            # 実際のビジネスシナリオに基づいて例外を慎重に処理し、プロジェクトで例外を無視しないでください。 この例に表示されているエラーメッセージは参照用です。
            # エラーメッセージを表示します。
            print(error.message)
            # トラブルシューティング用の URL を提供します。
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)


if __name__ == '__main__':
    Sample.main(sys.argv[1:])

MPS キューを更新する

UpdatePipeline オペレーションを呼び出して、MPS キューの名前やステータスなどの MPS キューを更新できます。 MPS キューのステータスには、アクティブと一時停止が含まれます。

import os
import sys

from typing import List

from alibabacloud_mts20140618.client import Client as Mts20140618Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_mts20140618 import models as mts_20140618_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient


class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client() -> Mts20140618Client:
        """
        AccessKey ID と AccessKey シークレットを使用してクライアントを初期化します。
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            # 必須。 ALIBABA_CLOUD_ACCESS_KEY_ID 環境変数が設定されていることを確認してください。
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # 必須。 ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
            access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
        )
        config.endpoint = f'mts.cn-hangzhou.aliyuncs.com'
        return Mts20140618Client(config)

    @staticmethod
    def main(
        args: List[str],
    ) -> None:
        client = Sample.create_client()
        update_pipeline_request = mts_20140618_models.UpdatePipelineRequest(
            # 更新する MPS キューの ID。
            pipeline_id='d1ce4d3efcb549419193f50f1fcd****',
            # MPS キューの新しい名前。
            name='example-pipeline-****',
            # MPS キューの新しいステータス。
            state='Paused',
            # Simple Message Queue(SMQ、旧称 MNS)の設定。
            notify_config='{"Topic":"example-topic-****"}',
            # 現在の Resource Access Management(RAM)ユーザーに割り当てられているロール。
            role='AliyunMTSDefaultRole'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # サンプルコードをコピーして実行する場合は、API オペレーションのレスポンスを表示するための独自のコードを記述してください。
            client.update_pipeline_with_options(update_pipeline_request, runtime)
        except Exception as error:
            # 実際のビジネスシナリオに基づいて例外を慎重に処理し、プロジェクトで例外を無視しないでください。 この例に表示されているエラーメッセージは参照用です。
            # エラーメッセージを表示します。
            print(error.message)
            # トラブルシューティング用の URL を提供します。
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)

    @staticmethod
    async def main_async(
        args: List[str],
    ) -> None:
        client = Sample.create_client()
        update_pipeline_request = mts_20140618_models.UpdatePipelineRequest(
            pipeline_id='d1ce4d3efcb549419193f50f1fcd****',
            name='example-pipeline-****',
            state='Paused',
            notify_config='{"Topic":"example-topic-****"}',
            role='AliyunMTSDefaultRole'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # サンプルコードをコピーして実行する場合は、API オペレーションのレスポンスを表示するための独自のコードを記述してください。
            await client.update_pipeline_with_options_async(update_pipeline_request, runtime)
        except Exception as error:
            # 実際のビジネスシナリオに基づいて例外を慎重に処理し、プロジェクトで例外を無視しないでください。 この例に表示されているエラーメッセージは参照用です。
            # エラーメッセージを表示します。
            print(error.message)
            # トラブルシューティング用の URL を提供します。
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)


if __name__ == '__main__':
    Sample.main(sys.argv[1:])

参照