All URIs are relative to https://dns.de-fra.ionos.com
Method | HTTP request | Description |
---|---|---|
RecordsGet | Get /records | Retrieve all records |
ZonesRecordsDelete | Delete /zones/{zoneId}/records/{recordId} | Delete a record |
ZonesRecordsFindById | Get /zones/{zoneId}/records/{recordId} | Retrieve a record |
ZonesRecordsGet | Get /zones/{zoneId}/records | Retrieve records |
ZonesRecordsPost | Post /zones/{zoneId}/records | Create a record |
ZonesRecordsPut | Put /zones/{zoneId}/records/{recordId} | Ensure a record |
var result RecordReadList = RecordsGet(ctx)
.FilterZoneId(filterZoneId)
.FilterName(filterName)
.FilterState(filterState)
.Offset(offset)
.Limit(limit)
.Execute()
Retrieve all records
package main
import (
"context"
"fmt"
"os"
ionoscloud "github.com/ionos-cloud/sdk-go-dns"
)
func main() {
filterZoneId := TODO // string | Filter used to fetch only the records that contain specified zoneId. (optional)
filterName := "app" // string | Filter used to fetch only the records that contain specified record name. (optional)
filterState := openapiclient.ProvisioningState("PROVISIONING") // ProvisioningState | Filter used to fetch only the records that are in certain state. (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.RecordsApi.RecordsGet(context.Background()).FilterZoneId(filterZoneId).FilterName(filterName).FilterState(filterState).Offset(offset).Limit(limit).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `RecordsApi.RecordsGet``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp)
}
// response from `RecordsGet`: RecordReadList
fmt.Fprintf(os.Stdout, "Response from `RecordsApi.RecordsGet`: %v\n", resource)
}
Other parameters are passed through a pointer to an apiRecordsGetRequest struct via the builder pattern
Name | Type | Description | Notes |
---|---|---|---|
filterZoneId | string | Filter used to fetch only the records that contain specified zoneId. | |
filterName | string | Filter used to fetch only the records that contain specified record name. | |
filterState | ProvisioningState | Filter used to fetch only the records that are in certain state. | |
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] |
- Content-Type: Not defined
- Accept: application/json
var result = ZonesRecordsDelete(ctx, zoneId, recordId)
.Execute()
Delete a record
package main
import (
"context"
"fmt"
"os"
ionoscloud "github.com/ionos-cloud/sdk-go-dns"
)
func main() {
zoneId := TODO // string | The ID (UUID) of the DNS zone.
recordId := TODO // string | The ID (UUID) of the record.
configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL")
apiClient := ionoscloud.NewAPIClient(configuration)
resp, err := apiClient.RecordsApi.ZonesRecordsDelete(context.Background(), zoneId, recordId).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `RecordsApi.ZonesRecordsDelete``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp)
}
}
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
zoneId | string | The ID (UUID) of the DNS zone. | |
recordId | string | The ID (UUID) of the record. |
Other parameters are passed through a pointer to an apiZonesRecordsDeleteRequest struct via the builder pattern
Name | Type | Description | Notes |
---|
(empty response body)
- Content-Type: Not defined
- Accept: application/json
var result RecordRead = ZonesRecordsFindById(ctx, zoneId, recordId)
.Execute()
Retrieve a record
package main
import (
"context"
"fmt"
"os"
ionoscloud "github.com/ionos-cloud/sdk-go-dns"
)
func main() {
zoneId := TODO // string | The ID (UUID) of the DNS zone.
recordId := TODO // string | The ID (UUID) of the record.
configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL")
apiClient := ionoscloud.NewAPIClient(configuration)
resource, resp, err := apiClient.RecordsApi.ZonesRecordsFindById(context.Background(), zoneId, recordId).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `RecordsApi.ZonesRecordsFindById``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp)
}
// response from `ZonesRecordsFindById`: RecordRead
fmt.Fprintf(os.Stdout, "Response from `RecordsApi.ZonesRecordsFindById`: %v\n", resource)
}
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
zoneId | string | The ID (UUID) of the DNS zone. | |
recordId | string | The ID (UUID) of the record. |
Other parameters are passed through a pointer to an apiZonesRecordsFindByIdRequest struct via the builder pattern
Name | Type | Description | Notes |
---|
- Content-Type: Not defined
- Accept: application/json
var result RecordReadList = ZonesRecordsGet(ctx, zoneId)
.Execute()
Retrieve records
package main
import (
"context"
"fmt"
"os"
ionoscloud "github.com/ionos-cloud/sdk-go-dns"
)
func main() {
zoneId := TODO // string | The ID (UUID) of the DNS zone.
configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL")
apiClient := ionoscloud.NewAPIClient(configuration)
resource, resp, err := apiClient.RecordsApi.ZonesRecordsGet(context.Background(), zoneId).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `RecordsApi.ZonesRecordsGet``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp)
}
// response from `ZonesRecordsGet`: RecordReadList
fmt.Fprintf(os.Stdout, "Response from `RecordsApi.ZonesRecordsGet`: %v\n", resource)
}
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
zoneId | string | The ID (UUID) of the DNS zone. |
Other parameters are passed through a pointer to an apiZonesRecordsGetRequest struct via the builder pattern
Name | Type | Description | Notes |
---|
- Content-Type: Not defined
- Accept: application/json
var result RecordRead = ZonesRecordsPost(ctx, zoneId)
.RecordCreate(recordCreate)
.Execute()
Create a record
package main
import (
"context"
"fmt"
"os"
ionoscloud "github.com/ionos-cloud/sdk-go-dns"
)
func main() {
zoneId := TODO // string | The ID (UUID) of the DNS zone.
recordCreate := *openapiclient.NewRecordCreate(*openapiclient.NewRecord("app", "Type_example", "1.2.3.4")) // RecordCreate | record
configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL")
apiClient := ionoscloud.NewAPIClient(configuration)
resource, resp, err := apiClient.RecordsApi.ZonesRecordsPost(context.Background(), zoneId).RecordCreate(recordCreate).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `RecordsApi.ZonesRecordsPost``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp)
}
// response from `ZonesRecordsPost`: RecordRead
fmt.Fprintf(os.Stdout, "Response from `RecordsApi.ZonesRecordsPost`: %v\n", resource)
}
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
zoneId | string | The ID (UUID) of the DNS zone. |
Other parameters are passed through a pointer to an apiZonesRecordsPostRequest struct via the builder pattern
Name | Type | Description | Notes |
---|---|---|---|
recordCreate | RecordCreate | record |
- Content-Type: application/json
- Accept: application/json
var result RecordRead = ZonesRecordsPut(ctx, zoneId, recordId)
.RecordEnsure(recordEnsure)
.Execute()
Ensure a record
package main
import (
"context"
"fmt"
"os"
ionoscloud "github.com/ionos-cloud/sdk-go-dns"
)
func main() {
zoneId := TODO // string | The ID (UUID) of the DNS zone.
recordId := TODO // string | The ID (UUID) of the DNS record.
recordEnsure := *openapiclient.NewRecordEnsure(*openapiclient.NewRecord("app", "Type_example", "1.2.3.4")) // RecordEnsure |
configuration := ionoscloud.NewConfiguration("USERNAME", "PASSWORD", "TOKEN", "HOST_URL")
apiClient := ionoscloud.NewAPIClient(configuration)
resource, resp, err := apiClient.RecordsApi.ZonesRecordsPut(context.Background(), zoneId, recordId).RecordEnsure(recordEnsure).Execute()
if err != nil {
fmt.Fprintf(os.Stderr, "Error when calling `RecordsApi.ZonesRecordsPut``: %v\n", err)
fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", resp)
}
// response from `ZonesRecordsPut`: RecordRead
fmt.Fprintf(os.Stdout, "Response from `RecordsApi.ZonesRecordsPut`: %v\n", resource)
}
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
zoneId | string | The ID (UUID) of the DNS zone. | |
recordId | string | The ID (UUID) of the DNS record. |
Other parameters are passed through a pointer to an apiZonesRecordsPutRequest struct via the builder pattern
Name | Type | Description | Notes |
---|---|---|---|
recordEnsure | RecordEnsure |
- Content-Type: application/json
- Accept: application/json