Consulte les métadonnées de fichier extraites, y compris des champs tels que le nom du fichier, les balises, le chemin et les balises personnalisées. Les métadonnées d'un fichier sont renvoyées si la valeur d'au moins un champ des métadonnées du fichier correspond à la chaîne spécifiée.
Description de l'opération
-
Avant d'appeler cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'Intelligent Media Management.
-
Avant d'appeler cette opération, assurez-vous d'avoir indexé des fichiers dans un jeu de données en utilisant des liaisons (CreateBinding) ou une indexation active (IndexFileMeta ou BatchIndexFileMeta).
-
Les résultats renvoyés sont fournis à titre de référence uniquement. Selon la configuration du modèle de workflow, les catégories et le contenu des métadonnées de fichier obtenues peuvent différer des exemples. Si vous avez des questions, rejoignez le groupe DingTalk pour nous faire part de vos commentaires. Pour obtenir l'identifiant du groupe DingTalk, reportez-vous à la section Nous contacter.
-
Pour les champs qui participent à la recherche, reportez-vous à la liste des champs et opérateurs pris en charge.
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
|
imm:FuzzyQuery |
list |
*Jeu de données.
|
Aucune | Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| NextToken |
string |
Non |
Le jeton utilisé pour la pagination lorsque le nombre total de fichiers dépasse la valeur de MaxResults. La liste des informations de fichier est renvoyée par ordre lexicographique à partir de NextToken. Définissez ce paramètre sur vide lors du premier appel de cette opération. |
MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpwZw== |
| MaxResults |
integer |
Non |
Le nombre maximal de fichiers à renvoyer. Valeurs valides : 0 à 200. Si vous ne définissez pas ce paramètre ou si vous le définissez sur 0, la valeur par défaut est 100. |
1 |
| ProjectName |
string |
Oui |
Le nom du projet. Pour plus d'informations sur la façon d'obtenir le nom du projet, consultez la section Créer un projet. |
test-project |
| DatasetName |
string |
Oui |
Le nom du jeu de données. Pour plus d'informations sur la façon d'obtenir le nom du jeu de données, consultez la section Créer un jeu de données. |
test-dataset |
| Query |
string |
Oui |
La chaîne utilisée pour la requête. La taille de la chaîne ne peut pas dépasser 1 Mo. |
Alibaba Cloud |
| Sort |
string |
Non |
La liste des champs selon lesquels trier les résultats. Pour plus d'informations, consultez la liste des champs et opérateurs pris en charge.
|
Size,Filename |
| Order |
string |
Non |
L'ordre de tri des champs de tri. Valeurs valides :
Remarque
|
asc,desc |
| WithFields |
array |
Non |
Spécifie les champs à renvoyer. Seules les valeurs des champs spécifiés sont renvoyées au lieu de tous les champs de métadonnées existants. Vous pouvez utiliser ce paramètre pour réduire la taille de la structure renvoyée. Si vous ne spécifiez pas ce paramètre ou si vous le laissez vide, tous les champs sont renvoyés. |
|
|
string |
Non |
Spécifie les champs à renvoyer. Seules les valeurs des champs spécifiés sont renvoyées au lieu de tous les champs de métadonnées existants. Vous pouvez utiliser ce paramètre pour réduire la taille de la structure renvoyée. Si vous ne spécifiez pas ce paramètre ou si vous le laissez vide, tous les champs sont renvoyés. |
Filename |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
La structure de la réponse. |
||
| Files |
array |
La liste des informations de fichier. |
|
| File |
Les informations de fichier. |
||
| NextToken |
string |
Le jeton utilisé pour la pagination lorsque le nombre total de fichiers dépasse la valeur de MaxResults. Lors de votre prochaine requête pour lister les informations de fichier, définissez NextToken sur cette valeur pour renvoyer les résultats restants. Ce paramètre n'est renvoyé que lorsque tous les fichiers ne sont pas renvoyés. |
MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpwZw== |
| RequestId |
string |
L'identifiant de la requête. |
1B3D5E0A-D8B8-4DA0-8127-ED32C851**** |
| TotalHits |
integer |
Le nombre d'enregistrements correspondants. |
10 |
Exemples
JSON format
{
"Files": [
{
"OwnerId": "102321002467****",
"ProjectName": "test-project",
"DatasetName": "test-dataset",
"ObjectType": "file",
"ObjectId": "75d5de2c50754e3dadd5c35dbca5f9949369e37eb342a73821f690c94c36c7f7",
"UpdateTime": "2021-06-29T14:50:13.011643661+08:00",
"CreateTime": "2021-06-29T14:50:13.011643661+08:00",
"URI": "oss://test-bucket/test-object.jpg",
"OSSURI": "oss://examplebucket/sampleobject.jpg",
"Filename": "sampleobject.jpg",
"MediaType": "image",
"ContentType": "image/jpeg",
"Size": 1000,
"FileHash": "1d9c280a7c4f67f7ef873e28449dbe17",
"FileModifiedTime": "2021-06-29T14:50:13.011643661+08:00",
"FileCreateTime": "2021-06-29T14:50:13.011643661+08:00",
"FileAccessTime": "2021-06-29T14:50:13.011643661+08:00",
"ProduceTime": "2021-06-29T14:50:13.011643661+08:00",
"LatLong": "30.134390,120.074997",
"Timezone": "\"\"",
"Addresses": [
{
"Language": "zh-Hans",
"AddressLine": "N° 969, Wenyi West Road, district de Yuhang, Hangzhou, Zhejiang, Chine",
"Country": "Chine",
"Province": "Zhejiang",
"City": "Hangzhou",
"District": "District de Yuhang",
"Township": "Wenyi West Road"
}
],
"TravelClusterId": "-",
"Orientation": 0,
"Figures": [
{
"FigureId": "868a9e74-cde5-4c7a-9013-28bb984****",
"FigureConfidence": 1,
"FigureClusterId": "Cluster-dbe72fec-b84c-4ab6-885b-3678e64****",
"FigureClusterConfidence": 1,
"FigureType": "face",
"Age": 29,
"AgeSD": 5,
"Gender": "female",
"GenderConfidence": 1,
"Emotion": "happiness",
"EmotionConfidence": 0.70784568786621,
"FaceQuality": 0.960875928401947,
"Boundary": {
"Width": 200,
"Height": 300,
"Left": 10,
"Top": 30,
"Polygon": [
{
"X": 10,
"Y": 10
}
]
},
"Mouth": "close",
"MouthConfidence": 1,
"Beard": "none",
"BeardConfidence": 1,
"Hat": "none",
"HatConfidence": 1,
"Mask": "none",
"MaskConfidence": 1,
"Glasses": "none",
"GlassesConfidence": 0.8,
"Sharpness": 0.7,
"Attractive": 0.96,
"HeadPose": {
"Pitch": 18.385589599609375,
"Roll": 4.204030513763428,
"Yaw": 2.4945924282073975
}
}
],
"FigureCount": 10,
"Labels": [
{
"Language": "zh-Hans",
"LabelName": "椅子",
"LabelLevel": 2,
"LabelConfidence": 0.95,
"ParentLabelName": "家具",
"CentricScore": 0.877,
"LabelAlias": "座椅",
"Clips": [
{
"TimeRange": [
100
]
}
]
}
],
"Title": "test",
"ImageWidth": 270,
"ImageHeight": 500,
"EXIF": "{\"Compression\":{\"value\":\"6\"},\"DateTime\":{\"value\":\"2020:08:19 17:11:11\"}}",
"ImageScore": {
"OverallQualityScore": 0.736
},
"CroppingSuggestions": [
{
"AspectRatio": "2:3",
"Confidence": 0.742,
"Boundary": {
"Width": 200,
"Height": 300,
"Left": 10,
"Top": 30,
"Polygon": [
{
"X": 10,
"Y": 10
}
]
}
}
],
"OCRContents": [
{
"Language": "zh-hans",
"Contents": "Bienvenue dans Intelligent Media Management",
"Confidence": 0.8254936695098877,
"Boundary": {
"Width": 200,
"Height": 300,
"Left": 10,
"Top": 30,
"Polygon": [
{
"X": 10,
"Y": 10
}
]
}
}
],
"VideoWidth": 1080,
"VideoHeight": 1920,
"VideoStreams": [
{
"Index": 0,
"Language": "en",
"CodecName": "h264",
"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"Profile": "High",
"CodecTimeBase": "1373627/83160000",
"CodecTagString": "avc1",
"CodecTag": "0x31637661",
"Width": 1280,
"Height": 720,
"HasBFrames": 2,
"SampleAspectRatio": "1:1",
"DisplayAspectRatio": "16:9",
"PixelFormat": "yuv420p",
"Level": 40,
"FrameRate": "25/1",
"AverageFrameRate": "25/1",
"TimeBase": "1/12800",
"StartTime": 0,
"Duration": 22.88,
"Bitrate": 5407765,
"FrameCount": 572,
"Rotate": "90",
"BitDepth": 8,
"ColorSpace": "bt709",
"ColorRange": "tv",
"ColorTransfer": "bt709",
"ColorPrimaries": "bt709"
}
],
"Subtitles": [
{
"Index": 2,
"Language": "en",
"CodecName": "mov_text",
"CodecLongName": "MOV text",
"CodecTagString": "tx3g",
"CodecTag": "0x67337874",
"StartTime": 0,
"Duration": 71.378,
"Bitrate": 74,
"Content": "Bienvenue",
"Width": 600,
"Height": 30
}
],
"AudioStreams": [
{
"Index": 1,
"Language": "en",
"CodecName": "aac",
"CodecLongName": "AAC (Advanced Audio Coding)",
"CodecTimeBase": "1/44100",
"CodecTagString": "mp4a",
"CodecTag": "0x6134706d",
"TimeBase": "1/48000",
"StartTime": 0.0235,
"Duration": 3.690667,
"Bitrate": 320087,
"FrameCount": 173,
"Lyric": "test",
"SampleFormat": "fltp",
"SampleRate": 48000,
"Channels": 2,
"ChannelLayout": "stéréo"
}
],
"Artist": "Jane",
"AlbumArtist": "Jane",
"AudioCovers": [
{
"ImageWidth": 500,
"ImageHeight": 820,
"EXIF": "{\"FileSize\":{\"value\":\"29304\"},\"Format\":{\"value\":\"jpg\"}}",
"ImageScore": {
"OverallQualityScore": 0.736
},
"CroppingSuggestions": [
{
"AspectRatio": "2:3",
"Confidence": 0.742
}
],
"OCRContents": [
{
"Language": "zh-hans",
"Contents": "Bienvenue dans Intelligent Media Management",
"Confidence": 0.8254936695098877
}
]
}
],
"Composer": "Jane",
"Performer": "Jane",
"Language": "eng",
"Album": "FirstAlbum",
"PageCount": 5,
"ETag": "\"1D9C280A7C4F67F7EF873E28449****\"",
"CacheControl": "no-cache",
"ContentDisposition": "attachment; filename =test.jpg",
"ContentEncoding": "UTF-8",
"ContentLanguage": "zh-CN",
"AccessControlAllowOrigin": "https://aliyundoc.com",
"AccessControlRequestMethod": "PUT",
"ServerSideEncryptionCustomerAlgorithm": "SM4",
"ServerSideEncryption": "AES256",
"ServerSideDataEncryption": "SM4",
"ServerSideEncryptionKeyId": "9468da86-3509-4f8d-a61e-6eab1eac****",
"OSSStorageClass": "Standard",
"OSSCRC64": "559890638950338001",
"ObjectACL": "default",
"ContentMd5": "HZwoCnxPZ/fvhz4oRJ2+Fw==",
"OSSUserMeta": {
"key": "val"
},
"OSSTaggingCount": 2,
"OSSTagging": {
"key": "val"
},
"OSSExpiration": "2120-01-01T12:00:00.000Z",
"OSSVersionId": "CAEQNhiBgMDJgZCA0BYiIDc4MGZjZGI2OTBjOTRmNTE5NmU5NmFhZjhjYmY0****",
"OSSDeleteMarker": "CAEQMhiBgIDXiaaB0BYiIGQzYmRkZGUxMTM1ZDRjOTZhNjk4YjRjMTAyZjhl****",
"OSSObjectType": "Normal",
"CustomId": "\t\nmember-image-id-0001",
"CustomLabels": {
"test": "test",
"test2": 1
},
"StreamCount": 1,
"ProgramCount": 1,
"FormatName": "mov",
"FormatLongName": "QuickTime / MOV",
"StartTime": 0,
"Bitrate": 13091201,
"Duration": 15.263,
"SemanticTypes": [
"content"
],
"Elements": [
{
"ElementContents": [
{
"Type": "text",
"Content": "Fragment de texte",
"URL": "http://aliyun.com",
"TimeRange": [
500
]
}
],
"ObjectId": "id1",
"ElementType": "title - titre ; image - image ; table - tableau ; narrative-text - texte narratif",
"SemanticSimilarity": 0.8,
"ElementRelations": [
{
"Type": "child, parent",
"ObjectId": "id1"
}
]
}
],
"SceneElements": [
{
"TimeRange": [
100
],
"FrameTimes": [
30
],
"VideoStreamIndex": 0,
"Labels": [
{
"Language": "zh-Hans",
"LabelName": "椅子",
"LabelLevel": 2,
"LabelConfidence": 0.95,
"ParentLabelName": "家具",
"CentricScore": 0.877,
"LabelAlias": "座椅",
"Clips": [
{
"TimeRange": [
100
]
}
]
}
]
}
],
"OCRTexts": "阿里云IMM",
"Reason": "[InternalError] The request has been failed due to some unknown error. status: 500, requestId: CC5ACFBD-BB7A-496D-A9D6-****",
"ObjectStatus": "Indexed",
"Insights": {
"Video": {
"Description": "None",
"Caption": "La vidéo montre deux scènes différentes : l'une avec une assiette blanche immobile, un flacon noir et un verre transparent, et l'autre avec une main tenant un flacon de shampoing portant la mention \"YEZOLU\" se déplaçant lentement vers le haut dans une salle de bain"
},
"Image": {
"Caption": "Aucun",
"Description": "L'image représente une personne vêtue d'une veste de costume sombre et d'une chemise blanche. L'arrière-plan est un dégradé allant du bleu clair au gris"
}
}
}
],
"NextToken": "MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpwZw==",
"RequestId": "1B3D5E0A-D8B8-4DA0-8127-ED32C851****",
"TotalHits": 10
}Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.