docs(containers): document VPC integration fields (scaleway#2589)

Author: scaleway-bot

api/container/v1beta1/container_sdk.go

@@ -996,6 +996,7 @@ type Container struct {
 	// Tags: list of tags applied to the Serverless Container.
 	Tags []string `json:"tags"`
 
+	// PrivateNetworkID: when connected to a Private Network, the container can access other Scaleway resources in this Private Network.
 	PrivateNetworkID *string `json:"private_network_id"`
 
 	// Command: command executed when the container starts. This overrides the default command defined in the container image. This is usually the main executable, or entry point script to run.
@@ -1097,7 +1098,8 @@ type Namespace struct {
 	// UpdatedAt: last update date of the namespace.
 	UpdatedAt *time.Time `json:"updated_at"`
 
-	// Deprecated
+	// Deprecated: VpcIntegrationActivated: when activated, containers in the namespace can be connected to a Private Network.
+	// Note that activating the VPC integration can only be done when creating a new namespace.
 	VpcIntegrationActivated *bool `json:"vpc_integration_activated,omitempty"`
 }
 
@@ -1253,6 +1255,9 @@ type CreateContainerRequest struct {
 	// Tags: tags of the Serverless Container.
 	Tags []string `json:"tags"`
 
+	// PrivateNetworkID: when connected to a Private Network, the container can access other Scaleway resources in this Private Network.
+	//
+	// Note: this feature is currently in beta and requires a namespace with VPC integration activated, using the `activate_vpc_integration` flag.
 	PrivateNetworkID *string `json:"private_network_id,omitempty"`
 
 	// Command: command executed when the container starts. This overrides the default command defined in the container image. This is usually the main executable, or entry point script to run.
@@ -1315,6 +1320,7 @@ type CreateNamespaceRequest struct {
 	// Tags: tags of the Serverless Container Namespace.
 	Tags []string `json:"tags"`
 
+	// ActivateVpcIntegration: when activated, containers in the namespace can be connected to a Private Network.
 	ActivateVpcIntegration bool `json:"activate_vpc_integration"`
 }
 
@@ -1831,11 +1837,14 @@ type UpdateContainerRequest struct {
 	// Deprecated: MaxConcurrency: number of maximum concurrent executions of the container.
 	MaxConcurrency *uint32 `json:"max_concurrency,omitempty"`
 
-	// Protocol: default value: unknown_protocol
+	// Protocol: protocol the container uses.
+	// Default value: unknown_protocol
 	Protocol ContainerProtocol `json:"protocol"`
 
+	// Port: port the container listens on.
 	Port *uint32 `json:"port,omitempty"`
 
+	// SecretEnvironmentVariables: secret environment variables of the container.
 	SecretEnvironmentVariables []*Secret `json:"secret_environment_variables"`
 
 	// HTTPOption: possible values:
@@ -1863,6 +1872,9 @@ type UpdateContainerRequest struct {
 	// Tags: tags of the Serverless Container.
 	Tags *[]string `json:"tags,omitempty"`
 
+	// PrivateNetworkID: when connected to a Private Network, the container can access other Scaleway resources in this Private Network.
+	//
+	// Note: this feature is currently in beta and requires a namespace with VPC integration activated, using the `activate_vpc_integration` flag.
 	PrivateNetworkID *string `json:"private_network_id,omitempty"`
 
 	// Command: command executed when the container starts. This overrides the default command defined in the container image. This is usually the main executable, or entry point script to run.