云服务器内容精选

  • 请求参数 字段名 类型 约束 说明 Bucket String 必选 桶名。 Key String 必选 对象名。 RequestDate String 或 Date 可选 指定请求时间。 说明: 当为String类型时,必须符合ISO8601或RFC822规范。 PartNumber Number 必选 段号,取值范围:[1,10000]。 UploadId String 必选 分段上传任务的ID。 CopySource String 必选 指定源桶、源对象和源对象版本号(可为空)的参数,格式:源桶名/源对象名?versionId=源对象版本号。 CopySourceRange String 可选 指定复制源对象的范围,取值区间:[0,源对象长度-1],格式:bytes=x-y。如果CopySourceRange的最大长度超出源对象长度-1,仍旧取源对象长度-1。 SseC String 可选 以SSE-C方式加密目标段,支持的值: AES256 SseCKey String 可选 SSE-C方式下加密目标段的密钥,由AES256算法算出。 CopySourceSseC String 可选 以SSE-C方式解密源对象,支持的值: AES256 CopySourceSseCKey String 可选 SSE-C方式下解密源对象的密钥,由AES256算法算出。
  • 返回结果(InterfaceResult) 字段名 类型 说明 RequestId String OBS服务端返回的请求ID。 Deleteds Array 删除成功的对象列表。 Key String 删除成功的对象名。 VersionId String 删除成功的对象版本号。 DeleteMarker String 标识删除的对象是否是删除标记。 DeleteMarkerVersionId String 删除标记的版本号。 Errors Array 删除失败的对象列表。 Key String 删除失败的对象名。 VersionId String 删除失败的对象版本号。 Code String 删除失败的错误码。 Message String 删除失败的错误消息。
  • 请求参数 字段名 类型 约束 说明 Bucket String 必选 桶名。 Key String 必选 对象名。 RequestDate String 或 Date 可选 指定请求时间。 说明: 当为String类型时,必须符合ISO8601或RFC822规范。 VersionId String 可选 待恢复归档存储对象的版本号。 Days Number 必选 恢复对象的保存时间(单位:天),取值范围:[1, 30]。 Tier String 可选 恢复选项。
  • 请求参数 字段名 类型 约束 说明 Bucket String 必选 桶名。 RequestDate String 或 Date 可选 指定请求时间。 说明: 当为String类型时,必须符合ISO8601或RFC822规范。 Objects Array 必选 待删除的对象列表。 Key String 必选 待删除对象的名称。 VersionId String 可选 待删除对象的版本号。 Quiet Boolean 可选 批量删除对象的响应方式,false表示详细模式,返回删除成功和删除失败的所有结果;true表示简单模式,只返回删除过程中出错的结果。
  • 权限类型 访问方式 类型 说明 ObsClient.enums.PermissionRead String 如果有桶的读权限,则可以获取该桶内对象列表、桶内多段任务、桶的元数据、桶的多版本。 如果有对象的读权限,则可以获取该对象内容和元数据。 ObsClient.enums.PermissionWrite String 如果有桶的写权限,则可以上传、覆盖和删除该桶内任何对象和段。 此权限在对象上不适用。 ObsClient.enums.PermissionReadAcp String 如果有读ACP的权限,则可以获取对应的桶或对象的权限控制列表(ACL)。 桶或对象的所有者永远拥有读对应桶或对象ACP的权限。 ObsClient.enums.PermissionWriteAcp String 如果有写ACP的权限,则可以更新对应桶或对象的权限控制列表(ACL)。 桶或对象的所有者永远拥有写对应桶或对象的ACP的权限。 拥有了写ACP的权限,由于可以更改权限控制策略,实际上意味着拥有了完全访问的权限。 ObsClient.enums.PermissionFullControl String 如果有桶的完全控制权限意味着拥有PermissionRead、PermissionWrite、PermissionReadAcp和PermissionWriteAcp的权限。 如果有对象的完全控制权限意味着拥有PermissionRead、PermissionReadAcp和PermissionWriteAcp的权限。 父主题: 预定义常量
  • 返回结果(InterfaceResult) 字段名 类型 说明 RequestId String OBS服务端返回的请求ID。 Owner Object 桶的所有者。 ID String 桶所有者的DomainId。 Name String 桶所有者的名字。 Grants Array 被授权用户权限信息列表。 Grantee Object 被授权用户。 Name String 被授权用户的名字,当用户类型是Group时为空。 ID String 被授权用户的DomainId,当用户类型是Group时为空。 URI String 被授权的用户组,当用户类型是CanonicalUser时为空。 Permission String 被授予的权限。 Delivered String 桶内对象ACL是否继承桶的ACL。
  • 请求参数 字段名 类型 约束 说明 Bucket String 必选 桶名。 Key String 必选 对象名。 RequestDate String 或 Date 可选 指定请求时间。 说明: 当为String类型时,必须符合ISO8601或RFC822规范。 Position Number 必选 追加上传的位置,第一次追加上传时必须为0。 ACL String 可选 创建对象时可指定的预定义访问策略。 StorageClass String 可选 创建对象时可指定的对象的存储类型。 Body String 可选 待上传对象的内容。 SourceFile File 或 Blob 可选 待上传的文件(浏览器必须支持FileReader)。 ProgressCallback Function 可选 获取上传进度的回调函数。 说明: 该回调函数依次包含三个参数:已上传的字节数、总字节数、已使用的时间(单位:秒)。 Offset Number 可选 当设置了SourceFile时有效,代表源文件中某一分段的起始偏移大小,默认值为0, 单位为字节。 Metadata Object 可选 待上传对象的自定义元数据。 WebsiteRedirectLocation String 可选 当桶设置了Website配置,该参数指明对象的重定向地址。 Expires Number 可选 待上传对象的生命周期,单位:天。 SuccessActionRedirect String 可选 上传对象成功后的重定向的地址。 ContentType String 可选 待上传对象的MIME类型。 ContentLength Number 可选 当设置了SourceFile时有效,代表待上传对象数据的长度。 ContentMD5 String 可选 待上传对象数据的MD5值(经过Base64编码),提供给OBS服务端,校验数据完整性。 SseKms String 可选 以SSE-KMS方式加密对象,支持的值: kms SseKmsKey String 可选 SSE-KMS方式下加密的主密钥,可为空。 SseC String 可选 以SSE-C方式加密对象,支持的值: AES256 SseCKey Buffer 可选 SSE-C方式下加密的密钥,由AES256算法得到。 Body与SourceFile不能同时使用。 当Body与SourceFile都为空时,上传对象的大小为0字节。
  • 返回结果(InterfaceResult) 字段名 类型 说明 RequestId String OBS服务端返回的请求ID。 ETag String 目标对象的ETag值。 LastModified String 目标对象的最近一次修改时间。 VersionId String 目标对象的版本号,如果目标桶未开启多版本状态则该值为空。 CopySourceVersionId String 源对象的版本号,如果源桶未开启多版本状态则该值为空。
  • 请求参数 字段名 类型 约束 说明 Bucket String 必选 目标桶名。 Key String 必选 目标对象名。 RequestDate String 或 Date 可选 指定请求时间。 说明: 当为String类型时,必须符合ISO8601或RFC822规范。 ACL String 可选 创建对象时可指定的预定义访问策略。 StorageClass String 可选 创建对象时可指定的对象的存储类型。 CopySource String 必选 指定源桶、源对象和源对象版本号(可为空)的参数,格式:源桶名/源对象名?versionId=源对象版本号。 CopySourceIfMatch String 可选 如果源对象的ETag值与该参数值相同,则进行复制,否则返回异常码。 CopySourceIfModifiedSince String 可选 如果源对象的修改时间晚于该参数值指定的时间,则进行复制,否则返回异常码。该参数值必须符合http://www.ietf.org/rfc/rfc2616.txt规定的HTTP时间格式。 CopySourceIfNoneMatch String 可选 如果源对象的ETag值与该参数值不相同,则进行复制,否则返回异常码。 CopySourceIfUnmodifiedSince String 可选 如果源对象的修改时间早于该参数值指定的时间,则进行复制,否则返回异常码。该参数值必须符合http://www.ietf.org/rfc/rfc2616.txt规定的HTTP时间格式。 CacheControl String 可选 复制时重写响应中的Cache-Control头。 ContentDisposition String 可选 复制时重写响应中的Content-Disposition头。 ContentEncoding String 可选 复制时重写响应中的Content-Encoding头。 ContentLanguage String 可选 复制时重写响应中的Content-Language头。 ContentType String 可选 复制时重写响应中的Content-Type头。 Expires String 可选 复制时重写响应中的Expires头。 MetadataDirective String 可选 复制策略。 Metadata Object 可选 目标对象的自定义元数据。 WebsiteRedirectLocation String 可选 当桶设置了Website配置,该参数指明对象的重定向地址。 SseKms String 可选 以SSE-KMS方式加密目标对象,支持的值: kms SseKmsKey String 可选 SSE-KMS方式下加密目标对象的主密钥,可为空。 SseC String 可选 以SSE-C方式加密目标对象,支持的值: AES256 SseCKey String 可选 SSE-C方式下加密目标对象的密钥,由AES256算法算出。 CopySourceSseC String 可选 以SSE-C方式解密源对象,支持的值: AES256 CopySourceSseCKey String 可选 SSE-C方式下解密源对象的密钥,由AES256算法算出。 如果包含CopySourceIfUnmodifiedSince并且不符合,或者包含CopySourceIfMatch并且不符合,或者包含CopySourceIfModifiedSince并且不符合,或者包含CopySourceIfNoneMatch并且不符合,抛出异常中HTTP状态码为:412 precondition failed。 CopySourceIfModifiedSince和CopySourceIfNoneMatch可以一起使用;CopySourceIfUnmodifiedSince和CopySourceIfMatch可以一起使用。
  • 请求参数 字段名 类型 约束 说明 Bucket String 必选 桶名。 RequestDate String 或 Date 可选 指定请求时间。 说明: 当为String类型时,必须符合ISO8601或RFC822规范。 ACL String 可选 预定义访问策略。 Owner Object 可选 桶的所有者。 ID String 必选 桶所有者的DomainId。 Grants Array 可选 被授权用户权限信息列表。 Grantee Object 必选 被授权用户。 Type String 必选 被授权的用户类型。 ID String 如果Type为“CanonicalUser”则必选,否则必须为空 被授权用户的DomainId。 URI String 如果Type为“Group”则必选,否则必须为空 被授权的用户组。 Permission String 必选 被授予的权限。 Delivered Boolean 可选 桶内对象ACL是否继承桶的ACL。 Owner和Grants必须配套使用,且与ACL互斥。当设置了这两个字段时,不能设置ACL;反之,当设置了ACL时,不能设置Owner和Grants。 Owner、Grants与ACL不能全为空。
  • 返回结果(InterfaceResult) 字段名 类型 说明 RequestId String OBS服务端返回的请求ID。 Size String 桶的空间大小。 ObjectNumber String 桶内对象个数。 StandardSize String 返回标准存储类型存量大小 StandardObjectNumber String 返回标准存储类型对象个数 WarmSize String obs请求时返回低频存储类型存量大小 WarmObjectNumber String obs请求时返回低频存储类型对象个数 ColdSize String obs请求时返回归档存储类型存量大小 ColdObjectNumber String obs请求时返回归档存储类型对象个数 DeepArchiveSize String 返回深度归档存储类型存量大小 DeepArchiveObjectNumber String 返回深度归档存储类型对象个数 HighPerformanceSize String 返回高性能存储类型存量大小 HighPerformanceObjectNumber String 返回高性能存储类型对象个数 Standard_IASize String s3请求时返回低频存储类型存量大小 Standard_IAObjectNumber String s3请求时返回低频存储类型对象个数 GlacierSize String s3请求时返回归档存储类型存量大小 GlacierObjectNumber String s3请求时返回归档存储类型对象个数
  • 请求参数 字段名 类型 约束 说明 Bucket String 必选 桶名。 RequestDate String 或 Date 可选 指定请求时间。 说明: 当为String类型时,必须符合ISO8601或RFC822规范。 Delimiter String 可选 用于对分段上传任务中的对象名进行分组的字符。对于对象名中包含Delimiter的任务,其对象名(如果请求中指定了Prefix,则此处的对象名需要去掉Prefix)中从首字符至第一个Delimiter之间的字符串将作为一个分组并作为CommonPrefix返回。 Prefix String 可选 限定返回的分段上传任务中的对象名必须带有Prefix前缀。 MaxUploads Number 可选 列举分段上传任务的最大数目,取值范围为1~1000,当超出范围时,按照默认的1000进行处理。 KeyMarker String 可选 表示列举时返回指定的KeyMarker之后的分段上传任务。 UploadIdMarker String 可选 只有与KeyMarker参数一起使用时才有意义,用于指定返回结果的起始位置,即列举时返回指定KeyMarker的UploadIdMarker之后的分段上传任务。
  • 返回结果(InterfaceResult) 字段名 类型 说明 RequestId String OBS服务端返回的请求ID。 Bucket String 桶名。 KeyMarker String 列举分段上传任务的起始位置,与请求中的该参数对应。 UploadIdMarker String 列举分段上传任务的起始位置(UploadId标识),与请求中的该参数对应。 NextKeyMarker String 下次列举分段上传任务请求的起始位置。 NextUploadIdMarker String 下次列举分段上传任务请求的起始位置(UploadId标识),与NextKeyMarker配合使用。 Delimiter String 用于对分段上传任务中的对象名进行分组的字符,与请求中的该参数对应。 Prefix String 分段上传任务中的对象名前缀,与请求中的该参数对应。 MaxUploads String 列举分段上传任务的最大数目,与请求中的该参数对应。 IsTruncated String 表明本次请求是否返回了全部结果,“true”表示没有返回全部结果;“false”表示已返回了全部结果。 Uploads Array 分段上传任务列表。 Key String 分段上传任务的对象名。 UploadId String 分段上传任务的ID。 Initiator Object 分段上传任务的创建者。 ID String 创建者的DomainId。 Owner Object 和Initiator相同,代表分段上传任务的创建者。 ID String 创建者的DomainId。 Initiated String 分段上传任务的初始化时间。 StorageClass String 分段上传对象的存储类型。 CommonPrefixes Array 当请求中设置了Delimiter分组字符时,返回按Delimiter分组后的对象名称前缀列表。 Prefix String 按Delimiter分组后的对象名称前缀。
  • 请求参数 字段名 类型 约束 说明 Bucket String 必选 桶名。 Key String 必选 对象名。 RequestDate String 或 Date 可选 指定请求时间。 说明: 当为String类型时,必须符合ISO8601或RFC822规范。 ACL String 可选 创建对象时可指定的预定义访问策略。 StorageClass String 可选 创建对象时可指定的对象的存储类型。 Body String 可选 待上传对象的内容。 SourceFile File 或 Blob 可选 待上传的文件(浏览器必须支持FileReader)。 ProgressCallback Function 可选 获取上传进度的回调函数。 说明: 该回调函数依次包含三个参数:已上传的字节数、总字节数、已使用的时间(单位:秒)。 Offset Number 可选 当设置了SourceFile时有效,代表源文件中某一分段的起始偏移大小,默认值为0, 单位为字节。 Metadata Object 可选 待上传对象的自定义元数据。 WebsiteRedirectLocation String 可选 当桶设置了Website配置,该参数指明对象的重定向地址。 Expires Number 可选 待上传对象的生命周期,单位:天。 SuccessActionRedirect String 可选 上传对象成功后的重定向的地址。 ContentType String 可选 待上传对象的MIME类型。 ContentLength Number 可选 当设置了SourceFile时有效,代表待上传对象数据的长度。 ContentMD5 String 可选 待上传对象数据的MD5值(经过Base64编码),提供给OBS服务端,校验数据完整性。 SseKms String 可选 以SSE-KMS方式加密对象,支持的值: kms SseKmsKey String 可选 SSE-KMS方式下加密的主密钥,可为空。 SseC String 可选 以SSE-C方式加密对象,支持的值: AES256 SseCKey String 可选 SSE-C方式下加密的密钥,由AES256算法得到。 Body与SourceFile不能同时使用。 当Body与SourceFile都为空时,上传对象的大小为0字节。
  • 返回结果(InterfaceResult) 字段名 类型 说明 RequestId String OBS服务端返回的请求ID。 ETag String 对象的ETag值。 VersionId String 对象的版本号。 StorageClass String 对象的存储类型,当对象存储类型是标准存储时,该值为空。 SseKms String SSE-KMS方式的算法。 SseKmsKey String SSE-KMS加密方式下使用的KMS主密钥的ID值。 SseC String SSE-C方式的算法。 SseCKeyMd5 String SSE-C方式下加密使用密钥的MD5值,该值用于验证密钥传输过程中是否出错。