:CreateFpShotDB

Notes d'utilisation

• Appelez cette opération pour soumettre une tâche de création d'une bibliothèque d'empreintes vidéo ou textuelles. Une bibliothèque d'empreintes textuelles permet de stocker les empreintes associées à du texte.

• La création d'une bibliothèque d'empreintes textuelles n'est possible que dans la région Chine (Shanghai). Par défaut, vous pouvez soumettre jusqu'à 10 tâches de création de bibliothèques d'empreintes vidéo simultanément dans une file d'attente ApsaraVideo Media Processing (MPS). Un dépassement de cette limite peut entraîner l'échec de l'appel.

Limite de QPS

Vous pouvez appeler cette opération jusqu'à 100 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.

Paramètres de requête

| Action | String | Oui | CreateFpShotDB |

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

|

| Name | String | Oui | example name |

Le nom de la bibliothèque d'empreintes multimédias à créer.

|

| ModelId | Integer | Non | 11 |

L'ID du modèle de la bibliothèque d'empreintes multimédias. Pour créer une bibliothèque d'empreintes textuelles, définissez ce paramètre sur 11. Pour créer une bibliothèque d'empreintes vidéo, définissez-le sur 12. Pour créer une bibliothèque d'empreintes audio, définissez-le sur 13. Une valeur de 14 indique qu'il s'agit d'une bibliothèque d'empreintes d'images.

|

| Config | String | Non | null |

Les configurations de la bibliothèque d'empreintes multimédias. Ce paramètre est vide par défaut. Vous pouvez personnaliser les configurations selon vos besoins métier. La valeur doit être une chaîne au format JSON.

|

| Description | String | Non | The library is a text fingerprint library. |

La description de la bibliothèque d'empreintes multimédias.

|

Paramètres de réponse

| RequestId | String | 25818875-5F78-4A13-BEF6-D7393642CA58 |

L'ID de la requête.

|

| FpShotDB | Object | |

Les détails de la bibliothèque d'empreintes multimédias.

|

| Description | String | The library is a text fingerprint library. |

La description de la bibliothèque d'empreintes multimédias.

|

| State | String | offline |

L'état de la bibliothèque d'empreintes multimédias. Après sa création, la bibliothèque passe à l'état offline. Une fois traitée en arrière-plan, elle passe à l'état active.

|

| Name | String | example-name-**** |

Le nom de la bibliothèque d'empreintes multimédias.

|

| FpDBId | String | 88c6ca184c0e47098a5b665e2a12**** |

L'ID de la bibliothèque d'empreintes multimédias. Nous vous recommandons de conserver cet ID pour les appels d'opérations ultérieurs.

|

| ModelId | Integer | 11 |

L'ID du modèle de la bibliothèque d'empreintes multimédias.

|

| Config | String | null |

Les configurations de la bibliothèque d'empreintes multimédias.

|

Exemples

Exemple de requête

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=CreateFpShotDB
&Name=example name
&ModelId=11
&Config=null
&Description=The library is a text fingerprint library.
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<CreateFpShotDBResponse>
    <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
    <FpShotDB>
        <Description>The library is a text fingerprint library.</Description>
        <State>offline</State>
        <Name>example-name-****</Name>
        <FpDBId>88c6ca184c0e47098a5b665e2a12****</FpDBId>
        <ModelId>11</ModelId>
        <Config>null</Config>
    </FpShotDB>
</CreateFpShotDBResponse>

Format JSON

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

{
  "RequestId" : "25818875-5F78-4A13-BEF6-D7393642CA58",
  "FpShotDB" : {
    "Description" : "The library is a text fingerprint library.",
    "State" : "offline",
    "Name" : "example-name-****",
    "FpDBId" : "88c6ca184c0e47098a5b665e2a12****",
    "ModelId" : 11,
    "Config" : "null"
  }
}

Codes d'erreur

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