ruạṛ
a O��f� � @ s� d dl mZ d dlmZ d dlmZ d dlmZmZ d dlm Z d dl m Z m Z d dl mZ d dlmZmZmZ d d lmZmZ d d lmZ ed �ZG d d� de�ZdS )� )�absolute_import)�requests)�six)�retry�circuit_breaker)� BaseClient)�get_config_value_or_default�validate_config)�Signer)�Sentinel�#get_signer_from_authentication_type� AUTHENTICATION_TYPE_FIELD_NAME)�,back_up_body_calculate_stream_content_length�(is_content_length_calculable_by_req_util� )�object_storage_type_mapping�Missingc @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd2d3� Z d4d5� Z d6d7� Z d8d9� Z d:d;� Z d<d=� Z!d>d?� Z"d@dA� Z#dBdC� Z$dDdE� Z%dFdG� Z&dHdI� Z'dJdK� Z(dLdM� Z)dNdO� Z*dPdQ� Z+dRdS� Z,dTdU� Z-dVdW� Z.dXdY� Z/dZd[� Z0d\d]� Z1d^d_� Z2d`da� Z3dbdc� Z4ddde� Z5dfdg� Z6dhS )i�ObjectStorageClientaA Common set of Object Storage and Archive Storage APIs for managing buckets, objects, and related resources. For more information, see [Overview of Object Storage](/Content/Object/Concepts/objectstorageoverview.htm) and [Overview of Archive Storage](/Content/Archive/Concepts/archivestorageoverview.htm). c K s t ||�d�d� d|v r$|d }nDt|v r6t|�}n2t|d |d |d |�d�t|d�|�d�d �}d |�d �d d |�dd�|�dtj�d�}d|v r�|�d�|d< |�d�du r�tj|d< d|v r�|�d�|d< t d||t fi |��| _ |�d�| _ |�d�| _ dS )a� Creates a new service client :param dict config: Configuration keys and values as per `SDK and Tool Configuration <https://docs.cloud.oracle.com/Content/API/Concepts/sdkconfig.htm>`__. The :py:meth:`~oci.config.from_file` method can be used to load configuration from a file. Alternatively, a ``dict`` can be passed. You can validate_config the dict using :py:meth:`~oci.config.validate_config` :param str service_endpoint: (optional) The endpoint of the service to call using this client. For example ``https://iaas.us-ashburn-1.oraclecloud.com``. If this keyword argument is not provided then it will be derived using the region in the config parameter. You should only provide this keyword argument if you have an explicit need to specify a service endpoint. :param timeout: (optional) The connection and read timeouts for the client. The default values are connection timeout 10 seconds and read timeout 60 seconds. This keyword argument can be provided as a single float, in which case the value provided is used for both the read and connection timeouts, or as a tuple of two floats. If a tuple is provided then the first value is used as the connection timeout and the second value as the read timeout. :type timeout: float or tuple(float, float) :param signer: (optional) The signer to use when signing requests made by the service client. The default is to use a :py:class:`~oci.signer.Signer` based on the values provided in the config parameter. One use case for this parameter is for `Instance Principals authentication <https://docs.cloud.oracle.com/Content/Identity/Tasks/callingservicesfrominstances.htm>`__ by passing an instance of :py:class:`~oci.auth.signers.InstancePrincipalsSecurityTokenSigner` as the value for this keyword argument :type signer: :py:class:`~oci.signer.AbstractBaseSigner` :param obj retry_strategy: (optional) A retry strategy to apply to all calls made by this service client (i.e. at the client level). There is no retry strategy applied by default. Retry strategies can also be applied at the operation level by passing a ``retry_strategy`` keyword argument as part of calling the operation. Any value provided at the operation level will override whatever is specified at the client level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` is also available. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. :param obj circuit_breaker_strategy: (optional) A circuit breaker strategy to apply to all calls made by this service client (i.e. at the client level). This client uses :py:data:`~oci.circuit_breaker.DEFAULT_CIRCUIT_BREAKER_STRATEGY` as default if no circuit breaker strategy is provided. The specifics of circuit breaker strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/circuit_breakers.html>`__. :param function circuit_breaker_callback: (optional) Callback function to receive any exceptions triggerred by the circuit breaker. :param allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this client should allow control characters in the response object. By default, the client will not allow control characters to be in the response object. �signer)r �tenancy�user� fingerprint�key_file� pass_phrase� key_content)r r r �private_key_file_locationr �private_key_contentT�service_endpoint�/z2https://objectstorage.{region}.{secondLevelDomain}�skip_deserializationF�circuit_breaker_strategy)�regional_clientr � base_path�service_endpoint_templater r �timeoutN�allow_control_chars�object_storage�retry_strategy�circuit_breaker_callback)r �getr r r r r � GLOBAL_CIRCUIT_BREAKER_STRATEGY� DEFAULT_CIRCUIT_BREAKER_STRATEGYr r � base_clientr' r( )�self�config�kwargsr �base_client_init_kwargs� r1 ��/sparta/input/_build_configuration/image_build+validate/lib/bmcenv/lib64/python3.9/site-packages/oci/object_storage/object_storage_client.py�__init__ s: 0 � � z ObjectStorageClient.__init__c s� d}d}d}d} g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qld|i}dd � t �|�D �}dd|� dt �d�}dd � t �|�D �}| j j |� d�| j d�}|d u �rtj}|�rft|tj��s@| j �|� |�| j� |j| j j||| |||� d�|| d� S | j j||| |||� d�|| d�S d S )a� Aborts an in-progress multipart upload and deletes all parts that have been uploaded. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str object_name: (required) The name of the object. Avoid entering confidential information. Example: `test/object1.log` :param str upload_id: (required) The upload ID for a multipart upload. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/abort_multipart_upload.py.html>`__ to see an example of how to use abort_multipart_upload API. �0/n/{namespaceName}/b/{bucketName}/u/{objectName}�DELETE�abort_multipart_uploadzahttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/MultipartUpload/AbortMultipartUpload�r% r' �opc_client_request_idc s g | ]}|� vr|�qS r1 r1 ��.0�_key��expected_kwargsr1 r2 � <listcomp>� � z>ObjectStorageClient.abort_multipart_upload.<locals>.<listcomp>z/abort_multipart_upload got unknown kwargs: {!r}�� namespaceName� bucketName� objectNamec S s i | ]\}}|t ur||�qS r1 ��missing�r: �k�vr1 r1 r2 � <dictcomp>� r? z>ObjectStorageClient.abort_multipart_upload.<locals>.<dictcomp>Nr �7Parameter {} cannot be None, whitespace or empty string�uploadIdc S s& i | ] \}}|t ur|d ur||�qS �NrD rF r1 r1 r2 rI � r? �application/jsonr8 ��accept� content-type�opc-client-request-idc S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' ��operation_retry_strategy�client_retry_strategyr% �� resource_path�method� path_params� query_params� header_paramsr% �operation_name�api_reference_link�r �iterkeys� ValueError�format� iteritems� isinstance� string_types�len�stripr) rE r, � get_preferred_retry_strategyr' r �DEFAULT_RETRY_STRATEGY�NoneRetryStrategy� add_opc_client_retries_header� add_circuit_breaker_callbackr( �make_retrying_call�call_api�r- �namespace_name� bucket_name� object_name� upload_idr/ rV rW r[ r\ � extra_kwargsrX rG rH rY rZ r' r1 r< r2 r6 n sr (��$� �� � �z*ObjectStorageClient.abort_multipart_uploadc sf d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���d |i}d d � t �|�D �}t �|�D ]:\} } | d u s�t| t j�rht| �� �d krhtd�| ���qhdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u r�tj} | �rBt| tj��s | j �| � | �| j� | j| j j|||| |� d�||d�S | j j|||| |� d�||d�S d S )a Cancels a work request. :param str work_request_id: (required) The ID of the asynchronous request. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/cancel_work_request.py.html>`__ to see an example of how to use cancel_work_request API. � /workRequests/{workRequestId}r5 �cancel_work_requestzZhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/WorkRequest/CancelWorkRequestr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> r? z;ObjectStorageClient.cancel_work_request.<locals>.<listcomp>z,cancel_work_request got unknown kwargs: {!r}� workRequestIdc S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI r? z;ObjectStorageClient.cancel_work_request.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? r' rR r% �rV rW rX rZ r% r[ r\ r] � r- �work_request_idr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 rt � sd ��$ �� � �z'ObjectStorageClient.cancel_work_requestc s� d}d}d} d} g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} }|d u s�t|t j�rlt|�� �d krltd�| ���qld|i}dd � t �|�D �}dd|� dt �|� dt �|� dt �d�}dd � t �|�D �}| j j |� d�| j d�}|d u �r(tj}|�r|t|tj��sT| j �|� |�| j� |j| j j||| ||||� d�| | d� S | j j||| ||||� d�| | d� S d S )a Commits a multipart upload, which involves checking part numbers and entity tags (ETags) of the parts, to create an aggregate object. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str object_name: (required) The name of the object. Avoid entering confidential information. Example: `test/object1.log` :param str upload_id: (required) The upload ID for a multipart upload. :param oci.object_storage.models.CommitMultipartUploadDetails commit_multipart_upload_details: (required) The part numbers and entity tags (ETags) for the parts you want to commit. :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str if_none_match: (optional) The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the resource already exists. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/commit_multipart_upload.py.html>`__ to see an example of how to use commit_multipart_upload API. r4 �POST�commit_multipart_uploadzbhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/MultipartUpload/CommitMultipartUpload�r% r' �if_match� if_none_matchr8 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> { r? z?ObjectStorageClient.commit_multipart_upload.<locals>.<listcomp>z0commit_multipart_upload got unknown kwargs: {!r}r@ c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z?ObjectStorageClient.commit_multipart_upload.<locals>.<dictcomp>Nr rJ rK c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? rM r| r} r8 �rO rP �if-match� if-none-matchrQ c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r% � rV rW rX rY rZ �bodyr% r[ r\ r] )r- rn ro rp rq � commit_multipart_upload_detailsr/ rV rW r[ r\ rr rX rG rH rY rZ r' r1 r< r2 rz : sz 4��$� �� � �z+ObjectStorageClient.commit_multipart_uploadc s� d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �d� } dd � t �| �D �} | j j |� d�| j d�}|d u �r<tj}|�r�t|tj��sh| j �| � |�| j� |j| j j||| | ||� d �||d � S | j j||| | ||� d �||d �S d S ) a� Creates a request to copy an object within a region or to another region. See `Object Names`__ for object naming requirements. __ https://docs.cloud.oracle.com/Content/Object/Tasks/managingobjects.htm#namerequirements :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param oci.object_storage.models.CopyObjectDetails copy_object_details: (required) The source and destination of the object to be copied. :param str opc_client_request_id: (optional) The client request ID for tracing. :param str opc_sse_customer_algorithm: (optional) The optional header that specifies "AES256" as the encryption algorithm. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key: (optional) The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or decrypt the data. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key_sha256: (optional) The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This value is used to check the integrity of the encryption key. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_source_sse_customer_algorithm: (optional) The optional header that specifies "AES256" as the encryption algorithm to use to decrypt the source object. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_source_sse_customer_key: (optional) The optional header that specifies the base64-encoded 256-bit encryption key to use to decrypt the source object. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_source_sse_customer_key_sha256: (optional) The optional header that specifies the base64-encoded SHA256 hash of the encryption key used to decrypt the source object. This value is used to check the integrity of the encryption key. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_kms_key_id: (optional) 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. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/copy_object.py.html>`__ to see an example of how to use copy_object API. z4/n/{namespaceName}/b/{bucketName}/actions/copyObjectry � copy_objectzNhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Object/CopyObject) r% r' r8 �opc_sse_customer_algorithm�opc_sse_customer_key�opc_sse_customer_key_sha256�!opc_source_sse_customer_algorithm�opc_source_sse_customer_key�"opc_source_sse_customer_key_sha256�opc_sse_kms_key_idc s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> ' r? z3ObjectStorageClient.copy_object.<locals>.<listcomp>z$copy_object got unknown kwargs: {!r}�rA rB c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI 1 r? z3ObjectStorageClient.copy_object.<locals>.<dictcomp>Nr rJ rM r8 r� r� r� r� r� r� r� ) rO rP rQ �opc-sse-customer-algorithm�opc-sse-customer-key�opc-sse-customer-key-sha256z!opc-source-sse-customer-algorithmzopc-source-sse-customer-keyz"opc-source-sse-customer-key-sha256�opc-sse-kms-key-idc S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI C r? r' rR r% �rV rW rX rZ r� r% r[ r\ r] )r- rn ro �copy_object_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r� � sx Y ��$ � � � �z ObjectStorageClient.copy_objectc sn d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���d |i} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rht| �� �d krhtd�| ���qhdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u r�tj} | �rFt| tj��s | j �| � | �| j� | j| j j||| | |d|� d�||d� S | j j||| | |d|� d�||d� S d S )aM Creates a bucket in the given namespace with a bucket name and optional user-defined metadata. Avoid entering confidential information in bucket names. :param str namespace_name: (required) The Object Storage namespace used for the request. :param oci.object_storage.models.CreateBucketDetails create_bucket_details: (required) Request object for creating a bucket. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.Bucket` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/create_bucket.py.html>`__ to see an example of how to use create_bucket API. �/n/{namespaceName}/bry � create_bucketzPhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Bucket/CreateBucketr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z5ObjectStorageClient.create_bucket.<locals>.<listcomp>z&create_bucket got unknown kwargs: {!r}rA c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z5ObjectStorageClient.create_bucket.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR �Bucketr% � rV rW rX rZ r� � response_typer% r[ r\ r] )r- rn �create_bucket_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r� e sl !��$ �� � �z!ObjectStorageClient.create_bucketc s� d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �d� } dd � t �| �D �} | j j |� d�| j d�}|d u �r2tj}|�r�t|tj��s^| j �| � |�| j� |j| j j||| | |d|� d �||d � S | j j||| | |d|� d �||d � S d S ) aM Starts a new multipart upload to a specific object in the given bucket in the given namespace. See `Object Names`__ for object naming requirements. __ https://docs.cloud.oracle.com/Content/Object/Tasks/managingobjects.htm#namerequirements :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param oci.object_storage.models.CreateMultipartUploadDetails create_multipart_upload_details: (required) Request object for creating a multipart upload. :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str if_none_match: (optional) The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the resource already exists. :param str opc_client_request_id: (optional) The client request ID for tracing. :param str opc_sse_customer_algorithm: (optional) The optional header that specifies "AES256" as the encryption algorithm. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key: (optional) The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or decrypt the data. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key_sha256: (optional) The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This value is used to check the integrity of the encryption key. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_kms_key_id: (optional) 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. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.MultipartUpload` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/create_multipart_upload.py.html>`__ to see an example of how to use create_multipart_upload API. �#/n/{namespaceName}/b/{bucketName}/ury �create_multipart_uploadzbhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/MultipartUpload/CreateMultipartUpload) r% r' r| r} r8 r� r� r� r� c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> & r? z?ObjectStorageClient.create_multipart_upload.<locals>.<listcomp>z0create_multipart_upload got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI 0 r? z?ObjectStorageClient.create_multipart_upload.<locals>.<dictcomp>Nr rJ rM r| r} r8 r� r� r� r� ) rO rP r r� rQ r� r� r� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI A r? r' rR �MultipartUploadr% r� r] )r- rn ro � create_multipart_upload_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r� � sz L ��$ � � � �z+ObjectStorageClient.create_multipart_uploadc sp d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rHt|tj��s | j �| � |�| j� |j| j j||| | |d|� d�||d� S | j j||| | |d|� d�||d� S d S )a� Creates a pre-authenticated request specific to the bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param oci.object_storage.models.CreatePreauthenticatedRequestDetails create_preauthenticated_request_details: (required) Information needed to create the pre-authenticated request. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.PreauthenticatedRequest` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/create_preauthenticated_request.py.html>`__ to see an example of how to use create_preauthenticated_request API. �#/n/{namespaceName}/b/{bucketName}/pry � create_preauthenticated_requestzrhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/PreauthenticatedRequest/CreatePreauthenticatedRequestr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? zGObjectStorageClient.create_preauthenticated_request.<locals>.<listcomp>z8create_preauthenticated_request got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? zGObjectStorageClient.create_preauthenticated_request.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR �PreauthenticatedRequestr% r� r] )r- rn ro �'create_preauthenticated_request_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r� e sn $��$ �� � �z3ObjectStorageClient.create_preauthenticated_requestc sp d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rHt|tj��s | j �| � |�| j� |j| j j||| | |d|� d�||d� S | j j||| | |d|� d�||d� S d S )a� Creates a replication policy for the specified bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param oci.object_storage.models.CreateReplicationPolicyDetails create_replication_policy_details: (required) The replication policy. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.ReplicationPolicy` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/create_replication_policy.py.html>`__ to see an example of how to use create_replication_policy API. �5/n/{namespaceName}/b/{bucketName}/replicationPoliciesry �create_replication_policyz`https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Replication/CreateReplicationPolicyr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? zAObjectStorageClient.create_replication_policy.<locals>.<listcomp>z2create_replication_policy got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI r? zAObjectStorageClient.create_replication_policy.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? r' rR �ReplicationPolicyr% r� r] )r- rn ro �!create_replication_policy_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r� � sn $��$ �� � �z-ObjectStorageClient.create_replication_policyc sp d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rHt|tj��s | j �| � |�| j� |j| j j||| | |d|� d�||d� S | j j||| | |d|� d�||d� S d S )a. Creates a new retention rule in the specified bucket. The new rule will take effect typically within 30 seconds. Note that a maximum of 100 rules are supported on a bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param oci.object_storage.models.CreateRetentionRuleDetails create_retention_rule_details: (required) The retention rule to create for the bucket. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.RetentionRule` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/create_retention_rule.py.html>`__ to see an example of how to use create_retention_rule API. �0/n/{namespaceName}/b/{bucketName}/retentionRulesry �create_retention_rulez^https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/RetentionRule/CreateRetentionRuler7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> e r? z=ObjectStorageClient.create_retention_rule.<locals>.<listcomp>z.create_retention_rule got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI o r? z=ObjectStorageClient.create_retention_rule.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI z r? r' rR � RetentionRuler% r� r] )r- rn ro � create_retention_rule_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r� 5 sn %��$ �� � �z)ObjectStorageClient.create_retention_rulec sr d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u r�tj} | �rNt| tj��s*| j �| � | �| j� | j| j j||| | |� d�||d�S | j j||| | |� d�||d�S d S )a� Deletes a bucket if the bucket is already empty. If the bucket is not empty, use :func:`delete_object` first. In addition, you cannot delete a bucket that has a multipart upload in progress or a pre-authenticated request associated with that bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/delete_bucket.py.html>`__ to see an example of how to use delete_bucket API. �!/n/{namespaceName}/b/{bucketName}r5 � delete_bucketzPhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Bucket/DeleteBucket�r% r' r| r8 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z5ObjectStorageClient.delete_bucket.<locals>.<listcomp>z&delete_bucket got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z5ObjectStorageClient.delete_bucket.<locals>.<dictcomp>Nr rJ rM r| r8 �rO rP r rQ c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r% rv r] �r- rn ro r/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r� � sh )��$ �� � �z!ObjectStorageClient.delete_bucketc s� d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qld|� dt �i} dd � t �| �D �} dd|� dt �|� dt �d�}dd � t �|�D �}| j j |� d�| j d�}|d u �r&tj}|�rxt|tj��sR| j �|� |�| j� |j| j j||| | ||� d�||d� S | j j||| | ||� d�||d�S d S )a� Deletes an object. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str object_name: (required) The name of the object. Avoid entering confidential information. Example: `test/object1.log` :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str opc_client_request_id: (optional) The client request ID for tracing. :param str version_id: (optional) VersionId used to identify a particular version of the object :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/delete_object.py.html>`__ to see an example of how to use delete_object API. �0/n/{namespaceName}/b/{bucketName}/o/{objectName}r5 � delete_objectzPhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Object/DeleteObject)r% r' r| r8 � version_idc s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> C r? z5ObjectStorageClient.delete_object.<locals>.<listcomp>z&delete_object got unknown kwargs: {!r}r@ c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI N r? z5ObjectStorageClient.delete_object.<locals>.<dictcomp>Nr rJ � versionIdr� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI W r? rM r| r8 r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI _ r? r' rR r% rU r] �r- rn ro rp r/ rV rW r[ r\ rr rX rG rH rY rZ r' r1 r< r2 r� st -��$ � �� � �z!ObjectStorageClient.delete_objectc sr d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u r�tj} | �rNt| tj��s*| j �| � | �| j� | j| j j||| | |� d�||d�S | j j||| | |� d�||d�S d S )a! Deletes the object lifecycle policy for the bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str opc_client_request_id: (optional) The client request ID for tracing. :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/delete_object_lifecycle_policy.py.html>`__ to see an example of how to use delete_object_lifecycle_policy API. �#/n/{namespaceName}/b/{bucketName}/lr5 � delete_object_lifecycle_policyznhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/ObjectLifecyclePolicy/DeleteObjectLifecyclePolicy)r% r' r8 r| c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? zFObjectStorageClient.delete_object_lifecycle_policy.<locals>.<listcomp>z7delete_object_lifecycle_policy got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? zFObjectStorageClient.delete_object_lifecycle_policy.<locals>.<dictcomp>Nr rJ rM r8 r| )rO rP rQ r c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r% rv r] r� r1 r< r2 r� � sh &��$ �� � �z2ObjectStorageClient.delete_object_lifecycle_policyc sj d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qldd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rFt|tj��s"| j �| � |�| j� |j| j j||| | |� d�||d�S | j j||| | |� d�||d�S d S )a� Deletes the pre-authenticated request for the bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str par_id: (required) The unique identifier for the pre-authenticated request. This can be used to manage operations against the pre-authenticated request, such as GET or DELETE. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/delete_preauthenticated_request.py.html>`__ to see an example of how to use delete_preauthenticated_request API. �+/n/{namespaceName}/b/{bucketName}/p/{parId}r5 � delete_preauthenticated_requestzrhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/PreauthenticatedRequest/DeletePreauthenticatedRequestr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> r? zGObjectStorageClient.delete_preauthenticated_request.<locals>.<listcomp>z8delete_preauthenticated_request got unknown kwargs: {!r}�rA rB �parIdc S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI $ r? zGObjectStorageClient.delete_preauthenticated_request.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI / r? r' rR r% rv r] �r- rn ro �par_idr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r� � sh %��$ �� � �z3ObjectStorageClient.delete_preauthenticated_requestc sj d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qldd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rFt|tj��s"| j �| � |�| j� |j| j j||| | |� d�||d�S | j j||| | |� d�||d�S d S )aK Deletes the replication policy associated with the source bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str replication_id: (required) The ID of the replication policy. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/delete_replication_policy.py.html>`__ to see an example of how to use delete_replication_policy API. �E/n/{namespaceName}/b/{bucketName}/replicationPolicies/{replicationId}r5 �delete_replication_policyz`https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Replication/DeleteReplicationPolicyr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> ~ r? zAObjectStorageClient.delete_replication_policy.<locals>.<listcomp>z2delete_replication_policy got unknown kwargs: {!r}�rA rB � replicationIdc S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? zAObjectStorageClient.delete_replication_policy.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r% rv r] �r- rn ro �replication_idr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r� O sh $��$ �� � �z-ObjectStorageClient.delete_replication_policyc sv d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qldd|� dt �|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u �rtj}|�rRt|tj��s.| j �| � |�| j� |j| j j||| | |� d�||d�S | j j||| | |� d�||d�S d S )a� Deletes the specified rule. The deletion takes effect typically within 30 seconds. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str retention_rule_id: (required) The ID of the retention rule. :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/delete_retention_rule.py.html>`__ to see an example of how to use delete_retention_rule API. �B/n/{namespaceName}/b/{bucketName}/retentionRules/{retentionRuleId}r5 �delete_retention_rulez^https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/RetentionRule/DeleteRetentionRuler� c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z=ObjectStorageClient.delete_retention_rule.<locals>.<listcomp>z.delete_retention_rule got unknown kwargs: {!r}�rA rB �retentionRuleIdc S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z=ObjectStorageClient.delete_retention_rule.<locals>.<dictcomp>Nr rJ rM r| r8 r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? r' rR r% rv r] �r- rn ro �retention_rule_idr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r� � sj )��$ �� � �z)ObjectStorageClient.delete_retention_rulec s� d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjd|v r�g d�} |d D ]} | | vr�td�| ���q�d| j � |� dt �d�i}dd � t �|�D �}dd|� dt �|� dt �|� dt �d�}dd � t �|�D �}| j j |� d�| jd�}|d u �rltj}|�r�t|tj��s�| j �|� |�| j� |j| j j||| ||d |� d �||d � S | j j||| ||d |� d �||d � S d S ) a� Gets the current representation of the given bucket in the given Object Storage namespace. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str if_none_match: (optional) The entity tag (ETag) to avoid matching. Wildcards ('*') are not allowed. If the specified ETag does not match the ETag of the existing resource, the request returns the expected response. If the ETag matches the ETag of the existing resource, the request returns an HTTP 304 status without a response body. :param str opc_client_request_id: (optional) The client request ID for tracing. :param list[str] fields: (optional) Bucket summary includes the 'namespace', 'name', 'compartmentId', 'createdBy', 'timeCreated', and 'etag' fields. This parameter can also include 'approximateCount' (approximate number of objects), 'approximateSize' (total approximate size in bytes of all objects) and 'autoTiering' (state of auto tiering on the bucket). For example 'approximateCount,approximateSize,autoTiering'. Allowed values are: "approximateCount", "approximateSize", "autoTiering" :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.Bucket` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/get_bucket.py.html>`__ to see an example of how to use get_bucket API. r� �GET� get_bucketzMhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Bucket/GetBucket)r% r' r| r} r8 �fieldsc s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> a r? z2ObjectStorageClient.get_bucket.<locals>.<listcomp>z#get_bucket got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI k r? z2ObjectStorageClient.get_bucket.<locals>.<dictcomp>Nr rJ r� )�approximateCount�approximateSize� autoTiering�.Invalid value for `fields`, must be one of {0}�csvc S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI | r? rM r| r} r8 r~ c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r� r% � rV rW rX rY rZ r� r% r[ r\ )r r^ r_ r` ra rb rc rd re r, � generate_collection_format_paramr) rE rf r' r rg rh ri rj r( rk rl )r- rn ro r/ rV rW r[ r\ rr rX rG rH �fields_allowed_values� fields_itemrY rZ r' r1 r< r2 r� s� 3��$ �� �� � �z ObjectStorageClient.get_bucketc s* d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���d |�d t�i}d d � t �|�D �}d d |�dt�d�}dd � t �|�D �}| jj|�d�| j d�} | du r�t j } | �rt | t j �s�| j�|� | �| j� | j| jj||||d|�d�||d� S | jj||||d|�d�||d�S dS )a Each Oracle Cloud Infrastructure tenant is assigned one unique and uneditable Object Storage namespace. The namespace is a system-generated string assigned during account creation. For some older tenancies, the namespace string may be the tenancy name in all lower-case letters. You cannot edit a namespace. GetNamespace returns the name of the Object Storage namespace for the user making the request. If an optional compartmentId query parameter is provided, GetNamespace returns the namespace name of the corresponding tenancy, provided the user has access to it. :param str opc_client_request_id: (optional) The client request ID for tracing. :param str compartment_id: (optional) This is an optional field representing either the tenancy `OCID`__ or the compartment `OCID`__ within the tenancy whose Object Storage namespace is to be retrieved. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type str :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/get_namespace.py.html>`__ to see an example of how to use get_namespace API. z/nr� � get_namespacezShttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Namespace/GetNamespace)r% r' r8 �compartment_idc s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z5ObjectStorageClient.get_namespace.<locals>.<listcomp>z&get_namespace got unknown kwargs: {!r}� compartmentIdr� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? z5ObjectStorageClient.get_namespace.<locals>.<dictcomp>rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR N�strr% �rV rW rY rZ r� r% r[ r\ �r r^ r_ r` r) rE ra r, rf r' r rg rb rh ri rj r( rk rl ) r- r/ rV rW r[ r\ rr rY rZ r' r1 r< r2 r� � sb '� � �� � �z!ObjectStorageClient.get_namespacec sj d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���d |i}d d � t �|�D �}t �|�D ]:\} } | d u s�t| t j�rht| �� �d krhtd�| ���qhdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u r�tj} | �rDt| tj��s | j �| � | �| j� | j| j j|||| d|� d�||d� S | j j|||| d|� d�||d�S d S )aA Gets the metadata for the Object Storage namespace, which contains defaultS3CompartmentId and defaultSwiftCompartmentId. Any user with the OBJECTSTORAGE_NAMESPACE_READ permission will be able to see the current metadata. 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`__. __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm :param str namespace_name: (required) The Object Storage namespace used for the request. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.NamespaceMetadata` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/get_namespace_metadata.py.html>`__ to see an example of how to use get_namespace_metadata API. �/n/{namespaceName}r� �get_namespace_metadataz[https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Namespace/GetNamespaceMetadatar7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> = r? z>ObjectStorageClient.get_namespace_metadata.<locals>.<listcomp>z/get_namespace_metadata got unknown kwargs: {!r}rA c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI F r? z>ObjectStorageClient.get_namespace_metadata.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI Q r? r' rR �NamespaceMetadatar% �rV rW rX rZ r� r% r[ r\ r] ) r- rn r/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r� sh %��$ �� � �z*ObjectStorageClient.get_namespace_metadatac s d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���ql|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �d�} dd � t �| �D �} dd|� dt �|� dt �|� dt �|� d t �|� d t �|� d t �|� d t �d � }d!d � t �|�D �}| j j |� d"�| j d#�}|d u �r�tj}|�r�t|tj��s�| j �|� |�| j� |j| j j||| | |d$|� d%�||d&� S | j j||| | |d$|� d%�||d&� S d S )'a Gets the metadata and body of an object. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str object_name: (required) The name of the object. Avoid entering confidential information. Example: `test/object1.log` :param str version_id: (optional) VersionId used to identify a particular version of the object :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str if_none_match: (optional) The entity tag (ETag) to avoid matching. Wildcards ('*') are not allowed. If the specified ETag does not match the ETag of the existing resource, the request returns the expected response. If the ETag matches the ETag of the existing resource, the request returns an HTTP 304 status without a response body. :param str opc_client_request_id: (optional) The client request ID for tracing. :param str range: (optional) Optional byte range to fetch, as described in `RFC 7233`__. Note that only a single range of bytes is supported. __ https://tools.ietf.org/html/rfc7233#section-2.1 :param str opc_sse_customer_algorithm: (optional) The optional header that specifies "AES256" as the encryption algorithm. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key: (optional) The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or decrypt the data. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key_sha256: (optional) The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This value is used to check the integrity of the encryption key. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str http_response_content_disposition: (optional) Specify this query parameter to override the value of the Content-Disposition response header in the GetObject response. :param str http_response_cache_control: (optional) Specify this query parameter to override the Cache-Control response header in the GetObject response. :param str http_response_content_type: (optional) Specify this query parameter to override the Content-Type response header in the GetObject response. :param str http_response_content_language: (optional) Specify this query parameter to override the Content-Language response header in the GetObject response. :param str http_response_content_encoding: (optional) Specify this query parameter to override the Content-Encoding response header in the GetObject response. :param str http_response_expires: (optional) Specify this query parameter to override the Expires response header in the GetObject response. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type stream :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/get_object.py.html>`__ to see an example of how to use get_object API. r� r� � get_objectzMhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Object/GetObject)r% r' r� r| r} r8 �ranger� r� r� �!http_response_content_disposition�http_response_cache_control�http_response_content_type� http_response_content_language� http_response_content_encoding�http_response_expiresc s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z2ObjectStorageClient.get_object.<locals>.<listcomp>z#get_object got unknown kwargs: {!r}r@ c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z2ObjectStorageClient.get_object.<locals>.<dictcomp>Nr rJ r� r� r� r� r� r� r� )r� � httpResponseContentDisposition�httpResponseCacheControl�httpResponseContentType�httpResponseContentLanguage�httpResponseContentEncoding�httpResponseExpiresc S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? rM r| r} r8 r� r� r� r� ) rO rP r r� rQ r� r� r� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? r' rR �streamr% r� r] r� r1 r< r2 r� s s� ^��$ � � � � �z ObjectStorageClient.get_objectc sl d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u r�tj} | �rFt| tj��s | j �| � | �| j� | j| j j||| | d|� d�||d� S | j j||| | d|� d�||d�S d S )a Gets the object lifecycle policy for the bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.ObjectLifecyclePolicy` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/get_object_lifecycle_policy.py.html>`__ to see an example of how to use get_object_lifecycle_policy API. r� r� �get_object_lifecycle_policyzkhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/ObjectLifecyclePolicy/GetObjectLifecyclePolicyr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> ` r? zCObjectStorageClient.get_object_lifecycle_policy.<locals>.<listcomp>z4get_object_lifecycle_policy got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI j r? zCObjectStorageClient.get_object_lifecycle_policy.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI u r? r' rR �ObjectLifecyclePolicyr% r� r] r� r1 r< r2 r� 4 sj !��$ �� � �z/ObjectStorageClient.get_object_lifecycle_policyc sn d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qldd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rHt|tj��s"| j �| � |�| j� |j| j j||| | d|� d�||d� S | j j||| | d|� d�||d�S d S )a� Gets the pre-authenticated request for the bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str par_id: (required) The unique identifier for the pre-authenticated request. This can be used to manage operations against the pre-authenticated request, such as GET or DELETE. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.PreauthenticatedRequestSummary` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/get_preauthenticated_request.py.html>`__ to see an example of how to use get_preauthenticated_request API. r� r� � get_preauthenticated_requestzohttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/PreauthenticatedRequest/GetPreauthenticatedRequestr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? zDObjectStorageClient.get_preauthenticated_request.<locals>.<listcomp>z5get_preauthenticated_request got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? zDObjectStorageClient.get_preauthenticated_request.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR � PreauthenticatedRequestSummaryr% r� r] r� r1 r< r2 r� � sl %��$ �� � �z0ObjectStorageClient.get_preauthenticated_requestc sn d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qldd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rHt|tj��s"| j �| � |�| j� |j| j j||| | d|� d�||d� S | j j||| | d|� d�||d�S d S )aP Get the replication policy. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str replication_id: (required) The ID of the replication policy. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.ReplicationPolicy` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/get_replication_policy.py.html>`__ to see an example of how to use get_replication_policy API. r� r� �get_replication_policyz]https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Replication/GetReplicationPolicyr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> . r? z>ObjectStorageClient.get_replication_policy.<locals>.<listcomp>z/get_replication_policy got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI 9 r? z>ObjectStorageClient.get_replication_policy.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI D r? r' rR r� r% r� r] r� r1 r< r2 r� � sl $��$ �� � �z*ObjectStorageClient.get_replication_policyc sn d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qldd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rHt|tj��s"| j �| � |�| j� |j| j j||| | d|� d�||d� S | j j||| | d|� d�||d�S d S )aI Get the specified retention rule. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str retention_rule_id: (required) The ID of the retention rule. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.RetentionRule` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/get_retention_rule.py.html>`__ to see an example of how to use get_retention_rule API. r� r� �get_retention_rulez[https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/RetentionRule/GetRetentionRuler7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z:ObjectStorageClient.get_retention_rule.<locals>.<listcomp>z+get_retention_rule got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z:ObjectStorageClient.get_retention_rule.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r� r% r� r] r� r1 r< r2 r� f sl $��$ �� � �z&ObjectStorageClient.get_retention_rulec sj d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���d |i}d d � t �|�D �}t �|�D ]:\} } | d u s�t| t j�rht| �� �d krhtd�| ���qhdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u r�tj} | �rDt| tj��s | j �| � | �| j� | j| j j|||| d|� d�||d� S | j j|||| d|� d�||d�S d S )aN Gets the status of the work request for the given ID. :param str work_request_id: (required) The ID of the asynchronous request. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.WorkRequest` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/get_work_request.py.html>`__ to see an example of how to use get_work_request API. rs r� �get_work_requestzWhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/WorkRequest/GetWorkRequestr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z8ObjectStorageClient.get_work_request.<locals>.<listcomp>z)get_work_request got unknown kwargs: {!r}ru c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z8ObjectStorageClient.get_work_request.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? r' rR � WorkRequestr% r� r] rw r1 r< r2 r� � sh ��$ �� � �z$ObjectStorageClient.get_work_requestc s~ d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �|� dt �|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u �r tj} | �rZt| tj��s6| j �| � | �| j� | j| j j||| | |� d�||d�S | j j||| | |� d�||d�S d S )a� Efficiently checks to see if a bucket exists and gets the current entity tag (ETag) for the bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str if_none_match: (optional) The entity tag (ETag) to avoid matching. Wildcards ('*') are not allowed. If the specified ETag does not match the ETag of the existing resource, the request returns the expected response. If the ETag matches the ETag of the existing resource, the request returns an HTTP 304 status without a response body. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/head_bucket.py.html>`__ to see an example of how to use head_bucket API. r� �HEAD� head_bucketzNhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Bucket/HeadBucketr{ c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> c r? z3ObjectStorageClient.head_bucket.<locals>.<listcomp>z$head_bucket got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI m r? z3ObjectStorageClient.head_bucket.<locals>.<dictcomp>Nr rJ rM r| r} r8 r~ c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI z r? r' rR r% rv r] r� r1 r< r2 r� + sj +��$ �� � �z ObjectStorageClient.head_bucketc s� d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qld|� dt �i} dd � t �| �D �} dd|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �d�}dd � t �|�D �}| j j |� d�| j d �}|d u �rNtj}|�r�t|tj��sz| j �|� |�| j� |j| j j||| | ||� d �||d � S | j j||| | ||� d �||d �S d S ) a Gets the user-defined metadata and entity tag (ETag) for an object. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str object_name: (required) The name of the object. Avoid entering confidential information. Example: `test/object1.log` :param str version_id: (optional) VersionId used to identify a particular version of the object :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str if_none_match: (optional) The entity tag (ETag) to avoid matching. Wildcards ('*') are not allowed. If the specified ETag does not match the ETag of the existing resource, the request returns the expected response. If the ETag matches the ETag of the existing resource, the request returns an HTTP 304 status without a response body. :param str opc_client_request_id: (optional) The client request ID for tracing. :param str opc_sse_customer_algorithm: (optional) The optional header that specifies "AES256" as the encryption algorithm. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key: (optional) The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or decrypt the data. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key_sha256: (optional) The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This value is used to check the integrity of the encryption key. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/head_object.py.html>`__ to see an example of how to use head_object API. r� r� � head_objectzNhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Object/HeadObject) r% r' r� r| r} r8 r� r� r� c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z3ObjectStorageClient.head_object.<locals>.<listcomp>z$head_object got unknown kwargs: {!r}r@ c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z3ObjectStorageClient.head_object.<locals>.<dictcomp>Nr rJ r� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? rM r| r} r8 r� r� r� )rO rP r r� rQ r� r� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? r' rR r% rU r] r� r1 r< r2 r� � s| F ��$ � � � � �z ObjectStorageClient.head_objectc s� d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���d |i} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rht| �� �d krhtd�| ���qhd|v r�dg} |d D ]} | | vr�td�| ���q�||� dt �|� dt �| j � |� dt �d�d�}dd � t �|�D �}dd|� dt �d�}dd � t �|�D �}| j j |� d�| jd �}|d u �rjtj}|�r�t|tj��s�| j �|� |�| j� |j| j j||| ||d |� d �||d � S | j j||| ||d |� d �||d � S d S ) a� 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`__. __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm :param str namespace_name: (required) The Object Storage namespace used for the request. :param str compartment_id: (required) The ID of the compartment in which to list buckets. :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param list[str] fields: (optional) Bucket summary in list of buckets includes the 'namespace', 'name', 'compartmentId', 'createdBy', 'timeCreated', and 'etag' fields. This parameter can also include 'tags' (freeformTags and definedTags). The only supported value of this parameter is 'tags' for now. Example 'tags'. Allowed values are: "tags" :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.object_storage.models.BucketSummary` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_buckets.py.html>`__ to see an example of how to use list_buckets API. r� r� � list_bucketszOhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Bucket/ListBuckets)r% r' �limit�pager� r8 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> ~ r? z4ObjectStorageClient.list_buckets.<locals>.<listcomp>z%list_buckets got unknown kwargs: {!r}rA c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z4ObjectStorageClient.list_buckets.<locals>.<dictcomp>Nr rJ r� �tagsr� r� r� r� )r� r� r� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR zlist[BucketSummary]r% r� )r r^ r_ r` ra rb rc rd re r) rE r, r� rf r' r rg rh ri rj r( rk rl )r- rn r� r/ rV rW r[ r\ rr rX rG rH r� r� rY rZ r' r1 r< r2 r� 3 s� =��$ � � �� � �z ObjectStorageClient.list_bucketsc s� d}d}d}d} g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���ql||� dt �|� dt �d�}dd � t �|�D �}dd|� dt �d�}dd � t �|�D �}| j j |� d�| j d�}|d u �r(tj}|�r|t|tj��sT| j �|� |�| j� |j| j j||| ||d|� d�|| d� S | j j||| ||d|� d�|| d� S d S ) a� Lists the parts of an in-progress multipart upload. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str object_name: (required) The name of the object. Avoid entering confidential information. Example: `test/object1.log` :param str upload_id: (required) The upload ID for a multipart upload. :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.object_storage.models.MultipartUploadPartSummary` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_multipart_upload_parts.py.html>`__ to see an example of how to use list_multipart_upload_parts API. r4 r� �list_multipart_upload_partszehttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/MultipartUpload/ListMultipartUploadParts�r% r' r� r� r8 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> r? zCObjectStorageClient.list_multipart_upload_parts.<locals>.<listcomp>z4list_multipart_upload_parts got unknown kwargs: {!r}r@ c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI r? zCObjectStorageClient.list_multipart_upload_parts.<locals>.<dictcomp>Nr rJ r� r� )rK r� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI % r? r' rR z list[MultipartUploadPartSummary]r% r� r] rm r1 r< r2 r� � sz 5��$ � �� � �z/ObjectStorageClient.list_multipart_upload_partsc s� d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qj|� dt �|� dt �d�} dd � t �| �D �} dd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u �r$tj}|�rxt|tj��sP| j �| � |�| j� |j| j j||| | | d|� d�||d� S | j j||| | | d|� d�||d� S d S ) a� Lists all of the in-progress multipart uploads for the given bucket in the given Object Storage namespace. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.object_storage.models.MultipartUpload` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_multipart_uploads.py.html>`__ to see an example of how to use list_multipart_uploads API. r� r� �list_multipart_uploadszahttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/MultipartUpload/ListMultipartUploadsr� c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z>ObjectStorageClient.list_multipart_uploads.<locals>.<listcomp>z/list_multipart_uploads got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z>ObjectStorageClient.list_multipart_uploads.<locals>.<dictcomp>Nr rJ r� r� )r� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR zlist[MultipartUpload]r% r� r] �r- rn ro r/ rV rW r[ r\ rr rX rG rH rY rZ r' r1 r< r2 r� I sv .��$ � �� � �z*ObjectStorageClient.list_multipart_uploadsc s� d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qj|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �d�} dd � t �| �D �} dd|� dt �d�} d d � t �| �D �} | j j |� d �| j d �}|d u �r`tj}|�r�t|tj��s�| j �| � |�| j� |j| j j||| | | d |� d �||d!� S | j j||| | | d |� d �||d!� S d S )"a� 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`__. __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str prefix: (optional) The string to use for matching against the start of object names in a list query. :param str start: (optional) Object names returned by a list query must be greater or equal to this parameter. :param str end: (optional) Object names returned by a list query must be strictly less than this parameter. :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str delimiter: (optional) 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. :param str fields: (optional) 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'. Allowed values are: "name", "size", "etag", "timeCreated", "md5", "timeModified", "storageTier", "archivalState" :param str opc_client_request_id: (optional) The client request ID for tracing. :param str start_after: (optional) Object names returned by a list query must be greater than this parameter. :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.ObjectVersionCollection` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_object_versions.py.html>`__ to see an example of how to use list_object_versions API. z0/n/{namespaceName}/b/{bucketName}/objectversionsr� �list_object_versionszVhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Object/ListObjectVersions) r% r' �prefix�start�endr� � delimiterr� r8 � start_afterr� c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> ) r? z<ObjectStorageClient.list_object_versions.<locals>.<listcomp>z-list_object_versions got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI 3 r? z<ObjectStorageClient.list_object_versions.<locals>.<dictcomp>Nr rJ r r r r� r r� r r� )r r r r� r r� � startAfterr� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI C r? rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI J r? r' rR �ObjectVersionCollectionr% r� r] r� r1 r< r2 r� � s� S ��$ � �� � �z(ObjectStorageClient.list_object_versionsc s� d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qj|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �d�} dd � t �| �D �} dd|� dt �d�} dd � t �| �D �} | j j |� d �| j d �}|d u �rVtj}|�r�t|tj��s�| j �| � |�| j� |j| j j||| | | d |� d �||d � S | j j||| | | d |� d �||d � S d S )!a Lists the objects in a bucket. By default, ListObjects returns object names only. See the `fields` parameter for other fields that you can optionally include in ListObjects response. ListObjects returns at most 1000 objects. To paginate through more objects, use the returned 'nextStartWith' value with the 'start' parameter. To filter which objects ListObjects returns, use the 'start' and 'end' parameters. 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`__. __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str prefix: (optional) The string to use for matching against the start of object names in a list query. :param str start: (optional) Object names returned by a list query must be greater or equal to this parameter. :param str end: (optional) Object names returned by a list query must be strictly less than this parameter. :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str delimiter: (optional) 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. :param str fields: (optional) 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'. Allowed values are: "name", "size", "etag", "timeCreated", "md5", "timeModified", "storageTier", "archivalState" :param str opc_client_request_id: (optional) The client request ID for tracing. :param str start_after: (optional) Object names returned by a list query must be greater than this parameter. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.ListObjects` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_objects.py.html>`__ to see an example of how to use list_objects API. z#/n/{namespaceName}/b/{bucketName}/or� � list_objectszOhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Object/ListObjects) r% r' r r r r� r r� r8 r c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z4ObjectStorageClient.list_objects.<locals>.<listcomp>z%list_objects got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z4ObjectStorageClient.list_objects.<locals>.<dictcomp>Nr rJ r r r r� r r� r )r r r r� r r� r c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR � ListObjectsr% r� r] r� r1 r< r2 r n s� O ��$ � �� � �z ObjectStorageClient.list_objectsc s� d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qj|� dt �|� dt �|� dt �d�} dd � t �| �D �} dd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u �r.tj}|�r�t|tj��sZ| j �| � |�| j� |j| j j||| | | d|� d�||d � S | j j||| | | d|� d�||d � S d S ) ax Lists pre-authenticated requests for the bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str object_name_prefix: (optional) User-specified object name prefixes can be used to query and return a list of pre-authenticated requests. :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.object_storage.models.PreauthenticatedRequestSummary` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_preauthenticated_requests.py.html>`__ to see an example of how to use list_preauthenticated_requests API. r� r� � list_preauthenticated_requestszqhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/PreauthenticatedRequest/ListPreauthenticatedRequests)r% r' �object_name_prefixr� r� r8 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> R r? zFObjectStorageClient.list_preauthenticated_requests.<locals>.<listcomp>z7list_preauthenticated_requests got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI \ r? zFObjectStorageClient.list_preauthenticated_requests.<locals>.<dictcomp>Nr rJ r r� r� )�objectNamePrefixr� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI g r? rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI n r? r' rR z$list[PreauthenticatedRequestSummary]r% r� r] r� r1 r< r2 r sx 1��$ � �� � �z2ObjectStorageClient.list_preauthenticated_requestsc s� d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qj|� dt �|� dt �d�} dd � t �| �D �} dd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u �r$tj}|�rxt|tj��sP| j �| � |�| j� |j| j j||| | | d|� d�||d� S | j j||| | | d|� d�||d� S d S ) a� List the replication policies associated with a bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str opc_client_request_id: (optional) The client request ID for tracing. :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.object_storage.models.ReplicationPolicySummary` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_replication_policies.py.html>`__ to see an example of how to use list_replication_policies API. r� r� �list_replication_policiesz`https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Replication/ListReplicationPolicies�r% r' r8 r� r� c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? zAObjectStorageClient.list_replication_policies.<locals>.<listcomp>z2list_replication_policies got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? zAObjectStorageClient.list_replication_policies.<locals>.<dictcomp>Nr rJ r� r� �r� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR z list[ReplicationPolicySummary]r% r� r] r� r1 r< r2 r � sv .��$ � �� � �z-ObjectStorageClient.list_replication_policiesc s� d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qj|� dt �|� dt �d�} dd � t �| �D �} dd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u �r$tj}|�rxt|tj��sP| j �| � |�| j� |j| j j||| | | d|� d�||d� S | j j||| | | d|� d�||d� S d S ) a� List the replication sources of a destination bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str opc_client_request_id: (optional) The client request ID for tracing. :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.object_storage.models.ReplicationSource` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_replication_sources.py.html>`__ to see an example of how to use list_replication_sources API. z4/n/{namespaceName}/b/{bucketName}/replicationSourcesr� �list_replication_sourcesz_https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Replication/ListReplicationSourcesr c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> G r? z@ObjectStorageClient.list_replication_sources.<locals>.<listcomp>z1list_replication_sources got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI Q r? z@ObjectStorageClient.list_replication_sources.<locals>.<dictcomp>Nr rJ r� r� r c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI [ r? rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI b r? r' rR zlist[ReplicationSource]r% r� r] r� r1 r< r2 r sv .��$ � �� � �z,ObjectStorageClient.list_replication_sourcesc sv d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjd|� dt �i} dd � t �| �D �} ddd�} | j j |� d�| j d�}|d u r�tj}|�rNt|tj��s&| j �| � |�| j� |j| j j||| | | d|� d�||d� S | j j||| | | d|� d�||d� S d S )a_ List the retention rules for a bucket. The retention rules are sorted based on creation time, with the most recently created retention rule returned first. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.RetentionRuleCollection` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_retention_rules.py.html>`__ to see an example of how to use list_retention_rules API. r� r� �list_retention_rulesz]https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/RetentionRule/ListRetentionRules)r% r' r� c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z<ObjectStorageClient.list_retention_rules.<locals>.<listcomp>z-list_retention_rules got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z<ObjectStorageClient.list_retention_rules.<locals>.<dictcomp>Nr rJ r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? rM )rO rP r' rR �RetentionRuleCollectionr% r� r] r� r1 r< r2 r � sp %��$ ��� � �z(ObjectStorageClient.list_retention_rulesc s� d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���d |i}d d � t �|�D �}t �|�D ]:\} } | d u s�t| t j�rht| �� �d krhtd�| ���qh|� dt �|� dt �d�} dd � t �| �D �} dd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u �r"tj} | �rvt| tj��sN| j �| � | �| j� | j| j j|||| | d|� d�||d� S | j j|||| | d|� d�||d� S d S ) a Lists the errors of the work request with the given ID. :param str work_request_id: (required) The ID of the asynchronous request. :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.object_storage.models.WorkRequestError` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_work_request_errors.py.html>`__ to see an example of how to use list_work_request_errors API. z$/workRequests/{workRequestId}/errorsr� �list_work_request_errorszchttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/WorkRequestError/ListWorkRequestErrors�r% r' r� r� r8 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> ) r? z@ObjectStorageClient.list_work_request_errors.<locals>.<listcomp>z1list_work_request_errors got unknown kwargs: {!r}ru c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI 2 r? z@ObjectStorageClient.list_work_request_errors.<locals>.<dictcomp>Nr rJ r� r� r c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI < r? rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI C r? r' rR zlist[WorkRequestError]r% r� r] �r- rx r/ rV rW r[ r\ rr rX rG rH rY rZ r' r1 r< r2 r � st *��$ � �� � �z,ObjectStorageClient.list_work_request_errorsc s� d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���d |i}d d � t �|�D �}t �|�D ]:\} } | d u s�t| t j�rht| �� �d krhtd�| ���qh|� dt �|� dt �d�} dd � t �| �D �} dd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u �r"tj} | �rvt| tj��sN| j �| � | �| j� | j| j j|||| | d|� d�||d� S | j j|||| | d|� d�||d� S d S ) a Lists the logs of the work request with the given ID. :param str work_request_id: (required) The ID of the asynchronous request. :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.object_storage.models.WorkRequestLogEntry` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_work_request_logs.py.html>`__ to see an example of how to use list_work_request_logs API. z"/workRequests/{workRequestId}/logsr� �list_work_request_logszdhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/WorkRequestLogEntry/ListWorkRequestLogsr c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z>ObjectStorageClient.list_work_request_logs.<locals>.<listcomp>z/list_work_request_logs got unknown kwargs: {!r}ru c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z>ObjectStorageClient.list_work_request_logs.<locals>.<dictcomp>Nr rJ r� r� r c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR zlist[WorkRequestLogEntry]r% r� r] r r1 r< r2 r g st *��$ � �� � �z*ObjectStorageClient.list_work_request_logsc s6 d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||�d t�|�d t�d �}d d � t �|�D �}dd|�dt�d�} dd � t �| �D �} | jj|�d�| j d�} | du r�t j } | �rt | t j �s�| j�| � | �| j� | j| jj|||| d|�d�||d� S | jj|||| d|�d�||d�S dS )a Lists the work requests in a compartment. :param str compartment_id: (required) The ID of the compartment in which to list buckets. :param str opc_client_request_id: (optional) The client request ID for tracing. :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see `List Pagination`__. __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.object_storage.models.WorkRequestSummary` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/list_work_requests.py.html>`__ to see an example of how to use list_work_requests API. z /workRequestsr� �list_work_requestszYhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/WorkRequest/ListWorkRequestsr c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> r? z:ObjectStorageClient.list_work_requests.<locals>.<listcomp>z+list_work_requests got unknown kwargs: {!r}r� r� )r� r� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? z:ObjectStorageClient.list_work_requests.<locals>.<dictcomp>rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI $ r? r' rR Nzlist[WorkRequestSummary]r% r� r� ) r- r� r/ rV rW r[ r\ rr rY rZ r' r1 r< r2 r � sf *� � �� � �z&ObjectStorageClient.list_work_requestsc sh d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u r�tj} | �rDt| tj��s | j �| � | �| j� | j| j j||| | |� d�||d�S | j j||| | |� d�||d�S d S )a_ Stops replication to the destination bucket and removes the replication policy. When the replication policy was created, this destination bucket became read-only except for new and changed objects replicated automatically from the source bucket. MakeBucketWritable removes the replication policy. This bucket is no longer the target for replication and is now writable, allowing users to make changes to bucket contents. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/make_bucket_writable.py.html>`__ to see an example of how to use make_bucket_writable API. z</n/{namespaceName}/b/{bucketName}/actions/makeBucketWritablery �make_bucket_writablez[https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Replication/MakeBucketWritabler7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> u r? z<ObjectStorageClient.make_bucket_writable.<locals>.<listcomp>z-make_bucket_writable got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI r? z<ObjectStorageClient.make_bucket_writable.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r% rv r] r� r1 r< r2 r F sf $��$ �� � �z(ObjectStorageClient.make_bucket_writablec s0 d}d}d}d} g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qld|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� d t �|� d t �|� d t �|� d t �d �}t �|� d!i ��D ]\}}||d"| < �qbd#d � t �|�D �}d$d� |D �}d|v�r�d%|d< z| W n t �y� |� d&t �}Y n0 |t u�r�|d u�r�t|t j t jf��st |d'��std(��t |d)��rTt |d*��rT|jd+k�rTtj�|�d k�r�d,|d-< n8d-|v�r�t|��s�t||� d.��}|d |d-< |d/ }| jj|� d0�| jd1�}|d u �r�tj}|�rt|tj��s�| j�|� |� | j � |j | jj ||| ||d2|� d3�|| d4� S | jj ||| ||d2|� d3�|| d4� S d S )5a�$ Creates a new object or overwrites an existing object with the same name. The maximum object size allowed by PutObject is 50 GiB. See `Object Names`__ for object naming requirements. See `Special Instructions for Object Storage PUT`__ for request signature requirements. __ https://docs.cloud.oracle.com/Content/Object/Tasks/managingobjects.htm#namerequirements __ https://docs.cloud.oracle.com/Content/API/Concepts/signingrequests.htm#ObjectStoragePut :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str object_name: (required) The name of the object. Avoid entering confidential information. Example: `test/object1.log` :param stream put_object_body: (required) The object to upload to the object store. :param int content_length: (optional) The content length of the body. :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str if_none_match: (optional) The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the resource already exists. :param str opc_client_request_id: (optional) The client request ID for tracing. :param str expect: (optional) A value of `100-continue` requests preliminary verification of the request method, path, and headers before the request body is sent. If no error results from such verification, the server will send a 100 (Continue) interim response to indicate readiness for the request body. The only allowed value for this parameter is "100-Continue" (case-insensitive). :param str content_md5: (optional) The optional base-64 header that defines the encoded MD5 hash of the body. If the optional Content-MD5 header is present, Object Storage performs an integrity check on the body of the HTTP request by computing the MD5 hash for the body and comparing it to the MD5 hash supplied in the header. If the two hashes do not match, the object is rejected and an HTTP-400 Unmatched Content MD5 error is returned with the message: "The computed MD5 of the request body (ACTUAL_MD5) does not match the Content-MD5 header (HEADER_MD5)" :param str content_type: (optional) The optional Content-Type header that defines the standard MIME type format of the object. Content type defaults to 'application/octet-stream' if not specified in the PutObject call. Specifying values for this header has no effect on Object Storage behavior. Programs that read the object determine what to do based on the value provided. For example, you could use this header to identify and perform special operations on text only objects. :param str content_language: (optional) The optional Content-Language header that defines the content language of the object to upload. Specifying values for this header has no effect on Object Storage behavior. Programs that read the object determine what to do based on the value provided. For example, you could use this header to identify and differentiate objects based on a particular language. :param str content_encoding: (optional) The optional Content-Encoding header that defines the content encodings that were applied to the object to upload. Specifying values for this header has no effect on Object Storage behavior. Programs that read the object determine what to do based on the value provided. For example, you could use this header to determine what decoding mechanisms need to be applied to obtain the media-type specified by the Content-Type header of the object. :param str content_disposition: (optional) The optional Content-Disposition header that defines presentational information for the object to be returned in GetObject and HeadObject responses. Specifying values for this header has no effect on Object Storage behavior. Programs that read the object determine what to do based on the value provided. For example, you could use this header to let users download objects with custom filenames in a browser. :param str cache_control: (optional) The optional Cache-Control header that defines the caching behavior value to be returned in GetObject and HeadObject responses. Specifying values for this header has no effect on Object Storage behavior. Programs that read the object determine what to do based on the value provided. For example, you could use this header to identify objects that require caching restrictions. :param str opc_sse_customer_algorithm: (optional) The optional header that specifies "AES256" as the encryption algorithm. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key: (optional) The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or decrypt the data. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key_sha256: (optional) The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This value is used to check the integrity of the encryption key. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_kms_key_id: (optional) 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. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param str storage_tier: (optional) The storage tier that the object should be stored in. If not specified, the object will be stored in the same storage tier as the bucket. Allowed values are: "Standard", "InfrequentAccess", "Archive" :param dict(str, str) opc_meta: (optional) Optional user-defined metadata key and value. "opc-meta-" will be appended to each dict key before it is sent to the server. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :param int buffer_limit: (optional) A buffer limit for the stream to be buffered. buffer_limit is used to set the buffer size capacity. Streams will be read until the size of the buffer reaches the buffer_limit. If the stream size is greater than the buffer_limit, a BufferError exception will be thrown. The buffer_limit parameter is used when the stream object does not have a `seek`, `tell`, or `fileno` property for the Python Request library to calculate out the content length. If buffer_limit is not passed, then the buffer_limit will be defaulted to 100MB. Large streams can cause the process to freeze, consider passing in content-length for large streams instead. :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/put_object.py.html>`__ to see an example of how to use put_object API. r� �PUT� put_objectzMhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Object/PutObject)r% r' � buffer_limit�content_lengthr| r} r8 �expect� content_md5� content_type�content_language�content_encoding�content_disposition� cache_controlr� r� r� r� � storage_tier�opc_metac s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> \ r? z2ObjectStorageClient.put_object.<locals>.<listcomp>z#put_object got unknown kwargs: {!r}r@ c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI g r? z2ObjectStorageClient.put_object.<locals>.<dictcomp>Nr rJ rM r| r} r8 r r r r r r r! r" r� r� r� r� r# )rO r r� rQ �Expect�Content-Length� Content-MD5z Content-TypezContent-LanguagezContent-EncodingzContent-Dispositionz Cache-Controlr� r� r� r� z storage-tierr$ z opc-meta-c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? c S s g | ] }|� � �qS r1 ��lower�r: rG r1 r1 r2 r> � r? � 100-continue�put_object_body�read�=The body must be a string, bytes, or provide a read() method.�fileno�name�<stdin>�0r& r � byte_contentr' rR Fr% ) rV rW rX rZ r� �enforce_content_headersr% r[ r\ � r r^ r_ r` ra rb rc rd re r) rE � NameError� binary_type�hasattr� TypeErrorr0 r �utils� super_lenr r r, rf r' r rg rh ri rj r( rk rl )r- rn ro rp r, r/ rV rW r[ r\ rr rX rG rH rZ �key�value� lowercase_header_params_keys�calculated_objr' r1 r< r2 r � s� ��$ � �$ � � �z ObjectStorageClient.put_objectc s� d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �|� dt �|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u �r tj}|�r^t|tj��s6| j �| � |�| j� |j| j j||| | |d|� d�||d� S | j j||| | |d|� d�||d� S d S )a� Creates or replaces the object lifecycle policy for the bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param oci.object_storage.models.PutObjectLifecyclePolicyDetails put_object_lifecycle_policy_details: (required) The lifecycle policy to apply to the bucket. :param str opc_client_request_id: (optional) The client request ID for tracing. :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str if_none_match: (optional) The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the resource already exists. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.ObjectLifecyclePolicy` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/put_object_lifecycle_policy.py.html>`__ to see an example of how to use put_object_lifecycle_policy API. r� r �put_object_lifecycle_policyzkhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/ObjectLifecyclePolicy/PutObjectLifecyclePolicy)r% r' r8 r| r} c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? zCObjectStorageClient.put_object_lifecycle_policy.<locals>.<listcomp>z4put_object_lifecycle_policy got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI r? zCObjectStorageClient.put_object_lifecycle_policy.<locals>.<dictcomp>Nr rJ rM r8 r| r} )rO rP rQ r r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? r' rR r� r% r� r] )r- rn ro �#put_object_lifecycle_policy_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 r@ � sr -��$ �� � �z/ObjectStorageClient.put_object_lifecycle_policyc sh d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u r�tj} | �rDt| tj��s | j �| � | �| j� | j| j j||| | |� d�||d�S | j j||| | |� d�||d�S d S )a� Re-encrypts the unique data encryption key that encrypts each object written to the bucket by using the most recent version of the master encryption key assigned to the bucket. (All data encryption keys are encrypted by a master encryption key. Master encryption keys are assigned to buckets and managed by Oracle by default, but you can assign a key that you created and control through the Oracle Cloud Infrastructure Key Management service.) The kmsKeyId property of the bucket determines which master encryption key is assigned to the bucket. If you assigned a different Key Management master encryption key to the bucket, you can call this API to re-encrypt all data encryption keys with the newly assigned key. Similarly, you might want to re-encrypt all data encryption keys if the assigned key has been rotated to a new key version since objects were last added to the bucket. If you call this API and there is no kmsKeyId associated with the bucket, the call will fail. Calling this API starts a work request task to re-encrypt the data encryption key of all objects in the bucket. Only objects created before the time of the API call will be re-encrypted. The call can take a long time, depending on how many objects are in the bucket and how big they are. This API returns a work request ID that you can use to retrieve the status of the work request task. All the versions of objects will be re-encrypted whether versioning is enabled or suspended at the bucket. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/reencrypt_bucket.py.html>`__ to see an example of how to use reencrypt_bucket API. z3/n/{namespaceName}/b/{bucketName}/actions/reencryptry �reencrypt_bucketzShttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Bucket/ReencryptBucketr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> o r? z8ObjectStorageClient.reencrypt_bucket.<locals>.<listcomp>z)reencrypt_bucket got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI y r? z8ObjectStorageClient.reencrypt_bucket.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r% rv r] r� r1 r< r2 rB 5 sf /��$ �� � �z$ObjectStorageClient.reencrypt_bucketc s� d}d}d}d} g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qld|� dt �i}dd � t �|�D �}dd|� dt �d�}dd � t �|�D �}| j j |� d�| j d�}|d u �r tj}|�rpt|tj��sH| j �|� |�| j� |j| j j||| ||||� d�|| d� S | j j||| ||||� d�|| d� S d S )a" Re-encrypts the data encryption keys that encrypt the object and its chunks. By default, when you create a bucket, the Object Storage service manages the master encryption key used to encrypt each object's data encryption keys. The encryption mechanism that you specify for the bucket applies to the objects it contains. You can alternatively employ one of these encryption strategies for an object: - You can assign a key that you created and control through the Oracle Cloud Infrastructure Vault service. - You can encrypt an object using your own encryption key. The key you supply is known as a customer-provided encryption key (SSE-C). :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str object_name: (required) The name of the object. Avoid entering confidential information. Example: `test/object1.log` :param oci.object_storage.models.ReencryptObjectDetails reencrypt_object_details: (required) Request object for re-encrypting the data encryption key associated with an object. :param str version_id: (optional) VersionId used to identify a particular version of the object :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/reencrypt_object.py.html>`__ to see an example of how to use reencrypt_object API. z@/n/{namespaceName}/b/{bucketName}/actions/reencrypt/{objectName}ry �reencrypt_objectzShttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Object/ReencryptObject)r% r' r� r8 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z8ObjectStorageClient.reencrypt_object.<locals>.<listcomp>z)reencrypt_object got unknown kwargs: {!r}r@ c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z8ObjectStorageClient.reencrypt_object.<locals>.<dictcomp>Nr rJ r� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r% r� r] )r- rn ro rp �reencrypt_object_detailsr/ rV rW r[ r\ rr rX rG rH rY rZ r' r1 r< r2 rC � sv 3��$ � �� � �z$ObjectStorageClient.reencrypt_objectc sl d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rFt|tj��s | j �| � |�| j� |j| j j||| | ||� d�||d� S | j j||| | ||� d�||d�S d S )a; Rename an object in the given Object Storage namespace. See `Object Names`__ for object naming requirements. __ https://docs.cloud.oracle.com/Content/Object/Tasks/managingobjects.htm#namerequirements :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param oci.object_storage.models.RenameObjectDetails rename_object_details: (required) The sourceName and newName of rename operation. Avoid entering confidential information. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/rename_object.py.html>`__ to see an example of how to use rename_object API. z6/n/{namespaceName}/b/{bucketName}/actions/renameObjectry � rename_objectzPhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Object/RenameObjectr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> V r? z5ObjectStorageClient.rename_object.<locals>.<listcomp>z&rename_object got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI ` r? z5ObjectStorageClient.rename_object.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI k r? r' rR r% r� r] )r- rn ro �rename_object_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 rE " sj )��$ �� � �z!ObjectStorageClient.rename_objectc sl d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rFt|tj��s | j �| � |�| j� |j| j j||| | ||� d�||d� S | j j||| | ||� d�||d�S d S )a� Restores one or more objects specified by the objectName parameter. By default objects will be restored for 24 hours. Duration can be configured using the hours parameter. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param oci.object_storage.models.RestoreObjectsDetails restore_objects_details: (required) Request to restore objects. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/restore_objects.py.html>`__ to see an example of how to use restore_objects API. z8/n/{namespaceName}/b/{bucketName}/actions/restoreObjectsry �restore_objectszRhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Object/RestoreObjectsr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? z7ObjectStorageClient.restore_objects.<locals>.<listcomp>z(restore_objects got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? z7ObjectStorageClient.restore_objects.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r% r� r] )r- rn ro �restore_objects_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 rG � sj %��$ �� � �z#ObjectStorageClient.restore_objectsc sz d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rRt|tj��s*| j �| � |�| j� |j| j j||| | |d|� d�||d� S | j j||| | |d|� d�||d� S d S )am Performs a partial or full update of a bucket's user-defined metadata. Use UpdateBucket to move a bucket from one compartment to another within the same tenancy. Supply the compartmentID of the compartment that you want to move the bucket to. For more information about moving resources between compartments, see `Moving Resources to a Different Compartment`__. __ https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param oci.object_storage.models.UpdateBucketDetails update_bucket_details: (required) Request object for updating a bucket. :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.Bucket` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/update_bucket.py.html>`__ to see an example of how to use update_bucket API. r� ry � update_bucketzPhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Bucket/UpdateBucketr� c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> / r? z5ObjectStorageClient.update_bucket.<locals>.<listcomp>z&update_bucket got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI 9 r? z5ObjectStorageClient.update_bucket.<locals>.<dictcomp>Nr rJ rM r| r8 r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI E r? r' rR r� r% r� r] )r- rn ro �update_bucket_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 rI � sp /��$ �� � �z!ObjectStorageClient.update_bucketc sn d}d}d}d}g d�� � fdd�t �|�D �}|rBtd�|���d |i} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rht| �� �d krhtd�| ���qhdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�} | d u r�tj} | �rFt| tj��s | j �| � | �| j� | j| j j||| | |d|� d�||d� S | j j||| | |d|� d�||d� S d S )a By default, buckets created using the Amazon S3 Compatibility API or the Swift API are created in the root compartment of the Oracle Cloud Infrastructure tenancy. You can change the default Swift/Amazon S3 compartmentId designation to a different compartmentId. All subsequent bucket creations will use the new default compartment, but no previously created buckets will be modified. A user must have OBJECTSTORAGE_NAMESPACE_UPDATE permission to make changes to the default compartments for Amazon S3 and Swift. :param str namespace_name: (required) The Object Storage namespace used for the request. :param oci.object_storage.models.UpdateNamespaceMetadataDetails update_namespace_metadata_details: (required) Request object for update NamespaceMetadata. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.NamespaceMetadata` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/update_namespace_metadata.py.html>`__ to see an example of how to use update_namespace_metadata API. r� r �update_namespace_metadataz^https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Namespace/UpdateNamespaceMetadatar7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> � r? zAObjectStorageClient.update_namespace_metadata.<locals>.<listcomp>z2update_namespace_metadata got unknown kwargs: {!r}rA c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI � r? zAObjectStorageClient.update_namespace_metadata.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r� r% r� r] )r- rn �!update_namespace_metadata_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 rK i sl &��$ �� � �z-ObjectStorageClient.update_namespace_metadatac sl d}d}d}d}g d�� � fdd�t �|�D �} | rBtd�| ���||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rjt| �� �d krjtd�| ���qjdd|� dt �d�} dd � t �| �D �} | j j |� d�| j d�}|d u r�tj}|�rFt|tj��s | j �| � |�| j� |j| j j||| | ||� d�||d� S | j j||| | ||� d�||d�S d S )a� Changes the storage tier of the object specified by the objectName parameter. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param oci.object_storage.models.UpdateObjectStorageTierDetails update_object_storage_tier_details: (required) The object name and the desired storage tier. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/update_object_storage_tier.py.html>`__ to see an example of how to use update_object_storage_tier API. zA/n/{namespaceName}/b/{bucketName}/actions/updateObjectStorageTierry �update_object_storage_tierz[https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/Object/UpdateObjectStorageTierr7 c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> r? zBObjectStorageClient.update_object_storage_tier.<locals>.<listcomp>z3update_object_storage_tier got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI r? zBObjectStorageClient.update_object_storage_tier.<locals>.<dictcomp>Nr rJ rM r8 rN c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI r? r' rR r% r� r] )r- rn ro �"update_object_storage_tier_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 rM � sj $��$ �� � �z.ObjectStorageClient.update_object_storage_tierc s~ d}d}d}d} g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\} } | d u s�t| t j�rlt| �� �d krltd�| ���qldd|� dt �|� dt �d�}dd � t �|�D �}| j j |� d�| j d�}|d u �rtj}|�rVt|tj��s.| j �|� |�| j� |j| j j||| ||d|� d�|| d� S | j j||| ||d|� d�|| d� S d S )ak Updates the specified retention rule. Rule changes take effect typically within 30 seconds. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str retention_rule_id: (required) The ID of the retention rule. :param oci.object_storage.models.UpdateRetentionRuleDetails update_retention_rule_details: (required) Request object for updating the retention rule. :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str opc_client_request_id: (optional) The client request ID for tracing. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.RetentionRule` :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/update_retention_rule.py.html>`__ to see an example of how to use update_retention_rule API. r� r �update_retention_rulez^https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/RetentionRule/UpdateRetentionRuler� c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> p r? z=ObjectStorageClient.update_retention_rule.<locals>.<listcomp>z.update_retention_rule got unknown kwargs: {!r}r� c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI { r? z=ObjectStorageClient.update_retention_rule.<locals>.<dictcomp>Nr rJ rM r| r8 r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI � r? r' rR r� r% r� r] )r- rn ro r� � update_retention_rule_detailsr/ rV rW r[ r\ rr rX rG rH rZ r' r1 r< r2 rO 8 sr ,��$ �� � �z)ObjectStorageClient.update_retention_rulec s� d}d} d} d} g d�� � fdd�t �|�D �} | rBtd�| ���|||d �} d d � t �| �D �} t �| �D ]:\}}|d u s�t|t j�rlt|�� �d krltd�|���ql||d�}dd � t �|�D �}d|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �|� dt �d � }d d � t �|�D �}d d� |D �}d|v�rfd |d< z| W n t �y� |� d t �}Y n0 |t u�rD|d u�rDt|t j t jf��s�t |d!��s�td"��t |d#��r t |d$��r |jd%k�r tj�|�d k�rDd&|d'< n8d'|v�rDt|��sDt||� d(��}|d |d'< |d) }| jj|� d*�| jd+�}|d u �rltj}|�r�t|tj��s�| j�|� |� | j � |j | jj || | |||d,|� d-�| | d.� S | jj || | |||d,|� d-�| | d.� S d S )/a� Uploads a single part of a multipart upload. :param str namespace_name: (required) The Object Storage namespace used for the request. :param str bucket_name: (required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` :param str object_name: (required) The name of the object. Avoid entering confidential information. Example: `test/object1.log` :param str upload_id: (required) The upload ID for a multipart upload. :param int upload_part_num: (required) The part number that identifies the object part currently being uploaded. :param stream upload_part_body: (required) The part being uploaded to the Object Storage service. :param int content_length: (optional) The content length of the body. :param str opc_client_request_id: (optional) The client request ID for tracing. :param str if_match: (optional) The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload the resource. :param str if_none_match: (optional) The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the resource already exists. :param str expect: (optional) A value of `100-continue` requests preliminary verification of the request method, path, and headers before the request body is sent. If no error results from such verification, the server will send a 100 (Continue) interim response to indicate readiness for the request body. The only allowed value for this parameter is "100-Continue" (case-insensitive). :param str content_md5: (optional) The optional base-64 header that defines the encoded MD5 hash of the body. If the optional Content-MD5 header is present, Object Storage performs an integrity check on the body of the HTTP request by computing the MD5 hash for the body and comparing it to the MD5 hash supplied in the header. If the two hashes do not match, the object is rejected and an HTTP-400 Unmatched Content MD5 error is returned with the message: "The computed MD5 of the request body (ACTUAL_MD5) does not match the Content-MD5 header (HEADER_MD5)" :param str opc_sse_customer_algorithm: (optional) The optional header that specifies "AES256" as the encryption algorithm. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key: (optional) The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or decrypt the data. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_customer_key_sha256: (optional) The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This value is used to check the integrity of the encryption key. For more information, see `Using Your Own Keys for Server-Side Encryption`__. __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm :param str opc_sse_kms_key_id: (optional) 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. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__. To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. :param bool allow_control_chars: (optional) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings :param int buffer_limit: (optional) A buffer limit for the stream to be buffered. buffer_limit is used to set the buffer size capacity. Streams will be read until the size of the buffer reaches the buffer_limit. If the stream size is greater than the buffer_limit, a BufferError exception will be thrown. The buffer_limit parameter is used when the stream object does not have a `seek`, `tell`, or `fileno` property for the Python Request library to calculate out the content length. If buffer_limit is not passed, then the buffer_limit will be defaulted to 100MB. Large streams can cause the process to freeze, consider passing in content-length for large streams instead. :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.90.0/objectstorage/upload_part.py.html>`__ to see an example of how to use upload_part API. r4 r � upload_partzWhttps://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/MultipartUpload/UploadPart) r% r' r r r8 r| r} r r r� r� r� r� c s g | ]}|� vr|�qS r1 r1 r9 r< r1 r2 r> ( r? z3ObjectStorageClient.upload_part.<locals>.<listcomp>z$upload_part got unknown kwargs: {!r}r@ c S s i | ]\}}|t ur||�qS r1 rD rF r1 r1 r2 rI 3 r? z3ObjectStorageClient.upload_part.<locals>.<dictcomp>Nr rJ )rK � uploadPartNumc S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI = r? rM r8 r| r} r r r r� r� r� r� ) rO rQ r r� r% r& r' r� r� r� r� c S s& i | ] \}}|t ur|d ur||�qS rL rD rF r1 r1 r2 rI L r? c S s g | ] }|� � �qS r1 r( r* r1 r1 r2 r> N r? r+ �upload_part_bodyr- r. r/ r0 r1 r2 r& r r3 r' rR Fr% ) rV rW rX rY rZ r� r4 r% r[ r\ r5 )r- rn ro rp rq �upload_part_numrS r/ rV rW r[ r\ rr rX rG rH rY rZ r> r? r' r1 r< r2 rQ � s� h��$� � �$ � � �z ObjectStorageClient.upload_partN)7�__name__� __module__� __qualname__�__doc__r3 r6 rt rz r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r r r r r@ rB rC rE rG rI rK rM rO rQ r1 r1 r1 r2 r s� Sp\ *d hhikxhfel df Bchgg^o z , &zzluujd uo~kguifsr N)� __future__r � oci._vendorr r �ocir r �oci.base_clientr � oci.configr r � oci.signerr �oci.utilr r r r r �modelsr rE �objectr r1 r1 r1 r2 �<module> s
cải xoăn