o  i(@s`dZddlmZddlmZddlmZddlmZddl m Z ddl m Z Gdd d e 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)create_trace_span)_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_projectr}/var/www/snowflake_co_dev_github/snow_flake_back_end_deploy/env/lib/python3.10/site-packages/google/cloud/storage/hmac_key.py__init__:s   zHMACKeyMetadata.__init__cCs(t||jstS|j|jko|j|jkSN) isinstance __class__NotImplementedrr)rotherrrr__eq__Fs zHMACKeyMetadata.__eq__cCst|jt|jSr)hashrrrrrr__hash__LszHMACKeyMetadata.__hash__cC |jdS)z|Access ID of the key. :rtype: str or None :returns: unique identifier of the key within a project. r rgetr rrrrO 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#r rrrr&Xr%zHMACKeyMetadata.etagcCr")zID of the key, including the Project ID and the Access ID. :rtype: str or None :returns: ID of the key. idr#r rrrr'ar%zHMACKeyMetadata.idcCr")zzProject ID associated with the key. :rtype: str or None :returns: project identfier for the key. r r#r rrrprojectjr%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#r rrrservice_account_emailsr%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#r rrrr+|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/updatedNr1r,rrrr4r3zHMACKeyMetadata.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 )rr rrrrszHMACKeyMetadata.user_projectc Cstdd4zi}|jdur|j|d<|jj|j|||dWnty/YWddSw WddS1sr6rr?rrrreloads    "zHMACKeyMetadata.reloadcCsltdd'i}|jdur|j|d<d|ji}|jj|j||||d|_WddS1s/wYdS)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.updater7Nr9r+r:)rrr+r _put_resourcer6r)rr<r=r@payloadrrrupdates     "zHMACKeyMetadata.updatecCs^tdd i}|jdur|j|d<|jj|j|||dWddS1s(wYdS)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.deleter7Nr9r:)rrr_delete_resourcer6r?rrrdeletes   "zHMACKeyMetadata.delete)NNN)__name__ __module__ __qualname____doc__ ACTIVE_STATEINACTIVE_STATE DELETED_STATE_SETTABLE_STATESrrr!propertyrr&r'r(r*r+setterr2r4r6rrrrArBrrErGrrrrrsL              !rN)rKgoogle.cloud.exceptionsrgoogle.cloud._helpersr+google.cloud.storage._opentelemetry_tracingrgoogle.cloud.storage.constantsrgoogle.cloud.storage.retryrrobjectrrrrrs