oci.ObjectStorage.getBucketSummaries
This data source provides the list of Buckets in Oracle Cloud Infrastructure Object Storage service.
Gets a list of all BucketSummary items in a compartment. A BucketSummary contains only summary fields for the bucket and does not contain fields like the user-defined metadata.
ListBuckets returns a BucketSummary containing at most 1000 buckets. To paginate through more buckets, 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
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/v3/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 dictionaryThe 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<GetBucket Summaries Filter> 
- CompartmentId string
- The ID of the compartment in which to list buckets.
- Namespace string
- The Object Storage namespace used for the request.
- Filters
[]GetBucket Summaries Filter 
- compartmentId String
- The ID of the compartment in which to list buckets.
- namespace String
- The Object Storage namespace used for the request.
- filters
List<GetBucket Summaries Filter> 
- compartmentId string
- The ID of the compartment in which to list buckets.
- namespace string
- The Object Storage namespace used for the request.
- filters
GetBucket Summaries Filter[] 
- 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[GetBucket Summaries Filter] 
- 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<GetBucket Summaries Bucket Summary> 
- 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<GetBucket Summaries Filter> 
- BucketSummaries []GetBucket Summaries Bucket Summary 
- 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
[]GetBucket Summaries Filter 
- bucketSummaries List<GetBucket Summaries Bucket Summary> 
- 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<GetBucket Summaries Filter> 
- bucketSummaries GetBucket Summaries Bucket Summary[] 
- 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
GetBucket Summaries Filter[] 
- bucket_summaries Sequence[GetBucket Summaries Bucket Summary] 
- 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[GetBucket Summaries Filter] 
- 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 NoPublicAccessby default, which only allows an authenticated caller to access the bucket and its contents. WhenObjectReadis enabled on the bucket, public access is allowed for theGetObject,HeadObject, andListObjectsoperations. WhenObjectReadWithoutListis enabled on the bucket, public access is allowed for theGetObjectandHeadObjectoperations.
- 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 Disabledby default. For auto tieringInfrequentAccess, 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.
- 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.
- 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
- IsRead boolOnly 
- Whether or not this bucket is read only. By default, isReadOnlyis set tofalse. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
- KmsKey stringId 
- 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.
- ObjectEvents boolEnabled 
- Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabledis set tofalse. SetobjectEventsEnabledtotrueto emit events for object state changes. For more information about events, see Overview of Events.
- ObjectLifecycle stringPolicy Etag 
- 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, replicationEnabledis set tofalse. This will be set to 'true' when you create a replication policy for the bucket.
- RetentionRules List<GetBucket Summaries Bucket Summary Retention Rule> 
- StorageTier string
- The storage tier type assigned to the bucket. A bucket is set to Standardtier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When theArchivetier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. ThestorageTierproperty 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 Disabledby default. For versioningEnabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning isSuspended, 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 NoPublicAccessby default, which only allows an authenticated caller to access the bucket and its contents. WhenObjectReadis enabled on the bucket, public access is allowed for theGetObject,HeadObject, andListObjectsoperations. WhenObjectReadWithoutListis enabled on the bucket, public access is allowed for theGetObjectandHeadObjectoperations.
- 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 Disabledby default. For auto tieringInfrequentAccess, 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.
- 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.
- 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
- IsRead boolOnly 
- Whether or not this bucket is read only. By default, isReadOnlyis set tofalse. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
- KmsKey stringId 
- 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.
- ObjectEvents boolEnabled 
- Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabledis set tofalse. SetobjectEventsEnabledtotrueto emit events for object state changes. For more information about events, see Overview of Events.
- ObjectLifecycle stringPolicy Etag 
- 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, replicationEnabledis set tofalse. This will be set to 'true' when you create a replication policy for the bucket.
- RetentionRules []GetBucket Summaries Bucket Summary Retention Rule 
- StorageTier string
- The storage tier type assigned to the bucket. A bucket is set to Standardtier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When theArchivetier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. ThestorageTierproperty 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 Disabledby default. For versioningEnabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning isSuspended, 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 NoPublicAccessby default, which only allows an authenticated caller to access the bucket and its contents. WhenObjectReadis enabled on the bucket, public access is allowed for theGetObject,HeadObject, andListObjectsoperations. WhenObjectReadWithoutListis enabled on the bucket, public access is allowed for theGetObjectandHeadObjectoperations.
- 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 Disabledby default. For auto tieringInfrequentAccess, 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.
- 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.
- 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
- isRead BooleanOnly 
- Whether or not this bucket is read only. By default, isReadOnlyis set tofalse. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
- kmsKey StringId 
- 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.
- objectEvents BooleanEnabled 
- Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabledis set tofalse. SetobjectEventsEnabledtotrueto emit events for object state changes. For more information about events, see Overview of Events.
- objectLifecycle StringPolicy Etag 
- 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, replicationEnabledis set tofalse. This will be set to 'true' when you create a replication policy for the bucket.
- retentionRules List<GetBucket Summaries Bucket Summary Retention Rule> 
- storageTier String
- The storage tier type assigned to the bucket. A bucket is set to Standardtier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When theArchivetier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. ThestorageTierproperty 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 Disabledby default. For versioningEnabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning isSuspended, 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 NoPublicAccessby default, which only allows an authenticated caller to access the bucket and its contents. WhenObjectReadis enabled on the bucket, public access is allowed for theGetObject,HeadObject, andListObjectsoperations. WhenObjectReadWithoutListis enabled on the bucket, public access is allowed for theGetObjectandHeadObjectoperations.
- 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 Disabledby default. For auto tieringInfrequentAccess, 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.
- {[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.
- {[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
- isRead booleanOnly 
- Whether or not this bucket is read only. By default, isReadOnlyis set tofalse. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
- kmsKey stringId 
- 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.
- objectEvents booleanEnabled 
- Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabledis set tofalse. SetobjectEventsEnabledtotrueto emit events for object state changes. For more information about events, see Overview of Events.
- objectLifecycle stringPolicy Etag 
- 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, replicationEnabledis set tofalse. This will be set to 'true' when you create a replication policy for the bucket.
- retentionRules GetBucket Summaries Bucket Summary Retention Rule[] 
- storageTier string
- The storage tier type assigned to the bucket. A bucket is set to Standardtier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When theArchivetier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. ThestorageTierproperty 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 Disabledby default. For versioningEnabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning isSuspended, 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 NoPublicAccessby default, which only allows an authenticated caller to access the bucket and its contents. WhenObjectReadis enabled on the bucket, public access is allowed for theGetObject,HeadObject, andListObjectsoperations. WhenObjectReadWithoutListis enabled on the bucket, public access is allowed for theGetObjectandHeadObjectoperations.
- 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 Disabledby default. For auto tieringInfrequentAccess, 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.
- 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.
- 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_ boolonly 
- Whether or not this bucket is read only. By default, isReadOnlyis set tofalse. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
- kms_key_ strid 
- 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_ boolenabled 
- Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabledis set tofalse. SetobjectEventsEnabledtotrueto emit events for object state changes. For more information about events, see Overview of Events.
- object_lifecycle_ strpolicy_ etag 
- 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, replicationEnabledis set tofalse. This will be set to 'true' when you create a replication policy for the bucket.
- retention_rules Sequence[GetBucket Summaries Bucket Summary Retention Rule] 
- storage_tier str
- The storage tier type assigned to the bucket. A bucket is set to Standardtier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When theArchivetier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. ThestorageTierproperty 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 Disabledby default. For versioningEnabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning isSuspended, 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 NoPublicAccessby default, which only allows an authenticated caller to access the bucket and its contents. WhenObjectReadis enabled on the bucket, public access is allowed for theGetObject,HeadObject, andListObjectsoperations. WhenObjectReadWithoutListis enabled on the bucket, public access is allowed for theGetObjectandHeadObjectoperations.
- 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 Disabledby default. For auto tieringInfrequentAccess, 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.
- 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.
- 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
- isRead BooleanOnly 
- Whether or not this bucket is read only. By default, isReadOnlyis set tofalse. This will be set to 'true' when this bucket is configured as a destination in a replication policy.
- kmsKey StringId 
- 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.
- objectEvents BooleanEnabled 
- Whether or not events are emitted for object state changes in this bucket. By default, objectEventsEnabledis set tofalse. SetobjectEventsEnabledtotrueto emit events for object state changes. For more information about events, see Overview of Events.
- objectLifecycle StringPolicy Etag 
- 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, replicationEnabledis set tofalse. 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 Standardtier by default, which means objects uploaded or copied to the bucket will be in the standard storage tier. When theArchivetier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. ThestorageTierproperty 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 Disabledby default. For versioningEnabled, objects are protected from overwrites and deletes, by maintaining their version history. When versioning isSuspended, the previous versions will still remain but new versions will no longer be created when overwitten or deleted.
GetBucketSummariesBucketSummaryRetentionRule      
- DisplayName string
- Durations
List<GetBucket Summaries Bucket Summary Retention Rule Duration> 
- RetentionRule stringId 
- TimeCreated string
- The date and time the bucket was created, as described in RFC 2616.
- TimeModified string
- TimeRule stringLocked 
- DisplayName string
- Durations
[]GetBucket Summaries Bucket Summary Retention Rule Duration 
- RetentionRule stringId 
- TimeCreated string
- The date and time the bucket was created, as described in RFC 2616.
- TimeModified string
- TimeRule stringLocked 
- displayName String
- durations
List<GetBucket Summaries Bucket Summary Retention Rule Duration> 
- retentionRule StringId 
- timeCreated String
- The date and time the bucket was created, as described in RFC 2616.
- timeModified String
- timeRule StringLocked 
- displayName string
- durations
GetBucket Summaries Bucket Summary Retention Rule Duration[] 
- retentionRule stringId 
- timeCreated string
- The date and time the bucket was created, as described in RFC 2616.
- timeModified string
- timeRule stringLocked 
- display_name str
- durations
Sequence[GetBucket Summaries Bucket Summary Retention Rule Duration] 
- retention_rule_ strid 
- time_created str
- The date and time the bucket was created, as described in RFC 2616.
- time_modified str
- time_rule_ strlocked 
- displayName String
- durations List<Property Map>
- retentionRule StringId 
- timeCreated String
- The date and time the bucket was created, as described in RFC 2616.
- timeModified String
- timeRule StringLocked 
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   
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the ociTerraform Provider.
