Oracle Cloud Infrastructure
getObjectVersions
This data source provides the list of Object Versions in Oracle Cloud Infrastructure Object Storage service.
Lists the object versions in a bucket.
ListObjectVersions returns an ObjectVersionCollection containing at most 1000 object versions. To paginate through
more object versions, use the returned opc-next-page
value with the page
request parameter.
To use this and other API operations, you must be authorized in an IAM policy. If you are not authorized, talk to an administrator. If you are an administrator who needs to write policies to give users access, see Getting Started with Policies.
Example Usage
using Pulumi;
using Oci = Pulumi.Oci;
class MyStack : Stack
{
public MyStack()
{
var testObjectVersions = Output.Create(Oci.ObjectStorage.GetObjectVersions.InvokeAsync(new Oci.ObjectStorage.GetObjectVersionsArgs
{
Bucket = @var.Object_version_bucket,
Namespace = @var.Object_version_namespace,
Delimiter = @var.Object_version_delimiter,
End = @var.Object_version_end,
Fields = @var.Object_version_fields,
Prefix = @var.Object_version_prefix,
Start = @var.Object_version_start,
StartAfter = @var.Object_version_start_after,
}));
}
}
package main
import (
"github.com/pulumi/pulumi-oci/sdk/go/oci/ObjectStorage"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := ObjectStorage.GetObjectVersions(ctx, &objectstorage.GetObjectVersionsArgs{
Bucket: _var.Object_version_bucket,
Namespace: _var.Object_version_namespace,
Delimiter: pulumi.StringRef(_var.Object_version_delimiter),
End: pulumi.StringRef(_var.Object_version_end),
Fields: pulumi.StringRef(_var.Object_version_fields),
Prefix: pulumi.StringRef(_var.Object_version_prefix),
Start: pulumi.StringRef(_var.Object_version_start),
StartAfter: pulumi.StringRef(_var.Object_version_start_after),
}, nil)
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_oci as oci
test_object_versions = oci.ObjectStorage.get_object_versions(bucket=var["object_version_bucket"],
namespace=var["object_version_namespace"],
delimiter=var["object_version_delimiter"],
end=var["object_version_end"],
fields=var["object_version_fields"],
prefix=var["object_version_prefix"],
start=var["object_version_start"],
start_after=var["object_version_start_after"])
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testObjectVersions = oci.ObjectStorage.getObjectVersions({
bucket: _var.object_version_bucket,
namespace: _var.object_version_namespace,
delimiter: _var.object_version_delimiter,
end: _var.object_version_end,
fields: _var.object_version_fields,
prefix: _var.object_version_prefix,
start: _var.object_version_start,
startAfter: _var.object_version_start_after,
});
Coming soon!
Using getObjectVersions
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getObjectVersions(args: GetObjectVersionsArgs, opts?: InvokeOptions): Promise<GetObjectVersionsResult>
function getObjectVersionsOutput(args: GetObjectVersionsOutputArgs, opts?: InvokeOptions): Output<GetObjectVersionsResult>
def get_object_versions(bucket: Optional[str] = None,
delimiter: Optional[str] = None,
end: Optional[str] = None,
fields: Optional[str] = None,
filters: Optional[Sequence[_objectstorage.GetObjectVersionsFilter]] = None,
namespace: Optional[str] = None,
prefix: Optional[str] = None,
start: Optional[str] = None,
start_after: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetObjectVersionsResult
def get_object_versions_output(bucket: Optional[pulumi.Input[str]] = None,
delimiter: Optional[pulumi.Input[str]] = None,
end: Optional[pulumi.Input[str]] = None,
fields: Optional[pulumi.Input[str]] = None,
filters: Optional[pulumi.Input[Sequence[pulumi.Input[_objectstorage.GetObjectVersionsFilterArgs]]]] = None,
namespace: Optional[pulumi.Input[str]] = None,
prefix: Optional[pulumi.Input[str]] = None,
start: Optional[pulumi.Input[str]] = None,
start_after: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetObjectVersionsResult]
func GetObjectVersions(ctx *Context, args *GetObjectVersionsArgs, opts ...InvokeOption) (*GetObjectVersionsResult, error)
func GetObjectVersionsOutput(ctx *Context, args *GetObjectVersionsOutputArgs, opts ...InvokeOption) GetObjectVersionsResultOutput
> Note: This function is named GetObjectVersions
in the Go SDK.
public static class GetObjectVersions
{
public static Task<GetObjectVersionsResult> InvokeAsync(GetObjectVersionsArgs args, InvokeOptions? opts = null)
public static Output<GetObjectVersionsResult> Invoke(GetObjectVersionsInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetObjectVersionsResult> getObjectVersions(GetObjectVersionsArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
Fn::Invoke:
Function: oci:ObjectStorage/getObjectVersions:getObjectVersions
Arguments:
# Arguments dictionary
The following arguments are supported:
- Bucket string
The name of the bucket. Avoid entering confidential information. Example:
my-new-bucket1
- Namespace string
The Object Storage namespace used for the request.
- Delimiter string
When this parameter is set, only objects whose names do not contain the delimiter character (after an optionally specified prefix) are returned in the objects key of the response body. Scanned objects whose names contain the delimiter have the part of their name up to the first occurrence of the delimiter (including the optional prefix) returned as a set of prefixes. Note that only '/' is a supported delimiter character at this time.
- End string
Object names returned by a list query must be strictly less than this parameter.
- Fields string
Object summary by default includes only the 'name' field. Use this parameter to also include 'size' (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time), 'timeModified' (object modification date and time), 'storageTier' and 'archivalState' fields. Specify the value of this parameter as a comma-separated, case-insensitive list of those field names. For example 'name,etag,timeCreated,md5,timeModified,storageTier,archivalState'.
- Filters
List<Get
Object Versions Filter> - Prefix string
The string to use for matching against the start of object names in a list query.
- Start string
Object names returned by a list query must be greater or equal to this parameter.
- Start
After string Object names returned by a list query must be greater than this parameter.
- Bucket string
The name of the bucket. Avoid entering confidential information. Example:
my-new-bucket1
- Namespace string
The Object Storage namespace used for the request.
- Delimiter string
When this parameter is set, only objects whose names do not contain the delimiter character (after an optionally specified prefix) are returned in the objects key of the response body. Scanned objects whose names contain the delimiter have the part of their name up to the first occurrence of the delimiter (including the optional prefix) returned as a set of prefixes. Note that only '/' is a supported delimiter character at this time.
- End string
Object names returned by a list query must be strictly less than this parameter.
- Fields string
Object summary by default includes only the 'name' field. Use this parameter to also include 'size' (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time), 'timeModified' (object modification date and time), 'storageTier' and 'archivalState' fields. Specify the value of this parameter as a comma-separated, case-insensitive list of those field names. For example 'name,etag,timeCreated,md5,timeModified,storageTier,archivalState'.
- Filters
[]Get
Object Versions Filter - Prefix string
The string to use for matching against the start of object names in a list query.
- Start string
Object names returned by a list query must be greater or equal to this parameter.
- Start
After string Object names returned by a list query must be greater than this parameter.
- bucket String
The name of the bucket. Avoid entering confidential information. Example:
my-new-bucket1
- namespace String
The Object Storage namespace used for the request.
- delimiter String
When this parameter is set, only objects whose names do not contain the delimiter character (after an optionally specified prefix) are returned in the objects key of the response body. Scanned objects whose names contain the delimiter have the part of their name up to the first occurrence of the delimiter (including the optional prefix) returned as a set of prefixes. Note that only '/' is a supported delimiter character at this time.
- end String
Object names returned by a list query must be strictly less than this parameter.
- fields String
Object summary by default includes only the 'name' field. Use this parameter to also include 'size' (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time), 'timeModified' (object modification date and time), 'storageTier' and 'archivalState' fields. Specify the value of this parameter as a comma-separated, case-insensitive list of those field names. For example 'name,etag,timeCreated,md5,timeModified,storageTier,archivalState'.
- filters
List<Get
Object Versions Filter> - prefix String
The string to use for matching against the start of object names in a list query.
- start String
Object names returned by a list query must be greater or equal to this parameter.
- start
After String Object names returned by a list query must be greater than this parameter.
- bucket string
The name of the bucket. Avoid entering confidential information. Example:
my-new-bucket1
- namespace string
The Object Storage namespace used for the request.
- delimiter string
When this parameter is set, only objects whose names do not contain the delimiter character (after an optionally specified prefix) are returned in the objects key of the response body. Scanned objects whose names contain the delimiter have the part of their name up to the first occurrence of the delimiter (including the optional prefix) returned as a set of prefixes. Note that only '/' is a supported delimiter character at this time.
- end string
Object names returned by a list query must be strictly less than this parameter.
- fields string
Object summary by default includes only the 'name' field. Use this parameter to also include 'size' (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time), 'timeModified' (object modification date and time), 'storageTier' and 'archivalState' fields. Specify the value of this parameter as a comma-separated, case-insensitive list of those field names. For example 'name,etag,timeCreated,md5,timeModified,storageTier,archivalState'.
- filters
Get
Object Versions Filter[] - prefix string
The string to use for matching against the start of object names in a list query.
- start string
Object names returned by a list query must be greater or equal to this parameter.
- start
After string Object names returned by a list query must be greater than this parameter.
- bucket str
The name of the bucket. Avoid entering confidential information. Example:
my-new-bucket1
- namespace str
The Object Storage namespace used for the request.
- delimiter str
When this parameter is set, only objects whose names do not contain the delimiter character (after an optionally specified prefix) are returned in the objects key of the response body. Scanned objects whose names contain the delimiter have the part of their name up to the first occurrence of the delimiter (including the optional prefix) returned as a set of prefixes. Note that only '/' is a supported delimiter character at this time.
- end str
Object names returned by a list query must be strictly less than this parameter.
- fields str
Object summary by default includes only the 'name' field. Use this parameter to also include 'size' (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time), 'timeModified' (object modification date and time), 'storageTier' and 'archivalState' fields. Specify the value of this parameter as a comma-separated, case-insensitive list of those field names. For example 'name,etag,timeCreated,md5,timeModified,storageTier,archivalState'.
- filters
Get
Object Versions Filter] - prefix str
The string to use for matching against the start of object names in a list query.
- start str
Object names returned by a list query must be greater or equal to this parameter.
- start_
after str Object names returned by a list query must be greater than this parameter.
- bucket String
The name of the bucket. Avoid entering confidential information. Example:
my-new-bucket1
- namespace String
The Object Storage namespace used for the request.
- delimiter String
When this parameter is set, only objects whose names do not contain the delimiter character (after an optionally specified prefix) are returned in the objects key of the response body. Scanned objects whose names contain the delimiter have the part of their name up to the first occurrence of the delimiter (including the optional prefix) returned as a set of prefixes. Note that only '/' is a supported delimiter character at this time.
- end String
Object names returned by a list query must be strictly less than this parameter.
- fields String
Object summary by default includes only the 'name' field. Use this parameter to also include 'size' (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time), 'timeModified' (object modification date and time), 'storageTier' and 'archivalState' fields. Specify the value of this parameter as a comma-separated, case-insensitive list of those field names. For example 'name,etag,timeCreated,md5,timeModified,storageTier,archivalState'.
- filters List<Property Map>
- prefix String
The string to use for matching against the start of object names in a list query.
- start String
Object names returned by a list query must be greater or equal to this parameter.
- start
After String Object names returned by a list query must be greater than this parameter.
getObjectVersions Result
The following output properties are available:
- Bucket string
- Id string
The provider-assigned unique ID for this managed resource.
- Items
List<Get
Object Versions Item> An array of object version summaries.
- Namespace string
- Prefixes List<string>
Prefixes that are common to the results returned by the request if the request specified a delimiter.
- Delimiter string
- End string
- Fields string
- Filters
List<Get
Object Versions Filter> - Prefix string
- Start string
- Start
After string
- Bucket string
- Id string
The provider-assigned unique ID for this managed resource.
- Items
[]Get
Object Versions Item An array of object version summaries.
- Namespace string
- Prefixes []string
Prefixes that are common to the results returned by the request if the request specified a delimiter.
- Delimiter string
- End string
- Fields string
- Filters
[]Get
Object Versions Filter - Prefix string
- Start string
- Start
After string
- bucket String
- id String
The provider-assigned unique ID for this managed resource.
- items
List<Get
Object Versions Item> An array of object version summaries.
- namespace String
- prefixes List<String>
Prefixes that are common to the results returned by the request if the request specified a delimiter.
- delimiter String
- end String
- fields String
- filters
List<Get
Object Versions Filter> - prefix String
- start String
- start
After String
- bucket string
- id string
The provider-assigned unique ID for this managed resource.
- items
Get
Object Versions Item[] An array of object version summaries.
- namespace string
- prefixes string[]
Prefixes that are common to the results returned by the request if the request specified a delimiter.
- delimiter string
- end string
- fields string
- filters
Get
Object Versions Filter[] - prefix string
- start string
- start
After string
- bucket str
- id str
The provider-assigned unique ID for this managed resource.
- items
Get
Object Versions Item] An array of object version summaries.
- namespace str
- prefixes Sequence[str]
Prefixes that are common to the results returned by the request if the request specified a delimiter.
- delimiter str
- end str
- fields str
- filters
Get
Object Versions Filter] - prefix str
- start str
- start_
after str
- bucket String
- id String
The provider-assigned unique ID for this managed resource.
- items List<Property Map>
An array of object version summaries.
- namespace String
- prefixes List<String>
Prefixes that are common to the results returned by the request if the request specified a delimiter.
- delimiter String
- end String
- fields String
- filters List<Property Map>
- prefix String
- start String
- start
After String
Supporting Types
GetObjectVersionsFilter
GetObjectVersionsItem
- Archival
State string Archival state of an object. This field is set only for objects in Archive tier.
- Etag string
The current entity tag (ETag) for the object.
- Is
Delete boolMarker This flag will indicate if the version is deleted or not.
- Md5 string
Base64-encoded MD5 hash of the object data.
- Name string
The name of the object. Avoid entering confidential information. Example: test/object1.log
- Size string
Size of the object in bytes.
- Storage
Tier string The storage tier that the object is stored in.
- Time
Created string The date and time the object was created, as described in RFC 2616.
- Time
Modified string The date and time the object was modified, as described in RFC 2616.
- Version
Id string VersionId of the object.
- Archival
State string Archival state of an object. This field is set only for objects in Archive tier.
- Etag string
The current entity tag (ETag) for the object.
- Is
Delete boolMarker This flag will indicate if the version is deleted or not.
- Md5 string
Base64-encoded MD5 hash of the object data.
- Name string
The name of the object. Avoid entering confidential information. Example: test/object1.log
- Size string
Size of the object in bytes.
- Storage
Tier string The storage tier that the object is stored in.
- Time
Created string The date and time the object was created, as described in RFC 2616.
- Time
Modified string The date and time the object was modified, as described in RFC 2616.
- Version
Id string VersionId of the object.
- archival
State String Archival state of an object. This field is set only for objects in Archive tier.
- etag String
The current entity tag (ETag) for the object.
- is
Delete BooleanMarker This flag will indicate if the version is deleted or not.
- md5 String
Base64-encoded MD5 hash of the object data.
- name String
The name of the object. Avoid entering confidential information. Example: test/object1.log
- size String
Size of the object in bytes.
- storage
Tier String The storage tier that the object is stored in.
- time
Created String The date and time the object was created, as described in RFC 2616.
- time
Modified String The date and time the object was modified, as described in RFC 2616.
- version
Id String VersionId of the object.
- archival
State string Archival state of an object. This field is set only for objects in Archive tier.
- etag string
The current entity tag (ETag) for the object.
- is
Delete booleanMarker This flag will indicate if the version is deleted or not.
- md5 string
Base64-encoded MD5 hash of the object data.
- name string
The name of the object. Avoid entering confidential information. Example: test/object1.log
- size string
Size of the object in bytes.
- storage
Tier string The storage tier that the object is stored in.
- time
Created string The date and time the object was created, as described in RFC 2616.
- time
Modified string The date and time the object was modified, as described in RFC 2616.
- version
Id string VersionId of the object.
- archival_
state str Archival state of an object. This field is set only for objects in Archive tier.
- etag str
The current entity tag (ETag) for the object.
- is_
delete_ boolmarker This flag will indicate if the version is deleted or not.
- md5 str
Base64-encoded MD5 hash of the object data.
- name str
The name of the object. Avoid entering confidential information. Example: test/object1.log
- size str
Size of the object in bytes.
- storage_
tier str The storage tier that the object is stored in.
- time_
created str The date and time the object was created, as described in RFC 2616.
- time_
modified str The date and time the object was modified, as described in RFC 2616.
- version_
id str VersionId of the object.
- archival
State String Archival state of an object. This field is set only for objects in Archive tier.
- etag String
The current entity tag (ETag) for the object.
- is
Delete BooleanMarker This flag will indicate if the version is deleted or not.
- md5 String
Base64-encoded MD5 hash of the object data.
- name String
The name of the object. Avoid entering confidential information. Example: test/object1.log
- size String
Size of the object in bytes.
- storage
Tier String The storage tier that the object is stored in.
- time
Created String The date and time the object was created, as described in RFC 2616.
- time
Modified String The date and time the object was modified, as described in RFC 2616.
- version
Id String VersionId of the object.
Package Details
- Repository
- https://github.com/pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
oci
Terraform Provider.