호스팅어-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 서버를 설치하려면 패키지 관리자에 따라 다음 명령 중 하나를 실행하세요.

# Install globally from npm
npm install -g hostinger-api-mcp

# Or with yarn
yarn global add hostinger-api-mcp

# Or with pnpm
pnpm add -g hostinger-api-mcp

업데이트

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

# Update globally from npm
npm update -g hostinger-api-mcp

# Or with yarn
yarn global upgrade hostinger-api-mcp

# Or with pnpm
pnpm update -g hostinger-api-mcp

구성

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

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

용법

Claude, Cursor 등에 대한 JSON 구성

{
    "mcpServers": {
        "hostinger-api": {
            "command": "hostinger-api-mcp",
            "env": {
                "DEBUG": "false",
                "APITOKEN": "YOUR API TOKEN"
            }
        }
    }
}

MCP 도구 공급자로 사용

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

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

import { MCP } from "claude-js";
import { createStdio } from "claude-js/mcp";

// Create stdin/stdout transport
const transport = createStdio({ command: "hostinger-api-mcp" });

// Connect to the MCP server
const mcp = new MCP({ transport });
await mcp.connect();

// List available tools
const { tools } = await mcp.listTools();
console.log("Available tools:", tools);

// Call a tool
const result = await mcp.callTool({
    id: "TOOL-ID",
    arguments: { param1: "value1" }
});
console.log("Tool result:", result);

사용 가능한 도구

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

청구_getCatalogItemListV1

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

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

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

청구_새서비스주문생성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 속성(필수)

도메인_도메인목록V1 가져오기

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

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

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 : 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 : 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

매개변수 :

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

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 : 공개키 속성

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(필수)