o Fh'&@sTdZddlmZddlmZddlmZddlmZddlm Z Gddde 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_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_projectrV/var/www/html/loop/nvenv/lib/python3.10/site-packages/google/cloud/storage/hmac_key.py__init__9s   zHMACKeyMetadata.__init__cCs(t||jstS|j|jko|j|jkSN) isinstance __class__NotImplementedr r)rotherrrr__eq__Es zHMACKeyMetadata.__eq__cCst|jt|jSr)hashr rrrrr__hash__KszHMACKeyMetadata.__hash__cC |jdS)z|Access ID of the key. :rtype: str or None :returns: unique identifier of the key within a project. r rgetrrrrrN 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%Wr$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"rrrrprojectir$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_emailrr$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*{s zHMACKeyMetadata.statecCs||jd<dS)Nr*)rrvaluerrrr*scC |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_createdcCr-)r.updatedNr0r+rrrr3r2zHMACKeyMetadata.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/)r ValueErrorr'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_resourcer5rrr9r: 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. Nr6r7)rr r;r5rr<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. Nr6r*r7)rr*r _put_resourcer5r)rr9r:r=payloadrrrupdates    zHMACKeyMetadata.updatecCs2i}|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. Nr6r7)rr _delete_resourcer5r<rrrdeletes   zHMACKeyMetadata.delete)NNN)__name__ __module__ __qualname____doc__ ACTIVE_STATEINACTIVE_STATE DELETED_STATE_SETTABLE_STATESrrr propertyrr%r&r'r)r*setterr1r3r5rrrr>r?rrBrDrrrrrsL               rN) rHgoogle.cloud.exceptionsrgoogle.cloud._helpersrgoogle.cloud.storage.constantsrgoogle.cloud.storage.retryrrobjectrrrrrs