QueryAnalysisJobList - : Central de Documentação do Alibaba Cloud

Observações de uso

Esta operação permite consultar até 10 trabalhos de análise de modelo por vez.

Limite de QPS

O limite desta operação é de 100 chamadas por segundo por conta. Se o número de chamadas por segundo exceder esse valor, o sistema ativa o throttling, o que pode afetar seus serviços. Recomendamos observar esse limite ao chamar esta operação. Para mais informações, consulte Limite de QPS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

QueryAnalysisJobList

A operação a ser executada. Defina o valor como QueryAnalysisJobList.

AnalysisJobIds

String

Sim

bb558c1cc25b45309aab5be44d19****

Os IDs dos trabalhos de análise de modelo.

É possível consultar até 10 trabalhos por vez.
Separe vários IDs com vírgulas (,).

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	5CA6E020-4102-4FFF-AA56-5ED7ECD811A1	O ID da solicitação.
AnalysisJobList	Array of AnalysisJob		Os IDs dos trabalhos de análise de modelo.
AnalysisJob
CreationTime	String	2014-01-10T12:00:00Z	O horário de criação do trabalho.
Percent	Long	86	O progresso da transcodificação.
State	String	Success	O status do trabalho. Valores válidos: Submitted: O trabalho foi enviado. Analyzing: O trabalho está em execução. Success: O trabalho foi concluído com sucesso. Fail: O trabalho falhou.
AnalysisConfig	Object		A configuração do trabalho.
QualityControl	Object		O controle de qualidade da saída do trabalho.
MethodStreaming	String	network	O modo de reprodução. Valores válidos: network: reprodução online local: reprodução em dispositivos locais Valor padrão: network.
RateQuality	String	25	O nível de qualidade da saída do trabalho. Valor padrão: 25.
PropertiesControl	Object		O controle dos atributos da saída do trabalho.
Deinterlace	String	Auto	Indica se o desentrelaçamento foi forçado. Valores válidos: Auto: O desentrelaçamento ocorreu automaticamente. Force: O desentrelaçamento foi forçado. None: O desentrelaçamento foi desativado.
Crop	Object		A configuração de corte das imagens de vídeo.
Top	String	8	A margem superior removida pelo corte. Nota Este parâmetro é inválido se o parâmetro Mode estiver definido como Auto ou None.
Width	String	8	A largura do vídeo após a remoção das margens. Nota Este parâmetro é inválido se o parâmetro Mode estiver definido como Auto ou None.
Height	String	8	A altura do vídeo após a remoção das margens. Nota Este parâmetro é inválido se o parâmetro Mode estiver definido como Auto ou None.
Left	String	8	A margem esquerda removida pelo corte. Nota Este parâmetro é inválido se o parâmetro Mode estiver definido como Auto ou None.
Mode	String	Auto	O modo de corte. Valores válidos: Auto: O corte ocorreu automaticamente. Force: O corte foi forçado. None: O corte foi desativado. Este parâmetro é obrigatório se o valor do parâmetro Crop não for um objeto JSON vazio.
Message	String	The resource operated \"PipelineId\" cannot be found	A mensagem de erro retornada quando o trabalho falha.
Priority	String	8	A prioridade do trabalho na fila do MPS à qual ele foi adicionado. Valores válidos: 1 a 10. O valor 10 indica a maior prioridade. Valor padrão: 10.
MNSMessageResult	Object		A mensagem enviada pelo Message Service (MNS) para notificar o usuário sobre o resultado do trabalho.
MessageId	String	3ca84a39a9024f19853b21be9cf9****	O ID da mensagem de sucesso. Este parâmetro não é retornado se o trabalho falhar.
ErrorMessage	String	The resource operated \"PipelineId\" cannot be found	A mensagem de erro retornada quando o trabalho falha. Este parâmetro não é retornado se o trabalho for bem-sucedido.
ErrorCode	String	InvalidParameter.ResourceNotFound	O código de erro retornado quando o trabalho falha. Este parâmetro não é retornado se o trabalho for bem-sucedido.
TemplateList	Array of Template		A lista de modelos predefinidos correspondentes.
Template
Video	Object		A configuração do codec de vídeo.
Bufsize	String	6000	O tamanho do buffer. Unidade: KB. Valor padrão: 6000.
Degrain	String	5	O nível do algoritmo independente de redução de ruído.
BitrateBnd	Object		O intervalo médio de taxa de bits do vídeo.
Max	String	1500	O limite superior da taxa de bits total. Unidade: Kbit/s.
Min	String	800	O limite inferior da taxa de bits total. Unidade: Kbit/s.
PixFmt	String	yuv420p	O formato de pixel para codificação de cores do vídeo. Valores válidos: formatos de pixel padrão, como yuv420p e yuvj420p.
Codec	String	H.264	O formato do codec de vídeo. Valores válidos: H.264 e H.265. Valor padrão: H.264.
Height	String	720	A altura do vídeo. Unidade: pixel. Valor padrão: a altura original do vídeo.
Qscale	String	15	O nível de controle de qualidade do vídeo.
Bitrate	String	1000	A taxa de bits média do vídeo. Unidade: Kbit/s.
Maxrate	String	2000	A taxa de bits máxima do vídeo. Valores válidos: 10 a 50000. Unidade: Kbit/s.
Profile	String	high	O perfil do codec. Valores válidos: baseline: adequado para dispositivos móveis. main: adequado para dispositivos de definição padrão. high: adequado para dispositivos de alta definição. Valor padrão: high.
Crf	String	26	O fator de taxa constante, que é a configuração padrão de controle de qualidade. Valor padrão quando o parâmetro Codec está definido como H.264: 23. Valor padrão quando o parâmetro Codec está definido como H.265: 26. Se este parâmetro for retornado, a configuração do parâmetro Bitrate será inválida.
Gop	String	250	O número máximo de quadros entre dois keyframes. Valor padrão: 250.
Width	String	1280	A largura do vídeo. Unidade: pixel. Valor padrão: a largura original do vídeo.
Fps	String	25	A taxa de quadros. O valor é 60 se a taxa de quadros do arquivo de entrada exceder 60. Valor padrão: a taxa de quadros do arquivo de entrada.
Preset	String	medium	O algoritmo de vídeo predefinido. Valores válidos: veryfast, fast, medium, slow e slower. Valor padrão: medium.
ScanMode	String	interlaced	O modo de varredura. Valores válidos: interlaced: Varredura entrelaçada realizada. progressive: Varredura progressiva realizada.
TransConfig	Object		A configuração geral de transcodificação.
TransMode	String	onepass	O modo de transcodificação. Valor padrão: onepass. Valores válidos: onepass twopass CBR
State	String	Normal	O status do modelo. Valores válidos: Normal: O modelo está no estado normal. Deleted: O modelo foi excluído.
MuxConfig	Object		A configuração de transmuxing.
Gif	Object		O formato GIF.
FinalDelay	String	0	O intervalo entre dois loops consecutivos para o formato GIF. Unidade: 0,01 s. Por exemplo, um valor de 500 indica 5 segundos.
Loop	String	0	O número de loops para o formato GIF ou WebP. Valor padrão: 0.
Segment	Object		A configuração do segmento.
Duration	String	10	A duração do segmento. Unidade: segundos.
Name	String	FLV-UD	O nome do modelo.
Audio	Object		A configuração do codec de áudio.
Profile	String	aac_low	O perfil do codec do arquivo de áudio. Valores válidos quando o parâmetro Codec está definido como aac: aac_low aac_he aac_he_v2 aac_ld aac_eld
Codec	String	aac	O formato do codec de áudio. Valor padrão: aac. Valores válidos: aac mp3 vorbis flac
Samplerate	String	44100	A taxa de amostragem. Unidade: Hz. Valor padrão: 44100.
Qscale	String	15	O nível de controle de qualidade do áudio.
Channels	String	2	O número de canais de som. Valor padrão: 2.
Bitrate	String	128	A taxa de bits de áudio do arquivo de saída. Valores válidos: 8 a 1000. Unidade: Kbit/s. Valor padrão: 128.
Id	String	S00000000-00****	O ID do modelo de transcodificação.
Container	Object		A configuração do contêiner.
Format	String	flv	O formato do contêiner.
UserData	String	testid-001	Os dados personalizados.
Code	String	InvalidParameter.ResourceNotFound	O código de erro retornado quando o trabalho falha.
InputFile	Object		As informações sobre a entrada do trabalho.
Object	String	example.flv	O nome do arquivo de entrada carregado no bucket do Object Storage Service (OSS).
Location	String	oss-cn-hangzhou	O ID da região do OSS.
Bucket	String	example-bucket	O nome do bucket do OSS onde o arquivo de entrada foi carregado.
PipelineId	String	bb558c1cc25b45309aab5be44d19****	O ID da fila do ApsaraVideo Media Processing (MPS) à qual o trabalho foi adicionado.
Id	String	57f6aa3f84824309bcba67231b406****	O ID do trabalho de análise de modelo.
NonExistAnalysisJobIds	Array of String	null	Os IDs dos trabalhos de análise de modelo inexistentes. Se todos os IDs de trabalho consultados existirem, a resposta não conterá este parâmetro.

Exemplos

Exemplos de solicitações

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

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"
    ]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.