hostinger-api-mcp

호스팅어-api-mcp

Hostinger API를 위한 MCP(Model Context Protocol) 서버입니다.

필수 조건

• Node.js 버전 20 이상

Node.js가 설치되어 있지 않다면 공식 웹사이트 에서 다운로드할 수 있습니다. 또는 Homebrew (macOS)나 Chocolatey (Windows)와 같은 패키지 관리자를 사용하여 Node.js를 설치할 수도 있습니다.

설치된 Node.js 버전을 설치하고 관리하려면 NVM(Node Version Manager)을 사용하는 것이 좋습니다. NVM을 설치한 후 다음 명령을 사용하여 Node.js를 설치할 수 있습니다.

지엑스피1

설치

MCP 서버를 설치하려면 패키지 관리자에 따라 다음 명령 중 하나를 실행하세요.

업데이트

MCP 서버를 최신 버전으로 업데이트하려면 패키지 관리자에 따라 다음 명령 중 하나를 사용하세요.

구성

서버를 실행할 때 다음 환경 변수를 구성할 수 있습니다.

• DEBUG : 디버그 로깅 활성화(true/false)(기본값: false)
• APITOKEN : Authorization 헤더에 전송되는 API 토큰입니다.

용법

Claude, Cursor 등에 대한 JSON 구성

SSE 전송 사용

MCP 서버를 SSE 전송과 함께 사용하려면 --sse 옵션을 사용하여 서버를 실행해야 합니다. 이렇게 하면 서버가 로컬호스트 포트 8100에서 Server-Sent Events를 사용하여 클라이언트와 통신할 수 있습니다. 또한 --host 및 --port 옵션을 사용하여 서버가 수신 대기할 호스트와 포트를 설정할 수 있습니다.

SSE 전송을 사용하여 서버를 실행하는 예:

MCP 도구 공급자로 사용

이 서버는 MCP(Model Context Protocol)를 구현하며 Claude.js 클라이언트나 다른 MCP 소비자와 같은 모든 MCP 호환 소비자와 함께 사용할 수 있습니다.

Claude.js 클라이언트에서 이 서버에 연결하는 예:

사용 가능한 도구

이 MCP 서버는 다음과 같은 도구를 제공합니다.

청구_getCatalogItemListV1

이 엔드포인트는 주문 가능한 카탈로그 항목 목록을 검색합니다.

카탈로그 항목의 가격은 센트(부동 소수점 없음)로 표시됩니다. 예를 들어, float 17.99 는 정수 1799 로 표시됩니다.

• 방법 : GET
• 경로 : /api/billing/v1/catalog

매개변수 :

• category : 카테고리별로 카탈로그 항목 필터링
• name : 카탈로그 항목을 이름으로 필터링합니다. 와일드카드 검색에는 * 사용합니다. 예: .COM* 사용하여 .com 도메인을 찾습니다.

청구_새서비스주문생성V1

이 엔드포인트는 새로운 서비스 주문을 생성합니다.

주문하려면 결제 수단 ID와 카탈로그 엔드포인트의 가격 품목 목록, 수량을 제공해야 합니다. 주문 생성 시 쿠폰을 제공할 수도 있습니다.

이 엔드포인트를 사용하여 생성된 주문은 자동 갱신되도록 설정됩니다.

일부 credit_card 결제는 추가 확인이 필요할 수 있으며, 이로 인해 구매가 처리되지 않을 수 있습니다. 이 문제가 발생하면 credit_card 아닌 다른 결제 수단을 사용하시는 것을 권장합니다.

• 방법 : POST
• 경로 : /api/billing/v1/orders

매개변수 :

• payment_method_id : 결제 방법 ID (필수)
• items : items 매개변수(필수)
• coupons : 할인 쿠폰 코드

청구_기본 결제 방법 설정V1

이 엔드포인트는 귀하 계정의 기본 결제 방법을 설정합니다.

• 방법 : POST
• 경로 : /api/billing/v1/payment-methods/{paymentMethodId}

매개변수 :

• paymentMethodId : 결제 방법 ID (필수)

청구_삭제결제방법V1

이 엔드포인트는 귀하의 계정에서 결제 방법을 삭제합니다.

• 방법 : DELETE
• 경로 : /api/billing/v1/payment-methods/{paymentMethodId}

매개변수 :

• paymentMethodId : 결제 방법 ID (필수)

청구_getPaymentMethodListV1

이 엔드포인트는 새로운 주문을 하는 데 사용할 수 있는 결제 방법 목록을 검색합니다.

새로운 결제 방법을 추가하려면 hPanel을 사용하세요.

• 방법 : GET
• 경로 : /api/billing/v1/payment-methods

청구_취소구독V1

이 엔드포인트는 구독을 취소하고 추가 청구를 중단합니다.

• 방법 : DELETE
• 경로 : /api/billing/v1/subscriptions/{subscriptionId}

매개변수 :

• subscriptionId : 구독 ID (필수)

청구_구독목록V1 가져오기

이 엔드포인트는 귀하의 계정과 연결된 모든 구독 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/billing/v1/subscriptions

DNS_getSnapshotV1

이 엔드포인트는 DNS 영역 레코드의 내용이 포함된 특정 DNS 스냅샷을 검색합니다.

• 방법 : GET
• 경로 : /api/dns/v1/snapshots/{domain}/{snapshotId}

매개변수 :

• domain : 도메인 이름 (필수)
• snapshotId : 스냅샷 ID(필수)

DNS_getSnapshotListV1

이 엔드포인트는 DNS 스냅샷 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/dns/v1/snapshots/{domain}

매개변수 :

• domain : 도메인 이름 (필수)

DNS_restoreSnapshotV1

이 엔드포인트는 DNS 영역을 선택한 스냅샷으로 복원합니다.

• 방법 : POST
• 경로 : /api/dns/v1/snapshots/{domain}/{snapshotId}/restore

매개변수 :

• domain : 도메인 이름 (필수)
• snapshotId : 스냅샷 ID(필수)

DNS_getRecordsV1

이 엔드포인트는 특정 도메인에 대한 DNS 영역 레코드를 검색합니다.

• 방법 : GET
• 경로 : /api/dns/v1/zones/{domain}

매개변수 :

• domain : 도메인 이름 (필수)

DNS_updateZoneRecordsV1

이 엔드포인트는 선택한 도메인의 DNS 레코드를 업데이트합니다.

overwrite = true 사용하면 기존 레코드가 제공된 레코드로 대체됩니다. 그렇지 않으면 기존 레코드가 업데이트되고 새 레코드가 추가됩니다.

• 방법 : PUT
• 경로 : /api/dns/v1/zones/{domain}

매개변수 :

• domain : 도메인 이름 (필수)
• overwrite : true 이면 이름 및 유형이 일치하는 리소스 레코드(RR)가 삭제되고 새 RR이 생성됩니다. 그렇지 않으면 리소스 레코드의 TTL이 업데이트되고 새 레코드가 추가됩니다. 일치하는 RR이 없으면 새 RR이 생성됩니다.
• zone : zone 매개변수(필수)

DNS_deleteZoneRecordsV1

이 엔드포인트는 선택한 도메인의 DNS 레코드를 삭제합니다. 삭제할 레코드를 필터링하려면 레코드 name 과 type 필터에 추가하세요. 단일 요청으로 여러 필터를 적용할 수 있습니다.

동일한 이름과 유형의 레코드가 여러 개 있고 그 중 일부만 삭제하려는 경우, Update zone records 엔드포인트를 참조하세요.

• 방법 : DELETE
• 경로 : /api/dns/v1/zones/{domain}

매개변수 :

• domain : 도메인 이름 (필수)

DNS_resetZoneRecordsV1

이 엔드포인트는 DNS 영역을 기본 레코드로 재설정합니다.

• 방법 : POST
• 경로 : /api/dns/v1/zones/{domain}/reset

매개변수 :

• domain : 도메인 이름 (필수)
• sync : 작업을 동기적으로 실행해야 하는지 여부를 결정합니다.
• reset_email_records : 이메일 기록을 재설정할지 여부를 결정합니다.
• whitelisted_record_types : 재설정하지 않을 레코드 유형을 지정합니다.

DNS_validateZoneRecordsV1

이 엔드포인트는 선택된 도메인에 대한 업데이트 전에 DNS 레코드를 검증하는 데 사용됩니다.

유효성 검사가 성공하면 응답에 200 Success 코드가 포함됩니다. 유효성 검사 오류가 발생하면 응답은 422 Validation error 코드와 함께 실패합니다.

• 방법 : POST
• 경로 : /api/dns/v1/zones/{domain}/validate

매개변수 :

• domain : 도메인 이름 (필수)
• overwrite : true 이면 이름 및 유형이 일치하는 리소스 레코드(RR)가 삭제되고 새 RR이 생성됩니다. 그렇지 않으면 리소스 레코드의 TTL이 업데이트되고 새 레코드가 추가됩니다. 일치하는 RR이 없으면 새 RR이 생성됩니다.
• zone : zone 매개변수(필수)

domains_checkDomainAvailabilityV1

이 엔드포인트는 도메인 이름의 가용성을 확인합니다. 여러 TLD를 한 번에 확인할 수 있습니다. 응답으로 대체 도메인을 받으려면 요청에 TLD를 하나만 입력하고 with_alternatives true 로 설정하세요. TLD는 맨 앞에 마침표(.)를 사용하지 않고 입력해야 합니다(예: com , net , org ).

Endpoint는 분당 요청 수를 10개로 제한합니다.

• 방법 : POST
• 경로 : /api/domains/v1/availability

매개변수 :

• domain : 도메인 이름(TLD 제외) (필수)
• tlds : TLD 목록(필수)
• with_alternatives : 응답에 대안을 포함해야 합니까?

domains_getForwardingDataV1

이 엔드포인트는 도메인 전달 데이터를 검색합니다.

• 방법 : GET
• 경로 : /api/domains/v1/forwarding/{domain}

매개변수 :

• domain : 도메인 이름 (필수)

도메인_삭제포워딩데이터V1

이 엔드포인트는 도메인 전달 데이터를 삭제합니다.

• 방법 : DELETE
• 경로 : /api/domains/v1/forwarding/{domain}

매개변수 :

• domain : 도메인 이름 (필수)

도메인_포워딩데이터 생성V1

이 엔드포인트는 도메인 전달 데이터를 생성합니다.

• 방법 : POST
• 경로 : /api/domains/v1/forwarding

매개변수 :

• domain : 도메인 이름 (필수)
• redirect_type : 리디렉션 유형(필수)
• redirect_url : 도메인을 전달할 URL (필수)

domains_enableDomainLockV1

이 엔드포인트는 도메인에 대한 도메인 잠금을 활성화합니다. 도메인 잠금이 활성화되면 먼저 잠금을 해제하지 않고는 해당 도메인을 다른 등록기관으로 이전할 수 없습니다.

• 방법 : PUT
• 경로 : /api/domains/v1/portfolio/{domain}/domain-lock

매개변수 :

• domain : 도메인 이름 (필수)

domains_disableDomainLockV1

이 엔드포인트는 도메인의 도메인 잠금을 비활성화합니다. 도메인을 다른 등록기관으로 이전하기 전에 도메인 잠금을 비활성화해야 합니다.

• 방법 : DELETE
• 경로 : /api/domains/v1/portfolio/{domain}/domain-lock

매개변수 :

• domain : 도메인 이름 (필수)

domains_getDomainV1

이 엔드포인트는 지정된 도메인에 대한 세부 정보를 검색합니다.

• 방법 : GET
• 경로 : /api/domains/v1/portfolio/{domain}

매개변수 :

• domain : 도메인 이름 (필수)

도메인_도메인리스트V1 가져오기

이 엔드포인트는 귀하의 계정과 연결된 모든 도메인 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/domains/v1/portfolio

도메인_구매NewDomainV1

이 엔드포인트를 통해 새 도메인 이름을 구매하고 등록할 수 있습니다. 등록에 실패하면 hPanel에 로그인하여 도메인 등록 상태를 확인하세요.

결제 방법을 지정하지 않으면 기본 결제 방법이 자동으로 사용됩니다.

WHOIS 정보를 제공하지 않으면 해당 TLD(최상위 도메인)의 기본 연락처 정보가 사용됩니다. 요청하기 전에 원하는 TLD의 WHOIS 정보가 계정에 있는지 확인하세요.

일부 TLD는 additional_details 제공해야 하며, 구매 완료 전에 해당 정보가 검증됩니다. 필요한 추가 정보는 TLD마다 다릅니다.

• 방법 : POST
• 경로 : /api/domains/v1/portfolio

매개변수 :

• domain : 도메인 이름 (필수)
• item_id : 카탈로그 가격 항목 ID(필수)
• payment_method_id : 결제 수단 ID
• domain_contacts : 도메인 연락처 정보
• additional_details : 추가 등록 데이터, 가능한 값은 TLD에 따라 다름
• coupons : 할인 쿠폰 코드

도메인_개인정보보호V1 활성화

이 엔드포인트는 도메인의 개인정보 보호 기능을 활성화합니다. 개인정보 보호 기능이 활성화되면 도메인 소유자의 개인정보가 공개 WHOIS 데이터베이스에서 숨겨집니다.

• 방법 : PUT
• 경로 : /api/domains/v1/portfolio/{domain}/privacy-protection

매개변수 :

• domain : 도메인 이름 (필수)

도메인_개인정보보호V1 비활성화

이 엔드포인트는 도메인의 개인정보 보호 기능을 비활성화합니다. 개인정보 보호 기능이 비활성화되면 도메인 소유자의 개인정보가 공개 WHOIS 데이터베이스에 표시됩니다.

• 방법 : DELETE
• 경로 : /api/domains/v1/portfolio/{domain}/privacy-protection

매개변수 :

• domain : 도메인 이름 (필수)

domains_updateNameserversV1

이 엔드포인트는 지정된 도메인에 대한 네임서버를 설정합니다.

잘못된 네임서버 구성으로 인해 도메인을 확인할 수 없거나 사용할 수 없게 될 수 있으니 주의하세요.

• 방법 : PUT
• 경로 : /api/domains/v1/portfolio/{domain}/nameservers

매개변수 :

• domain : 도메인 이름 (필수)
• ns1 : 이름 서버(필수)
• ns2 : 두 번째 네임 서버(필수)
• ns3 : 세 번째 네임 서버
• ns4 : 네 번째 네임 서버

도메인_getWHOISProfileV1

이 엔드포인트는 WHOIS 연락처 프로필을 검색합니다.

• 방법 : GET
• 경로 : /api/domains/v1/whois/{whoisId}

매개변수 :

• whoisId : WHOIS ID (필수)

도메인_삭제WHOISProfileV1

이 엔드포인트는 WHOIS 연락처 프로필을 삭제합니다.

• 방법 : DELETE
• 경로 : /api/domains/v1/whois/{whoisId}

매개변수 :

• whoisId : WHOIS ID (필수)

도메인_getWHOISProfileListV1

이 엔드포인트는 WHOIS 연락처 프로필 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/domains/v1/whois

매개변수 :

• tld : TLD로 필터링(점 없이)

도메인_WHOISProfileV1 생성

이 엔드포인트는 WHOIS 연락처 프로필을 생성합니다.

• 방법 : POST
• 경로 : /api/domains/v1/whois

매개변수 :

• tld : 도메인의 TLD(마침표 없이) (필수)
• country : ISO 3166 2자리 국가 코드(필수)
• entity_type : 법인 유형(필수)
• tld_details : TLD 세부 정보
• whois_details : WHOIS 세부 정보(필수)

도메인_getWHOISProfileUsageV1

이 엔드포인트는 제공된 WHOIS 연락처 프로필이 사용되는 도메인 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/domains/v1/whois/{whoisId}/usage

매개변수 :

• whoisId : WHOIS ID (필수)

VPS_getDataCentersListV1

이 엔드포인트는 사용 가능한 모든 데이터 센터 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/data-centers

VPS_활성화방화벽V1

이 엔드포인트는 지정된 가상 머신에 대한 방화벽을 활성화합니다.

가상 머신에는 한 번에 하나의 방화벽만 활성화될 수 있습니다.

• 방법 : POST
• 경로 : /api/vps/v1/firewall/{firewallId}/activate/{virtualMachineId}

매개변수 :

• firewallId : 방화벽 ID (필수)
• virtualMachineId : 가상 머신 ID(필수)

VPS_deactivateFirewallV1

이 엔드포인트는 지정된 가상 머신에 대한 방화벽을 비활성화합니다.

• 방법 : POST
• 경로 : /api/vps/v1/firewall/{firewallId}/deactivate/{virtualMachineId}

매개변수 :

• firewallId : 방화벽 ID (필수)
• virtualMachineId : 가상 머신 ID(필수)

VPS_getFirewallV1

이 엔드포인트는 ID와 연관된 규칙을 통해 방화벽을 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/firewall/{firewallId}

매개변수 :

• firewallId : 방화벽 ID (필수)

VPS_삭제방화벽V1

이 엔드포인트는 지정된 방화벽을 삭제합니다.

이 방화벽이 활성화된 모든 가상 머신의 방화벽은 자동으로 비활성화됩니다.

• 방법 : DELETE
• 경로 : /api/vps/v1/firewall/{firewallId}

매개변수 :

• firewallId : 방화벽 ID (필수)

VPS_getFirewallListV1

이 엔드포인트는 사용 가능한 모든 방화벽 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/firewall

매개변수 :

• page : 페이지 번호

VPS_createNewFirewallV1

이 엔드포인트는 새로운 방화벽을 만듭니다.

• 방법 : POST
• 경로 : /api/vps/v1/firewall

매개변수 :

• name : 이름 매개변수(필수)

VPS_업데이트 방화벽 규칙 V1

이 엔드포인트는 지정된 방화벽에서 특정 방화벽 규칙을 업데이트합니다.

이 방화벽이 활성화된 모든 가상 머신은 방화벽과의 동기화를 잃게 되며, 수동으로 다시 동기화해야 합니다.

• 방법 : PUT
• 경로 : /api/vps/v1/firewall/{firewallId}/rules/{ruleId}

매개변수 :

• firewallId : 방화벽 ID (필수)
• ruleId : 방화벽 규칙 ID(필수)
• protocol : 프로토콜 매개변수(필수)
• port : 포트 또는 포트 범위, 예: 1024:2048 (필수)
• source : 소스 매개변수(필수)
• source_detail : IP 범위, CIDR, 단일 IP 또는 any (필수)

VPS_삭제방화벽규칙V1

이 엔드포인트는 지정된 방화벽에서 특정 방화벽 규칙을 삭제합니다.

이 방화벽이 활성화된 모든 가상 머신은 방화벽과의 동기화를 잃게 되며, 수동으로 다시 동기화해야 합니다.

• 방법 : DELETE
• 경로 : /api/vps/v1/firewall/{firewallId}/rules/{ruleId}

매개변수 :

• firewallId : 방화벽 ID (필수)
• ruleId : 방화벽 규칙 ID(필수)

VPS_createFirewallRuleV1

이 엔드포인트는 지정된 방화벽에서 새 방화벽 규칙을 생성합니다. 기본적으로 방화벽은 모든 수신 트래픽을 차단하므로, 사용하려는 모든 포트에 대해 허용 규칙을 추가해야 합니다.

이 방화벽이 활성화된 모든 가상 머신은 방화벽과의 동기화를 잃게 되며, 수동으로 다시 동기화해야 합니다.

• 방법 : POST
• 경로 : /api/vps/v1/firewall/{firewallId}/rules

매개변수 :

• firewallId : 방화벽 ID (필수)
• protocol : 프로토콜 매개변수(필수)
• port : 포트 또는 포트 범위, 예: 1024:2048 (필수)
• source : 소스 매개변수(필수)
• source_detail : IP 범위, CIDR, 단일 IP 또는 any (필수)

VPS_syncFirewallV1

이 엔드포인트는 지정된 가상 머신에 대한 방화벽을 동기화합니다.

방화벽에 새로운 규칙이 추가, 제거 또는 업데이트되는 경우 방화벽과 가상 머신의 동기화가 끊어질 수 있습니다.

• 방법 : POST
• 경로 : /api/vps/v1/firewall/{firewallId}/sync/{virtualMachineId}

매개변수 :

• firewallId : 방화벽 ID (필수)
• virtualMachineId : 가상 머신 ID(필수)

VPS_getPostInstallScriptV1

이 엔드포인트는 ID로 설치 후 스크립트를 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/post-install-scripts/{postInstallScriptId}

매개변수 :

• postInstallScriptId : 설치 후 스크립트 ID(필수)

VPS_updatePostInstallScriptV1

이 엔드포인트는 특정 설치 후 스크립트를 업데이트합니다.

• 방법 : PUT
• 경로 : /api/vps/v1/post-install-scripts/{postInstallScriptId}

매개변수 :

• postInstallScriptId : 설치 후 스크립트 ID(필수)
• name : 스크립트 이름 (필수)
• content : 스크립트 내용 (필수)

VPS_deleteAPostInstallScriptV1

이 엔드포인트는 계정에서 설치 후 스크립트를 삭제합니다.

• 방법 : DELETE
• 경로 : /api/vps/v1/post-install-scripts/{postInstallScriptId}

매개변수 :

• postInstallScriptId : 설치 후 스크립트 ID(필수)

VPS_getPostInstallScriptListV1

이 엔드포인트는 사용자 계정과 관련된 설치 후 스크립트 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/post-install-scripts

매개변수 :

• page : 페이지 번호

VPS_createPostInstallScriptV1

이 엔드포인트를 사용하면 계정에 새로운 설치 후 스크립트를 추가할 수 있으며, 이 스크립트는 가상 머신 인스턴스를 설치한 후 실행하는 데 사용할 수 있습니다.

스크립트 내용은 실행 가능 속성이 설정된 /post_install 파일에 저장되며, 가상 머신이 설치되면 실행됩니다. 스크립트 출력은 /post_install.log 로 리디렉션됩니다. 최대 스크립트 크기는 48KB입니다.

• 방법 : POST
• 경로 : /api/vps/v1/post-install-scripts

매개변수 :

• name : 스크립트 이름 (필수)
• content : 스크립트 내용 (필수)

VPS_attachPublicKeyV1

이 엔드포인트는 사용자 계정의 기존 공개 키를 지정된 가상 머신에 연결합니다.

여러 개의 키를 하나의 가상 머신에 연결할 수 있습니다.

• 방법 : POST
• 경로 : /api/vps/v1/public-keys/attach/{virtualMachineId}

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• ids : 첨부할 공개 키 ID(필수)

VPS_deleteAPublicKeyV1

이 엔드포인트는 계정에서 공개 키를 삭제합니다.

계정에서 공개 키를 삭제해도 가상 머신에서는 제거되지 않습니다.

• 방법 : DELETE
• 경로 : /api/vps/v1/public-keys/{publicKeyId}

매개변수 :

• publicKeyId : 공개 키 ID(필수)

VPS_getPublicKeyListV1

이 엔드포인트는 귀하의 계정과 연결된 공개 키 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/public-keys

매개변수 :

• page : 페이지 번호

VPS_createNewPublicKeyV1

이 엔드포인트를 사용하면 계정에 새로운 공개 키를 추가할 수 있으며, 이 키를 가상 머신 인스턴스에 연결하여 보안 액세스를 제공할 수 있습니다.

• 방법 : POST
• 경로 : /api/vps/v1/public-keys

매개변수 :

• name : 이름 매개변수(필수)
• key : 키 매개변수(필수)

VPS_getTemplateV1

이 엔드포인트는 가상 머신의 특정 OS 템플릿에 대한 세부 정보를 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/templates/{templateId}

매개변수 :

• templateId : 템플릿 ID (필수)

VPS_getTemplateListV1

이 엔드포인트는 가상 머신에 사용 가능한 OS 템플릿 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/templates

VPS_getActionV1

이 엔드포인트는 지정된 가상 머신에서 수행된 특정 작업에 대한 세부 정보를 검색합니다.

이 엔드포인트를 사용하면 작업 이름, 타임스탬프, 상태를 포함하여 특정 작업에 대한 자세한 정보를 볼 수 있습니다.

• 방법 : GET
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/actions/{actionId}

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• actionId : 작업 ID(필수)

VPS_getActionListV1

이 엔드포인트는 지정된 가상 머신에서 수행된 작업 목록을 검색합니다.

작업은 가상 머신에서 실행된 작업이나 이벤트(예: 머신 시작, 중지 또는 수정)입니다. 이 엔드포인트를 통해 이러한 작업의 기록을 확인하고, 작업 이름, 타임스탬프, 상태 등 각 작업에 대한 세부 정보를 확인할 수 있습니다.

• 방법 : GET
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/actions

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• page : 페이지 번호

VPS_getAttachedPublicKeysV1

이 엔드포인트는 지정된 가상 머신에 연결된 공개 키 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/public-keys

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• page : 페이지 번호

VPS_삭제백업V1

이 엔드포인트는 가상 머신의 지정된 백업을 삭제합니다.

• 방법 : DELETE
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/backups/{backupId}

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• backupId : 백업 ID (필수)

VPS_getBackupListV1

이 엔드포인트는 지정된 가상 머신에 대한 백업 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/backups

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• page : 페이지 번호

VPS_복원백업V1

이 엔드포인트는 지정된 가상 머신의 백업을 복원합니다.

그러면 시스템에서 복원 프로세스를 시작하는데, 백업 크기에 따라 시간이 다소 걸릴 수 있습니다.

가상 머신의 모든 데이터는 백업 데이터로 덮어쓰여집니다.

• 방법 : POST
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/backups/{backupId}/restore

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• backupId : 백업 ID (필수)

VPS_setHostnameV1

이 엔드포인트는 지정된 가상 머신의 호스트 이름을 설정합니다. 호스트 이름을 변경해도 PTR 레코드는 자동으로 업데이트되지 않습니다. 가상 머신에 호스트 이름으로 접근할 수 있도록 하려면 도메인 A/AAAA 레코드도 가상 머신 IP로 연결해야 합니다.

• 방법 : PUT
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/hostname

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• hostname : 호스트 이름 매개변수(필수)

VPS_resetHostnameV1

이 엔드포인트는 지정된 가상 머신의 호스트 이름과 PTR 레코드를 기본값으로 재설정합니다.

• 방법 : DELETE
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/hostname

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_getVirtualMachineV1

이 엔드포인트는 지정된 가상 머신에 대한 자세한 정보를 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_getVirtualMachineListV1

이 엔드포인트는 사용 가능한 모든 가상 머신 목록을 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/virtual-machines

VPS_getScanMetricsV1

이 엔드포인트는 지정된 가상 머신에 설치된 Monarx 맬웨어 검사기의 검사 지표를 검색합니다. 검사 지표는 Monarx가 수행한 맬웨어 검사에 대한 자세한 정보를 제공하며, 여기에는 검사 횟수, 탐지된 위협 및 기타 관련 통계가 포함됩니다. 이 정보는 가상 머신의 보안 상태를 모니터링하고 맬웨어 검사기의 효율성을 평가하는 데 유용합니다.

• 방법 : GET
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/monarx

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_installMonarxV1

이 엔드포인트는 지정된 가상 머신에 Monarx 맬웨어 스캐너를 설치합니다.

Monarx는 가상 머신의 맬웨어 감염을 탐지하고 예방하도록 설계된 보안 도구입니다. Monarx를 설치하면 가상 머신의 보안을 강화하여 악성 소프트웨어로부터 안전하게 보호할 수 있습니다.

• 방법 : POST
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/monarx

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_uninstallMonarxV1

이 엔드포인트는 지정된 가상 머신에서 Monarx 맬웨어 스캐너를 제거합니다. Monarx가 설치되어 있지 않으면 요청은 아무런 영향 없이 처리됩니다.

• 방법 : DELETE
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/monarx

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_getMetricsV1

이 엔드포인트는 지정된 가상 머신의 과거 메트릭을 검색합니다. 여기에는 다음 메트릭이 포함됩니다.

• CPU 사용량
• 메모리 사용량
• 디스크 사용량
• 네트워크 사용량
• 가동 시간
• 방법 : GET
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/metrics

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• date_from : RFC 3339 섹션 5.6에 정의된 날짜-시간 표기법(필수)
• date_to : RFC 3339 섹션 5.6에 정의된 날짜-시간 표기법(필수)

VPS_setNameserversV1

이 엔드포인트는 지정된 가상 머신의 네임서버를 설정합니다. 네임서버 구성이 잘못되면 가상 머신이 도메인 이름을 확인하지 못할 수 있습니다.

• 방법 : PUT
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/nameservers

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• ns1 : ns1 매개변수(필수)
• ns2 : ns2 매개변수

VPS_createPTRRecordV1

이 엔드포인트는 지정된 가상 머신에 대한 PTR(포인터) 레코드를 생성하거나 업데이트합니다.

• 방법 : POST
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/ptr

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_deletePTRRecordV1

이 엔드포인트는 지정된 가상 머신의 PTR(포인터) 레코드를 삭제합니다.

삭제된 후에는 가상 머신의 IP 주소에 대한 역방향 DNS 조회에서 이전에 구성된 호스트 이름이 반환되지 않습니다.

• 방법 : DELETE
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/ptr

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_setPanelPasswordV1

이 엔드포인트는 지정된 가상 머신의 패널 비밀번호를 설정합니다. 가상 머신이 패널 OS를 사용하지 않는 경우, 요청은 아무런 영향 없이 처리됩니다. 비밀번호 요구 사항은 가상 머신 다시 만들기 엔드포인트 와 동일합니다.

• 방법 : PUT
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/panel-password

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• password : 가상 머신의 패널 비밀번호(필수)

VPS_startRecoveryModeV1

이 엔드포인트는 지정된 가상 머신의 복구 모드를 시작합니다. 복구 모드는 사용자가 파일 시스템 복구, 데이터 복구, 가상 머신의 정상적인 부팅을 방해하는 문제 해결 등 시스템 복구 작업을 수행할 수 있는 특수 상태입니다.

가상 머신은 복구 디스크 이미지를 부팅하고 원본 디스크 이미지는 /mnt 디렉토리에 마운트됩니다.

• 방법 : POST
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/recovery

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• root_password : 복구 모드를 위한 임시 루트 비밀번호(필수)

VPS_stopRecoveryModeV1

이 엔드포인트는 지정된 가상 머신의 복구 모드를 중지합니다. 가상 머신이 복구 모드에 있지 않으면 이 작업은 실패합니다.

• 방법 : DELETE
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/recovery

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_recreateVirtualMachineV1

이 엔드포인트는 가상 머신을 처음부터 다시 생성합니다. 재생성 과정에는 운영 체제를 다시 설치하고 가상 머신을 초기 상태로 재설정하는 작업이 포함됩니다. 스냅샷이 있는 경우 삭제됩니다.

비밀번호 요구 사항

유출된 비밀번호 데이터베이스와 비밀번호를 대조하여 확인합니다. 비밀번호 요건은 다음과 같습니다.

• 최소 8자 이상
• 대문자 하나 이상
• 최소한 하나의 소문자
• 최소한 하나의 숫자
• 공개적으로 유출되지 않습니다

이 작업은 되돌릴 수 없으며 가상 머신에 저장된 모든 데이터가 손실됩니다!

• 방법 : POST
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/recreate

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• template_id : 템플릿 ID (필수)
• password : 가상 머신의 비밀번호입니다. 입력하지 않으면 무작위 비밀번호가 생성됩니다. 비밀번호는 응답에 표시되지 않습니다.
• post_install_script_id : 설치 후 스크립트 ID

VPS_재시작VirtualMachineV1

이 엔드포인트는 지정된 가상 머신을 다시 시작합니다. 이는 가상 머신을 완전히 중지했다가 다시 시작하는 것과 같습니다. 가상 머신이 중지된 경우 다시 시작됩니다.

• 방법 : POST
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/restart

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_setRootPasswordV1

이 엔드포인트는 지정된 가상 머신의 루트 비밀번호를 설정합니다. 비밀번호에 대한 요구 사항은 가상 머신 재생성 엔드포인트 와 동일합니다.

• 방법 : PUT
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/root-password

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• password : 가상 머신의 루트 비밀번호(필수)

VPS_setupNewVirtualMachineV1

이 엔드포인트는 새로 구매한 가상 머신을 설정합니다. 이러한 가상 머신은 initial 상태를 갖습니다. /api/billing/v1/orders 엔드포인트를 사용하여 새 가상 머신을 구매할 수 있습니다.

• 방법 : POST
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/setup

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)
• template_id : 템플릿 ID (필수)
• data_center_id : 데이터 센터 ID(필수)
• post_install_script_id : 설치 후 스크립트 ID
• password : 가상 머신의 비밀번호입니다. 입력하지 않으면 무작위 비밀번호가 생성됩니다. 비밀번호는 응답에 표시되지 않습니다.
• hostname : 가상 머신의 기본 호스트 이름을 재정의합니다.
• install_monarx : Monarx 맬웨어 스캐너를 설치합니다(지원되는 경우)
• enable_backups : 주간 백업 일정 활성화
• ns1 : ns1 매개변수
• ns2 : ns2 매개변수
• public_key : public_key 매개변수

VPS_getSnapshotV1

이 엔드포인트는 지정된 가상 머신의 스냅샷을 검색합니다.

• 방법 : GET
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/snapshot

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_createSnapshotV1

이 엔드포인트는 지정된 가상 머신의 스냅샷을 생성합니다. 스냅샷은 특정 시점의 가상 머신 상태와 데이터를 캡처하여 사용자가 필요한 경우 가상 머신을 해당 상태로 복원할 수 있도록 합니다. 이 작업은 가상 머신의 현재 상태에 영향을 주지 않고 백업, 시스템 복구 및 변경 사항 테스트에 유용합니다.

새로운 스냅샷을 생성하면 기존 스냅샷이 덮어쓰여집니다!

• 방법 : POST
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/snapshot

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_삭제스냅샷V1

이 엔드포인트는 지정된 가상 머신의 스냅샷을 삭제합니다.

• 방법 : DELETE
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/snapshot

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_restoreSnapshotV1

이 엔드포인트는 스냅샷을 사용하여 지정된 가상 머신을 이전 상태로 복원합니다. 스냅샷에서 복원하면 사용자가 가상 머신을 해당 상태로 되돌릴 수 있으며, 이는 시스템 복구, 변경 사항 실행 취소 또는 테스트에 유용합니다.

• 방법 : POST
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/snapshot/restore

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_startVirtualMachineV1

이 엔드포인트는 지정된 가상 머신을 시작합니다. 가상 머신이 이미 실행 중인 경우 요청은 아무런 영향 없이 처리됩니다.

• 방법 : POST
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/start

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)

VPS_stopVirtualMachineV1

이 엔드포인트는 지정된 가상 머신을 중지합니다. 가상 머신이 이미 중지된 경우 요청은 아무런 영향 없이 계속 처리됩니다.

• 방법 : POST
• 경로 : /api/vps/v1/virtual-machines/{virtualMachineId}/stop

매개변수 :

• virtualMachineId : 가상 머신 ID(필수)