Categorygithub.com/g1eng/sakura_vps_client_go
repositorypackage
0.4.410
Repository: https://github.com/g1eng/sakura_vps_client_go.git
Documentation: pkg.go.dev

# Packages

No description provided by the author

# README

これは何

さくらのVPS APIをGoで利用するための非公式クライアントライブラリです。

このライブラリは上流の仕様書CC-BY 4.0国際ライセンスで許諾する部分を切り出して作成した仕様書を元に、OpenAPI Generator の Go generator を用いてコード生成を行ったものです。

このパッケージはさくらインターネットが著作権を有する仕様書(バージョン: "4.4.1")を元として作成されています。

利用方法

本リポジトリでは、クライアントライブラリの包括的な利用方法のサポートを提供しません。 その代わり、仕様書に含まれるAPIの利用方法をご自身のエディタで参照できるよう、/docs配下にAPIの利用方法のドキュメンテーションが格納されています。

goplsのようなLSPサーバーを用いれば、それぞれの関数の利用方法について有益なサジェストを得ることができるでしょう。

ライセンス

Apache 2.0

ただし、仕様書CC-BY 4.0国際ライセンスで許諾されます。

Go API client for sakura_vps

No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)

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: 4.4.1
  • Package version: 1.0.0
  • Generator version: 7.11.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 sakura_vps "github.com/g1eng/sakura_vps_client_go"

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 sakura_vps.ContextServerIndex of type int.

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

Templated Server URL

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

ctx := context.WithValue(context.Background(), sakura_vps.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 sakura_vps.ContextOperationServerIndices and sakura_vps.ContextOperationServerVariables context maps.

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

Documentation for API Endpoints

All URIs are relative to https://secure.sakura.ad.jp/vps/api/v7

ClassMethodHTTP requestDescription
ApiKeyAPIDeleteApiKeyDelete /api-keys/{api_key_id}APIキーを削除する
ApiKeyAPIDeleteRoleDelete /roles/{role_id}ロールを削除する
ApiKeyAPIGetApiKeyGet /api-keys/{api_key_id}APIキーを取得する
ApiKeyAPIGetApiKeyListGet /api-keysAPIキーの一覧を取得する
ApiKeyAPIGetPermissionListGet /permissions権限の一覧を取得する
ApiKeyAPIGetRoleGet /roles/{role_id}ロールを取得する
ApiKeyAPIGetRoleListGet /rolesロール一覧を取得する
ApiKeyAPIPostApiKeyPost /api-keysAPIキーを作成する
ApiKeyAPIPostApiKeyRotatePost /api-keys/{api_key_id}/rotateAPIキーのトークンのローテーションを行う
ApiKeyAPIPostRolePost /rolesロールを作成する
ApiKeyAPIPutApiKeyPut /api-keys/{api_key_id}APIキーを更新する
ApiKeyAPIPutRolePut /roles/{role_id}ロールを更新する
DiscAPIGetDiscListGet /discsディスク情報一覧を取得する
NfsServerAPIGetNfsServerGet /nfs-servers/{nfs_server_id}NFS情報を取得する
NfsServerAPIGetNfsServerInterfaceGet /nfs-servers/{nfs_server_id}/interfaceNFSのインターフェースを取得する
NfsServerAPIGetNfsServerListGet /nfs-serversNFS情報一覧を取得する
NfsServerAPIGetNfsServerPowerStatusGet /nfs-servers/{nfs_server_id}/power-statusNFSの電源状態を取得する
NfsServerAPIGetNfsServerStorageGet /nfs-servers/{nfs_server_id}/storageNFSのストレージ容量情報を取得する
NfsServerAPIPostNfsServerChangeIpv4Post /nfs-servers/{nfs_server_id}/change-ipv4NFSのipv4を更新する
NfsServerAPIPutNfsServerPut /nfs-servers/{nfs_server_id}NFS情報を更新する
NfsServerAPIPutNfsServerInterfacePut /nfs-servers/{nfs_server_id}/interfaceNFSのインターフェース情報を更新する
ServerAPIDeleteServerMonitoringsDelete /servers/{server_id}/monitorings/{server_monitoring_id}サーバーのサーバー監視情報を削除する
ServerAPIGetServerGet /servers/{server_id}サーバー情報を取得する
ServerAPIGetServerInterfaceGet /servers/{server_id}/interfaces/{interface_id}サーバーのインターフェース情報を取得する
ServerAPIGetServerInterfaceListGet /servers/{server_id}/interfacesサーバーのインターフェース情報一覧を取得する
ServerAPIGetServerLimitationGet /servers/{server_id}/limitationサーバーの制限情報を取得する
ServerAPIGetServerListGet /serversサーバー情報一覧を取得する
ServerAPIGetServerMonitoringGet /servers/{server_id}/monitorings/{server_monitoring_id}サーバーのサーバー監視情報を取得する
ServerAPIGetServerMonitoringHealthGet /servers/{server_id}/monitorings/{server_monitoring_id}/healthサーバー監視の監視状態を取得する
ServerAPIGetServerMonitoringListGet /servers/{server_id}/monitoringsサーバーのサーバー監視情報一覧を取得する
ServerAPIGetServerPowerStatusGet /servers/{server_id}/power-statusサーバーの電源状態を取得する
ServerAPIGetServerVideoDeviceGet /servers/{server_id}/video-deviceサーバーのビデオデバイスの設定を取得する
ServerAPIGetServerVncConsoleKeymapGet /servers/{server_id}/vnc-console-keymapコンパネのVNCコンソールのキーマップ情報を取得する
ServerAPIPostServerForceRebootPost /servers/{server_id}/force-rebootサーバーを強制再起動する
ServerAPIPostServerMonitoringPost /servers/{server_id}/monitoringsサーバーのサーバー監視を作成する
ServerAPIPostServerMountDiscPost /servers/{server_id}/mount-discサーバーにディスクをマウントする
ServerAPIPostServerPowerOnPost /servers/{server_id}/power-onサーバーを起動する
ServerAPIPostServerShutdownPost /servers/{server_id}/shutdownサーバーをシャットダウンする
ServerAPIPutServerPut /servers/{server_id}サーバー情報を更新する
ServerAPIPutServerInterfacePut /servers/{server_id}/interfaces/{interface_id}サーバーのインターフェース情報を更新する
ServerAPIPutServerIpv4PtrPut /servers/{server_id}/ipv4-ptrサーバーのipv4の逆引きホスト名を更新する
ServerAPIPutServerIpv6PtrPut /servers/{server_id}/ipv6-ptrサーバーのipv6の逆引きホスト名を更新する
ServerAPIPutServerMonitoringPut /servers/{server_id}/monitorings/{server_monitoring_id}サーバーのサーバー監視情報を更新する
ServerAPIPutServerVideoDevicePut /servers/{server_id}/video-deviceサーバーのビデオデバイスの設定を更新する
ServerAPIPutServerVncConsoleKeymapPut /servers/{server_id}/vnc-console-keymapコンパネのVNCコンソールのキーマップ情報を変更する
SwitchAPIDeleteSwitchDelete /switches/{switch_id}スイッチを削除する
SwitchAPIGetSwitchGet /switches/{switch_id}スイッチ情報を取得する
SwitchAPIGetSwitchListGet /switchesスイッチ情報一覧を取得する
SwitchAPIPostSwitchPost /switchesスイッチを作成する
SwitchAPIPutSwitchPut /switches/{switch_id}スイッチ情報を更新する
ZoneAPIGetZoneListGet /zonesゾーン情報一覧を取得する

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

ApiKeyAuth

  • Type: HTTP Bearer token authentication

Example

auth := context.WithValue(context.Background(), sakura_vps.ContextAccessToken, "BEARER_TOKEN_STRING")
r, err := client.Service.Operation(auth, args)

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