本文将对对象存储服务连接、FTP服务连接以及连接超时的参数进行说明,便于正确输入参数信息,完成云存储服务连接。
对象存储服务连接
华为云对象存储服务 OBS、阿里云对象存储服务 OSS、SeaweedFS 对象存储服务、MinIO 对象存储服务、兼容 AWS S3 协议对象存储服务都属于对象存储服务,选择这些服务类型,需要设置以下参数:
参数 | 说明 |
连接名称 | 默认值为“CloudStorage”,用于标识云存储服务连接。指定的名称不能与当前已有连接重名。连接名称支持中文、英文、数字、下划线、短横线、@字符,例如:影像-cloudstorage@_name。 |
服务类型 |
标识云存储服务提供者。 华为云对象存储服务 OBS、阿里云对象存储服务 OSS、SeaweedFS 对象存储服务、MinIO 对象存储服务也是兼容 AWS S3 协议对象存储服务。选择兼容 AWS S3 协议对象存储服务后,同样可以连接至以上服务类型,区别在于连接信息中无服务提供者标识。 |
服务端点 | 服务端点(Endpoint),设置云存储服务的访问地址,支持域名和IP+端口两种地址形式。参数值输入示例:
注意事项:
服务端点的地址形式与具体的对象存储服务有关,同时服务端点还可能为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)的对照表,下面列举常用的选项信息。
以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的最大重试次数。 |
相关主题