GetDownloadUrl API でセキュアなファイルダウンロード URL を生成する - Drive and Photo Service

ファイルのダウンロード URL を取得します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST /v2/file/get_download_url HTTP/1.1

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
body	object	任意
share_id	string	任意	共有 ID。共有を介してファイルにアクセスする場合は、認証のために `x-share-token` ヘッダーを含め、このフィールドを指定します。その場合、`drive_id` フィールドは無視されます。それ以外の場合は、認証のために AccessKey ペアまたはアクセストークンを使用し、`drive_id` フィールドを指定します。 `share_id` または `drive_id` のいずれかを指定する必要があります。	7JQX1FswpQ8
drive_id	string	任意	ドライブ ID。	1
file_id	string	必須	ファイル ID。	9520943DC264
file_name	string	任意	ファイル名。最大長は 1,024 文字です。	1.txt
expire_sec	integer	任意	ダウンロード URL の生存時間 (TTL) (秒単位)。最大値は 115200 です。デフォルト値は 900 です。	100
response_content_type	string	任意		video/mp4

レスポンスフィールド

フィールド	型	説明	例
	object	応答スキーマ。
url	string	パブリックダウンロード URL。インテリジェントデータエンドポイントを有効にすると、システムは顧客に最適なネットワーク回線を選択し、対応するドメイン名を持つダウンロード URL を返します。	https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
internal_url	string	Virtual Private Cloud (VPC) 内で使用するためのダウンロード URL。インテリジェントデータエンドポイントを有効にしている場合、このフィールドは使用されません。その場合、システムは `url` フィールドに適切な URL を自動的に返します。このフィールドを使用するには、PDS テクニカルサポートにお問い合わせください。	https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
cdn_url	string	コンテンツデリバリーネットワーク (CDN) ダウンロード URL。インテリジェントデータエンドポイントを有効にしている場合、このフィールドは使用されません。その場合、システムは `url` フィールドに適切な URL を自動的に返します。このフィールドを使用するには、PDS テクニカルサポートにお問い合わせください。	https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt
expiration	string	ダウンロード URL の有効期限。	2022-01-02T15:04:05.999Z07:00
size	integer	ファイルサイズ (バイト単位)。	10
crc64_hash	string	CRC-64 値。	5498595269368962671
content_hash	string	ファイルコンテンツのハッシュ。	EA4942AA8761213890A5C386F88E6464D2C31CA1
content_hash_name	string	ファイルコンテンツのハッシュアルゴリズム名。	sha1

例

成功レスポンス

JSONJSON

{
  "url": "https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt",
  "internal_url": "https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt",
  "cdn_url": "https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt",
  "expiration": "2022-01-02T15:04:05.999Z07:00",
  "size": 10,
  "crc64_hash": "5498595269368962671",
  "content_hash": "EA4942AA8761213890A5C386F88E6464D2C31CA1",
  "content_hash_name": "sha1"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。