Post Action

Cloud Functions 액션을 실행합니다.

참고

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

요청

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

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

요청 헤더

Cloud Funtions API에서 공통으로 사용하는 헤더에 대한 정보는 Cloud Functions 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

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

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

요청 쿼리 파라미터

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

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

요청 바디

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

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

요청 예시

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

curl -X POST 'https://cloudfunctions.apigw.fin-ntruss.com/ncf/api/v2/packages/{packageName}/actions/{actionName}?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}'
--data '{
    "name": "Cloud Functions",
    "place": "NAVER Cloud"
}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`content`	Object	-	액션 실행 정보
`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	-	액션을 실행한 사용자 정보

응답 상태 코드

Cloud Functions API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Cloud Functions 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

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