Make Zone compatible with ManagedZone API resource

[ccobham]

When creating a google-cloud-dns Zone object, this library maps properties from an underlying google-api-services-dns ManagedZone response. Not all properties exposed in the REST API / google-api-services-dns library are mapped as would be expected.

I happened to need the visibility field, but at a glance there are a number of additional missing properties (serviceDirectoryConfig, reverseLookupConfig, ...).

Ideally, the google-cloud-dns Zone would expose all of the same properties available in the API or it would provide a handle to the google-api-services-dns ManagedZone.

Were these properties omitted intentionally? If so, is there a recommended way to retrieve them using this library?

Thanks!

• https://cloud.google.com/dns/docs/reference/rest/v1beta2/managedZones#ManagedZone

[lqiu96]

Hi @ccobham, thanks for the question.

Providing some context regarding DNS:

The Java SDK has two DNS libraries available.

1. google-cloud-java/dns: https://github.com/googleapis/google-cloud-java/tree/main/java-dns
2. google-api-java-client-services/dns: https://github.com/googleapis/google-api-java-client-services/tree/main/clients/google-api-services-dns/v1/2.0.0/com/google/api/services/dns

See https://cloud.google.com/apis/docs/client-libraries-explained which hopefully can provide a bit more insight.

Were these properties omitted intentionally? If so, is there a recommended way to retrieve them using this library?

These weren't omitted intentionally. The google-cloud-java/dns is handwritten and hasn't been updated in a while with the changes.

I believe the google-api-java-client-services is being kept up to date with the latest changes. Is possible, would you be able to only use the google-api-java-client-services/dns library? Do you have any need/ requirements to use google-cloud-java/dns?

I know having to re-write and change libraries may be a non-starter and just wanted to see if there are possible workarounds (i.e. using google-api-java-client-services/dns).

[ccobham]

@lqiu96 Thank you for the summary.

As a workaround, I cast the result of DnsOptions::getRpc to DnsRpc and directly retrieved the ManagedZone.

I don't have a hard requirement to use google-cloud-java/dns. I think the interface easier to work with than google-api-java-client-services/dns. It isn't clear to me how a DnsRpc object should be instantiated using google-api-java-client-services/dns directly (this could be user error). There's a lot of logic in google-cloud-java/dns that I think is worth keeping (e.g. retry logic, simpler pagination) and that I'd prefer not to write myself.

Are there any plans to either (a) deprecate google-cloud-java/dns in favor of google-api-java-client-services/dns or (b) update google-cloud-java/dns with the latest API changes?