Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Terraform in Yandex Cloud
  • Getting started
  • Solution library
    • Overview
    • Release notes
          • storage_bucket
          • storage_bucket_grant
          • storage_bucket_iam_binding
          • storage_bucket_policy
          • storage_object

In this article:

  • Example usage
  • Schema
  • Required
  • Optional
  • Read-Only
  • Import
  1. Terraform reference
  2. Resources
  3. Object Storage (S3)
  4. Resources
  5. storage_object

yandex_storage_object (Resource)

Written by
Yandex Cloud
Updated at September 11, 2025
  • Example usage
  • Schema
    • Required
    • Optional
    • Read-Only
  • Import

Allows management of Yandex Cloud Storage Object.

Example usageExample usage

//
// Create a new Storage Object in Bucket.
//
resource "yandex_storage_object" "cute-cat-picture" {
  bucket = "cat-pictures"
  key    = "cute-cat"
  source = "/images/cats/cute-cat.jpg"
  tags = {
    test = "value"
  }
}

SchemaSchema

RequiredRequired

  • bucket (String) The name of the containing bucket.
  • key (String) The name of the object once it is in the bucket.

OptionalOptional

  • access_key (String) The access key to use when applying changes. This value can also be provided as storage_access_key specified in provider config (explicitly or within shared_credentials_file) is used.
  • acl (String) The predefined ACL to apply. Defaults to private.

Warning

To change ACL after creation, the service account to which used access and secret keys correspond should have storage.admin role, though this role is not necessary to be able to create an object with any ACL.

  • content (String) Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text. Conflicts with source and content_base64.
  • content_base64 (String) Base64-encoded data that will be decoded and uploaded as raw bytes for the object content. This allows safely uploading non-UTF8 binary data, but is recommended only for small content such as the result of the gzipbase64 function with small text strings. For larger objects, use source to stream the content from a disk file. Conflicts with source and content.
  • content_type (String) A standard MIME type describing the format of the object data, e.g. application/octet-stream. All Valid MIME Types are valid for this input.
  • object_lock_legal_hold_status (String) Specifies a legal hold status of an object. Requires object_lock_configuration to be enabled on a bucket.
  • object_lock_mode (String) Specifies a type of object lock. One of ["GOVERNANCE", "COMPLIANCE"]. It must be set simultaneously with object_lock_retain_until_date. Requires object_lock_configuration to be enabled on a bucket.
  • object_lock_retain_until_date (String) Specifies date and time in RTC3339 format until which an object is to be locked. It must be set simultaneously with object_lock_mode. Requires object_lock_configuration to be enabled on a bucket.
  • secret_key (String, Sensitive) The secret key to use when applying changes. This value can also be provided as storage_secret_key specified in provider config (explicitly or within shared_credentials_file) is used.
  • source (String) The path to a file that will be read and uploaded as raw bytes for the object content. Conflicts with content and content_base64.
  • source_hash (String) Used to trigger object update when the source content changes. So the only meaningful value is `filemd5("path/to/source"). The value is only stored in state and not saved by Yandex Storage.
  • tags (Map of String) The tags object for setting tags (or labels) for bucket. See Tags for more information.

Read-OnlyRead-Only

  • id (String) The ID of this resource.

ImportImport

Warning

Import for this resource is not implemented yet.

Was the article helpful?

Previous
storage_bucket_policy
Next
resourcemanager_cloud
© 2025 Direct Cursus Technology L.L.C.