Go's semantic import versioning gives a path without a /vN suffix exactly two publishable major versions: v0 and v1. This client rides the shared 8.5.x line, so at the bare path every tag it cut was unpublishable -- v8.5.89 and v8.5.156 both sat on the repo while proxy.golang.org served v1.0.5 and always would. A tag the proxy rejects is not a release, it is a decoration. The host half does NOT move. hanzoai/go-sdk is the path already on the proxy and pkg.go.dev, and renaming it would strand every existing import; adding the suffix does not, because v1 consumers keep resolving v1.0.5 at the old path. That is what the suffix is for. The generator writes the same path into 2,272 doc references, so sdks.yaml's git-repo-id carries it too -- otherwise the next regeneration would tell readers to import a path whose 8.x tags the proxy refuses. And the release workflow now READS the path from go.mod instead of restating it: one spelling, in the file that defines it, so the warm step cannot go on asking for a path nobody publishes.
18 KiB
\DnsAPI
All URIs are relative to https://api.hanzo.ai
| Method | HTTP request | Description |
|---|---|---|
| DeleteDnsZonesByZone | Delete /v1/dns/zones/{zone} | Delete a DNS zone |
| DeleteDnsZonesByZoneRecordsByRecord | Delete /v1/dns/zones/{zone}/records/{record} | Delete a DNS record |
| GetDnsHealth | Get /v1/dns/health | Check the DNS control plane |
| GetDnsZones | Get /v1/dns/zones | List your org's DNS zones |
| GetDnsZonesByZone | Get /v1/dns/zones/{zone} | Read one DNS zone |
| GetDnsZonesByZoneRecords | Get /v1/dns/zones/{zone}/records | List a zone's DNS records |
| GetDnsZonesByZoneRecordsByRecord | Get /v1/dns/zones/{zone}/records/{record} | Read one DNS record |
| PatchDnsZonesByZoneRecordsByRecord | Patch /v1/dns/zones/{zone}/records/{record} | Amend a DNS record |
| PostDnsSync | Post /v1/dns/sync | Push a set of zones and records in one call |
| PostDnsZones | Post /v1/dns/zones | Create a DNS zone |
| PostDnsZonesByZoneRecords | Post /v1/dns/zones/{zone}/records | Create a DNS record |
| PutDnsZonesByZoneRecordsByRecord | Put /v1/dns/zones/{zone}/records/{record} | Amend a DNS record |
DeleteDnsZonesByZone
DeleteDnsZonesByZone(ctx, zone).Execute()
Delete a DNS zone
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
zone := "zone_example" // string |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.DeleteDnsZonesByZone(context.Background(), zone).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.DeleteDnsZonesByZone``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| zone | string |
Other Parameters
Other parameters are passed through a pointer to a apiDeleteDnsZonesByZoneRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
DeleteDnsZonesByZoneRecordsByRecord
DeleteDnsZonesByZoneRecordsByRecord(ctx, zone, record).Execute()
Delete a DNS record
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
zone := "zone_example" // string |
record := "record_example" // string |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.DeleteDnsZonesByZoneRecordsByRecord(context.Background(), zone, record).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.DeleteDnsZonesByZoneRecordsByRecord``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| zone | string | ||
| record | string |
Other Parameters
Other parameters are passed through a pointer to a apiDeleteDnsZonesByZoneRecordsByRecordRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetDnsHealth
GetDnsHealth(ctx).Execute()
Check the DNS control plane
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.GetDnsHealth(context.Background()).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.GetDnsHealth``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
This endpoint does not need any parameter.
Other Parameters
Other parameters are passed through a pointer to a apiGetDnsHealthRequest struct via the builder pattern
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetDnsZones
GetDnsZones(ctx).Execute()
List your org's DNS zones
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.GetDnsZones(context.Background()).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.GetDnsZones``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
This endpoint does not need any parameter.
Other Parameters
Other parameters are passed through a pointer to a apiGetDnsZonesRequest struct via the builder pattern
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetDnsZonesByZone
GetDnsZonesByZone(ctx, zone).Execute()
Read one DNS zone
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
zone := "zone_example" // string |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.GetDnsZonesByZone(context.Background(), zone).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.GetDnsZonesByZone``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| zone | string |
Other Parameters
Other parameters are passed through a pointer to a apiGetDnsZonesByZoneRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetDnsZonesByZoneRecords
GetDnsZonesByZoneRecords(ctx, zone).Execute()
List a zone's DNS records
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
zone := "zone_example" // string |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.GetDnsZonesByZoneRecords(context.Background(), zone).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.GetDnsZonesByZoneRecords``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| zone | string |
Other Parameters
Other parameters are passed through a pointer to a apiGetDnsZonesByZoneRecordsRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetDnsZonesByZoneRecordsByRecord
GetDnsZonesByZoneRecordsByRecord(ctx, zone, record).Execute()
Read one DNS record
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
zone := "zone_example" // string |
record := "record_example" // string |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.GetDnsZonesByZoneRecordsByRecord(context.Background(), zone, record).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.GetDnsZonesByZoneRecordsByRecord``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| zone | string | ||
| record | string |
Other Parameters
Other parameters are passed through a pointer to a apiGetDnsZonesByZoneRecordsByRecordRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PatchDnsZonesByZoneRecordsByRecord
PatchDnsZonesByZoneRecordsByRecord(ctx, zone, record).Execute()
Amend a DNS record
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
zone := "zone_example" // string |
record := "record_example" // string |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.PatchDnsZonesByZoneRecordsByRecord(context.Background(), zone, record).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.PatchDnsZonesByZoneRecordsByRecord``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| zone | string | ||
| record | string |
Other Parameters
Other parameters are passed through a pointer to a apiPatchDnsZonesByZoneRecordsByRecordRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostDnsSync
PostDnsSync(ctx).Execute()
Push a set of zones and records in one call
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.PostDnsSync(context.Background()).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.PostDnsSync``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
This endpoint does not need any parameter.
Other Parameters
Other parameters are passed through a pointer to a apiPostDnsSyncRequest struct via the builder pattern
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostDnsZones
PostDnsZones(ctx).Execute()
Create a DNS zone
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.PostDnsZones(context.Background()).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.PostDnsZones``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
This endpoint does not need any parameter.
Other Parameters
Other parameters are passed through a pointer to a apiPostDnsZonesRequest struct via the builder pattern
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PostDnsZonesByZoneRecords
PostDnsZonesByZoneRecords(ctx, zone).Execute()
Create a DNS record
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
zone := "zone_example" // string |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.PostDnsZonesByZoneRecords(context.Background(), zone).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.PostDnsZonesByZoneRecords``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| zone | string |
Other Parameters
Other parameters are passed through a pointer to a apiPostDnsZonesByZoneRecordsRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
PutDnsZonesByZoneRecordsByRecord
PutDnsZonesByZoneRecordsByRecord(ctx, zone, record).Execute()
Amend a DNS record
Example
package main
import (
"context"
"fmt"
"os"
openapiclient "github.com/hanzoai/go-sdk/v8"
)
func main() {
zone := "zone_example" // string |
record := "record_example" // string |
configuration := openapiclient.NewConfiguration()
apiClient := openapiclient.NewAPIClient(configuration)
r, err := apiClient.DnsAPI.PutDnsZonesByZoneRecordsByRecord(context.Background(), zone, record).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `DnsAPI.PutDnsZonesByZoneRecordsByRecord``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
}
}
Path Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
| zone | string | ||
| record | string |
Other Parameters
Other parameters are passed through a pointer to a apiPutDnsZonesByZoneRecordsByRecordRequest struct via the builder pattern
| Name | Type | Description | Notes |
|---|
Return type
(empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]