Object Storage API, gRPC: BucketService

A set of methods for managing buckets.

Call	Description
List	Retrieves the list of buckets in the specified folder.
Get	Returns the specified bucket.
Create	Creates a bucket in the specified folder.
Update	Updates the specified bucket.
Delete	Deletes the specified bucket.
GetStats	Returns the statistics for the specified bucket.
GetHTTPSConfig	Returns the HTTPS configuration for the specified bucket.
SetHTTPSConfig	Updates the HTTPS configuration for the specified bucket.
DeleteHTTPSConfig	Deletes the HTTPS configuration for the specified bucket.

Calls BucketServiceCalls BucketService

ListList

Retrieves the list of buckets in the specified folder.
The following fields will not be returned for buckets in the list: Bucket.policy, Bucket.acl, Bucket.cors, Bucket.website_settings, Bucket.lifecycle_rules, Bucket.tags.

rpc List (ListBucketsRequest) returns (ListBucketsResponse)

ListBucketsRequestListBucketsRequest

Field	Description
folder_id	string Required. ID of the folder to list buckets in. To get the folder ID, make a yandex.cloud.resourcemanager.v1.FolderService.List request. The maximum string length in characters is 50.

ListBucketsResponseListBucketsResponse

Field	Description
buckets[]	Bucket List of buckets in the specified folder.

BucketBucket

Field	Description
id	string ID of the bucket. Always equal to name, which has priority.
name	string Name of the bucket. The name is unique within the platform. For naming limitations and rules, see documentation.
folder_id	string ID of the folder that the bucket belongs to.
anonymous_access_flags	AnonymousAccessFlags Flags for configuring public (anonymous) access to the bucket's content and settings. For details, see documentation.
default_storage_class	string Default storage class for objects in the bucket. Supported classes are standard storage (STANDARD), cold storage (COLD, STANDARD_IA, NEARLINE all synonyms), and ice storage (ICE and GLACIER are synonyms). For details, see documentation.
versioning	enum Versioning Bucket versioning status. For details, see documentation. VERSIONING_DISABLED: The bucket is unversioned, i.e. versioning has never been enabled for the bucket, including at its creation. Objects that are stored in the bucket have a version ID of null. To enable versioning, change status to VERSIONING_ENABLED via a BucketService.Update request. Note that this action is irreversible, and a bucket with versioning enabled can never return to VERSIONING_DISABLED state. VERSIONING_ENABLED: Bucket versioning is enabled, i.e. all new objects are versioned and given a unique version ID, and objects that already existed at the time versioning was enabled will be versioned and given a unique version ID when modified by future requests. To suspend versioning, change status to VERSIONING_SUSPENDED via a BucketService.Update request. You cannot disable versioning altogether for a bucket that already had it enabled; objects that had version IDs will keep them. VERSIONING_SUSPENDED: Bucket versioning is suspended, i.e. new objects are not versioned, but objects that already existed at the time versioning was suspended are still versioned and keep their version IDs. To resume versioning, change status to VERSIONING_ENABLED via a BucketService.Update request.
max_size	int64 Maximum size of the bucket, in bytes. For details, see documentation.
policy	google.protobuf.Struct Bucket policies that set permissions for actions with the bucket, its objects, and groups of objects. For details, see documentation.
acl	ACL Access control list (ACL) of the bucket. For details, see documentation.
created_at	google.protobuf.Timestamp Creation timestamp.
cors[]	CorsRule List of rules for cross-domain requests to objects in the bucket (cross-origin resource sharing, CORS). For details, see documentation.
website_settings	WebsiteSettings Configuration for hosting a static website in the bucket. For details, see documentation.
lifecycle_rules[]	LifecycleRule List of object lifecycle rules for the bucket. For details, see documentation.
tags[]	Tag List of tags for the bucket. For details, see documentation.
object_lock	ObjectLock Configuration for object lock on the bucket. For details about the concept, see documentation.
encryption	Encryption Configuration for bucket's encryption For detauls, see documentation

AnonymousAccessFlagsAnonymousAccessFlags

Field	Description
read	google.protobuf.BoolValue Specifies whether public (anonymous) access to read objects in the bucket is enabled.
list	google.protobuf.BoolValue Specifies whether public (anonymous) access to the list of objects in the bucket is enabled.
config_read	google.protobuf.BoolValue Specifies whether public (anonymous) access to read CORS, static website hosting, and object lifecycles settings of the bucket is enabled.

ACLACL

Field	Description
grants[]	Grant List of permissions granted and the grantees.

GrantGrant

Field	Description
permission	enum Permission Required. Permission granted by the grant. PERMISSION_FULL_CONTROL: Allows grantee the PERMISSION_WRITE, PERMISSION_WRITE_ACP, PERMISSION_READ, and PERMISSION_READ_ACP on the bucket. Maps to x-amz-grant-full-control header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_WRITE: Allows grantee to create new objects in the bucket. For the bucket and object owners of existing objects, also allows deletions and overwrites of those objects. Maps to x-amz-grant-write header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_WRITE_ACP: Allows grantee to write the ACL for the bucket. Maps to x-amz-grant-write-acp header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_READ: Allows grantee to list the objects in the bucket. Maps to x-amz-grant-read header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_READ_ACP: Allows grantee to read the bucket ACL Maps to x-amz-grant-read-acp header for bucketPutAcl method of Amazon S3-compatible HTTP API.
grant_type	enum GrantType Required. The grantee type for the grant. GRANT_TYPE_ACCOUNT: A grantee is an account on the platform. For this grantee type, you need to specify the user ID in Bucket.acl.grants.grantee_id field. To get user ID, see instruction. Maps to using id="*" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API). GRANT_TYPE_ALL_AUTHENTICATED_USERS: Grantees are all authenticated users, both from your clouds and other users' clouds. Access permission to this group allows any account on the platform to access the resource via a signed (authenticated) request. Maps to using uri="http://acs.amazonaws.com/groups/global/AuthenticatedUsers" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API). GRANT_TYPE_ALL_USERS: Grantees are all internet users. Access permission to this group allows anyone in the world access to the resource via signed (authenticated) or unsigned (anonymous) requests. Maps to using uri="http://acs.amazonaws.com/groups/global/AllUsers" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API).
grantee_id	string ID of the account who is a grantee. Required when the grant_type is GRANT_TYPE_ACCOUNT.

CorsRuleCorsRule

Field	Description
id	string ID of the CORS rule.
allowed_methods[]	enum Method List of HTTP methods allowed by the CORS rule. When a client sends a CORS-preflight options request with the Access-Control-Request-Method header (see S3-compatible API reference), the specified method is checked against the list of the allowed methods. If there is a match, all the allowed methods are listed in the Access-Control-Allow-Methods header of the response. The number of elements must be greater than 0. METHOD_GET: HTTP GET method. METHOD_HEAD: HTTP HEAD method. METHOD_POST: HTTP POST method. METHOD_PUT: HTTP PUT method. METHOD_DELETE: HTTP DELETE method.
allowed_headers[]	string List of HTTP headers allowed by the CORS rule. When a client sends a CORS-preflight options request with the Access-Control-Request-Headers header (see S3-compatible API reference), the specified headers are checked against the list of the allowed headers. If there is a match, the specified headers that are allowed are listed in the Access-Control-Allow-Headers header of the response. Each string in the list can contain at most one * wildcard character that matches 0 or more characters. For example, x-amz-* value will allow all Amazon S3-compatible headers.
allowed_origins[]	string List of request origins allowed by the CORS rule. Each string in the list can contain at most one * wildcard character that matches 0 or more characters. For example, http://*.example.com value will allow requests originating from all subdomains of example.com. The number of elements must be greater than 0.
expose_headers[]	string List of headers contained in responses to CORS requests that can be accessed by applications.
max_age_seconds	google.protobuf.Int64Value Time in seconds that a client can cache the response to a CORS-preflight request as identified by the object requested, the HTTP method, and the origin.

WebsiteSettingsWebsiteSettings

Field	Description
index	string Key of the index page object that is returned when a response is made to the root of the website. Either index or redirect_all_requests must be specified in order for the bucket to host a static website. If specified, the index page object must be located in the root of the bucket.
error	string Key of the error page object that is returned when an error occurs.
redirect_all_requests	Scheme Configuration for redirecting all requests sent to the website. Either redirect_all_requests or index must be specified in order for the bucket to host a static website. If redirect_all_requests is specified, it must be the only field in Bucket.website_settings.
routing_rules[]	RoutingRule List of redirect rules.

SchemeScheme

Field	Description
protocol	enum Protocol Scheme of the redirect URI. PROTOCOL_HTTP: http scheme. PROTOCOL_HTTPS: https scheme.
hostname	string Hostname of the redirect URI.

ConditionCondition

Field	Description
http_error_code_returned_equals	string HTTP status code (number only) that must match for the redirect to apply.
key_prefix_equals	string Prefix of the object key from which requests are redirected.

RedirectRedirect

Field	Description
hostname	string Hostname of the redirect URI.
http_redirect_code	string HTTP status code of the redirect response. Default value: "301". Value must match the regular expression 3(0[1-9]|[1-9][0-9]).
protocol	enum Protocol Scheme of the redirect URI. PROTOCOL_HTTP: http scheme. PROTOCOL_HTTPS: https scheme.
replace_key_prefix_with	string Substitution for the prefix of the object key specified in Condition.key_prefix_equals. At most one of replace_key_prefix_with and replace_key_with can be specified.
replace_key_with	string New object key. At most one of replace_key_with and replace_key_prefix_with can be specified.

RoutingRuleRoutingRule

Field	Description
condition	Condition Redirect condition.
redirect	Redirect Redirect instructions.

LifecycleRuleLifecycleRule

Field	Description
id	google.protobuf.StringValue ID of the rule. Provided by the client or generated at creation time.
enabled	bool Indicates whether the rule is in effect.
filter	RuleFilter Filter that identifies the objects to which the rule applies. If not specified, the rule applies to all objects in the bucket.
expiration	Expiration Expiration rule. The expiration of an object is described as follows. For the unversioned bucket (Bucket.versioning is VERSIONING_DISABLED), the object is deleted and cannot be recovered. For the bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED), the current version of the object (if it exists and is not a delete marker) is retained as a non-current version, and a delete marker becomes the current version of the object. For the bucket with versioning suspended (Bucket.versioning is VERSIONING_SUSPENDED), the current version of the object is retained as a non-current version if it is not a delete marker, or is removed otherwise, and a delete marker becomes the current version of the object.
transitions[]	Transition List of transition rules. The transition of an object is described as follows. For the unversioned bucket (Bucket.versioning is VERSIONING_DISABLED), the object is transitioned to the specified storage class. For the bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED), the current version of the object is transitioned to the specified storage class.
abort_incomplete_multipart_upload	AfterDays Configuration for aborting incomplete multipart uploads.
noncurrent_expiration	NoncurrentExpiration Expiration rule for non-current versions of objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). At expiration, the non-current version of the object is deleted and cannot be recovered.
noncurrent_transitions[]	NoncurrentTransition List of transition rules for non-current versions of objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). At transition, the non-current version of the object is transitioned to the specified storage class.
noncurrent_delete_markers	NoncurrentDeleteMarkers Expiration rule for non-current delete markers of an objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). Works in the same way as noncurrent_expiration rule, but only for delete markers. At expiration, the non-current delete marker of the object is deleted and cannot be recovered.

AfterDaysAfterDays

Field	Description
days_after_expiration	google.protobuf.Int64Value Time period, in number of days from the start of the multipart upload, after which the incomplete upload is aborted.

NoncurrentDeleteMarkersNoncurrentDeleteMarkers

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of a delete marker was classified as non-current, after which the delete marker expires.

NoncurrentExpirationNoncurrentExpiration

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of an object was classified as non-current, after which the version expires.

NoncurrentTransitionNoncurrentTransition

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of an object was classified as non-current, after which the version is transitioned.
storage_class	string Required. Storage class to which a non-current version of an object is transitioned from standard storage. The only supported class is cold storage (COLD, STANDARD_IA, NEARLINE all synonyms). Transitions from cold to standard storage and transitions to or from ice storage are not allowed.

TransitionTransition

Field	Description
date	google.protobuf.Timestamp Specific date of object transition. The rule continues to apply even after the date has passed, i.e. any new objects created in the bucket are transitioned immediately. At most one of date and days fields can be specified.
days	google.protobuf.Int64Value Time period, in number of days from the creation or modification of the object, after which an object is transitioned. At most one of days and date fields can be specified.
storage_class	string Required. Storage class to which an object is transitioned from standard storage. The only supported class is cold storage (COLD, STANDARD_IA, NEARLINE all synonyms). Transitions from cold to standard storage and transitions to or from ice storage are not allowed.

ExpirationExpiration

Field	Description
date	google.protobuf.Timestamp Specific date of object expiration. The rule continues to apply even after the date has passed, i.e. any new objects created in the bucket expire immediately. Exactly one of date, days, and expired_object_delete_marker fields can be specified.
days	google.protobuf.Int64Value Time period, in number of days from the creation or modification of the object, after which an object expires. Exactly one of days, date, and expired_object_delete_marker fields can be specified.
expired_object_delete_marker	google.protobuf.BoolValue Indicates whether a delete marker of an object with no non-current versions (referred to as an expired object delete marker) is removed at the object's expiration. Exactly one of expired_object_delete_marker, date, and days fields can be specified.

RuleFilterRuleFilter

Field	Description
prefix	string Key prefix that the object must have in order for the rule to apply.
object_size_greater_than	google.protobuf.Int64Value Size that the object must be greater.
object_size_less_than	google.protobuf.Int64Value Size that the object must be less t.
tag	Tag Tags that the object's tag set must have for the rule to apply.
and_operator	And Apply a logical AND to all of the predicates configured inside the And operator.

AndAnd

Field	Description
prefix	string
object_size_greater_than	google.protobuf.Int64Value
object_size_less_than	google.protobuf.Int64Value
tag[]	Tag

TagTag

Field	Description
key	string Key of the bucket tag.
value	string Value of the bucket tag.

ObjectLockObjectLock

Field	Description
status	enum ObjectLockStatus Default lock configuration for added objects
default_retention	DefaultRetention

DefaultRetentionDefaultRetention

Field	Description
mode	enum Mode Lock type
period	oneof: days or years
days	int64 Number of days for locking
years	int64 Number of years for locking

EncryptionEncryption

Field	Description
rules[]	EncryptionRule

EncryptionRuleEncryptionRule

Field	Description
kms_master_key_id	string
sse_algorithm	string

GetGet

Returns the specified bucket.
To get the list of all available buckets, make a List request.

rpc Get (GetBucketRequest) returns (Bucket)

GetBucketRequestGetBucketRequest

Field	Description
name	string Required. Name of the bucket to return. To get the bucket name, make a BucketService.List request.
view	enum View Scope of information about the bucket to return. Access to scopes is managed via Identity and Access Management roles, bucket ACL and policies. VIEW_BASIC: Returns basic information about a bucket. The following fields will not be returned: Bucket.acl, Bucket.cors, Bucket.website_settings, Bucket.lifecycle_rules, Bucket.tags. VIEW_ACL: Returns basic information and access control list (ACL) for the bucket. The following fields will not be returned: Bucket.cors, Bucket.website_settings, Bucket.lifecycle_rules, Bucket.tags. VIEW_FULL: Returns full information about a bucket.

BucketBucket

Field	Description
id	string ID of the bucket. Always equal to name, which has priority.
name	string Name of the bucket. The name is unique within the platform. For naming limitations and rules, see documentation.
folder_id	string ID of the folder that the bucket belongs to.
anonymous_access_flags	AnonymousAccessFlags Flags for configuring public (anonymous) access to the bucket's content and settings. For details, see documentation.
default_storage_class	string Default storage class for objects in the bucket. Supported classes are standard storage (STANDARD), cold storage (COLD, STANDARD_IA, NEARLINE all synonyms), and ice storage (ICE and GLACIER are synonyms). For details, see documentation.
versioning	enum Versioning Bucket versioning status. For details, see documentation. VERSIONING_DISABLED: The bucket is unversioned, i.e. versioning has never been enabled for the bucket, including at its creation. Objects that are stored in the bucket have a version ID of null. To enable versioning, change status to VERSIONING_ENABLED via a BucketService.Update request. Note that this action is irreversible, and a bucket with versioning enabled can never return to VERSIONING_DISABLED state. VERSIONING_ENABLED: Bucket versioning is enabled, i.e. all new objects are versioned and given a unique version ID, and objects that already existed at the time versioning was enabled will be versioned and given a unique version ID when modified by future requests. To suspend versioning, change status to VERSIONING_SUSPENDED via a BucketService.Update request. You cannot disable versioning altogether for a bucket that already had it enabled; objects that had version IDs will keep them. VERSIONING_SUSPENDED: Bucket versioning is suspended, i.e. new objects are not versioned, but objects that already existed at the time versioning was suspended are still versioned and keep their version IDs. To resume versioning, change status to VERSIONING_ENABLED via a BucketService.Update request.
max_size	int64 Maximum size of the bucket, in bytes. For details, see documentation.
policy	google.protobuf.Struct Bucket policies that set permissions for actions with the bucket, its objects, and groups of objects. For details, see documentation.
acl	ACL Access control list (ACL) of the bucket. For details, see documentation.
created_at	google.protobuf.Timestamp Creation timestamp.
cors[]	CorsRule List of rules for cross-domain requests to objects in the bucket (cross-origin resource sharing, CORS). For details, see documentation.
website_settings	WebsiteSettings Configuration for hosting a static website in the bucket. For details, see documentation.
lifecycle_rules[]	LifecycleRule List of object lifecycle rules for the bucket. For details, see documentation.
tags[]	Tag List of tags for the bucket. For details, see documentation.
object_lock	ObjectLock Configuration for object lock on the bucket. For details about the concept, see documentation.
encryption	Encryption Configuration for bucket's encryption For detauls, see documentation

AnonymousAccessFlagsAnonymousAccessFlags

Field	Description
read	google.protobuf.BoolValue Specifies whether public (anonymous) access to read objects in the bucket is enabled.
list	google.protobuf.BoolValue Specifies whether public (anonymous) access to the list of objects in the bucket is enabled.
config_read	google.protobuf.BoolValue Specifies whether public (anonymous) access to read CORS, static website hosting, and object lifecycles settings of the bucket is enabled.

ACLACL

Field	Description
grants[]	Grant List of permissions granted and the grantees.

GrantGrant

Field	Description
permission	enum Permission Required. Permission granted by the grant. PERMISSION_FULL_CONTROL: Allows grantee the PERMISSION_WRITE, PERMISSION_WRITE_ACP, PERMISSION_READ, and PERMISSION_READ_ACP on the bucket. Maps to x-amz-grant-full-control header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_WRITE: Allows grantee to create new objects in the bucket. For the bucket and object owners of existing objects, also allows deletions and overwrites of those objects. Maps to x-amz-grant-write header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_WRITE_ACP: Allows grantee to write the ACL for the bucket. Maps to x-amz-grant-write-acp header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_READ: Allows grantee to list the objects in the bucket. Maps to x-amz-grant-read header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_READ_ACP: Allows grantee to read the bucket ACL Maps to x-amz-grant-read-acp header for bucketPutAcl method of Amazon S3-compatible HTTP API.
grant_type	enum GrantType Required. The grantee type for the grant. GRANT_TYPE_ACCOUNT: A grantee is an account on the platform. For this grantee type, you need to specify the user ID in Bucket.acl.grants.grantee_id field. To get user ID, see instruction. Maps to using id="*" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API). GRANT_TYPE_ALL_AUTHENTICATED_USERS: Grantees are all authenticated users, both from your clouds and other users' clouds. Access permission to this group allows any account on the platform to access the resource via a signed (authenticated) request. Maps to using uri="http://acs.amazonaws.com/groups/global/AuthenticatedUsers" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API). GRANT_TYPE_ALL_USERS: Grantees are all internet users. Access permission to this group allows anyone in the world access to the resource via signed (authenticated) or unsigned (anonymous) requests. Maps to using uri="http://acs.amazonaws.com/groups/global/AllUsers" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API).
grantee_id	string ID of the account who is a grantee. Required when the grant_type is GRANT_TYPE_ACCOUNT.

CorsRuleCorsRule

Field	Description
id	string ID of the CORS rule.
allowed_methods[]	enum Method List of HTTP methods allowed by the CORS rule. When a client sends a CORS-preflight options request with the Access-Control-Request-Method header (see S3-compatible API reference), the specified method is checked against the list of the allowed methods. If there is a match, all the allowed methods are listed in the Access-Control-Allow-Methods header of the response. The number of elements must be greater than 0. METHOD_GET: HTTP GET method. METHOD_HEAD: HTTP HEAD method. METHOD_POST: HTTP POST method. METHOD_PUT: HTTP PUT method. METHOD_DELETE: HTTP DELETE method.
allowed_headers[]	string List of HTTP headers allowed by the CORS rule. When a client sends a CORS-preflight options request with the Access-Control-Request-Headers header (see S3-compatible API reference), the specified headers are checked against the list of the allowed headers. If there is a match, the specified headers that are allowed are listed in the Access-Control-Allow-Headers header of the response. Each string in the list can contain at most one * wildcard character that matches 0 or more characters. For example, x-amz-* value will allow all Amazon S3-compatible headers.
allowed_origins[]	string List of request origins allowed by the CORS rule. Each string in the list can contain at most one * wildcard character that matches 0 or more characters. For example, http://*.example.com value will allow requests originating from all subdomains of example.com. The number of elements must be greater than 0.
expose_headers[]	string List of headers contained in responses to CORS requests that can be accessed by applications.
max_age_seconds	google.protobuf.Int64Value Time in seconds that a client can cache the response to a CORS-preflight request as identified by the object requested, the HTTP method, and the origin.

WebsiteSettingsWebsiteSettings

Field	Description
index	string Key of the index page object that is returned when a response is made to the root of the website. Either index or redirect_all_requests must be specified in order for the bucket to host a static website. If specified, the index page object must be located in the root of the bucket.
error	string Key of the error page object that is returned when an error occurs.
redirect_all_requests	Scheme Configuration for redirecting all requests sent to the website. Either redirect_all_requests or index must be specified in order for the bucket to host a static website. If redirect_all_requests is specified, it must be the only field in Bucket.website_settings.
routing_rules[]	RoutingRule List of redirect rules.

SchemeScheme

Field	Description
protocol	enum Protocol Scheme of the redirect URI. PROTOCOL_HTTP: http scheme. PROTOCOL_HTTPS: https scheme.
hostname	string Hostname of the redirect URI.

ConditionCondition

Field	Description
http_error_code_returned_equals	string HTTP status code (number only) that must match for the redirect to apply.
key_prefix_equals	string Prefix of the object key from which requests are redirected.

RedirectRedirect

Field	Description
hostname	string Hostname of the redirect URI.
http_redirect_code	string HTTP status code of the redirect response. Default value: "301". Value must match the regular expression 3(0[1-9]|[1-9][0-9]).
protocol	enum Protocol Scheme of the redirect URI. PROTOCOL_HTTP: http scheme. PROTOCOL_HTTPS: https scheme.
replace_key_prefix_with	string Substitution for the prefix of the object key specified in Condition.key_prefix_equals. At most one of replace_key_prefix_with and replace_key_with can be specified.
replace_key_with	string New object key. At most one of replace_key_with and replace_key_prefix_with can be specified.

RoutingRuleRoutingRule

Field	Description
condition	Condition Redirect condition.
redirect	Redirect Redirect instructions.

LifecycleRuleLifecycleRule

Field	Description
id	google.protobuf.StringValue ID of the rule. Provided by the client or generated at creation time.
enabled	bool Indicates whether the rule is in effect.
filter	RuleFilter Filter that identifies the objects to which the rule applies. If not specified, the rule applies to all objects in the bucket.
expiration	Expiration Expiration rule. The expiration of an object is described as follows. For the unversioned bucket (Bucket.versioning is VERSIONING_DISABLED), the object is deleted and cannot be recovered. For the bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED), the current version of the object (if it exists and is not a delete marker) is retained as a non-current version, and a delete marker becomes the current version of the object. For the bucket with versioning suspended (Bucket.versioning is VERSIONING_SUSPENDED), the current version of the object is retained as a non-current version if it is not a delete marker, or is removed otherwise, and a delete marker becomes the current version of the object.
transitions[]	Transition List of transition rules. The transition of an object is described as follows. For the unversioned bucket (Bucket.versioning is VERSIONING_DISABLED), the object is transitioned to the specified storage class. For the bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED), the current version of the object is transitioned to the specified storage class.
abort_incomplete_multipart_upload	AfterDays Configuration for aborting incomplete multipart uploads.
noncurrent_expiration	NoncurrentExpiration Expiration rule for non-current versions of objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). At expiration, the non-current version of the object is deleted and cannot be recovered.
noncurrent_transitions[]	NoncurrentTransition List of transition rules for non-current versions of objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). At transition, the non-current version of the object is transitioned to the specified storage class.
noncurrent_delete_markers	NoncurrentDeleteMarkers Expiration rule for non-current delete markers of an objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). Works in the same way as noncurrent_expiration rule, but only for delete markers. At expiration, the non-current delete marker of the object is deleted and cannot be recovered.

AfterDaysAfterDays

Field	Description
days_after_expiration	google.protobuf.Int64Value Time period, in number of days from the start of the multipart upload, after which the incomplete upload is aborted.

NoncurrentDeleteMarkersNoncurrentDeleteMarkers

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of a delete marker was classified as non-current, after which the delete marker expires.

NoncurrentExpirationNoncurrentExpiration

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of an object was classified as non-current, after which the version expires.

NoncurrentTransitionNoncurrentTransition

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of an object was classified as non-current, after which the version is transitioned.
storage_class	string Required. Storage class to which a non-current version of an object is transitioned from standard storage. The only supported class is cold storage (COLD, STANDARD_IA, NEARLINE all synonyms). Transitions from cold to standard storage and transitions to or from ice storage are not allowed.

TransitionTransition

Field	Description
date	google.protobuf.Timestamp Specific date of object transition. The rule continues to apply even after the date has passed, i.e. any new objects created in the bucket are transitioned immediately. At most one of date and days fields can be specified.
days	google.protobuf.Int64Value Time period, in number of days from the creation or modification of the object, after which an object is transitioned. At most one of days and date fields can be specified.
storage_class	string Required. Storage class to which an object is transitioned from standard storage. The only supported class is cold storage (COLD, STANDARD_IA, NEARLINE all synonyms). Transitions from cold to standard storage and transitions to or from ice storage are not allowed.

ExpirationExpiration

Field	Description
date	google.protobuf.Timestamp Specific date of object expiration. The rule continues to apply even after the date has passed, i.e. any new objects created in the bucket expire immediately. Exactly one of date, days, and expired_object_delete_marker fields can be specified.
days	google.protobuf.Int64Value Time period, in number of days from the creation or modification of the object, after which an object expires. Exactly one of days, date, and expired_object_delete_marker fields can be specified.
expired_object_delete_marker	google.protobuf.BoolValue Indicates whether a delete marker of an object with no non-current versions (referred to as an expired object delete marker) is removed at the object's expiration. Exactly one of expired_object_delete_marker, date, and days fields can be specified.

RuleFilterRuleFilter

Field	Description
prefix	string Key prefix that the object must have in order for the rule to apply.
object_size_greater_than	google.protobuf.Int64Value Size that the object must be greater.
object_size_less_than	google.protobuf.Int64Value Size that the object must be less t.
tag	Tag Tags that the object's tag set must have for the rule to apply.
and_operator	And Apply a logical AND to all of the predicates configured inside the And operator.

AndAnd

Field	Description
prefix	string
object_size_greater_than	google.protobuf.Int64Value
object_size_less_than	google.protobuf.Int64Value
tag[]	Tag

TagTag

Field	Description
key	string Key of the bucket tag.
value	string Value of the bucket tag.

ObjectLockObjectLock

Field	Description
status	enum ObjectLockStatus Default lock configuration for added objects
default_retention	DefaultRetention

DefaultRetentionDefaultRetention

Field	Description
mode	enum Mode Lock type
period	oneof: days or years
days	int64 Number of days for locking
years	int64 Number of years for locking

EncryptionEncryption

Field	Description
rules[]	EncryptionRule

EncryptionRuleEncryptionRule

Field	Description
kms_master_key_id	string
sse_algorithm	string

CreateCreate

Creates a bucket in the specified folder.

rpc Create (CreateBucketRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:CreateBucketMetadata

    Operation.response:Bucket

CreateBucketRequestCreateBucketRequest

Field	Description
name	string Required. Name of the bucket. The name must be unique within the platform. For naming limitations and rules, see documentation.
folder_id	string Required. ID of the folder to create a bucket in. To get the folder ID, make a yandex.cloud.resourcemanager.v1.FolderService.List request. The maximum string length in characters is 50.
default_storage_class	string Default storage class for objects in the bucket. Supported classes are standard storage (STANDARD), cold storage (COLD, STANDARD_IA, NEARLINE all synonyms), and ice storage (ICE and GLACIER are synonyms). For details, see documentation.
max_size	int64 Maximum size of the bucket. For details, see documentation.
anonymous_access_flags	AnonymousAccessFlags Flags for configuring public (anonymous) access to the bucket's content and settings. For details, see documentation.
acl	ACL Access control list (ACL) of the bucket. For details, see documentation.
tags[]	Tag List of tags for the bucket. For details, see documentation.

AnonymousAccessFlagsAnonymousAccessFlags

Field	Description
read	google.protobuf.BoolValue Specifies whether public (anonymous) access to read objects in the bucket is enabled.
list	google.protobuf.BoolValue Specifies whether public (anonymous) access to the list of objects in the bucket is enabled.
config_read	google.protobuf.BoolValue Specifies whether public (anonymous) access to read CORS, static website hosting, and object lifecycles settings of the bucket is enabled.

ACLACL

Field	Description
grants[]	Grant List of permissions granted and the grantees.

GrantGrant

Field	Description
permission	enum Permission Required. Permission granted by the grant. PERMISSION_FULL_CONTROL: Allows grantee the PERMISSION_WRITE, PERMISSION_WRITE_ACP, PERMISSION_READ, and PERMISSION_READ_ACP on the bucket. Maps to x-amz-grant-full-control header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_WRITE: Allows grantee to create new objects in the bucket. For the bucket and object owners of existing objects, also allows deletions and overwrites of those objects. Maps to x-amz-grant-write header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_WRITE_ACP: Allows grantee to write the ACL for the bucket. Maps to x-amz-grant-write-acp header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_READ: Allows grantee to list the objects in the bucket. Maps to x-amz-grant-read header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_READ_ACP: Allows grantee to read the bucket ACL Maps to x-amz-grant-read-acp header for bucketPutAcl method of Amazon S3-compatible HTTP API.
grant_type	enum GrantType Required. The grantee type for the grant. GRANT_TYPE_ACCOUNT: A grantee is an account on the platform. For this grantee type, you need to specify the user ID in Bucket.acl.grants.grantee_id field. To get user ID, see instruction. Maps to using id="*" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API). GRANT_TYPE_ALL_AUTHENTICATED_USERS: Grantees are all authenticated users, both from your clouds and other users' clouds. Access permission to this group allows any account on the platform to access the resource via a signed (authenticated) request. Maps to using uri="http://acs.amazonaws.com/groups/global/AuthenticatedUsers" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API). GRANT_TYPE_ALL_USERS: Grantees are all internet users. Access permission to this group allows anyone in the world access to the resource via signed (authenticated) or unsigned (anonymous) requests. Maps to using uri="http://acs.amazonaws.com/groups/global/AllUsers" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API).
grantee_id	string ID of the account who is a grantee. Required when the grant_type is GRANT_TYPE_ACCOUNT.

TagTag

Field	Description
key	string Key of the bucket tag.
value	string Value of the bucket tag.

OperationOperation

Field	Description
id	string ID of the operation.
description	string Description of the operation. 0-256 characters long.
created_at	google.protobuf.Timestamp Creation timestamp.
created_by	string ID of the user or service account who initiated the operation.
modified_at	google.protobuf.Timestamp The time when the Operation resource was last modified.
done	bool If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata	google.protobuf.Any<CreateBucketMetadata> Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result	oneof: error or response The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
error	google.rpc.Status The error result of the operation in case of failure or cancellation.
response	google.protobuf.Any<Bucket> if operation finished successfully.

CreateBucketMetadataCreateBucketMetadata

Field	Description
name	string Name of the bucket that is being created.

BucketBucket

Field	Description
id	string ID of the bucket. Always equal to name, which has priority.
name	string Name of the bucket. The name is unique within the platform. For naming limitations and rules, see documentation.
folder_id	string ID of the folder that the bucket belongs to.
anonymous_access_flags	AnonymousAccessFlags Flags for configuring public (anonymous) access to the bucket's content and settings. For details, see documentation.
default_storage_class	string Default storage class for objects in the bucket. Supported classes are standard storage (STANDARD), cold storage (COLD, STANDARD_IA, NEARLINE all synonyms), and ice storage (ICE and GLACIER are synonyms). For details, see documentation.
versioning	enum Versioning Bucket versioning status. For details, see documentation. VERSIONING_DISABLED: The bucket is unversioned, i.e. versioning has never been enabled for the bucket, including at its creation. Objects that are stored in the bucket have a version ID of null. To enable versioning, change status to VERSIONING_ENABLED via a BucketService.Update request. Note that this action is irreversible, and a bucket with versioning enabled can never return to VERSIONING_DISABLED state. VERSIONING_ENABLED: Bucket versioning is enabled, i.e. all new objects are versioned and given a unique version ID, and objects that already existed at the time versioning was enabled will be versioned and given a unique version ID when modified by future requests. To suspend versioning, change status to VERSIONING_SUSPENDED via a BucketService.Update request. You cannot disable versioning altogether for a bucket that already had it enabled; objects that had version IDs will keep them. VERSIONING_SUSPENDED: Bucket versioning is suspended, i.e. new objects are not versioned, but objects that already existed at the time versioning was suspended are still versioned and keep their version IDs. To resume versioning, change status to VERSIONING_ENABLED via a BucketService.Update request.
max_size	int64 Maximum size of the bucket, in bytes. For details, see documentation.
policy	google.protobuf.Struct Bucket policies that set permissions for actions with the bucket, its objects, and groups of objects. For details, see documentation.
acl	ACL Access control list (ACL) of the bucket. For details, see documentation.
created_at	google.protobuf.Timestamp Creation timestamp.
cors[]	CorsRule List of rules for cross-domain requests to objects in the bucket (cross-origin resource sharing, CORS). For details, see documentation.
website_settings	WebsiteSettings Configuration for hosting a static website in the bucket. For details, see documentation.
lifecycle_rules[]	LifecycleRule List of object lifecycle rules for the bucket. For details, see documentation.
tags[]	Tag List of tags for the bucket. For details, see documentation.
object_lock	ObjectLock Configuration for object lock on the bucket. For details about the concept, see documentation.
encryption	Encryption Configuration for bucket's encryption For detauls, see documentation

CorsRuleCorsRule

Field	Description
id	string ID of the CORS rule.
allowed_methods[]	enum Method List of HTTP methods allowed by the CORS rule. When a client sends a CORS-preflight options request with the Access-Control-Request-Method header (see S3-compatible API reference), the specified method is checked against the list of the allowed methods. If there is a match, all the allowed methods are listed in the Access-Control-Allow-Methods header of the response. The number of elements must be greater than 0. METHOD_GET: HTTP GET method. METHOD_HEAD: HTTP HEAD method. METHOD_POST: HTTP POST method. METHOD_PUT: HTTP PUT method. METHOD_DELETE: HTTP DELETE method.
allowed_headers[]	string List of HTTP headers allowed by the CORS rule. When a client sends a CORS-preflight options request with the Access-Control-Request-Headers header (see S3-compatible API reference), the specified headers are checked against the list of the allowed headers. If there is a match, the specified headers that are allowed are listed in the Access-Control-Allow-Headers header of the response. Each string in the list can contain at most one * wildcard character that matches 0 or more characters. For example, x-amz-* value will allow all Amazon S3-compatible headers.
allowed_origins[]	string List of request origins allowed by the CORS rule. Each string in the list can contain at most one * wildcard character that matches 0 or more characters. For example, http://*.example.com value will allow requests originating from all subdomains of example.com. The number of elements must be greater than 0.
expose_headers[]	string List of headers contained in responses to CORS requests that can be accessed by applications.
max_age_seconds	google.protobuf.Int64Value Time in seconds that a client can cache the response to a CORS-preflight request as identified by the object requested, the HTTP method, and the origin.

WebsiteSettingsWebsiteSettings

Field	Description
index	string Key of the index page object that is returned when a response is made to the root of the website. Either index or redirect_all_requests must be specified in order for the bucket to host a static website. If specified, the index page object must be located in the root of the bucket.
error	string Key of the error page object that is returned when an error occurs.
redirect_all_requests	Scheme Configuration for redirecting all requests sent to the website. Either redirect_all_requests or index must be specified in order for the bucket to host a static website. If redirect_all_requests is specified, it must be the only field in Bucket.website_settings.
routing_rules[]	RoutingRule List of redirect rules.

SchemeScheme

Field	Description
protocol	enum Protocol Scheme of the redirect URI. PROTOCOL_HTTP: http scheme. PROTOCOL_HTTPS: https scheme.
hostname	string Hostname of the redirect URI.

ConditionCondition

Field	Description
http_error_code_returned_equals	string HTTP status code (number only) that must match for the redirect to apply.
key_prefix_equals	string Prefix of the object key from which requests are redirected.

RedirectRedirect

Field	Description
hostname	string Hostname of the redirect URI.
http_redirect_code	string HTTP status code of the redirect response. Default value: "301". Value must match the regular expression 3(0[1-9]|[1-9][0-9]).
protocol	enum Protocol Scheme of the redirect URI. PROTOCOL_HTTP: http scheme. PROTOCOL_HTTPS: https scheme.
replace_key_prefix_with	string Substitution for the prefix of the object key specified in Condition.key_prefix_equals. At most one of replace_key_prefix_with and replace_key_with can be specified.
replace_key_with	string New object key. At most one of replace_key_with and replace_key_prefix_with can be specified.

RoutingRuleRoutingRule

Field	Description
condition	Condition Redirect condition.
redirect	Redirect Redirect instructions.

LifecycleRuleLifecycleRule

Field	Description
id	google.protobuf.StringValue ID of the rule. Provided by the client or generated at creation time.
enabled	bool Indicates whether the rule is in effect.
filter	RuleFilter Filter that identifies the objects to which the rule applies. If not specified, the rule applies to all objects in the bucket.
expiration	Expiration Expiration rule. The expiration of an object is described as follows. For the unversioned bucket (Bucket.versioning is VERSIONING_DISABLED), the object is deleted and cannot be recovered. For the bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED), the current version of the object (if it exists and is not a delete marker) is retained as a non-current version, and a delete marker becomes the current version of the object. For the bucket with versioning suspended (Bucket.versioning is VERSIONING_SUSPENDED), the current version of the object is retained as a non-current version if it is not a delete marker, or is removed otherwise, and a delete marker becomes the current version of the object.
transitions[]	Transition List of transition rules. The transition of an object is described as follows. For the unversioned bucket (Bucket.versioning is VERSIONING_DISABLED), the object is transitioned to the specified storage class. For the bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED), the current version of the object is transitioned to the specified storage class.
abort_incomplete_multipart_upload	AfterDays Configuration for aborting incomplete multipart uploads.
noncurrent_expiration	NoncurrentExpiration Expiration rule for non-current versions of objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). At expiration, the non-current version of the object is deleted and cannot be recovered.
noncurrent_transitions[]	NoncurrentTransition List of transition rules for non-current versions of objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). At transition, the non-current version of the object is transitioned to the specified storage class.
noncurrent_delete_markers	NoncurrentDeleteMarkers Expiration rule for non-current delete markers of an objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). Works in the same way as noncurrent_expiration rule, but only for delete markers. At expiration, the non-current delete marker of the object is deleted and cannot be recovered.

AfterDaysAfterDays

Field	Description
days_after_expiration	google.protobuf.Int64Value Time period, in number of days from the start of the multipart upload, after which the incomplete upload is aborted.

NoncurrentDeleteMarkersNoncurrentDeleteMarkers

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of a delete marker was classified as non-current, after which the delete marker expires.

NoncurrentExpirationNoncurrentExpiration

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of an object was classified as non-current, after which the version expires.

NoncurrentTransitionNoncurrentTransition

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of an object was classified as non-current, after which the version is transitioned.
storage_class	string Required. Storage class to which a non-current version of an object is transitioned from standard storage. The only supported class is cold storage (COLD, STANDARD_IA, NEARLINE all synonyms). Transitions from cold to standard storage and transitions to or from ice storage are not allowed.

TransitionTransition

Field	Description
date	google.protobuf.Timestamp Specific date of object transition. The rule continues to apply even after the date has passed, i.e. any new objects created in the bucket are transitioned immediately. At most one of date and days fields can be specified.
days	google.protobuf.Int64Value Time period, in number of days from the creation or modification of the object, after which an object is transitioned. At most one of days and date fields can be specified.
storage_class	string Required. Storage class to which an object is transitioned from standard storage. The only supported class is cold storage (COLD, STANDARD_IA, NEARLINE all synonyms). Transitions from cold to standard storage and transitions to or from ice storage are not allowed.

ExpirationExpiration

Field	Description
date	google.protobuf.Timestamp Specific date of object expiration. The rule continues to apply even after the date has passed, i.e. any new objects created in the bucket expire immediately. Exactly one of date, days, and expired_object_delete_marker fields can be specified.
days	google.protobuf.Int64Value Time period, in number of days from the creation or modification of the object, after which an object expires. Exactly one of days, date, and expired_object_delete_marker fields can be specified.
expired_object_delete_marker	google.protobuf.BoolValue Indicates whether a delete marker of an object with no non-current versions (referred to as an expired object delete marker) is removed at the object's expiration. Exactly one of expired_object_delete_marker, date, and days fields can be specified.

RuleFilterRuleFilter

Field	Description
prefix	string Key prefix that the object must have in order for the rule to apply.
object_size_greater_than	google.protobuf.Int64Value Size that the object must be greater.
object_size_less_than	google.protobuf.Int64Value Size that the object must be less t.
tag	Tag Tags that the object's tag set must have for the rule to apply.
and_operator	And Apply a logical AND to all of the predicates configured inside the And operator.

AndAnd

Field	Description
prefix	string
object_size_greater_than	google.protobuf.Int64Value
object_size_less_than	google.protobuf.Int64Value
tag[]	Tag

ObjectLockObjectLock

Field	Description
status	enum ObjectLockStatus Default lock configuration for added objects
default_retention	DefaultRetention

DefaultRetentionDefaultRetention

Field	Description
mode	enum Mode Lock type
period	oneof: days or years
days	int64 Number of days for locking
years	int64 Number of years for locking

EncryptionEncryption

Field	Description
rules[]	EncryptionRule

EncryptionRuleEncryptionRule

Field	Description
kms_master_key_id	string
sse_algorithm	string

UpdateUpdate

Updates the specified bucket.
In most cases, storage.editor role (see documentation) should be enough to update a bucket, subject to its policy.

rpc Update (UpdateBucketRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:UpdateBucketMetadata

    Operation.response:Bucket

UpdateBucketRequestUpdateBucketRequest

Field	Description
name	string Required. Name of the bucket to update. The name cannot be updated. To get the bucket name, make a BucketService.List request.
update_mask	google.protobuf.FieldMask Required. Update mask that specifies which attributes of the bucket should be updated. Use * for full update.
anonymous_access_flags	AnonymousAccessFlags Flags for configuring public (anonymous) access to the bucket's content and settings. For details, see documentation.
default_storage_class	string Default storage class for objects in the bucket. Supported classes are standard storage (STANDARD), cold storage (COLD, STANDARD_IA, NEARLINE all synonyms), and ice storage (ICE and GLACIER are synonyms). For details, see documentation.
max_size	int64 Maximum size of the bucket, in bytes. For details, see documentation.
cors[]	CorsRule List of rules for cross-domain requests to objects in the bucket (cross-origin resource sharing, CORS). For details, see documentation.
website_settings	WebsiteSettings Configuration for hosting a static website in the bucket. For details, see documentation.
versioning	enum Versioning Bucket versioning status. For details, see documentation. VERSIONING_DISABLED: The bucket is unversioned, i.e. versioning has never been enabled for the bucket, including at its creation. Objects that are stored in the bucket have a version ID of null. To enable versioning, change status to VERSIONING_ENABLED via a BucketService.Update request. Note that this action is irreversible, and a bucket with versioning enabled can never return to VERSIONING_DISABLED state. VERSIONING_ENABLED: Bucket versioning is enabled, i.e. all new objects are versioned and given a unique version ID, and objects that already existed at the time versioning was enabled will be versioned and given a unique version ID when modified by future requests. To suspend versioning, change status to VERSIONING_SUSPENDED via a BucketService.Update request. You cannot disable versioning altogether for a bucket that already had it enabled; objects that had version IDs will keep them. VERSIONING_SUSPENDED: Bucket versioning is suspended, i.e. new objects are not versioned, but objects that already existed at the time versioning was suspended are still versioned and keep their version IDs. To resume versioning, change status to VERSIONING_ENABLED via a BucketService.Update request.
lifecycle_rules[]	LifecycleRule List of object lifecycle rules for the bucket. For details, see documentation.
policy	google.protobuf.Struct Bucket policies that set permissions for actions with the bucket, its objects, and groups of objects. For details, see documentation.
acl	ACL Access control list (ACL) of the bucket. For details, see documentation.
tags[]	Tag List of tags for the bucket. For details, see documentation.
object_lock	ObjectLock Configuration for object lock on the bucket. For details about the concept, see documentation.
encryption	Encryption Configuration for bucket's encryption For detauls, see documentation

AnonymousAccessFlagsAnonymousAccessFlags

Field	Description
read	google.protobuf.BoolValue Specifies whether public (anonymous) access to read objects in the bucket is enabled.
list	google.protobuf.BoolValue Specifies whether public (anonymous) access to the list of objects in the bucket is enabled.
config_read	google.protobuf.BoolValue Specifies whether public (anonymous) access to read CORS, static website hosting, and object lifecycles settings of the bucket is enabled.

CorsRuleCorsRule

Field	Description
id	string ID of the CORS rule.
allowed_methods[]	enum Method List of HTTP methods allowed by the CORS rule. When a client sends a CORS-preflight options request with the Access-Control-Request-Method header (see S3-compatible API reference), the specified method is checked against the list of the allowed methods. If there is a match, all the allowed methods are listed in the Access-Control-Allow-Methods header of the response. The number of elements must be greater than 0. METHOD_GET: HTTP GET method. METHOD_HEAD: HTTP HEAD method. METHOD_POST: HTTP POST method. METHOD_PUT: HTTP PUT method. METHOD_DELETE: HTTP DELETE method.
allowed_headers[]	string List of HTTP headers allowed by the CORS rule. When a client sends a CORS-preflight options request with the Access-Control-Request-Headers header (see S3-compatible API reference), the specified headers are checked against the list of the allowed headers. If there is a match, the specified headers that are allowed are listed in the Access-Control-Allow-Headers header of the response. Each string in the list can contain at most one * wildcard character that matches 0 or more characters. For example, x-amz-* value will allow all Amazon S3-compatible headers.
allowed_origins[]	string List of request origins allowed by the CORS rule. Each string in the list can contain at most one * wildcard character that matches 0 or more characters. For example, http://*.example.com value will allow requests originating from all subdomains of example.com. The number of elements must be greater than 0.
expose_headers[]	string List of headers contained in responses to CORS requests that can be accessed by applications.
max_age_seconds	google.protobuf.Int64Value Time in seconds that a client can cache the response to a CORS-preflight request as identified by the object requested, the HTTP method, and the origin.

WebsiteSettingsWebsiteSettings

Field	Description
index	string Key of the index page object that is returned when a response is made to the root of the website. Either index or redirect_all_requests must be specified in order for the bucket to host a static website. If specified, the index page object must be located in the root of the bucket.
error	string Key of the error page object that is returned when an error occurs.
redirect_all_requests	Scheme Configuration for redirecting all requests sent to the website. Either redirect_all_requests or index must be specified in order for the bucket to host a static website. If redirect_all_requests is specified, it must be the only field in Bucket.website_settings.
routing_rules[]	RoutingRule List of redirect rules.

SchemeScheme

Field	Description
protocol	enum Protocol Scheme of the redirect URI. PROTOCOL_HTTP: http scheme. PROTOCOL_HTTPS: https scheme.
hostname	string Hostname of the redirect URI.

ConditionCondition

Field	Description
http_error_code_returned_equals	string HTTP status code (number only) that must match for the redirect to apply.
key_prefix_equals	string Prefix of the object key from which requests are redirected.

RedirectRedirect

Field	Description
hostname	string Hostname of the redirect URI.
http_redirect_code	string HTTP status code of the redirect response. Default value: "301". Value must match the regular expression 3(0[1-9]|[1-9][0-9]).
protocol	enum Protocol Scheme of the redirect URI. PROTOCOL_HTTP: http scheme. PROTOCOL_HTTPS: https scheme.
replace_key_prefix_with	string Substitution for the prefix of the object key specified in Condition.key_prefix_equals. At most one of replace_key_prefix_with and replace_key_with can be specified.
replace_key_with	string New object key. At most one of replace_key_with and replace_key_prefix_with can be specified.

RoutingRuleRoutingRule

Field	Description
condition	Condition Redirect condition.
redirect	Redirect Redirect instructions.

LifecycleRuleLifecycleRule

Field	Description
id	google.protobuf.StringValue ID of the rule. Provided by the client or generated at creation time.
enabled	bool Indicates whether the rule is in effect.
filter	RuleFilter Filter that identifies the objects to which the rule applies. If not specified, the rule applies to all objects in the bucket.
expiration	Expiration Expiration rule. The expiration of an object is described as follows. For the unversioned bucket (Bucket.versioning is VERSIONING_DISABLED), the object is deleted and cannot be recovered. For the bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED), the current version of the object (if it exists and is not a delete marker) is retained as a non-current version, and a delete marker becomes the current version of the object. For the bucket with versioning suspended (Bucket.versioning is VERSIONING_SUSPENDED), the current version of the object is retained as a non-current version if it is not a delete marker, or is removed otherwise, and a delete marker becomes the current version of the object.
transitions[]	Transition List of transition rules. The transition of an object is described as follows. For the unversioned bucket (Bucket.versioning is VERSIONING_DISABLED), the object is transitioned to the specified storage class. For the bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED), the current version of the object is transitioned to the specified storage class.
abort_incomplete_multipart_upload	AfterDays Configuration for aborting incomplete multipart uploads.
noncurrent_expiration	NoncurrentExpiration Expiration rule for non-current versions of objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). At expiration, the non-current version of the object is deleted and cannot be recovered.
noncurrent_transitions[]	NoncurrentTransition List of transition rules for non-current versions of objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). At transition, the non-current version of the object is transitioned to the specified storage class.
noncurrent_delete_markers	NoncurrentDeleteMarkers Expiration rule for non-current delete markers of an objects in a bucket with versioning enabled (Bucket.versioning is VERSIONING_ENABLED) or suspended (VERSIONING_SUSPENDED). Works in the same way as noncurrent_expiration rule, but only for delete markers. At expiration, the non-current delete marker of the object is deleted and cannot be recovered.

AfterDaysAfterDays

Field	Description
days_after_expiration	google.protobuf.Int64Value Time period, in number of days from the start of the multipart upload, after which the incomplete upload is aborted.

NoncurrentDeleteMarkersNoncurrentDeleteMarkers

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of a delete marker was classified as non-current, after which the delete marker expires.

NoncurrentExpirationNoncurrentExpiration

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of an object was classified as non-current, after which the version expires.

NoncurrentTransitionNoncurrentTransition

Field	Description
noncurrent_days	google.protobuf.Int64Value Time period, in number of days since the version of an object was classified as non-current, after which the version is transitioned.
storage_class	string Required. Storage class to which a non-current version of an object is transitioned from standard storage. The only supported class is cold storage (COLD, STANDARD_IA, NEARLINE all synonyms). Transitions from cold to standard storage and transitions to or from ice storage are not allowed.

TransitionTransition

Field	Description
date	google.protobuf.Timestamp Specific date of object transition. The rule continues to apply even after the date has passed, i.e. any new objects created in the bucket are transitioned immediately. At most one of date and days fields can be specified.
days	google.protobuf.Int64Value Time period, in number of days from the creation or modification of the object, after which an object is transitioned. At most one of days and date fields can be specified.
storage_class	string Required. Storage class to which an object is transitioned from standard storage. The only supported class is cold storage (COLD, STANDARD_IA, NEARLINE all synonyms). Transitions from cold to standard storage and transitions to or from ice storage are not allowed.

ExpirationExpiration

Field	Description
date	google.protobuf.Timestamp Specific date of object expiration. The rule continues to apply even after the date has passed, i.e. any new objects created in the bucket expire immediately. Exactly one of date, days, and expired_object_delete_marker fields can be specified.
days	google.protobuf.Int64Value Time period, in number of days from the creation or modification of the object, after which an object expires. Exactly one of days, date, and expired_object_delete_marker fields can be specified.
expired_object_delete_marker	google.protobuf.BoolValue Indicates whether a delete marker of an object with no non-current versions (referred to as an expired object delete marker) is removed at the object's expiration. Exactly one of expired_object_delete_marker, date, and days fields can be specified.

RuleFilterRuleFilter

Field	Description
prefix	string Key prefix that the object must have in order for the rule to apply.
object_size_greater_than	google.protobuf.Int64Value Size that the object must be greater.
object_size_less_than	google.protobuf.Int64Value Size that the object must be less t.
tag	Tag Tags that the object's tag set must have for the rule to apply.
and_operator	And Apply a logical AND to all of the predicates configured inside the And operator.

AndAnd

Field	Description
prefix	string
object_size_greater_than	google.protobuf.Int64Value
object_size_less_than	google.protobuf.Int64Value
tag[]	Tag

ACLACL

Field	Description
grants[]	Grant List of permissions granted and the grantees.

GrantGrant

Field	Description
permission	enum Permission Required. Permission granted by the grant. PERMISSION_FULL_CONTROL: Allows grantee the PERMISSION_WRITE, PERMISSION_WRITE_ACP, PERMISSION_READ, and PERMISSION_READ_ACP on the bucket. Maps to x-amz-grant-full-control header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_WRITE: Allows grantee to create new objects in the bucket. For the bucket and object owners of existing objects, also allows deletions and overwrites of those objects. Maps to x-amz-grant-write header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_WRITE_ACP: Allows grantee to write the ACL for the bucket. Maps to x-amz-grant-write-acp header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_READ: Allows grantee to list the objects in the bucket. Maps to x-amz-grant-read header for bucketPutAcl method of Amazon S3-compatible HTTP API. PERMISSION_READ_ACP: Allows grantee to read the bucket ACL Maps to x-amz-grant-read-acp header for bucketPutAcl method of Amazon S3-compatible HTTP API.
grant_type	enum GrantType Required. The grantee type for the grant. GRANT_TYPE_ACCOUNT: A grantee is an account on the platform. For this grantee type, you need to specify the user ID in Bucket.acl.grants.grantee_id field. To get user ID, see instruction. Maps to using id="*" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API). GRANT_TYPE_ALL_AUTHENTICATED_USERS: Grantees are all authenticated users, both from your clouds and other users' clouds. Access permission to this group allows any account on the platform to access the resource via a signed (authenticated) request. Maps to using uri="http://acs.amazonaws.com/groups/global/AuthenticatedUsers" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API). GRANT_TYPE_ALL_USERS: Grantees are all internet users. Access permission to this group allows anyone in the world access to the resource via signed (authenticated) or unsigned (anonymous) requests. Maps to using uri="http://acs.amazonaws.com/groups/global/AllUsers" value for x-amz-grant-* header (bucketPutAcl method of Amazon S3-compatible HTTP API).
grantee_id	string ID of the account who is a grantee. Required when the grant_type is GRANT_TYPE_ACCOUNT.

TagTag

Field	Description
key	string Key of the bucket tag.
value	string Value of the bucket tag.

ObjectLockObjectLock

Field	Description
status	enum ObjectLockStatus Default lock configuration for added objects
default_retention	DefaultRetention

DefaultRetentionDefaultRetention

Field	Description
mode	enum Mode Lock type
period	oneof: days or years
days	int64 Number of days for locking
years	int64 Number of years for locking

EncryptionEncryption

Field	Description
rules[]	EncryptionRule

EncryptionRuleEncryptionRule

Field	Description
kms_master_key_id	string
sse_algorithm	string

OperationOperation

Field	Description
id	string ID of the operation.
description	string Description of the operation. 0-256 characters long.
created_at	google.protobuf.Timestamp Creation timestamp.
created_by	string ID of the user or service account who initiated the operation.
modified_at	google.protobuf.Timestamp The time when the Operation resource was last modified.
done	bool If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata	google.protobuf.Any<UpdateBucketMetadata> Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result	oneof: error or response The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
error	google.rpc.Status The error result of the operation in case of failure or cancellation.
response	google.protobuf.Any<Bucket> if operation finished successfully.

UpdateBucketMetadataUpdateBucketMetadata

Field	Description
name	string Name of the bucket that is being updated.

BucketBucket

Field	Description
id	string ID of the bucket. Always equal to name, which has priority.
name	string Name of the bucket. The name is unique within the platform. For naming limitations and rules, see documentation.
folder_id	string ID of the folder that the bucket belongs to.
anonymous_access_flags	AnonymousAccessFlags Flags for configuring public (anonymous) access to the bucket's content and settings. For details, see documentation.
default_storage_class	string Default storage class for objects in the bucket. Supported classes are standard storage (STANDARD), cold storage (COLD, STANDARD_IA, NEARLINE all synonyms), and ice storage (ICE and GLACIER are synonyms). For details, see documentation.
versioning	enum Versioning Bucket versioning status. For details, see documentation. VERSIONING_DISABLED: The bucket is unversioned, i.e. versioning has never been enabled for the bucket, including at its creation. Objects that are stored in the bucket have a version ID of null. To enable versioning, change status to VERSIONING_ENABLED via a BucketService.Update request. Note that this action is irreversible, and a bucket with versioning enabled can never return to VERSIONING_DISABLED state. VERSIONING_ENABLED: Bucket versioning is enabled, i.e. all new objects are versioned and given a unique version ID, and objects that already existed at the time versioning was enabled will be versioned and given a unique version ID when modified by future requests. To suspend versioning, change status to VERSIONING_SUSPENDED via a BucketService.Update request. You cannot disable versioning altogether for a bucket that already had it enabled; objects that had version IDs will keep them. VERSIONING_SUSPENDED: Bucket versioning is suspended, i.e. new objects are not versioned, but objects that already existed at the time versioning was suspended are still versioned and keep their version IDs. To resume versioning, change status to VERSIONING_ENABLED via a BucketService.Update request.
max_size	int64 Maximum size of the bucket, in bytes. For details, see documentation.
policy	google.protobuf.Struct Bucket policies that set permissions for actions with the bucket, its objects, and groups of objects. For details, see documentation.
acl	ACL Access control list (ACL) of the bucket. For details, see documentation.
created_at	google.protobuf.Timestamp Creation timestamp.
cors[]	CorsRule List of rules for cross-domain requests to objects in the bucket (cross-origin resource sharing, CORS). For details, see documentation.
website_settings	WebsiteSettings Configuration for hosting a static website in the bucket. For details, see documentation.
lifecycle_rules[]	LifecycleRule List of object lifecycle rules for the bucket. For details, see documentation.
tags[]	Tag List of tags for the bucket. For details, see documentation.
object_lock	ObjectLock Configuration for object lock on the bucket. For details about the concept, see documentation.
encryption	Encryption Configuration for bucket's encryption For detauls, see documentation

DeleteDelete

Deletes the specified bucket.

rpc Delete (DeleteBucketRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:DeleteBucketMetadata

    Operation.response:google.protobuf.Empty

DeleteBucketRequestDeleteBucketRequest

Field	Description
name	string Required. Name of the bucket to update. To get the bucket name, make a BucketService.List request.

OperationOperation

Field	Description
id	string ID of the operation.
description	string Description of the operation. 0-256 characters long.
created_at	google.protobuf.Timestamp Creation timestamp.
created_by	string ID of the user or service account who initiated the operation.
modified_at	google.protobuf.Timestamp The time when the Operation resource was last modified.
done	bool If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata	google.protobuf.Any<DeleteBucketMetadata> Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result	oneof: error or response The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
error	google.rpc.Status The error result of the operation in case of failure or cancellation.
response	google.protobuf.Any<google.protobuf.Empty> if operation finished successfully.

DeleteBucketMetadataDeleteBucketMetadata

Field	Description
name	string Name of the bucket that is being deleted.

GetStatsGetStats

Returns the statistics for the specified bucket.

rpc GetStats (GetBucketStatsRequest) returns (BucketStats)

GetBucketStatsRequestGetBucketStatsRequest

Field	Description
name	string Required. Name of the bucket to return the statistics for.

BucketStatsBucketStats

Field	Description
name	string Name of the bucket.
max_size	google.protobuf.Int64Value Maximum size of the bucket, in bytes.
used_size	int64 Size of used space in the bucket, in bytes.
storage_class_max_sizes[]	OptionalSizeByClass Size of available space in the bucket by storage class, in bytes.
storage_class_used_sizes[]	SizeByClass Size of used space in the bucket by storage class, in bytes.
storage_class_counters[]	CountersByClass Object-related statistics by storage class and type of upload (simple vs. multipart), in bytes.
default_storage_class	google.protobuf.StringValue Default storage class for objects in the bucket. Supported classes are standard storage (STANDARD), cold storage (COLD, STANDARD_IA, NEARLINE all synonyms), and ice storage (ICE and GLACIER are synonyms). For details, see documentation.
anonymous_access_flags	AnonymousAccessFlags Flags for configuring public (anonymous) access to the bucket's content and settings. For details, see documentation.
created_at	google.protobuf.Timestamp Bucket creation timestamp.
updated_at	google.protobuf.Timestamp Bucket latest update timestamp.

OptionalSizeByClassOptionalSizeByClass

Field	Description
storage_class	string Storage class. Supported classes are standard storage (STANDARD), cold storage (COLD, STANDARD_IA, NEARLINE all synonyms), and ice storage (ICE and GLACIER are synonyms). For details, see documentation.
class_size	google.protobuf.Int64Value Size of available space in the bucket for the storage class.

SizeByClassSizeByClass

Field	Description
storage_class	string Storage class. Supported classes are standard storage (STANDARD), cold storage (COLD, STANDARD_IA, NEARLINE all synonyms), and ice storage (ICE and GLACIER are synonyms). For details, see documentation.
class_size	int64 Size of used space in the bucket for the storage class.

CountersByClassCountersByClass

Field	Description
storage_class	string Storage class. Supported classes are standard storage (STANDARD), cold storage (COLD, STANDARD_IA, NEARLINE all synonyms), and ice storage (ice and GLACIER are synonyms). For details, see documentation.
counters	Counters Object-related statistics for the storage class by type of upload.

CountersCounters

Field	Description
simple_object_size	int64 Total size of objects uploaded in single operation, in bytes.
simple_object_count	int64 Number of objects uploaded in single operation.
objects_parts_size	int64 Total size of uploaded parts in incomplete multipart uploads, in bytes.
objects_parts_count	int64 Number of uploaded parts in incomplete multipart uploads.
multipart_objects_size	int64 Total size of objects uploaded in multiple parts, in bytes.
multipart_objects_count	int64 Number of objects uploaded in multiple parts.
active_multipart_count	int64 Number of incomplete multipart uploads.

AnonymousAccessFlagsAnonymousAccessFlags

Field	Description
read	google.protobuf.BoolValue Specifies whether public (anonymous) access to read objects in the bucket is enabled.
list	google.protobuf.BoolValue Specifies whether public (anonymous) access to the list of objects in the bucket is enabled.
config_read	google.protobuf.BoolValue Specifies whether public (anonymous) access to read CORS, static website hosting, and object lifecycles settings of the bucket is enabled.

GetHTTPSConfigGetHTTPSConfig

Returns the HTTPS configuration for the specified bucket.

rpc GetHTTPSConfig (GetBucketHTTPSConfigRequest) returns (HTTPSConfig)

GetBucketHTTPSConfigRequestGetBucketHTTPSConfigRequest

Field	Description
name	string Required. Name of the bucket to return the HTTPS configuration for.

HTTPSConfigHTTPSConfig

Field	Description
name	string Name of the bucket.
source_type	enum SourceType Type of TLS certificate source. SOURCE_TYPE_SELF_MANAGED: Your certificate, uploaded directly. SOURCE_TYPE_MANAGED_BY_CERTIFICATE_MANAGER: Certificate managed by Certificate Manager.
issuer	google.protobuf.StringValue Issuer of the TLS certificate.
subject	google.protobuf.StringValue Subject of the TLS certificate.
dns_names[]	string List of DNS names of the TLS certificate (Subject Alternative Name field).
not_before	google.protobuf.Timestamp Start of the TLS certificate validity period (Not Before field).
not_after	google.protobuf.Timestamp End of the TLS certificate validity period (Not After field)
certificate_id	string ID of the TLS certificate in Certificate Manager. To get information about the certificate from Certificate Manager, make a yandex.cloud.certificatemanager.v1.CertificateService.Get request.

SetHTTPSConfigSetHTTPSConfig

Updates the HTTPS configuration for the specified bucket.
The updated configuration could take up to 30 minutes to apply to the bucket.

rpc SetHTTPSConfig (SetBucketHTTPSConfigRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:SetBucketHTTPSConfigMetadata

    Operation.response:HTTPSConfig

SetBucketHTTPSConfigRequestSetBucketHTTPSConfigRequest

Field	Description
name	string Required. Name of the bucket to update the HTTPS configuration for.
params	oneof: self_managed or certificate_manager HTTPS configuration parameters.
self_managed	SelfManagedHTTPSConfigParams Your TLS certificate, uploaded directly. Object Storage only supports PEM-encoded certificates.
certificate_manager	CertificateManagerHTTPSConfigParams TLS certificate from Certificate Manager. To create a certificate in Certificate Manager, make a yandex.cloud.certificatemanager.v1.CertificateService.Create request.

SelfManagedHTTPSConfigParamsSelfManagedHTTPSConfigParams

Field	Description
certificate_pem	string PEM-encoded certificate. The maximum string length in characters is 3145728.
private_key_pem	string PEM-encoded private key for the certificate. The maximum string length in characters is 3145728.

CertificateManagerHTTPSConfigParamsCertificateManagerHTTPSConfigParams

Field	Description
certificate_id	string ID of the certificate. To get the list of all available certificates, make a yandex.cloud.certificatemanager.v1.CertificateService.List request.

OperationOperation

Field	Description
id	string ID of the operation.
description	string Description of the operation. 0-256 characters long.
created_at	google.protobuf.Timestamp Creation timestamp.
created_by	string ID of the user or service account who initiated the operation.
modified_at	google.protobuf.Timestamp The time when the Operation resource was last modified.
done	bool If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata	google.protobuf.Any<SetBucketHTTPSConfigMetadata> Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result	oneof: error or response The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
error	google.rpc.Status The error result of the operation in case of failure or cancellation.
response	google.protobuf.Any<HTTPSConfig> if operation finished successfully.

SetBucketHTTPSConfigMetadataSetBucketHTTPSConfigMetadata

Field	Description
name	string Name of the bucket the HTTPS configuration is being updated for.

HTTPSConfigHTTPSConfig

Field	Description
name	string Name of the bucket.
source_type	enum SourceType Type of TLS certificate source. SOURCE_TYPE_SELF_MANAGED: Your certificate, uploaded directly. SOURCE_TYPE_MANAGED_BY_CERTIFICATE_MANAGER: Certificate managed by Certificate Manager.
issuer	google.protobuf.StringValue Issuer of the TLS certificate.
subject	google.protobuf.StringValue Subject of the TLS certificate.
dns_names[]	string List of DNS names of the TLS certificate (Subject Alternative Name field).
not_before	google.protobuf.Timestamp Start of the TLS certificate validity period (Not Before field).
not_after	google.protobuf.Timestamp End of the TLS certificate validity period (Not After field)
certificate_id	string ID of the TLS certificate in Certificate Manager. To get information about the certificate from Certificate Manager, make a yandex.cloud.certificatemanager.v1.CertificateService.Get request.

DeleteHTTPSConfigDeleteHTTPSConfig

Deletes the HTTPS configuration for the specified bucket.

rpc DeleteHTTPSConfig (DeleteBucketHTTPSConfigRequest) returns (operation.Operation)

Metadata and response of Operation:

    Operation.metadata:DeleteBucketHTTPSConfigMetadata

    Operation.response:google.protobuf.Empty

DeleteBucketHTTPSConfigRequestDeleteBucketHTTPSConfigRequest

Field	Description
name	string Required. Name of the bucket to delete the HTTPS configuration for.

OperationOperation

Field	Description
id	string ID of the operation.
description	string Description of the operation. 0-256 characters long.
created_at	google.protobuf.Timestamp Creation timestamp.
created_by	string ID of the user or service account who initiated the operation.
modified_at	google.protobuf.Timestamp The time when the Operation resource was last modified.
done	bool If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.
metadata	google.protobuf.Any<DeleteBucketHTTPSConfigMetadata> Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
result	oneof: error or response The operation result. If done == false and there was no failure detected, neither error nor response is set. If done == false and there was a failure detected, error is set. If done == true, exactly one of error or response is set.
error	google.rpc.Status The error result of the operation in case of failure or cancellation.
response	google.protobuf.Any<google.protobuf.Empty> if operation finished successfully.

DeleteBucketHTTPSConfigMetadataDeleteBucketHTTPSConfigMetadata

Field	Description
name	string Name of the bucket the HTTPS configuration is being deleted for.