How-to guides

• 1: 트리거 설정하기
• 2: AIOS 연계하기
• 3: Blueprint 상세 가이드
• 4: PrivateLink 서비스 연계하기
• 5: 리소스 기반 정책 가이드

1 - 트리거 설정하기

트리거 설정하기

Cronjob 트리거 설정하기

Cronjob 트리거를 설정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 트리거를 설정할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. 트리거 탭을 클릭한 후, 트리거 추가 버튼을 클릭하세요.로 설정하세요. 트리거 추가 팝업창이 열립니다.
5. 트리거 추가 팝업창에서 트리거 종류에서 Cronjob을 선택하세요. 하단에 필수 정보 입력 영역이 나타납니다.

   구분	상세 설명
   Cronjob 설정	트리거의 반복 빈도를 설정 분, 시간, 일, 월, 요일 단위로 설정 가능
   Timezone 설정	트리거의 기준 시간대를 설정

   표. Cronjob 트리거 필수 정보 항목
6. 필수 정보를 입력한 후, 확인 버튼을 클릭하세요.
7. 추가를 알리는 팝업창이 열리면 확인 버튼을 클릭하세요.

API Gateway 트리거 설정하기

API Gateway 트리거를 설정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 트리거를 설정할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. 트리거 탭을 클릭한 후, 트리거 추가 버튼을 클릭하세요.로 설정하세요. 트리거 추가 팝업창이 열립니다.
5. 트리거 추가 팝업창에서 트리거 종류에서 API Gateway을 선택하세요. 하단에 필수 정보 입력 영역이 나타납니다.

   구분	상세 설명
   API명	API 선택 기존에 생성된 API를 선택하거나 새로 생성 가능
   스테이지	배포 대상 선택 기존에 생성된 스테이지를 선택하거나 새로 생성 가능

   표. API Gateway 트리거 필수 정보 항목
6. 필수 정보를 입력한 후, 확인 버튼을 클릭하세요.
7. 추가를 알리는 팝업창이 열리면 확인 버튼을 클릭하세요.

멀티 트리거 설정하기

하나의 함수에 여러개의 트리거를 연결하여 사용할 수 있습니다.

트리거 수정하기

추가된 트리거를 수정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 트리거를 수정할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. 트리거 탭을 클릭한 후, 트리거 목록에서 설정값을 수정할 트리거의 수정 버튼을 클릭하세요. 트리거 수정 팝업창이 열립니다.
5. 트리거 수정 팝업창에서 설정값을 수정한 후, 확인 버튼을 클릭하세요.
   • 설정값은 트리거의 종류에 따라 달라집니다(Cronjob 트리거, API Gateway 트리거 참고).
6. 수정을 알리는 팝업창이 열리면 확인을 클릭하세요.

트리거 삭제하기

트리거를 삭제하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 트리거를 설정할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. 트리거 탭의 트리거 목록에서 삭제할 트리거를 선택한 후, 삭제 버튼을 클릭하세요.
5. 트리거 삭제를 알리는 팝업창이 열리면 확인 버튼을 클릭하세요.

2 - AIOS 연계하기

AIOS 연계하기

Cloud Functions와 AIOS를 연계하여 LLM을 활용할 수 있습니다.

AIOS LLM 프라이빗 엔드포인트

AIOS LLM 프라이빗 엔드포인트의 URL은 다음과 같습니다.

• Samsung Cloud Platform for Samsung: https://aios.private.kr-west1.s.samsungsdscloud.com
• Samsung Cloud Platform for Enterprise: https://aios.private.kr-west1.e.samsungsdscloud.com

Blueprint 소스코드 변경하기

Cloud Functions와 AIOS를 연계하려면 각 리전 내 사용하는 LLM Endpoint에 맞춰 Blueprint에 있는 URL 주소를 변경해야 합니다. Blueprint 소스코드를 변경하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Cloud Functions 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 URL로 호출할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. 코드 탭을 클릭하여 이동한 후, 수정 버튼을 클릭하세요. Function 코드 수정 페이지로 이동합니다.
5. Python, Node.js, Go Runtime 소스코드를 사용하여 Blueprint를 변경한 후, 저장 버튼을 클릭하세요.
   • Python 소스코드
     • Python

     Sample Code Download

     Copy Code

     배경색 변경

     import json
     import requests
     
     def handle_request(params):
       # User writing area (Function details)
       url = "{AIOS LLM 프라이빗 엔드포인트}/{API}" # Destination URL
       data = { "model": "openai/gpt-oss-120b"
         , "prompt" : "Write a haiku about recursion in programming."
         , "temperature": 0
         , "max_tokens": 100
         , "stream": False
       }
       try:
         response = requests.post(url, json=data, verify=True)
     
         return {
           'statusCode': response.status_code,
           'body': json.dumps(response.text)
         }
       except requests.exceptions.RequestException as e:
         return str(e)

     import json
     import requests
     
     def handle_request(params):
       # User writing area (Function details)
       url = "{AIOS LLM 프라이빗 엔드포인트}/{API}" # Destination URL
       data = { "model": "openai/gpt-oss-120b"
         , "prompt" : "Write a haiku about recursion in programming."
         , "temperature": 0
         , "max_tokens": 100
         , "stream": False
       }
       try:
         response = requests.post(url, json=data, verify=True)
     
         return {
           'statusCode': response.status_code,
           'body': json.dumps(response.text)
         }
       except requests.exceptions.RequestException as e:
         return str(e)

   • Node.js 소스코드
     • Node.js

     Sample Code Download

     Copy Code

     배경색 변경

     const request = require('request');
     
     /**
     * @description User writing area (Function details)
     */
     exports.handleRequest = async function (params) {
     return await sendRequest(params);
     };
     
     async function sendRequest(req) {
       return new Promise((resolve, reject) => {
         url = "{AIOS LLM 프라이빗 엔드포인트}/{API}"
         data = { model: 'openai/gpt-oss-120b'
           , prompt : 'Write a haiku about recursion in programming.'
           , temperature: 0
           , max_tokens: 100
           , stream: false
         }
     
         const options = {
           uri: url,
           method:'POST',
           body: data,
           json: true,
           strictSSL: false,
           rejectUnauthorized: false
         }
         
         request(options, (error, response, body) => {
           if (error) {
             reject(error);
           } else {
             resolve({
               statusCode: response.statusCode,
               body: JSON.stringify(body)
             });
           }
         });
       });
     }

     const request = require('request');
     
     /**
     * @description User writing area (Function details)
     */
     exports.handleRequest = async function (params) {
     return await sendRequest(params);
     };
     
     async function sendRequest(req) {
       return new Promise((resolve, reject) => {
         url = "{AIOS LLM 프라이빗 엔드포인트}/{API}"
         data = { model: 'openai/gpt-oss-120b'
           , prompt : 'Write a haiku about recursion in programming.'
           , temperature: 0
           , max_tokens: 100
           , stream: false
         }
     
         const options = {
           uri: url,
           method:'POST',
           body: data,
           json: true,
           strictSSL: false,
           rejectUnauthorized: false
         }
         
         request(options, (error, response, body) => {
           if (error) {
             reject(error);
           } else {
             resolve({
               statusCode: response.statusCode,
               body: JSON.stringify(body)
             });
           }
         });
       });
     }

   • GO 소스코드
     • GO

     Sample Code Download

     Copy Code

     배경색 변경

     package gofunction
     
     import (
       "bytes"
       "net/http"
       "encoding/json"
       "io/ioutil"
     )
     
     type PostData struct {
       Model string `json:"model"`
       Prompt string `json:"prompt"`
       Temperature int `json:"temperature"`
       MaxTokens int `json:"max_tokens"`
       Stream bool `json:"stream"`
     }
     
     func HandleRequest(r *http.Request)(string, error) {
       url := "{AIOS LLM 프라이빗 엔드포인트}/{API}"
       data := PostData {
         Model: "openai/gpt-oss-120b",
         Prompt: "Write a haiku about recursion in programming.",
         Temperature: 0,
         MaxTokens: 100,
         Stream: false,
       }
       
       jsonData, err := json.Marshal(data)
       if err != nil {
         panic(err)
       }
     
       req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
       if err != nil {
         panic(err)
       }
     
       req.Header.Set("Content-Type", "application/json")
     
       client := &http.Client{}
       resp, err := client.Do(req)
       if err != nil {
         panic(err)
       }
       defer resp.Body.Close()
     
       // 응답 본문 읽기
       body, err := ioutil.ReadAll(resp.Body)
       if err != nil {
         panic(err)
       }
     
       return string(body), nil
     }

     package gofunction
     
     import (
       "bytes"
       "net/http"
       "encoding/json"
       "io/ioutil"
     )
     
     type PostData struct {
       Model string `json:"model"`
       Prompt string `json:"prompt"`
       Temperature int `json:"temperature"`
       MaxTokens int `json:"max_tokens"`
       Stream bool `json:"stream"`
     }
     
     func HandleRequest(r *http.Request)(string, error) {
       url := "{AIOS LLM 프라이빗 엔드포인트}/{API}"
       data := PostData {
         Model: "openai/gpt-oss-120b",
         Prompt: "Write a haiku about recursion in programming.",
         Temperature: 0,
         MaxTokens: 100,
         Stream: false,
       }
       
       jsonData, err := json.Marshal(data)
       if err != nil {
         panic(err)
       }
     
       req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
       if err != nil {
         panic(err)
       }
     
       req.Header.Set("Content-Type", "application/json")
     
       client := &http.Client{}
       resp, err := client.Do(req)
       if err != nil {
         panic(err)
       }
       defer resp.Body.Close()
     
       // 응답 본문 읽기
       body, err := ioutil.ReadAll(resp.Body)
       if err != nil {
         panic(err)
       }
     
       return string(body), nil
     }

3 - Blueprint 상세 가이드

Blueprint 개요

Cloud Functions 생성 시 Blueprint를 설정하여 Cloud Functions에서 제공하는 Runtime 소스코드를 활용할 수 있습니다. Cloud Functions에서 제공하는 Blueprint 항목은 다음을 참조하세요.

Hello World

Hello World 응답 받기 설정 및 함수 호출 예시(함수 URL 이용)를 설명합니다.

Hello World 설정하기

Hello World를 설정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.

2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.

3. Function 목록 페이지에서 URL로 호출할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.

4. 구성 탭을 클릭한 후, 함수 URL 항목의 수정 버튼을 클릭하세요. 함수 URL 수정 팝업창이 열립니다.

5. 함수 URL 수정 팝업창에서 활성화 여부를 사용으로 설정한 후, 확인 버튼을 클릭하세요.

   구분	상세 설명
   활성화 여부	함수 URL의 사용 여부를 설정
   인증 유형	함수 URL에 대한 요청 시 IAM 인증 사용 여부 선택
   접근 제어	접근 가능한 IP를 추가하여 관리 가능 사용으로 설정한 후, 퍼블릭 접근 IP 입력 및 추가 가능

   표. 트리거 추가 시 필수 입력 항목

6. 코드 탭으로 이동한 후, 수정 버튼을 클릭하세요. Function 코드 수정 페이지로 이동합니다.

7. 성공 및 실패 케이스에 대한 처리 로직을 추가한 후, 저장 버튼을 클릭하세요.

   • Node.js 소스코드
     • Node.js

     Sample Code Download

     Copy Code

     배경색 변경

     exports.handleRequest = async function (params) {
         /**
         * @description User writing area (Function details)
         */
         const response = {
         statusCode: 200,
         body: JSON.stringify('Hello Serverless World!'),
         };
         return response;
     };

     exports.handleRequest = async function (params) {
         /**
         * @description User writing area (Function details)
         */
         const response = {
         statusCode: 200,
         body: JSON.stringify('Hello Serverless World!'),
         };
         return response;
     };

   • Python 소스코드
     • Python

     Sample Code Download

     Copy Code

     배경색 변경

     import json
     
     def handle_request(params):
         # User writing area (Function details)
         return {
         'statusCode': 200,
         'body': json.dumps('Hello Serverless World!')
         }

     import json
     
     def handle_request(params):
         # User writing area (Function details)
         return {
         'statusCode': 200,
         'body': json.dumps('Hello Serverless World!')
         }

   • PHP 소스코드
     • PHP

     Sample Code Download

     Copy Code

     배경색 변경

     <?php
     function handle_request() {
         # User writing area (Function details)
         $res = array(
             'statusCode' => 200,
             'body' => 'Hello Serverless World!',
         );
         return $res;
     }
     ?>
     

     <?php
     function handle_request() {
         # User writing area (Function details)
         $res = array(
             'statusCode' => 200,
             'body' => 'Hello Serverless World!',
         );
         return $res;
     }
     ?>
     

함수 호출 확인하기

Function 상세 페이지의 구성 탭에서 함수 URL을 호출한 후, 응답을 확인합니다.

Hello Serverless World!

Execution after timeout

제한시간 이후 함수 실행(Execution after timeout) 설정 및 함수 호출 예시(함수 URL 사용)를 설명합니다.

Execution after timeout 설정하기

Execution after timeout을 설정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 트리거를 설정할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. 트리거 탭을 클릭한 후, 트리거 추가 버튼을 클릭하세요. 트리거 추가 팝업창이 열립니다.
5. 트리거 추가 팝업창에서 트리거 종류 항목을 선택한 후, 하단에 표시되는 필수 정보를 입력하고 확인 버튼을 클릭하세요.
   • 필수 정보는 트리거 종류에 따라 달라집니다.

     트리거 종류	입력 항목
     API Gateway	API명: 기존에 생성된 API를 선택하거나 새로 생성 가능 스테이지: 기존에 생성된 스테이지를 선택하거나 새로 생성 가능
     Cronjob	예시를 참고하여 트리거의 반복 빈도(분, 시, 일, 월, 요일)를 입력 Timezone 설정: 적용할 기준 시간대를 선택

     표. 트리거 추가 시 필수 입력 항목
6. 코드 탭으로 이동한 후, 수정 버튼을 클릭하세요. Function 코드 수정 페이지로 이동합니다.
7. 성공 및 실패 케이스에 대한 처리 로직을 추가한 후, 저장 버튼을 클릭하세요.
   • Node.js 소스코드
     • Node.js

     Sample Code Download

     Copy Code

     배경색 변경

     exports.handleRequest = async function (params) {
         /**
          * @description User writing area (Function details)
          */
         console.log("Hello world 3");
         await delay(3000);
     
         const response = {
             statusCode: 200,
             body: JSON.stringify('Hello Serverless World!'),
         };
         return response;
     };
     
     const delay = (ms) => {
         return new Promise(resolve=>{
             setTimeout(resolve,ms)
         })
     }

     exports.handleRequest = async function (params) {
         /**
          * @description User writing area (Function details)
          */
         console.log("Hello world 3");
         await delay(3000);
     
         const response = {
             statusCode: 200,
             body: JSON.stringify('Hello Serverless World!'),
         };
         return response;
     };
     
     const delay = (ms) => {
         return new Promise(resolve=>{
             setTimeout(resolve,ms)
         })
     }

함수 호출 확인하기

Function 상세 페이지의 구성 탭에서 함수 URL을 호출하고 일정 시간이 지난 후, 응답을 확인합니다.

Hello Serverless World!

HTTP request body

Request Body 파싱하기 설정 및 함수 호출 예시(함수 URL 사용)를 설명합니다.

HTTP request body 설정하기

HTTP request body를 설정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 트리거를 설정할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. 트리거 탭을 클릭한 후, 트리거 추가 버튼을 클릭하세요. 트리거 추가 팝업창이 열립니다.
5. 트리거 추가 팝업창에서 트리거 종류 항목을 선택한 후, 하단에 표시되는 필수 정보를 입력하고 확인 버튼을 클릭하세요.
   • 필수 정보는 트리거 종류에 따라 달라집니다.

     트리거 종류	입력 항목
     API Gateway	API명: 기존에 생성된 API를 선택하거나 새로 생성 가능 스테이지: 기존에 생성된 스테이지를 선택하거나 새로 생성 가능
     Cronjob	예시를 참고하여 트리거의 반복 빈도(분, 시, 일, 월, 요일)를 입력 Timezone 설정: 적용할 기준 시간대를 선택

     표. 트리거 추가 시 필수 입력 항목
6. 코드 탭으로 이동한 후, 수정 버튼을 클릭하세요. Function 코드 수정 페이지로 이동합니다.
7. 성공 및 실패 케이스에 대한 처리 로직을 추가한 후, 저장 버튼을 클릭하세요.
   • Node.js 소스코드
     • Node.js

     Sample Code Download

     Copy Code

     배경색 변경

     exports.handleRequest = async function (params) {
         /**
         * @description User writing area (Function details)
         */
         const response = {
         statusCode: 200,
         body: JSON.stringify(params.body),
         };
         return response;
     };

     exports.handleRequest = async function (params) {
         /**
         * @description User writing area (Function details)
         */
         const response = {
         statusCode: 200,
         body: JSON.stringify(params.body),
         };
         return response;
     };

   • Python 소스코드
     • Python

     Sample Code Download

     Copy Code

     배경색 변경

     import json
     
     def handle_request(params):
         # User writing area (Function details)
         return {
             'statusCode': 200,
             'body': json.dumps(params.json)
     }

     import json
     
     def handle_request(params):
         # User writing area (Function details)
         return {
             'statusCode': 200,
             'body': json.dumps(params.json)
     }

함수 호출 확인하기

Function 상세 페이지의 구성 탭에서 함수 URL을 호출한 후, Body 데이터와 요청 Body값, 응답 Body값을 확인합니다.

• 요청 Body값

  Sample Code Download

  Copy Code

  배경색 변경

  {
      "testKey" :"cloud-001",
      "testNames": [
          {
              "name": "Son"
          },
          {
              "name": "Kim"
          }
      ],
      "testCode":"test"
  }

  {
      "testKey" :"cloud-001",
      "testNames": [
          {
              "name": "Son"
          },
          {
              "name": "Kim"
          }
      ],
      "testCode":"test"
  }

• 응답 Body값

  Sample Code Download

  Copy Code

  배경색 변경

  {
      "testKey" :"cloud-001",
      "testNames": [
          {
              "name": "Son"
          },
          {
              "name": "Kim"
          }
      ],
      "testCode":"test"
  }

  {
      "testKey" :"cloud-001",
      "testNames": [
          {
              "name": "Son"
          },
          {
              "name": "Kim"
          }
      ],
      "testCode":"test"
  }

Send HTTP requests

HTTP 요청하기 설정 및 함수 호출 예시(함수 URL 사용)를 설명합니다.

Send HTTP requests 설정하기

Send HTTP requests를 설정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 트리거를 설정할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. 트리거 탭을 클릭한 후, 트리거 추가 버튼을 클릭하세요. 트리거 추가 팝업창이 열립니다.
5. 트리거 추가 팝업창에서 트리거 종류 항목을 선택한 후, 하단에 표시되는 필수 정보를 입력하고 확인 버튼을 클릭하세요.
   • 필수 정보는 트리거 종류에 따라 달라집니다.

     트리거 종류	입력 항목
     API Gateway	API명: 기존에 생성된 API를 선택하거나 새로 생성 가능 스테이지: 기존에 생성된 스테이지를 선택하거나 새로 생성 가능
     Cronjob	예시를 참고하여 트리거의 반복 빈도(분, 시, 일, 월, 요일)를 입력 Timezone 설정: 적용할 기준 시간대를 선택
     표. 트리거 추가 시 필수 입력 항목

6. 코드 탭으로 이동한 후, 수정 버튼을 클릭하세요. Function 코드 수정 페이지로 이동합니다.
7. 성공 및 실패 케이스에 대한 처리 로직을 추가한 후, 저장 버튼을 클릭하세요.
   • Node.js 소스코드
     • Node.js

     Sample Code Download

     Copy Code

     배경색 변경

     const request = require('request');
     
     /**
     * @description User writing area (Function details)
     */
     exports.handleRequest = async function (params) {
     return await sendRequest(params);
     };
     
     async function sendRequest(req) {
         return new Promise((resolve, reject) => {
             // Port 80 and Port 443 are available
             url = "https://example.com"; // Destination URL
     
                 const options = {
                 uri: url,
                 method:'GET',
                 json: true,
                 strictSSL: false,
                 rejectUnauthorized: false
             }
             request(options, (error, response, body) => {
                 if (error) {
                     reject(error);
                 } else {
                     resolve({
                         statusCode: response.statusCode,
                         body: JSON.stringify(body)
                     });
                 }
             });
         });
     }

     const request = require('request');
     
     /**
     * @description User writing area (Function details)
     */
     exports.handleRequest = async function (params) {
     return await sendRequest(params);
     };
     
     async function sendRequest(req) {
         return new Promise((resolve, reject) => {
             // Port 80 and Port 443 are available
             url = "https://example.com"; // Destination URL
     
                 const options = {
                 uri: url,
                 method:'GET',
                 json: true,
                 strictSSL: false,
                 rejectUnauthorized: false
             }
             request(options, (error, response, body) => {
                 if (error) {
                     reject(error);
                 } else {
                     resolve({
                         statusCode: response.statusCode,
                         body: JSON.stringify(body)
                     });
                 }
             });
         });
     }

   • Python 소스코드
     • Python

     Sample Code Download

     Copy Code

     배경색 변경

     import json
     import requests
     
     def handle_request(params):
         # User writing area (Function details)
         
         # Port 80 and Port 443 are available
         url = "https://example.com" # Destination URL
     
         try:
             response = requests.get(url, verify=True)
             return {
                 'statusCode': response.status_code,
                 'body': json.dumps(response.text)
             }
         except requests.exceptions.RequestException as e:
             return str(e)

     import json
     import requests
     
     def handle_request(params):
         # User writing area (Function details)
         
         # Port 80 and Port 443 are available
         url = "https://example.com" # Destination URL
     
         try:
             response = requests.get(url, verify=True)
             return {
                 'statusCode': response.status_code,
                 'body': json.dumps(response.text)
             }
         except requests.exceptions.RequestException as e:
             return str(e)

함수 호출 확인하기

Function 상세 페이지의 구성 탭에서 함수 URL을 호출한 후, 응답을 확인합니다.

<!doctype html>
<html>
<head>
    <title>Example Domain</title>

    <meta charset="utf-8" />
    <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <style type="text/css">
    body {
        background-color: #f0f0f2;
        margin: 0;
        padding: 0;
        font-family: -apple-system, system-ui, BlinkMacSystemFont, "Segoe UI", "Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif;
    }
    div {
        width: 600px;
        margin: 5em auto;
        padding: 2em;
        background-color: #fdfdff;
        border-radius: 0.5em;
        box-shadow: 2px 3px 7px 2px rgba(0,0,0,0.02);
    }
    a:link, a:visited {
        color: #38488f;
        text-decoration: none;
    }
    @media (max-width: 700px) {
        div {
            margin: 0 auto;
            width: auto;
        }
    }
    </style>
</head>

<body>
<div>
    <h1>Example Domain</h1>

    <p>This domain is for use in illustrative examples in documents. You may use this
    domain in literature without prior coordination or asking for permission.</p>
    <p><a href="https://www.iana.org/domains/example">More information...</a></p>
</div>
</body>
</html>

<!doctype html>
<html>
<head>
    <title>Example Domain</title>

    <meta charset="utf-8" />
    <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <style type="text/css">
    body {
        background-color: #f0f0f2;
        margin: 0;
        padding: 0;
        font-family: -apple-system, system-ui, BlinkMacSystemFont, "Segoe UI", "Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif;
    }
    div {
        width: 600px;
        margin: 5em auto;
        padding: 2em;
        background-color: #fdfdff;
        border-radius: 0.5em;
        box-shadow: 2px 3px 7px 2px rgba(0,0,0,0.02);
    }
    a:link, a:visited {
        color: #38488f;
        text-decoration: none;
    }
    @media (max-width: 700px) {
        div {
            margin: 0 auto;
            width: auto;
        }
    }
    </style>
</head>

<body>
<div>
    <h1>Example Domain</h1>

    <p>This domain is for use in illustrative examples in documents. You may use this
    domain in literature without prior coordination or asking for permission.</p>
    <p><a href="https://www.iana.org/domains/example">More information...</a></p>
</div>
</body>
</html>

Print logs

Log 출력하기 설정 및 함수 호출 예시(함수 URL 사용)를 설명합니다.

Print logs 설정하기

Print logs 응답 받기를 설정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 트리거를 설정할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. 트리거 탭을 클릭한 후, 트리거 추가 버튼을 클릭하세요. 트리거 추가 팝업창이 열립니다.
5. 트리거 추가 팝업창에서 트리거 종류 항목을 선택한 후, 하단에 표시되는 필수 정보를 입력하고 확인 버튼을 클릭하세요.
   • 필수 정보는 트리거 종류에 따라 달라집니다.

     트리거 종류	입력 항목
     API Gateway	API명: 기존에 생성된 API를 선택하거나 새로 생성 가능 스테이지: 기존에 생성된 스테이지를 선택하거나 새로 생성 가능
     Cronjob	예시를 참고하여 트리거의 반복 빈도(분, 시, 일, 월, 요일)를 입력 Timezone 설정: 적용할 기준 시간대를 선택
     표. 트리거 추가 시 필수 입력 항목

6. 코드 탭으로 이동한 후, 수정 버튼을 클릭하세요. Function 코드 수정 페이지로 이동합니다.
7. 성공 및 실패 케이스에 대한 처리 로직을 추가한 후, 저장 버튼을 클릭하세요.
   • Node.js 소스코드
     • Node.js

     Sample Code Download

     Copy Code

     배경색 변경

     const winston = require('winston');
     
     // Log module setting
     const logger = winston.createLogger({
         format: winston.format.combine(
             winston.format.timestamp(),
             winston.format.printf(info => info.timestamp + ' ' + info.level + ': ' + info.message)
             ),
             transports: [
                 new winston.transports.Console()
                 ]
     });
     
     exports.handleRequest = async function (params) {
         /**
         * @description User writing area (Function details)
         */
         const response = {
             statusCode: 200,
             body: JSON.stringify(params.body),
         };
     
         logger.info(JSON.stringify(response, null, 2));
     
         return response;
     };

     const winston = require('winston');
     
     // Log module setting
     const logger = winston.createLogger({
         format: winston.format.combine(
             winston.format.timestamp(),
             winston.format.printf(info => info.timestamp + ' ' + info.level + ': ' + info.message)
             ),
             transports: [
                 new winston.transports.Console()
                 ]
     });
     
     exports.handleRequest = async function (params) {
         /**
         * @description User writing area (Function details)
         */
         const response = {
             statusCode: 200,
             body: JSON.stringify(params.body),
         };
     
         logger.info(JSON.stringify(response, null, 2));
     
         return response;
     };

   • Python 소스코드
     • Python

     Sample Code Download

     Copy Code

     배경색 변경

     import json
     import logging
     
     # Log module setting
     logging.basicConfig(level=logging.INFO)
     
     def handle_request(params):
         # User writing area (Function details)
         response = {
             'statusCode': 200,
             'body': json.dumps(params.json)
         }
     
         logging.info(response)
     
         return response

     import json
     import logging
     
     # Log module setting
     logging.basicConfig(level=logging.INFO)
     
     def handle_request(params):
         # User writing area (Function details)
         response = {
             'statusCode': 200,
             'body': json.dumps(params.json)
         }
     
         logging.info(response)
     
         return response

함수 호출 확인하기

Function 상세 페이지의 구성 탭에서 함수 URL을 호출한 후, 로그 탭에서 로그를 확인합니다.

[2023-09-07] 12:06:23] "host": "scf-xxxxxxxxxxxxxxxxxxxxx",
[2023-09-07] 12:06:23] "ce-id": "xxxxxxxxxxxxxxxxxxxxx",
[2023-09-07] 12:06:23] "ce-source": "xxxxxxxxxxxxxxxxxxxxx",

[2023-09-07] 12:06:23] "host": "scf-xxxxxxxxxxxxxxxxxxxxx",
[2023-09-07] 12:06:23] "ce-id": "xxxxxxxxxxxxxxxxxxxxx",
[2023-09-07] 12:06:23] "ce-source": "xxxxxxxxxxxxxxxxxxxxx",

Throw a custom error

커스텀 에러 발생(Throw a custom error) 설정 및 함수 호출 예시(함수 URL 사용)를 설명합니다.

Throw a custom error 설정하기

Throw a custom error를 설정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 트리거를 설정할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. 트리거 탭을 클릭한 후, 트리거 추가 버튼을 클릭하세요. 트리거 추가 팝업창이 열립니다.
5. 트리거 추가 팝업창에서 트리거 종류 항목을 선택한 후, 하단에 표시되는 필수 정보를 입력하고 확인 버튼을 클릭하세요.
   • 필수 정보는 트리거 종류에 따라 달라집니다.

     트리거 종류	입력 항목
     API Gateway	API명: 기존에 생성된 API를 선택하거나 새로 생성 가능 스테이지: 기존에 생성된 스테이지를 선택하거나 새로 생성 가능
     Cronjob	예시를 참고하여 트리거의 반복 빈도(분, 시, 일, 월, 요일)를 입력 Timezone 설정: 적용할 기준 시간대를 선택

     표. 트리거 추가 시 필수 입력 항목
6. 코드 탭으로 이동한 후, 수정 버튼을 클릭하세요. Function 코드 수정 페이지로 이동합니다.
7. 성공 및 실패 케이스에 대한 처리 로직을 추가한 후, 저장 버튼을 클릭하세요.
   • Node.js 소스코드
     • Node.js

     Sample Code Download

     Copy Code

     배경색 변경

     class CustomError extends Error {
         constructor(message) {
             super(message);
             this.name = 'CustomError';
         }
     }
     
     exports.handleRequest = async function (params) {
         /**
         * @description User writing area (Function details)
         */
         throw new CustomError('This is a custom error!');
     };

     class CustomError extends Error {
         constructor(message) {
             super(message);
             this.name = 'CustomError';
         }
     }
     
     exports.handleRequest = async function (params) {
         /**
         * @description User writing area (Function details)
         */
         throw new CustomError('This is a custom error!');
     };

   • Python 소스코드
     • Python

     Sample Code Download

     Copy Code

     배경색 변경

     class CustomError(Exception):
         def __init__(self, message):
         self.message = message
     
     def handle_request(parmas):
         raise CustomError('This is a custom error!')

     class CustomError(Exception):
         def __init__(self, message):
         self.message = message
     
     def handle_request(parmas):
         raise CustomError('This is a custom error!')

   • PHP 소스코드
     • PHP

     Sample Code Download

     Copy Code

     배경색 변경

     <?php
         class CustomError extends Exception {
             public function __construct($message) {
                 parent::__construct($message);
                 $this->message = $message;
             }
         }
     
         function handle_request() {
             throw new CustomError('This is a custom error!');
         }
     ?>
     

     <?php
         class CustomError extends Exception {
             public function __construct($message) {
                 parent::__construct($message);
                 $this->message = $message;
             }
         }
     
         function handle_request() {
             throw new CustomError('This is a custom error!');
         }
     ?>
     

함수 호출 확인하기

Function 상세 페이지의 구성 탭에서 함수 URL을 호출한 후, 로그 탭에서 에러 발생 여부를 확인합니다.

Using Environment Variable

환경 변수 사용(Using Environment Variable) 설정 및 함수 호출 예시(함수 URL 사용)를 설명합니다.

Using Environment Variable 설정하기

Using Environment Variable를 설정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 트리거를 설정할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. 트리거 탭을 클릭한 후, 트리거 추가 버튼을 클릭하세요. 트리거 추가 팝업창이 열립니다.
5. 트리거 추가 팝업창에서 트리거 종류 항목을 선택한 후, 하단에 표시되는 필수 정보를 입력하고 확인 버튼을 클릭하세요.
   • 필수 정보는 트리거 종류에 따라 달라집니다.

     트리거 종류	입력 항목
     API Gateway	API명: 기존에 생성된 API를 선택하거나 새로 생성 가능 스테이지: 기존에 생성된 스테이지를 선택하거나 새로 생성 가능
     Cronjob	예시를 참고하여 트리거의 반복 빈도(분, 시, 일, 월, 요일)를 입력 Timezone 설정: 적용할 기준 시간대를 선택

     표. 트리거 추가 시 필수 입력 항목
6. 코드 탭으로 이동한 후, 수정 버튼을 클릭하세요. Function 코드 수정 페이지로 이동합니다.
7. 성공 및 실패 케이스에 대한 처리 로직을 추가한 후, 저장 버튼을 클릭하세요.
   • Node.js 소스코드
     • Node.js

     Sample Code Download

     Copy Code

     배경색 변경

     exports.handleRequest = async function (params) {
         /**
         * @description User writing area (Function details)
         */
         return process.env.test;
     };

     exports.handleRequest = async function (params) {
         /**
         * @description User writing area (Function details)
         */
         return process.env.test;
     };

   • Python 소스코드
     • Python

     Sample Code Download

     Copy Code

     배경색 변경

     import json
     
     import os
     
     def handle_request(params):
         # User writing area (Function details)
         return os.environ.get("test")

     import json
     
     import os
     
     def handle_request(params):
         # User writing area (Function details)
         return os.environ.get("test")

   • PHP 소스코드
     • PHP

     Sample Code Download

     Copy Code

     배경색 변경

     import json
     
     def handle_request(params):
         # User writing area (Function details)
         return os.environ.get("test")

     import json
     
     def handle_request(params):
         # User writing area (Function details)
         return os.environ.get("test")

8. 구성 탭으로 이동한 후, 환경 변수 영역의 수정 버튼을 클릭하세요. 환경 변수 수정 팝업창이 열립니다.
9. 환경 변수 정보를 입력한 후, 확인 버튼을 클릭하세요.

   구분	상세 설명
   이름	Key값을 입력
   값	Value값을 입력

   표. 환경 변수 입력 항목

함수 호출 확인하기

Function 상세 페이지의 구성 탭에서 함수 URL을 호출한 후, 로그 탭에서 환경 변수값을 확인합니다.

4 - PrivateLink 서비스 연계하기

Cloud Functions와 PrivateLink 서비스를 연계하여 Samsung Cloud Platform 내부의 VPC와 VPC, VPC와 서비스를 외부 인터넷 없이 연결할 수 있습니다.
데이터가 내부 네트워크만 이용하게되어 보안성이 높고, 퍼블릭 IP, NAT, VPN, 인터넷 게이트웨이 등이 필요하지 않습니다.

PrivateLink 서비스 활성화하기

PrivateLink Service를 연계하기 위해 서비스를 먼저 활성화해야 합니다.

PrivateLink 서비스를 활성화하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 PrivateLink를 연계할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. Function 상세 페이지에서 구성 탭을 클릭하세요.
5. Private 연결 구성에서 PrivateLink Service의 수정 버튼을 클릭하세요. PrivateLink Service 수정 팝업창이 열립니다.
6. PrivateLink Service 수정 팝업창에서 활성화 여부의 사용 항목을 체크한 후, 확인 버튼을 클릭하세요. 구성 탭의 Private 연결 구성에 PrivateLink Service 정보가 표시됩니다.

PrivateLink 서비스 연계하기

PrivateLink Service를 연계하여 함수를 다른 VPC에서 프라이빗하게 접근할 수 있도록 노출시킬 수 있습니다.

PrivateLink 서비스를 연계하려면 다음 작업을 확인하세요.

• 발급된 Private URL 호출을 위하여 PrivateLink Endpoint의 IP주소와 Private URL 주소에 대한 도메인을 등록하세요.

  192.168.0.13 abc123.scf.private.kr-west1.qa2.samsungsdscloud.com
  

• PrivateLink Service 호출 시 필요한 Endpoint 생성자의 인증 정보를 기반으로 IAM 인증을 확인하세요.

  x-scf-access-key
  

  x-scf-secret-key
  

PrivateLink Endpoint 생성하기

사용자 VPC의 PrivateLink Service에 접근하기 위한 Entry Point를 생성합니다.

PrivateLink Endpoint를 생성하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 PrivateLink를 연계할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. Function 상세 페이지에서 구성 탭을 클릭하세요.
5. Private 연결 구성에서 PrivateLink Endpoint의 추가 버튼을 클릭하세요. PrivateLink Endpoint 추가 팝업창이 열립니다.
6. PrivateLink Service 추가 팝업창에서 PrivateLink Service ID와 Alias 정보를 입력한 후, 확인 버튼을 클릭하세요.
7. 생성을 알리는 팝업창이 열리면 확인 버튼을 클릭하세요. 구성 탭의 Private 연결 구성에 PrivateLink Endpoint 정보가 표시됩니다.

APIGW Private EPS 연계하기

SCF Endpoint와 APIGW Private Endpoint를 연결하려면 SCF Endpoint Alias에 APIGW EPS의 resource path를 대신하여 Private URL을 기재해야 합니다.

• Private URL 예시: 181b6126ef6d4e4b81370df5.apigw.private.kr-west1.s.samsungsdscloud.com/get/resourcepath

APIGW Private EPS 연계하려면 다음 코드를 참조하세요.

const request = require('request');

/**
 * @description User writing area (Function details)
*/
exports.handleRequest = async function (params) {
    return await sendRequest(params);
};
 
async function sendRequest(req) {
    return new Promise((resolve, reject) => {
        // Port 80 and Port 443 are available
        url = "https://{alias}/{resource_path}"; // Destination URL
        /**
        {alias}는 함수 내에서 Endpoint 생성 시 입력한 alias명
        {resoure_path}는 APIGW EPS의 Private URL에서 지정한 resource path (/get/resourcepath)
        */

        const options = {
            uri: url,
            method:'GET',
            json: true,
            strictSSL: false,
            rejectUnauthorized: false
        }
         
        request(options, (error, response, body) => {
            if (error) {
                reject(error);
            } else {
                resolve({
                    statusCode: response.statusCode,
                    body: JSON.stringify(body)
                });
            }
        });
    });
}

const request = require('request');

/**
 * @description User writing area (Function details)
*/
exports.handleRequest = async function (params) {
    return await sendRequest(params);
};
 
async function sendRequest(req) {
    return new Promise((resolve, reject) => {
        // Port 80 and Port 443 are available
        url = "https://{alias}/{resource_path}"; // Destination URL
        /**
        {alias}는 함수 내에서 Endpoint 생성 시 입력한 alias명
        {resoure_path}는 APIGW EPS의 Private URL에서 지정한 resource path (/get/resourcepath)
        */

        const options = {
            uri: url,
            method:'GET',
            json: true,
            strictSSL: false,
            rejectUnauthorized: false
        }
         
        request(options, (error, response, body) => {
            if (error) {
                reject(error);
            } else {
                resolve({
                    statusCode: response.statusCode,
                    body: JSON.stringify(body)
                });
            }
        });
    });
}

5 - 리소스 기반 정책 가이드

리소스 기반 정책 개요

Cloud Functions의 리소스 기반 정책(Resource-based Policy)은 리소스에 부여되는 정책으로써 특정 자원에 대한 행동(Action)을 주체(Principal)에 한하여 허용하거나 거부(Effect)하도록 결정할 수 있습니다.
리소스 기반 정책을 활용하여 함수를 실행(Invoke)할 수 있는 주체를 직접 정의할 수 있습니다.

리소스 기반 정책을 통해 다음을 정의하여 함수 호출을 허용할 수 있습니다.

• 지정된 Samsung Cloud Platform 계정의 사용자
• 지정된 소스 IP 주소 범위 또는 CIDR 블록

소스 정책은 지정된 보안 주체(보통 IAM 역할 또는 그룹)가 API를 호출할 수 있는지 여부를 제어하기 위해 API에 연결되는 JSON 정책 문서 형태로 정의됩니다.

리소스 기반 정책 사용 시나리오

리소스 기반 정책의 주요 사용 시나리오는 다음과 같습니다.

리소스 기반 정책 시나리오

Cloud Functions의 기능이 동작할 때 활용되는 리소스 기반 정책 시나리오는 다음과 같습니다.

사용자 추가 활용 시나리오

Cloud Functions의 리소스 기반 정책으로 자동으로 등록되진 않지만 필요에 따라 사용자가 추가하여 활용할 수 있습니다.
사용자가 추가하여 활용할 수 있는 시나리오는 다음과 같습니다.

• 교차 계정 접근
  • A 계정의 IAM 사용자가 B 계정의 Lambda를 실행하고 싶은 경우, B 계정 함수 정책에 A 계정을 등록합니다.
• 하이브리드 접근 제어
  • 단순히 계정이나 IP만 제한하는 것이 아니라, 특정 사용자와 특정 IP 대역 두 조건이 동시에 만족해야 접근할 수 있도록 구성할 수 있습니다.

Cloud Functions의 리소스 기반 정책 관리

Cloud Functions의 리소스 기반 정책을 확인하고 설정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Compute > Cloud Functions 메뉴를 클릭하세요. Cloud Functions의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Function 메뉴를 클릭하세요. Function 목록 페이지로 이동합니다.
3. Function 목록 페이지에서 정책을 설정할 자원을 클릭하세요. Function 상세 페이지로 이동합니다.
4. Function 상세 페이지의 구성 탭을 클릭하세요.
5. 리소스 기반 정책 권한 항목의 수정 버튼을 클릭하세요. 리소스 정책 수정 팝업창이 열립니다.
6. 리소스 정책 수정 팝업창에서 정책 템플릿을 선택한 후, 정책을 작성하세요.
   • 정책 템플릿별 정책 예시는 리소스 기반 정책 예시를 참고하세요.
7. 작성이 완료되면 확인 버튼을 클릭하세요.
   • 삭제 버튼을 클릭하면 등록된 정책이 삭제됩니다.

리소스 기반 정책 예시

사용자는 필요에 따라 리소스 기반 정책을 추가로 정의하거나 기존 정책을 수정하여 활용할 수 있습니다.

함수 URL - 인증타입 None

Principal이 /*인 Public 호출을 허용하는 정책입니다.

정책 템플릿

{
    "Statement": [
        {
        	"Action": ["scf:InvokeFunctionUrl"],
        	"Condition": {
            	"StringEquals": {
                	"scf:CloudFunctionAuthType": ["NONE"]
            	}
        	},
        	"Effect": "Allow",
        	"Principal": "*", 
            "Resource": ["{{CloudFunctionSrn}}"],   
            "Sid": "InvokeFunctionURLAllowPublicAccess"
        }
    ],
    "Version": "2024-07-01"
}

{
    "Statement": [
        {
        	"Action": ["scf:InvokeFunctionUrl"],
        	"Condition": {
            	"StringEquals": {
                	"scf:CloudFunctionAuthType": ["NONE"]
            	}
        	},
        	"Effect": "Allow",
        	"Principal": "*", 
            "Resource": ["{{CloudFunctionSrn}}"],   
            "Sid": "InvokeFunctionURLAllowPublicAccess"
        }
    ],
    "Version": "2024-07-01"
}

정책 예시

{
    "Statement": [
        {
            "Action": ["scf:InvokeFunctionUrl"],
            "Condition": {
                "StringEquals": {
                    "scf:CloudFunctionAuthType": ["NONE"]
                }
            },
            "Effect": "Allow",
            "Principal": "*",
            "Resource": ["srn:e::accountID:kr-west1::scf:cloud-function/functionsID"],
            "Sid": "InvokeFunctionURLAllowPublicAccess"
        }
    ],
    "Version": "2024-07-01"
}

{
    "Statement": [
        {
            "Action": ["scf:InvokeFunctionUrl"],
            "Condition": {
                "StringEquals": {
                    "scf:CloudFunctionAuthType": ["NONE"]
                }
            },
            "Effect": "Allow",
            "Principal": "*",
            "Resource": ["srn:e::accountID:kr-west1::scf:cloud-function/functionsID"],
            "Sid": "InvokeFunctionURLAllowPublicAccess"
        }
    ],
    "Version": "2024-07-01"
}

함수 URL - 인증타입 IAM

특정 사용자에게 Public URL 호출을 허용하는 정책입니다.

정책 템플릿

{
    "Statement": [
        {
            "Action": ["scf:InvokeFunctionUrl"],
            "Condition": {
                "StringEquals": {
                    "scf:CloudFunctionAuthType": ["SCP_IAM"]
                }
            },
            "Effect": "Allow",
            "Principal": {
                "scp": ["srn:{{Environment}}::{{AccountID}}:::iam:user/{{UserId}}"]
            }, 
            "Resource": ["{{CloudFunctionSrn}}"],  
            "Sid": "Statement1"
        }
    ],
    "Version": "2024-07-01"
}

{
    "Statement": [
        {
            "Action": ["scf:InvokeFunctionUrl"],
            "Condition": {
                "StringEquals": {
                    "scf:CloudFunctionAuthType": ["SCP_IAM"]
                }
            },
            "Effect": "Allow",
            "Principal": {
                "scp": ["srn:{{Environment}}::{{AccountID}}:::iam:user/{{UserId}}"]
            }, 
            "Resource": ["{{CloudFunctionSrn}}"],  
            "Sid": "Statement1"
        }
    ],
    "Version": "2024-07-01"
}

정책 예시

{
    "Statement": [
        {
            "Action": ["scf:InvokeFunctionUrl"],
            "Condition": {
                "StringEquals": {
                    "scf:CloudFunctionAuthType": ["SCP_IAM"]
                }
            },
            "Effect": "Allow",
            "Principal": "*",
            "Resource":  ["srn:e::accountID:kr-west1::scf:cloud-function/functionsID"],
            "Sid": "accountID-iam-invokefunctionurl"
        }
    ],
    "Version": "2024-07-01"
}

{
    "Statement": [
        {
            "Action": ["scf:InvokeFunctionUrl"],
            "Condition": {
                "StringEquals": {
                    "scf:CloudFunctionAuthType": ["SCP_IAM"]
                }
            },
            "Effect": "Allow",
            "Principal": "*",
            "Resource":  ["srn:e::accountID:kr-west1::scf:cloud-function/functionsID"],
            "Sid": "accountID-iam-invokefunctionurl"
        }
    ],
    "Version": "2024-07-01"
}

API Gateway 트리거

Principal이 *인 Public 호출을 허용하는 정책입니다.

정책 템플릿

{
    "Statement": [
        {
            "Action": ["scf:InvokeFunction"],
            "Condition": {
                "SrnLike": {
                    "scp:RequestAttribute/body['x-scf-request-obj-srn']": ["{{ApiGatewayMethodSrn}}"]
                }
            },
            "Effect": "Allow",
            "Principal": {
                "Service": ["apigateway.samsungsdscloud.com"]
            }, 
            "Resource": ["{{CloudFunctionSrn}}"],  
            "Sid": "Statement1"
        }
    ],
    "Version": "2024-07-01"
}

{
    "Statement": [
        {
            "Action": ["scf:InvokeFunction"],
            "Condition": {
                "SrnLike": {
                    "scp:RequestAttribute/body['x-scf-request-obj-srn']": ["{{ApiGatewayMethodSrn}}"]
                }
            },
            "Effect": "Allow",
            "Principal": {
                "Service": ["apigateway.samsungsdscloud.com"]
            }, 
            "Resource": ["{{CloudFunctionSrn}}"],  
            "Sid": "Statement1"
        }
    ],
    "Version": "2024-07-01"
}

정책 예시

{
    "Statement": [
        {
            "Action": [
                "scf:InvokeFunction"
            ],
            "Condition": {
                "SrnLike": {
                    "scp:RequestAttribute/body['x-scf-request-obj-srn']": [
                        "srn:e::accountID:kr-west1::apigateway:method/MethodID/*/GET/test"
                    ]
                }
            },
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "apigateway.samsungsdscloud.com"
                ]
            },
            "Resource": [
                "srn:e::accountID:kr-west1::scf:cloud-function/functionID"
            ],
            "Sid": "999e9a9999de4d4683c9e10c74ee999z"
        }
    ],
    "Version": "2024-07-01"
}

{
    "Statement": [
        {
            "Action": [
                "scf:InvokeFunction"
            ],
            "Condition": {
                "SrnLike": {
                    "scp:RequestAttribute/body['x-scf-request-obj-srn']": [
                        "srn:e::accountID:kr-west1::apigateway:method/MethodID/*/GET/test"
                    ]
                }
            },
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "apigateway.samsungsdscloud.com"
                ]
            },
            "Resource": [
                "srn:e::accountID:kr-west1::scf:cloud-function/functionID"
            ],
            "Sid": "999e9a9999de4d4683c9e10c74ee999z"
        }
    ],
    "Version": "2024-07-01"
}

PrivateLink 연결

특정 사용자에게 Privatelink Endpoint를 통한 함수 호출을 허용하는 정책입니다.

정책 템플릿

{
    "Statement": [
        {
            "Action": ["scf:InvokeFunction"],
            "Condition": {
                "StringEquals": {
           			"scf:CloudFunctionPrivatelinkServiceAuthType": ["SCP_IAM"] 
                }
            },
            "Effect": "Allow",
            "Principal": {
                "scp": ["srn:{{Environment}}::{{AccountID}}:::iam:user/{{UserId}}"]
            }, 
            "Resource": ["{{CloudFunctionSrn}}"], 
            "Sid": "Statement1"
        }
    ],
    "Version": "2024-07-01"
}

{
    "Statement": [
        {
            "Action": ["scf:InvokeFunction"],
            "Condition": {
                "StringEquals": {
           			"scf:CloudFunctionPrivatelinkServiceAuthType": ["SCP_IAM"] 
                }
            },
            "Effect": "Allow",
            "Principal": {
                "scp": ["srn:{{Environment}}::{{AccountID}}:::iam:user/{{UserId}}"]
            }, 
            "Resource": ["{{CloudFunctionSrn}}"], 
            "Sid": "Statement1"
        }
    ],
    "Version": "2024-07-01"
}

정책 예시

{
    "Statement": [
        {
            "Action": [
                "scf:InvokeFunction"
            ],
            "Condition": {
                "StringEquals": {
                    "scf:CloudFunctionAuthType": [
                        "SCP_IAM"
                    ]
                }
            },
            "Effect": "Allow",
            "Principal": {
                "scp": [
                    "srn:e::accountID:::iam:user/userID"
                ]
            },
            "Resource": [
                "srn:e::accountID:kr-west1::scf:cloud-function/functionID"
            ],
            "Sid": "rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr-privatelink-invokefunction"
        }
    ],
    "Version": "2024-07-01"
}

{
    "Statement": [
        {
            "Action": [
                "scf:InvokeFunction"
            ],
            "Condition": {
                "StringEquals": {
                    "scf:CloudFunctionAuthType": [
                        "SCP_IAM"
                    ]
                }
            },
            "Effect": "Allow",
            "Principal": {
                "scp": [
                    "srn:e::accountID:::iam:user/userID"
                ]
            },
            "Resource": [
                "srn:e::accountID:kr-west1::scf:cloud-function/functionID"
            ],
            "Sid": "rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr-privatelink-invokefunction"
        }
    ],
    "Version": "2024-07-01"
}