oci 2.0.5 → 2.0.6

data/lib/oci/object_storage/models/bucket_summary.rb

@@ -3,36 +3,46 @@
 require 'date'
 
 module OCI
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized,
+  # talk to an administrator. If you're an administrator who needs to write policies to give users access, see
+  # [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+  #
   class ObjectStorage::Models::BucketSummary
-    # The namespace in which the bucket lives.
+    # **[Required]** The namespace in which the bucket lives.
     # @return [String]
     attr_accessor :namespace
 
-    # The name of the bucket. Avoid entering confidential information.
+    # **[Required]** The name of the bucket. Avoid entering confidential information.
     # Example: my-new-bucket1
     # 
     # @return [String]
     attr_accessor :name
 
-    # The compartment ID in which the bucket is authorized.
+    # **[Required]** The compartment ID in which the bucket is authorized.
     # @return [String]
     attr_accessor :compartment_id
 
-    # The OCID of the user who created the bucket.
+    # **[Required]** The OCID of the user who created the bucket.
     # @return [String]
     attr_accessor :created_by
 
-    # The date and time the bucket was created, as described in [RFC 2616](https://tools.ietf.org/rfc/rfc2616), section 14.29.
+    # **[Required]** The date and time the bucket was created, as described in [RFC 2616](https://tools.ietf.org/rfc/rfc2616), section 14.29.
     # @return [DateTime]
     attr_accessor :time_created
 
-    # The entity tag for the bucket.
+    # **[Required]** The entity tag for the bucket.
     # @return [String]
     attr_accessor :etag
 
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :namespace The value to assign to the {#namespace} property
+    # @option attributes [String] :name The value to assign to the {#name} property
+    # @option attributes [String] :compartmentId The value to assign to the {#compartment_id} property
+    # @option attributes [String] :createdBy The value to assign to the {#created_by} property
+    # @option attributes [DateTime] :timeCreated The value to assign to the {#time_created} property
+    # @option attributes [String] :etag The value to assign to the {#etag} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 

data/lib/oci/object_storage/models/commit_multipart_upload_details.rb

@@ -3,8 +3,12 @@
 require 'date'
 
 module OCI
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized,
+  # talk to an administrator. If you're an administrator who needs to write policies to give users access, see
+  # [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+  #
   class ObjectStorage::Models::CommitMultipartUploadDetails
-    # The part numbers and ETags for the parts to be committed.
+    # **[Required]** The part numbers and ETags for the parts to be committed.
     # @return [Array<OCI::ObjectStorage::Models::CommitMultipartUploadPartDetails>]
     attr_accessor :parts_to_commit
 
@@ -17,6 +21,8 @@ module OCI
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [Array<OCI::ObjectStorage::Models::CommitMultipartUploadPartDetails>] :partsToCommit The value to assign to the {#parts_to_commit} property
+    # @option attributes [Array<Integer>] :partsToExclude The value to assign to the {#parts_to_exclude} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 

data/lib/oci/object_storage/models/commit_multipart_upload_part_details.rb

@@ -3,18 +3,24 @@
 require 'date'
 
 module OCI
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized,
+  # talk to an administrator. If you're an administrator who needs to write policies to give users access, see
+  # [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+  #
   class ObjectStorage::Models::CommitMultipartUploadPartDetails
-    # The part number for this part.
+    # **[Required]** The part number for this part.
     # @return [Integer]
     attr_accessor :part_num
 
-    # The ETag returned when this part was uploaded.
+    # **[Required]** The ETag returned when this part was uploaded.
     # @return [String]
     attr_accessor :etag
 
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [Integer] :partNum The value to assign to the {#part_num} property
+    # @option attributes [String] :etag The value to assign to the {#etag} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 

data/lib/oci/object_storage/models/create_bucket_details.rb

@@ -3,23 +3,28 @@
 require 'date'
 
 module OCI
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized,
+  # talk to an administrator. If you're an administrator who needs to write policies to give users access, see
+  # [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+  #
   class ObjectStorage::Models::CreateBucketDetails
 
     PUBLIC_ACCESS_TYPE_ENUM = [PUBLIC_ACCESS_TYPE_NO_PUBLIC_ACCESS = 'NoPublicAccess',
-                PUBLIC_ACCESS_TYPE_OBJECT_READ = 'ObjectRead']
+                PUBLIC_ACCESS_TYPE_OBJECT_READ = 'ObjectRead',
+                PUBLIC_ACCESS_TYPE_OBJECT_READ_WITHOUT_LIST = 'ObjectReadWithoutList']
 
 
     STORAGE_TIER_ENUM = [STORAGE_TIER_STANDARD = 'Standard',
                 STORAGE_TIER_ARCHIVE = 'Archive']
 
-    # The name of the bucket. Valid characters are uppercase or lowercase letters,
+    # **[Required]** The name of the bucket. Valid characters are uppercase or lowercase letters,
     # numbers, and dashes. Bucket names must be unique within the namespace. Avoid entering confidential information.
     # example: Example: my-new-bucket1
     # 
     # @return [String]
     attr_accessor :name
 
-    # The ID of the compartment in which to create the bucket.
+    # **[Required]** The ID of the compartment in which to create the bucket.
     # @return [String]
     attr_accessor :compartment_id
 
@@ -30,7 +35,8 @@ module OCI
     # 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.
+    # `GetObject`, `HeadObject`, and `ListObjects` operations. When `ObjectReadWithoutList` is enabled on the bucket,
+    # public access is allowed for the `GetObject` and `HeadObject` operations.
     # 
     # @return [String]
     attr_accessor :public_access_type
@@ -46,6 +52,11 @@ module OCI
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :name The value to assign to the {#name} property
+    # @option attributes [String] :compartmentId The value to assign to the {#compartment_id} property
+    # @option attributes [Hash<String, String>] :metadata The value to assign to the {#metadata} property
+    # @option attributes [String] :publicAccessType The value to assign to the {#public_access_type} property
+    # @option attributes [String] :storageTier The value to assign to the {#storage_tier} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 

data/lib/oci/object_storage/models/create_multipart_upload_details.rb

@@ -3,8 +3,12 @@
 require 'date'
 
 module OCI
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized,
+  # talk to an administrator. If you're an administrator who needs to write policies to give users access, see
+  # [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+  #
   class ObjectStorage::Models::CreateMultipartUploadDetails
-    # The name of the object to which this multi-part upload is targeted. Avoid entering confidential information.
+    # **[Required]** The name of the object to which this multi-part upload is targeted. Avoid entering confidential information.
     # Example: test/object1.log
     # 
     # @return [String]
@@ -31,6 +35,11 @@ module OCI
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :object The value to assign to the {#object} property
+    # @option attributes [String] :contentType The value to assign to the {#content_type} property
+    # @option attributes [String] :contentLanguage The value to assign to the {#content_language} property
+    # @option attributes [String] :contentEncoding The value to assign to the {#content_encoding} property
+    # @option attributes [Hash<String, String>] :metadata The value to assign to the {#metadata} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 

data/lib/oci/object_storage/models/create_preauthenticated_request_details.rb

@@ -10,7 +10,7 @@ module OCI
                 ACCESS_TYPE_OBJECT_READ_WRITE = 'ObjectReadWrite',
                 ACCESS_TYPE_ANY_OBJECT_WRITE = 'AnyObjectWrite']
 
-    # A user-specified name for the pre-authenticated request. Helpful for management purposes.
+    # **[Required]** A user-specified name for the pre-authenticated request. Helpful for management purposes.
     # @return [String]
     attr_accessor :name
 
@@ -18,11 +18,11 @@ module OCI
     # @return [String]
     attr_accessor :object_name
 
-    # The operation that can be performed on this resource.
+    # **[Required]** The operation that can be performed on this resource.
     # @return [String]
     attr_accessor :access_type
 
-    # The expiration date for the pre-authenticated request as per [RFC 3339](https://tools.ietf.org/rfc/rfc3339). After this date the pre-authenticated request will no longer be valid.
+    # **[Required]** The expiration date for the pre-authenticated request as per [RFC 3339](https://tools.ietf.org/rfc/rfc3339). After this date the pre-authenticated request will no longer be valid.
     # 
     # @return [DateTime]
     attr_accessor :time_expires
@@ -30,6 +30,10 @@ module OCI
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :name The value to assign to the {#name} property
+    # @option attributes [String] :objectName The value to assign to the {#object_name} property
+    # @option attributes [String] :accessType The value to assign to the {#access_type} property
+    # @option attributes [DateTime] :timeExpires The value to assign to the {#time_expires} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 

data/lib/oci/object_storage/models/list_objects.rb

@@ -3,8 +3,12 @@
 require 'date'
 
 module OCI
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized,
+  # talk to an administrator. If you're an administrator who needs to write policies to give users access, see
+  # [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+  #
   class ObjectStorage::Models::ListObjects
-    # An array of object summaries.
+    # **[Required]** An array of object summaries.
     # 
     # @return [Array<OCI::ObjectStorage::Models::ObjectSummary>]
     attr_accessor :objects
@@ -24,6 +28,9 @@ module OCI
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [Array<OCI::ObjectStorage::Models::ObjectSummary>] :objects The value to assign to the {#objects} property
+    # @option attributes [Array<String>] :prefixes The value to assign to the {#prefixes} property
+    # @option attributes [String] :nextStartWith The value to assign to the {#next_start_with} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 

data/lib/oci/object_storage/models/multipart_upload.rb

@@ -3,30 +3,45 @@
 require 'date'
 
 module OCI
+  # Multipart uploads provide efficient and resilient uploads, especially for large objects. Multipart uploads also accommodate
+  # objects that are too large for a single upload operation. With multipart uploads, individual parts of an object can be
+  # uploaded in parallel to reduce the amount of time you spend uploading. Multipart uploads can also minimize the impact
+  # of network failures by letting you retry a failed part upload instead of requiring you to retry an entire object upload.
+  # See [Managing Multipart Uploads](https://docs.us-phoenix-1.oraclecloud.com/Content/Object/Tasks/managingmultipartuploads.htm).
+  #
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized,
+  # talk to an administrator. If you're an administrator who needs to write policies to give users access, see
+  # [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+  #
   class ObjectStorage::Models::MultipartUpload
-    # The namespace in which the in-progress multipart upload is stored.
+    # **[Required]** The namespace in which the in-progress multipart upload is stored.
     # @return [String]
     attr_accessor :namespace
 
-    # The bucket in which the in-progress multipart upload is stored.
+    # **[Required]** The bucket in which the in-progress multipart upload is stored.
     # @return [String]
     attr_accessor :bucket
 
-    # The object name of the in-progress multipart upload.
+    # **[Required]** The object name of the in-progress multipart upload.
     # @return [String]
     attr_accessor :object
 
-    # The unique identifier for the in-progress multipart upload.
+    # **[Required]** The unique identifier for the in-progress multipart upload.
     # @return [String]
     attr_accessor :upload_id
 
-    # The date and time the upload was created, as described in [RFC 2616](https://tools.ietf.org/rfc/rfc2616), section 14.29.
+    # **[Required]** The date and time the upload was created, as described in [RFC 2616](https://tools.ietf.org/rfc/rfc2616), section 14.29.
     # @return [DateTime]
     attr_accessor :time_created
 
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :namespace The value to assign to the {#namespace} property
+    # @option attributes [String] :bucket The value to assign to the {#bucket} property
+    # @option attributes [String] :object The value to assign to the {#object} property
+    # @option attributes [String] :uploadId The value to assign to the {#upload_id} property
+    # @option attributes [DateTime] :timeCreated The value to assign to the {#time_created} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 

data/lib/oci/object_storage/models/multipart_upload_part_summary.rb

@@ -3,26 +3,35 @@
 require 'date'
 
 module OCI
+  # Get summary information about multipart uploads.
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized,
+  # talk to an administrator. If you're an administrator who needs to write policies to give users access,
+  # see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+  #
   class ObjectStorage::Models::MultipartUploadPartSummary
-    # The current entity tag for the part.
+    # **[Required]** The current entity tag for the part.
     # @return [String]
     attr_accessor :etag
 
-    # The MD5 hash of the bytes of the part.
+    # **[Required]** The MD5 hash of the bytes of the part.
     # @return [String]
     attr_accessor :md5
 
-    # The size of the part in bytes.
+    # **[Required]** The size of the part in bytes.
     # @return [Integer]
     attr_accessor :size
 
-    # The part number for this part.
+    # **[Required]** The part number for this part.
     # @return [Integer]
     attr_accessor :part_number
 
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :etag The value to assign to the {#etag} property
+    # @option attributes [String] :md5 The value to assign to the {#md5} property
+    # @option attributes [Integer] :size The value to assign to the {#size} property
+    # @option attributes [Integer] :partNumber The value to assign to the {#part_number} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 

data/lib/oci/object_storage/models/namespace_metadata.rb

@@ -3,22 +3,27 @@
 require 'date'
 
 module OCI
+  # A NamespaceMetadta is a map for storing namespace and defaultS3CompartmentId, defaultSwiftCompartmentId.
+  #
   class ObjectStorage::Models::NamespaceMetadata
-    # The namespace to which the metadata belongs.
+    # **[Required]** The namespace to which the metadata belongs.
     # @return [String]
     attr_accessor :namespace
 
-    # The default compartment ID for an S3 client.
+    # **[Required]** The default compartment ID for an S3 client.
     # @return [String]
     attr_accessor :default_s3_compartment_id
 
-    # The default compartment ID for a Swift client.
+    # **[Required]** The default compartment ID for a Swift client.
     # @return [String]
     attr_accessor :default_swift_compartment_id
 
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :namespace The value to assign to the {#namespace} property
+    # @option attributes [String] :defaultS3CompartmentId The value to assign to the {#default_s3_compartment_id} property
+    # @option attributes [String] :defaultSwiftCompartmentId The value to assign to the {#default_swift_compartment_id} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 

data/lib/oci/object_storage/models/object_summary.rb

@@ -3,8 +3,12 @@
 require 'date'
 
 module OCI
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized,
+  # talk to an administrator. If you're an administrator who needs to write policies to give users access, see
+  # [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+  #
   class ObjectStorage::Models::ObjectSummary
-    # The name of the object. Avoid entering confidential information.
+    # **[Required]** The name of the object. Avoid entering confidential information.
     # Example: test/object1.log
     # 
     # @return [String]
@@ -25,6 +29,10 @@ module OCI
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :name The value to assign to the {#name} property
+    # @option attributes [Integer] :size The value to assign to the {#size} property
+    # @option attributes [String] :md5 The value to assign to the {#md5} property
+    # @option attributes [DateTime] :timeCreated The value to assign to the {#time_created} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 

data/lib/oci/object_storage/models/preauthenticated_request.rb

@@ -3,6 +3,13 @@
 require 'date'
 
 module OCI
+  # Pre-authenticated requests provide a way to let users access a bucket or an object without having their own credentials.
+  # When you create a pre-authenticated request, a unique URL is generated. Users in your organization, partners, or third
+  # parties can use this URL to access the targets identified in the pre-authenticated request. See [Managing Access to Buckets and Objects](https://docs.us-phoenix-1.oraclecloud.com/Content/Object/Tasks/managingaccess.htm).
+  #
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator.
+  # If you're an administrator who needs to write policies to give users access, see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+  #
   class ObjectStorage::Models::PreauthenticatedRequest
 
     ACCESS_TYPE_ENUM = [ACCESS_TYPE_OBJECT_READ = 'ObjectRead',
@@ -11,15 +18,15 @@ module OCI
                 ACCESS_TYPE_ANY_OBJECT_WRITE = 'AnyObjectWrite',
                 ACCESS_TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE']
 
-    # The unique identifier to use when directly addressing the pre-authenticated request.
+    # **[Required]** The unique identifier to use when directly addressing the pre-authenticated request.
     # @return [String]
     attr_accessor :id
 
-    # The user-provided name of the pre-authenticated request.
+    # **[Required]** The user-provided name of the pre-authenticated request.
     # @return [String]
     attr_accessor :name
 
-    # The URI to embed in the URL when using the pre-authenticated request.
+    # **[Required]** The URI to embed in the URL when using the pre-authenticated request.
     # @return [String]
     attr_accessor :access_uri
 
@@ -30,16 +37,16 @@ module OCI
     # @return [String]
     attr_accessor :object_name
 
-    # The operation that can be performed on this resource.
+    # **[Required]** The operation that can be performed on this resource.
     # @return [String]
     attr_accessor :access_type
 
-    # The expiration date for the pre-authenticated request as per [RFC 3339](https://tools.ietf.org/rfc/rfc3339). After this date the pre-authenticated request will no longer be valid.
+    # **[Required]** The expiration date for the pre-authenticated request as per [RFC 3339](https://tools.ietf.org/rfc/rfc3339). After this date the pre-authenticated request will no longer be valid.
     # 
     # @return [DateTime]
     attr_accessor :time_expires
 
-    # The date when the pre-authenticated request was created as per specification
+    # **[Required]** The date when the pre-authenticated request was created as per specification
     # [RFC 3339](https://tools.ietf.org/rfc/rfc3339).
     # 
     # @return [DateTime]
@@ -48,6 +55,13 @@ module OCI
 
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :id The value to assign to the {#id} property
+    # @option attributes [String] :name The value to assign to the {#name} property
+    # @option attributes [String] :accessUri The value to assign to the {#access_uri} property
+    # @option attributes [String] :objectName The value to assign to the {#object_name} property
+    # @option attributes [String] :accessType The value to assign to the {#access_type} property
+    # @option attributes [DateTime] :timeExpires The value to assign to the {#time_expires} property
+    # @option attributes [DateTime] :timeCreated The value to assign to the {#time_created} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)