VK Cloud logo

Object Lock

Объектілерді бұғаттаумен жұмыс істеуге арналған әдістер:

  • GetObjectLegalHold — мерзімсіз бұғаттаудың статусын алу.
  • PutObjectLegalHold — мерзімсіз бұғаттауды орнату немесе алып тастау.
  • GetObjectRetention — объектіге орнатылған уақытша бұғаттаудың статусын алу.
  • PutObjectRetention — объектіге уақытша бұғаттауды орнату, баптау немесе алып тастау.
  • GetObjectLockConfiguration — әдепкі уақытша бұғаттаудың статусын алу.
  • PutObjectLockConfiguration — әдепкі уақытша бұғаттауды орнату, баптау немесе алып тастау.

GetObjectLegalHold

Объектіге орнатылған мерзімсіз бұғаттаудың статусын қайтарады.

Сұрау мысалы:

GET /{Key+}?legal-hold HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com

Жауап мысалы:

HTTP/1.1 200<?xml version="1.0" encoding="UTF-8"?><LegalHold>   <Status>string</Status></LegalHold>

PutObjectLegalHold

PutObjectLegalHold әдісі объектіге мерзімсіз бұғаттауды орнатады немесе алып тастайды.

Сұрау денесі:

<LegalHold xmlns="http://s3.amazonaws.com/doc/2006-03-01/">   <Status>string</Status></LegalHold>

Сұрау параметрлері:

Параметр

Түрі

Сипаттама

LegalHold

complex element

Объектінің мерзімсіз бұғаттау баптаулары

LegalHold.Status

xs:string (enum)

Мерзімсіз бұғаттау статусы:

  • ON — бұғаттау орнатылған
  • OFF — бұғаттау алынды

Сұрау мысалы:

PUT /{Key+}?legal-hold HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com<?xml version="1.0" encoding="UTF-8"?><LegalHold xmlns="http://s3.amazonaws.com/doc/2006-03-01/">   <Status>string</Status></LegalHold>

GetObjectRetention

Объектіге орнатылған уақытша бұғаттаудың статусын алу.

Сұрау мысалы:

GET /{Key+}?retention HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com

Жауап мысалы:

HTTP/1.1 200<?xml version="1.0" encoding="UTF-8"?><Retention>   <Mode>string</Mode>   <RetainUntilDate>timestamp</RetainUntilDate></Retention>

PutObjectRetention

PutObjectRetention әдісі объектіге уақытша бұғаттауды орнатады, баптайды немесе алып тастайды.

Әдісті орындау кезінде уақытша басқарылатын бұғаттауды айналып өту үшін сұрауда x-amz-bypass-governance-retention мәні бар тақырыпты көрсетіңіз.

Сұрау денесі:

<Retention xmlns="http://s3.amazonaws.com/doc/2006-03-01/">   <Mode>string</Mode>   <RetainUntilDate>timestamp</RetainUntilDate></Retention>

Сұрау параметрлері:

Параметр

Түрі

Сипаттама

Retention

complex element

Объектінің уақытша бұғаттау баптаулары

Retention.Mode

xs:string (enum)

Бұғаттау түрі:

  • GOVERNANCE — уақытша басқарылатын бұғаттау
  • COMPLIANCE — уақытша қатаң бұғаттау

Retention.RetainUntilDate

xs:dateTime

ISO8601 форматындағы объект бұғаттауының қолданылу мерзімі аяқталатын күн мен уақыт

Сұрау мысалы:

PUT /{Key+}?retention HTTP/1.1Host: my-test-bucket1.hb.bizmrg.comx-amz-bypass-governance-retention: BypassGovernanceRetention<?xml version="1.0" encoding="UTF-8"?>

GetObjectLockConfiguration

Әдепкі уақытша бұғаттаудың статусын алу.

Сұрау мысалы:

GET /?object-lock HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com

Жауап мысалы:

HTTP/1.1 200<?xml version="1.0" encoding="UTF-8"?><ObjectLockConfiguration>   <ObjectLockEnabled>string</ObjectLockEnabled>   <Rule>      <DefaultRetention>         <Days>integer</Days>         <Mode>string</Mode>         <Years>integer</Years>      </DefaultRetention>   </Rule></ObjectLockConfiguration>

PutObjectLockConfiguration

PutObjectLockConfiguration әдісі әдепкі уақытша бұғаттауды орнату, баптау және алып тастау үшін қолданылады.

Сұрау денесі:

<ObjectLockConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">   <ObjectLockEnabled>string</ObjectLockEnabled>   <Rule>      <DefaultRetention>         <Days>integer</Days>         <Mode>string</Mode>         <Years>integer</Years>      </DefaultRetention>   </Rule></ObjectLockConfiguration>

Сұрау параметрлері:

Параметр

Түрі

Сипаттама

ObjectLockConfiguration

ObjectLockEnabled

xs\:string (enum)

Бұғаттау статусы. Enabled — қосылған

Rule

complex element

Әдепкі бұғаттау ережесі

Rule.DefaultRetention

complex element

Әдепкі бұғаттау параметрі

Rule.DefaultRetention.Mode

xs\:string (enum)

Бұғаттау түрі:

  • GOVERNANCE — уақытша басқарылатын бұғаттау
  • COMPLIANCE — уақытша қатаң бұғаттау

Rule.DefaultRetention.Days

xs\:integer

Объект жүктелген сәттен бастап күндермен бұғаттау мерзімі. Years параметрімен бір уақытта көрсетуге болмайды

Rule.DefaultRetention.Years

xs\:integer

Объект жүктелген сәттен бастап жылдармен бұғаттау мерзімі. Days параметрімен бір уақытта көрсетуге болмайды

Сұрау мысалы:

PUT /?object-lock HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com<?xml version="1.0" encoding="UTF-8"?><ObjectLockConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">   <ObjectLockEnabled>string</ObjectLockEnabled>   <Rule>      <DefaultRetention>         <Days>integer</Days>         <Mode>string</Mode>         <Years>integer</Years>      </DefaultRetention>   </Rule></ObjectLockConfiguration>