Oracle Cloud Infrastructure v2.33.0, May 1 25

Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi

oci.ObjectStorage.getBucketSummaries

Explore with Pulumi AI

Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi

Example Usage

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

const testBuckets = oci.ObjectStorage.getBucketSummaries({
    compartmentId: compartmentId,
    namespace: bucketNamespace,
});

import pulumi
import pulumi_oci as oci

test_buckets = oci.ObjectStorage.get_bucket_summaries(compartment_id=compartment_id,
    namespace=bucket_namespace)

package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/objectstorage"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := objectstorage.GetBucketSummaries(ctx, &objectstorage.GetBucketSummariesArgs{
			CompartmentId: compartmentId,
			Namespace:     bucketNamespace,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var testBuckets = Oci.ObjectStorage.GetBucketSummaries.Invoke(new()
    {
        CompartmentId = compartmentId,
        Namespace = bucketNamespace,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.ObjectStorage.ObjectStorageFunctions;
import com.pulumi.oci.ObjectStorage.inputs.GetBucketSummariesArgs;
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) {
        final var testBuckets = ObjectStorageFunctions.getBucketSummaries(GetBucketSummariesArgs.builder()
            .compartmentId(compartmentId)
            .namespace(bucketNamespace)
            .build());

    }
}

variables:
  testBuckets:
    fn::invoke:
      function: oci:ObjectStorage:getBucketSummaries
      arguments:
        compartmentId: ${compartmentId}
        namespace: ${bucketNamespace}

Using getBucketSummaries

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 getBucketSummaries(args: GetBucketSummariesArgs, opts?: InvokeOptions): Promise<GetBucketSummariesResult>
function getBucketSummariesOutput(args: GetBucketSummariesOutputArgs, opts?: InvokeOptions): Output<GetBucketSummariesResult>

def get_bucket_summaries(compartment_id: Optional[str] = None,
                         filters: Optional[Sequence[GetBucketSummariesFilter]] = None,
                         namespace: Optional[str] = None,
                         opts: Optional[InvokeOptions] = None) -> GetBucketSummariesResult
def get_bucket_summaries_output(compartment_id: Optional[pulumi.Input[str]] = None,
                         filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetBucketSummariesFilterArgs]]]] = None,
                         namespace: Optional[pulumi.Input[str]] = None,
                         opts: Optional[InvokeOptions] = None) -> Output[GetBucketSummariesResult]

func GetBucketSummaries(ctx *Context, args *GetBucketSummariesArgs, opts ...InvokeOption) (*GetBucketSummariesResult, error)
func GetBucketSummariesOutput(ctx *Context, args *GetBucketSummariesOutputArgs, opts ...InvokeOption) GetBucketSummariesResultOutput

> Note: This function is named GetBucketSummaries in the Go SDK.

public static class GetBucketSummaries 
{
    public static Task<GetBucketSummariesResult> InvokeAsync(GetBucketSummariesArgs args, InvokeOptions? opts = null)
    public static Output<GetBucketSummariesResult> Invoke(GetBucketSummariesInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetBucketSummariesResult> getBucketSummaries(GetBucketSummariesArgs args, InvokeOptions options)
public static Output<GetBucketSummariesResult> getBucketSummaries(GetBucketSummariesArgs args, InvokeOptions options)

fn::invoke:
  function: oci:ObjectStorage/getBucketSummaries:getBucketSummaries
  arguments:
    # arguments dictionary

The following arguments are supported:

CompartmentId string: The ID of the compartment in which to list buckets.
Namespace string: The Object Storage namespace used for the request.
Filters List<GetBucketSummariesFilter>

CompartmentId string: The ID of the compartment in which to list buckets.
Namespace string: The Object Storage namespace used for the request.
Filters []GetBucketSummariesFilter

compartmentId String: The ID of the compartment in which to list buckets.
namespace String: The Object Storage namespace used for the request.
filters List<GetBucketSummariesFilter>

compartmentId string: The ID of the compartment in which to list buckets.
namespace string: The Object Storage namespace used for the request.
filters GetBucketSummariesFilter[]

compartment_id str: The ID of the compartment in which to list buckets.
namespace str: The Object Storage namespace used for the request.
filters Sequence[GetBucketSummariesFilter]

compartmentId String: The ID of the compartment in which to list buckets.
namespace String: The Object Storage namespace used for the request.
filters List<Property Map>

getBucketSummaries Result

The following output properties are available:

BucketSummaries List<GetBucketSummariesBucketSummary>: The list of bucket_summaries.
CompartmentId string: The compartment ID in which the bucket is authorized.
Id string: The provider-assigned unique ID for this managed resource.
Namespace string: The Object Storage namespace in which the bucket resides.
Filters List<GetBucketSummariesFilter>

BucketSummaries []GetBucketSummariesBucketSummary: The list of bucket_summaries.
CompartmentId string: The compartment ID in which the bucket is authorized.
Id string: The provider-assigned unique ID for this managed resource.
Namespace string: The Object Storage namespace in which the bucket resides.
Filters []GetBucketSummariesFilter

bucketSummaries List<GetBucketSummariesBucketSummary>: The list of bucket_summaries.
compartmentId String: The compartment ID in which the bucket is authorized.
id String: The provider-assigned unique ID for this managed resource.
namespace String: The Object Storage namespace in which the bucket resides.
filters List<GetBucketSummariesFilter>

bucketSummaries GetBucketSummariesBucketSummary[]: The list of bucket_summaries.
compartmentId string: The compartment ID in which the bucket is authorized.
id string: The provider-assigned unique ID for this managed resource.
namespace string: The Object Storage namespace in which the bucket resides.
filters GetBucketSummariesFilter[]

bucket_summaries Sequence[GetBucketSummariesBucketSummary]: The list of bucket_summaries.
compartment_id str: The compartment ID in which the bucket is authorized.
id str: The provider-assigned unique ID for this managed resource.
namespace str: The Object Storage namespace in which the bucket resides.
filters Sequence[GetBucketSummariesFilter]

bucketSummaries List<Property Map>: The list of bucket_summaries.
compartmentId String: The compartment ID in which the bucket is authorized.
id String: The provider-assigned unique ID for this managed resource.
namespace String: The Object Storage namespace in which the bucket resides.
filters List<Property Map>

Supporting Types

GetBucketSummariesBucketSummary

AccessType string: The type of public access enabled on this bucket. A bucket is set to NoPublicAccess by default, which only allows an authenticated caller to access the bucket and its contents. When ObjectRead is enabled on the bucket, public access is allowed for the GetObject, HeadObject, and ListObjects operations. When ObjectReadWithoutList is enabled on the bucket, public access is allowed for the GetObject and HeadObject operations.
ApproximateCount string: The approximate number of objects in the bucket. Count statistics are reported periodically. You will see a lag between what is displayed and the actual object count.
ApproximateSize string: The approximate total size in bytes of all objects in the bucket. Size statistics are reported periodically. You will see a lag between what is displayed and the actual size of the bucket.
AutoTiering string: The auto tiering status on the bucket. A bucket is created with auto tiering Disabled by default. For auto tiering InfrequentAccess, objects are transitioned automatically between the 'Standard' and 'InfrequentAccess' tiers based on the access pattern of the objects.
BucketId string
CompartmentId string: The ID of the compartment in which to list buckets.
CreatedBy string: The OCID of the user who created the bucket.
DefinedTags Dictionary<string, string>: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
Etag string: The entity tag (ETag) for the bucket.
FreeformTags Dictionary<string, string>: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
Id string
IsReadOnly bool: Whether or not this bucket is read only. By default, isReadOnly is set to false. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
KmsKeyId string: The OCID of a master encryption key used to call the Key Management service to generate a data encryption key or to encrypt or decrypt a data encryption key.
Metadata Dictionary<string, string>: Arbitrary string keys and values for user-defined metadata.
Name string: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
Namespace string: The Object Storage namespace used for the request.
ObjectEventsEnabled bool: Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabled is set to false. Set objectEventsEnabled to true to emit events for object state changes. For more information about events, see Overview of Events.
ObjectLifecyclePolicyEtag string: The entity tag (ETag) for the live object lifecycle policy on the bucket.
ReplicationEnabled bool: Whether or not this bucket is a replication source. By default, replicationEnabled is set to false. This will be set to 'true' when you create a replication policy for the bucket.
RetentionRules List<GetBucketSummariesBucketSummaryRetentionRule>
StorageTier string: The storage tier type assigned to the bucket. A bucket is set to Standard tier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When the Archive tier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. The storageTier property is immutable after bucket is created.
TimeCreated string: The date and time the bucket was created, as described in RFC 2616.
Versioning string: The versioning status on the bucket. A bucket is created with versioning Disabled by default. For versioning Enabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning is Suspended, the previous versions will still remain but new versions will no longer be created when overwitten or deleted.

AccessType string: The type of public access enabled on this bucket. A bucket is set to NoPublicAccess by default, which only allows an authenticated caller to access the bucket and its contents. When ObjectRead is enabled on the bucket, public access is allowed for the GetObject, HeadObject, and ListObjects operations. When ObjectReadWithoutList is enabled on the bucket, public access is allowed for the GetObject and HeadObject operations.
ApproximateCount string: The approximate number of objects in the bucket. Count statistics are reported periodically. You will see a lag between what is displayed and the actual object count.
ApproximateSize string: The approximate total size in bytes of all objects in the bucket. Size statistics are reported periodically. You will see a lag between what is displayed and the actual size of the bucket.
AutoTiering string: The auto tiering status on the bucket. A bucket is created with auto tiering Disabled by default. For auto tiering InfrequentAccess, objects are transitioned automatically between the 'Standard' and 'InfrequentAccess' tiers based on the access pattern of the objects.
BucketId string
CompartmentId string: The ID of the compartment in which to list buckets.
CreatedBy string: The OCID of the user who created the bucket.
DefinedTags map[string]string: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
Etag string: The entity tag (ETag) for the bucket.
FreeformTags map[string]string: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
Id string
IsReadOnly bool: Whether or not this bucket is read only. By default, isReadOnly is set to false. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
KmsKeyId string: The OCID of a master encryption key used to call the Key Management service to generate a data encryption key or to encrypt or decrypt a data encryption key.
Metadata map[string]string: Arbitrary string keys and values for user-defined metadata.
Name string: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
Namespace string: The Object Storage namespace used for the request.
ObjectEventsEnabled bool: Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabled is set to false. Set objectEventsEnabled to true to emit events for object state changes. For more information about events, see Overview of Events.
ObjectLifecyclePolicyEtag string: The entity tag (ETag) for the live object lifecycle policy on the bucket.
ReplicationEnabled bool: Whether or not this bucket is a replication source. By default, replicationEnabled is set to false. This will be set to 'true' when you create a replication policy for the bucket.
RetentionRules []GetBucketSummariesBucketSummaryRetentionRule
StorageTier string: The storage tier type assigned to the bucket. A bucket is set to Standard tier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When the Archive tier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. The storageTier property is immutable after bucket is created.
TimeCreated string: The date and time the bucket was created, as described in RFC 2616.
Versioning string: The versioning status on the bucket. A bucket is created with versioning Disabled by default. For versioning Enabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning is Suspended, the previous versions will still remain but new versions will no longer be created when overwitten or deleted.

accessType String: The type of public access enabled on this bucket. A bucket is set to NoPublicAccess by default, which only allows an authenticated caller to access the bucket and its contents. When ObjectRead is enabled on the bucket, public access is allowed for the GetObject, HeadObject, and ListObjects operations. When ObjectReadWithoutList is enabled on the bucket, public access is allowed for the GetObject and HeadObject operations.
approximateCount String: The approximate number of objects in the bucket. Count statistics are reported periodically. You will see a lag between what is displayed and the actual object count.
approximateSize String: The approximate total size in bytes of all objects in the bucket. Size statistics are reported periodically. You will see a lag between what is displayed and the actual size of the bucket.
autoTiering String: The auto tiering status on the bucket. A bucket is created with auto tiering Disabled by default. For auto tiering InfrequentAccess, objects are transitioned automatically between the 'Standard' and 'InfrequentAccess' tiers based on the access pattern of the objects.
bucketId String
compartmentId String: The ID of the compartment in which to list buckets.
createdBy String: The OCID of the user who created the bucket.
definedTags Map<String,String>: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
etag String: The entity tag (ETag) for the bucket.
freeformTags Map<String,String>: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id String
isReadOnly Boolean: Whether or not this bucket is read only. By default, isReadOnly is set to false. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
kmsKeyId String: The OCID of a master encryption key used to call the Key Management service to generate a data encryption key or to encrypt or decrypt a data encryption key.
metadata Map<String,String>: Arbitrary string keys and values for user-defined metadata.
name String: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
namespace String: The Object Storage namespace used for the request.
objectEventsEnabled Boolean: Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabled is set to false. Set objectEventsEnabled to true to emit events for object state changes. For more information about events, see Overview of Events.
objectLifecyclePolicyEtag String: The entity tag (ETag) for the live object lifecycle policy on the bucket.
replicationEnabled Boolean: Whether or not this bucket is a replication source. By default, replicationEnabled is set to false. This will be set to 'true' when you create a replication policy for the bucket.
retentionRules List<GetBucketSummariesBucketSummaryRetentionRule>
storageTier String: The storage tier type assigned to the bucket. A bucket is set to Standard tier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When the Archive tier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. The storageTier property is immutable after bucket is created.
timeCreated String: The date and time the bucket was created, as described in RFC 2616.
versioning String: The versioning status on the bucket. A bucket is created with versioning Disabled by default. For versioning Enabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning is Suspended, the previous versions will still remain but new versions will no longer be created when overwitten or deleted.

accessType string: The type of public access enabled on this bucket. A bucket is set to NoPublicAccess by default, which only allows an authenticated caller to access the bucket and its contents. When ObjectRead is enabled on the bucket, public access is allowed for the GetObject, HeadObject, and ListObjects operations. When ObjectReadWithoutList is enabled on the bucket, public access is allowed for the GetObject and HeadObject operations.
approximateCount string: The approximate number of objects in the bucket. Count statistics are reported periodically. You will see a lag between what is displayed and the actual object count.
approximateSize string: The approximate total size in bytes of all objects in the bucket. Size statistics are reported periodically. You will see a lag between what is displayed and the actual size of the bucket.
autoTiering string: The auto tiering status on the bucket. A bucket is created with auto tiering Disabled by default. For auto tiering InfrequentAccess, objects are transitioned automatically between the 'Standard' and 'InfrequentAccess' tiers based on the access pattern of the objects.
bucketId string
compartmentId string: The ID of the compartment in which to list buckets.
createdBy string: The OCID of the user who created the bucket.
definedTags {[key: string]: string}: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
etag string: The entity tag (ETag) for the bucket.
freeformTags {[key: string]: string}: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id string
isReadOnly boolean: Whether or not this bucket is read only. By default, isReadOnly is set to false. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
kmsKeyId string: The OCID of a master encryption key used to call the Key Management service to generate a data encryption key or to encrypt or decrypt a data encryption key.
metadata {[key: string]: string}: Arbitrary string keys and values for user-defined metadata.
name string: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
namespace string: The Object Storage namespace used for the request.
objectEventsEnabled boolean: Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabled is set to false. Set objectEventsEnabled to true to emit events for object state changes. For more information about events, see Overview of Events.
objectLifecyclePolicyEtag string: The entity tag (ETag) for the live object lifecycle policy on the bucket.
replicationEnabled boolean: Whether or not this bucket is a replication source. By default, replicationEnabled is set to false. This will be set to 'true' when you create a replication policy for the bucket.
retentionRules GetBucketSummariesBucketSummaryRetentionRule[]
storageTier string: The storage tier type assigned to the bucket. A bucket is set to Standard tier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When the Archive tier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. The storageTier property is immutable after bucket is created.
timeCreated string: The date and time the bucket was created, as described in RFC 2616.
versioning string: The versioning status on the bucket. A bucket is created with versioning Disabled by default. For versioning Enabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning is Suspended, the previous versions will still remain but new versions will no longer be created when overwitten or deleted.

access_type str: The type of public access enabled on this bucket. A bucket is set to NoPublicAccess by default, which only allows an authenticated caller to access the bucket and its contents. When ObjectRead is enabled on the bucket, public access is allowed for the GetObject, HeadObject, and ListObjects operations. When ObjectReadWithoutList is enabled on the bucket, public access is allowed for the GetObject and HeadObject operations.
approximate_count str: The approximate number of objects in the bucket. Count statistics are reported periodically. You will see a lag between what is displayed and the actual object count.
approximate_size str: The approximate total size in bytes of all objects in the bucket. Size statistics are reported periodically. You will see a lag between what is displayed and the actual size of the bucket.
auto_tiering str: The auto tiering status on the bucket. A bucket is created with auto tiering Disabled by default. For auto tiering InfrequentAccess, objects are transitioned automatically between the 'Standard' and 'InfrequentAccess' tiers based on the access pattern of the objects.
bucket_id str
compartment_id str: The ID of the compartment in which to list buckets.
created_by str: The OCID of the user who created the bucket.
defined_tags Mapping[str, str]: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
etag str: The entity tag (ETag) for the bucket.
freeform_tags Mapping[str, str]: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id str
is_read_only bool: Whether or not this bucket is read only. By default, isReadOnly is set to false. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
kms_key_id str: The OCID of a master encryption key used to call the Key Management service to generate a data encryption key or to encrypt or decrypt a data encryption key.
metadata Mapping[str, str]: Arbitrary string keys and values for user-defined metadata.
name str: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
namespace str: The Object Storage namespace used for the request.
object_events_enabled bool: Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabled is set to false. Set objectEventsEnabled to true to emit events for object state changes. For more information about events, see Overview of Events.
object_lifecycle_policy_etag str: The entity tag (ETag) for the live object lifecycle policy on the bucket.
replication_enabled bool: Whether or not this bucket is a replication source. By default, replicationEnabled is set to false. This will be set to 'true' when you create a replication policy for the bucket.
retention_rules Sequence[GetBucketSummariesBucketSummaryRetentionRule]
storage_tier str: The storage tier type assigned to the bucket. A bucket is set to Standard tier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When the Archive tier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. The storageTier property is immutable after bucket is created.
time_created str: The date and time the bucket was created, as described in RFC 2616.
versioning str: The versioning status on the bucket. A bucket is created with versioning Disabled by default. For versioning Enabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning is Suspended, the previous versions will still remain but new versions will no longer be created when overwitten or deleted.

accessType String: The type of public access enabled on this bucket. A bucket is set to NoPublicAccess by default, which only allows an authenticated caller to access the bucket and its contents. When ObjectRead is enabled on the bucket, public access is allowed for the GetObject, HeadObject, and ListObjects operations. When ObjectReadWithoutList is enabled on the bucket, public access is allowed for the GetObject and HeadObject operations.
approximateCount String: The approximate number of objects in the bucket. Count statistics are reported periodically. You will see a lag between what is displayed and the actual object count.
approximateSize String: The approximate total size in bytes of all objects in the bucket. Size statistics are reported periodically. You will see a lag between what is displayed and the actual size of the bucket.
autoTiering String: The auto tiering status on the bucket. A bucket is created with auto tiering Disabled by default. For auto tiering InfrequentAccess, objects are transitioned automatically between the 'Standard' and 'InfrequentAccess' tiers based on the access pattern of the objects.
bucketId String
compartmentId String: The ID of the compartment in which to list buckets.
createdBy String: The OCID of the user who created the bucket.
definedTags Map<String>: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
etag String: The entity tag (ETag) for the bucket.
freeformTags Map<String>: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id String
isReadOnly Boolean: Whether or not this bucket is read only. By default, isReadOnly is set to false. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
kmsKeyId String: The OCID of a master encryption key used to call the Key Management service to generate a data encryption key or to encrypt or decrypt a data encryption key.
metadata Map<String>: Arbitrary string keys and values for user-defined metadata.
name String: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
namespace String: The Object Storage namespace used for the request.
objectEventsEnabled Boolean: Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabled is set to false. Set objectEventsEnabled to true to emit events for object state changes. For more information about events, see Overview of Events.
objectLifecyclePolicyEtag String: The entity tag (ETag) for the live object lifecycle policy on the bucket.
replicationEnabled Boolean: Whether or not this bucket is a replication source. By default, replicationEnabled is set to false. This will be set to 'true' when you create a replication policy for the bucket.
retentionRules List<Property Map>
storageTier String: The storage tier type assigned to the bucket. A bucket is set to Standard tier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When the Archive tier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. The storageTier property is immutable after bucket is created.
timeCreated String: The date and time the bucket was created, as described in RFC 2616.
versioning String: The versioning status on the bucket. A bucket is created with versioning Disabled by default. For versioning Enabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning is Suspended, the previous versions will still remain but new versions will no longer be created when overwitten or deleted.

GetBucketSummariesBucketSummaryRetentionRule

DisplayName string
Durations List<GetBucketSummariesBucketSummaryRetentionRuleDuration>
RetentionRuleId string
TimeCreated string: The date and time the bucket was created, as described in RFC 2616.
TimeModified string
TimeRuleLocked string

DisplayName string
Durations []GetBucketSummariesBucketSummaryRetentionRuleDuration
RetentionRuleId string
TimeCreated string: The date and time the bucket was created, as described in RFC 2616.
TimeModified string
TimeRuleLocked string

displayName String
durations List<GetBucketSummariesBucketSummaryRetentionRuleDuration>
retentionRuleId String
timeCreated String: The date and time the bucket was created, as described in RFC 2616.
timeModified String
timeRuleLocked String

displayName string
durations GetBucketSummariesBucketSummaryRetentionRuleDuration[]
retentionRuleId string
timeCreated string: The date and time the bucket was created, as described in RFC 2616.
timeModified string
timeRuleLocked string

display_name str
durations Sequence[GetBucketSummariesBucketSummaryRetentionRuleDuration]
retention_rule_id str
time_created str: The date and time the bucket was created, as described in RFC 2616.
time_modified str
time_rule_locked str

displayName String
durations List<Property Map>
retentionRuleId String
timeCreated String: The date and time the bucket was created, as described in RFC 2616.
timeModified String
timeRuleLocked String

GetBucketSummariesBucketSummaryRetentionRuleDuration

TimeAmount string
TimeUnit string

TimeAmount string
TimeUnit string

timeAmount String
timeUnit String

timeAmount string
timeUnit string

time_amount str
time_unit str

timeAmount String
timeUnit String

GetBucketSummariesFilter

Name string: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
Values List<string>
Regex bool

Name string: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
Values []string
Regex bool

name String: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
values List<String>
regex Boolean

name string: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
values string[]
regex boolean

name str: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
values Sequence[str]
regex bool

name String: The name of the bucket. Avoid entering confidential information. Example: my-new-bucket1
values List<String>
regex Boolean

Package Details

Repository: oci pulumi/pulumi-oci
License: Apache-2.0
Notes: This Pulumi package is based on the oci Terraform Provider.

Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi

pulumi/pulumi-oci

oci.ObjectStorage.getBucketSummaries

On this page

On this page

Example Usage

Using getBucketSummaries

getBucketSummaries Result

Supporting Types

GetBucketSummariesBucketSummary

GetBucketSummariesBucketSummaryRetentionRule

GetBucketSummariesBucketSummaryRetentionRuleDuration

GetBucketSummariesFilter

Package Details

On this page

On this page