# SecondaryZonesApi All URIs are relative to ** | Method | HTTP request | Description | | ----------------------------------------------------- | ---------------------------------------------- | --------------------------- | | [**SecondaryzonesAxfrGet**](#SecondaryzonesAxfrGet) | **Get** /secondaryzones/{secondaryZoneId}/axfr | Get status of zone transfer | | [**SecondaryzonesAxfrPut**](#SecondaryzonesAxfrPut) | **Put** /secondaryzones/{secondaryZoneId}/axfr | Start zone transfer | | [**SecondaryzonesDelete**](#SecondaryzonesDelete) | **Delete** /secondaryzones/{secondaryZoneId} | Delete a secondary zone | | [**SecondaryzonesFindById**](#SecondaryzonesFindById) | **Get** /secondaryzones/{secondaryZoneId} | Retrieve a secondary zone | | [**SecondaryzonesGet**](#SecondaryzonesGet) | **Get** /secondaryzones | Retrieve secondary zones | | [**SecondaryzonesPost**](#SecondaryzonesPost) | **Post** /secondaryzones | Create a secondary zone | | [**SecondaryzonesPut**](#SecondaryzonesPut) | **Put** /secondaryzones/{secondaryZoneId} | Update a secondary zone | ## SecondaryzonesAxfrGet ```go var result ZoneTransferPrimaryIpsStatus = SecondaryzonesAxfrGet(ctx, secondaryZoneId) .Execute() ``` Get status of zone transfer ### Example ```go package main import ( "context" "fmt" "os" ionoscloud "github.com/ionos-cloud/sdk-go-dns" ) func main() { secondaryZoneId := "38400000-8cf0-11bd-b23e-10b96e4ef00d" // string | The ID (UUID) of the DNS zone. configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL") apiClient := ionoscloud.NewAPIClient(configuration) resource, resp, err := apiClient.SecondaryZonesApi.SecondaryzonesAxfrGet(context.Background(), secondaryZoneId).Execute() if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `SecondaryZonesApi.SecondaryzonesAxfrGet``: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp) } // response from `SecondaryzonesAxfrGet`: ZoneTransferPrimaryIpsStatus fmt.Fprintf(os.Stdout, "Response from `SecondaryZonesApi.SecondaryzonesAxfrGet`: %v\n", resource) } ``` ### Path Parameters | Name | Type | Description | Notes | | ------------------- | ------------------- | --------------------------------------------------------------------------- | ----- | | **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. | | | **secondaryZoneId** | **string** | The ID (UUID) of the DNS zone. | | ### Other Parameters Other parameters are passed through a pointer to an apiSecondaryzonesAxfrGetRequest struct via the builder pattern ### Return type [**ZoneTransferPrimaryIpsStatus**](https://docs.ionos.com/sections-test/go-sdk/dns-go-sdk/models/zonetransferprimaryipsstatus) ### HTTP request headers * **Content-Type**: Not defined * **Accept**: application/json ### URLs Configuration per Operation Each operation can use different server URL defined using `OperationServers` map in the `Configuration`. An operation is uniquely identified by `"SecondaryZonesApiService.SecondaryzonesAxfrGet"` string. Similar rules for overriding default operation server index and variables apply by using `sw.ContextOperationServerIndices` and `sw.ContextOperationServerVariables` context maps. ```golang ctx := context.WithValue(context.Background(), {packageName}.ContextOperationServerIndices, map[string]int{ "SecondaryZonesApiService.SecondaryzonesAxfrGet": 2, }) ctx = context.WithValue(context.Background(), {packageName}.ContextOperationServerVariables, map[string]map[string]string{ "SecondaryZonesApiService.SecondaryzonesAxfrGet": { "port": "8443", }, }) ``` ## SecondaryzonesAxfrPut ```go var result map[string]interface{} = SecondaryzonesAxfrPut(ctx, secondaryZoneId) .Execute() ``` Start zone transfer ### Example ```go package main import ( "context" "fmt" "os" ionoscloud "github.com/ionos-cloud/sdk-go-dns" ) func main() { secondaryZoneId := "38400000-8cf0-11bd-b23e-10b96e4ef00d" // string | The ID (UUID) of the DNS zone. configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL") apiClient := ionoscloud.NewAPIClient(configuration) resource, resp, err := apiClient.SecondaryZonesApi.SecondaryzonesAxfrPut(context.Background(), secondaryZoneId).Execute() if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `SecondaryZonesApi.SecondaryzonesAxfrPut``: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp) } // response from `SecondaryzonesAxfrPut`: map[string]interface{} fmt.Fprintf(os.Stdout, "Response from `SecondaryZonesApi.SecondaryzonesAxfrPut`: %v\n", resource) } ``` ### Path Parameters | Name | Type | Description | Notes | | ------------------- | ------------------- | --------------------------------------------------------------------------- | ----- | | **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. | | | **secondaryZoneId** | **string** | The ID (UUID) of the DNS zone. | | ### Other Parameters Other parameters are passed through a pointer to an apiSecondaryzonesAxfrPutRequest struct via the builder pattern ### Return type **map\[string]interface{}** ### HTTP request headers * **Content-Type**: Not defined * **Accept**: application/json ### URLs Configuration per Operation Each operation can use different server URL defined using `OperationServers` map in the `Configuration`. An operation is uniquely identified by `"SecondaryZonesApiService.SecondaryzonesAxfrPut"` string. Similar rules for overriding default operation server index and variables apply by using `sw.ContextOperationServerIndices` and `sw.ContextOperationServerVariables` context maps. ```golang ctx := context.WithValue(context.Background(), {packageName}.ContextOperationServerIndices, map[string]int{ "SecondaryZonesApiService.SecondaryzonesAxfrPut": 2, }) ctx = context.WithValue(context.Background(), {packageName}.ContextOperationServerVariables, map[string]map[string]string{ "SecondaryZonesApiService.SecondaryzonesAxfrPut": { "port": "8443", }, }) ``` ## SecondaryzonesDelete ```go var result map[string]interface{} = SecondaryzonesDelete(ctx, secondaryZoneId) .Execute() ``` Delete a secondary zone ### Example ```go package main import ( "context" "fmt" "os" ionoscloud "github.com/ionos-cloud/sdk-go-dns" ) func main() { secondaryZoneId := "38400000-8cf0-11bd-b23e-10b96e4ef00d" // string | The ID (UUID) of the DNS zone. configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL") apiClient := ionoscloud.NewAPIClient(configuration) resp, err := apiClient.SecondaryZonesApi.SecondaryzonesDelete(context.Background(), secondaryZoneId).Execute() if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `SecondaryZonesApi.SecondaryzonesDelete``: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp) } // response from `SecondaryzonesDelete`: map[string]interface{} fmt.Fprintf(os.Stdout, "Response from `SecondaryZonesApi.SecondaryzonesDelete`: %v\n", resource) } ``` ### Path Parameters | Name | Type | Description | Notes | | ------------------- | ------------------- | --------------------------------------------------------------------------- | ----- | | **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. | | | **secondaryZoneId** | **string** | The ID (UUID) of the DNS zone. | | ### Other Parameters Other parameters are passed through a pointer to an apiSecondaryzonesDeleteRequest struct via the builder pattern ### Return type **map\[string]interface{}** ### HTTP request headers * **Content-Type**: Not defined * **Accept**: application/json ### URLs Configuration per Operation Each operation can use different server URL defined using `OperationServers` map in the `Configuration`. An operation is uniquely identified by `"SecondaryZonesApiService.SecondaryzonesDelete"` string. Similar rules for overriding default operation server index and variables apply by using `sw.ContextOperationServerIndices` and `sw.ContextOperationServerVariables` context maps. ```golang ctx := context.WithValue(context.Background(), {packageName}.ContextOperationServerIndices, map[string]int{ "SecondaryZonesApiService.SecondaryzonesDelete": 2, }) ctx = context.WithValue(context.Background(), {packageName}.ContextOperationServerVariables, map[string]map[string]string{ "SecondaryZonesApiService.SecondaryzonesDelete": { "port": "8443", }, }) ``` ## SecondaryzonesFindById ```go var result SecondaryZoneRead = SecondaryzonesFindById(ctx, secondaryZoneId) .Execute() ``` Retrieve a secondary zone ### Example ```go package main import ( "context" "fmt" "os" ionoscloud "github.com/ionos-cloud/sdk-go-dns" ) func main() { secondaryZoneId := "38400000-8cf0-11bd-b23e-10b96e4ef00d" // string | The ID (UUID) of the DNS zone. configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL") apiClient := ionoscloud.NewAPIClient(configuration) resource, resp, err := apiClient.SecondaryZonesApi.SecondaryzonesFindById(context.Background(), secondaryZoneId).Execute() if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `SecondaryZonesApi.SecondaryzonesFindById``: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp) } // response from `SecondaryzonesFindById`: SecondaryZoneRead fmt.Fprintf(os.Stdout, "Response from `SecondaryZonesApi.SecondaryzonesFindById`: %v\n", resource) } ``` ### Path Parameters | Name | Type | Description | Notes | | ------------------- | ------------------- | --------------------------------------------------------------------------- | ----- | | **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. | | | **secondaryZoneId** | **string** | The ID (UUID) of the DNS zone. | | ### Other Parameters Other parameters are passed through a pointer to an apiSecondaryzonesFindByIdRequest struct via the builder pattern ### Return type [**SecondaryZoneRead**](https://docs.ionos.com/sections-test/go-sdk/dns-go-sdk/models/secondaryzoneread) ### HTTP request headers * **Content-Type**: Not defined * **Accept**: application/json ### URLs Configuration per Operation Each operation can use different server URL defined using `OperationServers` map in the `Configuration`. An operation is uniquely identified by `"SecondaryZonesApiService.SecondaryzonesFindById"` string. Similar rules for overriding default operation server index and variables apply by using `sw.ContextOperationServerIndices` and `sw.ContextOperationServerVariables` context maps. ```golang ctx := context.WithValue(context.Background(), {packageName}.ContextOperationServerIndices, map[string]int{ "SecondaryZonesApiService.SecondaryzonesFindById": 2, }) ctx = context.WithValue(context.Background(), {packageName}.ContextOperationServerVariables, map[string]map[string]string{ "SecondaryZonesApiService.SecondaryzonesFindById": { "port": "8443", }, }) ``` ## SecondaryzonesGet ```go var result SecondaryZoneReadList = SecondaryzonesGet(ctx) .FilterState(filterState) .FilterZoneName(filterZoneName) .Offset(offset) .Limit(limit) .Execute() ``` Retrieve secondary zones ### Example ```go package main import ( "context" "fmt" "os" ionoscloud "github.com/ionos-cloud/sdk-go-dns" ) func main() { filterState := openapiclient.ProvisioningState("PROVISIONING") // ProvisioningState | Filter used to fetch all zones in a particular state. (optional) filterZoneName := "example.com" // string | Filter used to fetch only the zones that contain the specified zone name. (optional) offset := int32(56) // int32 | The first element (of the total list of elements) to include in the response. Use together with limit for pagination. (optional) (default to 0) limit := int32(56) // int32 | The maximum number of elements to return. Use together with offset for pagination. (optional) (default to 100) configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL") apiClient := ionoscloud.NewAPIClient(configuration) resource, resp, err := apiClient.SecondaryZonesApi.SecondaryzonesGet(context.Background()).FilterState(filterState).FilterZoneName(filterZoneName).Offset(offset).Limit(limit).Execute() if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `SecondaryZonesApi.SecondaryzonesGet``: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp) } // response from `SecondaryzonesGet`: SecondaryZoneReadList fmt.Fprintf(os.Stdout, "Response from `SecondaryZonesApi.SecondaryzonesGet`: %v\n", resource) } ``` ### Path Parameters ### Other Parameters Other parameters are passed through a pointer to an apiSecondaryzonesGetRequest struct via the builder pattern | Name | Type | Description | Notes | | ------------------ | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ----------------- | | **filterState** | [**ProvisioningState**](https://github.com/ionos-cloud/sdk-go-dns/blob/master/docs/models/.md/README.md) | Filter used to fetch all zones in a particular state. | | | **filterZoneName** | **string** | Filter used to fetch only the zones that contain the specified zone name. | | | **offset** | **int32** | The first element (of the total list of elements) to include in the response. Use together with limit for pagination. | \[default to 0] | | **limit** | **int32** | The maximum number of elements to return. Use together with offset for pagination. | \[default to 100] | ### Return type [**SecondaryZoneReadList**](https://docs.ionos.com/sections-test/go-sdk/dns-go-sdk/models/secondaryzonereadlist) ### HTTP request headers * **Content-Type**: Not defined * **Accept**: application/json ### URLs Configuration per Operation Each operation can use different server URL defined using `OperationServers` map in the `Configuration`. An operation is uniquely identified by `"SecondaryZonesApiService.SecondaryzonesGet"` string. Similar rules for overriding default operation server index and variables apply by using `sw.ContextOperationServerIndices` and `sw.ContextOperationServerVariables` context maps. ```golang ctx := context.WithValue(context.Background(), {packageName}.ContextOperationServerIndices, map[string]int{ "SecondaryZonesApiService.SecondaryzonesGet": 2, }) ctx = context.WithValue(context.Background(), {packageName}.ContextOperationServerVariables, map[string]map[string]string{ "SecondaryZonesApiService.SecondaryzonesGet": { "port": "8443", }, }) ``` ## SecondaryzonesPost ```go var result SecondaryZoneRead = SecondaryzonesPost(ctx) .SecondaryZoneCreate(secondaryZoneCreate) .Execute() ``` Create a secondary zone ### Example ```go package main import ( "context" "fmt" "os" ionoscloud "github.com/ionos-cloud/sdk-go-dns" ) func main() { secondaryZoneCreate := *openapiclient.NewSecondaryZoneCreate(*openapiclient.NewSecondaryZone("example.com", []string{"PrimaryIps_example"})) // SecondaryZoneCreate | zone configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL") apiClient := ionoscloud.NewAPIClient(configuration) resource, resp, err := apiClient.SecondaryZonesApi.SecondaryzonesPost(context.Background()).SecondaryZoneCreate(secondaryZoneCreate).Execute() if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `SecondaryZonesApi.SecondaryzonesPost``: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp) } // response from `SecondaryzonesPost`: SecondaryZoneRead fmt.Fprintf(os.Stdout, "Response from `SecondaryZonesApi.SecondaryzonesPost`: %v\n", resource) } ``` ### Path Parameters ### Other Parameters Other parameters are passed through a pointer to an apiSecondaryzonesPostRequest struct via the builder pattern | Name | Type | Description | Notes | | ----------------------- | ------------------------------------------------------------------------------------------------------------ | ----------- | ----- | | **secondaryZoneCreate** | [**SecondaryZoneCreate**](https://docs.ionos.com/sections-test/go-sdk/dns-go-sdk/models/secondaryzonecreate) | zone | | ### Return type [**SecondaryZoneRead**](https://docs.ionos.com/sections-test/go-sdk/dns-go-sdk/models/secondaryzoneread) ### HTTP request headers * **Content-Type**: application/json * **Accept**: application/json ### URLs Configuration per Operation Each operation can use different server URL defined using `OperationServers` map in the `Configuration`. An operation is uniquely identified by `"SecondaryZonesApiService.SecondaryzonesPost"` string. Similar rules for overriding default operation server index and variables apply by using `sw.ContextOperationServerIndices` and `sw.ContextOperationServerVariables` context maps. ```golang ctx := context.WithValue(context.Background(), {packageName}.ContextOperationServerIndices, map[string]int{ "SecondaryZonesApiService.SecondaryzonesPost": 2, }) ctx = context.WithValue(context.Background(), {packageName}.ContextOperationServerVariables, map[string]map[string]string{ "SecondaryZonesApiService.SecondaryzonesPost": { "port": "8443", }, }) ``` ## SecondaryzonesPut ```go var result SecondaryZoneRead = SecondaryzonesPut(ctx, secondaryZoneId) .SecondaryZoneEnsure(secondaryZoneEnsure) .Execute() ``` Update a secondary zone ### Example ```go package main import ( "context" "fmt" "os" ionoscloud "github.com/ionos-cloud/sdk-go-dns" ) func main() { secondaryZoneId := "38400000-8cf0-11bd-b23e-10b96e4ef00d" // string | The ID (UUID) of the DNS zone. secondaryZoneEnsure := *openapiclient.NewSecondaryZoneEnsure(*openapiclient.NewSecondaryZone("example.com", []string{"PrimaryIps_example"})) // SecondaryZoneEnsure | update zone configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL") apiClient := ionoscloud.NewAPIClient(configuration) resource, resp, err := apiClient.SecondaryZonesApi.SecondaryzonesPut(context.Background(), secondaryZoneId).SecondaryZoneEnsure(secondaryZoneEnsure).Execute() if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `SecondaryZonesApi.SecondaryzonesPut``: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp) } // response from `SecondaryzonesPut`: SecondaryZoneRead fmt.Fprintf(os.Stdout, "Response from `SecondaryZonesApi.SecondaryzonesPut`: %v\n", resource) } ``` ### Path Parameters | Name | Type | Description | Notes | | ------------------- | ------------------- | --------------------------------------------------------------------------- | ----- | | **ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc. | | | **secondaryZoneId** | **string** | The ID (UUID) of the DNS zone. | | ### Other Parameters Other parameters are passed through a pointer to an apiSecondaryzonesPutRequest struct via the builder pattern | Name | Type | Description | Notes | | ----------------------- | ------------------------------------------------------------------------------------------------------------ | ----------- | ----- | | **secondaryZoneEnsure** | [**SecondaryZoneEnsure**](https://docs.ionos.com/sections-test/go-sdk/dns-go-sdk/models/secondaryzoneensure) | update zone | | ### Return type [**SecondaryZoneRead**](https://docs.ionos.com/sections-test/go-sdk/dns-go-sdk/models/secondaryzoneread) ### HTTP request headers * **Content-Type**: application/json * **Accept**: application/json ### URLs Configuration per Operation Each operation can use different server URL defined using `OperationServers` map in the `Configuration`. An operation is uniquely identified by `"SecondaryZonesApiService.SecondaryzonesPut"` string. Similar rules for overriding default operation server index and variables apply by using `sw.ContextOperationServerIndices` and `sw.ContextOperationServerVariables` context maps. ```golang ctx := context.WithValue(context.Background(), {packageName}.ContextOperationServerIndices, map[string]int{ "SecondaryZonesApiService.SecondaryzonesPut": 2, }) ctx = context.WithValue(context.Background(), {packageName}.ContextOperationServerVariables, map[string]map[string]string{ "SecondaryZonesApiService.SecondaryzonesPut": { "port": "8443", }, }) ```