Obtém os detalhes de um arquivo.
Experimente agora
Testar
Autorização RAM
Sintaxe da solicitação
POST /v2/file/get HTTP/1.1Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| domain_id |
string |
Sim |
||
| body |
object |
Não |
Os parâmetros do corpo da solicitação. |
|
| drive_id |
string |
Não |
O ID do drive. |
1 |
| file_id |
string |
Sim |
O ID do arquivo. |
9520943DC264 |
| url_expire_sec |
integer |
Não |
O tempo de expiração em segundos. O valor deve ser um número inteiro de 10 a 14.400, inclusive. |
100 |
| fields |
string |
Não |
Especifica quais campos retornar:
Por padrão, esta operação retorna todos os campos do arquivo, exceto aqueles que requerem uma solicitação explícita. |
* |
| thumbnail_processes |
object |
Não |
Especifica a configuração de miniatura. Solicite até cinco miniaturas em uma única chamada definindo chaves personalizadas para o mapa. A resposta retorna a URL de cada miniatura solicitada sob sua chave correspondente. |
|
| ImageProcess |
Não |
Define as regras de processamento para miniaturas de imagens, vídeos e documentos. |
||
| share_id |
string |
Não |
O ID do compartilhamento. Para acessar um arquivo em um compartilhamento, forneça este parâmetro e autentique-se com o cabeçalho x-share-token, caso em que drive_id é ignorado. Caso contrário, forneça drive_id e autentique-se com um par de AccessKey ou um access_token. Você deve especificar share_id ou drive_id. |
7JQX1FswpQ8 |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
| File |
O objeto de arquivo. |
Exemplos
Resposta de sucesso
JSON formato
{
"domain_id": "bj1",
"drive_id": "1",
"file_id": "5d79206586bb5dd69fb34c349282718146c55da7",
"name": "1.mov",
"type": "file",
"content_type": "application/json",
"created_at": "2019-08-20T06:51:27.292Z",
"updated_at": "2019-08-20T06:51:27.292Z",
"description": "image file",
"trashed_at": "2019-08-20T06:51:27.292Z",
"file_extension": "txt",
"hidden": false,
"size": 1024,
"starred": false,
"status": "available",
"labels": [
"[\"label1:1\", \"label2:2\"]"
],
"upload_id": "C9DCFE5A82644AC7A02DB74C30C934A6",
"parent_file_id": "3d5b846942cf94fa72324c8a4bda34e81da635a",
"crc64_hash": "3574582125365864471",
"content_hash": "EA4942AA8761213890A5C386F88E6464D2C31CA3",
"content_hash_name": "sha1",
"download_url": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx",
"thumbnail": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx",
"category": "image",
"local_created_at": "2019-08-20T06:51:27.292Z",
"local_modified_at": "2019-08-20T06:51:27.292Z",
"revision_id": "5d5b846942cf94fa72324c14a4bda34e81da635d",
"thumbnail_urls": {
"key": "\"128X128\": \"https://url1\", \"800X800\": \"url2\""
},
"image_media_metadata": {
"time": "2006-01-02T15:04:05.000Z07:00",
"width": 1024,
"height": 1024,
"location": "30.185453,120.218522",
"country": "China\n",
"province": "Zhejiang\n",
"city": "Hangzhou\n",
"district": "Binjiang District\n",
"township": "Xixing Street\n",
"address_line": "Jiangling Road, Xixing Street, Binjiang District, Hangzhou, Zhejiang\n",
"image_tags": [
{
"confidence": 0.98,
"parent_name": "sport",
"name": "basketball",
"tag_level": 3,
"source": "play basketball",
"centric_score": 0.877
}
],
"faces": "[{\"FaceId\":\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\",\"GroupId\":\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\",\"FaceConfidence\":0.999,\"Age\":13,\"AgeConfidence\":4,\"Gender\":\"female\",\"GenderConfidence\":1,\"Emotion\":\"none\",\"EmotionConfidence\":0.672,\"FaceAttributes\":{\"Mask\":\"none\",\"MaskConfidence\":0.894,\"Beard\":\"none\",\"BeardConfidence\":0.997,\"Glasses\":\"none\",\"GlassesConfidence\":0.999,\"Mouth\":\"close\",\"MouthConfidence\":0.937,\"Hat\":\"none\",\"HatConfidence\":0.998,\"HeadPose\":{\"Pitch\":10.684,\"Roll\":-10.707,\"Yaw\":-20.094},\"FaceBoundary\":{\"Width\":457,\"Height\":687,\"Top\":1324,\"Left\":1356}}}]",
"faces_thumbnail": [
{
"face_id": "a9a66a86-73dd-4c95-8b79-1d8a49db5226",
"face_group_id": "Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0",
"face_thumbnail": "https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2"
}
],
"exif": "{\"Compression\":{\"value\":\"6\"},\"DateTime\":{\"value\":\"2020:08:19 17:11:11\"}}",
"image_quality": {
"overall_score": 0.736
}
},
"user_tags": {
"key": "\"k1\":\"v1\", \"k2\",\"v2\""
},
"video_media_metadata": {
"width": 1920,
"height": 1080,
"video_media_video_stream": [
{
"duration": "22.88",
"bitrate": "108420",
"code_name": "h264",
"frame_count": "90"
}
],
"video_media_audio_stream": [
{
"duration": "7704.573000",
"bit_rate": "129280",
"code_name": "aac"
}
]
},
"id_path": "id1/id2",
"name_path": "root/f1/f2",
"dir_size_info": {
"dir_count": 1,
"file_count": 10
},
"action_list": [
""
],
"auto_delete_left_sec": 0
}Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.