huaweicloudsdkobs 3.1.76__py2.py3-none-any.whl → 3.1.78__py2.py3-none-any.whl

Sign up to get free protection for your applications and to get access to all the features.
Files changed (50) hide show
  1. huaweicloudsdkobs/v1/__init__.py +0 -1
  2. huaweicloudsdkobs/v1/model/__init__.py +0 -1
  3. huaweicloudsdkobs/v1/model/bucket.py +15 -15
  4. huaweicloudsdkobs/v1/model/contents.py +18 -18
  5. huaweicloudsdkobs/v1/model/copy_object_request.py +78 -78
  6. huaweicloudsdkobs/v1/model/copy_object_response.py +3 -3
  7. huaweicloudsdkobs/v1/model/create_bucket_request.py +51 -51
  8. huaweicloudsdkobs/v1/model/create_bucket_request_body.py +3 -3
  9. huaweicloudsdkobs/v1/model/delete_bucket_customdomain_request.py +9 -9
  10. huaweicloudsdkobs/v1/model/delete_bucket_request.py +6 -6
  11. huaweicloudsdkobs/v1/model/delete_object.py +6 -6
  12. huaweicloudsdkobs/v1/model/delete_object_request.py +12 -12
  13. huaweicloudsdkobs/v1/model/delete_objects_request.py +12 -12
  14. huaweicloudsdkobs/v1/model/delete_objects_request_body.py +6 -6
  15. huaweicloudsdkobs/v1/model/delete_objects_response.py +3 -3
  16. huaweicloudsdkobs/v1/model/delete_result_deleted.py +12 -12
  17. huaweicloudsdkobs/v1/model/delete_result_error.py +9 -9
  18. huaweicloudsdkobs/v1/model/domains.py +9 -9
  19. huaweicloudsdkobs/v1/model/filter_rule.py +6 -6
  20. huaweicloudsdkobs/v1/model/function_stage_configuration.py +12 -12
  21. huaweicloudsdkobs/v1/model/get_bucket_acl_request.py +9 -9
  22. huaweicloudsdkobs/v1/model/get_bucket_customdomain_request.py +9 -9
  23. huaweicloudsdkobs/v1/model/get_bucket_customdomain_response.py +5 -9
  24. huaweicloudsdkobs/v1/model/get_bucket_metadata_request.py +12 -12
  25. huaweicloudsdkobs/v1/model/get_bucket_notification_request.py +9 -9
  26. huaweicloudsdkobs/v1/model/get_object_metadata_request.py +33 -33
  27. huaweicloudsdkobs/v1/model/get_object_request.py +60 -60
  28. huaweicloudsdkobs/v1/model/grant.py +6 -6
  29. huaweicloudsdkobs/v1/model/grantee.py +6 -6
  30. huaweicloudsdkobs/v1/model/list_buckets_request.py +6 -6
  31. huaweicloudsdkobs/v1/model/list_buckets_response.py +4 -4
  32. huaweicloudsdkobs/v1/model/list_objects_request.py +27 -27
  33. huaweicloudsdkobs/v1/model/list_objects_response.py +27 -27
  34. huaweicloudsdkobs/v1/model/owner.py +3 -3
  35. huaweicloudsdkobs/v1/model/put_object_request.py +60 -60
  36. huaweicloudsdkobs/v1/model/set_bucket_acl_request.py +12 -12
  37. huaweicloudsdkobs/v1/model/set_bucket_custom_domain_body.py +15 -15
  38. huaweicloudsdkobs/v1/model/set_bucket_customedomain_request.py +9 -9
  39. huaweicloudsdkobs/v1/model/set_bucket_notification_request.py +9 -9
  40. huaweicloudsdkobs/v1/model/topic_configuration.py +9 -9
  41. huaweicloudsdkobs/v1/obs_async_client.py +543 -557
  42. huaweicloudsdkobs/v1/obs_client.py +543 -557
  43. huaweicloudsdkobs/v1/region/obs_region.py +4 -8
  44. {huaweicloudsdkobs-3.1.76.dist-info → huaweicloudsdkobs-3.1.78.dist-info}/METADATA +2 -2
  45. huaweicloudsdkobs-3.1.78.dist-info/RECORD +70 -0
  46. huaweicloudsdkobs/v1/model/buckets.py +0 -117
  47. huaweicloudsdkobs-3.1.76.dist-info/RECORD +0 -71
  48. {huaweicloudsdkobs-3.1.76.dist-info → huaweicloudsdkobs-3.1.78.dist-info}/LICENSE +0 -0
  49. {huaweicloudsdkobs-3.1.76.dist-info → huaweicloudsdkobs-3.1.78.dist-info}/WHEEL +0 -0
  50. {huaweicloudsdkobs-3.1.76.dist-info → huaweicloudsdkobs-3.1.78.dist-info}/top_level.txt +0 -0
@@ -70,45 +70,45 @@ class PutObjectRequest(SdkStreamRequest):
70
70
 
71
71
  The model defined in huaweicloud sdk
72
72
 
73
- :param bucket_name: 桶名称
73
+ :param bucket_name: Name of the bucket.
74
74
  :type bucket_name: str
75
- :param object_key: 通过此请求创建的对象名称。
75
+ :param object_key: Object key for which this operation was initiated.
76
76
  :type object_key: str
77
- :param date: 请求发起端的日期和时间,例如:Wed, 27 Jun 2018 13:39:15 +0000 默认值:无。 条件:如果消息头中带了x-obs-date字段,则可以不带该字段,其他情况下必选。
77
+ :param date: Time when a request was initiated, for example, **Wed, 27 Jun 2018 13:39:15 +0000**. Default value: none Restriction: This header is optional if the **x-obs-date** header is contained in the request, but mandatory in other circumstances.
78
78
  :type date: str
79
- :param content_md5: 按照RFC 1864标准计算出消息体的MD5摘要字符串,即消息体128-bit MD5值经过base64编码后得到的字符串 示例:n58IG6hfM7vqI4K0vnWpog==。
79
+ :param content_md5: Base64-encoded 128-bit MD5 digest of the message according to RFC 1864. Example: n58IG6hfM7vqI4K0vnWpog==
80
80
  :type content_md5: str
81
- :param x_obs_acl: 创建对象时,可以加上此消息头设置对象的权限控制策略,使用的策略为预定义的常用策 示例:x-obs-acl: public-read
81
+ :param x_obs_acl: When creating a bucket, you can add this header to configure access control policies (predefined policies) for the bucket. Example: x-obs-acl: public-read
82
82
  :type x_obs_acl: str
83
- :param x_obs_grant_read: 创建对象时,使用此头域授权租户下所有用户有读对象和获取对象元数据的权限 示例:x-obs-grant-read: id=domainID。如果授权给多个租户,需要通过','分割。
83
+ :param x_obs_grant_read: When creating an object, you can use this header to grant all users under a tenant the permissions to read the object and obtain the object metadata. Example: x-obs-grant-read: id=domainID. If multiple tenants are authorized, separate them with commas (,).
84
84
  :type x_obs_grant_read: str
85
- :param x_obs_grant_read_acp: 创建对象时,使用此头域授权租户下所有用户有获取对象ACL的权限 示例:x-obs-grant-read-acp: id=domainID。如果授权给多个租户,需要通过','分割。
85
+ :param x_obs_grant_read_acp: When creating an object, you can use this header to grant all users under a tenant the permissions to obtain the object ACL. Example: x-obs-grant-read-acp: id=domainID. If multiple tenants are authorized, separate them with commas (,).
86
86
  :type x_obs_grant_read_acp: str
87
- :param x_obs_grant_write_acp: 创建对象时,使用此头域授权租户下所有用户有写对象ACL的权 示例:x-obs-grant-write-acp: id=domainID。如果授权给多个租户,需要通过','分割。
87
+ :param x_obs_grant_write_acp: When creating an object, you can use this header to grant all users under a tenant the permissions to write the object ACL. Example: x-obs-grant-write-acp: id=domainID. If multiple tenants are authorized, separate them with commas (,).
88
88
  :type x_obs_grant_write_acp: str
89
- :param x_obs_grant_full_control: 创建对象时,使用此头域授权domain下所有用户有读对象、获取对象元数据、获取对象ACL、写对象ACL的权限 示例:x-obs-grant-full-control: id=domainID。如果授权给多个租户,需要通过','分割。
89
+ :param x_obs_grant_full_control: When creating an object, you can use this header to grant all users in a domain the permissions to read the object, to obtain the object metadata and ACL, and to write the object ACL. Example: x-obs-grant-full-control: id=domainID. If multiple tenants are authorized, separate them with commas (,).
90
90
  :type x_obs_grant_full_control: str
91
- :param x_obs_storage_class: 创建对象时,可以加上此头域设置对象的存储类型。如果未设置此头域,则以桶的默认存储类型作为对象的存储类型 说明:存储类型有3种:STANDARD(标准存储)、WARM(低频访问存储)、COLD(归档存储)。因此这里可配置的值有:STANDARDWARMCOLD,注意大小写敏感。 示例:x-obs-storage-class: STANDARD
91
+ :param x_obs_storage_class: When creating an object, you can use this header to specify a storage class for the object. If you do not have this header configured, the object inherits the default storage class of the bucket.Note: There are three storage classes: Standard (STANDARD), Infrequent Access (WARM), and Archive (COLD), so the value can be **STANDARD**, **WARM**, or **COLD**. The value is case sensitive.Example: x-obs-storage-class: STANDARD
92
92
  :type x_obs_storage_class: str
93
- :param x_obs_meta_xxx: 用户自定义元数据 示例:x-obs-meta-test: test metadata
93
+ :param x_obs_meta_xxx: User-defined metadata. Example: x-obs-meta-test: test metadata
94
94
  :type x_obs_meta_xxx: str
95
- :param x_obs_persistent_headers: 创建对象时,可以在HTTP请求中加入“x-obs-persistent-headers”消息头,用来加入一个或多个自定义的响应头,当用户获取此对象或查询此对象元数据时,加入的自定义响应头将会在返回消息的头域中出现。 格式:x-obs-persistent-headers: key1:base64_encode(value1),key2:base64_encode(value2).... 说明:其中key1/key2等为自定义header,若含有非ASCII码或不可识别字符,可以采用URL编码或者Base64编码,服务端只会作为字符串处理,不会做解码。value1/value2等为对应自定义header的值,base64_encode指做base64编码,即将自定义header和对应值的base64编码作为一个key-value对用“:”连接,然后用“,”将所有的key-value对连接起来,放在x-obs-persistent-headers这个header中即可,服务端会对上传的value做解码处理。 示例: x-obs-persistent-headers: key1:dmFsdWUx,key2:dmFsdWUy 下载此对象或获取此对象元数据时:返回两个头域分别为“key1:value1”与“key2:value2” 约束: 1. 通过该方式指定的自定义响应头不能以“x-obs-”为前缀,比如可以指定“key1”,但是不能指定“x-obs-key1” 2. 不能指定http标准头,例如host/content-md5/origin/range/Content-Disposition等 3. 此头域和自定义元数据总长度不能超过8KB 4. 如果传入相同key,将value以“,”拼接后放入同一个key中返回
95
+ :param x_obs_persistent_headers: When creating an object, you can add the **x-obs-persistent-headers** header in an HTTP request to customize one or more response headers. When you retrieve the object or query the object metadata, the custom headers will be returned in the response message.Format: **x-obs-persistent-headers: ****key1:base64_encode(***value1***),****key2:base64_encode(***value2***)...**Note: Items, such as **key1** and **key2**, are user-defined headers. If they contain non-ASCII or unrecognizable characters, they can be encoded using URL or Base64. The server processes these headers as strings, but does not decode them. Items, such as *value1* and *value2* are the values of the corresponding headers. **base64_encode** indicates that the value is encoded using Base64. A user-defined header and its Base64-encoded value are connected using a colon (:) to form a key-value pair. All key-value pairs are separated with a comma (,) and are placed in the **x-obs-persistent-headers** header. The server then decodes the uploaded value.Example: x-obs-persistent-headers: key1:dmFsdWUx,key2:dmFsdWUyWhen you download the object or obtain the object metadata, headers **key1:***value1* and **key2:***value2* will be returned.Restrictions:+ Response headers customized in this way cannot be prefixed with **x-obs-**. For example, you should use **key1**, instead of **x-obs-key1**.+ Standard HTTP headers, such as **host**, **content-md5**, **origin**, **range**, and **Content-Disposition**, cannot be specified as custom headers.+ The total length of this header and the custom metadata cannot exceed 8 KB.+ If the same keys are transferred, values are separated with commas (,) and then returned in one key.
96
96
  :type x_obs_persistent_headers: str
97
- :param x_obs_website_redirect_location: 当桶设置了Website配置,可以将获取这个对象的请求重定向到桶内另一个对象或一个外部的URLOBS将这个值从头域中取出,保存在对象的元数据中。 例如,重定向请求到桶内另一对象: x-obs-website-redirect-location:/anotherPage.html 或重定向请求到一个外部URLx-obs-website-redirect-location:http://www.example.com/ 默认值:无 约束:必须以“/”、“http://”或“https://”开头,长度不超过2KB。
97
+ :param x_obs_website_redirect_location: If static website hosting has been configured for a bucket, you can configure this parameter to redirect requests for an object in this bucket to another object in the same bucket or to an external URL. OBS stores the value of this header in the object metadata.Example of redirecting requests to another object in the bucket:x-obs-website-redirect-location:/anotherPage.htmlExample of redirecting requests to an external URL:x-obs-website-redirect-location:http://www.example.com/Default value: noneRestriction: The value must start with a slash (/), **http://**, or **https://**, with a length of no more than 2 KB.
98
98
  :type x_obs_website_redirect_location: str
99
- :param x_obs_server_side_encryption: 使用该头域表示服务端加密是SSE-KMS方式。 示例:x-obs-server-side-encryption: kms
99
+ :param x_obs_server_side_encryption: Indicates that SSE-KMS is used. Example: x-obs-server-side-encryption: kms
100
100
  :type x_obs_server_side_encryption: str
101
- :param x_obs_server_side_encryption_kms_key_id: SSE-KMS方式下使用该头域,该头域表示主密钥,如果用户没有提供该头域,那么默认的主密钥将会被使用。 支持两种格式的描述方式: 1. regionID:domainID(租户ID):key/key_id 或者 2.key_id 其中regionID是使用密钥所属region的ID;domainID是使用密钥所属租户的租户IDkey_id是从数据加密服务创建的密钥ID。 示例: 1. x-obs-server-side-encryption-kms-key-id: cn-north-4:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0 或者 2. x-obs-server-side-encryption-kms-key-id: 4f1cd4de-ab64-4807-920a-47fc42e7f0d0
101
+ :param x_obs_server_side_encryption_kms_key_id: Master key ID. This header is used for encryption with SSE-KMS. If the customer does not provide the master key ID, the default master key ID will be used.Supported formats:+ *regionID***:***domainID***:key/***key_id* + *key_id**regionID* is the ID of the region to which the key belongs. *domainID* is the account ID of the tenant to which the key belongs. *key_id* is the key ID created in DEW.Examples:+ x-obs-server-side-encryption-kms-key-id:cn-north-4:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0 + x-obs-server-side-encryption-kms-key-id:4f1cd4de-ab64-4807-920a-47fc42e7f0d0
102
102
  :type x_obs_server_side_encryption_kms_key_id: str
103
- :param x_obs_server_side_encryption_customer_algorithm: SSE-C方式下使用该头域,该头域表示加密使用的算法。 示例:x-obs-server-side-encryption-customer-algorithm: AES256 约束:需要和x-obs-server-side-encryption-customer-key x-obs-server-side-encryption-customer-key-MD5一起使用。
103
+ :param x_obs_server_side_encryption_customer_algorithm: The encryption algorithm used for SSE-C.Example: x-obs-server-side-encryption-customer-algorithm:AES256Restriction: This header must be used together with **x-obs-server-side-encryption-customer-key** and **x-obs-server-side-encryption-customer-key-MD5**.
104
104
  :type x_obs_server_side_encryption_customer_algorithm: str
105
- :param x_obs_server_side_encryption_customer_key: SSE-C方式下使用该头域,该头域表示加密使用的密钥。该密钥用于加密对象 示例:x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw= 约束:该头域由256-bit的密钥经过base64-encoded得到,需要和x-obs-server-side-encryption-customer-algorithmx-obs-server-side-encryption-customer-key-MD5一起使用。
105
+ :param x_obs_server_side_encryption_customer_key: Encryption key used for SSE-C. This key is used to encrypt objects.Example: x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=Restriction: This header is a Base64-encoded 256-bit key and must be used together with **x-obs-server-side-encryption-customer-algorithm** and **x-obs-server-side-encryption-customer-key-MD5**.
106
106
  :type x_obs_server_side_encryption_customer_key: str
107
- :param x_obs_server_side_encryption_customer_key_md5: SSE-C方式下使用该头域,该头域表示加密使用的密钥的MD5值。MD5值用于验证密钥传输过程中没有出错。 示例:x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ== 约束: 该头域由密钥的128-bit MD5值经过base64-encoded得到,需要和x-obs-server-side-encryption-customer-algorithmx-obs-server-side-encryption-customer-key一起使用。
107
+ :param x_obs_server_side_encryption_customer_key_md5: MD5 value of the key used to encrypt objects in SSE-C mode. The MD5 value is used to check whether any error occurs during the transmission of the key. Example: x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==Restriction: This header is a Base64-encoded 128-bit MD5 value and must be used together with **x-obs-server-side-encryption-customer-algorithm** and **x-obs-server-side-encryption-customer-key**.
108
108
  :type x_obs_server_side_encryption_customer_key_md5: str
109
- :param success_action_redirect: 此参数的值是一个URL,用于指定当此次请求操作成功响应后的重定向的地址。 如果此参数值有效且操作成功,响应码为303Location头域由此参数以及桶名、对象名、对象的ETag组成。 如果此参数值无效,则OBS忽略此参数的作用,响应码为204Location头域为对象地址。
109
+ :param success_action_redirect: The address (a URL) which a successfully responded request is redirected to. If this parameter value is valid and the request succeeds, OBS returns status code 303. The **Location** header consists of **success_action_redirect** as well as the bucket name, object name, and object ETag. If this parameter is invalid, OBS ignores this parameter and returns status code 204. In such case, the **Location** header is the object address.
110
110
  :type success_action_redirect: str
111
- :param x_obs_expires: 表示对象的过期时间,单位是天。过期之后对象会被自动删除。(从对象最后修改时间开始计算) 此字段对于每个对象仅支持上传时配置,不支持后期通过修改元数据接口修改。 示例:x-obs-expires:3
111
+ :param x_obs_expires: When an object expires. It is measured in days. An object will be automatically deleted once it expires. The expiration is calculated from when the object was last modified. This header can be only configured during the object upload, and cannot be modified later by using the metadata API. Example: x-obs-expires:3
112
112
  :type x_obs_expires: int
113
113
  """
114
114
  super(PutObjectRequest, self).__init__(stream)
@@ -179,7 +179,7 @@ class PutObjectRequest(SdkStreamRequest):
179
179
  def bucket_name(self):
180
180
  """Gets the bucket_name of this PutObjectRequest.
181
181
 
182
- 桶名称
182
+ Name of the bucket.
183
183
 
184
184
  :return: The bucket_name of this PutObjectRequest.
185
185
  :rtype: str
@@ -190,7 +190,7 @@ class PutObjectRequest(SdkStreamRequest):
190
190
  def bucket_name(self, bucket_name):
191
191
  """Sets the bucket_name of this PutObjectRequest.
192
192
 
193
- 桶名称
193
+ Name of the bucket.
194
194
 
195
195
  :param bucket_name: The bucket_name of this PutObjectRequest.
196
196
  :type bucket_name: str
@@ -201,7 +201,7 @@ class PutObjectRequest(SdkStreamRequest):
201
201
  def object_key(self):
202
202
  """Gets the object_key of this PutObjectRequest.
203
203
 
204
- 通过此请求创建的对象名称。
204
+ Object key for which this operation was initiated.
205
205
 
206
206
  :return: The object_key of this PutObjectRequest.
207
207
  :rtype: str
@@ -212,7 +212,7 @@ class PutObjectRequest(SdkStreamRequest):
212
212
  def object_key(self, object_key):
213
213
  """Sets the object_key of this PutObjectRequest.
214
214
 
215
- 通过此请求创建的对象名称。
215
+ Object key for which this operation was initiated.
216
216
 
217
217
  :param object_key: The object_key of this PutObjectRequest.
218
218
  :type object_key: str
@@ -223,7 +223,7 @@ class PutObjectRequest(SdkStreamRequest):
223
223
  def date(self):
224
224
  """Gets the date of this PutObjectRequest.
225
225
 
226
- 请求发起端的日期和时间,例如:Wed, 27 Jun 2018 13:39:15 +0000 默认值:无。 条件:如果消息头中带了x-obs-date字段,则可以不带该字段,其他情况下必选。
226
+ Time when a request was initiated, for example, **Wed, 27 Jun 2018 13:39:15 +0000**. Default value: none Restriction: This header is optional if the **x-obs-date** header is contained in the request, but mandatory in other circumstances.
227
227
 
228
228
  :return: The date of this PutObjectRequest.
229
229
  :rtype: str
@@ -234,7 +234,7 @@ class PutObjectRequest(SdkStreamRequest):
234
234
  def date(self, date):
235
235
  """Sets the date of this PutObjectRequest.
236
236
 
237
- 请求发起端的日期和时间,例如:Wed, 27 Jun 2018 13:39:15 +0000 默认值:无。 条件:如果消息头中带了x-obs-date字段,则可以不带该字段,其他情况下必选。
237
+ Time when a request was initiated, for example, **Wed, 27 Jun 2018 13:39:15 +0000**. Default value: none Restriction: This header is optional if the **x-obs-date** header is contained in the request, but mandatory in other circumstances.
238
238
 
239
239
  :param date: The date of this PutObjectRequest.
240
240
  :type date: str
@@ -245,7 +245,7 @@ class PutObjectRequest(SdkStreamRequest):
245
245
  def content_md5(self):
246
246
  """Gets the content_md5 of this PutObjectRequest.
247
247
 
248
- 按照RFC 1864标准计算出消息体的MD5摘要字符串,即消息体128-bit MD5值经过base64编码后得到的字符串 示例:n58IG6hfM7vqI4K0vnWpog==。
248
+ Base64-encoded 128-bit MD5 digest of the message according to RFC 1864. Example: n58IG6hfM7vqI4K0vnWpog==
249
249
 
250
250
  :return: The content_md5 of this PutObjectRequest.
251
251
  :rtype: str
@@ -256,7 +256,7 @@ class PutObjectRequest(SdkStreamRequest):
256
256
  def content_md5(self, content_md5):
257
257
  """Sets the content_md5 of this PutObjectRequest.
258
258
 
259
- 按照RFC 1864标准计算出消息体的MD5摘要字符串,即消息体128-bit MD5值经过base64编码后得到的字符串 示例:n58IG6hfM7vqI4K0vnWpog==。
259
+ Base64-encoded 128-bit MD5 digest of the message according to RFC 1864. Example: n58IG6hfM7vqI4K0vnWpog==
260
260
 
261
261
  :param content_md5: The content_md5 of this PutObjectRequest.
262
262
  :type content_md5: str
@@ -267,7 +267,7 @@ class PutObjectRequest(SdkStreamRequest):
267
267
  def x_obs_acl(self):
268
268
  """Gets the x_obs_acl of this PutObjectRequest.
269
269
 
270
- 创建对象时,可以加上此消息头设置对象的权限控制策略,使用的策略为预定义的常用策 示例:x-obs-acl: public-read
270
+ When creating a bucket, you can add this header to configure access control policies (predefined policies) for the bucket. Example: x-obs-acl: public-read
271
271
 
272
272
  :return: The x_obs_acl of this PutObjectRequest.
273
273
  :rtype: str
@@ -278,7 +278,7 @@ class PutObjectRequest(SdkStreamRequest):
278
278
  def x_obs_acl(self, x_obs_acl):
279
279
  """Sets the x_obs_acl of this PutObjectRequest.
280
280
 
281
- 创建对象时,可以加上此消息头设置对象的权限控制策略,使用的策略为预定义的常用策 示例:x-obs-acl: public-read
281
+ When creating a bucket, you can add this header to configure access control policies (predefined policies) for the bucket. Example: x-obs-acl: public-read
282
282
 
283
283
  :param x_obs_acl: The x_obs_acl of this PutObjectRequest.
284
284
  :type x_obs_acl: str
@@ -289,7 +289,7 @@ class PutObjectRequest(SdkStreamRequest):
289
289
  def x_obs_grant_read(self):
290
290
  """Gets the x_obs_grant_read of this PutObjectRequest.
291
291
 
292
- 创建对象时,使用此头域授权租户下所有用户有读对象和获取对象元数据的权限 示例:x-obs-grant-read: id=domainID。如果授权给多个租户,需要通过','分割。
292
+ When creating an object, you can use this header to grant all users under a tenant the permissions to read the object and obtain the object metadata. Example: x-obs-grant-read: id=domainID. If multiple tenants are authorized, separate them with commas (,).
293
293
 
294
294
  :return: The x_obs_grant_read of this PutObjectRequest.
295
295
  :rtype: str
@@ -300,7 +300,7 @@ class PutObjectRequest(SdkStreamRequest):
300
300
  def x_obs_grant_read(self, x_obs_grant_read):
301
301
  """Sets the x_obs_grant_read of this PutObjectRequest.
302
302
 
303
- 创建对象时,使用此头域授权租户下所有用户有读对象和获取对象元数据的权限 示例:x-obs-grant-read: id=domainID。如果授权给多个租户,需要通过','分割。
303
+ When creating an object, you can use this header to grant all users under a tenant the permissions to read the object and obtain the object metadata. Example: x-obs-grant-read: id=domainID. If multiple tenants are authorized, separate them with commas (,).
304
304
 
305
305
  :param x_obs_grant_read: The x_obs_grant_read of this PutObjectRequest.
306
306
  :type x_obs_grant_read: str
@@ -311,7 +311,7 @@ class PutObjectRequest(SdkStreamRequest):
311
311
  def x_obs_grant_read_acp(self):
312
312
  """Gets the x_obs_grant_read_acp of this PutObjectRequest.
313
313
 
314
- 创建对象时,使用此头域授权租户下所有用户有获取对象ACL的权限 示例:x-obs-grant-read-acp: id=domainID。如果授权给多个租户,需要通过','分割。
314
+ When creating an object, you can use this header to grant all users under a tenant the permissions to obtain the object ACL. Example: x-obs-grant-read-acp: id=domainID. If multiple tenants are authorized, separate them with commas (,).
315
315
 
316
316
  :return: The x_obs_grant_read_acp of this PutObjectRequest.
317
317
  :rtype: str
@@ -322,7 +322,7 @@ class PutObjectRequest(SdkStreamRequest):
322
322
  def x_obs_grant_read_acp(self, x_obs_grant_read_acp):
323
323
  """Sets the x_obs_grant_read_acp of this PutObjectRequest.
324
324
 
325
- 创建对象时,使用此头域授权租户下所有用户有获取对象ACL的权限 示例:x-obs-grant-read-acp: id=domainID。如果授权给多个租户,需要通过','分割。
325
+ When creating an object, you can use this header to grant all users under a tenant the permissions to obtain the object ACL. Example: x-obs-grant-read-acp: id=domainID. If multiple tenants are authorized, separate them with commas (,).
326
326
 
327
327
  :param x_obs_grant_read_acp: The x_obs_grant_read_acp of this PutObjectRequest.
328
328
  :type x_obs_grant_read_acp: str
@@ -333,7 +333,7 @@ class PutObjectRequest(SdkStreamRequest):
333
333
  def x_obs_grant_write_acp(self):
334
334
  """Gets the x_obs_grant_write_acp of this PutObjectRequest.
335
335
 
336
- 创建对象时,使用此头域授权租户下所有用户有写对象ACL的权 示例:x-obs-grant-write-acp: id=domainID。如果授权给多个租户,需要通过','分割。
336
+ When creating an object, you can use this header to grant all users under a tenant the permissions to write the object ACL. Example: x-obs-grant-write-acp: id=domainID. If multiple tenants are authorized, separate them with commas (,).
337
337
 
338
338
  :return: The x_obs_grant_write_acp of this PutObjectRequest.
339
339
  :rtype: str
@@ -344,7 +344,7 @@ class PutObjectRequest(SdkStreamRequest):
344
344
  def x_obs_grant_write_acp(self, x_obs_grant_write_acp):
345
345
  """Sets the x_obs_grant_write_acp of this PutObjectRequest.
346
346
 
347
- 创建对象时,使用此头域授权租户下所有用户有写对象ACL的权 示例:x-obs-grant-write-acp: id=domainID。如果授权给多个租户,需要通过','分割。
347
+ When creating an object, you can use this header to grant all users under a tenant the permissions to write the object ACL. Example: x-obs-grant-write-acp: id=domainID. If multiple tenants are authorized, separate them with commas (,).
348
348
 
349
349
  :param x_obs_grant_write_acp: The x_obs_grant_write_acp of this PutObjectRequest.
350
350
  :type x_obs_grant_write_acp: str
@@ -355,7 +355,7 @@ class PutObjectRequest(SdkStreamRequest):
355
355
  def x_obs_grant_full_control(self):
356
356
  """Gets the x_obs_grant_full_control of this PutObjectRequest.
357
357
 
358
- 创建对象时,使用此头域授权domain下所有用户有读对象、获取对象元数据、获取对象ACL、写对象ACL的权限 示例:x-obs-grant-full-control: id=domainID。如果授权给多个租户,需要通过','分割。
358
+ When creating an object, you can use this header to grant all users in a domain the permissions to read the object, to obtain the object metadata and ACL, and to write the object ACL. Example: x-obs-grant-full-control: id=domainID. If multiple tenants are authorized, separate them with commas (,).
359
359
 
360
360
  :return: The x_obs_grant_full_control of this PutObjectRequest.
361
361
  :rtype: str
@@ -366,7 +366,7 @@ class PutObjectRequest(SdkStreamRequest):
366
366
  def x_obs_grant_full_control(self, x_obs_grant_full_control):
367
367
  """Sets the x_obs_grant_full_control of this PutObjectRequest.
368
368
 
369
- 创建对象时,使用此头域授权domain下所有用户有读对象、获取对象元数据、获取对象ACL、写对象ACL的权限 示例:x-obs-grant-full-control: id=domainID。如果授权给多个租户,需要通过','分割。
369
+ When creating an object, you can use this header to grant all users in a domain the permissions to read the object, to obtain the object metadata and ACL, and to write the object ACL. Example: x-obs-grant-full-control: id=domainID. If multiple tenants are authorized, separate them with commas (,).
370
370
 
371
371
  :param x_obs_grant_full_control: The x_obs_grant_full_control of this PutObjectRequest.
372
372
  :type x_obs_grant_full_control: str
@@ -377,7 +377,7 @@ class PutObjectRequest(SdkStreamRequest):
377
377
  def x_obs_storage_class(self):
378
378
  """Gets the x_obs_storage_class of this PutObjectRequest.
379
379
 
380
- 创建对象时,可以加上此头域设置对象的存储类型。如果未设置此头域,则以桶的默认存储类型作为对象的存储类型 说明:存储类型有3种:STANDARD(标准存储)、WARM(低频访问存储)、COLD(归档存储)。因此这里可配置的值有:STANDARDWARMCOLD,注意大小写敏感。 示例:x-obs-storage-class: STANDARD
380
+ When creating an object, you can use this header to specify a storage class for the object. If you do not have this header configured, the object inherits the default storage class of the bucket.Note: There are three storage classes: Standard (STANDARD), Infrequent Access (WARM), and Archive (COLD), so the value can be **STANDARD**, **WARM**, or **COLD**. The value is case sensitive.Example: x-obs-storage-class: STANDARD
381
381
 
382
382
  :return: The x_obs_storage_class of this PutObjectRequest.
383
383
  :rtype: str
@@ -388,7 +388,7 @@ class PutObjectRequest(SdkStreamRequest):
388
388
  def x_obs_storage_class(self, x_obs_storage_class):
389
389
  """Sets the x_obs_storage_class of this PutObjectRequest.
390
390
 
391
- 创建对象时,可以加上此头域设置对象的存储类型。如果未设置此头域,则以桶的默认存储类型作为对象的存储类型 说明:存储类型有3种:STANDARD(标准存储)、WARM(低频访问存储)、COLD(归档存储)。因此这里可配置的值有:STANDARDWARMCOLD,注意大小写敏感。 示例:x-obs-storage-class: STANDARD
391
+ When creating an object, you can use this header to specify a storage class for the object. If you do not have this header configured, the object inherits the default storage class of the bucket.Note: There are three storage classes: Standard (STANDARD), Infrequent Access (WARM), and Archive (COLD), so the value can be **STANDARD**, **WARM**, or **COLD**. The value is case sensitive.Example: x-obs-storage-class: STANDARD
392
392
 
393
393
  :param x_obs_storage_class: The x_obs_storage_class of this PutObjectRequest.
394
394
  :type x_obs_storage_class: str
@@ -399,7 +399,7 @@ class PutObjectRequest(SdkStreamRequest):
399
399
  def x_obs_meta_xxx(self):
400
400
  """Gets the x_obs_meta_xxx of this PutObjectRequest.
401
401
 
402
- 用户自定义元数据 示例:x-obs-meta-test: test metadata
402
+ User-defined metadata. Example: x-obs-meta-test: test metadata
403
403
 
404
404
  :return: The x_obs_meta_xxx of this PutObjectRequest.
405
405
  :rtype: str
@@ -410,7 +410,7 @@ class PutObjectRequest(SdkStreamRequest):
410
410
  def x_obs_meta_xxx(self, x_obs_meta_xxx):
411
411
  """Sets the x_obs_meta_xxx of this PutObjectRequest.
412
412
 
413
- 用户自定义元数据 示例:x-obs-meta-test: test metadata
413
+ User-defined metadata. Example: x-obs-meta-test: test metadata
414
414
 
415
415
  :param x_obs_meta_xxx: The x_obs_meta_xxx of this PutObjectRequest.
416
416
  :type x_obs_meta_xxx: str
@@ -421,7 +421,7 @@ class PutObjectRequest(SdkStreamRequest):
421
421
  def x_obs_persistent_headers(self):
422
422
  """Gets the x_obs_persistent_headers of this PutObjectRequest.
423
423
 
424
- 创建对象时,可以在HTTP请求中加入“x-obs-persistent-headers”消息头,用来加入一个或多个自定义的响应头,当用户获取此对象或查询此对象元数据时,加入的自定义响应头将会在返回消息的头域中出现。 格式:x-obs-persistent-headers: key1:base64_encode(value1),key2:base64_encode(value2).... 说明:其中key1/key2等为自定义header,若含有非ASCII码或不可识别字符,可以采用URL编码或者Base64编码,服务端只会作为字符串处理,不会做解码。value1/value2等为对应自定义header的值,base64_encode指做base64编码,即将自定义header和对应值的base64编码作为一个key-value对用“:”连接,然后用“,”将所有的key-value对连接起来,放在x-obs-persistent-headers这个header中即可,服务端会对上传的value做解码处理。 示例: x-obs-persistent-headers: key1:dmFsdWUx,key2:dmFsdWUy 下载此对象或获取此对象元数据时:返回两个头域分别为“key1:value1”与“key2:value2” 约束: 1. 通过该方式指定的自定义响应头不能以“x-obs-”为前缀,比如可以指定“key1”,但是不能指定“x-obs-key1” 2. 不能指定http标准头,例如host/content-md5/origin/range/Content-Disposition等 3. 此头域和自定义元数据总长度不能超过8KB 4. 如果传入相同key,将value以“,”拼接后放入同一个key中返回
424
+ When creating an object, you can add the **x-obs-persistent-headers** header in an HTTP request to customize one or more response headers. When you retrieve the object or query the object metadata, the custom headers will be returned in the response message.Format: **x-obs-persistent-headers: ****key1:base64_encode(***value1***),****key2:base64_encode(***value2***)...**Note: Items, such as **key1** and **key2**, are user-defined headers. If they contain non-ASCII or unrecognizable characters, they can be encoded using URL or Base64. The server processes these headers as strings, but does not decode them. Items, such as *value1* and *value2* are the values of the corresponding headers. **base64_encode** indicates that the value is encoded using Base64. A user-defined header and its Base64-encoded value are connected using a colon (:) to form a key-value pair. All key-value pairs are separated with a comma (,) and are placed in the **x-obs-persistent-headers** header. The server then decodes the uploaded value.Example: x-obs-persistent-headers: key1:dmFsdWUx,key2:dmFsdWUyWhen you download the object or obtain the object metadata, headers **key1:***value1* and **key2:***value2* will be returned.Restrictions:+ Response headers customized in this way cannot be prefixed with **x-obs-**. For example, you should use **key1**, instead of **x-obs-key1**.+ Standard HTTP headers, such as **host**, **content-md5**, **origin**, **range**, and **Content-Disposition**, cannot be specified as custom headers.+ The total length of this header and the custom metadata cannot exceed 8 KB.+ If the same keys are transferred, values are separated with commas (,) and then returned in one key.
425
425
 
426
426
  :return: The x_obs_persistent_headers of this PutObjectRequest.
427
427
  :rtype: str
@@ -432,7 +432,7 @@ class PutObjectRequest(SdkStreamRequest):
432
432
  def x_obs_persistent_headers(self, x_obs_persistent_headers):
433
433
  """Sets the x_obs_persistent_headers of this PutObjectRequest.
434
434
 
435
- 创建对象时,可以在HTTP请求中加入“x-obs-persistent-headers”消息头,用来加入一个或多个自定义的响应头,当用户获取此对象或查询此对象元数据时,加入的自定义响应头将会在返回消息的头域中出现。 格式:x-obs-persistent-headers: key1:base64_encode(value1),key2:base64_encode(value2).... 说明:其中key1/key2等为自定义header,若含有非ASCII码或不可识别字符,可以采用URL编码或者Base64编码,服务端只会作为字符串处理,不会做解码。value1/value2等为对应自定义header的值,base64_encode指做base64编码,即将自定义header和对应值的base64编码作为一个key-value对用“:”连接,然后用“,”将所有的key-value对连接起来,放在x-obs-persistent-headers这个header中即可,服务端会对上传的value做解码处理。 示例: x-obs-persistent-headers: key1:dmFsdWUx,key2:dmFsdWUy 下载此对象或获取此对象元数据时:返回两个头域分别为“key1:value1”与“key2:value2” 约束: 1. 通过该方式指定的自定义响应头不能以“x-obs-”为前缀,比如可以指定“key1”,但是不能指定“x-obs-key1” 2. 不能指定http标准头,例如host/content-md5/origin/range/Content-Disposition等 3. 此头域和自定义元数据总长度不能超过8KB 4. 如果传入相同key,将value以“,”拼接后放入同一个key中返回
435
+ When creating an object, you can add the **x-obs-persistent-headers** header in an HTTP request to customize one or more response headers. When you retrieve the object or query the object metadata, the custom headers will be returned in the response message.Format: **x-obs-persistent-headers: ****key1:base64_encode(***value1***),****key2:base64_encode(***value2***)...**Note: Items, such as **key1** and **key2**, are user-defined headers. If they contain non-ASCII or unrecognizable characters, they can be encoded using URL or Base64. The server processes these headers as strings, but does not decode them. Items, such as *value1* and *value2* are the values of the corresponding headers. **base64_encode** indicates that the value is encoded using Base64. A user-defined header and its Base64-encoded value are connected using a colon (:) to form a key-value pair. All key-value pairs are separated with a comma (,) and are placed in the **x-obs-persistent-headers** header. The server then decodes the uploaded value.Example: x-obs-persistent-headers: key1:dmFsdWUx,key2:dmFsdWUyWhen you download the object or obtain the object metadata, headers **key1:***value1* and **key2:***value2* will be returned.Restrictions:+ Response headers customized in this way cannot be prefixed with **x-obs-**. For example, you should use **key1**, instead of **x-obs-key1**.+ Standard HTTP headers, such as **host**, **content-md5**, **origin**, **range**, and **Content-Disposition**, cannot be specified as custom headers.+ The total length of this header and the custom metadata cannot exceed 8 KB.+ If the same keys are transferred, values are separated with commas (,) and then returned in one key.
436
436
 
437
437
  :param x_obs_persistent_headers: The x_obs_persistent_headers of this PutObjectRequest.
438
438
  :type x_obs_persistent_headers: str
@@ -443,7 +443,7 @@ class PutObjectRequest(SdkStreamRequest):
443
443
  def x_obs_website_redirect_location(self):
444
444
  """Gets the x_obs_website_redirect_location of this PutObjectRequest.
445
445
 
446
- 当桶设置了Website配置,可以将获取这个对象的请求重定向到桶内另一个对象或一个外部的URLOBS将这个值从头域中取出,保存在对象的元数据中。 例如,重定向请求到桶内另一对象: x-obs-website-redirect-location:/anotherPage.html 或重定向请求到一个外部URLx-obs-website-redirect-location:http://www.example.com/ 默认值:无 约束:必须以“/”、“http://”或“https://”开头,长度不超过2KB。
446
+ If static website hosting has been configured for a bucket, you can configure this parameter to redirect requests for an object in this bucket to another object in the same bucket or to an external URL. OBS stores the value of this header in the object metadata.Example of redirecting requests to another object in the bucket:x-obs-website-redirect-location:/anotherPage.htmlExample of redirecting requests to an external URL:x-obs-website-redirect-location:http://www.example.com/Default value: noneRestriction: The value must start with a slash (/), **http://**, or **https://**, with a length of no more than 2 KB.
447
447
 
448
448
  :return: The x_obs_website_redirect_location of this PutObjectRequest.
449
449
  :rtype: str
@@ -454,7 +454,7 @@ class PutObjectRequest(SdkStreamRequest):
454
454
  def x_obs_website_redirect_location(self, x_obs_website_redirect_location):
455
455
  """Sets the x_obs_website_redirect_location of this PutObjectRequest.
456
456
 
457
- 当桶设置了Website配置,可以将获取这个对象的请求重定向到桶内另一个对象或一个外部的URLOBS将这个值从头域中取出,保存在对象的元数据中。 例如,重定向请求到桶内另一对象: x-obs-website-redirect-location:/anotherPage.html 或重定向请求到一个外部URLx-obs-website-redirect-location:http://www.example.com/ 默认值:无 约束:必须以“/”、“http://”或“https://”开头,长度不超过2KB。
457
+ If static website hosting has been configured for a bucket, you can configure this parameter to redirect requests for an object in this bucket to another object in the same bucket or to an external URL. OBS stores the value of this header in the object metadata.Example of redirecting requests to another object in the bucket:x-obs-website-redirect-location:/anotherPage.htmlExample of redirecting requests to an external URL:x-obs-website-redirect-location:http://www.example.com/Default value: noneRestriction: The value must start with a slash (/), **http://**, or **https://**, with a length of no more than 2 KB.
458
458
 
459
459
  :param x_obs_website_redirect_location: The x_obs_website_redirect_location of this PutObjectRequest.
460
460
  :type x_obs_website_redirect_location: str
@@ -465,7 +465,7 @@ class PutObjectRequest(SdkStreamRequest):
465
465
  def x_obs_server_side_encryption(self):
466
466
  """Gets the x_obs_server_side_encryption of this PutObjectRequest.
467
467
 
468
- 使用该头域表示服务端加密是SSE-KMS方式。 示例:x-obs-server-side-encryption: kms
468
+ Indicates that SSE-KMS is used. Example: x-obs-server-side-encryption: kms
469
469
 
470
470
  :return: The x_obs_server_side_encryption of this PutObjectRequest.
471
471
  :rtype: str
@@ -476,7 +476,7 @@ class PutObjectRequest(SdkStreamRequest):
476
476
  def x_obs_server_side_encryption(self, x_obs_server_side_encryption):
477
477
  """Sets the x_obs_server_side_encryption of this PutObjectRequest.
478
478
 
479
- 使用该头域表示服务端加密是SSE-KMS方式。 示例:x-obs-server-side-encryption: kms
479
+ Indicates that SSE-KMS is used. Example: x-obs-server-side-encryption: kms
480
480
 
481
481
  :param x_obs_server_side_encryption: The x_obs_server_side_encryption of this PutObjectRequest.
482
482
  :type x_obs_server_side_encryption: str
@@ -487,7 +487,7 @@ class PutObjectRequest(SdkStreamRequest):
487
487
  def x_obs_server_side_encryption_kms_key_id(self):
488
488
  """Gets the x_obs_server_side_encryption_kms_key_id of this PutObjectRequest.
489
489
 
490
- SSE-KMS方式下使用该头域,该头域表示主密钥,如果用户没有提供该头域,那么默认的主密钥将会被使用。 支持两种格式的描述方式: 1. regionID:domainID(租户ID):key/key_id 或者 2.key_id 其中regionID是使用密钥所属region的ID;domainID是使用密钥所属租户的租户IDkey_id是从数据加密服务创建的密钥ID。 示例: 1. x-obs-server-side-encryption-kms-key-id: cn-north-4:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0 或者 2. x-obs-server-side-encryption-kms-key-id: 4f1cd4de-ab64-4807-920a-47fc42e7f0d0
490
+ Master key ID. This header is used for encryption with SSE-KMS. If the customer does not provide the master key ID, the default master key ID will be used.Supported formats:+ *regionID***:***domainID***:key/***key_id* + *key_id**regionID* is the ID of the region to which the key belongs. *domainID* is the account ID of the tenant to which the key belongs. *key_id* is the key ID created in DEW.Examples:+ x-obs-server-side-encryption-kms-key-id:cn-north-4:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0 + x-obs-server-side-encryption-kms-key-id:4f1cd4de-ab64-4807-920a-47fc42e7f0d0
491
491
 
492
492
  :return: The x_obs_server_side_encryption_kms_key_id of this PutObjectRequest.
493
493
  :rtype: str
@@ -498,7 +498,7 @@ class PutObjectRequest(SdkStreamRequest):
498
498
  def x_obs_server_side_encryption_kms_key_id(self, x_obs_server_side_encryption_kms_key_id):
499
499
  """Sets the x_obs_server_side_encryption_kms_key_id of this PutObjectRequest.
500
500
 
501
- SSE-KMS方式下使用该头域,该头域表示主密钥,如果用户没有提供该头域,那么默认的主密钥将会被使用。 支持两种格式的描述方式: 1. regionID:domainID(租户ID):key/key_id 或者 2.key_id 其中regionID是使用密钥所属region的ID;domainID是使用密钥所属租户的租户IDkey_id是从数据加密服务创建的密钥ID。 示例: 1. x-obs-server-side-encryption-kms-key-id: cn-north-4:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0 或者 2. x-obs-server-side-encryption-kms-key-id: 4f1cd4de-ab64-4807-920a-47fc42e7f0d0
501
+ Master key ID. This header is used for encryption with SSE-KMS. If the customer does not provide the master key ID, the default master key ID will be used.Supported formats:+ *regionID***:***domainID***:key/***key_id* + *key_id**regionID* is the ID of the region to which the key belongs. *domainID* is the account ID of the tenant to which the key belongs. *key_id* is the key ID created in DEW.Examples:+ x-obs-server-side-encryption-kms-key-id:cn-north-4:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0 + x-obs-server-side-encryption-kms-key-id:4f1cd4de-ab64-4807-920a-47fc42e7f0d0
502
502
 
503
503
  :param x_obs_server_side_encryption_kms_key_id: The x_obs_server_side_encryption_kms_key_id of this PutObjectRequest.
504
504
  :type x_obs_server_side_encryption_kms_key_id: str
@@ -509,7 +509,7 @@ class PutObjectRequest(SdkStreamRequest):
509
509
  def x_obs_server_side_encryption_customer_algorithm(self):
510
510
  """Gets the x_obs_server_side_encryption_customer_algorithm of this PutObjectRequest.
511
511
 
512
- SSE-C方式下使用该头域,该头域表示加密使用的算法。 示例:x-obs-server-side-encryption-customer-algorithm: AES256 约束:需要和x-obs-server-side-encryption-customer-key x-obs-server-side-encryption-customer-key-MD5一起使用。
512
+ The encryption algorithm used for SSE-C.Example: x-obs-server-side-encryption-customer-algorithm:AES256Restriction: This header must be used together with **x-obs-server-side-encryption-customer-key** and **x-obs-server-side-encryption-customer-key-MD5**.
513
513
 
514
514
  :return: The x_obs_server_side_encryption_customer_algorithm of this PutObjectRequest.
515
515
  :rtype: str
@@ -520,7 +520,7 @@ class PutObjectRequest(SdkStreamRequest):
520
520
  def x_obs_server_side_encryption_customer_algorithm(self, x_obs_server_side_encryption_customer_algorithm):
521
521
  """Sets the x_obs_server_side_encryption_customer_algorithm of this PutObjectRequest.
522
522
 
523
- SSE-C方式下使用该头域,该头域表示加密使用的算法。 示例:x-obs-server-side-encryption-customer-algorithm: AES256 约束:需要和x-obs-server-side-encryption-customer-key x-obs-server-side-encryption-customer-key-MD5一起使用。
523
+ The encryption algorithm used for SSE-C.Example: x-obs-server-side-encryption-customer-algorithm:AES256Restriction: This header must be used together with **x-obs-server-side-encryption-customer-key** and **x-obs-server-side-encryption-customer-key-MD5**.
524
524
 
525
525
  :param x_obs_server_side_encryption_customer_algorithm: The x_obs_server_side_encryption_customer_algorithm of this PutObjectRequest.
526
526
  :type x_obs_server_side_encryption_customer_algorithm: str
@@ -531,7 +531,7 @@ class PutObjectRequest(SdkStreamRequest):
531
531
  def x_obs_server_side_encryption_customer_key(self):
532
532
  """Gets the x_obs_server_side_encryption_customer_key of this PutObjectRequest.
533
533
 
534
- SSE-C方式下使用该头域,该头域表示加密使用的密钥。该密钥用于加密对象 示例:x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw= 约束:该头域由256-bit的密钥经过base64-encoded得到,需要和x-obs-server-side-encryption-customer-algorithmx-obs-server-side-encryption-customer-key-MD5一起使用。
534
+ Encryption key used for SSE-C. This key is used to encrypt objects.Example: x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=Restriction: This header is a Base64-encoded 256-bit key and must be used together with **x-obs-server-side-encryption-customer-algorithm** and **x-obs-server-side-encryption-customer-key-MD5**.
535
535
 
536
536
  :return: The x_obs_server_side_encryption_customer_key of this PutObjectRequest.
537
537
  :rtype: str
@@ -542,7 +542,7 @@ class PutObjectRequest(SdkStreamRequest):
542
542
  def x_obs_server_side_encryption_customer_key(self, x_obs_server_side_encryption_customer_key):
543
543
  """Sets the x_obs_server_side_encryption_customer_key of this PutObjectRequest.
544
544
 
545
- SSE-C方式下使用该头域,该头域表示加密使用的密钥。该密钥用于加密对象 示例:x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw= 约束:该头域由256-bit的密钥经过base64-encoded得到,需要和x-obs-server-side-encryption-customer-algorithmx-obs-server-side-encryption-customer-key-MD5一起使用。
545
+ Encryption key used for SSE-C. This key is used to encrypt objects.Example: x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=Restriction: This header is a Base64-encoded 256-bit key and must be used together with **x-obs-server-side-encryption-customer-algorithm** and **x-obs-server-side-encryption-customer-key-MD5**.
546
546
 
547
547
  :param x_obs_server_side_encryption_customer_key: The x_obs_server_side_encryption_customer_key of this PutObjectRequest.
548
548
  :type x_obs_server_side_encryption_customer_key: str
@@ -553,7 +553,7 @@ class PutObjectRequest(SdkStreamRequest):
553
553
  def x_obs_server_side_encryption_customer_key_md5(self):
554
554
  """Gets the x_obs_server_side_encryption_customer_key_md5 of this PutObjectRequest.
555
555
 
556
- SSE-C方式下使用该头域,该头域表示加密使用的密钥的MD5值。MD5值用于验证密钥传输过程中没有出错。 示例:x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ== 约束: 该头域由密钥的128-bit MD5值经过base64-encoded得到,需要和x-obs-server-side-encryption-customer-algorithmx-obs-server-side-encryption-customer-key一起使用。
556
+ MD5 value of the key used to encrypt objects in SSE-C mode. The MD5 value is used to check whether any error occurs during the transmission of the key. Example: x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==Restriction: This header is a Base64-encoded 128-bit MD5 value and must be used together with **x-obs-server-side-encryption-customer-algorithm** and **x-obs-server-side-encryption-customer-key**.
557
557
 
558
558
  :return: The x_obs_server_side_encryption_customer_key_md5 of this PutObjectRequest.
559
559
  :rtype: str
@@ -564,7 +564,7 @@ class PutObjectRequest(SdkStreamRequest):
564
564
  def x_obs_server_side_encryption_customer_key_md5(self, x_obs_server_side_encryption_customer_key_md5):
565
565
  """Sets the x_obs_server_side_encryption_customer_key_md5 of this PutObjectRequest.
566
566
 
567
- SSE-C方式下使用该头域,该头域表示加密使用的密钥的MD5值。MD5值用于验证密钥传输过程中没有出错。 示例:x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ== 约束: 该头域由密钥的128-bit MD5值经过base64-encoded得到,需要和x-obs-server-side-encryption-customer-algorithmx-obs-server-side-encryption-customer-key一起使用。
567
+ MD5 value of the key used to encrypt objects in SSE-C mode. The MD5 value is used to check whether any error occurs during the transmission of the key. Example: x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==Restriction: This header is a Base64-encoded 128-bit MD5 value and must be used together with **x-obs-server-side-encryption-customer-algorithm** and **x-obs-server-side-encryption-customer-key**.
568
568
 
569
569
  :param x_obs_server_side_encryption_customer_key_md5: The x_obs_server_side_encryption_customer_key_md5 of this PutObjectRequest.
570
570
  :type x_obs_server_side_encryption_customer_key_md5: str
@@ -575,7 +575,7 @@ class PutObjectRequest(SdkStreamRequest):
575
575
  def success_action_redirect(self):
576
576
  """Gets the success_action_redirect of this PutObjectRequest.
577
577
 
578
- 此参数的值是一个URL,用于指定当此次请求操作成功响应后的重定向的地址。 如果此参数值有效且操作成功,响应码为303Location头域由此参数以及桶名、对象名、对象的ETag组成。 如果此参数值无效,则OBS忽略此参数的作用,响应码为204Location头域为对象地址。
578
+ The address (a URL) which a successfully responded request is redirected to. If this parameter value is valid and the request succeeds, OBS returns status code 303. The **Location** header consists of **success_action_redirect** as well as the bucket name, object name, and object ETag. If this parameter is invalid, OBS ignores this parameter and returns status code 204. In such case, the **Location** header is the object address.
579
579
 
580
580
  :return: The success_action_redirect of this PutObjectRequest.
581
581
  :rtype: str
@@ -586,7 +586,7 @@ class PutObjectRequest(SdkStreamRequest):
586
586
  def success_action_redirect(self, success_action_redirect):
587
587
  """Sets the success_action_redirect of this PutObjectRequest.
588
588
 
589
- 此参数的值是一个URL,用于指定当此次请求操作成功响应后的重定向的地址。 如果此参数值有效且操作成功,响应码为303Location头域由此参数以及桶名、对象名、对象的ETag组成。 如果此参数值无效,则OBS忽略此参数的作用,响应码为204Location头域为对象地址。
589
+ The address (a URL) which a successfully responded request is redirected to. If this parameter value is valid and the request succeeds, OBS returns status code 303. The **Location** header consists of **success_action_redirect** as well as the bucket name, object name, and object ETag. If this parameter is invalid, OBS ignores this parameter and returns status code 204. In such case, the **Location** header is the object address.
590
590
 
591
591
  :param success_action_redirect: The success_action_redirect of this PutObjectRequest.
592
592
  :type success_action_redirect: str
@@ -597,7 +597,7 @@ class PutObjectRequest(SdkStreamRequest):
597
597
  def x_obs_expires(self):
598
598
  """Gets the x_obs_expires of this PutObjectRequest.
599
599
 
600
- 表示对象的过期时间,单位是天。过期之后对象会被自动删除。(从对象最后修改时间开始计算) 此字段对于每个对象仅支持上传时配置,不支持后期通过修改元数据接口修改。 示例:x-obs-expires:3
600
+ When an object expires. It is measured in days. An object will be automatically deleted once it expires. The expiration is calculated from when the object was last modified. This header can be only configured during the object upload, and cannot be modified later by using the metadata API. Example: x-obs-expires:3
601
601
 
602
602
  :return: The x_obs_expires of this PutObjectRequest.
603
603
  :rtype: int
@@ -608,7 +608,7 @@ class PutObjectRequest(SdkStreamRequest):
608
608
  def x_obs_expires(self, x_obs_expires):
609
609
  """Sets the x_obs_expires of this PutObjectRequest.
610
610
 
611
- 表示对象的过期时间,单位是天。过期之后对象会被自动删除。(从对象最后修改时间开始计算) 此字段对于每个对象仅支持上传时配置,不支持后期通过修改元数据接口修改。 示例:x-obs-expires:3
611
+ When an object expires. It is measured in days. An object will be automatically deleted once it expires. The expiration is calculated from when the object was last modified. This header can be only configured during the object upload, and cannot be modified later by using the metadata API. Example: x-obs-expires:3
612
612
 
613
613
  :param x_obs_expires: The x_obs_expires of this PutObjectRequest.
614
614
  :type x_obs_expires: int
@@ -39,13 +39,13 @@ class SetBucketAclRequest:
39
39
 
40
40
  The model defined in huaweicloud sdk
41
41
 
42
- :param date: 请求发起端的日期和时间,例如:Wed, 27 Jun 2018 13:39:15 +0000 默认值:无。 条件:如果消息头中带了x-obs-date字段,则可以不带该字段,其他情况下必选。
42
+ :param date: Time when a request was initiated, for example, **Wed, 27 Jun 2018 13:39:15 +0000**. Default value: none Restriction: This header is optional if the **x-obs-date** header is contained in the request, but mandatory in other circumstances.
43
43
  :type date: str
44
- :param bucket_name: 请求的桶名称。
44
+ :param bucket_name: Name of the requested bucket
45
45
  :type bucket_name: str
46
- :param acl: acl表示请求访问控制列表API
46
+ :param acl: Indicates the API for sending a request to the ACL.
47
47
  :type acl: str
48
- :param x_obs_acl: 通过cannedACL的方式来设置桶的ACL 取值范围:private | public-read | public-read-write | public-read-delivered | public-read-write-delivered
48
+ :param x_obs_acl: Uses a canned ACL for the bucket.Value options: **private**, **public-read**, **public-read-write**, **public-read-delivered**, or **public-read-write-delivered**
49
49
  :type x_obs_acl: str
50
50
  :param body: Body of the SetBucketAclRequest
51
51
  :type body: :class:`huaweicloudsdkobs.v1.SetBucketAclRequestBody`
@@ -73,7 +73,7 @@ class SetBucketAclRequest:
73
73
  def date(self):
74
74
  """Gets the date of this SetBucketAclRequest.
75
75
 
76
- 请求发起端的日期和时间,例如:Wed, 27 Jun 2018 13:39:15 +0000 默认值:无。 条件:如果消息头中带了x-obs-date字段,则可以不带该字段,其他情况下必选。
76
+ Time when a request was initiated, for example, **Wed, 27 Jun 2018 13:39:15 +0000**. Default value: none Restriction: This header is optional if the **x-obs-date** header is contained in the request, but mandatory in other circumstances.
77
77
 
78
78
  :return: The date of this SetBucketAclRequest.
79
79
  :rtype: str
@@ -84,7 +84,7 @@ class SetBucketAclRequest:
84
84
  def date(self, date):
85
85
  """Sets the date of this SetBucketAclRequest.
86
86
 
87
- 请求发起端的日期和时间,例如:Wed, 27 Jun 2018 13:39:15 +0000 默认值:无。 条件:如果消息头中带了x-obs-date字段,则可以不带该字段,其他情况下必选。
87
+ Time when a request was initiated, for example, **Wed, 27 Jun 2018 13:39:15 +0000**. Default value: none Restriction: This header is optional if the **x-obs-date** header is contained in the request, but mandatory in other circumstances.
88
88
 
89
89
  :param date: The date of this SetBucketAclRequest.
90
90
  :type date: str
@@ -95,7 +95,7 @@ class SetBucketAclRequest:
95
95
  def bucket_name(self):
96
96
  """Gets the bucket_name of this SetBucketAclRequest.
97
97
 
98
- 请求的桶名称。
98
+ Name of the requested bucket
99
99
 
100
100
  :return: The bucket_name of this SetBucketAclRequest.
101
101
  :rtype: str
@@ -106,7 +106,7 @@ class SetBucketAclRequest:
106
106
  def bucket_name(self, bucket_name):
107
107
  """Sets the bucket_name of this SetBucketAclRequest.
108
108
 
109
- 请求的桶名称。
109
+ Name of the requested bucket
110
110
 
111
111
  :param bucket_name: The bucket_name of this SetBucketAclRequest.
112
112
  :type bucket_name: str
@@ -117,7 +117,7 @@ class SetBucketAclRequest:
117
117
  def acl(self):
118
118
  """Gets the acl of this SetBucketAclRequest.
119
119
 
120
- acl表示请求访问控制列表API
120
+ Indicates the API for sending a request to the ACL.
121
121
 
122
122
  :return: The acl of this SetBucketAclRequest.
123
123
  :rtype: str
@@ -128,7 +128,7 @@ class SetBucketAclRequest:
128
128
  def acl(self, acl):
129
129
  """Sets the acl of this SetBucketAclRequest.
130
130
 
131
- acl表示请求访问控制列表API
131
+ Indicates the API for sending a request to the ACL.
132
132
 
133
133
  :param acl: The acl of this SetBucketAclRequest.
134
134
  :type acl: str
@@ -139,7 +139,7 @@ class SetBucketAclRequest:
139
139
  def x_obs_acl(self):
140
140
  """Gets the x_obs_acl of this SetBucketAclRequest.
141
141
 
142
- 通过cannedACL的方式来设置桶的ACL 取值范围:private | public-read | public-read-write | public-read-delivered | public-read-write-delivered
142
+ Uses a canned ACL for the bucket.Value options: **private**, **public-read**, **public-read-write**, **public-read-delivered**, or **public-read-write-delivered**
143
143
 
144
144
  :return: The x_obs_acl of this SetBucketAclRequest.
145
145
  :rtype: str
@@ -150,7 +150,7 @@ class SetBucketAclRequest:
150
150
  def x_obs_acl(self, x_obs_acl):
151
151
  """Sets the x_obs_acl of this SetBucketAclRequest.
152
152
 
153
- 通过cannedACL的方式来设置桶的ACL 取值范围:private | public-read | public-read-write | public-read-delivered | public-read-write-delivered
153
+ Uses a canned ACL for the bucket.Value options: **private**, **public-read**, **public-read-write**, **public-read-delivered**, or **public-read-write-delivered**
154
154
 
155
155
  :param x_obs_acl: The x_obs_acl of this SetBucketAclRequest.
156
156
  :type x_obs_acl: str