---
title: "호출 문제"
slug: "cloudfunctions-troubleshoot-invocation"
updated: 2026-07-23T09:02:32Z
published: 2026-07-23T09:02:32Z
canonical: "guide-fin.ncloud-docs.com/cloudfunctions-troubleshoot-invocation"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 호출 문제

Cloud Functions를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오.

## "Request larger than allowed" 오류

- 요청한 바디 크기가 10MB 이하인데, API Gateway 트리거 호출 시 오류가 발생합니다.
- API Gateway 트리거 호출 시 다음과 같은 오류 메시지가 표시됩니다.

```
{
  "code": "<code>",
  "error": "Request larger than allowed: 2097152 > 1048576 bytes."
}
```

#### 원인

요청 본문의 크기가 Cloud Functions에서 허용하는 최대 크기(1MB/1,048,576bytes)를 초과했다는 의미입니다. API Gateway의 요청 바디 크기 제한은 10MB이지만 Cloud Functions을 연동하는 경우에는 Cloud Functions의 파라미터 크기 제한인 1MB가 적용됩니다. 자세한 설명은 [Cloud Functions 리소스 제한 사양](/docs/cloudfunctions-spec#%EB%A6%AC%EC%86%8C%EC%8A%A4%EC%A0%9C%ED%95%9C%EC%82%AC%EC%96%91)을 참조해 주십시오.

#### 해결 방법

- 요청 본문의 크기를 Cloud Functions의 파라미터 크기 제한(1MB)에 맞게 조정해 주십시오.
- 대용량 데이터를 전달해야 할 경우, Cloud Functions의 코드에서 Object Storage의 파일을 읽도록 구성하는 등 다른 방법을 고려해 주십시오.

## "ACTION_BODY_INVALID_TYPE" 오류

- Put Action API 요청 시 ACTION_BODY_INVALID_TYPE 오류가 발생합니다.
- 다음과 같은 오류 메시지가 표시됩니다.

```
{
  "error": {
    "errorCode": "80305",
    "message": "ACTION_BODY_INVALID_TYPE",
    "details": "The requested body is in an invalid action format."
  }
}
```

```
{
    "error": {
        "errorCode": "80305",
        "message": "ACTION_BODY_INVALID_TYPE",
        "details": "The type of 'timeout' needs to be verified."
}
}
```

#### 원인

- `"details": "The requested body is in an invalid action format."` 인 경우
  - 요청 본문의 형식이 유효하지 않았을 경우 표시되는 오류 메시지입니다. 언어별로 처리 방식이 다를 수 있으나 Python에서는 JSON 매개변수를 사용하여 요청해야 합니다.
  - 예를 들어 다음과 같이 요청했을 경우, 문자열 그대로 전송되기 때문에 해당 오류가 발생합니다.

```
response = requests.put(url, headers=headers, data=body)
```
- `"details": "The type of '{timeout}' needs to be verified."` 인 경우
  - PutAction API의 request body 필드 값의 타입을 잘못 정의한 경우 표시되는 오류 메시지입니다.

#### 해결 방법

- `"details": "The requested body is in an invalid action format."` 인 경우 자동으로 JSON 직렬화하여 올바르게 요청을 보낼 수 있도록 `json=body`를 입력해 주십시오. 올바른 요청 방식은 다음과 같습니다.

```
import requests

body = {"description": "Create Action", ... }
response = requests.put(url, headers=headers, json=body)
```
- `"details": "The type of '{timeout}' needs to be verified."` 인 경우
  - 잘못 정의된 필드 타입을 수정해 주십시오.

          참고

          

자세한 설명은 [Put Action API](https://api-fin.ncloud-docs.com/docs/compute-cloudfunctions-v2-putaction)를 참조해 주십시오.

## "Not Found Exception" 오류

- Not Found Exception 오류가 발생합니다.
- 다음과 같은 오류 메시지가 표시됩니다.

```
{       
    "error": {           
        "errorCode": "300",
        "message": "Not Found Exception",           
        "details": "URL not found."       
    }
}
```

#### 원인

- 호출하려는 URL 및 Method가 잘못 입력되었을 경우, Not Found Exception 오류가 발생할 수 있습니다.
- API Gateway 구독 방식이 보호 모드인 경우, 호출이 불가하여 Not Found Exception 오류가 발생할 수 있습니다. API Gateway 구독 방식이 '공개-자율구독'인 경우에는 Product에 API Key 등록/승인 여부와 관계없이 호출이 가능하지만, '보호-승인필요'인 경우에는 등록/승인된 API Key가 아니라면 호출이 불가능합니다.

#### 해결 방법

- 호출하려는 URL 및 Method가 정확하게 입력되었는지 확인해 주십시오.
- API Gateway 구독 방식을 확인한 후, '공개-자율구독'으로 변경해 주십시오. 구독 방식을 변경하는 방법은 API Gateway 가이드의 [Product 수정](/docs/api-gateway-myproducts#Product%EC%88%98%EC%A0%95)을 참조해 주십시오.

## 200이 아닌 HTTP Status 코드 리턴

200이 아닌 HTTP Status 코드가 리턴됩니다.

#### 원인

비동기 실행 호출 시(blocking=false query param) 202(Accepted)가 리턴됩니다. 액션 실행 자체만 체크하기 때문에 액션 코드 내부 동작의 성공 및 실패 여부는 관여하지 않습니다. 또한 동기 호출 시, 정상 실행 성공 시 200(OK)이 리턴됩니다. 액션이 1분 이상 실행될 경우 비동기 실행으로 전환되며 202(Accepted)를 리턴합니다.

#### 해결 방법

원인에서 설명한 바와 같이, 이는 정상적인 동작이며 별도 조치가 필요하지 않습니다.

          참고

          

이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.