published on Wednesday, Apr 15, 2026 by ionos-cloud
published on Wednesday, Apr 15, 2026 by ionos-cloud
Manages IONOS Object Storage Objects on IonosCloud.
⚠️ Note: The Terraform provider only supports contract-owned buckets. User-owned buckets are not supported, and there are no plans to introduce support for them. As a result, user-owned buckets cannot be created, updated, deleted, read, or imported using this provider.
Create BucketObject Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new BucketObject(name: string, args: BucketObjectArgs, opts?: CustomResourceOptions);@overload
def BucketObject(resource_name: str,
args: BucketObjectArgs,
opts: Optional[ResourceOptions] = None)
@overload
def BucketObject(resource_name: str,
opts: Optional[ResourceOptions] = None,
key: Optional[str] = None,
bucket: Optional[str] = None,
object_lock_legal_hold: Optional[str] = None,
metadata: Optional[Mapping[str, str]] = None,
content_encoding: Optional[str] = None,
content_language: Optional[str] = None,
content_type: Optional[str] = None,
expires: Optional[str] = None,
force_destroy: Optional[bool] = None,
object_lock_retain_until_date: Optional[str] = None,
object_lock_mode: Optional[str] = None,
mfa: Optional[str] = None,
content_disposition: Optional[str] = None,
cache_control: Optional[str] = None,
content: Optional[str] = None,
request_payer: Optional[str] = None,
server_side_encryption: Optional[str] = None,
server_side_encryption_context: Optional[str] = None,
server_side_encryption_customer_algorithm: Optional[str] = None,
server_side_encryption_customer_key: Optional[str] = None,
server_side_encryption_customer_key_md5: Optional[str] = None,
source: Optional[str] = None,
storage_class: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
website_redirect: Optional[str] = None)func NewBucketObject(ctx *Context, name string, args BucketObjectArgs, opts ...ResourceOption) (*BucketObject, error)public BucketObject(string name, BucketObjectArgs args, CustomResourceOptions? opts = null)
public BucketObject(String name, BucketObjectArgs args)
public BucketObject(String name, BucketObjectArgs args, CustomResourceOptions options)
type: ionoscloud:objectstorage:BucketObject
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "ionoscloud_objectstorage_bucketobject" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args BucketObjectArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args BucketObjectArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args BucketObjectArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args BucketObjectArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args BucketObjectArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var bucketObjectResource = new Ionoscloud.Objectstorage.BucketObject("bucketObjectResource", new()
{
Key = "string",
Bucket = "string",
ObjectLockLegalHold = "string",
Metadata =
{
{ "string", "string" },
},
ContentEncoding = "string",
ContentLanguage = "string",
ContentType = "string",
Expires = "string",
ForceDestroy = false,
ObjectLockRetainUntilDate = "string",
ObjectLockMode = "string",
Mfa = "string",
ContentDisposition = "string",
CacheControl = "string",
Content = "string",
RequestPayer = "string",
ServerSideEncryption = "string",
ServerSideEncryptionContext = "string",
ServerSideEncryptionCustomerAlgorithm = "string",
ServerSideEncryptionCustomerKey = "string",
ServerSideEncryptionCustomerKeyMd5 = "string",
Source = "string",
StorageClass = "string",
Tags =
{
{ "string", "string" },
},
WebsiteRedirect = "string",
});
example, err := objectstorage.NewBucketObject(ctx, "bucketObjectResource", &objectstorage.BucketObjectArgs{
Key: pulumi.String("string"),
Bucket: pulumi.String("string"),
ObjectLockLegalHold: pulumi.String("string"),
Metadata: pulumi.StringMap{
"string": pulumi.String("string"),
},
ContentEncoding: pulumi.String("string"),
ContentLanguage: pulumi.String("string"),
ContentType: pulumi.String("string"),
Expires: pulumi.String("string"),
ForceDestroy: pulumi.Bool(false),
ObjectLockRetainUntilDate: pulumi.String("string"),
ObjectLockMode: pulumi.String("string"),
Mfa: pulumi.String("string"),
ContentDisposition: pulumi.String("string"),
CacheControl: pulumi.String("string"),
Content: pulumi.String("string"),
RequestPayer: pulumi.String("string"),
ServerSideEncryption: pulumi.String("string"),
ServerSideEncryptionContext: pulumi.String("string"),
ServerSideEncryptionCustomerAlgorithm: pulumi.String("string"),
ServerSideEncryptionCustomerKey: pulumi.String("string"),
ServerSideEncryptionCustomerKeyMd5: pulumi.String("string"),
Source: pulumi.String("string"),
StorageClass: pulumi.String("string"),
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
WebsiteRedirect: pulumi.String("string"),
})
resource "ionoscloud_objectstorage_bucketobject" "bucketObjectResource" {
key = "string"
bucket = "string"
object_lock_legal_hold = "string"
metadata = {
"string" = "string"
}
content_encoding = "string"
content_language = "string"
content_type = "string"
expires = "string"
force_destroy = false
object_lock_retain_until_date = "string"
object_lock_mode = "string"
mfa = "string"
content_disposition = "string"
cache_control = "string"
content = "string"
request_payer = "string"
server_side_encryption = "string"
server_side_encryption_context = "string"
server_side_encryption_customer_algorithm = "string"
server_side_encryption_customer_key = "string"
server_side_encryption_customer_key_md5 = "string"
source = "string"
storage_class = "string"
tags = {
"string" = "string"
}
website_redirect = "string"
}
var bucketObjectResource = new BucketObject("bucketObjectResource", BucketObjectArgs.builder()
.key("string")
.bucket("string")
.objectLockLegalHold("string")
.metadata(Map.of("string", "string"))
.contentEncoding("string")
.contentLanguage("string")
.contentType("string")
.expires("string")
.forceDestroy(false)
.objectLockRetainUntilDate("string")
.objectLockMode("string")
.mfa("string")
.contentDisposition("string")
.cacheControl("string")
.content("string")
.requestPayer("string")
.serverSideEncryption("string")
.serverSideEncryptionContext("string")
.serverSideEncryptionCustomerAlgorithm("string")
.serverSideEncryptionCustomerKey("string")
.serverSideEncryptionCustomerKeyMd5("string")
.source("string")
.storageClass("string")
.tags(Map.of("string", "string"))
.websiteRedirect("string")
.build());
bucket_object_resource = ionoscloud.objectstorage.BucketObject("bucketObjectResource",
key="string",
bucket="string",
object_lock_legal_hold="string",
metadata={
"string": "string",
},
content_encoding="string",
content_language="string",
content_type="string",
expires="string",
force_destroy=False,
object_lock_retain_until_date="string",
object_lock_mode="string",
mfa="string",
content_disposition="string",
cache_control="string",
content="string",
request_payer="string",
server_side_encryption="string",
server_side_encryption_context="string",
server_side_encryption_customer_algorithm="string",
server_side_encryption_customer_key="string",
server_side_encryption_customer_key_md5="string",
source="string",
storage_class="string",
tags={
"string": "string",
},
website_redirect="string")
const bucketObjectResource = new ionoscloud.objectstorage.BucketObject("bucketObjectResource", {
key: "string",
bucket: "string",
objectLockLegalHold: "string",
metadata: {
string: "string",
},
contentEncoding: "string",
contentLanguage: "string",
contentType: "string",
expires: "string",
forceDestroy: false,
objectLockRetainUntilDate: "string",
objectLockMode: "string",
mfa: "string",
contentDisposition: "string",
cacheControl: "string",
content: "string",
requestPayer: "string",
serverSideEncryption: "string",
serverSideEncryptionContext: "string",
serverSideEncryptionCustomerAlgorithm: "string",
serverSideEncryptionCustomerKey: "string",
serverSideEncryptionCustomerKeyMd5: "string",
source: "string",
storageClass: "string",
tags: {
string: "string",
},
websiteRedirect: "string",
});
type: ionoscloud:objectstorage:BucketObject
properties:
bucket: string
cacheControl: string
content: string
contentDisposition: string
contentEncoding: string
contentLanguage: string
contentType: string
expires: string
forceDestroy: false
key: string
metadata:
string: string
mfa: string
objectLockLegalHold: string
objectLockMode: string
objectLockRetainUntilDate: string
requestPayer: string
serverSideEncryption: string
serverSideEncryptionContext: string
serverSideEncryptionCustomerAlgorithm: string
serverSideEncryptionCustomerKey: string
serverSideEncryptionCustomerKeyMd5: string
source: string
storageClass: string
tags:
string: string
websiteRedirect: string
BucketObject Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The BucketObject resource accepts the following input properties:
- Bucket string
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- Key string
- [string] The key of the object. Must be at least 1 character long.
- Cache
Control string - [string] Specifies caching behavior along the request/reply chain.
- Content string
- [string] Inline content of the object.
- Content
Disposition string - [string] Specifies presentational information for the object.
- Content
Encoding string - [string] Specifies what content encodings have been applied to the object.
- Content
Language string - [string] The natural language or languages of the intended audience for the object.
- Content
Type string - [string] A standard MIME type describing the format of the contents.
- Expires string
- [string] The date and time at which the object is no longer cacheable.
- Force
Destroy bool - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - Metadata Dictionary<string, string>
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- Mfa string
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- Object
Lock stringLegal Hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - Object
Lock stringMode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - Object
Lock stringRetain Until Date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- Request
Payer string - [string] Confirms that the requester knows that they will be charged for the request.
- Server
Side stringEncryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- Server
Side stringEncryption Context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- Server
Side stringEncryption Customer Algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- Server
Side stringEncryption Customer Key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- Server
Side stringEncryption Customer Key Md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- Source string
- [string] The path to the file to upload.
- Storage
Class string - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- Dictionary<string, string>
- [map] The tag-set for the object.
- Website
Redirect string - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- Bucket string
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- Key string
- [string] The key of the object. Must be at least 1 character long.
- Cache
Control string - [string] Specifies caching behavior along the request/reply chain.
- Content string
- [string] Inline content of the object.
- Content
Disposition string - [string] Specifies presentational information for the object.
- Content
Encoding string - [string] Specifies what content encodings have been applied to the object.
- Content
Language string - [string] The natural language or languages of the intended audience for the object.
- Content
Type string - [string] A standard MIME type describing the format of the contents.
- Expires string
- [string] The date and time at which the object is no longer cacheable.
- Force
Destroy bool - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - Metadata map[string]string
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- Mfa string
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- Object
Lock stringLegal Hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - Object
Lock stringMode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - Object
Lock stringRetain Until Date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- Request
Payer string - [string] Confirms that the requester knows that they will be charged for the request.
- Server
Side stringEncryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- Server
Side stringEncryption Context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- Server
Side stringEncryption Customer Algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- Server
Side stringEncryption Customer Key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- Server
Side stringEncryption Customer Key Md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- Source string
- [string] The path to the file to upload.
- Storage
Class string - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- map[string]string
- [map] The tag-set for the object.
- Website
Redirect string - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- bucket string
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- key string
- [string] The key of the object. Must be at least 1 character long.
- cache_
control string - [string] Specifies caching behavior along the request/reply chain.
- content string
- [string] Inline content of the object.
- content_
disposition string - [string] Specifies presentational information for the object.
- content_
encoding string - [string] Specifies what content encodings have been applied to the object.
- content_
language string - [string] The natural language or languages of the intended audience for the object.
- content_
type string - [string] A standard MIME type describing the format of the contents.
- expires string
- [string] The date and time at which the object is no longer cacheable.
- force_
destroy bool - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - metadata map(string)
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- mfa string
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- object_
lock_ stringlegal_ hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - object_
lock_ stringmode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - object_
lock_ stringretain_ until_ date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- request_
payer string - [string] Confirms that the requester knows that they will be charged for the request.
- server_
side_ stringencryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- server_
side_ stringencryption_ context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- server_
side_ stringencryption_ customer_ algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- server_
side_ stringencryption_ customer_ key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- server_
side_ stringencryption_ customer_ key_ md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- source string
- [string] The path to the file to upload.
- storage_
class string - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- map(string)
- [map] The tag-set for the object.
- website_
redirect string - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- bucket String
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- key String
- [string] The key of the object. Must be at least 1 character long.
- cache
Control String - [string] Specifies caching behavior along the request/reply chain.
- content String
- [string] Inline content of the object.
- content
Disposition String - [string] Specifies presentational information for the object.
- content
Encoding String - [string] Specifies what content encodings have been applied to the object.
- content
Language String - [string] The natural language or languages of the intended audience for the object.
- content
Type String - [string] A standard MIME type describing the format of the contents.
- expires String
- [string] The date and time at which the object is no longer cacheable.
- force
Destroy Boolean - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - metadata Map<String,String>
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- mfa String
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- object
Lock StringLegal Hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - object
Lock StringMode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - object
Lock StringRetain Until Date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- request
Payer String - [string] Confirms that the requester knows that they will be charged for the request.
- server
Side StringEncryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- server
Side StringEncryption Context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- server
Side StringEncryption Customer Algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- server
Side StringEncryption Customer Key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- server
Side StringEncryption Customer Key Md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- source String
- [string] The path to the file to upload.
- storage
Class String - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- Map<String,String>
- [map] The tag-set for the object.
- website
Redirect String - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- bucket string
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- key string
- [string] The key of the object. Must be at least 1 character long.
- cache
Control string - [string] Specifies caching behavior along the request/reply chain.
- content string
- [string] Inline content of the object.
- content
Disposition string - [string] Specifies presentational information for the object.
- content
Encoding string - [string] Specifies what content encodings have been applied to the object.
- content
Language string - [string] The natural language or languages of the intended audience for the object.
- content
Type string - [string] A standard MIME type describing the format of the contents.
- expires string
- [string] The date and time at which the object is no longer cacheable.
- force
Destroy boolean - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - metadata {[key: string]: string}
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- mfa string
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- object
Lock stringLegal Hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - object
Lock stringMode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - object
Lock stringRetain Until Date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- request
Payer string - [string] Confirms that the requester knows that they will be charged for the request.
- server
Side stringEncryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- server
Side stringEncryption Context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- server
Side stringEncryption Customer Algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- server
Side stringEncryption Customer Key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- server
Side stringEncryption Customer Key Md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- source string
- [string] The path to the file to upload.
- storage
Class string - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- {[key: string]: string}
- [map] The tag-set for the object.
- website
Redirect string - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- bucket str
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- key str
- [string] The key of the object. Must be at least 1 character long.
- cache_
control str - [string] Specifies caching behavior along the request/reply chain.
- content str
- [string] Inline content of the object.
- content_
disposition str - [string] Specifies presentational information for the object.
- content_
encoding str - [string] Specifies what content encodings have been applied to the object.
- content_
language str - [string] The natural language or languages of the intended audience for the object.
- content_
type str - [string] A standard MIME type describing the format of the contents.
- expires str
- [string] The date and time at which the object is no longer cacheable.
- force_
destroy bool - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - metadata Mapping[str, str]
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- mfa str
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- object_
lock_ strlegal_ hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - object_
lock_ strmode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - object_
lock_ strretain_ until_ date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- request_
payer str - [string] Confirms that the requester knows that they will be charged for the request.
- server_
side_ strencryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- server_
side_ strencryption_ context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- server_
side_ strencryption_ customer_ algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- server_
side_ strencryption_ customer_ key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- server_
side_ strencryption_ customer_ key_ md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- source str
- [string] The path to the file to upload.
- storage_
class str - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- Mapping[str, str]
- [map] The tag-set for the object.
- website_
redirect str - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- bucket String
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- key String
- [string] The key of the object. Must be at least 1 character long.
- cache
Control String - [string] Specifies caching behavior along the request/reply chain.
- content String
- [string] Inline content of the object.
- content
Disposition String - [string] Specifies presentational information for the object.
- content
Encoding String - [string] Specifies what content encodings have been applied to the object.
- content
Language String - [string] The natural language or languages of the intended audience for the object.
- content
Type String - [string] A standard MIME type describing the format of the contents.
- expires String
- [string] The date and time at which the object is no longer cacheable.
- force
Destroy Boolean - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - metadata Map<String>
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- mfa String
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- object
Lock StringLegal Hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - object
Lock StringMode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - object
Lock StringRetain Until Date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- request
Payer String - [string] Confirms that the requester knows that they will be charged for the request.
- server
Side StringEncryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- server
Side StringEncryption Context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- server
Side StringEncryption Customer Algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- server
Side StringEncryption Customer Key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- server
Side StringEncryption Customer Key Md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- source String
- [string] The path to the file to upload.
- storage
Class String - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- Map<String>
- [map] The tag-set for the object.
- website
Redirect String - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
Outputs
All input properties are implicitly available as output properties. Additionally, the BucketObject resource produces the following output properties:
- etag string
- [string] An entity tag (ETag) is an opaque identifier assigned by a web server to a specific version of a resource found at a URL.
- id string
- The provider-assigned unique ID for this managed resource.
- version_
id string - [string] The version of the object.
- etag str
- [string] An entity tag (ETag) is an opaque identifier assigned by a web server to a specific version of a resource found at a URL.
- id str
- The provider-assigned unique ID for this managed resource.
- version_
id str - [string] The version of the object.
Look up Existing BucketObject Resource
Get an existing BucketObject resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: BucketObjectState, opts?: CustomResourceOptions): BucketObject@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
bucket: Optional[str] = None,
cache_control: Optional[str] = None,
content: Optional[str] = None,
content_disposition: Optional[str] = None,
content_encoding: Optional[str] = None,
content_language: Optional[str] = None,
content_type: Optional[str] = None,
etag: Optional[str] = None,
expires: Optional[str] = None,
force_destroy: Optional[bool] = None,
key: Optional[str] = None,
metadata: Optional[Mapping[str, str]] = None,
mfa: Optional[str] = None,
object_lock_legal_hold: Optional[str] = None,
object_lock_mode: Optional[str] = None,
object_lock_retain_until_date: Optional[str] = None,
request_payer: Optional[str] = None,
server_side_encryption: Optional[str] = None,
server_side_encryption_context: Optional[str] = None,
server_side_encryption_customer_algorithm: Optional[str] = None,
server_side_encryption_customer_key: Optional[str] = None,
server_side_encryption_customer_key_md5: Optional[str] = None,
source: Optional[str] = None,
storage_class: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
version_id: Optional[str] = None,
website_redirect: Optional[str] = None) -> BucketObjectfunc GetBucketObject(ctx *Context, name string, id IDInput, state *BucketObjectState, opts ...ResourceOption) (*BucketObject, error)public static BucketObject Get(string name, Input<string> id, BucketObjectState? state, CustomResourceOptions? opts = null)public static BucketObject get(String name, Output<String> id, BucketObjectState state, CustomResourceOptions options)resources: _: type: ionoscloud:objectstorage:BucketObject get: id: ${id}import {
to = ionoscloud_objectstorage_bucketobject.example
id = "${id}"
}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Bucket string
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- Cache
Control string - [string] Specifies caching behavior along the request/reply chain.
- Content string
- [string] Inline content of the object.
- Content
Disposition string - [string] Specifies presentational information for the object.
- Content
Encoding string - [string] Specifies what content encodings have been applied to the object.
- Content
Language string - [string] The natural language or languages of the intended audience for the object.
- Content
Type string - [string] A standard MIME type describing the format of the contents.
- Etag string
- [string] An entity tag (ETag) is an opaque identifier assigned by a web server to a specific version of a resource found at a URL.
- Expires string
- [string] The date and time at which the object is no longer cacheable.
- Force
Destroy bool - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - Key string
- [string] The key of the object. Must be at least 1 character long.
- Metadata Dictionary<string, string>
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- Mfa string
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- Object
Lock stringLegal Hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - Object
Lock stringMode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - Object
Lock stringRetain Until Date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- Request
Payer string - [string] Confirms that the requester knows that they will be charged for the request.
- Server
Side stringEncryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- Server
Side stringEncryption Context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- Server
Side stringEncryption Customer Algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- Server
Side stringEncryption Customer Key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- Server
Side stringEncryption Customer Key Md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- Source string
- [string] The path to the file to upload.
- Storage
Class string - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- Dictionary<string, string>
- [map] The tag-set for the object.
- Version
Id string - [string] The version of the object.
- Website
Redirect string - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- Bucket string
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- Cache
Control string - [string] Specifies caching behavior along the request/reply chain.
- Content string
- [string] Inline content of the object.
- Content
Disposition string - [string] Specifies presentational information for the object.
- Content
Encoding string - [string] Specifies what content encodings have been applied to the object.
- Content
Language string - [string] The natural language or languages of the intended audience for the object.
- Content
Type string - [string] A standard MIME type describing the format of the contents.
- Etag string
- [string] An entity tag (ETag) is an opaque identifier assigned by a web server to a specific version of a resource found at a URL.
- Expires string
- [string] The date and time at which the object is no longer cacheable.
- Force
Destroy bool - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - Key string
- [string] The key of the object. Must be at least 1 character long.
- Metadata map[string]string
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- Mfa string
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- Object
Lock stringLegal Hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - Object
Lock stringMode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - Object
Lock stringRetain Until Date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- Request
Payer string - [string] Confirms that the requester knows that they will be charged for the request.
- Server
Side stringEncryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- Server
Side stringEncryption Context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- Server
Side stringEncryption Customer Algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- Server
Side stringEncryption Customer Key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- Server
Side stringEncryption Customer Key Md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- Source string
- [string] The path to the file to upload.
- Storage
Class string - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- map[string]string
- [map] The tag-set for the object.
- Version
Id string - [string] The version of the object.
- Website
Redirect string - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- bucket string
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- cache_
control string - [string] Specifies caching behavior along the request/reply chain.
- content string
- [string] Inline content of the object.
- content_
disposition string - [string] Specifies presentational information for the object.
- content_
encoding string - [string] Specifies what content encodings have been applied to the object.
- content_
language string - [string] The natural language or languages of the intended audience for the object.
- content_
type string - [string] A standard MIME type describing the format of the contents.
- etag string
- [string] An entity tag (ETag) is an opaque identifier assigned by a web server to a specific version of a resource found at a URL.
- expires string
- [string] The date and time at which the object is no longer cacheable.
- force_
destroy bool - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - key string
- [string] The key of the object. Must be at least 1 character long.
- metadata map(string)
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- mfa string
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- object_
lock_ stringlegal_ hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - object_
lock_ stringmode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - object_
lock_ stringretain_ until_ date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- request_
payer string - [string] Confirms that the requester knows that they will be charged for the request.
- server_
side_ stringencryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- server_
side_ stringencryption_ context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- server_
side_ stringencryption_ customer_ algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- server_
side_ stringencryption_ customer_ key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- server_
side_ stringencryption_ customer_ key_ md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- source string
- [string] The path to the file to upload.
- storage_
class string - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- map(string)
- [map] The tag-set for the object.
- version_
id string - [string] The version of the object.
- website_
redirect string - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- bucket String
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- cache
Control String - [string] Specifies caching behavior along the request/reply chain.
- content String
- [string] Inline content of the object.
- content
Disposition String - [string] Specifies presentational information for the object.
- content
Encoding String - [string] Specifies what content encodings have been applied to the object.
- content
Language String - [string] The natural language or languages of the intended audience for the object.
- content
Type String - [string] A standard MIME type describing the format of the contents.
- etag String
- [string] An entity tag (ETag) is an opaque identifier assigned by a web server to a specific version of a resource found at a URL.
- expires String
- [string] The date and time at which the object is no longer cacheable.
- force
Destroy Boolean - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - key String
- [string] The key of the object. Must be at least 1 character long.
- metadata Map<String,String>
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- mfa String
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- object
Lock StringLegal Hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - object
Lock StringMode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - object
Lock StringRetain Until Date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- request
Payer String - [string] Confirms that the requester knows that they will be charged for the request.
- server
Side StringEncryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- server
Side StringEncryption Context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- server
Side StringEncryption Customer Algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- server
Side StringEncryption Customer Key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- server
Side StringEncryption Customer Key Md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- source String
- [string] The path to the file to upload.
- storage
Class String - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- Map<String,String>
- [map] The tag-set for the object.
- version
Id String - [string] The version of the object.
- website
Redirect String - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- bucket string
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- cache
Control string - [string] Specifies caching behavior along the request/reply chain.
- content string
- [string] Inline content of the object.
- content
Disposition string - [string] Specifies presentational information for the object.
- content
Encoding string - [string] Specifies what content encodings have been applied to the object.
- content
Language string - [string] The natural language or languages of the intended audience for the object.
- content
Type string - [string] A standard MIME type describing the format of the contents.
- etag string
- [string] An entity tag (ETag) is an opaque identifier assigned by a web server to a specific version of a resource found at a URL.
- expires string
- [string] The date and time at which the object is no longer cacheable.
- force
Destroy boolean - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - key string
- [string] The key of the object. Must be at least 1 character long.
- metadata {[key: string]: string}
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- mfa string
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- object
Lock stringLegal Hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - object
Lock stringMode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - object
Lock stringRetain Until Date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- request
Payer string - [string] Confirms that the requester knows that they will be charged for the request.
- server
Side stringEncryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- server
Side stringEncryption Context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- server
Side stringEncryption Customer Algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- server
Side stringEncryption Customer Key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- server
Side stringEncryption Customer Key Md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- source string
- [string] The path to the file to upload.
- storage
Class string - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- {[key: string]: string}
- [map] The tag-set for the object.
- version
Id string - [string] The version of the object.
- website
Redirect string - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- bucket str
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- cache_
control str - [string] Specifies caching behavior along the request/reply chain.
- content str
- [string] Inline content of the object.
- content_
disposition str - [string] Specifies presentational information for the object.
- content_
encoding str - [string] Specifies what content encodings have been applied to the object.
- content_
language str - [string] The natural language or languages of the intended audience for the object.
- content_
type str - [string] A standard MIME type describing the format of the contents.
- etag str
- [string] An entity tag (ETag) is an opaque identifier assigned by a web server to a specific version of a resource found at a URL.
- expires str
- [string] The date and time at which the object is no longer cacheable.
- force_
destroy bool - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - key str
- [string] The key of the object. Must be at least 1 character long.
- metadata Mapping[str, str]
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- mfa str
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- object_
lock_ strlegal_ hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - object_
lock_ strmode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - object_
lock_ strretain_ until_ date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- request_
payer str - [string] Confirms that the requester knows that they will be charged for the request.
- server_
side_ strencryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- server_
side_ strencryption_ context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- server_
side_ strencryption_ customer_ algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- server_
side_ strencryption_ customer_ key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- server_
side_ strencryption_ customer_ key_ md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- source str
- [string] The path to the file to upload.
- storage_
class str - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- Mapping[str, str]
- [map] The tag-set for the object.
- version_
id str - [string] The version of the object.
- website_
redirect str - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
- bucket String
- [string] The name of the bucket where the object will be stored. Must be between 3 and 63 characters.
- cache
Control String - [string] Specifies caching behavior along the request/reply chain.
- content String
- [string] Inline content of the object.
- content
Disposition String - [string] Specifies presentational information for the object.
- content
Encoding String - [string] Specifies what content encodings have been applied to the object.
- content
Language String - [string] The natural language or languages of the intended audience for the object.
- content
Type String - [string] A standard MIME type describing the format of the contents.
- etag String
- [string] An entity tag (ETag) is an opaque identifier assigned by a web server to a specific version of a resource found at a URL.
- expires String
- [string] The date and time at which the object is no longer cacheable.
- force
Destroy Boolean - [bool] If true, the object will be destroyed if versioning is enabled then all versions will be destroyed. Default is
false. - key String
- [string] The key of the object. Must be at least 1 character long.
- metadata Map<String>
- [map] A map of metadata to store with the object in IONOS Object Storage. Metadata keys must be lowercase alphanumeric characters.
- mfa String
- [string]The concatenation of the authentication device's serial number, a space, and the value displayed on your authentication device.
- object
Lock StringLegal Hold - [string] Indicates whether a legal hold is in effect for the object. Valid values are
ONandOFF. - object
Lock StringMode - [string] The object lock mode that you want to apply to the object. Valid values are
GOVERNANCEandCOMPLIANCE. - object
Lock StringRetain Until Date - [string] The date and time when the object lock retention expires.Must be in RFC3999 format
- request
Payer String - [string] Confirms that the requester knows that they will be charged for the request.
- server
Side StringEncryption - [string] The server-side encryption algorithm used when storing this object in IONOS Object Storage. Valid value is AES256.
- server
Side StringEncryption Context - [string] Specifies the IONOS Object Storage Encryption Context for object encryption.
- server
Side StringEncryption Customer Algorithm - [string] Specifies the algorithm to use for encrypting the object. Valid value is AES256.
- server
Side StringEncryption Customer Key - [string] Specifies the 256-bit, base64-encoded encryption key to use to encrypt and decrypt your data.
- server
Side StringEncryption Customer Key Md5 - [string] Specifies the 128-bit MD5 digest of the encryption key.
- source String
- [string] The path to the file to upload.
- storage
Class String - [string] The storage class of the object. Valid value is STANDARD. Default is STANDARD.
- Map<String>
- [map] The tag-set for the object.
- version
Id String - [string] The version of the object.
- website
Redirect String - [string] Redirects requests for this object to another object in the same bucket or to an external URL.
Import
Resource Object can be imported using the bucket name and object key
$ pulumi import ionoscloud:objectstorage/bucketObject:BucketObject example example/object
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- ionoscloud ionos-cloud/pulumi-ionoscloud
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
ionoscloudTerraform Provider.
published on Wednesday, Apr 15, 2026 by ionos-cloud
