a !f27@sPdZddlZddlmZddlmZddlmZddlm Z Gddde Z dS) zDefine API ManagedZones.N)_rfc3339_to_datetime)NotFoundChangesResourceRecordSetc@seZdZdZd-ddZeddZeddZed d Z ed d Z ed dZ eddZ eddZ e jddZ eddZejddZddZddZddZddZdd Zd.d!d"Zd/d#d$Zd0d%d&Zd1d'd(Zd2d)d*Zd3d+d,ZdS)4 ManagedZoneaManagedZones are containers for DNS resource records. See: https://cloud.google.com/dns/api/v1/managedZones :type name: string :param name: the name of the zone :type dns_name: string or :class:`NoneType` :param dns_name: the DNS name of the zone. If not passed, then calls to :meth:`create` will fail. :type client: :class:`gcloud.dns.client.Client` :param client: A client which holds credentials and project configuration for the zone (which requires a project). :type description: string or :class:`NoneType` :param description: the description for the zone. If not passed, defaults to the value of 'dns_name'. NcCs.||_||_||_i|_|dur$|}||_dS)N)namedns_name_client _properties description)selfr r clientr rP/var/www/html/python-backend/venv/lib/python3.9/site-packages/gcloud/dns/zone.py__init__.szManagedZone.__init__cCsH|d}|d}|dus$|dur,td||||d}|||S)aFactory: construct a zone given its API representation :type resource: dict :param resource: zone resource representation returned from the API :type client: :class:`gcloud.dns.client.Client` :param client: Client which holds credentials and project configuration for the zone. :rtype: :class:`gcloud.dns.zone.ManagedZone` :returns: Zone parsed from ``resource``. r dnsNameNz@Resource lacks required identity information:["name"]["dnsName"])r)getKeyError_set_properties)clsresourcerr r zonerrr from_api_repr7s   zManagedZone.from_api_reprcCs|jjS)ztProject bound to the zone. :rtype: string :returns: the project (derived from the client). )r projectrrrrrNszManagedZone.projectcCsd|j|jfS)z|URL path for the zone's APIs. :rtype: string :returns: the path based on project and dataste name. z/projects/%s/managedZones/%s)rr rrrrpathWszManagedZone.pathcCs |jdS)zDatetime at which the zone was created. :rtype: ``datetime.datetime``, or ``NoneType`` :returns: the creation time (None until set from the server). creationTimer rrrrrcreated`szManagedZone.createdcCs |jdS)zDatetime at which the zone was created. :rtype: list of strings, or ``NoneType``. :returns: the assigned name servers (None until set from the server). Z nameServersrrrrr name_serversiszManagedZone.name_serverscCs |jdS)zID for the zone resource. :rtype: string, or ``NoneType`` :returns: the ID (None until set from the server). idrrrrrzone_idrszManagedZone.zone_idcCs |jdS)zDescription of the zone. :rtype: string, or ``NoneType`` :returns: The description as set by the user, or None (the default). r rrrrrr {szManagedZone.descriptioncCs*t|tjs|durtd||jd<dS)zUpdate description of the zone. :type value: string, or ``NoneType`` :param value: new description :raises: ValueError for invalid value types. NPass a string, or Noner  isinstancesix string_types ValueErrorr rvaluerrrr s cCs |jdS)a:Named set of DNS name servers that all host the same ManagedZones. Most users will leave this blank. See: https://cloud.google.com/dns/api/v1/managedZones#nameServerSet :rtype: string, or ``NoneType`` :returns: The name as set by the user, or None (the default). nameServerSetrrrrrname_server_sets zManagedZone.name_server_setcCs*t|tjs|durtd||jd<dS)zUpdate named set of DNS name servers. :type value: string, or ``NoneType`` :param value: new title :raises: ValueError for invalid value types. Nr$r,r%r*rrrr-s cCst|||||dS)aConstruct a resource record set bound to this zone. :type name: string :param name: Name of the record set. :type record_type: string :param record_type: RR type :type ttl: integer :param ttl: TTL for the RR, in seconds :type rrdatas: list of string :param rrdatas: resource data for the RR :rtype: :class:`gcloud.dns.resource_record_set.ResourceRecordSet` :returns: a new ``ResourceRecordSet`` instance rr)rr Z record_typettlZrrdatasrrrresource_record_setszManagedZone.resource_record_setcCs t|dS)zConstruct a change set bound to this zone. :rtype: :class:`gcloud.dns.changes.Changes` :returns: a new ``Changes`` instance r.rrrrrchangesszManagedZone.changescCs|dur|j}|S)avCheck client or verify over-ride. :type client: :class:`gcloud.dns.client.Client` or ``NoneType`` :param client: the client to use. If not passed, falls back to the ``client`` stored on the current zone. :rtype: :class:`gcloud.dns.client.Client` :returns: The client passed in or the currently bound client. N)r rrrrr_require_clients zManagedZone._require_clientcCsH|j|}|dd|_d|vr8t|d|d<|j|dS)zUpdate properties from resource in body of ``api_response`` :type api_response: httplib2.Response :param api_response: response returned from an API call rNr)r clearcopypopr rupdate)r api_responsecleanedrrrrs zManagedZone._set_propertiescCsJd|ji}|jdur|j|d<|jdur2|j|d<|jdurF|j|d<|S)z1Generate a resource for ``create`` or ``update``.r Nrr r,)r r r r-)rrrrr_build_resources      zManagedZone._build_resourcecCs:||}d|jf}|jjd||d}||dS)aVAPI call: create the zone via a PUT request See: https://cloud.google.com/dns/api/v1/managedZones/create :type client: :class:`gcloud.dns.client.Client` or ``NoneType`` :param client: the client to use. If not passed, falls back to the ``client`` stored on the current zone. z/projects/%s/managedZonesPOST)methodrdataN)r3r connection api_requestr:r)rrrr8rrrcreates   zManagedZone.createcCsD||}z|jjd|jddidWnty:YdS0dSdS)aAPI call: test for the existence of the zone via a GET request See https://cloud.google.com/dns/api/v1/managedZones/get :type client: :class:`gcloud.dns.client.Client` or ``NoneType`` :param client: the client to use. If not passed, falls back to the ``client`` stored on the current zone. :rtype: bool :returns: Boolean indicating existence of the managed zone. GETfieldsr"r<rZ query_paramsFTN)r3r>r?rrr2rrrexistss    zManagedZone.existscCs*||}|jjd|jd}||dS)aZAPI call: refresh zone properties via a GET request See https://cloud.google.com/dns/api/v1/managedZones/get :type client: :class:`gcloud.dns.client.Client` or ``NoneType`` :param client: the client to use. If not passed, falls back to the ``client`` stored on the current zone. rAr<rN)r3r>r?rr)rrr8rrrreloads zManagedZone.reloadcCs ||}|jjd|jddS)aYAPI call: delete the zone via a DELETE request See: https://cloud.google.com/dns/api/v1/managedZones/delete :type client: :class:`gcloud.dns.client.Client` or ``NoneType`` :param client: the client to use. If not passed, falls back to the ``client`` stored on the current zone. DELETErEN)r3r>r?rr2rrrdelete,s zManagedZone.deletec sxi}|dur||d<|dur$||d<djjf}|}|j}|jd||d}fdd|d D}||d fS) a>List resource record sets for this zone. See: https://cloud.google.com/dns/api/v1/resourceRecordSets/list :type max_results: int :param max_results: maximum number of zones to return, If not passed, defaults to a value set by the API. :type page_token: string :param page_token: opaque marker for the next "page" of zones. If not passed, the API will return the first page of zones. :type client: :class:`gcloud.dns.client.Client` or ``NoneType`` :param client: the client to use. If not passed, falls back to the ``client`` stored on the current zone. :rtype: tuple, (list, str) :returns: list of :class:`gcloud.dns.resource_record_set.ResourceRecordSet`, plus a "next page token" string: if the token is not None, indicates that more zones can be retrieved with another call (pass that value as ``page_token``). N maxResults pageTokenz#/projects/%s/managedZones/%s/rrsetsrArCcsg|]}t|qSr)rr.0rrrr asz9ManagedZone.list_resource_record_sets..Zrrsets nextPageTokenrr r3r>r?r rZ max_resultsZ page_tokenrparamsrconnrespZzonesrrrlist_resource_record_sets9s  z%ManagedZone.list_resource_record_setsc sxi}|dur||d<|dur$||d<djjf}|}|j}|jd||d}fdd|d D}||d fS) a5List change sets for this zone. See: https://cloud.google.com/dns/api/v1/resourceRecordSets/list :type max_results: int :param max_results: maximum number of zones to return, If not passed, defaults to a value set by the API. :type page_token: string :param page_token: opaque marker for the next "page" of zones. If not passed, the API will return the first page of zones. :type client: :class:`gcloud.dns.client.Client` or ``NoneType`` :param client: the client to use. If not passed, falls back to the ``client`` stored on the current zone. :rtype: tuple, (list, str) :returns: list of :class:`gcloud.dns.resource_record_set.ResourceRecordSet`, plus a "next page token" string: if the token is not None, indicates that more zones can be retrieved with another call (pass that value as ``page_token``). NrIrJz$/projects/%s/managedZones/%s/changesrArCcsg|]}t|qSr)rrrKrrrrMsz,ManagedZone.list_changes..r1rNrOrPrrr list_changeses  zManagedZone.list_changes)NNN)N)N)N)N)NNN)NNN)__name__ __module__ __qualname____doc__r classmethodrpropertyrrr r!r#r setterr-r0r1r3rr:r@rDrFrHrTrUrrrrrsF                ,r) rYr'Zgcloud._helpersrZgcloud.exceptionsrZgcloud.dns.changesrZgcloud.dns.resource_record_setrobjectrrrrrs