云服务器内容精选

  • 操作步骤 登录OBS Browser。 在主页面右上角的搜索框中输入需要查找的桶名。 单击。 搜索到的桶会显示在桶列表中。如果想重新搜索其他桶,可单击删除已输入的关键字后重新输入需要搜索的桶名。 如果用户当前处于对象列表界面,需要快速切换到其他桶,则可单击页面左侧图标展开隐藏的桶列表,并在桶列表上方搜索框中搜索需要切换到的桶。 例如:您需要查找桶名中包含“test”字符的所有桶,您只需在主页面右上角的搜索框中输入“test”并单击,所有包含“test”字符的桶都会展示到桶列表中。
  • 相关操作 您可以在创建桶时指定桶的存储类别,也可以在创建后修改桶的存储类别。修改步骤如下: 在OBS管理控制台左侧导航栏选择“桶列表”。 在桶列表中,选择待操作的桶,并单击右侧的“修改存储类别”。 选择目标存储类别,并单击“确定”。 修改桶的存储类别后,不会影响已存储在桶内的对象的存储类别。 上传对象时,默认的对象存储类别与桶的存储类别一致。当桶存储类别修改后,新上传对象时的默认对象存储类别随之修改。
  • 操作步骤 在OBS管理控制台左侧导航栏选择“桶列表”。 在页面右上角单击“创建桶”,系统弹出如图1所示的页面。 图1 创建桶 配置桶参数。 表1 桶参数说明 参数 描述 复制桶配置 可选。单击“选择源桶”后,可以在桶列表中选择一个源桶。返回后页面会自动复制源桶的以下配置信息:区域 / 数据冗余策略 / 存储类别 / 桶策略 / 服务端加密 / 归档数据直读 / 企业项目 / 标签。 选择后您仍可以根据业务情况对复制的配置信息进行部分或全部更改。 区域 桶所属区域。请选择靠近您业务的区域,以降低网络时延,提高访问速度。桶创建成功后,不支持变更区域,请谨慎选择。 OBS大部分特性在所有区域发布,某些特性仅在部分区域发布。建议根据特性的发布区域选择桶所属区域,特性发布区域请参见功能总览。 如果希望ECS通过内网访问OBS桶,需要确保桶和ECS属于同一个区域,详情请参见在ECS上通过内网访问OBS。 桶名称 桶的名称。需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。桶创建成功后,不支持修改名称,创建时,请设置合适的桶名。 OBS中桶按照DNS规范进行命名,DNS规范为全球通用规则,其具体命名规则如下: 需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。用户删除桶后,立即创建同名桶或并行文件系统会创建失败,需要等待30分钟才能创建。 长度范围为3到63个字符,支持小写字母、数字、中划线(-)、英文句号(.)。 禁止两个英文句号(.)相邻,禁止英文句号(.)和中划线(-)相邻,禁止以英文句号(.)和中划线(-)开头或结尾。 禁止使用IP地址。 说明: 当用户使用虚拟主机方式通过HTTPS协议访问OBS时,如果桶名称中包含英文句号(.),会导致证书校验失败。所以该场景下,建议桶名称不要使用英文句号(.)。 数据冗余存储策略 多AZ存储:数据冗余存储至多个可用区(AZ),可靠性更高。 单AZ存储:数据仅存储在单个可用区(AZ),成本更低。 多AZ和单AZ的性能对比请参见存储类别对比。 请根据业务情况提前规划数据冗余存储策略,桶一旦创建成功,数据冗余存储策略就确定了,后续无法更改。 归档存储的桶不支持多AZ功能。 深度归档存储的桶不支持多AZ功能。 默认存储类别 桶的存储类别。不同的存储类别可以满足客户业务对存储性能、成本的不同诉求。 标准存储:适用于有大量热点文件或小文件,且需要频繁访问(平均一个月多次)并快速获取数据的业务场景。 低频访问存储:适用于不频繁访问(平均一年少于12次),但需要快速获取数据的业务场景。 归档存储:适用于很少访问(平均一年一次),且对数据获取速率要求不高的业务场景。 深度归档存储:适用于很少访问,访问频率低于归档存储,且对数据获取速率要求不高的业务场景。 更多详情请参见存储类别。 桶策略 桶的读写权限控制。 私有:除桶ACL授权外的其他用户无桶的访问权限。 公共读:任何用户都可以对桶内对象进行读操作。 公共读写:任何用户都可以对桶内对象进行读/写/删除操作。 复制桶策略:复制源桶的桶策略。当且仅当您选择了源桶时,该选项处于可选状态。 服务端加密 选择“SSE-KMS”加密,则需要选择加密算法、加密密钥类型。加密算法可以选择AES256加密算法或SM4加密算法。加密密钥类型您可以选择“默认密钥”,您上传的对象将使用当前区域的默认密钥进行加密,如果您没有默认密钥,系统将会在首次上传对象时自动为您创建,您也可以选择“自定义密钥”,通过单击“创建KMS密钥”进入数据加密服务页面创建自定义密钥,然后通过KMS密钥的下拉框选中您创建的KMS密钥。 选择“SSE-OBS”加密,则使用OBS服务创建和管理的密钥加密。 如果桶已配置了默认加密,上传对象可以继承桶的加密特性,也可以自行配置SSE-KMS或SSE-OBS加密特性。 WORM 开启WORM (一次写入多次读取) 功能后,当前桶支持配置保留策略,受保留策略保护的对象版本在指定时间段内不能被删除。WORM功能只能在创建桶时开启, 开启后无法关闭,当前桶默认开启多版本控制且不可关闭。 归档数据直读 通过归档数据直读,您可以直接下载存储类别为归档存储的对象,而无需提前恢复。归档数据直读会收取相应的费用,详见产品价格详情。 无论您选择了哪种默认存储类别,都可以开启归档数据直读。例如,默认存储类别为标准存储的桶也可以保存归档存储对象,开启归档数据直读后,您可以直接下载归档存储对象。 企业项目 将桶加入到企业项目中统一管理。 请参见创建企业项目先完成企业项目创建,默认为default企业项目。 在企业项目界面创建企业项目,然后将用户组添加到该企业项目。这时用户组内用户将获得用户组授权的该企业项目下的桶和对象的操作权限。 说明: 仅企业账号能够配置企业项目。 OBS的企业项目用户组的细粒度授权为“OBS ReadOnlyAccess”和“OBS OperateAccess”。 标签 可选。标签用于标识OBS中的桶,以此达到对OBS中的桶进行分类的目的。OBS以键值对的形式来描述标签,每个标签有且只有一对键值。 有关添加标签的信息,请参见标签。 存储包超值购 可选。OBS服务默认为按需计费模式,您可以通过购买存储包的方式,提前购买使用额度和时长,获取更多的优惠。勾选后还需在“资源包规格确认”页面单击“去支付”,才算购买成功。 存储包在桶创建完成后也可单独购买。 单击“立即创建”。 如果您同时购买了存储包,需要在“资源包规格确认”页面单击“去支付”,完成存储包购买。
  • 请求示例 文件下载,其中文件类型为PUBLIC,文件链接如下。 https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/data/download { "type" : "PUBLIC", "url" : "https://eihealth-6a713322-72ad-4080-bdcb-acf571576015.obs.cn-north-4.myhuaweicloud.com/test.txt" } { "type" : "PRIVATE", "url" : "projectName:/test.txt" }
  • URI POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/data/download 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 华为云项目ID,您可以从获取项目ID中获取。 最小长度:1 最大长度:128 eihealth_project_id 是 String 平台项目ID,您可以在平台单击所需的项目名称,进入项目设置页面查看。 最小长度:1 最大长度:128
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限,获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度:1 最大长度:32768 表3 请求Body参数 参数 是否必选 参数类型 描述 type 否 String 下载类型(仅支持PRIVATE|PUBLIC) 枚举值: PRIVATE PUBLIC EXTRANET url 否 String 资源地址(支持https、obs地址) 最小长度:1 最大长度:2000
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 count Integer 数据(文件夹、文件)总数量 objects Array of BucketObjectDto objects 数据列表 表5 BucketObjectDto 参数 参数类型 描述 path String 对象全路径(项目名称:/路径) name String 名称 type String 类型 枚举值: FILE FOLDER size Long 大小 create_time String 创建时间
  • 响应示例 状态码: 200 OK { "count" : 1, "objects" : [ { "path" : "bucket:/test.txt", "name" : "test.txt", "type" : "FILE", "size" : 1024, "create_time" : "2021-02-01T14:25:34Z" } ] }
  • URI GET /v1/{project_id}/customer-buckets/{bucket_name}/objects 表1 路径参数 参数 是否必选 参数类型 描述 bucket_name 是 String 桶名称 最小长度:1 最大长度:128 project_id 是 String 华为云项目ID,您可以从获取项目ID中获取。 最小长度:1 最大长度:128 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 限制量,单次查询总量[1, 1000],默认100 最小值:1 最大值:1000 缺省值:100 offset 否 Integer 偏移量,查询起始偏移,默认为0 最小值:0 最大值:100000000 缺省值:0 path 否 String 子路径 最小长度:0 最大长度:2000 search_key 否 String 查询关键词 最小长度:0 最大长度:2000
  • 操作步骤 在OBS管理控制台左侧导航栏选择“桶列表”。 在桶列表上方的搜索框中单击左键,在一级下拉框中选择“桶名称”、“区域”、“存储类别”、“数据冗余存储策略”或“企业项目”,然后在二级下拉框中选择你需要的选项,也可以输入关键字后再进行选择。 搜索到的桶会展示在桶列表中。 例如:您需要查找桶名称为“test”的桶,您只需在主页面上方的搜索框中单击左键,在一级下拉框中选择“桶名称”,在二级下拉框中选择“test”,或者选择“桶名称”后在搜索框中输入“test”,所有桶名称中包含“test”字符的桶都会展示到二级下拉框中,然后单击“test”。搜索到的桶会展示在桶列表中。 图1 搜索桶 桶列表支持组合过滤。 当筛选条件不同时:筛选条件是交集的关系。例如:选择区域“华北-北京四”后再选择存储类别“标准存储”,区域为“华北-北京四”且存储类别为“标准存储”的桶都会在列表中展示。 当筛选条件相同时:筛选条件是并集的关系。例如:选择桶名称“test-1”后再选择桶名称“test-2”进行组合搜索,桶名称为“test-1”和“test-2”的桶都会在列表中展示。 在桶列表上方的搜索框中直接输入关键字,桶名称、区域、存储类别、数据冗余存储策略或企业项目中包含关键字的所有桶都会展示到下拉框中,单击选择您需要的选项,符合条件的桶会在列表中展示。 或者在桶列表上方的搜索框中直接输入关键字,单击或Enter键。 搜索到的桶名称、区域、存储类别、数据冗余存储策略、企业项目中包含关键字的所有桶会展示在桶列表中。 例如:您在主页面上方的搜索框中输入“test”并单击或Enter键,桶名称、区域、存储类别、数据冗余存储策略、企业项目中包含“test”关键字的所有桶都会展示到桶列表中。 图2 搜索桶
  • 约束与限制 桶创建成功后,不能修改名称和所属区域。创建时,请设置合适的桶名和区域。 一个账号及账号下的所有IAM用户一共可创建100个桶。建议结合OBS细粒度权限控制能力,合理进行桶规划和使用。例如,建议在桶内根据对象前缀划分不同的目录,通过细粒度权限控制实现不同目录在不同业务部门之间的权限隔离。每个桶中存放的对象的数量和大小总和没有限制,用户不需要考虑数据的可扩展性。 考虑到桶名会作为访问域名的一部分,需要参与域名解析,因此桶名需要满足DNS域名规范。OBS系统在接受创桶请求时,会对桶名进行严格的检查,具体规则如下: 需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。用户删除桶后,立即创建同名桶或并行文件系统会创建失败,需要等待30分钟才能创建。 长度范围为3到63个字符,支持小写字母、数字、中划线(-)、英文句号(.)。 禁止两个英文句号(.)相邻,禁止英文句号(.)和中划线(-)相邻,禁止以英文句号(.)和中划线(-)开头或结尾。 禁止使用IP地址。 当使用HTTPS协议访问OBS系统时,由于SSL的通配符证书仅匹配不包含"."的桶。这将导致桶名包含"."的桶在访问OBS系统时,客户端会提示证书校验存在风险,比如浏览器安全提示会呈现红色告警。因此如非必要,请尽量不要在桶名中包含"."。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 total Integer 总数 最小值:0 最大值:100 size Integer 本页数量 最小值:0 最大值:100 items Array of ObsBucketInfo objects 对象列表 数组长度:0 - 100 表5 ObsBucketInfo 参数 参数类型 描述 responseHeaders Object 响应头 originalHeaders Object 请求头 statusCode Integer 状态 bucketName String 桶名称 owner owner object 桶拥有者信息 creationDate String 桶的创建时间 location String 桶的位置信息 storageClass Object 对象的存储类型 metadata Object 桶元数据 acl Object 桶ACL bucketStorageClass Object 桶的存储类型 bucketType String 桶类型 requestId String 请求id 表6 owner 参数 参数类型 描述 displayName String 显示名称 id String 用户的DomainID(帐号ID) 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:128 error_msg String 错误消息 最小长度:1 最大长度:512 error_details String 具体错误消息 最小长度:1 最大长度:1024 request_id String 请求处理ID 最小长度:1 最大长度:128 状态码: 401 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:128 error_msg String 错误消息 最小长度:1 最大长度:512 error_details String 具体错误消息 最小长度:1 最大长度:1024 request_id String 请求处理ID 最小长度:1 最大长度:128 状态码: 403 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:128 error_msg String 错误消息 最小长度:1 最大长度:512 error_details String 具体错误消息 最小长度:1 最大长度:1024 request_id String 请求处理ID 最小长度:1 最大长度:128 状态码: 404 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:128 error_msg String 错误消息 最小长度:1 最大长度:512 error_details String 具体错误消息 最小长度:1 最大长度:1024 request_id String 请求处理ID 最小长度:1 最大长度:128 状态码: 500 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:128 error_msg String 错误消息 最小长度:1 最大长度:512 error_details String 具体错误消息 最小长度:1 最大长度:1024 request_id String 请求处理ID 最小长度:1 最大长度:128
  • 响应示例 状态码: 400 { "error_code" : "EG.00014000", "error_msg" : "Bad request" } 状态码: 401 { "error_code" : "EG.00014010", "error_msg" : "Incorrect token or token resolution failed" } 状态码: 403 { "error_code" : "EG.00014030", "error_msg" : "No permissions to request this method" } 状态码: 404 { "error_code" : "EG.00014040", "error_msg" : "Not request resource found" } 状态码: 500 { "error_code" : "EG.00015000", "error_msg" : "Internal Server Error" }
  • URI GET /v1/{project_id}/subscriptions/obsbuckets 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户项目ID 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量,表示从此偏移量开始查询,偏移量不能小于0 最小值:0 最大值:100 缺省值:0 limit 否 Integer 每页显示的条目数量,不能小于1或大于1000 最小值:1 最大值:1000 缺省值:15 sort 否 String 指定查询排序 缺省值:created_time:DESC
  • URI POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/data/download 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,您可以从获取项目ID中获取。 最小长度:1 最大长度:128 eihealth_project_id 是 String 医疗智能体平台项目ID,您可以在EIHealth平台单击所需的项目名称,进入项目设置页面查看。 最小长度:1 最大长度:128