User given friendly name of the policy addressed by this request.
Query parameters
Parameters
clientOperationId
string
For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
[[["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-08-08 UTC."],[[["\u003cp\u003eThis webpage details how to update an existing DNS Policy using a \u003ccode\u003ePUT\u003c/code\u003e HTTP request to the specified URL.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL requires two path parameters: \u003ccode\u003eproject\u003c/code\u003e, which identifies the project, and \u003ccode\u003epolicy\u003c/code\u003e, which is the user-given name of the policy being updated.\u003c/p\u003e\n"],["\u003cp\u003eAn optional \u003ccode\u003eclientOperationId\u003c/code\u003e can be included as a query parameter for identifying mutating operations.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain an instance of the \u003ccode\u003ePolicy\u003c/code\u003e resource, and a successful response will also contain a \u003ccode\u003epolicy\u003c/code\u003e object in the JSON format.\u003c/p\u003e\n"],["\u003cp\u003eUpdating a policy requires one of two authorization scopes: \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/ndev.clouddns.readwrite\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: policies.update\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.PoliciesUpdateResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nUpdates an existing policy.\n\n### HTTP request\n\n`PUT https://dns.googleapis.com/dns/v1/projects/{project}/policies/{policy}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Policy](/dns/docs/reference/rest/v1/policies#Policy).\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/ndev.clouddns.readwrite`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]