o ˷e&@sPddlmZddlmZddlmZddlmZddlmZGddde Z dS) )NotFound)_rfc3339_nanos_to_datetime)_DEFAULT_TIMEOUT) DEFAULT_RETRY)DEFAULT_RETRY_IF_ETAG_IN_JSONc@seZdZdZdZ dZ dZ eefZd)ddZdd Z d d Z e d d Z e ddZ e ddZe ddZe ddZe ddZejddZe ddZe ddZe ddZe dd Zeefd!d"Zeefd#d$Zeefd%d&Zeefd'd(ZdS)*HMACKeyMetadataaMetadata about an HMAC service account key withn Cloud Storage. :type client: :class:`~google.cloud.stoage.client.Client` :param client: client associated with the key metadata. :type access_id: str :param access_id: (Optional) Unique ID of an existing key. :type project_id: str :param project_id: (Optional) Project ID of an existing key. Defaults to client's project. :type user_project: str :param user_project: (Optional) This parameter is currently ignored. ACTIVEINACTIVEDELETEDNcCs:||_i|_|dur||jd<|dur||jd<||_dS)NaccessId projectId)_client _properties _user_project)selfclient access_id project_id user_projectrT/var/www/ideatree/venv/lib/python3.10/site-packages/google/cloud/storage/hmac_key.py__init__4s   zHMACKeyMetadata.__init__cCs(t||jstS|j|jko|j|jkSN) isinstance __class__NotImplementedr r)rotherrrr__eq__@s zHMACKeyMetadata.__eq__cCst|jt|jSr)hashr rrrrr__hash__FszHMACKeyMetadata.__hash__cC |jdS)z|Access ID of the key. :rtype: str or None :returns: unique identifier of the key within a project. r rgetrrrrrI zHMACKeyMetadata.access_idcCr!)zETag identifying the version of the key metadata. :rtype: str or None :returns: ETag for the version of the key's metadata. etagr"rrrrr%Rr$zHMACKeyMetadata.etagcCr!)zID of the key, including the Project ID and the Access ID. :rtype: str or None :returns: ID of the key. idr"rrrrr&[r$zHMACKeyMetadata.idcCr!)zzProject ID associated with the key. :rtype: str or None :returns: project identfier for the key. r r"rrrrprojectdr$zHMACKeyMetadata.projectcCr!)zService account e-mail address associated with the key. :rtype: str or None :returns: e-mail address for the service account which created the key. serviceAccountEmailr"rrrrservice_account_emailmr$z%HMACKeyMetadata.service_account_emailcCr!)zGet / set key's state. One of: - ``ACTIVE`` - ``INACTIVE`` - ``DELETED`` :rtype: str or None :returns: key's current state. stater"rrrrr*vs zHMACKeyMetadata.statecCs.||jvrtdd|j||jd<dS)Nz!State may only be set to one of: z, r*)_SETTABLE_STATES ValueErrorjoinrrvaluerrrr*s cC |jd}|durt|SdS)3Retrieve the timestamp at which the HMAC key was created. :rtype: :class:`datetime.datetime` or ``NoneType`` :returns: Datetime object parsed from RFC3339 valid timestamp, or ``None`` if the bucket's resource has not been loaded from the server. timeCreatedNrr#rr.rrr time_created zHMACKeyMetadata.time_createdcCr0)r1updatedNr3r.rrrr6r5zHMACKeyMetadata.updatedcCs:|jdur td|j}|dur|jj}d|d|jS)z%Resource path for the metadata's key.NzNo 'access_id' set.z /projects/z /hmacKeys/)rr,r'r )rr'rrrpaths zHMACKeyMetadata.pathcCs|jS)zProject ID to be billed for API requests made via this bucket. This property is currently ignored by the server. :rtype: str )rrrrrrszHMACKeyMetadata.user_projectcCsJzi}|jdur |j|d<|jj|j|||dWdSty$YdSw)a#Determine whether or not the key for this metadata exists. :type timeout: float or tuple :param timeout: (Optional) The amount of time, in seconds, to wait for the server response. See: :ref:`configuring_timeouts` :type retry: google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy :param retry: (Optional) How to retry the RPC. See: :ref:`configuring_retries` :rtype: bool :returns: True if the key exists in Cloud Storage. N userProject query_paramstimeoutretryFT)rr _get_resourcer7rrr;r< qs_paramsrrrexistss   zHMACKeyMetadata.existscCs4i}|jdur |j|d<|jj|j|||d|_dS)a4Reload properties from Cloud Storage. :type timeout: float or tuple :param timeout: (Optional) The amount of time, in seconds, to wait for the server response. See: :ref:`configuring_timeouts` :type retry: google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy :param retry: (Optional) How to retry the RPC. See: :ref:`configuring_retries` :raises :class:`~google.api_core.exceptions.NotFound`: if the key does not exist on the back-end. Nr8r9)rr r=r7rr>rrrreloads   zHMACKeyMetadata.reloadcCs@i}|jdur |j|d<d|ji}|jj|j||||d|_dS)a9Save writable properties to Cloud Storage. :type timeout: float or tuple :param timeout: (Optional) The amount of time, in seconds, to wait for the server response. See: :ref:`configuring_timeouts` :type retry: google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy :param retry: (Optional) How to retry the RPC. See: :ref:`configuring_retries` :raises :class:`~google.api_core.exceptions.NotFound`: if the key does not exist on the back-end. Nr8r*r9)rr*r _put_resourcer7r)rr;r<r?payloadrrrupdates    zHMACKeyMetadata.updatecCsF|j|jkr tdi}|jdur|j|d<|jj|j|||ddS)a1Delete the key from Cloud Storage. :type timeout: float or tuple :param timeout: (Optional) The amount of time, in seconds, to wait for the server response. See: :ref:`configuring_timeouts` :type retry: google.api_core.retry.Retry or google.cloud.storage.retry.ConditionalRetryPolicy :param retry: (Optional) How to retry the RPC. See: :ref:`configuring_retries` :raises :class:`~google.api_core.exceptions.NotFound`: if the key does not exist on the back-end. z-Cannot delete key if not in 'INACTIVE' state.Nr8r9)r*INACTIVE_STATEr,rr _delete_resourcer7r>rrrdeletes    zHMACKeyMetadata.delete)NNN)__name__ __module__ __qualname____doc__ ACTIVE_STATErE DELETED_STATEr+rrr propertyrr%r&r'r)r*setterr4r6r7rrrr@rArrDrGrrrrrsL               rN) google.cloud.exceptionsrgoogle.cloud._helpersrgoogle.cloud.storage.constantsrgoogle.cloud.storage.retryrrobjectrrrrrs