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 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)
    }
}

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 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)
    }
}

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