package client import ( "context" v2netmap "github.com/nspcc-dev/neofs-api-go/v2/netmap" rpcapi "github.com/nspcc-dev/neofs-api-go/v2/rpc" "github.com/nspcc-dev/neofs-api-go/v2/rpc/client" "github.com/nspcc-dev/neofs-sdk-go/netmap" "github.com/nspcc-dev/neofs-sdk-go/version" ) // EndpointInfoPrm groups parameters of EndpointInfo operation. // // At the moment the operation is not parameterized, however, // the structure is still declared for backward compatibility. type EndpointInfoPrm struct{} // EndpointInfoRes group resulting values of EndpointInfo operation. type EndpointInfoRes struct { statusRes version *version.Version ni *netmap.NodeInfo } // LatestVersion returns latest NeoFS API protocol's version in use. // // Client doesn't retain value so modification is safe. func (x EndpointInfoRes) LatestVersion() *version.Version { return x.version } func (x *EndpointInfoRes) setLatestVersion(ver *version.Version) { x.version = ver } // NodeInfo returns information about the NeoFS node served on the remote endpoint. // // Client doesn't retain value so modification is safe. func (x EndpointInfoRes) NodeInfo() *netmap.NodeInfo { return x.ni } func (x *EndpointInfoRes) setNodeInfo(info *netmap.NodeInfo) { x.ni = info } // EndpointInfo requests information about the storage node served on the remote endpoint. // // Method can be used as a health check to see if node is alive and responds to requests. // // Any client's internal or transport errors are returned as `error`. // If WithNeoFSErrorParsing option has been provided, unsuccessful // NeoFS status codes are returned as `error`, otherwise, are included // in the returned result structure. // // Immediately panics if parameters are set incorrectly (see EndpointInfoPrm docs). // Context is required and must not be nil. It is used for network communication. // // Exactly one return value is non-nil. Server status return is returned in EndpointInfoRes. // Reflects all internal errors in second return value (transport problems, response processing, etc.). // // Return statuses: // - global (see Client docs). func (c *Client) EndpointInfo(ctx context.Context, _ EndpointInfoPrm) (*EndpointInfoRes, error) { // check context if ctx == nil { panic(panicMsgMissingContext) } // form request var req v2netmap.LocalNodeInfoRequest // init call context var ( cc contextCall res EndpointInfoRes ) c.initCallContext(&cc) cc.req = &req cc.statusRes = &res cc.call = func() (responseV2, error) { return rpcapi.LocalNodeInfo(c.Raw(), &req, client.WithContext(ctx)) } cc.result = func(r responseV2) { resp := r.(*v2netmap.LocalNodeInfoResponse) body := resp.GetBody() res.setLatestVersion(version.NewFromV2(body.GetVersion())) res.setNodeInfo(netmap.NewNodeInfoFromV2(body.GetNodeInfo())) } // process call if !cc.processCall() { return nil, cc.err } return &res, nil } // NetworkInfoPrm groups parameters of NetworkInfo operation. // // At the moment the operation is not parameterized, however, // the structure is still declared for backward compatibility. type NetworkInfoPrm struct{} // NetworkInfoRes groups resulting values of NetworkInfo operation. type NetworkInfoRes struct { statusRes info *netmap.NetworkInfo } // Info returns structured information about the NeoFS network. // // Client doesn't retain value so modification is safe. func (x NetworkInfoRes) Info() *netmap.NetworkInfo { return x.info } func (x *NetworkInfoRes) setInfo(info *netmap.NetworkInfo) { x.info = info } // NetworkInfo requests information about the NeoFS network of which the remote server is a part. // // Any client's internal or transport errors are returned as `error`. // If WithNeoFSErrorParsing option has been provided, unsuccessful // NeoFS status codes are returned as `error`, otherwise, are included // in the returned result structure. // // Immediately panics if parameters are set incorrectly (see NetworkInfoPrm docs). // Context is required and must not be nil. It is used for network communication. // // Exactly one return value is non-nil. Server status return is returned in NetworkInfoRes. // Reflects all internal errors in second return value (transport problems, response processing, etc.). // // Return statuses: // - global (see Client docs). func (c *Client) NetworkInfo(ctx context.Context, _ NetworkInfoPrm) (*NetworkInfoRes, error) { // check context if ctx == nil { panic(panicMsgMissingContext) } // form request var req v2netmap.NetworkInfoRequest // init call context var ( cc contextCall res NetworkInfoRes ) c.initCallContext(&cc) cc.req = &req cc.statusRes = &res cc.call = func() (responseV2, error) { return rpcapi.NetworkInfo(c.Raw(), &req, client.WithContext(ctx)) } cc.result = func(r responseV2) { resp := r.(*v2netmap.NetworkInfoResponse) res.setInfo(netmap.NewNetworkInfoFromV2(resp.GetBody().GetNetworkInfo())) } // process call if !cc.processCall() { return nil, cc.err } return &res, nil }