googleapis / googleapis/google-cloud-cpp

storage: add support for object retention

Open
#12,994 5 comments 0 reactions 0 assignees View on GitHub
api: storage external type: feature request
Dominant language
C++
Stars
659
Forks
462
Avg merge
1d 2h
Merged PRs (30d)
89

Description

Please implement the object retention feature. The following operations must be supported:

- [x] Create a bucket with object retention enabled by using the `enableObjectRetention` bucket create boolean option at bucket create time
- [x] Get the object retention enabled status of a bucket
- [x] Create an object with retention enabled (on an retention enabled bucket) by populating the `retention` object at object create time (retention object has the fields `mode` which can be Unlocked or Locked, and `retainUntilTime` which is a timestamp)
- [x] Update retention for an existing object with a patch operation, by passing the `overrideUnlockedRetention` boolean patch option
- [x] Get the retention policy of an object
- [x] Remove retention for an existing object the same way as above

----
Support for gRPC is blocked as the protos are not published.

- [ ] Implement FromProto for `BucketObjectRetention`
- [ ] Support `EnableObjectRetention` for gRPC plugin
- [ ] Implement ToProto and FromProto for `ObjectRetention`
- [ ] Support `OverrideUnlockedRetention` for gRPC plugin
- [ ] Support bucket metadata for object retention in the testbench
- [ ] Support object metadata for object retention in the testbench
- [ ] Upgrade the testbench
- [ ] Enable the object retention samples when running against the emulator

Details in go/gcs-object-retention-client-request

You can use the [java implementation](https://github.com/googleapis/java-storage/pull/2277) as a reference.

The kokoro test project should be allowlisted shortly, let me know if you need access to an allowlisted project for your own testing.

We're aiming to get this in by the November code freeze, let me know if you need any help.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.