U $FZh(ã@s`dZddlmZddlmZddlmZddlmZddl m Z ddl m Z Gdd „d e ƒZ d S) zµConfigure 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)Úcreate_trace_span)Ú_DEFAULT_TIMEOUT)Ú DEFAULT_RETRY)ÚDEFAULT_RETRY_IF_ETAG_IN_JSONc@süeZdZdZdZdZdZeefZd)dd„Zdd „Z d d „Z e d d „ƒZ e dd„ƒZ e dd„ƒZe dd„ƒZe dd„ƒZe dd„ƒZejdd„ƒZe dd„ƒZe dd„ƒZe dd„ƒZe 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. ZACTIVEZINACTIVEZDELETEDNcCs:||_i|_|dk r||jd<|dk r0||jd<||_dS)NÚaccessIdÚ projectId)Ú_clientÚ _propertiesÚ _user_project)ÚselfÚclientÚ access_idZ project_idÚ user_project©rúd/home/aprabhat/apps/x.techxrdev.in/venv/lib/python3.8/site-packages/google/cloud/storage/hmac_key.pyÚ__init__:s  zHMACKeyMetadata.__init__cCs(t||jƒstS|j|jko&|j|jkS©N)Ú isinstanceÚ __class__ÚNotImplementedr r)rÚotherrrrÚ__eq__Fs zHMACKeyMetadata.__eq__cCst|jƒt|jƒSr)Úhashr r©rrrrÚ__hash__LszHMACKeyMetadata.__hash__cCs |j d¡S)z|Access ID of the key. :rtype: str or None :returns: unique identifier of the key within a project. r ©r ÚgetrrrrrOszHMACKeyMetadata.access_idcCs |j d¡S)z•ETag identifying the version of the key metadata. :rtype: str or None :returns: ETag for the version of the key's metadata. Úetagrrrrrr XszHMACKeyMetadata.etagcCs |j d¡S)zID of the key, including the Project ID and the Access ID. :rtype: str or None :returns: ID of the key. Úidrrrrrr!aszHMACKeyMetadata.idcCs |j d¡S)zzProject ID associated with the key. :rtype: str or None :returns: project identfier for the key. r rrrrrÚprojectjszHMACKeyMetadata.projectcCs |j d¡S)z­Service account e-mail address associated with the key. :rtype: str or None :returns: e-mail address for the service account which created the key. ZserviceAccountEmailrrrrrÚservice_account_emailssz%HMACKeyMetadata.service_account_emailcCs |j d¡S)zÂGet / set key's state. One of: - ``ACTIVE`` - ``INACTIVE`` - ``DELETED`` :rtype: str or None :returns: key's current state. Ústaterrrrrr$|s zHMACKeyMetadata.statecCs||jd<dS)Nr$)r ©rÚvaluerrrr$ŠscCs |j d¡}|dk rt|ƒ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. Z timeCreatedN©r rrr%rrrÚ time_createdŽs zHMACKeyMetadata.time_createdcCs |j d¡}|dk rt|ƒSdS)r'ÚupdatedNr(r%rrrr*›s zHMACKeyMetadata.updatedcCs:|jdkrtdƒ‚|j}|dkr(|jj}d|›d|j›S)z%Resource path for the metadata's key.NzNo 'access_id' set.z /projects/z /hmacKeys/)rÚ ValueErrorr"r )rr"rrrÚpath¨s  zHMACKeyMetadata.pathcCs|jS)z—Project ID to be billed for API requests made via this bucket. This property is currently ignored by the server. :rtype: str )r rrrrrµszHMACKeyMetadata.user_projectc Cs|tddhz2i}|jdk r&|j|d<|jj|j|||dWn tk r^YW5QR£dSXW5QR£dSW5QRXdS)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. zStorage.HmacKey.exists©ÚnameNÚ userProject©Z query_paramsÚtimeoutÚretryFT)rrr Ú _get_resourcer,r©rr1r2Ú qs_paramsrrrÚexists¿s   ü zHMACKeyMetadata.existsc CsJtdd6i}|jdk r$|j|d<|jj|j|||d|_W5QRXdS)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. zStorage.HmacKey.reloadr-Nr/r0)rrr r3r,r r4rrrÚreloadàs   üzHMACKeyMetadata.reloadc CsVtddBi}|jdk r$|j|d<d|ji}|jj|j||||d|_W5QRXdS)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. zStorage.HmacKey.updater-Nr/r$r0)rrr$r Z _put_resourcer,r )rr1r2r5ÚpayloadrrrÚupdateüs    ûzHMACKeyMetadata.updatec CsHtdd4i}|jdk r$|j|d<|jj|j|||dW5QRXdS)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. zStorage.HmacKey.deleter-Nr/r0)rrr Z_delete_resourcer,r4rrrÚdeletes   üzHMACKeyMetadata.delete)NNN)Ú__name__Ú __module__Ú __qualname__Ú__doc__Z ACTIVE_STATEZINACTIVE_STATEZ DELETED_STATEZ_SETTABLE_STATESrrrÚpropertyrr r!r"r#r$Úsetterr)r*r,rrrr6r7rr9r:rrrrrsD            !rN)r>Zgoogle.cloud.exceptionsrZgoogle.cloud._helpersrZ+google.cloud.storage._opentelemetry_tracingrZgoogle.cloud.storage.constantsrZgoogle.cloud.storage.retryrrÚobjectrrrrrÚs