Post Action

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

Cloud Functions 액션을 실행합니다.

참고

web, sequence-web 타입 액션에서 HTTP 요청/응답을 직접 처리할 수 없습니다. 관련 기능은 API Gateway 타입 트리거를 사용해 주십시오.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /packages/{packageName}/actions/{actionName}

요청 헤더

Cloud Functions API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 Cloud Functions 공통 헤더를 참조해 주십시오.

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
packageName String Required 패키지 이름
  • 패키지에 속하지 않은 액션인 경우 특수문자 '-' 입력
actionName String Required 액션 이름

요청 쿼리 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
platform String Optional 플랫폼 구분
  • vpc (기본값) | classic
timeout Integer Optional 액션 응답 최대 대기 시간(밀리초)
  • 0~60,000 (기본값: 60,000)
  • 타임아웃 이상 액션이 실행될 경우, 응답 바디에 액션 실행 이력 ID 값만 포함됨

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.
트리거 종류에 따라 필요한 액션의 런타임 파라미터를 JSON 형식으로 전달할 수 있습니다.

필드 타입 필수 여부 설명
사용자 정의 Object Optional 액션 런타임 파라미터

요청 예시

요청 예시는 다음과 같습니다.

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.activationId String 액션 실행 이력 ID
content.duration Integer 액션 실행 시간(밀리초)
content.end Integer 액션 실행 종료 시간(밀리초)
  • Unix Timestamp
content.name String 액션 이름
content.namespace String 사용자의 네임스페이스
content.response Object 액션 실행 결과 정보
content.response.result Object 액션 실행 결과
content.response.result.payload String 액션 실행 결과에 대한 메인 함수 반환 값
content.response.status String 액션 상태
content.response.success Boolean 액션 실행 성공 여부
content.start Integer 액션 실행 시작 시간(밀리초)
  • Unix Timestamp
content.subject String 액션을 실행한 사용자 정보

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
400 80302 ACTION_PLATFORM_MISMATCH 잘못된 플랫폼 파라미터
400 80316 ACTION_INVALID_RUNTIME_PARAMS 잘못된 요청 바디 형식
403 80002 SUB_ACC_NO_PERMISSION 리소스 조회 권한 오류
404 80301 ACTION_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"
    }
}