QueryFpShotJobList - - Centre de documentation Alibaba Cloud

Consulte les résultats des tâches ADN. Cette opération permet d'interroger les résultats de tous les types de tâches ADN.

Description de l'opération

Après avoir soumis une tâche ADN, le service ADN effectue une comparaison ADN. Vous pouvez appeler cette opération pour interroger les résultats de la tâche.
L'interrogation des tâches ADN textuelles n'est actuellement prise en charge que dans la région Chine (Shanghai).
Cette opération permet d'interroger les informations des tâches ADN uniquement sur les six derniers mois.

Limites de QPS

La limite de QPS pour un seul utilisateur est de 100 appels par seconde. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Effectuez les appels d'API de manière appropriée. Pour plus d'informations, consultez Limites de QPS.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

mts:QueryFpShotJobList

get

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
JobIds	string	Non	La liste des identifiants des tâches ADN à interroger. Nous vous recommandons d'interroger jusqu'à 10 identifiants de tâches à la fois. Séparez les identifiants de tâches multiples par des virgules (,).	88c6ca184c0e47098a5b665e2a12****
NextPageToken	string	Non	Le jeton pour la page suivante. Vous n'avez pas besoin de spécifier ce paramètre dans la première requête. Le service renvoie ce jeton et vous pouvez l'utiliser dans la deuxième requête.	16f01ad6175e4230ac42bb5182cd****
MaximumPageSize	integer	Non	Le nombre maximal d'entrées à renvoyer par page. Valeur par défaut : 10. Valeurs valides : 1 à 30.	10
State	string	Non	L'état des tâches à interroger. Valeurs valides : All : toutes les tâches Queuing : en file d'attente Analysing : en cours d'analyse Fail : échoué Success : réussi	All
StartOfJobCreatedTimeRange	string	Non	L'heure de création de tâche la plus ancienne. L'heure doit être au format UTC et conforme à la norme ISO 8601. Format : YYYY-MM-DDThh:mm:ssZ.	2021-12-22T03:48:05Z
EndOfJobCreatedTimeRange	string	Non	L'heure de création de tâche la plus récente. L'heure doit être au format UTC et conforme à la norme ISO 8601. Format : YYYY-MM-DDThh:mm:ssZ.	2022-02-14T02:16:07Z
PipelineId	string	Non	L'identifiant de la file d'attente MPS. Vous pouvez obtenir l'identifiant en choisissant Paramètres globaux > Files d'attente et rappels MPS dans la console ApsaraVideo Media Processing.	b11c171cced04565b1f38f1ecc39****

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	25818875-5F78-4A13-BEF6-D7393642CA58
NextPageToken	string	Le jeton pour la page suivante. Enregistrez ce jeton et utilisez-le dans la requête suivante.	b11c171cced04565b1f38f1ecc39****
FpShotJobList	object
FpShotJob	array<object>	Les informations de la tâche ADN.
	array<object>	Les détails des informations de la tâche ADN.
FpShotResult	object	Les résultats de la requête de la tâche ADN.
AudioFpShots	object
FpShot	array<object>	Les résultats de la requête d'ADN audio.
	array<object>	Les détails des résultats de la requête d'ADN audio.
PrimaryKey	string	La clé primaire unique.	498ac941373341599c4777c8d884****
FpShotSlices	object
FpShotSlice	array<object>	Les extraits audio similaires.
	array<object>	Les détails des extraits audio similaires.
Duplication	object	L'heure de début et la durée de l'audio dans la bibliothèque ADN.
Start	string	L'heure de début.	0
Duration	string	La durée.	3
Similarity	string	La similarité de l'extrait audio.	0
Input	object	L'heure de début et la durée de l'audio d'entrée.
Start	string	L'heure de début.	0
Duration	string	La durée.	5
Similarity	string	La similarité globale de l'audio.	0
FpShots	object
FpShot	array<object>	Les résultats de la requête d'ADN vidéo.
	array<object>	Les détails des résultats de la requête d'ADN vidéo.
PrimaryKey	string	La clé primaire unique de la vidéo.	498ac941373341599c4777c8d884****
FpShotSlices	object
FpShotSlice	array<object>	Les extraits vidéo similaires.
	array<object>	Les détails des extraits vidéo similaires.
Duplication	object	L'heure de début et la durée de la vidéo dans la bibliothèque ADN.
Start	string	L'heure de début.	1260
Duration	string	La durée.	48
Similarity	string	La similarité de l'extrait vidéo.	0
Input	object	L'heure de début et la durée de la vidéo d'entrée.
Start	string	L'heure de début.	46
Duration	string	La durée.	48
Similarity	string	La similarité globale de la vidéo. Remarque La similarité globale est la moyenne des similarités des extraits. Si plusieurs segments similaires existent dans la bibliothèque ADN, plusieurs résultats de correspondance sont renvoyés.	0.8914769887924194
TextFpShots	object
TextFpShot	array<object>	Les résultats de la requête d'ADN textuel.
	array<object>	Les détails des résultats de la requête d'ADN textuel.
PrimaryKey	string	La clé primaire unique du texte.	3e34ac649945b53a1b0f863ce030****
Similarity	string	La similarité du texte.	1.0
TextFpShotSlices	object
TextFpShotSlice	array<object>	Les extraits de texte en double.
	array<object>	Les détails des extraits de texte en double.
Similarity	string	Le niveau de confiance de l'extrait correspondant.	1.0
InputText	string	L'extrait de texte correspondant dans la requête.	It is snowing today
DuplicationText	string	L'extrait de texte correspondant dans la bibliothèque de base.	It is snowing today
InputFragment	object	L'heure de début et la durée de l'extrait correspondant dans la requête.
Start	string	L'heure de début.	0
Duration	string	La durée.	3
CreationTime	string	L'heure de création. L'heure est affichée au format UTC et conforme à la norme ISO 8601 au format YYYY-MM-DDTHH:mm:ssZ.	2017-01-10T12:00:00Z
FinishTime	string	L'heure de fin.	0
State	string	L'état de la tâche. Valeurs valides : Queuing : en file d'attente Analysing : en cours d'analyse Success : réussi Fail : échoué	Success
Message	string	Le message d'erreur renvoyé en cas d'échec de l'analyse. Ce paramètre n'est pas renvoyé si la tâche réussit.	The parameter \"Id\" is invalid.A uuid must:1)be comprised of chracters[a-f],numbers[0-9];2)be 32 characters long
FpShotConfig	object	Les configurations.
PrimaryKey	string	La clé primaire unique de la vidéo. L'unicité est garantie par l'utilisateur.	3ca84a39a9024f19853b21be9cf9****
SaveType	string	Le type de stockage. Valeurs valides : nosave : non stocké dans la bibliothèque save : stocké dans la bibliothèque après déduplication forcesave : stocké de force dans la bibliothèque	save
FpDBId	string	L'identifiant de la bibliothèque ADN.	2288c6ca184c0e47098a5b665e2a12****
FileId	string	L'identifiant du fichier.	ebb51ee30f0b49aba959823fa991****
UserData	string	Les données utilisateur personnalisées.	testid-001
Duration	integer	La durée du fichier d'entrée, en secondes.	5
Code	string	Le code d'erreur renvoyé en cas d'échec de l'analyse.	InvalidParameter.UUIDFormatInvalid
InputFile	object	L'entrée de la tâche.
Object	string	L'objet OSS de l'entrée de la tâche.	test.mp4
Location	string	L'emplacement OSS de l'entrée de la tâche.	oss-cn-beiing
Bucket	string	Le compartiment OSS de l'entrée de la tâche.	oss-test
PipelineId	string	L'identifiant de la file d'attente MPS.	88c6ca184c0e47098a5b665e2a12****
Id	string	L'identifiant de la tâche.	88c6ca184c0e47098a5b665e2a12****
Input	string	L'entrée de la tâche.	{"Bucket":"oss-test","Location":"oss-cn-beiing","Object":"test.mp4"}
NonExistIds	object
String	array	La liste des identifiants de tâches inexistants.
	string	La liste des identifiants de tâches inexistants. Ce paramètre n'est pas renvoyé si aucune donnée n'existe.	ae687c02fe944327ba9631e50da23128****

Exemples

JSON format

{
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "NextPageToken": "b11c171cced04565b1f38f1ecc39****",
  "FpShotJobList": {
    "FpShotJob": [
      {
        "FpShotResult": {
          "AudioFpShots": {
            "FpShot": [
              {
                "PrimaryKey": "498ac941373341599c4777c8d884****",
                "FpShotSlices": {
                  "FpShotSlice": [
                    {
                      "Duplication": {
                        "Start": "0",
                        "Duration": "3"
                      },
                      "Similarity": "0",
                      "Input": {
                        "Start": "0",
                        "Duration": "5"
                      }
                    }
                  ]
                },
                "Similarity": "0"
              }
            ]
          },
          "FpShots": {
            "FpShot": [
              {
                "PrimaryKey": "498ac941373341599c4777c8d884****",
                "FpShotSlices": {
                  "FpShotSlice": [
                    {
                      "Duplication": {
                        "Start": "1260",
                        "Duration": "48"
                      },
                      "Similarity": "0",
                      "Input": {
                        "Start": "46",
                        "Duration": "48"
                      }
                    }
                  ]
                },
                "Similarity": "0.8914769887924194"
              }
            ]
          },
          "TextFpShots": {
            "TextFpShot": [
              {
                "PrimaryKey": "3e34ac649945b53a1b0f863ce030****",
                "Similarity": "1.0",
                "TextFpShotSlices": {
                  "TextFpShotSlice": [
                    {
                      "Similarity": "1.0",
                      "InputText": "It is snowing today",
                      "DuplicationText": "It is snowing today",
                      "InputFragment": {
                        "Start": "0",
                        "Duration": "3"
                      }
                    }
                  ]
                }
              }
            ]
          }
        },
        "CreationTime": "2017-01-10T12:00:00Z",
        "FinishTime": "0",
        "State": "Success",
        "Message": "The parameter \\\"Id\\\" is invalid.A uuid must:1)be comprised of chracters[a-f],numbers[0-9];2)be 32 characters long",
        "FpShotConfig": {
          "PrimaryKey": "3ca84a39a9024f19853b21be9cf9****",
          "SaveType": "save",
          "FpDBId": "2288c6ca184c0e47098a5b665e2a12****"
        },
        "FileId": "ebb51ee30f0b49aba959823fa991****",
        "UserData": "testid-001",
        "Duration": 5,
        "Code": "InvalidParameter.UUIDFormatInvalid",
        "InputFile": {
          "Object": "test.mp4",
          "Location": "oss-cn-beiing",
          "Bucket": "oss-test"
        },
        "PipelineId": "88c6ca184c0e47098a5b665e2a12****",
        "Id": "88c6ca184c0e47098a5b665e2a12****",
        "Input": "{\"Bucket\":\"oss-test\",\"Location\":\"oss-cn-beiing\",\"Object\":\"test.mp4\"}"
      }
    ]
  },
  "NonExistIds": {
    "String": [
      "ae687c02fe944327ba9631e50da23128****"
    ]
  }
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.