Public IP Addresses

A PublicIPAddress is an IP address that app.files.com (or *.files.com) may potentially resolve to over the next 30 days. This list includes IP addresses that are hot standbys not in use.

List all possible public IP addresses

SDK Method

ip_address.GetReserved()

Return Values

Returns a *ip_address.Iter and an error. All() returns iter.Seq2[any, error] because this package has listings that return different resource types. This operation yields files_sdk.PublicIpAddress values. Use a type assertion or type switch to access their fields. Check each loop error before using its resource. Next() and Err() remain supported.

Authorization Requirement

No authentication required; you may call this endpoint without a key or session.

Additional Arguments

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    ip_address "github.com/Files-com/files-sdk-go/v3/ipaddress"
)

publicIpAddressIterator, err := ip_address.GetReserved(files_sdk.IpAddressGetReservedParams{})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Printf("API error (%s): %s\n", respErr.Type, respErr.ErrorMessage)
    } else {
        fmt.Printf("Request failed: %v\n", err)
    }
    return
}

for publicIpAddress, err := range publicIpAddressIterator.All() {
    if err != nil {
        var respErr files_sdk.ResponseError
        if errors.As(err, &respErr) {
            fmt.Printf("API error (%s): %s\n", respErr.Type, respErr.ErrorMessage)
        } else {
            fmt.Printf("Request failed: %v\n", err)
        }
        return
    }
    switch address := publicIpAddress.(type) {
    case files_sdk.IpAddress:
        fmt.Println(address.IpAddresses)
    case files_sdk.PublicIpAddress:
        fmt.Println(address.IpAddress)
    }
}

List all possible public ExaVault IP addresses

SDK Method

ip_address.GetExavaultReserved()

Return Values

Returns a *ip_address.Iter and an error. All() returns iter.Seq2[any, error] because this package has listings that return different resource types. This operation yields files_sdk.PublicIpAddress values. Use a type assertion or type switch to access their fields. Check each loop error before using its resource. Next() and Err() remain supported.

Authorization Requirement

No authentication required; you may call this endpoint without a key or session.

Additional Arguments

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    ip_address "github.com/Files-com/files-sdk-go/v3/ipaddress"
)

publicIpAddressIterator, err := ip_address.GetExavaultReserved(files_sdk.IpAddressGetExavaultReservedParams{})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Printf("API error (%s): %s\n", respErr.Type, respErr.ErrorMessage)
    } else {
        fmt.Printf("Request failed: %v\n", err)
    }
    return
}

for publicIpAddress, err := range publicIpAddressIterator.All() {
    if err != nil {
        var respErr files_sdk.ResponseError
        if errors.As(err, &respErr) {
            fmt.Printf("API error (%s): %s\n", respErr.Type, respErr.ErrorMessage)
        } else {
            fmt.Printf("Request failed: %v\n", err)
        }
        return
    }
    switch address := publicIpAddress.(type) {
    case files_sdk.IpAddress:
        fmt.Println(address.IpAddresses)
    case files_sdk.PublicIpAddress:
        fmt.Println(address.IpAddress)
    }
}

List all possible public SmartFile IP addresses

SDK Method

ip_address.GetSmartfileReserved()

Return Values

Returns a *ip_address.Iter and an error. All() returns iter.Seq2[any, error] because this package has listings that return different resource types. This operation yields files_sdk.PublicIpAddress values. Use a type assertion or type switch to access their fields. Check each loop error before using its resource. Next() and Err() remain supported.

Authorization Requirement

No authentication required; you may call this endpoint without a key or session.

Additional Arguments

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    ip_address "github.com/Files-com/files-sdk-go/v3/ipaddress"
)

publicIpAddressIterator, err := ip_address.GetSmartfileReserved(files_sdk.IpAddressGetSmartfileReservedParams{})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Printf("API error (%s): %s\n", respErr.Type, respErr.ErrorMessage)
    } else {
        fmt.Printf("Request failed: %v\n", err)
    }
    return
}

for publicIpAddress, err := range publicIpAddressIterator.All() {
    if err != nil {
        var respErr files_sdk.ResponseError
        if errors.As(err, &respErr) {
            fmt.Printf("API error (%s): %s\n", respErr.Type, respErr.ErrorMessage)
        } else {
            fmt.Printf("Request failed: %v\n", err)
        }
        return
    }
    switch address := publicIpAddress.(type) {
    case files_sdk.IpAddress:
        fmt.Println(address.IpAddresses)
    case files_sdk.PublicIpAddress:
        fmt.Println(address.IpAddress)
    }
}

The PublicIpAddress Object

Some of the methods above return a PublicIpAddress object. The attributes of this object are listed below.

AttributeDescription
IpAddress
string		The public IP address.
ServerName
string		The name of the frontend server.
FtpEnabled
boolean
SftpEnabled
boolean