Requires authorization
Atomically updates the
ResourceRecordSet
collection. This method can include both additions and deletions. If you need to update a resource record, you send the deletion and addition of the record in the same request. As a best practice to prevent collisions with other changes, you should increment the serial number of your
SOA
record with each request to this method by sending a deletion and addition of the
SOA
record with your other changes.
Try it now
or
see an example
.
Request
HTTP request
POST https://www.googleapis.com/dns/v1beta1/projects/project/managedZones/managedZone/changes
Parameters
Parameter name | Value | Description |
---|---|---|
Path parameters | ||
managedZone
|
string
|
Identifies the managed zone addressed by this request. Can be the managed zone name or ID. |
project
|
string
|
Identifies the project addressed by this request. |
Authorization
This request requires authorization with at least one of the following scopes ( read more about authentication and authorization ).
Scope |
---|
https://www.googleapis.com/auth/ndev.clouddns.readwrite
|
https://www.googleapis.com/auth/cloud-platform
|
Request body
In the request body, supply a Changes resource .
Response
If successful, this method returns a Changes resource in the response body.
Examples
Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).
Python
Uses the Python client library .
from apiclient import errors # ... ## # Addition of records # BODY = { 'additions' : [{ 'name' : 'example.com.', 'type' : 'A', 'ttl' : '3600', 'rrdatas' : [ '1.2.3.4' ] }] } try: response = service.changes().create(project=PROJECT_NAME, managedZone=ZONE_NAME, body=BODY).execute() except errors.HttpError, error: print 'An error occurred: %s' % error ## # Deletion and addition of records in the same request: # BODY = { 'additions' : [{ 'name' : 'example.com.', 'type' : 'A', 'ttl' : '3600', 'rrdatas' : [ '2.3.4.5' ] }], 'deletions' : [{ 'name' : 'example.com.', 'type' : 'A', 'ttl' : '3600', 'rrdatas' : [ '1.2.3.4' ] }] } try: response = service.changes().create(project=PROJECT_NAME, managedZone=ZONE_NAME, body=BODY).execute() except errors.HttpError, error: print 'An error occurred: %s' % error
Try it!
Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .