WOLFRAM

Wolfram 语言与系统参考资料中心

ExternalStorageUpload[file]

将 file 上传至由 $ExternalStorageBase 指定的外部存储.

ExternalStorageUpload[file,dest]

将 file 上传到支持它的外部存储服务的特定目的地 dest.

ExternalStorageUpload[filedest]

将 file 上传到支持它的外部存储服务的特定目的地 dest.

ExternalStorageUpload[{file1,file2,…},dest]

将文件列表上传到支持它的外部存储服务的特定目的地 dest.

ExternalStorageUpload[{file1,file2,…}dest]

将文件列表上传到支持它的外部存储服务的特定目的地 dest.

ExternalStorageUpload[{file1dest1,file2dest2,…}]

将文件列表上传到支持它的外部存储服务的特定目的地.

更多信息和选项
Details and Options Details and Options
范例  
基本范例  
范围  
单个文件  
默认目标  
目标指定  
多个文件  
选项  
ExternalStorageBase  
Amazon S3  
Dropbox  
IPFS  
OverwriteTarget  
属性和关系  
可能存在的问题  
参见
相关指南
相关链接
历史
按以下格式引用：

ExternalStorageUpload

ExternalStorageUpload[file]

将 file 上传至由 $ExternalStorageBase 指定的外部存储.

ExternalStorageUpload[file,dest]

将 file 上传到支持它的外部存储服务的特定目的地 dest.

ExternalStorageUpload[filedest]

将 file 上传到支持它的外部存储服务的特定目的地 dest.

ExternalStorageUpload[{file1,file2,…},dest]

将文件列表上传到支持它的外部存储服务的特定目的地 dest.

ExternalStorageUpload[{file1,file2,…}dest]

将文件列表上传到支持它的外部存储服务的特定目的地 dest.

ExternalStorageUpload[{file1dest1,file2dest2,…}]

将文件列表上传到支持它的外部存储服务的特定目的地.

更多信息和选项

  • ExternalStorageUpload 返回一个 ExternalStorageObject.
  • 默认外部存储由 $ExternalStorageBase 给出.
  • dest 的可能的形式包括：
  • "path"外部存储服务（如 Dropbox）中的路径
    "bucket"外部存储服务（如 Amazon S3）中的存储桶名称
    "bucket/key"外部存储服务（如 Amazon S3）中的存储桶名称和密钥
    "bucket/prefix/"外部存储服务（如 Amazon S3）中的存储桶名称和前缀
    "uri"外部存储服务的 URI（如 Amazon S3 URI）
    {"dest1","dest2",…}外部存储服务中的路径、存储桶或 URI 列表
    ExternalStorageObject[…]外部存储对象
  • 支持路径的常见外部存储服务包括 Dropbox 和 Amazon S3. IPFS 不支持路径.

范例

打开所有单元 关闭所有单元

基本范例  (5)

将文件上传到 InterPlanetary 文件系统 (IPFS) 中：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png"]

将文件上传到 Dropbox 中：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", "spikey.png", ExternalStorageBase -> "Dropbox"]

将 ExternalStorageObject 作为目标，上传文件：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", ExternalStorageObject[]]

将多个文件上传到 Amazon S3 存储桶：

Wolfram Language code: files = FileNameJoin[{$InstallationDirectory, "Documentation", "English", "System", "ExampleData", #}]& /@ {"coneflower.jpg", "spikey2.png", "turtle.jpg"};
Wolfram Language code: ExternalStorageUpload[files, "wolfram-bucket", ExternalStorageBase -> "AmazonS3"]

将多个文件上传到 Amazon S3 存储桶中的特定目标位置：

Wolfram Language code: files = FileNameJoin[{$InstallationDirectory, "Documentation", "English", "System", "ExampleData", #}]& /@ {"coneflower.jpg", "photo.jpg", "turtle.jpg"};
Wolfram Language code: destinations = Table[StringRiffle[{"wolfram-bucket", "jpgFiles", "image" <> ToString[i] <> ".jpg"}, "/"], {i, 1, 3}]
Wolfram Language code: ExternalStorageUpload[files, destinations, ExternalStorageBase -> "AmazonS3"]

范围  (8)

单个文件  (6)

默认目标  (1)

用默认的目标路径将文件上传到 Dropbox 中：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", ExternalStorageBase -> "Dropbox"]

目标指定  (5)

指定目标路径，将文件上传到 Dropbox 中：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", "spikey.png", ExternalStorageBase -> "Dropbox"]

将文件上传到 Dropbox 中. 如果目标目录不存在，将创建该目录：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", "/NonExistentFolderX77/spikey.png", ExternalStorageBase -> "Dropbox"]

将一个文件上传到 Amazon S3 存储桶：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", "wolfram-bucket", ExternalStorageBase -> "AmazonS3"]

将一个文件上传到 Amazon S3 存储桶中的特定路径：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", "wolfram-bucket/spikeyExample.png", ExternalStorageBase -> "AmazonS3"]

用语法 filedestination 给出同样的结果：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png" -> "wolfram-bucket/spikeyExample.png", ExternalStorageBase -> "AmazonS3"]

通过提供 Amazon S3 URI 将文件上传到 Amazon S3 存储桶中的特定路径：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", "s3://wolfram-bucket/spikeyExample.png", ExternalStorageBase -> "AmazonS3"]

多个文件  (2)

将多个文件上传到 Amazon S3 存储桶：

Wolfram Language code: files = FileNameJoin[{$InstallationDirectory, "Documentation", "English", "System", "ExampleData", #}]& /@ {"coneflower.jpg", "spikey2.png", "turtle.jpg"};
Wolfram Language code: ExternalStorageUpload[files, "wolfram-bucket", ExternalStorageBase -> "AmazonS3"]

用语法 {file1,file2,…}destination 给出同样的结果：

Wolfram Language code: ExternalStorageUpload[files -> "wolfram-bucket", ExternalStorageBase -> "AmazonS3"]

将多个文件上传到 Amazon S3 存储桶中的特定目标位置：

Wolfram Language code: files = FileNameJoin[{$InstallationDirectory, "Documentation", "English", "System", "ExampleData", #}]& /@ {"coneflower.jpg", "photo.jpg", "turtle.jpg"};
Wolfram Language code: destinations = Table[StringRiffle[{"wolfram-bucket", "jpgFiles", "image" <> ToString[i] <> ".jpg"}, "/"], {i, 1, 3}];
Wolfram Language code: ExternalStorageUpload[files, destinations, ExternalStorageBase -> "AmazonS3"]

用语法 {file1,file2,…}{dest1,dest2,…} 给出同样的结果：

Wolfram Language code: ExternalStorageUpload[files -> destinations, ExternalStorageBase -> "AmazonS3"]

提供规则列表作为第一个参数也可将文件上传到指定的目的地：

Wolfram Language code: rules = MapThread[Rule, {files, destinations}]
Wolfram Language code: ExternalStorageUpload[rules, ExternalStorageBase -> "AmazonS3"]

选项  (7)

ExternalStorageBase  (6)

Amazon S3  (4)

将一个文件上传到 Amazon S3 存储桶：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", "wolfram-bucket", ExternalStorageBase -> "AmazonS3"]

将一个文件上传到 Amazon S3 存储桶中的特定路径：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", "wolfram-bucket/spikeyExample.png", ExternalStorageBase -> "AmazonS3"]

将多个文件上传到 Amazon S3 存储桶：

Wolfram Language code: files = FileNameJoin[{$InstallationDirectory, "Documentation", "English", "System", "ExampleData", #}]& /@ {"coneflower.jpg", "spikey2.png", "turtle.jpg"};
Wolfram Language code: ExternalStorageUpload[files, "wolfram-bucket", ExternalStorageBase -> "AmazonS3"]

将多个文件上传到 Amazon S3 存储桶中的特定目标位置：

Wolfram Language code: files = FileNameJoin[{$InstallationDirectory, "Documentation", "English", "System", "ExampleData", #}]& /@ {"coneflower.jpg", "photo.jpg", "turtle.jpg"};
Wolfram Language code: destinations = Table[StringRiffle[{"wolfram-bucket", "jpgFiles", "image" <> ToString[i] <> ".jpg"}, "/"], {i, 1, 3}];
Wolfram Language code: ExternalStorageUpload[files, destinations, ExternalStorageBase -> "AmazonS3"]

Dropbox  (1)

将文件上传到 Dropbox 中：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", ExternalStorageBase -> "Dropbox"]

IPFS  (1)

将文件上传到 InterPlanetary 文件系统 (IPFS) 中. IPFS 不需要目标路径，因为该系统中的文件由自动给出的内容标识符 (CID) 标识：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", ExternalStorageBase -> "IPFS"]

OverwriteTarget  (1)

默认情况下，如果将不同的文件上传到现有路径，则 ExternalStorageUpload 不会覆盖文件. 上传一个新文件：

Wolfram Language code: file1 = "ExampleData/spikey2.png";
Wolfram Language code: ExternalStorageUpload[file1, "NonExistentFolderX77/spikey.png", ExternalStorageBase -> "Dropbox"]

将新文件上传到同一路径：

Wolfram Language code: file2 = "ExampleData/glasses.png";
Wolfram Language code: ExternalStorageUpload[file2, "NonExistentFolderX77/spikey.png", ExternalStorageBase -> "Dropbox"]

将创建一个新的文件：

Wolfram Language code: %["Path"]

通过将 OverwriteTarget 选项设为 True，目标文件将被替换：

Wolfram Language code: ExternalStorageUpload[file2, "NonExistentFolderX77/spikey.png", ExternalStorageBase -> "Dropbox", OverwriteTarget -> True]
Wolfram Language code: %["Path"]

属性和关系  (2)

ExternalStorageBase 选项可将来自已创建的连接中的 ServiceObject 作为值：

Wolfram Language code: dropbox = ServiceConnect["Dropbox"]
Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", ExternalStorageBase -> dropbox]

CopyFile 也支持将 ExternalStorageObject 作为文件指定，将本地文件上传到外部存储服务：

Wolfram Language code: eso = ExternalStorageObject[]
Wolfram Language code: CopyFile["ExampleData/spikey2.png", eso]

可能存在的问题  (1)

IPFS 管理内容标识符 (CID)：

Wolfram Language code: obj = ExternalStorageUpload["ExampleData/spikey2.png"]

如果使用 IPFS，不能上传到特定的 ExternalStorageObject：

Wolfram Language code: ExternalStorageUpload["ExampleData/spikey2.png", obj]
Wolfram Research (2020)，ExternalStorageUpload，Wolfram 语言函数，https://reference.wolfram.com/language/ref/ExternalStorageUpload.html （更新于 2021 年）.

文本

Wolfram Research (2020)，ExternalStorageUpload，Wolfram 语言函数，https://reference.wolfram.com/language/ref/ExternalStorageUpload.html （更新于 2021 年）.

CMS

Wolfram 语言. 2020. "ExternalStorageUpload." Wolfram 语言与系统参考资料中心. Wolfram Research. 最新版本 2021. https://reference.wolfram.com/language/ref/ExternalStorageUpload.html.

APA

Wolfram 语言. (2020). ExternalStorageUpload. Wolfram 语言与系统参考资料中心. 追溯自 https://reference.wolfram.com/language/ref/ExternalStorageUpload.html 年

BibTeX

@misc{reference.wolfram_2026_externalstorageupload, author="Wolfram Research", title="{ExternalStorageUpload}", year="2021", howpublished="\url{https://reference.wolfram.com/language/ref/ExternalStorageUpload.html}", note=[Accessed: 15-October-2026]}

BibLaTeX

@online{reference.wolfram_2026_externalstorageupload, organization={Wolfram Research}, title={ExternalStorageUpload}, year={2021}, url={https://reference.wolfram.com/language/ref/ExternalStorageUpload.html}, note=[Accessed: 15-October-2026]}