B ˆuf'&ã@sTdZddlmZddlmZddlmZddlmZddlm Z Gdd„de ƒ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)Ú_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ú_/home/ankuromar296_gmail_com/myenv/lib/python3.7/site-packages/google/cloud/storage/hmac_key.pyÚ__init__9s  zHMACKeyMetadata.__init__cCs(t||jƒstS|j|jko&|j|jkS)N)Ú isinstanceÚ __class__ÚNotImplementedr r)r ÚotherrrrÚ__eq__Es zHMACKeyMetadata.__eq__cCst|jƒt|jƒS)N)Úhashr r)r rrrÚ__hash__KszHMACKeyMetadata.__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 Úget)r rrrrNszHMACKeyMetadata.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. Úetag)r r)r rrrrWszHMACKeyMetadata.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. Úid)r r)r rrrr`szHMACKeyMetadata.idcCs |j d¡S)zzProject ID associated with the key. :rtype: str or None :returns: project identfier for the key. r )r r)r rrrÚprojectiszHMACKeyMetadata.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. ZserviceAccountEmail)r r)r rrrÚservice_account_emailrsz%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. Ústate)r r)r rrrr {s zHMACKeyMetadata.statecCs||jd<dS)Nr )r )r Úvaluerrrr ‰scCs |j d¡}|dk rt|ƒSdS)a3Retrieve 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 rr)r r!rrrÚ time_createds zHMACKeyMetadata.time_createdcCs |j d¡}|dk rt|ƒSdS)a3Retrieve 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. ÚupdatedN)r rr)r 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Ú ValueErrorrr )r rrrrÚ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 )r rrrr´szHMACKeyMetadata.user_projectcCsPy2i}|jdk r|j|d<|jj|j|||dWntk rFdSXdSdS)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_paramsÚtimeoutÚretryFT)rr Ú _get_resourcer%r)r r(r)Ú qs_paramsrrrÚexists¾s   zHMACKeyMetadata.existscCs4i}|jdk r|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. Nr&)r'r(r))rr r*r%r )r r(r)r+rrrÚreloadÞs  zHMACKeyMetadata.reloadcCs@i}|jdk r|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. Nr&r )r'r(r))rr r Z _put_resourcer%r )r r(r)r+ÚpayloadrrrÚupdateùs   zHMACKeyMetadata.updatecCs2i}|jdk r|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. Nr&)r'r(r))rr Z_delete_resourcer%)r r(r)r+rrrÚdeletes  zHMACKeyMetadata.delete)NNN)Ú__name__Ú __module__Ú __qualname__Ú__doc__Z ACTIVE_STATEZINACTIVE_STATEZ DELETED_STATEZ_SETTABLE_STATESrrrÚpropertyrrrrrr Úsetterr"r#r%rrrr,r-rr/r0rrrrrs.    rN) r4Zgoogle.cloud.exceptionsrZgoogle.cloud._helpersrZgoogle.cloud.storage.constantsrZgoogle.cloud.storage.retryrrÚobjectrrrrrÚs