feat: Updating warning for UpdateDomain cli command (#7375)

<!-- Describe what has changed in this PR -->
**What changed?**

The UpdateDomain API is (optionally) undergoing changes where it's
administrative functions are being protected by authorization checks and
it's failover / user-facing functionality is being made available in the
new endpoint `Failover`. This - if enforced - may affect users who're
not aware of this change.

<!-- Tell your future self why have you made these changes -->
**Why?**

<!-- How have you verified this change? Tested locally? Added a unit
test? Checked in staging env? -->
**How did you test it?**

<!-- Assuming the worst case, what can be broken when deploying this
change to production? -->
**Potential risks**

<!-- Is it notable for release? e.g. schema updates, configuration or
data migration required? If so, please mention it, and also update
CHANGELOG.md -->
**Release notes**

<!-- Is there any documentation updates should be made for config,
https://cadenceworkflow.io/docs/operation-guide/setup/ ? If so, please
open an PR in https://github.com/cadence-workflow/cadence-docs -->
**Documentation Changes**

Signed-off-by: David Porter <[email protected]>
Signed-off-by: Gaziza Yestemirova <[email protected]>

Author: davidporter-id-au

tools/cli/domain_commands.go

@@ -320,9 +320,16 @@ func (d *domainCLIImpl) UpdateDomain(c *cli.Context) error {
 	updateRequest.SecurityToken = securityToken
 	_, err = d.updateDomain(ctx, updateRequest)
 	if err != nil {
-		if _, ok := err.(*types.EntityNotExistsError); ok {
+		var entityNotExistsErr *types.EntityNotExistsError
+		if errors.As(err, &entityNotExistsErr) {
 			return commoncli.Problem(fmt.Sprintf("Domain %s does not exist.", domainName), err)
 		}
+		var accessDeniedErr *types.AccessDeniedError
+		if errors.As(err, &accessDeniedErr) {
+			fmt.Fprintf(os.Stderr, "WARNING: Update domain operation may not be available for general user use and is reserved for administrative operations.\n")
+			fmt.Fprintf(os.Stderr, "Please use the 'cadence domain failover' cli-command instead for domain management.\n")
+			return commoncli.Problem("Operation UpdateDomain failed due to authorization.", err)
+		}
 		return commoncli.Problem("Operation UpdateDomain failed.", err)
 	}
 	fmt.Printf("Domain %s successfully updated.\n", domainName)