diff --git a/docs/obs/s3api/ALL_META.TXT.json b/docs/obs/s3api/ALL_META.TXT.json index 2402ff41..3e6f9535 100644 --- a/docs/obs/s3api/ALL_META.TXT.json +++ b/docs/obs/s3api/ALL_META.TXT.json @@ -1933,7 +1933,7 @@ "node_id":"en-us_topic_0125560276.xml", "product_code":"obs", "code":"108", - "des":"Released OnWhat's New2024-01-19Updated the following content:Updated remarks about the GET Bucket location API in the \"Compatibility of OBS REST APIs\" section.Added WORM-", + "des":"Released OnWhat's New2024-03-21Updated the following content:Updated information about the RetainUntilDate parameter and added example 2 in Configuring WORM Retention for", "doc_type":"api_obs", "kw":"Change History,API Reference (S3)", "search_title":"", diff --git a/docs/obs/s3api/CLASS.TXT.json b/docs/obs/s3api/CLASS.TXT.json index 204729bf..fabb1e0f 100644 --- a/docs/obs/s3api/CLASS.TXT.json +++ b/docs/obs/s3api/CLASS.TXT.json @@ -963,7 +963,7 @@ "code":"107" }, { - "desc":"Released OnWhat's New2024-01-19Updated the following content:Updated remarks about the GET Bucket location API in the \"Compatibility of OBS REST APIs\" section.Added WORM-", + "desc":"Released OnWhat's New2024-03-21Updated the following content:Updated information about the RetainUntilDate parameter and added example 2 in Configuring WORM Retention for", "product_code":"obs", "title":"Change History", "uri":"en-us_topic_0125560276.html", diff --git a/docs/obs/s3api/en-us_topic_0000001806154009.html b/docs/obs/s3api/en-us_topic_0000001806154009.html index ddd3a4fa..38eb2870 100644 --- a/docs/obs/s3api/en-us_topic_0000001806154009.html +++ b/docs/obs/s3api/en-us_topic_0000001806154009.html @@ -72,12 +72,14 @@ Authorization: authorization

RetainUntilDate

-

Protection period for the object. Its value is a timestamp accurate to milliseconds, for example, 1435728035000 (corresponding to 13:20:35 on July 1, 2015).

+

Protection period for the object. The value can be a timestamp or in the ISO format.

+

A timestamp must be accurate to milliseconds. For example, the timestamp for 13:20:35 on July 1, 2015 should be 1435728035000.

+

A time zone is required in the ISO time format. For example, the ISO UTC time for 13:20:35 on July 1, 2015 should be 2015-07-01T13:20:35Z.

NOTE:

The value of this field must be later than the current time and can be extended but not shortened.

-

Type: long

-

Example: 1435728035000

-

Remarks: Its value is a timestamp accurate to milliseconds in Unix time.

+

Type: string

+

Example: 1435728035000 (a timestamp) or 2015-07-01T13:20:35Z (in the ISO format)

+

Remarks: timestamp value is accurate to milliseconds in Unix time.

Yes

@@ -138,7 +140,8 @@ Content-Length: length

For details about other errors, see Table 1.

-

Sample Request

PUT /objectname?retention HTTP/1.1
+
Sample Request 1
Configuring the WORM protection (with the protection period specified as a timestamp) for an object.

+
PUT /objectname?retention HTTP/1.1
 Host: bucketname.obs.region.example.com
 Date: WED, 01 Jul 2015 02:25:05 GMT
 Authorization: authorization
@@ -149,13 +152,32 @@ Content-Length: 157
     <RetainUntilDate>1435728035000</RetainUntilDate>
 </Retention>

 

-
Sample Response
HTTP/1.1 200 OK
+
Sample Response 1
HTTP/1.1 200 OK
 Server: OBS
 x-amz-request-id: BF260000016435CE298386946AE4C482
 x-amz-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCT9W2tcvLmMJ+plfdopaD62S0npbaRUz
 Date: WED, 01 Jul 2015 02:25:06 GMT
 Content-Length: 0

 

+
Sample Request 2
Configuring the WORM protection (with the protection period specified in the ISO format) for an object.

+
PUT /objectname?retention HTTP/1.1
+Host: bucketname.obs.region.example.com
+WED, 01 Jul 2015 02:25:06 GMT
+Authorization: authorization
+Content-Type: application/xml
+Content-Length: 193
+<Retention>
+    <Mode>COMPLIANCE</Mode>
+    <RetainUntilDate>2015-07-01T13:20:35Z</RetainUntilDate>
+</Retention>

+

+
Sample Response 2
HTTP/1.1 200 OK
+Server: OBS
+x-amz-request-id: 0000018E3CC039E75306D1560F6A5B61
+x-amz-id-2: 32AAAUgAIAABAAAQAAEAABAAAQAAEAABCS14XamzycaPY1tivqczu/2SI2sbVBNZ
+Date: WED, 01 Jul 2015 02:25:06 GMT
+Content-Length: 0

+

 

 

 

diff --git a/docs/obs/s3api/en-us_topic_0125560276.html b/docs/obs/s3api/en-us_topic_0125560276.html
index 3f95b31c..5306fa51 100644
--- a/docs/obs/s3api/en-us_topic_0125560276.html
+++ b/docs/obs/s3api/en-us_topic_0125560276.html
@@ -6,6 +6,12 @@
 
What's New

 
 
+
2024-03-21

+
+
Updated the following content:

+
+
+
 
2024-01-19

 
 
Updated the following content: