ListFpShotFiles - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Appelez cette opération pour répertorier les fichiers multimédias d'une bibliothèque d'empreintes digitales multimédias spécifiée, en vous basant sur l'ID de la bibliothèque. Cette opération prend en charge la pagination des résultats.

Limite de QPS

Vous pouvez appeler cette opération jusqu'à 500 fois par seconde par compte. Si le nombre d'appels par seconde dépasse cette 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 rubrique Limite de QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Par souci de simplicité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. Celui-ci génère dynamiquement l'exemple de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ListFpShotFiles	Opération à effectuer. Définissez la valeur sur ListFpShotDB.
NextPageToken	String	Non	ae0fd49c0840e14daf0d66a75b83****	Jeton de la page suivante. Ce paramètre est requis pour les requêtes paginées. Lors de la demande de la première page de résultats, laissez le paramètre NextPageToken vide. Pour obtenir les pages suivantes, spécifiez la valeur du paramètre NextPageToken renvoyée dans les résultats de la page précédente.
PageSize	Integer	Non	20	Nombre d'entrées à renvoyer par page. Valeur par défaut : 20.
FpDBId	String	Oui	2288c6ca184c0e47098a5b665e2a12****	ID de la bibliothèque d'empreintes digitales multimédias dont vous souhaitez répertorier les fichiers. Vous pouvez obtenir cet ID à partir des paramètres de réponse de l'opération CreateFpShotDB.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	25818875-5F78-4A13-BEF6-D7393642CA58	ID de la requête.
NextPageToken	String	ae0fd49c0840e14daf0d66a75b83****	Jeton de la page suivante.
FpShotFileList	Tableau de FpShotFile		Liste des fichiers d'empreintes digitales multimédias. Pour plus d'informations, reportez-vous à la section « FpShotFile » de la rubrique Types de données.
FpShotFile
PrimaryKey	String	fb712a6890464059b1b2ea7c8647****	Clé primaire unique de la vidéo.
InputFile	Object		Informations relatives à l'entrée de la tâche.
Object	String	example-****.mp4	Nom de l'objet Object Storage Service (OSS) utilisé comme fichier d'entrée.
Location	String	oss-cn-beijing	ID de la région OSS où réside le fichier d'entrée.
Bucket	String	example-bucket-****	Nom du bucket OSS dans lequel le fichier d'entrée est stocké.
FileId	String	41e6536e4f2250e2e9bf26cdea19****	ID du fichier vidéo.

Exemples

Exemple de requête

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=ListFpShotFiles
&NextPageToken=ae0fd49c0840e14daf0d66a75b83****
&PageSize=20
&FpDBId=2288c6ca184c0e47098a5b665e2a12****
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<ListFpShotFilesResponse>
    <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
    <NextPageToken>ae0fd49c0840e14daf0d66a75b83****</NextPageToken>
    <FpShotFileList>
        <PrimaryKey>fb712a6890464059b1b2ea7c8647****</PrimaryKey>
        <InputFile>
            <Object>example-****.mp4</Object>
            <Location>oss-cn-beijing</Location>
            <Bucket>example-bucket-****</Bucket>
        </InputFile>
        <FileId>41e6536e4f2250e2e9bf26cdea19****</FileId>
    </FpShotFileList>
</ListFpShotFilesResponse>

JSON format

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

{
  "RequestId" : "25818875-5F78-4A13-BEF6-D7393642CA58",
  "NextPageToken" : "ae0fd49c0840e14daf0d66a75b83****",
  "FpShotFileList" : [ {
    "PrimaryKey" : "fb712a6890464059b1b2ea7c8647****",
    "InputFile" : {
      "Object" : "example-****.mp4",
      "Location" : "oss-cn-beijing",
      "Bucket" : "example-bucket-****"
    },
    "FileId" : "41e6536e4f2250e2e9bf26cdea19****"
  } ]
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParameter.OutOfRange	The specified parameter %s is out of range.	Le message d'erreur indique que la valeur du paramètre n'est pas valide.
500	InternalError	The operation has failed due to some unknown error, exception or failure.	Le message d'erreur indique qu'une erreur interne s'est produite. Réessayez ultérieurement.

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