Docs Packages
  1. Packages
  2. Linode
  3. API Docs
  4. ObjectStorageObject
Linode v4.22.0 published on Tuesday, Jun 25, 2024 by Pulumi
pulumi/pulumi-linode

linode.ObjectStorageObject

Explore with Pulumi AI

linode logo
Linode v4.22.0 published on Tuesday, Jun 25, 2024 by Pulumi
pulumi/pulumi-linode

    Provides a Linode Object Storage Object resource. This can be used to create, modify, and delete Linodes Object Storage Objects for Buckets.

    Example Usage

    Uploading a file to a bucket

    import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";
import * as std from "@pulumi/std";

const object = new linode.ObjectStorageObject("object", {
    bucket: "my-bucket",
    cluster: "us-east-1",
    key: "my-object",
    secretKey: myKey.secretKey,
    accessKey: myKey.accessKey,
    source: std.pathexpand({
        input: "~/files/log.txt",
    }).then(invoke => invoke.result),
});

    import pulumi
import pulumi_linode as linode
import pulumi_std as std

object = linode.ObjectStorageObject("object",
    bucket="my-bucket",
    cluster="us-east-1",
    key="my-object",
    secret_key=my_key["secretKey"],
    access_key=my_key["accessKey"],
    source=std.pathexpand(input="~/files/log.txt").result)

    package main

import (
	"github.com/pulumi/pulumi-linode/sdk/v4/go/linode"
	"github.com/pulumi/pulumi-std/sdk/go/std"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		invokePathexpand, err := std.Pathexpand(ctx, &std.PathexpandArgs{
			Input: "~/files/log.txt",
		}, nil)
		if err != nil {
			return err
		}
		_, err = linode.NewObjectStorageObject(ctx, "object", &linode.ObjectStorageObjectArgs{
			Bucket:    pulumi.String("my-bucket"),
			Cluster:   pulumi.String("us-east-1"),
			Key:       pulumi.String("my-object"),
			SecretKey: pulumi.Any(myKey.SecretKey),
			AccessKey: pulumi.Any(myKey.AccessKey),
			Source:    invokePathexpand.Result,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;
using Std = Pulumi.Std;

return await Deployment.RunAsync(() => 
{
    var @object = new Linode.ObjectStorageObject("object", new()
    {
        Bucket = "my-bucket",
        Cluster = "us-east-1",
        Key = "my-object",
        SecretKey = myKey.SecretKey,
        AccessKey = myKey.AccessKey,
        Source = Std.Pathexpand.Invoke(new()
        {
            Input = "~/files/log.txt",
        }).Apply(invoke => invoke.Result),
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.ObjectStorageObject;
import com.pulumi.linode.ObjectStorageObjectArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var object = new ObjectStorageObject("object", ObjectStorageObjectArgs.builder()
            .bucket("my-bucket")
            .cluster("us-east-1")
            .key("my-object")
            .secretKey(myKey.secretKey())
            .accessKey(myKey.accessKey())
            .source(StdFunctions.pathexpand(PathexpandArgs.builder()
                .input("~/files/log.txt")
                .build()).result())
            .build());

    }
}

    resources:
  object:
    type: linode:ObjectStorageObject
    properties:
      bucket: my-bucket
      cluster: us-east-1
      key: my-object
      secretKey: ${myKey.secretKey}
      accessKey: ${myKey.accessKey}
      source:
        fn::invoke:
          Function: std:pathexpand
          Arguments:
            input: ~/files/log.txt
          Return: result

    Uploading plaintext to a bucket

    import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";

const object = new linode.ObjectStorageObject("object", {
    bucket: "my-bucket",
    cluster: "us-east-1",
    key: "my-object",
    secretKey: myKey.secretKey,
    accessKey: myKey.accessKey,
    content: "This is the content of the Object...",
    contentType: "text/plain",
    contentLanguage: "en",
});

    import pulumi
import pulumi_linode as linode

object = linode.ObjectStorageObject("object",
    bucket="my-bucket",
    cluster="us-east-1",
    key="my-object",
    secret_key=my_key["secretKey"],
    access_key=my_key["accessKey"],
    content="This is the content of the Object...",
    content_type="text/plain",
    content_language="en")

    package main

import (
	"github.com/pulumi/pulumi-linode/sdk/v4/go/linode"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := linode.NewObjectStorageObject(ctx, "object", &linode.ObjectStorageObjectArgs{
			Bucket:          pulumi.String("my-bucket"),
			Cluster:         pulumi.String("us-east-1"),
			Key:             pulumi.String("my-object"),
			SecretKey:       pulumi.Any(myKey.SecretKey),
			AccessKey:       pulumi.Any(myKey.AccessKey),
			Content:         pulumi.String("This is the content of the Object..."),
			ContentType:     pulumi.String("text/plain"),
			ContentLanguage: pulumi.String("en"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;

return await Deployment.RunAsync(() => 
{
    var @object = new Linode.ObjectStorageObject("object", new()
    {
        Bucket = "my-bucket",
        Cluster = "us-east-1",
        Key = "my-object",
        SecretKey = myKey.SecretKey,
        AccessKey = myKey.AccessKey,
        Content = "This is the content of the Object...",
        ContentType = "text/plain",
        ContentLanguage = "en",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.ObjectStorageObject;
import com.pulumi.linode.ObjectStorageObjectArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var object = new ObjectStorageObject("object", ObjectStorageObjectArgs.builder()
            .bucket("my-bucket")
            .cluster("us-east-1")
            .key("my-object")
            .secretKey(myKey.secretKey())
            .accessKey(myKey.accessKey())
            .content("This is the content of the Object...")
            .contentType("text/plain")
            .contentLanguage("en")
            .build());

    }
}

    resources:
  object:
    type: linode:ObjectStorageObject
    properties:
      bucket: my-bucket
      cluster: us-east-1
      key: my-object
      secretKey: ${myKey.secretKey}
      accessKey: ${myKey.accessKey}
      content: This is the content of the Object...
      contentType: text/plain
      contentLanguage: en

    Creating an object using implicitly created object credentials

    import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";
import * as std from "@pulumi/std";

const object = new linode.ObjectStorageObject("object", {
    bucket: "my-bucket",
    cluster: "us-east-1",
    key: "my-object",
    source: std.pathexpand({
        input: "~/files/log.txt",
    }).then(invoke => invoke.result),
});

    import pulumi
import pulumi_linode as linode
import pulumi_std as std

object = linode.ObjectStorageObject("object",
    bucket="my-bucket",
    cluster="us-east-1",
    key="my-object",
    source=std.pathexpand(input="~/files/log.txt").result)

    package main

import (
	"github.com/pulumi/pulumi-linode/sdk/v4/go/linode"
	"github.com/pulumi/pulumi-std/sdk/go/std"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		invokePathexpand, err := std.Pathexpand(ctx, &std.PathexpandArgs{
			Input: "~/files/log.txt",
		}, nil)
		if err != nil {
			return err
		}
		_, err = linode.NewObjectStorageObject(ctx, "object", &linode.ObjectStorageObjectArgs{
			Bucket:  pulumi.String("my-bucket"),
			Cluster: pulumi.String("us-east-1"),
			Key:     pulumi.String("my-object"),
			Source:  invokePathexpand.Result,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;
using Std = Pulumi.Std;

return await Deployment.RunAsync(() => 
{
    var @object = new Linode.ObjectStorageObject("object", new()
    {
        Bucket = "my-bucket",
        Cluster = "us-east-1",
        Key = "my-object",
        Source = Std.Pathexpand.Invoke(new()
        {
            Input = "~/files/log.txt",
        }).Apply(invoke => invoke.Result),
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.ObjectStorageObject;
import com.pulumi.linode.ObjectStorageObjectArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var object = new ObjectStorageObject("object", ObjectStorageObjectArgs.builder()
            .bucket("my-bucket")
            .cluster("us-east-1")
            .key("my-object")
            .source(StdFunctions.pathexpand(PathexpandArgs.builder()
                .input("~/files/log.txt")
                .build()).result())
            .build());

    }
}

    resources:
  object:
    type: linode:ObjectStorageObject
    properties:
      bucket: my-bucket
      cluster: us-east-1
      key: my-object
      source:
        fn::invoke:
          Function: std:pathexpand
          Arguments:
            input: ~/files/log.txt
          Return: result

    Create ObjectStorageObject Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new ObjectStorageObject(name: string, args: ObjectStorageObjectArgs, opts?: CustomResourceOptions);
    @overload
def ObjectStorageObject(resource_name: str,
                        args: ObjectStorageObjectArgs,
                        opts: Optional[ResourceOptions] = None)

@overload
def ObjectStorageObject(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        cluster: Optional[str] = None,
                        key: Optional[str] = None,
                        bucket: Optional[str] = None,
                        content_encoding: Optional[str] = None,
                        content_type: Optional[str] = None,
                        content: Optional[str] = None,
                        content_base64: Optional[str] = None,
                        content_disposition: Optional[str] = None,
                        access_key: Optional[str] = None,
                        content_language: Optional[str] = None,
                        cache_control: Optional[str] = None,
                        endpoint: Optional[str] = None,
                        etag: Optional[str] = None,
                        force_destroy: Optional[bool] = None,
                        acl: Optional[str] = None,
                        metadata: Optional[Mapping[str, str]] = None,
                        secret_key: Optional[str] = None,
                        source: Optional[str] = None,
                        website_redirect: Optional[str] = None)
    func NewObjectStorageObject(ctx *Context, name string, args ObjectStorageObjectArgs, opts ...ResourceOption) (*ObjectStorageObject, error)
    public ObjectStorageObject(string name, ObjectStorageObjectArgs args, CustomResourceOptions? opts = null)
    public ObjectStorageObject(String name, ObjectStorageObjectArgs args)
public ObjectStorageObject(String name, ObjectStorageObjectArgs args, CustomResourceOptions options)

    type: linode:ObjectStorageObject
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args ObjectStorageObjectArgs
    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 ObjectStorageObjectArgs
    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 ObjectStorageObjectArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ObjectStorageObjectArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ObjectStorageObjectArgs
    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 objectStorageObjectResource = new Linode.ObjectStorageObject("objectStorageObjectResource", new()
{
    Cluster = "string",
    Key = "string",
    Bucket = "string",
    ContentEncoding = "string",
    ContentType = "string",
    Content = "string",
    ContentBase64 = "string",
    ContentDisposition = "string",
    AccessKey = "string",
    ContentLanguage = "string",
    CacheControl = "string",
    Endpoint = "string",
    Etag = "string",
    ForceDestroy = false,
    Acl = "string",
    Metadata = 
    {
        { "string", "string" },
    },
    SecretKey = "string",
    Source = "string",
    WebsiteRedirect = "string",
});

    example, err := linode.NewObjectStorageObject(ctx, "objectStorageObjectResource", &linode.ObjectStorageObjectArgs{
	Cluster:            pulumi.String("string"),
	Key:                pulumi.String("string"),
	Bucket:             pulumi.String("string"),
	ContentEncoding:    pulumi.String("string"),
	ContentType:        pulumi.String("string"),
	Content:            pulumi.String("string"),
	ContentBase64:      pulumi.String("string"),
	ContentDisposition: pulumi.String("string"),
	AccessKey:          pulumi.String("string"),
	ContentLanguage:    pulumi.String("string"),
	CacheControl:       pulumi.String("string"),
	Endpoint:           pulumi.String("string"),
	Etag:               pulumi.String("string"),
	ForceDestroy:       pulumi.Bool(false),
	Acl:                pulumi.String("string"),
	Metadata: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	SecretKey:       pulumi.String("string"),
	Source:          pulumi.String("string"),
	WebsiteRedirect: pulumi.String("string"),
})

    var objectStorageObjectResource = new ObjectStorageObject("objectStorageObjectResource", ObjectStorageObjectArgs.builder()
    .cluster("string")
    .key("string")
    .bucket("string")
    .contentEncoding("string")
    .contentType("string")
    .content("string")
    .contentBase64("string")
    .contentDisposition("string")
    .accessKey("string")
    .contentLanguage("string")
    .cacheControl("string")
    .endpoint("string")
    .etag("string")
    .forceDestroy(false)
    .acl("string")
    .metadata(Map.of("string", "string"))
    .secretKey("string")
    .source("string")
    .websiteRedirect("string")
    .build());

    object_storage_object_resource = linode.ObjectStorageObject("objectStorageObjectResource",
    cluster="string",
    key="string",
    bucket="string",
    content_encoding="string",
    content_type="string",
    content="string",
    content_base64="string",
    content_disposition="string",
    access_key="string",
    content_language="string",
    cache_control="string",
    endpoint="string",
    etag="string",
    force_destroy=False,
    acl="string",
    metadata={
        "string": "string",
    },
    secret_key="string",
    source="string",
    website_redirect="string")

    const objectStorageObjectResource = new linode.ObjectStorageObject("objectStorageObjectResource", {
    cluster: "string",
    key: "string",
    bucket: "string",
    contentEncoding: "string",
    contentType: "string",
    content: "string",
    contentBase64: "string",
    contentDisposition: "string",
    accessKey: "string",
    contentLanguage: "string",
    cacheControl: "string",
    endpoint: "string",
    etag: "string",
    forceDestroy: false,
    acl: "string",
    metadata: {
        string: "string",
    },
    secretKey: "string",
    source: "string",
    websiteRedirect: "string",
});

    type: linode:ObjectStorageObject
properties:
    accessKey: string
    acl: string
    bucket: string
    cacheControl: string
    cluster: string
    content: string
    contentBase64: string
    contentDisposition: string
    contentEncoding: string
    contentLanguage: string
    contentType: string
    endpoint: string
    etag: string
    forceDestroy: false
    key: string
    metadata:
        string: string
    secretKey: string
    source: string
    websiteRedirect: string

    ObjectStorageObject Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The ObjectStorageObject resource accepts the following input properties:

    Bucket string
    The name of the bucket to put the object in.
    Cluster string
    The cluster the bucket is in.
    Key string
    They name of the object once it is in the bucket.
    AccessKey string
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    Acl string
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    CacheControl string
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    Content string
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    ContentBase64 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.
    ContentDisposition string
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    ContentEncoding string
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    ContentLanguage string
    The language the content is in e.g. en-US or en-GB.
    ContentType 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.
    Endpoint string
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    Etag string
    The specific version of this object.
    ForceDestroy bool
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    Metadata Dictionary<string, string>
    A map of keys/values to provision metadata.
    SecretKey string
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    Source string
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    WebsiteRedirect string
    Specifies a target URL for website redirect.
    Bucket string
    The name of the bucket to put the object in.
    Cluster string
    The cluster the bucket is in.
    Key string
    They name of the object once it is in the bucket.
    AccessKey string
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    Acl string
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    CacheControl string
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    Content string
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    ContentBase64 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.
    ContentDisposition string
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    ContentEncoding string
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    ContentLanguage string
    The language the content is in e.g. en-US or en-GB.
    ContentType 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.
    Endpoint string
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    Etag string
    The specific version of this object.
    ForceDestroy bool
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    Metadata map[string]string
    A map of keys/values to provision metadata.
    SecretKey string
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    Source string
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    WebsiteRedirect string
    Specifies a target URL for website redirect.
    bucket String
    The name of the bucket to put the object in.
    cluster String
    The cluster the bucket is in.
    key String
    They name of the object once it is in the bucket.
    accessKey String
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    acl String
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    cacheControl String
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    content String
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    contentBase64 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.
    contentDisposition String
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    contentEncoding String
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    contentLanguage String
    The language the content is in e.g. en-US or en-GB.
    contentType 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.
    endpoint String
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    etag String
    The specific version of this object.
    forceDestroy Boolean
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    metadata Map<String,String>
    A map of keys/values to provision metadata.
    secretKey String
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    source String
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    websiteRedirect String
    Specifies a target URL for website redirect.
    bucket string
    The name of the bucket to put the object in.
    cluster string
    The cluster the bucket is in.
    key string
    They name of the object once it is in the bucket.
    accessKey string
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    acl string
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    cacheControl string
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    content string
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    contentBase64 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.
    contentDisposition string
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    contentEncoding string
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    contentLanguage string
    The language the content is in e.g. en-US or en-GB.
    contentType 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.
    endpoint string
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    etag string
    The specific version of this object.
    forceDestroy boolean
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    metadata {[key: string]: string}
    A map of keys/values to provision metadata.
    secretKey string
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    source string
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    websiteRedirect string
    Specifies a target URL for website redirect.
    bucket str
    The name of the bucket to put the object in.
    cluster str
    The cluster the bucket is in.
    key str
    They name of the object once it is in the bucket.
    access_key str
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    acl str
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    cache_control str
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    content str
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    content_base64 str
    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.
    content_disposition str
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    content_encoding str
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    content_language str
    The language the content is in e.g. en-US or en-GB.
    content_type str
    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.
    endpoint str
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    etag str
    The specific version of this object.
    force_destroy bool
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    metadata Mapping[str, str]
    A map of keys/values to provision metadata.
    secret_key str
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    source str
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    website_redirect str
    Specifies a target URL for website redirect.
    bucket String
    The name of the bucket to put the object in.
    cluster String
    The cluster the bucket is in.
    key String
    They name of the object once it is in the bucket.
    accessKey String
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    acl String
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    cacheControl String
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    content String
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    contentBase64 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.
    contentDisposition String
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    contentEncoding String
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    contentLanguage String
    The language the content is in e.g. en-US or en-GB.
    contentType 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.
    endpoint String
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    etag String
    The specific version of this object.
    forceDestroy Boolean
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    metadata Map<String>
    A map of keys/values to provision metadata.
    secretKey String
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    source String
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    websiteRedirect String
    Specifies a target URL for website redirect.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the ObjectStorageObject resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    VersionId string
    A unique version ID value for the object.
    Id string
    The provider-assigned unique ID for this managed resource.
    VersionId string
    A unique version ID value for the object.
    id String
    The provider-assigned unique ID for this managed resource.
    versionId String
    A unique version ID value for the object.
    id string
    The provider-assigned unique ID for this managed resource.
    versionId string
    A unique version ID value for the object.
    id str
    The provider-assigned unique ID for this managed resource.
    version_id str
    A unique version ID value for the object.
    id String
    The provider-assigned unique ID for this managed resource.
    versionId String
    A unique version ID value for the object.

    Look up Existing ObjectStorageObject Resource

    Get an existing ObjectStorageObject 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?: ObjectStorageObjectState, opts?: CustomResourceOptions): ObjectStorageObject
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        access_key: Optional[str] = None,
        acl: Optional[str] = None,
        bucket: Optional[str] = None,
        cache_control: Optional[str] = None,
        cluster: Optional[str] = None,
        content: Optional[str] = None,
        content_base64: Optional[str] = None,
        content_disposition: Optional[str] = None,
        content_encoding: Optional[str] = None,
        content_language: Optional[str] = None,
        content_type: Optional[str] = None,
        endpoint: Optional[str] = None,
        etag: Optional[str] = None,
        force_destroy: Optional[bool] = None,
        key: Optional[str] = None,
        metadata: Optional[Mapping[str, str]] = None,
        secret_key: Optional[str] = None,
        source: Optional[str] = None,
        version_id: Optional[str] = None,
        website_redirect: Optional[str] = None) -> ObjectStorageObject
    func GetObjectStorageObject(ctx *Context, name string, id IDInput, state *ObjectStorageObjectState, opts ...ResourceOption) (*ObjectStorageObject, error)
    public static ObjectStorageObject Get(string name, Input<string> id, ObjectStorageObjectState? state, CustomResourceOptions? opts = null)
    public static ObjectStorageObject get(String name, Output<String> id, ObjectStorageObjectState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    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.
    The following state arguments are supported:
    AccessKey string
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    Acl string
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    Bucket string
    The name of the bucket to put the object in.
    CacheControl string
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    Cluster string
    The cluster the bucket is in.
    Content string
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    ContentBase64 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.
    ContentDisposition string
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    ContentEncoding string
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    ContentLanguage string
    The language the content is in e.g. en-US or en-GB.
    ContentType 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.
    Endpoint string
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    Etag string
    The specific version of this object.
    ForceDestroy bool
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    Key string
    They name of the object once it is in the bucket.
    Metadata Dictionary<string, string>
    A map of keys/values to provision metadata.
    SecretKey string
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    Source string
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    VersionId string
    A unique version ID value for the object.
    WebsiteRedirect string
    Specifies a target URL for website redirect.
    AccessKey string
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    Acl string
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    Bucket string
    The name of the bucket to put the object in.
    CacheControl string
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    Cluster string
    The cluster the bucket is in.
    Content string
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    ContentBase64 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.
    ContentDisposition string
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    ContentEncoding string
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    ContentLanguage string
    The language the content is in e.g. en-US or en-GB.
    ContentType 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.
    Endpoint string
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    Etag string
    The specific version of this object.
    ForceDestroy bool
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    Key string
    They name of the object once it is in the bucket.
    Metadata map[string]string
    A map of keys/values to provision metadata.
    SecretKey string
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    Source string
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    VersionId string
    A unique version ID value for the object.
    WebsiteRedirect string
    Specifies a target URL for website redirect.
    accessKey String
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    acl String
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    bucket String
    The name of the bucket to put the object in.
    cacheControl String
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    cluster String
    The cluster the bucket is in.
    content String
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    contentBase64 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.
    contentDisposition String
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    contentEncoding String
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    contentLanguage String
    The language the content is in e.g. en-US or en-GB.
    contentType 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.
    endpoint String
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    etag String
    The specific version of this object.
    forceDestroy Boolean
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    key String
    They name of the object once it is in the bucket.
    metadata Map<String,String>
    A map of keys/values to provision metadata.
    secretKey String
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    source String
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    versionId String
    A unique version ID value for the object.
    websiteRedirect String
    Specifies a target URL for website redirect.
    accessKey string
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    acl string
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    bucket string
    The name of the bucket to put the object in.
    cacheControl string
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    cluster string
    The cluster the bucket is in.
    content string
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    contentBase64 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.
    contentDisposition string
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    contentEncoding string
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    contentLanguage string
    The language the content is in e.g. en-US or en-GB.
    contentType 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.
    endpoint string
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    etag string
    The specific version of this object.
    forceDestroy boolean
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    key string
    They name of the object once it is in the bucket.
    metadata {[key: string]: string}
    A map of keys/values to provision metadata.
    secretKey string
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    source string
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    versionId string
    A unique version ID value for the object.
    websiteRedirect string
    Specifies a target URL for website redirect.
    access_key str
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    acl str
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    bucket str
    The name of the bucket to put the object in.
    cache_control str
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    cluster str
    The cluster the bucket is in.
    content str
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    content_base64 str
    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.
    content_disposition str
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    content_encoding str
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    content_language str
    The language the content is in e.g. en-US or en-GB.
    content_type str
    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.
    endpoint str
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    etag str
    The specific version of this object.
    force_destroy bool
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    key str
    They name of the object once it is in the bucket.
    metadata Mapping[str, str]
    A map of keys/values to provision metadata.
    secret_key str
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    source str
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    version_id str
    A unique version ID value for the object.
    website_redirect str
    Specifies a target URL for website redirect.
    accessKey String
    The REQUIRED access key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_access_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    acl String
    The canned ACL to apply. (private, public-read, authenticated-read, public-read-write, custom) (defaults to private).
    bucket String
    The name of the bucket to put the object in.
    cacheControl String
    Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
    cluster String
    The cluster the bucket is in.
    content String
    Literal string value to use as the object content, which will be uploaded as UTF-8-encoded text.
    contentBase64 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.
    contentDisposition String
    Specifies presentational information for the object. Read w3c content_disposition for further information.
    contentEncoding String
    Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
    contentLanguage String
    The language the content is in e.g. en-US or en-GB.
    contentType 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.
    endpoint String
    Used with the s3 client to make bucket changes and will be computed automatically if left blank, override for testing/debug purposes.
    etag String
    The specific version of this object.
    forceDestroy Boolean
    Allow the object to be deleted regardless of any legal hold or object lock (defaults to false).
    key String
    They name of the object once it is in the bucket.
    metadata Map<String>
    A map of keys/values to provision metadata.
    secretKey String
    The REQUIRED secret key to authenticate with. If it's not specified with the resource, you must provide its value by

    • configuring the obj_secret_key in the provider configuration;
    • or, opting-in generating it implicitly at apply-time using obj_use_temp_keys at provider-level.
    source String
    The path to a file that will be read and uploaded as raw bytes for the object content. The path must either be relative to the root module or absolute.
    versionId String
    A unique version ID value for the object.
    websiteRedirect String
    Specifies a target URL for website redirect.

    Package Details

    Repository
    Linode pulumi/pulumi-linode
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the linode Terraform Provider.
    linode logo
    Linode v4.22.0 published on Tuesday, Jun 25, 2024 by Pulumi
    pulumi/pulumi-linode