api_reader.go

/*
Proxmox Backup Server API

Generated from apidoc.js. NOT an official Proxmox specification. See https://pbs.proxmox.com/docs/api-viewer/ for the upstream documentation.

API version: 9.x
*/

// Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.

package openapi

import (
	"bytes"
	"context"
	"io"
	"net/http"
	"net/url"
)


// ReaderAPIService ReaderAPI service
type ReaderAPIService service

type ApiReaderGetReaderRequest struct {
	ctx context.Context
	ApiService *ReaderAPIService
	backupId *string
	backupTime *int64
	backupType *PbsBackupTypeEnum
	store *string
	debug *bool
	ns *string
}

// Backup ID.
func (r ApiReaderGetReaderRequest) BackupId(backupId string) ApiReaderGetReaderRequest {
	r.backupId = &backupId
	return r
}

// Backup time (Unix epoch.)
func (r ApiReaderGetReaderRequest) BackupTime(backupTime int64) ApiReaderGetReaderRequest {
	r.backupTime = &backupTime
	return r
}

// Backup type.
func (r ApiReaderGetReaderRequest) BackupType(backupType PbsBackupTypeEnum) ApiReaderGetReaderRequest {
	r.backupType = &backupType
	return r
}

// Datastore name.
func (r ApiReaderGetReaderRequest) Store(store string) ApiReaderGetReaderRequest {
	r.store = &store
	return r
}

// Enable verbose debug logging.
func (r ApiReaderGetReaderRequest) Debug(debug bool) ApiReaderGetReaderRequest {
	r.debug = &debug
	return r
}

// Namespace.
func (r ApiReaderGetReaderRequest) Ns(ns string) ApiReaderGetReaderRequest {
	r.ns = &ns
	return r
}

func (r ApiReaderGetReaderRequest) Execute() (*ReaderGetReaderResponse, *http.Response, error) {
	return r.ApiService.ReaderGetReaderExecute(r)
}

/*
ReaderGetReader Upgraded to backup protocol ('proxmox-backup-reader-protocol-v1')

Upgraded to backup protocol ('proxmox-backup-reader-protocol-v1').

Permissions: The user needs Datastore.Read privilege on /datastore/{store}.

 @param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
 @return ApiReaderGetReaderRequest
*/
func (a *ReaderAPIService) ReaderGetReader(ctx context.Context) ApiReaderGetReaderRequest {
	return ApiReaderGetReaderRequest{
		ApiService: a,
		ctx: ctx,
	}
}

// Execute executes the request
//  @return ReaderGetReaderResponse
func (a *ReaderAPIService) ReaderGetReaderExecute(r ApiReaderGetReaderRequest) (*ReaderGetReaderResponse, *http.Response, error) {
	var (
		localVarHTTPMethod   = http.MethodGet
		localVarPostBody     interface{}
		formFiles            []formFile
		localVarReturnValue  *ReaderGetReaderResponse
	)

	localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "ReaderAPIService.ReaderGetReader")
	if err != nil {
		return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
	}

	localVarPath := localBasePath + "/reader"

	localVarHeaderParams := make(map[string]string)
	localVarQueryParams := url.Values{}
	localVarFormParams := url.Values{}
	if r.backupId == nil {
		return localVarReturnValue, nil, reportError("backupId is required and must be specified")
	}
	if r.backupTime == nil {
		return localVarReturnValue, nil, reportError("backupTime is required and must be specified")
	}
	if *r.backupTime < 1 {
		return localVarReturnValue, nil, reportError("backupTime must be greater than 1")
	}
	if r.backupType == nil {
		return localVarReturnValue, nil, reportError("backupType is required and must be specified")
	}
	if r.store == nil {
		return localVarReturnValue, nil, reportError("store is required and must be specified")
	}
	if strlen(*r.store) < 3 {
		return localVarReturnValue, nil, reportError("store must have at least 3 elements")
	}
	if strlen(*r.store) > 32 {
		return localVarReturnValue, nil, reportError("store must have less than 32 elements")
	}

	parameterAddToHeaderOrQuery(localVarQueryParams, "backup-id", r.backupId, "form", "")
	parameterAddToHeaderOrQuery(localVarQueryParams, "backup-time", r.backupTime, "form", "")
	parameterAddToHeaderOrQuery(localVarQueryParams, "backup-type", r.backupType, "form", "")
	if r.debug != nil {
		parameterAddToHeaderOrQuery(localVarQueryParams, "debug", r.debug, "form", "")
	}
	if r.ns != nil {
		parameterAddToHeaderOrQuery(localVarQueryParams, "ns", r.ns, "form", "")
	}
	parameterAddToHeaderOrQuery(localVarQueryParams, "store", r.store, "form", "")
	// 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"}

	// set Accept header
	localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
	if localVarHTTPHeaderAccept != "" {
		localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
	}
	if r.ctx != nil {
		// API Key Authentication
		if auth, ok := r.ctx.Value(ContextAPIKeys).(map[string]APIKey); ok {
			if apiKey, ok := auth["PBSApiToken"]; ok {
				var key string
				if apiKey.Prefix != "" {
					key = apiKey.Prefix + " " + apiKey.Key
				} else {
					key = apiKey.Key
				}
				localVarHeaderParams["Authorization"] = key
			}
		}
	}
	if r.ctx != nil {
		// API Key Authentication
		if auth, ok := r.ctx.Value(ContextAPIKeys).(map[string]APIKey); ok {
			if apiKey, ok := auth["CSRFPreventionToken"]; ok {
				var key string
				if apiKey.Prefix != "" {
					key = apiKey.Prefix + " " + apiKey.Key
				} else {
					key = apiKey.Key
				}
				localVarHeaderParams["CSRFPreventionToken"] = key
			}
		}
	}
	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,
		}
		if localVarHTTPResponse.StatusCode == 400 {
			var v PbsError
			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
		}
		if localVarHTTPResponse.StatusCode == 401 {
			var v PbsError
			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
		}
		if localVarHTTPResponse.StatusCode == 403 {
			var v PbsError
			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
		}
		if localVarHTTPResponse.StatusCode == 404 {
			var v PbsError
			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
		}
		if localVarHTTPResponse.StatusCode == 500 {
			var v PbsError
			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
		}
		if localVarHTTPResponse.StatusCode == 501 {
			var v PbsError
			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
		}
		if localVarHTTPResponse.StatusCode == 503 {
			var v PbsError
			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
}