B f'&bdZddlmZddlmZddlmZddlmZddlm Z Gdde Z d S) zConfigure HMAC keys that can be used to authenticate requests to Google Cloud Storage. See [HMAC keys documentation](https://cloud.google.com/storage/docs/authentication/hmackeys) )NotFound)_rfc3339_nanos_to_datetime)_DEFAULT_TIMEOUT) DEFAULT_RETRY)DEFAULT_RETRY_IF_ETAG_IN_JSONcleZdZdZdZ dZ dZ eefZddZdZ dZ e d Z e d Z e d Ze d Ze d Ze dZejdZe dZe dZe dZe dZeefdZeefdZeefdZeefdZdS)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. ACTIVEINACTIVEDELETEDNc`||_i|_| ||jd<| ||jd<||_dS)NaccessId projectId)_client _properties _user_project)selfclient access_id project_id user_projects l/home/panchajanya/Development/work/volatility3/lib/python3.11/site-packages/google/cloud/storage/hmac_key.py__init__zHMACKeyMetadata.__init__9sE   +4D Z (  !,6D [ ))czt||jstS|j|jko|j|jkSN) isinstance __class__NotImplementedrr)rothers r__eq__zHMACKeyMetadata.__eq__Es9%00 "! !|u},R5?1RRrcTt|jt|jzSr)hashrrrs r__hash__zHMACKeyMetadata.__hash__Ks!DL!!D$8$888rc6|jdS)z|Access ID of the key. :rtype: str or None :returns: unique identifier of the key within a project. rrgetr$s rrzHMACKeyMetadata.access_idNs##J///rc6|jdS)zETag identifying the version of the key metadata. :rtype: str or None :returns: ETag for the version of the key's metadata. etagr'r$s rr*zHMACKeyMetadata.etagWs##F+++rc6|jdS)zID of the key, including the Project ID and the Access ID. :rtype: str or None :returns: ID of the key. idr'r$s rr,zHMACKeyMetadata.id`s##D)))rc6|jdS)zzProject ID associated with the key. :rtype: str or None :returns: project identfier for the key. rr'r$s rprojectzHMACKeyMetadata.projectis##K000rc6|jdS)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'r$s rservice_account_emailz%HMACKeyMetadata.service_account_emailrs##$9:::rc6|jdS)zGet / set key's state. One of: - ``ACTIVE`` - ``INACTIVE`` - ``DELETED`` :rtype: str or None :returns: key's current state. stater'r$s rr3zHMACKeyMetadata.state{s##G,,,rc||jd<dS)Nr3)rrvalues rr3zHMACKeyMetadata.states$)!!!rc\|jd}|t|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(rr5s r time_createdzHMACKeyMetadata.time_createds6 $$]33  -e44 4  rc\|jd}|t|SdS)r8updatedNr:r5s rr=zHMACKeyMetadata.updateds6 $$Y//  -e44 4  rcr|jtd|j}| |jj}d|d|jS)z%Resource path for the metadata's key.NzNo 'access_id' set.z /projects/z /hmacKeys/)r ValueErrorr.r)rr.s rpathzHMACKeyMetadata.pathsI > !233 3, ?l*G?G??t~???rc|jS)zProject ID to be billed for API requests made via this bucket. This property is currently ignored by the server. :rtype: str )rr$s rrzHMACKeyMetadata.user_projects !!rc i}|j |j|d<|j|j|||dS#t$rYdSwxYw)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_paramstimeoutretryTF)rr _get_resourcer@rrrFrG qs_paramss rexistszHMACKeyMetadata.existssz I ,+/+< -( L & & & '   4   55 s6: AAc|i}|j |j|d<|j|j||||_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. NrCrD)rrrHr@rrIs rreloadzHMACKeyMetadata.reloadsR   ('+'8Im $<55 I" 6  rci}|j |j|d<d|ji}|j|j|||||_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. NrCr3rD)rr3r _put_resourcer@r)rrFrGrJpayloads rupdatezHMACKeyMetadata.updatesa   ('+'8Im $DJ'<55 I " 6  rcri}|j |j|d<|j|j|||dS)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. NrCrD)rr_delete_resourcer@rIs rdeletezHMACKeyMetadata.deletesV   ('+'8Im $ %% I" &     r)NNN)__name__ __module__ __qualname____doc__ ACTIVE_STATEINACTIVE_STATE DELETED_STATE_SETTABLE_STATESrr!r%propertyrr*r,r.r1r3setterr;r=r@rrrrKrMrrQrTrrr r s L:NM5$n5 * * * *SSS 99900X0,,X,**X*11X1;;X; - -X - \**\* 5 5X 5 5 5X 5 @ @X @""X".]@.]    6.5R    8.]      rr N) rXgoogle.cloud.exceptionsrgoogle.cloud._helpersrgoogle.cloud.storage.constantsrgoogle.cloud.storage.retryrrobjectr r_rrres -,,,,,<<<<<<;;;;;;444444DDDDDDQ Q Q Q Q fQ Q Q Q Q r