Post Action

Prev Next

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

Cloud Functions 액션을 실행합니다.

요청

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

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

요청 헤더

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

요청 경로 파라미터

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

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

요청 쿼리 파라미터

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

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

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
사용자 정의 Object Optional 액션 런타임 파라미터
  • {"key": "value"} 형태의 JSON

요청 예시

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

curl --location --request POST 'https://cloudfunctions.apigw.gov-ntruss.com/api/v2/packages/package003/actions/action000' \
--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 '<하단 참조>'

{
    "name": "Cloud Functions",
    "place": "NAVER Cloud"
}

응답

응답 형식을 설명합니다.

응답 바디

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

필드 타입 설명
content.activationId String 액션 실행 ID
content.duration Integer 실행 시간
content.start Integer 액션 실행 시작 시간(밀리초)
  • Unix Timestamp
content.end Integer 액션 실행 종료 시간(밀리초)
  • Unix Timestamp
content.name String 액션 이름
content.namespace String 사용자 네임스페이스
content.response Object 액션 실행 결과 정보
content.response.result Object 액션 실행 결과
content.response.status String 액션 상태
content.response.success Boolean 액션 실행 성공 여부
content.subject String 액션을 실행한 사용자 정보

응답 상태 코드

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Ncloud API 응답 상태 코드를 참조해 주십시오.

응답 예시

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

{
    "content": {
        "activationId": "*****6a1fcab420490f6a1fcab0*****",
        "duration": 33,
        "end": 1714021538121,
        "name": "action000",
        "namespace": "****YBNz****",
        "response": {
            "result": {
                "payload": "abc"
            },
            "status": "success",
            "success": true
        },
        "start": 1714021538088,
        "subject": "****YBNz****"
    }
}