feat: update generated apis (#265)

Author: Quentin Brosse

api/instance/v1/instance_sdk.go

@@ -971,7 +971,7 @@ type Server struct {
 	Protected bool `json:"protected"`
 	// PrivateIP display the server private IP address
 	PrivateIP *string `json:"private_ip"`
-	// PublicIP display the server public IP address
+	// PublicIP display information about the public IP
 	PublicIP *ServerIP `json:"public_ip"`
 	// ModificationDate display the server modification date
 	ModificationDate time.Time `json:"modification_date"`
@@ -1463,7 +1463,7 @@ type CreateServerRequest struct {
 	Volumes map[string]*VolumeTemplate `json:"volumes,omitempty"`
 	// EnableIPv6 true if IPv6 is enabled on the server
 	EnableIPv6 bool `json:"enable_ipv6,omitempty"`
-	// PublicIP the public IPv4 attached to the server
+	// PublicIP the ID of the reserved IP to attach to the server
 	PublicIP *string `json:"public_ip,omitempty"`
 	// BootType the boot type to use
 	//
@@ -1629,7 +1629,7 @@ type setServerRequest struct {
 	Protected bool `json:"protected"`
 	// PrivateIP display the server private IP address
 	PrivateIP *string `json:"private_ip"`
-	// PublicIP display the server public IP address
+	// PublicIP display information about the public IP
 	PublicIP *ServerIP `json:"public_ip"`
 	// ModificationDate display the server modification date
 	ModificationDate time.Time `json:"modification_date"`
@@ -1821,7 +1821,7 @@ type ServerActionRequest struct {
 
 // ServerAction perform action
 //
-// Perform power related actions on a server.
+// Perform power related actions on a server. Be wary that when terminating a server, all the attached volumes (local *and* block storage) are deleted. So, if you want to keep your local volumes, you must use the `archive` action instead of `terminate`. And if you want to keep block-storage volumes, **you must** detach it beforehand you issue the `terminate` call.  For more information, read the [Volumes](#volumes-7e8a39) documentation.
 func (s *API) ServerAction(req *ServerActionRequest, opts ...scw.RequestOption) (*ServerActionResponse, error) {
 	var err error
 

api/marketplace/v1/marketplace_sdk.go

@@ -65,30 +65,32 @@ type GetVersionResponse struct {
 	Version *Version `json:"version"`
 }
 
+// Image image
 type Image struct {
+	// ID uUID of this image
 	ID string `json:"id"`
-
+	// Name name of the image
 	Name string `json:"name"`
-
+	// Description text description of this image
 	Description string `json:"description"`
-
+	// Logo uRL of this image's logo
 	Logo string `json:"logo"`
-
+	// Categories list of categories this image belongs to
 	Categories []string `json:"categories"`
-
-	Organization *Organization `json:"organization"`
-
-	ValidUntil time.Time `json:"valid_until"`
-
+	// CreationDate creation date of this image
 	CreationDate time.Time `json:"creation_date"`
-
+	// ModificationDate date of the last modification of this image
 	ModificationDate time.Time `json:"modification_date"`
-
+	// ValidUntil expiration date of this image
+	ValidUntil time.Time `json:"valid_until"`
+	// Label label of this image
+	Label string `json:"label"`
+	// Versions list of versions of this image
 	Versions []*Version `json:"versions"`
+	// Organization organization this image belongs to
+	Organization *Organization `json:"organization"`
 
 	CurrentPublicVersion string `json:"current_public_version"`
-
-	Label string `json:"label"`
 }
 
 type ListImagesResponse struct {
@@ -103,14 +105,16 @@ type ListVersionsResponse struct {
 	TotalCount uint32 `json:"total_count"`
 }
 
+// LocalImage local image
 type LocalImage struct {
+	// ID uUID of this local image
 	ID string `json:"id"`
-
+	// CompatibleCommercialTypes list of all commercial types that are compatible with this local image
+	CompatibleCommercialTypes []string `json:"compatible_commercial_types"`
+	// Arch supported architecture for this local image
 	Arch string `json:"arch"`
-
+	// Zone availability Zone where this local image is available
 	Zone scw.Zone `json:"zone"`
-
-	CompatibleCommercialTypes []string `json:"compatible_commercial_types"`
 }
 
 type Organization struct {
@@ -119,15 +123,17 @@ type Organization struct {
 	Name string `json:"name"`
 }
 
+// Version version
 type Version struct {
+	// ID uUID of this version
 	ID string `json:"id"`
-
+	// Name name of this version
 	Name string `json:"name"`
-
+	// CreationDate creation date of this image version
 	CreationDate time.Time `json:"creation_date"`
-
+	// ModificationDate date of the last modification of this version
 	ModificationDate time.Time `json:"modification_date"`
-
+	// LocalImages list of local images available in this version
 	LocalImages []*LocalImage `json:"local_images"`
 }
 
@@ -155,8 +161,9 @@ func (s *API) GetServiceInfo(req *GetServiceInfoRequest, opts ...scw.RequestOpti
 }
 
 type ListImagesRequest struct {
+	// PerPage a positive integer lower or equal to 100 to select the number of items to display
 	PerPage *uint32 `json:"-"`
-
+	// Page a positive integer to choose the page to display
 	Page *int32 `json:"-"`
 }
 
@@ -209,6 +216,7 @@ func (r *ListImagesResponse) UnsafeAppend(res interface{}) (uint32, scw.SdkError
 }
 
 type GetImageRequest struct {
+	// ImageID display the image name
 	ImageID string `json:"-"`
 }