Post Action
- 인쇄
- PDF
Post Action
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Cloud Functions 액션을 실행합니다.
참고
basic, sequence 타입 액션만 실행 가능합니다.
요청
요청을 위한 파라미터, 헤더, 바디 정보를 설명합니다.
요청 URL
POST {CLOUD_FUNCTIONS_API_URL}/packages/{packageName}/actions/{actionName}
Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}
Path Variables
| 파라미터명 | 타입 | 필수 여부 | 설명 | 제약 사항 |
|---|---|---|---|---|
| packageName | String | Y | 패키지 이름 - package에 속하지 않은 action을 생성하는 경우 붙임표( - )를 입력 | |
| actionName | String | Y | 액션 이름 |
요청 파라미터
요청 파라미터는 다음과 같습니다.
| 파라미터명 | 타입 | 필수 여부 | 설명 | 제약 사항 |
|---|---|---|---|---|
| timeout | Integer | N | 액션 응답 최대 대기 시간 (ms) - options: 0~60000 - default: 60000 | Timeout 이상 액션이 실행될 경우, 응답 바디에 액션 실행 이력 ID 값만을 포함합니다. |
요청 바디
JSON 형식으로 액션의 런타임 파라미터를 전달할 수 있습니다.
응답
응답 바디
공통 필드
| 필드명 | 타입 | 설명 | 비고 |
|---|---|---|---|
| content.activationId | String | 액션 실행 이력 ID | |
| content.name | String | 액션 이름 | |
| content.duration | Integer | 액션 실행 시간 (ms) | |
| content.start | Integer | 액션 실행 시작 시간 | Unix timestamp (ms) |
| content.end | Integer | 액션 실행 종료 시간 | Unix timestamp (ms) |
| content.namespace | String | 사용자의 네임스페이스 | |
| content.subject | String | 액션을 실행한 사용자 정보 | |
| content.response | Object | 액션 실행 결과 정보 | |
| content.response.result | Object | 액션 실행 결과 | 메인 함수 리턴 값 |
| content.response.status | String | 액션 상태 | |
| content.response.success | Boolean | 액션 실행 성공 여부 |
오류 코드
| HTTP 상태 코드 | 오류 코드 | 오류 메시지 | 설명 |
|---|---|---|---|
| 400 | 80316 | ACTION_INVALID_RUNTIME_PARAMS | 잘못된 요청 바디 형식 |
| 403 | 80002 | SUB_ACC_NO_PERMISSION | 리소스 조회 권한 오류 |
| 404 | 80301 | ACTION_NOT_FOUND | 액션을 찾을 수 없음 |
예시
요청 예시
curl -X POST "https://cloudfunctions.apigw.fin-ntruss.com/ncf/api/v2/packages/-/actions/myaction?timeout=60000"
-H "Content-Type: application/json"
-H "x-ncp-iam-access-key: Y0Z9EG0lKoeWAQCSHRtM"
-H "x-ncp-apigw-timestamp: 1546398302273"
-H "x-ncp-apigw-signature-v2: VXjaLhHB2CdowCrqDNYg7w7GR3TYxZzM2eIZ+i3IH0Q="
-d '<하단 참조>'
{
"name": "Cloud Functions",
"place": "NAVER Cloud"
}
응답 예시
{
"content": {
"activationId": "9c8abdee5d664dfe8abdee5d665dfe65",
"duration": 60,
"start": 1702864891012,
"end": "1702864891072,
"name": "myaction",
"namespace": "kHbJQSZDDh3m",
"subject": "kHbJQSZDDh3m",
"response": {
"result": {
"payload" : "Hello, Cloud Functions in NAVER Cloud!"
},
"status": "success",
"success": true
}
}
}
이 문서가 도움이 되었습니까?