Post Action
    • PDF

    Post Action

    • PDF

    記事の要約

    Classic/VPC環境で利用できます。

    Cloud Functionsアクションを実行します。

    参考

    basicsequenceタイプのアクションのみ実行できます。

    リクエスト

    リクエスト形式を説明します。リクエスト形式は次の通りです。

    メソッドURI
    POST/packages/{packageName}/actions/{actionName}

    リクエストヘッダ

    Cloud Functions APIで共通して使用されるヘッダの詳細は、Cloud Functionsの共通ヘッダをご参照ください。

    リクエストパスパラメータ

    パラメータの説明は次の通りです。

    フィールドタイプ必須の有無説明
    packageNameStringRequiredパッケージ名
    • パッケージに属さないアクションの場合、記号の「-」を入力
    actionNameStringRequiredアクション名

    リクエストクエリパラメータ

    パラメータの説明は次の通りです。

    フィールドタイプ必須の有無説明
    platformStringOptionalプラットフォーム区分
    • vpc(デフォルト) | classic
    timeoutIntegerOptionalアクションレスポンスの最大待機時間(ミリ秒)
    • 0~60,000 (デフォルト: 60,000)
    • タイムアウトを超えてアクションが実行される場合、レスポンスボディにアクション実行履歴 IDのみ含まれる

    リクエストボディ

    リクエストボディの説明は次の通りです。
    トリガーの種類に応じて必要なアクションのランタイムパラメータを JSON形式で渡すことができます。

    フィールドタイプ必須の有無説明
    ユーザー定義ObjectOptionalアクションランタイムパラメータ

    リクエスト例

    リクエストのサンプルコードは次の通りです。

    curl -X POST 'https://cloudfunctions.apigw.ntruss.com/ncf/api/v2/packages/{packageName}/actions/{actionName}?platform=vpc&timeout=60000' \
    --header 'Content-Type: application/json; charset=utf-8' \
    --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}'
    -d '<下記参照>'
    
    {
        "name": "Cloud Functions",
        "place": "NAVER Cloud"
    }
    

    レスポンス

    レスポンス形式を説明します。

    レスポンスボディ

    レスポンスボディの説明は次の通りです。

    共通フィールド

    フィールドタイプ説明
    content.activationIdStringアクション実行履歴 ID
    content.durationIntegerアクション実行時間(ミリ秒)
    content.endIntegerアクション実行終了時間(ミリ秒)
    • Unix Timestamp
    content.nameStringアクション名
    content.namespaceStringユーザーのネームスペース
    content.responseObjectアクション実行結果情報
    content.response.resultObjectアクション実行結果
    content.response.result.payloadStringアクション実行結果に対するメイン関数の返り値
    content.response.statusStringアクションの状態
    content.response.successBooleanアクション実行は成功したかどうか
    content.startIntegerアクション実行開始時間(ミリ秒)
    • Unix Timestamp
    content.subjectStringアクションを実行したユーザー情報

    レスポンスステータスコード

    レスポンスステータスコードの説明は次の通りです。

    HTTPステータスコードコードメッセージ説明
    40080302ACTION_PLATFORM_MISMATCH正しくないプラットフォームパラメータ
    40080316ACTION_INVALID_RUNTIME_PARAMS無効なリクエストボディ形式
    40380002SUB_ACC_NO_PERMISSIONリソース照会権限エラー
    40480301ACTION_NOT_FOUNDアクションが見つからない

    レスポンス例

    レスポンスのサンプルコードは次の通りです。

    {
        "content": {
            "activationId": "***fe30d270d4bc29fe30d270debc2f7",
            "duration": 3,
            "end": 1713936450102,
            "name": "myaction",
            "namespace": "***QK06kFG8C",
            "response": {
                "result": {
                    "payload": "abc"
                },
                "status": "success",
                "success": true
            },
            "start": 1713936450099,
            "subject": "***QK06kFG8C"
        }
    }
    

    この記事は役に立ちましたか?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.