最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。
Classic/VPC環境で利用できます。
Cloud Functionsアクションを作成したり、変更したりします。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| PUT | /ncf/api/v2/packages/{packageName}/actions/{actionName} |
リクエストヘッダ
Cloud Functions APIで共通して使用されるヘッダの詳細は、Cloud Functionsのリクエストヘッダをご参照ください。
リクエストパスパラメータ
リクエストパスパラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
packageName |
String | Required | パッケージ名
|
actionName |
String | Required | アクション名
|
リクエストクエリパラメータ
リクエストクエリパラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
platform |
String | Optional | プラットフォーム区分
|
type |
String | Optional | アクションタイプ
|
リクエストボディ
リクエストボディの説明は次の通りです。
Basic/Webアクション
パラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
description |
String | Optional | アクションの説明(Byte)
|
parameters |
Object | Optional | アクションのデフォルトパラメータ
|
limits.timeout |
Integer | Required | アクションの最大実行時間(ミリ秒)
|
limits.memory |
Integer | Required | アクションの最大メモリ容量(MB)
|
exec.kind |
String | Required | アクションランタイム
|
exec.imageUri |
String | Conditional | ユーザー画像のパス
|
exec.binary |
Boolean | Required | アクションコードファイルはバイナリかどうか
|
exec.code |
String | Required | アクションのソースコード
|
exec.main |
String | Required | 実行関数 |
vpc |
Array | Required | 接続する VPC情報: vpc
|
raw-http |
Boolean | Optional | 未加工 HTTPの使用有無
|
custom-options |
Boolean | Optional | HTTPヘッダーオプションの設定
|
vpc
vpcの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
vpcNo |
Integer | Required | 接続する VPC ID |
subnetNo |
Integer | Required | 接続する Subnet ID |
Sequence/Sequence-webアクション
パラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
description |
String | Optional | アクションの説明(Byte)
|
exec.kind |
String | Required | アクションの種類
|
exec.components |
String[] | Required | シーケンスアクションに関連付けるアクションリスト
|
リクエスト例
リクエストのサンプルコードは次の通りです。
curl -X PUT 'https://cloudfunctions.apigw.ntruss.com/ncf/api/v2/packages/{packageName}/actions/{actionName}' \
--header 'Content-Type: application/json' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Sub Account Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
--data '{
"description" : "My action",
"parameters": {
"name": "Cloud Functions",
"place": "NCloud"
},
"limits": {
"timeout": 60000,
"memory": 128
},
"exec": {
"kind": "nodejs:16",
"code": "function main(params) { \nlet name = params.name || \"World\";\nlet place = params.place || \"Naver\"; \n return {payload: \"abc\"};\n}",
"binary": false,
"main": "main"
},
"vpc": [
{
"vpcNo" : ******,
"subnetNo" : *****
}
]
}'
レスポンス
レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの説明は次の通りです。
共通フィールド
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
content.name |
String | - | アクションの名前 |
content.resourceId |
String | - | アクションのリソース ID |
content.path |
String | - | アクションのパス |
content.description |
String | - | アクションの説明 |
content.type |
String | - | アクションタイプ |
Basic/Webアクション
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
content.parameters |
Object | - | アクションの基本パラメータ |
content.raw-http |
Boolean | - | 未加工 HTTPの使用有無
|
content.custom-options |
Boolean | - | ヘッダオプションの設定
|
content.exec.binary |
Boolean | - | アクションコードのファイルはバイナリかどうか |
content.exec.code |
String | - | アクションのソースコードまたは Base64-encodedコードファイルのバイナリ |
content.exec.imageUri |
String | - | ユーザー画像パス
|
content.exec.kind |
String | - | アクションのランタイム |
content.exec.main |
String | - | 実行関数 |
content.limits.memory |
Integer | - | アクションコンテナに割り当てられるメモリの容量 |
content.limits.timeout |
Integer | - | アクションが実行される最大時間 |
content.vpc |
Object[] | - | 接続された VPC情報: vpc
|
vpc
vpcの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
content.vpc[].vpcNo |
Integer | - | 接続された VPC ID |
content.vpc[].subnetNo |
Integer | - | 接続された Subnet ID |
Sequence/Web-sequenceアクション
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
content.exec.kind |
String | - | アクションの種類
|
content.exec.components |
String[] | - | 関連付けられたアクションリスト |
レスポンスステータスコード
Cloud Functions APIで共通して使用されるレスポンスステータスコードの詳細は、Cloud Functionsのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"content": {
"description": "My action",
"exec": {
"binary": false,
"code": "function main(params) { \nlet name = params.name || \"World\";\nlet place = params.place || \"Naver\"; \n return {payload: \"abc\"};\n}",
"kind": "nodejs:16",
"main": "main"
},
"limits": {
"memory": 128,
"timeout": 60000
},
"name": "myaction",
"parameters": {
"name": "Cloud Functions",
"place": "NCloud"
},
"path": "***QK06kFG8C/mypackage",
"resourceId": "*****",
"type": "basic",
"vpc": [
{
"subnetNo": ******,
"vpcNo": *****
}
]
}
}