Not available in Korea
endueendue
Sign In시작하기
← Connectors

Cloudflare

Cloudflare개발·배포

Cloudflare API 탐색, DNS 관리, Workers·Pages 배포 이력·로그 조회

제공 도구 18

발신·파괴적 작업 등 되돌리기 어려운 도구는 실행 전 사용자 승인을 거칩니다.

  • cloudflare__api_destructive파괴적승인 필요

    Cloudflare 공식 API의 destructive 작업을 실행한다. operation_id 와 필수 인자는 cloudflare__operations 에서 확인한다. 서버가 호스트·메서드·스키마·권한·위험도를 고정하며 다른 위험도는 거부한다. JSON REST를 지원하며 파일·실시간 스트리밍은 제한된다. ⚠️ 배포·삭제·권한·결제 변경 등이 즉시 적용되며 되돌릴 수 없는 작업이 포함된다. 결과: response · result_info · next_query · accepted · truncated. 비동기 작업·배포 id 는 response 에 보존된다.

  • cloudflare__delete_dns_record파괴적승인 필요

    Cloudflare DNS 레코드를 삭제한다. ⚠️ 도메인 이름 해석이 즉시 바뀌며 삭제한 레코드는 되돌릴 수 없다. zone_id 와 dns_record_id 는 cloudflare__list_dns_records 결과를 쓴다. 결과: response 의 삭제된 레코드 id.

  • cloudflare__pages_deployment_action파괴적승인 필요

    Pages 배포를 retry 또는 rollback 한다. ⚠️ 배포가 다시 실행되거나 프로덕션이 이전 버전으로 바뀌며 이미 제공한 응답은 되돌릴 수 없다. deployment_id 는 cloudflare__list_pages_deployments 결과의 id다. 결과: response 의 배포 id·상태와 async_status_operation. 진행 중이면 상태 조회 작업으로 완료를 확인한다.

  • cloudflare__purge_cache파괴적승인 필요

    Cloudflare 존의 캐시를 지운다 — files 로 특정 URL(https://, 최대 30개)만, 또는 purge_everything=true 로 존 전체. ⚠️ 되돌릴 수 없다 — 전체 퍼지는 캐시가 다시 채워질 때까지 오리진 부하가 오른다. 가능하면 files 로 필요한 URL 만 지운다. zone_id 는 cloudflare__list_zones 결과의 zone_id. 오류 코드 10000 이면 토큰에 Zone → Cache Purge 권한이 없는 것이다. 결과: purged · zone_id · scope · note.

  • cloudflare__api_send발신승인 필요

    Cloudflare 공식 API의 send 작업을 실행한다. operation_id 와 필수 인자는 cloudflare__operations 에서 확인한다. 서버가 호스트·메서드·스키마·권한·위험도를 고정하며 다른 위험도는 거부한다. JSON REST를 지원하며 파일·실시간 스트리밍은 제한된다. ⚠️ 외부 발신·초대·알림이 즉시 전달되며 되돌릴 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(승인 카드엔 본문이 없다). 결과: response · result_info · next_query · accepted · truncated. 비동기 작업·배포 id 는 response 에 보존된다.

  • cloudflare__api_write쓰기

    Cloudflare 공식 API의 write 작업을 실행한다. operation_id 와 필수 인자는 cloudflare__operations 에서 확인한다. 서버가 호스트·메서드·스키마·권한·위험도를 고정하며 다른 위험도는 거부한다. JSON REST를 지원하며 파일·실시간 스트리밍은 제한된다. 결과: response · result_info · next_query · accepted · truncated. 비동기 작업·배포 id 는 response 에 보존된다.

  • cloudflare__create_dns_record쓰기

    Cloudflare DNS 레코드를 생성한다. zone_id 는 cloudflare__list_zones 결과, record 는 type·name 과 content 또는 data 를 포함한다. 중첩 레코드·enum·필수값은 공식 스키마로 검증한다. 결과: response 의 DNS 레코드와 id.

  • cloudflare__update_dns_record쓰기

    Cloudflare DNS 레코드를 patch 또는 replace 방식으로 수정한다. zone_id 와 dns_record_id 는 cloudflare__list_dns_records 결과를 쓴다. replace 는 type·name·content 또는 data 가 필요하다. 결과: response 의 갱신된 레코드와 id.

  • cloudflare__api_read읽기

    Cloudflare 공식 API의 read 작업을 실행한다. operation_id 와 필수 인자는 cloudflare__operations 에서 확인한다. 서버가 호스트·메서드·스키마·권한·위험도를 고정하며 다른 위험도는 거부한다. JSON REST를 지원하며 파일·실시간 스트리밍은 제한된다. 결과: response · result_info · next_query · accepted · truncated. 비동기 작업·배포 id 는 response 에 보존된다.

  • cloudflare__list_dns_records읽기

    DNS 레코드 조회 (type·name·content·proxied·ttl). 필요 권한: Zone → DNS: Read

  • cloudflare__list_pages_deployments읽기

    Pages 배포 이력 — 배포 성패는 status(success/failure/canceled)로 판정한다. 필요 권한: Account → Cloudflare Pages: Read

  • cloudflare__list_pages_projects읽기

    Cloudflare Pages 프로젝트 목록 (+최신 배포 상태). 배포 이력 조회에 쓸 project 이름을 여기서 확보한다. 필요 권한: Account → Cloudflare Pages: Read

  • cloudflare__list_workers읽기

    배포된 Workers 스크립트 목록 (이름·수정시각·핸들러). 필요 권한: Account → Workers Scripts: Read

  • cloudflare__list_zones읽기

    존(도메인) 목록 조회 — 다른 존 단위 도구에 쓸 zone_id 를 여기서 얻는다. 필요 권한: Zone: Read. 결과: 존마다 zone_id · name · status · paused · plan (최대 50건).

  • cloudflare__operations읽기

    Cloudflare 공식 API 작업을 키워드·리소스·위험도로 검색한다. operation_id 를 지정하면 필수 입력·중첩 스키마·권한·pagination·제약을 조회한다. 파일·스트리밍·GraphQL·batch 미지원도 명시한다. 결과: operations · total · next_offset 또는 개별 operation 스키마.

  • cloudflare__pages_logs읽기

    Pages 배포 로그를 조회한다. project_name 과 deployment_id 는 cloudflare__list_pages_deployments 결과의 프로젝트·id, account_id 는 Cloudflare 계정 ID다. 결과: response 의 로그 data(line·ts) · total.

  • cloudflare__worker_deployments읽기

    Worker 배포 이력을 조회한다. script_name 은 cloudflare__list_workers 결과의 name, account_id 는 Cloudflare 계정 ID다. query 에 page·per_page·since·until 을 지정한다. 결과: response · result_info · next_query.

  • cloudflare__worker_logs읽기

    Workers Observability 저장 로그를 조회한다. body 에 queryId·timeframe(from/to 밀리초)·view 와 parameters(데이터셋·계산·필터)를 지정한다. 실시간 tail 은 별도 제한이 있다. 결과: response 의 로그·집계·offset. 후속 body.offset 은 응답을 따라 지정한다.

연동 준비

  1. My Profile → API Tokens 에서 토큰을 발급한다. 사용할 API 작업의 권한 그룹과 계정·존 리소스만 부여한다. 바로가기
  2. DNS 변경은 DNS Write, Workers 배포 이력·로그는 Workers Scripts Read/Write · Workers Observability Write 등 작업별 권한, Pages 로그는 Pages Read, 재시도·롤백은 Pages Write 가 필요하다. 파괴 작업과 외부 발신은 승인을 받는다.
  3. 업그레이드로 기존 토큰 권한이 늘어나지 않는다. 토큰 정책을 편집하고, 편집할 수 없으면 새 토큰을 발급해 재연결한다. 계정 역할·리소스 정책·제품 활성화·플랜 제약도 적용된다. Cloudflare 는 OAuth 대신 API Token 을 사용한다.

Cloudflare 공식 문서 ↗