Files
sdk/api_network.go

1100 lines
39 KiB
Go

/*
Hanzo Cloud API
The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
API version: v1
*/
// Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
package hanzoai
import (
"bytes"
"context"
"io"
"net/http"
"net/url"
"strings"
)
// NetworkAPIService NetworkAPI service
type NetworkAPIService service
type NetworkAPIDeleteNetworkIdentitiesByIdRequest struct {
ctx context.Context
ApiService *NetworkAPIService
id string
}
func (r NetworkAPIDeleteNetworkIdentitiesByIdRequest) Execute() (*http.Response, error) {
return r.ApiService.DeleteNetworkIdentitiesByIdExecute(r)
}
/*
DeleteNetworkIdentitiesById Takes one of the org's fabric identities out of the org.
Takes one of the org's fabric identities out of the org.
The identity's "org-<org>" role and every role scoped to the org are
removed and the rest is left alone, so an identity another org shares keeps
working there. The identity itself is deleted when no org role is left on
it, or when the caller IS its IAM subject — a person may always remove
themselves.
An id belonging to another org — or to nothing — is 404 before any write
reaches the controller: whether an identity exists is itself a cross-tenant
fact, and a delete may only ever act on what the caller could list, which for
a plain member is its own identity. A fabric administrator is the
controller's own and is refused.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@param id ID is the identity id from the path. The URL is the addressing authority, so it binds from there whatever else the request carries.
@return NetworkAPIDeleteNetworkIdentitiesByIdRequest
*/
func (a *NetworkAPIService) DeleteNetworkIdentitiesById(ctx context.Context, id string) NetworkAPIDeleteNetworkIdentitiesByIdRequest {
return NetworkAPIDeleteNetworkIdentitiesByIdRequest{
ApiService: a,
ctx: ctx,
id: id,
}
}
// Execute executes the request
func (a *NetworkAPIService) DeleteNetworkIdentitiesByIdExecute(r NetworkAPIDeleteNetworkIdentitiesByIdRequest) (*http.Response, error) {
var (
localVarHTTPMethod = http.MethodDelete
localVarPostBody interface{}
formFiles []formFile
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "NetworkAPIService.DeleteNetworkIdentitiesById")
if err != nil {
return nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/network/identities/{id}"
localVarPath = strings.Replace(localVarPath, "{"+"id"+"}", url.PathEscape(parameterValueToString(r.id, "id")), -1)
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarHTTPResponse, newErr
}
return localVarHTTPResponse, nil
}
type NetworkAPIDeleteNetworkServicesByIdRequest struct {
ctx context.Context
ApiService *NetworkAPIService
id string
}
func (r NetworkAPIDeleteNetworkServicesByIdRequest) Execute() (*http.Response, error) {
return r.ApiService.DeleteNetworkServicesByIdExecute(r)
}
/*
DeleteNetworkServicesById Takes a name off the org's overlay: the two policies, the service and its two configs that publishing made, in that order, and the \"<name>-host\" role from each of the org's identities — that role exists only for the bind policy to select, and a role naming no service is one the identities endpoint refuses to write.
Takes a name off the org's overlay: the two policies, the
service and its two configs that publishing made, in that order, and the
"<name>-host" role from each of the org's identities — that role exists
only for the bind policy to select, and a role naming no service is one
the identities endpoint refuses to write.
Only objects carrying this service's own names are deleted, so a policy
that selects the service by attribute is left alone. An id belonging to
another org — or to nothing — is 404 before any write, as for an identity.
Like publishing it is a steward's act, and a plain member is 403 before the
controller is read.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@param id ID is the service id from the path. The URL is the addressing authority, so it binds from there whatever else the request carries.
@return NetworkAPIDeleteNetworkServicesByIdRequest
*/
func (a *NetworkAPIService) DeleteNetworkServicesById(ctx context.Context, id string) NetworkAPIDeleteNetworkServicesByIdRequest {
return NetworkAPIDeleteNetworkServicesByIdRequest{
ApiService: a,
ctx: ctx,
id: id,
}
}
// Execute executes the request
func (a *NetworkAPIService) DeleteNetworkServicesByIdExecute(r NetworkAPIDeleteNetworkServicesByIdRequest) (*http.Response, error) {
var (
localVarHTTPMethod = http.MethodDelete
localVarPostBody interface{}
formFiles []formFile
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "NetworkAPIService.DeleteNetworkServicesById")
if err != nil {
return nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/network/services/{id}"
localVarPath = strings.Replace(localVarPath, "{"+"id"+"}", url.PathEscape(parameterValueToString(r.id, "id")), -1)
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarHTTPResponse, newErr
}
return localVarHTTPResponse, nil
}
type NetworkAPIGetNetworkRequest struct {
ctx context.Context
ApiService *NetworkAPIService
}
func (r NetworkAPIGetNetworkRequest) Execute() (*NetworkNetworkList, *http.Response, error) {
return r.ApiService.GetNetworkExecute(r)
}
/*
GetNetwork Returns the caller's org overlay network on the Zero Trust fabric.
Returns the caller's org overlay network on the Zero Trust fabric.
The org has at most ONE overlay, projected from the edge-routers tagged with its
"org-<org>" role attribute: nodes is the real router count and status is
"connected" once at least one router has dialed home, "provisioning" while none
has. An org with no routers gets an empty list, never a fabricated network.
The read degrades rather than erroring: a deployment with no ZT credential, and a
controller that cannot be reached, both answer 200 with an empty list so the
console's Networks page renders a clean empty state instead of an error.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return NetworkAPIGetNetworkRequest
*/
func (a *NetworkAPIService) GetNetwork(ctx context.Context) NetworkAPIGetNetworkRequest {
return NetworkAPIGetNetworkRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return NetworkNetworkList
func (a *NetworkAPIService) GetNetworkExecute(r NetworkAPIGetNetworkRequest) (*NetworkNetworkList, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodGet
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *NetworkNetworkList
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "NetworkAPIService.GetNetwork")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/network"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type NetworkAPIGetNetworkByIdRequest struct {
ctx context.Context
ApiService *NetworkAPIService
id string
}
func (r NetworkAPIGetNetworkByIdRequest) Execute() (*NetworkNetworkView, *http.Response, error) {
return r.ApiService.GetNetworkByIdExecute(r)
}
/*
GetNetworkById Returns one overlay network by id, scoped to the caller's org.
Returns one overlay network by id, scoped to the caller's org.
The org has exactly one overlay network and its id is derived from the org, so
any other id — another tenant's, or one that does not exist — is 404 rather than
a peek across the tenant boundary. An org whose network exists but has no
edge-routers is 404 too, for the same reason the list is empty: there is no
overlay until something is on it.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@param id ID is the network id from the path. The URL is the addressing authority, so it binds from there whatever else the request carries.
@return NetworkAPIGetNetworkByIdRequest
*/
func (a *NetworkAPIService) GetNetworkById(ctx context.Context, id string) NetworkAPIGetNetworkByIdRequest {
return NetworkAPIGetNetworkByIdRequest{
ApiService: a,
ctx: ctx,
id: id,
}
}
// Execute executes the request
//
// @return NetworkNetworkView
func (a *NetworkAPIService) GetNetworkByIdExecute(r NetworkAPIGetNetworkByIdRequest) (*NetworkNetworkView, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodGet
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *NetworkNetworkView
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "NetworkAPIService.GetNetworkById")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/network/{id}"
localVarPath = strings.Replace(localVarPath, "{"+"id"+"}", url.PathEscape(parameterValueToString(r.id, "id")), -1)
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type NetworkAPIGetNetworkIdentitiesRequest struct {
ctx context.Context
ApiService *NetworkAPIService
}
func (r NetworkAPIGetNetworkIdentitiesRequest) Execute() (*NetworkIdentityList, *http.Response, error) {
return r.ApiService.GetNetworkIdentitiesExecute(r)
}
/*
GetNetworkIdentities Returns the fabric identities the caller's org owns.
Returns the fabric identities the caller's org owns.
One row per identity tagged with the org's "org-<org>" role attribute, each
naming the IAM subject it logs in as. A steward sees every one; a plain member
sees only its own, since who else is on the org's network is not a member's
to read, and a plain member's API key, which holds no identity, is refused.
A tenancy read over the full inventory, so like the mesh list it does NOT
degrade: an unconfigured deployment answers 503.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return NetworkAPIGetNetworkIdentitiesRequest
*/
func (a *NetworkAPIService) GetNetworkIdentities(ctx context.Context) NetworkAPIGetNetworkIdentitiesRequest {
return NetworkAPIGetNetworkIdentitiesRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return NetworkIdentityList
func (a *NetworkAPIService) GetNetworkIdentitiesExecute(r NetworkAPIGetNetworkIdentitiesRequest) (*NetworkIdentityList, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodGet
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *NetworkIdentityList
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "NetworkAPIService.GetNetworkIdentities")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/network/identities"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type NetworkAPIGetNetworkRoutersRequest struct {
ctx context.Context
ApiService *NetworkAPIService
}
func (r NetworkAPIGetNetworkRoutersRequest) Execute() (*NetworkRouterList, *http.Response, error) {
return r.ApiService.GetNetworkRoutersExecute(r)
}
/*
GetNetworkRouters Returns the Zero Trust routers the caller's org owns.
Returns the Zero Trust routers the caller's org owns.
One row per real ZT edge-router tagged with the org's "org-<org>" role attribute,
carrying the controller's own health signal: "online" when connected, "disabled"
when administratively disabled, "offline" otherwise. region is filled only from a
"region-<slug>" role attribute and omitted when the router carries none, so the
column renders "—" rather than a guess.
The read degrades rather than erroring: a deployment with no ZT credential, and a
controller that cannot be reached, both answer 200 with an empty list.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return NetworkAPIGetNetworkRoutersRequest
*/
func (a *NetworkAPIService) GetNetworkRouters(ctx context.Context) NetworkAPIGetNetworkRoutersRequest {
return NetworkAPIGetNetworkRoutersRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return NetworkRouterList
func (a *NetworkAPIService) GetNetworkRoutersExecute(r NetworkAPIGetNetworkRoutersRequest) (*NetworkRouterList, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodGet
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *NetworkRouterList
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "NetworkAPIService.GetNetworkRouters")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/network/routers"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type NetworkAPIGetNetworkServicesRequest struct {
ctx context.Context
ApiService *NetworkAPIService
}
func (r NetworkAPIGetNetworkServicesRequest) Execute() (*NetworkMeshServiceList, *http.Response, error) {
return r.ApiService.GetNetworkServicesExecute(r)
}
/*
GetNetworkServices Returns the Zero Trust edge services the caller's org owns.
Returns the Zero Trust edge services the caller's org owns.
One row per real ZT edge service tagged with the org's "org-<org>" role
attribute: mtls is "required" when the service mandates end-to-end encryption and
"enabled" otherwise (the fabric always mutually authenticates every link), and
status is "active" because a listed service is a configured, dialable entry. A
service tagged for another org, or tagged for none, is invisible here.
Unlike the network and router reads this does NOT degrade: an unconfigured
deployment answers 503 and an unreachable controller surfaces the upstream's
status, so a mesh page never renders "no services" for a fabric it simply could
not read.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return NetworkAPIGetNetworkServicesRequest
*/
func (a *NetworkAPIService) GetNetworkServices(ctx context.Context) NetworkAPIGetNetworkServicesRequest {
return NetworkAPIGetNetworkServicesRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return NetworkMeshServiceList
func (a *NetworkAPIService) GetNetworkServicesExecute(r NetworkAPIGetNetworkServicesRequest) (*NetworkMeshServiceList, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodGet
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *NetworkMeshServiceList
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "NetworkAPIService.GetNetworkServices")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/network/services"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type NetworkAPIPostNetworkIdentitiesRequest struct {
ctx context.Context
ApiService *NetworkAPIService
networkIdentityIn *NetworkIdentityIn
}
func (r NetworkAPIPostNetworkIdentitiesRequest) NetworkIdentityIn(networkIdentityIn NetworkIdentityIn) NetworkAPIPostNetworkIdentitiesRequest {
r.networkIdentityIn = &networkIdentityIn
return r
}
func (r NetworkAPIPostNetworkIdentitiesRequest) Execute() (*NetworkIdentityView, *http.Response, error) {
return r.ApiService.PostNetworkIdentitiesExecute(r)
}
/*
PostNetworkIdentities Puts the caller on the org's overlay as its own IAM subject.
Puts the caller on the org's overlay as its own IAM subject.
The identity is the one whose externalId is the caller's `sub`, admitted by
the controller's "iam" auth policy: the caller logs in to the fabric with its
own IAM access token, and nothing is enrolled. It is named by the subject
unless a name is given, and carries the org's "org-<org>" role attribute plus
any supplied roles — each scoped to the org, and a "<service>-host" role
refused unless the org has published that service. Roles are a steward's to
take: a plain member joins with the org role alone, and asking for more is
403 before the controller is written.
An API key is refused 403: the fabric admits an IAM access token, a person's
or an application's, and a key has none to log in with.
IDEMPOTENT: a caller who already has an identity gets the same one back, with
any of these roles it lacked added — which is how one person's identity comes
to serve every org they act in.
A write, so it does not degrade: an unconfigured deployment answers 503.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return NetworkAPIPostNetworkIdentitiesRequest
*/
func (a *NetworkAPIService) PostNetworkIdentities(ctx context.Context) NetworkAPIPostNetworkIdentitiesRequest {
return NetworkAPIPostNetworkIdentitiesRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return NetworkIdentityView
func (a *NetworkAPIService) PostNetworkIdentitiesExecute(r NetworkAPIPostNetworkIdentitiesRequest) (*NetworkIdentityView, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodPost
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *NetworkIdentityView
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "NetworkAPIService.PostNetworkIdentities")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/network/identities"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
if r.networkIdentityIn == nil {
return localVarReturnValue, nil, reportError("networkIdentityIn is required and must be specified")
}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{"application/json"}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
// body params
localVarPostBody = r.networkIdentityIn
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type NetworkAPIPostNetworkServicesRequest struct {
ctx context.Context
ApiService *NetworkAPIService
networkServiceIn *NetworkServiceIn
}
func (r NetworkAPIPostNetworkServicesRequest) NetworkServiceIn(networkServiceIn NetworkServiceIn) NetworkAPIPostNetworkServicesRequest {
r.networkServiceIn = &networkServiceIn
return r
}
func (r NetworkAPIPostNetworkServicesRequest) Execute() (*NetworkPublishedView, *http.Response, error) {
return r.ApiService.PostNetworkServicesExecute(r)
}
/*
PostNetworkServices Puts a name on the org's overlay: a fabric service forwarding to host:port on whichever of the org's devices carries the \"<name>-host\" role, dialable at \"<name>.<org>.zt\" by any of the org's identities — and by the cloud's own, which is what lets a BYO cluster's apiserver be attached to the fleet with a \".zt\" kubeconfig.
Puts a name on the org's overlay: a fabric service forwarding
to host:port on whichever of the org's devices carries the "<name>-host"
role, dialable at "<name>.<org>.zt" by any of the org's identities — and by
the cloud's own, which is what lets a BYO cluster's apiserver be attached to
the fleet with a ".zt" kubeconfig.
Answers 201 with the service and its DNS name. The objects behind it are
created in dependency order and unwound on failure, so a half-published
service never lingers on the fabric. Publishing is a steward's act — an
admin of the org or its own machine client — and a plain member is 403.
A write, so it does not degrade: an unconfigured deployment answers 503.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return NetworkAPIPostNetworkServicesRequest
*/
func (a *NetworkAPIService) PostNetworkServices(ctx context.Context) NetworkAPIPostNetworkServicesRequest {
return NetworkAPIPostNetworkServicesRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return NetworkPublishedView
func (a *NetworkAPIService) PostNetworkServicesExecute(r NetworkAPIPostNetworkServicesRequest) (*NetworkPublishedView, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodPost
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *NetworkPublishedView
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "NetworkAPIService.PostNetworkServices")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/network/services"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
if r.networkServiceIn == nil {
return localVarReturnValue, nil, reportError("networkServiceIn is required and must be specified")
}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{"application/json"}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
// body params
localVarPostBody = r.networkServiceIn
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}