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 .