Post Action

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

Cloud Functions 액션을 실행합니다.

참고

basic, sequence 타입 액션만 실행할 수 있습니다.

요청

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

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

요청 헤더

Cloud Functions 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}'
-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	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"
    }
}

이 문서가 도움이 되었습니까?

What's Next

Delete Action

요청
응답