package
1.18.2
Repository: https://github.com/5gcorenet/openapi.git
Documentation: pkg.go.dev

# README

Go API client for openapi_ComDefs

OAS 3.0.1 specification of common type definitions in the Generic NRM © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved.

Overview

This API client was generated by the OpenAPI Generator project. By using the OpenAPI-spec from a remote server, you can easily generate an API client.

  • API version: 18.1.0
  • Package version: 1.0.0
  • Build package: org.openapitools.codegen.languages.GoClientCodegen

Installation

Install the following dependencies:

go get github.com/stretchr/testify/assert
go get golang.org/x/net/context

Put the package under your project folder and add the following in import:

import openapi_ComDefs "github.com/GIT_USER_ID/GIT_REPO_ID/openapi_ComDefs"

To use a proxy, set the environment variable HTTP_PROXY:

os.Setenv("HTTP_PROXY", "http://proxy_name:proxy_port")

Configuration of Server URL

Default configuration comes with Servers field that contains server objects as defined in the OpenAPI specification.

Select Server Configuration

For using other server than the one defined on index 0 set context value sw.ContextServerIndex of type int.

ctx := context.WithValue(context.Background(), openapi_ComDefs.ContextServerIndex, 1)

Templated Server URL

Templated server URL is formatted using default variables from configuration or from context value sw.ContextServerVariables of type map[string]string.

ctx := context.WithValue(context.Background(), openapi_ComDefs.ContextServerVariables, map[string]string{
	"basePath": "v2",
})

Note, enum values are always validated and all unused variables are silently ignored.

URLs Configuration per Operation

Each operation can use different server URL defined using OperationServers map in the Configuration. An operation is uniquely identified by "{classname}Service.{nickname}" string. Similar rules for overriding default operation server index and variables applies by using sw.ContextOperationServerIndices and sw.ContextOperationServerVariables context maps.

ctx := context.WithValue(context.Background(), openapi_ComDefs.ContextOperationServerIndices, map[string]int{
	"{classname}Service.{nickname}": 2,
})
ctx = context.WithValue(context.Background(), openapi_ComDefs.ContextOperationServerVariables, map[string]map[string]string{
	"{classname}Service.{nickname}": {
		"port": "8443",
	},
})

Documentation for API Endpoints

All URIs are relative to http://localhost

ClassMethodHTTP requestDescription

Documentation For Models

Documentation For Authorization

Endpoints do not require authorization.

Documentation for Utility Methods

Due to the fact that model structure members are all pointers, this package contains a number of utility functions to easily obtain pointers to values of basic types. Each of these functions takes a value of the given basic type and returns a pointer to it:

  • PtrBool
  • PtrInt
  • PtrInt32
  • PtrInt64
  • PtrFloat
  • PtrFloat32
  • PtrFloat64
  • PtrString
  • PtrTime

Author

# Functions

AlarmNotificationTypesAsNotificationType is a convenience function that returns AlarmNotificationTypes wrapped in NotificationType.
[]int32AsAreaOfInterest is a convenience function that returns []int32 wrapped in AreaOfInterest.
[]stringAsAreaOfInterest is a convenience function that returns []string wrapped in AreaOfInterest.
[]TaiAsAreaOfInterest is a convenience function that returns []Tai wrapped in AreaOfInterest.
CacheExpires helper function to determine remaining time before repeating a request.
CmNotificationTypesAsNotificationType is a convenience function that returns CmNotificationTypes wrapped in NotificationType.
FileNotificationTypesAsNotificationType is a convenience function that returns FileNotificationTypes wrapped in NotificationType.
GeoAreaToCellMappingAsAreaOfInterest is a convenience function that returns GeoAreaToCellMapping wrapped in AreaOfInterest.
HeartbeatNotificationTypesAsNotificationType is a convenience function that returns HeartbeatNotificationTypes wrapped in NotificationType.
IpAddrAsHost is a convenience function that returns IpAddr wrapped in Host.
Ipv6AddrAsHostAddr is a convenience function that returns Ipv6Addr wrapped in HostAddr.
Ipv6AddrAsIpAddr is a convenience function that returns Ipv6Addr wrapped in IpAddr.
IsNil checks if an input is nil.
NewAdministrativeStateFromValue returns a pointer to a valid AdministrativeState for the value passed as argument, or an error if the value passed is not allowed by the enum.
NewAlarmNotificationTypesFromValue returns a pointer to a valid AlarmNotificationTypes for the value passed as argument, or an error if the value passed is not allowed by the enum.
NewAPIClient creates a new API client.
NewAPIResponse returns a new APIResponse object.
NewAPIResponseWithError returns a new APIResponse object with the provided error message.
NewCmNotificationTypesFromValue returns a pointer to a valid CmNotificationTypes for the value passed as argument, or an error if the value passed is not allowed by the enum.
NewConfiguration returns a new Configuration object.
NewErrorResponse instantiates a new ErrorResponse object This constructor will assign default values to properties that have it defined, and makes sure properties required by API are set, but the set of arguments will change when the set of required properties is changed.
NewErrorResponseError instantiates a new ErrorResponseError object This constructor will assign default values to properties that have it defined, and makes sure properties required by API are set, but the set of arguments will change when the set of required properties is changed.
NewErrorResponseErrorWithDefaults instantiates a new ErrorResponseError object This constructor will only assign default values to properties that have it defined, but it doesn't guarantee that properties required by API are set.
NewErrorResponseWithDefaults instantiates a new ErrorResponse object This constructor will only assign default values to properties that have it defined, but it doesn't guarantee that properties required by API are set.
NewFileNotificationTypesFromValue returns a pointer to a valid FileNotificationTypes for the value passed as argument, or an error if the value passed is not allowed by the enum.
NewGeoArea instantiates a new GeoArea object This constructor will assign default values to properties that have it defined, and makes sure properties required by API are set, but the set of arguments will change when the set of required properties is changed.
NewGeoAreaToCellMapping instantiates a new GeoAreaToCellMapping object This constructor will assign default values to properties that have it defined, and makes sure properties required by API are set, but the set of arguments will change when the set of required properties is changed.
NewGeoAreaToCellMappingWithDefaults instantiates a new GeoAreaToCellMapping object This constructor will only assign default values to properties that have it defined, but it doesn't guarantee that properties required by API are set.
NewGeoAreaWithDefaults instantiates a new GeoArea object This constructor will only assign default values to properties that have it defined, but it doesn't guarantee that properties required by API are set.
NewGeoCoordinate instantiates a new GeoCoordinate object This constructor will assign default values to properties that have it defined, and makes sure properties required by API are set, but the set of arguments will change when the set of required properties is changed.
NewGeoCoordinateWithDefaults instantiates a new GeoCoordinate object This constructor will only assign default values to properties that have it defined, but it doesn't guarantee that properties required by API are set.
NewHeartbeatNotificationTypesFromValue returns a pointer to a valid HeartbeatNotificationTypes for the value passed as argument, or an error if the value passed is not allowed by the enum.
NewIpv6Addr instantiates a new Ipv6Addr object This constructor will assign default values to properties that have it defined, and makes sure properties required by API are set, but the set of arguments will change when the set of required properties is changed.
NewIpv6AddrWithDefaults instantiates a new Ipv6Addr object This constructor will only assign default values to properties that have it defined, but it doesn't guarantee that properties required by API are set.
NewIpv6Prefix instantiates a new Ipv6Prefix object This constructor will assign default values to properties that have it defined, and makes sure properties required by API are set, but the set of arguments will change when the set of required properties is changed.
NewIpv6PrefixWithDefaults instantiates a new Ipv6Prefix object This constructor will only assign default values to properties that have it defined, but it doesn't guarantee that properties required by API are set.
NewNotificationHeader instantiates a new NotificationHeader object This constructor will assign default values to properties that have it defined, and makes sure properties required by API are set, but the set of arguments will change when the set of required properties is changed.
NewNotificationHeaderWithDefaults instantiates a new NotificationHeader object This constructor will only assign default values to properties that have it defined, but it doesn't guarantee that properties required by API are set.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
NewOperationalStateFromValue returns a pointer to a valid OperationalState for the value passed as argument, or an error if the value passed is not allowed by the enum.
NewPerfNotificationTypesFromValue returns a pointer to a valid PerfNotificationTypes for the value passed as argument, or an error if the value passed is not allowed by the enum.
NewPlmnId instantiates a new PlmnId object This constructor will assign default values to properties that have it defined, and makes sure properties required by API are set, but the set of arguments will change when the set of required properties is changed.
NewPlmnIdWithDefaults instantiates a new PlmnId object This constructor will only assign default values to properties that have it defined, but it doesn't guarantee that properties required by API are set.
NewTai instantiates a new Tai object This constructor will assign default values to properties that have it defined, and makes sure properties required by API are set, but the set of arguments will change when the set of required properties is changed.
NewTaiWithDefaults instantiates a new Tai object This constructor will only assign default values to properties that have it defined, but it doesn't guarantee that properties required by API are set.
NewTimeWindow instantiates a new TimeWindow object This constructor will assign default values to properties that have it defined, and makes sure properties required by API are set, but the set of arguments will change when the set of required properties is changed.
NewTimeWindowWithDefaults instantiates a new TimeWindow object This constructor will only assign default values to properties that have it defined, but it doesn't guarantee that properties required by API are set.
NewUsageStateFromValue returns a pointer to a valid UsageState for the value passed as argument, or an error if the value passed is not allowed by the enum.
PerfNotificationTypesAsNotificationType is a convenience function that returns PerfNotificationTypes wrapped in NotificationType.
PtrBool is a helper routine that returns a pointer to given boolean value.
PtrFloat32 is a helper routine that returns a pointer to given float value.
PtrFloat64 is a helper routine that returns a pointer to given float value.
PtrInt is a helper routine that returns a pointer to given integer value.
PtrInt32 is a helper routine that returns a pointer to given integer value.
PtrInt64 is a helper routine that returns a pointer to given integer value.
PtrString is a helper routine that returns a pointer to given string value.
PtrTime is helper routine that returns a pointer to given Time value.
stringAsHost is a convenience function that returns string wrapped in Host.
stringAsHostAddr is a convenience function that returns string wrapped in HostAddr.
stringAsIpAddr is a convenience function that returns string wrapped in IpAddr.

# Constants

List of UsageState.
List of UsageState.
List of OperationalState.
List of OperationalState.
List of UsageState.
List of AdministrativeState.
List of AlarmNotificationTypes.
List of AlarmNotificationTypes.
List of AlarmNotificationTypes.
List of AlarmNotificationTypes.
List of AlarmNotificationTypes.
List of AlarmNotificationTypes.
List of AlarmNotificationTypes.
List of FileNotificationTypes.
List of FileNotificationTypes.
List of HeartbeatNotificationTypes.
List of CmNotificationTypes.
List of CmNotificationTypes.
List of CmNotificationTypes.
List of CmNotificationTypes.
List of AlarmNotificationTypes.
List of AlarmNotificationTypes.
List of PerfNotificationTypes.
List of AdministrativeState.

# Variables

All allowed values of AdministrativeState enum.
All allowed values of AlarmNotificationTypes enum.
All allowed values of CmNotificationTypes enum.
All allowed values of FileNotificationTypes enum.
All allowed values of HeartbeatNotificationTypes enum.
All allowed values of OperationalState enum.
All allowed values of PerfNotificationTypes enum.
All allowed values of UsageState enum.
ContextOperationServerIndices uses a server configuration from the index mapping.
ContextOperationServerVariables overrides a server configuration variables using operation specific values.
ContextServerIndex uses a server configuration from the index.
ContextServerVariables overrides a server configuration variables.

# Structs

APIClient manages communication with the Common Type Definitions API v18.1.0 In most cases there should be only one, shared, APIClient.
APIKey provides API key based authentication to a request passed via context using ContextAPIKey.
APIResponse stores the API response returned by the server.
AreaOfInterest - struct for AreaOfInterest.
BasicAuth provides basic http authentication to a request passed via context using ContextBasicAuth.
Configuration stores the configuration of the API client.
ErrorResponse Default schema for the response message body in case the request is not successful.
ErrorResponseError struct for ErrorResponseError.
GenericOpenAPIError Provides access to the body, error and model on returned errors.
GeoArea struct for GeoArea.
GeoAreaToCellMapping struct for GeoAreaToCellMapping.
GeoCoordinate struct for GeoCoordinate.
Host - struct for Host.
HostAddr - struct for HostAddr.
IpAddr - struct for IpAddr.
Ipv6Addr struct for Ipv6Addr.
Ipv6Prefix struct for Ipv6Prefix.
NotificationHeader struct for NotificationHeader.
NotificationType - struct for NotificationType.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
PlmnId struct for PlmnId.
ServerConfiguration stores the information about a server.
ServerVariable stores the information about a server variable.
Tai struct for Tai.
TimeWindow struct for TimeWindow.

# Interfaces

No description provided by the author

# Type aliases

AdministrativeState the model 'AdministrativeState'.
AlarmNotificationTypes the model 'AlarmNotificationTypes'.
CmNotificationTypes the model 'CmNotificationTypes'.
FileNotificationTypes the model 'FileNotificationTypes'.
HeartbeatNotificationTypes the model 'HeartbeatNotificationTypes'.
OperationalState the model 'OperationalState'.
PerfNotificationTypes the model 'PerfNotificationTypes'.
ServerConfigurations stores multiple ServerConfiguration items.
UsageState the model 'UsageState'.