云存储连接参数说明

本文将对对象存储服务连接、FTP服务连接以及连接超时的参数进行说明,便于正确输入参数信息,完成云存储服务连接。

对象存储服务连接

华为云对象存储服务 OBS、阿里云对象存储服务 OSS、SeaweedFS 对象存储服务、MinIO 对象存储服务、兼容 AWS S3 协议对象存储服务都属于对象存储服务,选择这些服务类型,需要设置以下参数:

参数 说明
连接名称 默认值为“CloudStorage”,用于标识云存储服务连接。指定的名称不能与当前已有连接重名。连接名称支持中文、英文、数字、下划线、短横线、@字符,例如:影像-cloudstorage@_name。
服务类型

标识云存储服务提供者。

华为云对象存储服务 OBS、阿里云对象存储服务 OSS、SeaweedFS 对象存储服务、MinIO 对象存储服务也是兼容 AWS S3 协议对象存储服务。选择兼容 AWS S3 协议对象存储服务后,同样可以连接至以上服务类型,区别在于连接信息中无服务提供者标识。

服务端点 服务端点(Endpoint),设置云存储服务的访问地址,支持域名IP+端口两种地址形式。参数值输入示例:
  • 域名:阿里云对象存储服务 OSS、华为云对象存储服务 OBS均采用域名的方式提供服务端点,服务端点与创建存储桶时指定的地域属性相关联。如在阿里云对象存储服务 OSS中存储桶的地域属性为“华北2(北京)”,则服务端点的值为“oss-cn-beijing.aliyuncs.com”。
  • IP+端口:SeaweedFS 对象存储服务、MinIO对象存储服务中采用此方式提供服务端点。如MinIO 对象存储服务为S3 API访问对象存储开放的端口是9110,对象存储服务器的IP为:1.1.1.0,则服务端点参数值应指定为:1.1.1.0:9110
注意事项:

服务端点的地址形式与具体的对象存储服务有关,同时服务端点还可能为HTTP或HTTPS访问协议。需根据具体情况在连接选项中,设置AWS_HTTPS的值,指定正确的端口号。

访问密钥

访问密钥为对象存储桶的访问凭证,包括访问密钥ID和访问密钥。由于服务器配置问题,如MinIO对象存储服务可能只需提供登录账号和密码。

存储桶名称 指定对象存储服务中存储桶的名称,需要具有该对象存储桶的访问凭证。不同提供商的定义有区别,如在阿里云中称为存储空间,在华为云中称为桶。
文件夹

文件夹可以设置连接至对象存储桶下的指定文件夹。若未指定,将连接至对象存储桶的根目录。

对象存储服务提供了虚拟文件夹,即对象存储桶下使用文件夹结构管理文件。通过此参数可以直接连接至指定文件夹,方便建立连接后进行文件查找。

例如:连接至MinIO对象存储服务的存储桶”image”,image.tif在存储桶中的文件路径为“/folder1/folder2/img/image.tif”,添加云存储连接的连接名称为“CloudStorage1”。那么将这里的文件夹设置为“/folder1/folder2”,在桌面端使用image.tif时,文件路径就可以简化为“//CloudStorage1/img/image.tif”。若不设置此参数,在使用image.tif时,文件路径为“//CloudStorage1/folder1/folder2/img/image.tif”。

连接选项 连接选项中提供名称(key)与值(value)的对照表,下面列举常用的选项信息。
  • AWS_HTTPS=[YES/NO]:AWS_HTTPS值为NO,将使用HTTP协议访问S3对象存储中的资源;AWS_HTTPS 值为YES,将使用HTTPS协议访问S3对象存储中的资源。如果未添加AWS_HTTPS选项,默认使用HTTPS协议访问S3对象存储中的资源。AWS_HTTPS值如何设置,需要确认S3对象存储服务器支持的请求协议。
  • AWS_NO_SIGN_REQUEST=[YES/NO]:对象存储桶身份验证方式(是否禁用请求签名),适用于具有公共访问权限的存储桶。如果为YES,可匿名连接到不需要身份验证访问权限的存储桶。如果访问对象存储桶必需身份验证,则AWS_NO_SIGN_REQUEST变量值设置为NO。
  • AWS_VIRTUAL_HOSTING=[TRUE/FALSE]:对象存储桶的访问方式,S3 支持虚拟托管类型(Virtual Hosted)和路径类型(path)URL访问存储桶。如果值为TRUE(默认值),为虚拟托管类型,是指将存储桶置于Host Header的访问方式,通过虚拟存储桶主机名标识存储桶,例如:mybucket.cname.domain.com,即“桶名+HostName”。如果值为FALSE,为路径类型,表示将存储桶标识为URI中的顶级目录,例如:cname.domain.com/mybucket。

以MinIO对象存储为例,默认支持格式为 http://example.com/bucket/object 的路径式请求。如果您配置了 MINIO_DOMAIN(MINIO_DOMAIN 环境变量用于启用虚拟主机样式的请求),MinIO 将同时支持来自客户端的路径式和虚拟主机式请求。 因此需要根据对象存储配置支持的请求方式,添加AWS_VIRTUAL_HOSTING选项并指定正确的值。 默认情况下,MinIO对象存储使用路径请求方式访问存储桶,那么就需要添加AWS_VIRTUAL_HOSTING=FALSE选项。

FTP服务连接

仅需根据服务端点、用户名和密码,就能连接到FTP服务,参数说明如下:

参数 说明
连接名称 默认值为“CloudStorage”,用于标识云存储服务连接。指定的名称不能与当前已有连接重名。连接名称支持中文、英文、数字、下划线、短横线、@字符,例如:影像-cloudstorage@_name。
服务端点 FTP服务地址,例如:127.0.0.1。
用户名/密码 访问FTP服务的用户名和对应的密码。
路径

路径可以设置连接至FTP服务中指定目录。若未指定,将连接至FTP服务器的根目录。

例如:设置路径:/nfs/gisdata/img/,将只会与此目录建立连接,创建连接后,连接节点下将只显示此目录下的文件及文件夹内容。

连接超时参数说明

在云存储服务对话框的全局环境项中组织了连接超时的参数。在不添加新的云存储服务连接时,也可通过此全局环境项修改连接超时参数,修改内容将实时应用于所有连接。说明如下:

参数 说明
HTTP创建连接的超时时间 连接云存储服务时,HTTP创建连接的超时时间。
HTTP单个请求的总超时时间 连接云存储服务时,HTTP单个请求的总超时时间,单个请求的总超时时间指从请求开始到请求结束的总时间,包括DNS解析、连接建立、传输等。
HTTP的重试时间间隔 连接云存储服务时,HTTP的重试时间间隔。
HTTP的最大重试次数 连接云存储服务时,HTTP的最大重试次数。

相关主题

添加云存储连接实例

创建镶嵌数据集

单任务切图

多任务切图