QueryAnalysisJobList - - Centre de documentation Alibaba Cloud

Remarques sur l'utilisation

Cette opération permet d'interroger jusqu'à 10 jobs d'analyse de modèle simultanément.

Limite QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde par compte. Si le nombre d'appels par seconde dépasse la limite, un mécanisme de limitation du débit (throttling) se déclenche, ce qui peut affecter votre activité. Nous vous recommandons de prendre en compte cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la section Limite QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter

Type

Required

Example

Description

Action

String

Yes

QueryAnalysisJobList

L'opération à effectuer. Définissez la valeur sur QueryAnalysisJobList.

AnalysisJobIds

String

Yes

bb558c1cc25b45309aab5be44d19****

Les ID des jobs d'analyse de modèle.

Vous pouvez interroger jusqu'à 10 jobs à la fois.
Séparez les différents ID par des virgules (,).

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	5CA6E020-4102-4FFF-AA56-5ED7ECD811A1	L'ID de la requête.
AnalysisJobList	Array of AnalysisJob		Les ID des jobs d'analyse de modèle.
AnalysisJob
CreationTime	String	2014-01-10T12:00:00Z	L'heure de création du job.
Percent	Long	86	La progression du transcodage.
State	String	Success	Le statut du job. Valeurs possibles : Submitted : Le job a été soumis. Analyzing : Le job est en cours d'exécution. Success : Le job a réussi. Fail : Le job a échoué.
AnalysisConfig	Object		La configuration du job.
QualityControl	Object		Le contrôle qualité appliqué à la sortie du job.
MethodStreaming	String	network	Le mode de lecture. Valeurs possibles : network : lecture en ligne local : lecture sur des appareils locaux Valeur par défaut : network.
RateQuality	String	25	Le niveau de qualité de la sortie du job. Valeur par défaut : 25.
PropertiesControl	Object		Le contrôle des attributs de la sortie du job.
Deinterlace	String	Auto	Indique si le désentrelacement a été forcé. Valeurs possibles : Auto : Le désentrelacement a été exécuté automatiquement. Force : Le désentrelacement a été forcé. None : Le désentrelacement a été explicitement désactivé.
Crop	Object		La configuration du recadrage des images vidéo.
Top	String	8	La marge supérieure recadrée. Remarque Ce paramètre n'est pas valide si le paramètre Mode est défini sur Auto ou None.
Width	String	8	La largeur de la vidéo après le recadrage des marges. Remarque Ce paramètre n'est pas valide si le paramètre Mode est défini sur Auto ou None.
Height	String	8	La hauteur de la vidéo après le recadrage des marges. Remarque Ce paramètre n'est pas valide si le paramètre Mode est défini sur Auto ou None.
Left	String	8	La marge gauche recadrée. Remarque Ce paramètre n'est pas valide si le paramètre Mode est défini sur Auto ou None.
Mode	String	Auto	Le mode de recadrage. Valeurs possibles : Auto : Le recadrage a été exécuté automatiquement. Force : Le recadrage a été forcé. None : Le recadrage a été explicitement désactivé. Ce paramètre est requis si la valeur du paramètre Crop n'est pas un objet JSON vide.
Message	String	The resource operated \"PipelineId\" cannot be found	Le message d'erreur renvoyé en cas d'échec du job.
Priority	String	8	La priorité du job dans la file d'attente MPS à laquelle il est ajouté. Valeurs possibles : 1 à 10. Une valeur de 10 indique la priorité la plus élevée. Valeur par défaut : 10.
MNSMessageResult	Object		Le message envoyé par Message Service (MNS) pour notifier l'utilisateur du résultat du job.
MessageId	String	3ca84a39a9024f19853b21be9cf9****	L'ID du message de succès. Ce paramètre n'est pas renvoyé si le job échoue.
ErrorMessage	String	The resource operated \"PipelineId\" cannot be found	Le message d'erreur renvoyé en cas d'échec du job. Ce paramètre n'est pas renvoyé si le job réussit.
ErrorCode	String	InvalidParameter.ResourceNotFound	Le code d'erreur renvoyé en cas d'échec du job. Ce paramètre n'est pas renvoyé si le job réussit.
TemplateList	Array of Template		La liste des modèles prédéfinis correspondants.
Template
Video	Object		La configuration du codec vidéo.
Bufsize	String	6000	La taille du tampon. Unité : Ko. Valeur par défaut : 6000.
Degrain	String	5	Le niveau de l'algorithme de débruitage indépendant.
BitrateBnd	Object		La plage de débit binaire moyen de la vidéo.
Max	String	1500	La limite supérieure du débit binaire total. Unité : Kbit/s.
Min	String	800	La limite inférieure du débit binaire total. Unité : Kbit/s.
PixFmt	String	yuv420p	Le format de pixel pour l'encodage des couleurs vidéo. Valeurs possibles : formats de pixels standard tels que yuv420p et yuvj420p.
Codec	String	H.264	Le format du codec vidéo. Valeurs possibles : H.264 et H.265. Valeur par défaut : H.264.
Height	String	720	La hauteur de la vidéo. Unité : pixel. Valeur par défaut : la hauteur d'origine de la vidéo.
Qscale	String	15	Le niveau de contrôle de la qualité de la vidéo.
Bitrate	String	1000	Le débit binaire moyen de la vidéo. Unité : Kbit/s.
Maxrate	String	2000	Le débit binaire vidéo maximal. Valeurs possibles : 10 à 50000. Unité : Kbit/s.
Profile	String	high	Le profil du codec. Valeurs possibles : baseline : adapté aux appareils mobiles. main : adapté aux appareils en définition standard. high : adapté aux appareils en haute définition. Valeur par défaut : high.
Crf	String	26	Le facteur de débit constant, qui est le paramètre de contrôle de la qualité par défaut. Valeur par défaut lorsque le paramètre Codec est défini sur H.264 : 23. Valeur par défaut lorsque le paramètre Codec est défini sur H.265 : 26. Si ce paramètre est renvoyé, le paramétrage du paramètre Bitrate n'est pas valide.
Gop	String	250	Le nombre maximal d'images entre deux images clés. Valeur par défaut : 250.
Width	String	1280	La largeur de la vidéo. Unité : pixel. Valeur par défaut : la largeur d'origine de la vidéo.
Fps	String	25	La fréquence d'images. La valeur est 60 si la fréquence d'images du fichier d'entrée dépasse 60. Valeur par défaut : la fréquence d'images du fichier d'entrée.
Preset	String	medium	L'algorithme vidéo prédéfini. Valeurs possibles : veryfast, fast, medium, slow et slower. Valeur par défaut : medium.
ScanMode	String	interlaced	Le mode de balayage. Valeurs possibles : interlaced : Un balayage entrelacé a été effectué. progressive : Un balayage progressif a été effectué.
TransConfig	Object		La configuration générale de transcodage.
TransMode	String	onepass	Le mode de transcodage. Valeur par défaut : onepass. Valeurs possibles : onepass twopass CBR
State	String	Normal	Le statut du modèle. Valeurs possibles : Normal : Le modèle est dans un état normal. Deleted : Le modèle est supprimé.
MuxConfig	Object		La configuration de transmuxing.
Gif	Object		Le format GIF.
FinalDelay	String	0	L'intervalle entre deux boucles consécutives pour le format GIF. Unité : 0,01 s. Par exemple, une valeur de 500 indique 5 secondes.
Loop	String	0	Le nombre de boucles pour le format GIF ou WebP. Valeur par défaut : 0.
Segment	Object		La configuration des segments.
Duration	String	10	La durée du segment. Unité : secondes.
Name	String	FLV-UD	Le nom du modèle.
Audio	Object		La configuration du codec audio.
Profile	String	aac_low	Le profil du codec du fichier audio. Valeurs possibles lorsque le paramètre Codec est défini sur aac : aac_low aac_he aac_he_v2 aac_ld aac_eld
Codec	String	aac	Le format du codec audio. Valeur par défaut : aac. Valeurs possibles : aac mp3 vorbis flac
Samplerate	String	44100	La fréquence d'échantillonnage. Unité : Hz. Valeur par défaut : 44100.
Qscale	String	15	Le niveau de contrôle de la qualité de l'audio.
Channels	String	2	Le nombre de canaux audio. Valeur par défaut : 2.
Bitrate	String	128	Le débit binaire audio du fichier de sortie. Valeurs possibles : 8 à 1000. Unité : Kbit/s. Valeur par défaut : 128.
Id	String	S00000000-00****	L'ID du modèle de transcodage.
Container	Object		La configuration du conteneur.
Format	String	flv	Le format du conteneur.
UserData	String	testid-001	Les données personnalisées.
Code	String	InvalidParameter.ResourceNotFound	Le code d'erreur renvoyé en cas d'échec du job.
InputFile	Object		Les informations sur l'entrée du job.
Object	String	example.flv	Le nom du fichier d'entrée téléchargé dans le bucket Object Storage Service (OSS).
Location	String	oss-cn-hangzhou	L'ID de la région OSS.
Bucket	String	example-bucket	Le nom du bucket OSS dans lequel le fichier d'entrée est téléchargé.
PipelineId	String	bb558c1cc25b45309aab5be44d19****	L'ID de la file d'attente ApsaraVideo Media Processing (MPS) à laquelle le job est ajouté.
Id	String	57f6aa3f84824309bcba67231b406****	L'ID du job d'analyse de modèle.
NonExistAnalysisJobIds	Array of String	null	Les ID des jobs d'analyse de modèle qui n'existent pas. Si tous les ID de job interrogés existent, la réponse ne contient pas ce paramètre.

Exemples

Exemples de requêtes

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryAnalysisJobList
&AnalysisJobIds=bb558c1cc25b45309aab5be44d19****
&<Common request parameters>

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<QueryAnalysisJobListResponse>
    <RequestId>5CA6E020-4102-4FFF-AA56-5ED7ECD811A1</RequestId>
    <AnalysisJobList>
        <CreationTime>2014-01-10T12:00:00Z</CreationTime>
        <Percent>86</Percent>
        <State>Success</State>
        <AnalysisConfig>
            <QualityControl>
                <MethodStreaming>network</MethodStreaming>
                <RateQuality>25</RateQuality>
            </QualityControl>
            <PropertiesControl>
                <Deinterlace>Auto</Deinterlace>
                <Crop>
                    <Top>8</Top>
                    <Width>8</Width>
                    <Height>8</Height>
                    <Left>8</Left>
                    <Mode>Auto</Mode>
                </Crop>
            </PropertiesControl>
        </AnalysisConfig>
        <Message>The resource operated \"PipelineId\" cannot be found</Message>
        <Priority>8</Priority>
        <MNSMessageResult>
            <MessageId>3ca84a39a9024f19853b21be9cf9****</MessageId>
        </MNSMessageResult>
        <TemplateList>
            <Video>
                <Bufsize>6000</Bufsize>
                <Degrain>5</Degrain>
                <BitrateBnd>
                    <Max>1500</Max>
                    <Min>800</Min>
                </BitrateBnd>
                <PixFmt>yuv420p</PixFmt>
                <Codec>H.264</Codec>
                <Height>720</Height>
                <Qscale>15</Qscale>
                <Bitrate>1000</Bitrate>
                <Maxrate>2000</Maxrate>
                <Profile>high</Profile>
                <Crf>26</Crf>
                <Gop>250</Gop>
                <Width>1280</Width>
                <Fps>25</Fps>
                <Preset>medium</Preset>
                <ScanMode>interlaced</ScanMode>
            </Video>
            <TransConfig>
                <TransMode>onepass</TransMode>
            </TransConfig>
            <State>Normal</State>
            <MuxConfig>
                <Gif>
                    <FinalDelay>0</FinalDelay>
                    <Loop>0</Loop>
                </Gif>
                <Segment>
                    <Duration>10</Duration>
                </Segment>
            </MuxConfig>
            <Name>FLV-UD</Name>
            <Audio>
                <Profile>aac_low</Profile>
                <Codec>aac</Codec>
                <Samplerate>44100</Samplerate>
                <Qscale>15</Qscale>
                <Channels>2</Channels>
                <Bitrate>128</Bitrate>
            </Audio>
            <Id>S00000000-00****</Id>
            <Container>
                <Format>flv</Format>
            </Container>
        </TemplateList>
        <UserData>testid-001</UserData>
        <InputFile>
            <Object>example.flv</Object>
            <Location>oss-cn-hangzhou</Location>
            <Bucket>example-bucket</Bucket>
        </InputFile>
        <PipelineId>bb558c1cc25b45309aab5be44d19****</PipelineId>
        <Id>57f6aa3f84824309bcba67231b406****</Id>
    </AnalysisJobList>
    <NonExistAnalysisJobIds>null</NonExistAnalysisJobIds>
</QueryAnalysisJobListResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
    "RequestId": "5CA6E020-4102-4FFF-AA56-5ED7ECD811A1",
    "AnalysisJobList": [
        {
            "CreationTime": "2014-01-10T12:00:00Z",
            "Percent": 86,
            "State": "Success",
            "AnalysisConfig": {
                "QualityControl": {
                    "MethodStreaming": "network",
                    "RateQuality": "25"
                },
                "PropertiesControl": {
                    "Deinterlace": "Auto",
                    "Crop": {
                        "Top": "8",
                        "Width": "8",
                        "Height": "8",
                        "Left": "8",
                        "Mode": "Auto"
                    }
                }
            },
            "Message": "The resource operated \\\"PipelineId\\\" cannot be found",
            "Priority": "8",
            "MNSMessageResult": {
                "MessageId": "3ca84a39a9024f19853b21be9cf9****",
            },
            "TemplateList": [
                {
                    "Video": {
                        "Bufsize": "6000",
                        "Degrain": "5",
                        "BitrateBnd": {
                            "Max": "1500",
                            "Min": "800"
                        },
                        "PixFmt": "yuv420p",
                        "Codec": "H.264",
                        "Height": "720",
                        "Qscale": "15",
                        "Bitrate": "1000",
                        "Maxrate": "2000",
                        "Profile": "high",
                        "Crf": "26",
                        "Gop": "250",
                        "Width": "1280",
                        "Fps": "25",
                        "Preset": "medium",
                        "ScanMode": "interlaced"
                    },
                    "TransConfig": {
                        "TransMode": "onepass"
                    },
                    "State": "Normal",
                    "MuxConfig": {
                        "Gif": {
                            "FinalDelay": "0",
                            "Loop": "0"
                        },
                        "Segment": {
                            "Duration": "10"
                        }
                    },
                    "Name": "FLV-UD",
                    "Audio": {
                        "Profile": "aac_low",
                        "Codec": "aac",
                        "Samplerate": "44100",
                        "Qscale": "15",
                        "Channels": "2",
                        "Bitrate": "128"
                    },
                    "Id": "S00000000-00****",
                    "Container": {
                        "Format": "flv"
                    }
                }
            ],
            "UserData": "testid-001",
            "InputFile": {
                "Object": "example.flv",
                "Location": "oss-cn-hangzhou",
                "Bucket": "example-bucket"
            },
            "PipelineId": "bb558c1cc25b45309aab5be44d19****",
            "Id": "57f6aa3f84824309bcba67231b406****"
        }
    ],
    "NonExistAnalysisJobIds": [
        "null"
    ]
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.