Reference documentation and code samples for the Cloud DNS API class Google::Cloud::Dns::Change.
DNS Change
Represents a request containing additions or deletions or records.
Additions and deletions can be done in bulk, in a single atomic
transaction, and take effect at the same time in each authoritative DNS
server.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Cloud DNS API - Class Google::Cloud::Dns::Change (v1.1.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.1.0 (latest)](/ruby/docs/reference/google-cloud-dns/latest/Google-Cloud-Dns-Change)\n- [1.0.0](/ruby/docs/reference/google-cloud-dns/1.0.0/Google-Cloud-Dns-Change)\n- [0.37.0](/ruby/docs/reference/google-cloud-dns/0.37.0/Google-Cloud-Dns-Change)\n- [0.36.1](/ruby/docs/reference/google-cloud-dns/0.36.1/Google-Cloud-Dns-Change)\n- [0.35.1](/ruby/docs/reference/google-cloud-dns/0.35.1/Google-Cloud-Dns-Change) \nReference documentation and code samples for the Cloud DNS API class Google::Cloud::Dns::Change.\n\nDNS Change\n----------\n\nRepresents a request containing additions or deletions or records.\nAdditions and deletions can be done in bulk, in a single atomic\ntransaction, and take effect at the same time in each authoritative DNS\nserver. \n\nInherits\n--------\n\n- Object\n\nExample\n-------\n\n```ruby\nrequire \"google/cloud/dns\"\n\ndns = Google::Cloud::Dns.new\nzone = dns.zone \"example-com\"\nzone.changes.each do |change|\n puts \"Change includes #{change.additions.count} additions \" \\\n \"and #{change.additions.count} deletions.\"\nend\n```\n\nMethods\n-------\n\n### #additions\n\n def additions()\n\nThe records added in this change request.\n\n### #deletions\n\n def deletions()\n\nThe records removed in this change request.\n\n### #done?\n\n def done?() -\u003e Boolean\n\nChecks if the status is `\"done\"`. \n**Returns**\n\n- (Boolean)\n\n### #id\n\n def id()\n\nUnique identifier for the resource; defined by the server.\n\n### #pending?\n\n def pending?() -\u003e Boolean\n\nChecks if the status is `\"pending\"`. \n**Returns**\n\n- (Boolean)\n\n### #refresh!\n\n def refresh!()\n\n**Alias Of** : [#reload!](./Google-Cloud-Dns-Change#Google__Cloud__Dns__Change_reload!_instance_) \nReloads the change with updated status from the DNS service.\n\n### #reload!\n\n def reload!()\n\n**Aliases**\n\n- [#refresh!](./Google-Cloud-Dns-Change#Google__Cloud__Dns__Change_refresh!_instance_) \nReloads the change with updated status from the DNS service.\n\n### #started_at\n\n def started_at()\n\nThe time that this operation was started by the server.\n\n### #status\n\n def status()\n\nStatus of the operation. Values are `\"done\"` and `\"pending\"`.\n\n### #wait_until_done!\n\n def wait_until_done!()\n\nRefreshes the change until the status is `done`.\nThe delay between refreshes will incrementally increase.\n**Example** \n\n```ruby\nrequire \"google/cloud/dns\"\n\ndns = Google::Cloud::Dns.new\nzone = dns.zone \"example-com\"\nchange = zone.change 1234567890\nchange.done? #=\u003e false\nchange.wait_until_done!\nchange.done? #=\u003e true\n```"]]
