How-to guides
Users can create the service by entering the required information for Cloud Functions and selecting detailed options through the Samsung Cloud Platform Console.
Create Cloud Functions
All Services > Compute > Cloud Functions Click the menu. 1. Navigate to the Service Home page of Cloud Functions.
On the Service Home page, click the Cloud Functions Create button. 2. Go to the Create Cloud Functions page.
Enter the information required to create the service on the Cloud Functions creation page.
Category RequiredDetailed description Funtion name required Enter the name of the Function to create - Start with a lowercase English letter and use lowercase English letters, numbers, and special characters (
-) to enter between 3 and 64 characters
Runtime Required Select Runtime creation method - Create new: Create a new Runtime
- Start with Blueprint: Write using the Runtime source code provided by the service
Runtime & Vesion required Select Runtime and Version - When Create New is selected
- Refer to the Runtime & Version list in Components > Runtime
- For the Java runtime, UI code editing is not supported, but you can import a JAR file from Object Storage and execute it
- When Start with Blueprint is selected
- You can view source code examples by clicking the View Source Code button for that Runtime & Version
- For detailed information on Blueprint settings, refer to the Blueprint Detailed Guide
- If the Runtime version has reached End of Technical Support (EoTS), settings cannot be changed after creation
Table. Cloud Functions service information input fields- Start with a lowercase English letter and use lowercase English letters, numbers, and special characters (
Summary Check the detailed information and estimated billing amount generated in the panel, and click the Create button.
- Once creation is complete, check the created resource on the Cloud Functions List page.
Check Cloud Functions detailed information
Cloud Functions Details page consists of Details, Monitoring, Logs, Code, Configuration, Triggers, Tags, Activity History tabs.
To view detailed information about the Cloud Functions service, follow these steps.
- Click the All Services > Compute > Cloud Functions menu. 1. Navigate to the Service Home page of Cloud Functions.
- On the Service Home page, click the Function menu. 2. Navigate to the Function list page.
- On the Function List page, click the resource to view detailed information. 3. Function Details navigate to the page.
- Function Details page displays status information and additional feature information, and is composed of Details, Monitoring, Logs, Code, Configuration, Triggers, Tags, Job History tabs.
Category Detailed description Cloud Functions status Cloud Functions status information - Ready: green icon, a state where normal function calls are possible
- Not Ready: gray icon, a state where normal function calls are not possible
- Deploying: yellow icon, a state where the function is being created or modified, triggering the following actions
- function creation and modification
- Code tab to edit code with the editor
- Code tab to inspect jar file
- Trigger tab to add and modify
- Configuration tab to modify
- Running: blue icon, a state where normal function calls are possible and cold start mitigation policy is applied
Service cancellation Service cancellation button Table. Cloud Functions status information and additional features
- Function Details page displays status information and additional feature information, and is composed of Details, Monitoring, Logs, Code, Configuration, Triggers, Tags, Job History tabs.
Detailed Information
Function List page lets you view detailed information of the selected resource and edit the information if needed.
| Category | Detailed description |
|---|---|
| service | Service name |
| Resource Type | Resource Type |
| SRN | Unique resource ID in Samsung Cloud Platform |
| Resource name | Resource name
|
| Resource ID | Service’s unique resource ID |
| constructor | User who created the service |
| Creation timestamp | Service creation date and time |
| Editor | User who modified the service |
| Modification date and time | Date and time the service was modified |
| Function name | Cloud Function name |
| Runtime | Runtime types and versions
|
- Even if technical support for the Runtime version ends, functions that have already been created can continue to be used without any call time limit. * However, security patches and updates for the specified Runtime version will not be applied.
- We do not guarantee bugs, errors, defects, or vulnerabilities that arise in Runtime versions that are no longer supported.
- When runtime support has been discontinued, the user must create a replacement runtime version and then manually delete the function of the previous version.
- To use this function safely, recreate it using the Lastest or Stable version.
AIOS service removed due to deprecation. | LLM Endpoint | Click User Guide to view LLM Endpoint information and usage instructions. |
–>
Monitoring
On the Function list page, you can view the Cloud Functions usage information for the selected resource.
| Category | Detailed description |
|---|---|
| Call count | Average number of times the function is called per unit time (instances) |
| execution time | Average execution time (seconds) of the function per unit time |
| Memory usage | Average memory usage (KB) during the function execution per unit time |
| Current work count | When a function is called multiple times simultaneously, the average number of tasks (instances) generated per unit time for concurrent processing. |
| Successful call count | Average number of times (instances) the runtime code operated correctly and delivered a response code per unit time when the function is called. |
| Failed call count | Average number of calls during which errors occurred per unit time when the function is invoked
|
log
Function list page lets you view the Cloud Functions logs of the selected resource.
| Category | Detailed description |
|---|---|
| unit period | Select the period to view Cloud Functions log information
|
| log message | Functions are displayed in order starting from the most recent occurrence. |
code
Function list page allows you to view and modify the Cloud Functions code of the selected resource.
The way source code is viewed and edited varies depending on the runtime used.
- Inline Editor: Node.js, Python, PHP, Go
- Execute compressed file (.jar/.zip): Java
| Category | Detailed description |
|---|---|
| source code | Inline editor method |
| Code information | Display code information |
| Edit | After clicking the Edit button, you can modify the code in the inline editor. |
| Category | Detailed description |
|---|---|
| source code | Execution method for compressed files (.jar/.zip) |
| Code information | Display compressed file information
|
| Edit | The Jar file can be modified
|
- If technical support for the Runtime version has ended, you cannot modify the code. * Also, because security patches and updates are not applied, create and use a new instance of the function with the Latest or Stable version to ensure safe usage.
- In the case of Java Runtime, it does not provide a UI code editing feature, and you must select a compressed file (.jar/.zip) from a bucket in the Object Storage service.
- For users whose authentication key for the Object Storage service has not been generated, Import from Object Storage cannot be executed, so the authentication key must be created in advance.
- For detailed information on creating an authentication key, see Creating an Authentication Key.
- You must change the Object Storage bucket’s access control for the Cloud Functions service to allow.
- For detailed information on Object Storage access control, please refer to Allow Cloud Functions Service Access.
Configuration
Function List page allows you to view the Cloud Functions configuration of the selected resource.
| Category | Detailed description |
|---|---|
| General configuration | Memory and timeout settings for Cloud Functions
|
| function URL | Issue an HTTPS URL address that can access the function
|
| environment variable | Set runtime environment variables
|
| Private connection configuration | PrivateLink Service Integration Information
|
| Permission | Adding and Managing Resource Policies for IAM-Based Functions |
- To modify the configuration items of Cloud Functions, refer to Cloud Functions 구성 관리하기.
- For detailed information about configuring Private connections, see PrivateLink 서비스 연계하기.
- If technical support for the Runtime version has ended, you cannot modify configuration items. * Also, because security patches and updates are not applied, create and use a new instance of the function with the Lastest or Stable version for safe usage.
- Access Control is disabled, the registered access information is deleted, making function access control impossible, which can expose the system to security attacks such as external scanning, hacking, and other threats.
- The number of CPU cores proportional to the memory allocation of General configuration is automatically assigned.
- General configuration’s minimum execution count of 1 or more prevents Cold Start, but incurs continuous costs.
Trigger
Function list page lets you view and configure the trigger information of the selected resource. By setting a trigger, you can automatically execute the Function when an event occurs.
| Category | Detailed description |
|---|---|
| Cronjob | Use Cronjob as a trigger
|
| API Gateway | Use API Gateway as a trigger
|
- If technical support for the Runtime version has ended, you cannot modify the trigger item. * Also, because security patches and updates are not applied, create and use a new instance with the Lastest or Stable version to use the function safely.
- If the Cronjob trigger is invoked before the function’s timeout, the function will execute concurrently, increasing the number of executions and the total time. * Therefore, be careful as ongoing additional costs can accrue, leading to high expenses.
- If the status is Deploying, it cannot be edited.
- Please refer to Trigger Setup for trigger configuration.
Tag
Tag tab allows you to view, add, modify, or delete resource tag information.
| Category | Detailed description |
|---|---|
| Tag list | Tag list
|
Job History
On the Work History page, you can view the resource’s work history.
| Category | Detailed description |
|---|---|
| Task History List | Resource Change History
|
Changing Java Runtime code
When using the Java Runtime, you cannot modify the code directly, so you must select and replace the compressed file (.jar/.zip) in the Object Storage service bucket.
To modify a compressed file, follow these steps.
Click the All Services > Compute > Cloud Functions menu. 1. Navigate to the Service Home page of Cloud Functions.
Click the Function menu on the Service Home page. 2. Function list go to the page.
Function List page, click the resource to change the compressed file in the code. 3. Go to the Function Details page.
On the Function Details page, click the Edit button in the Code tab. 4. Go to the Edit Function Code page.
Import from Object Storage Click the button. 5. Import from Object Storage The popup window opens.
Category Detailed description Java Runtime Java Runtime Information Handler information Handler Information - Execution Class: Automatically entered when setting the archive file (.jar/.zip)
- Execution Method: Automatically entered when setting the archive file (.jar/.zip)
Compressed file (.jar/.zip) Set the archive file to be changed - Archive file name (.jar/.zip): Displays the name of the archive file. Object Storage retrieval: After setting, it is entered automatically
- Object Storage retrieval: Object Storage settings to retrieve the archive file (.jar/.zip)
Table. Cloud Functions Details - Function Code Modification ItemsEnter the URL information of the Object Storage from which to retrieve the compressed file, and click the Confirm button. 6. The notification popup opens.
- You can find the URL information in the Folder List tab of the Object Storage detail page, under the File Info > Private URL item.
Click the Confirm button. 7. On the Function code edit page, the compressed file name (.jar/.zip) shows the name of the imported archive.
Click the Save button.
- If a user’s authentication key has not been generated, they cannot execute Retrieve from Object Storage.
- If the URL does not exist or the archive file matches any of the following, it cannot be changed.
- When using an unsupported file extension
- If the compressed file contains harmful files.
- If the size exceeds the supported limit
Managing Cloud Functions Configuration
Edit General Configuration
You can view and modify the memory and timeout settings of the Cloud Function. To modify the general configuration, follow these steps.
Click the All Services > Compute > Cloud Functions menu. 1. Navigate to the Service Home page of Cloud Functions.
On the Service Home page, click the Function menu. 2. Go to the Function list page.
Function list page, click the resource you want to edit the configuration for. 3. Navigate to the Function Details page.
On the Function Details page, click the Configuration tab and select the General Configuration item. 4. General Configuration information is displayed.
Click the Edit button. 5. General Configuration Edit The popup window opens.
General configuration edit After editing the information in the popup window, click the Confirm button.
Category RequiredDetailed description Memory required Set the maximum memory limit per function - 128 MB, 256 MB, 512 MB, 1,024 MB selectable
Time limit Selection Maximum time to wait for a call per Function - Enter a value between 1 ~ 300
Run function required Minimum and Maximum Task Count - Minimum Task Count: Enter a value between 0 ~ 50
- Maximum Task Count: Enter a value between 1 ~ 50
- Maximum Task Count must be set to a value greater than Minimum Task Count
Table. General configuration modification itemsCautionWhen the function execution is set to 1 or more, computing costs are incurred even if the function is not called, to maintain the pre‑execution environment.When the edit notification popup opens, click the Confirm button.
Edit function URL
You can view and modify the HTTPS URL address that accesses the Cloud Function. To modify the function URL, follow these steps.
Click the All Services > Compute > Cloud Functions menu. 1. Navigate to the Service Home page of Cloud Functions.
On the Service Home page, click the Function menu. 2. Go to the Function list page.
On the Function list page, click the resource to edit the function URL. 3. Navigate to the Function Details page.
On the Function Details page, click the Function URL item in the Configuration tab. 4. Function URL information is displayed.
Click the Edit button. 5. Edit Function URL The popup window opens.
Edit Function URL After editing the information in the popup window, click the Confirm button.
Category RequiredDetailed description Activation status Selection Set function URL activation status Authentication type required Authentication type setting - IAM: Only authenticated IAM users can access the function URL
- None: No IAM authentication is performed for function URL requests
Access control Selection Access control usage setting - When enabled, you can register and manage accessible IPs
Allow public access - List of IPs accessible when using access control - After entering an accessible IP, click the Add button to register it in the list
- Click the X of an IP in the list or click the Delete All button to remove the IP
Table. Function URL edit itemsCaution- If access control is not used, the registered access information will be deleted, making function access control impossible, and it may be exposed to security attacks such as external scanning and hacking.
- Refer to the OpenAPI of Samsung Cloud Platform.
When the edit notification popup opens, click the Confirm button.
Modify environment variables
You can view and modify the runtime environment variables of Cloud Functions. To modify environment variables, follow these steps.
All Services > Compute > Cloud Functions menu, click it. 1. Go to the Service Home page of Cloud Functions.
Click the Function menu on the Service Home page. 2. Go to the Function list page.
On the Function list page, click the resource to edit the function URL. 3. Function Details navigate to the page.
On the Function Details page, click the Environment Variables item in the Configuration tab. 4. environment variable information is displayed.
Click the Edit button. 5. Edit Environment Variables A popup window opens.
Edit Environment Variables After editing the information in the popup window, click the OK button.
Category RequiredDetailed description Name / Value required Set the environment variable name and value - Name: Start with an English letter and use numbers or special characters (. _ -) up to 50 characters
- Value: Enter up to 50 characters
- Add button to click to add environment variables
Server-side environment variable encryption Selection Configure whether to use encryption for environment variables User KMS key - When using server-side environment variable encryption, configure - Select an existing KMS key
- New creation: Go to the Key Management Service page to create a new key
Table: Environment Variable Modification ItemsReferenceA KMS key cannot be used in the following cases.
- When you lack IAM permissions
- When disabled
- If it is in a creating or pending deletion state
- If an error occurs and the system is in an error state
- If deleted or invalid
When the edit notification popup opens, click the Confirm button.
Edit Private Connection Configuration
You can view and modify the Private connection configuration of Cloud Functions.
To change whether to use a Private connection, follow these steps.
- All Services > Compute > Cloud Functions Click the menu. 1. Navigate to the Service Home page of Cloud Functions.
- On the Service Home page, click the Function menu. 2. Navigate to the Function list page.
- On the Function List page, click the resource to change the Private connection usage. 3. Go to the Function Details page.
- On the Function Details page, click the Private Connection Configuration item in the Configuration tab. 4. Private connection configuration information is displayed.
- Click the Edit button. 5. PrivateLink Service Edit The popup window opens.
- PrivateLink Service Edit popup, after changing the activation status, click the Confirm button.
- When the edit notification popup opens, click the Confirm button.
Edit Permissions
You can check the permissions of Cloud Functions and add and manage resource policies for IAM-based functions. To modify permissions, follow the steps below.
All Services > Compute > Cloud Functions Click the menu. 1. Navigate to the Service Home page of Cloud Functions.
On the Service Home page, click the Function menu. 2. Navigate to the Function list page.
Function list page, click the resource to modify its permissions. 3. Go to the Function Details page.
On the Function Details page, click the Permission item in the Configuration tab. 4. Permission information is displayed.
Click the Edit button of the Resource Policy. 5. Edit Resource Policy The popup window opens.
- If there is no configured resource policy, Add Resource Policy popup opens, allowing you to add a new resource policy.
Edit Resource Policy After modifying the information in the popup window, click the Confirm button.
Category RequiredDetailed description Policy Template required You can load a policy template provided by Cloud Functions or select custom to write one yourself. JSON editor Selection Review and edit the policy template code, or write it directly. Delete - Delete the resource policy currently being edited Table. Resource policy modification itemsWhen the popup notifying the edit opens, click the Confirm button.
Terminate Cloud Functions
To cancel the Cloud Functions service, follow these steps.
- Click the All Services > Compute > Cloud Functions menu. 1. Navigate to the Service Home page of Cloud Functions.
- On the Service Home page, click the Function menu. 2. Go to the Function List page.
- Function List on the page, click the resource to be terminated and click the Service Termination button.
- After the termination is complete, check on the Function List page whether the resource has been terminated.