가상 서버 인스턴스 관리

‘가상 서버 인스턴스’ 페이지에서 인스턴스 관리하기

IBM Cloud 콘솔의 ‘가상 서버 인스턴스’ 페이지에서 IBM Cloud® Virtual Servers for Virtual Private Cloud 인스턴스를 관리할 수 있습니다.

인스턴스를 관리하려면 다음 단계를 완료하십시오.

1. IBM Cloud 콘솔에서 탐색 메뉴 아이콘 아이콘 > 인프라 > 컴퓨팅 > 가상 서버 인스턴스를 클릭합니다.
2. 가상 서버 인스턴스 페이지에서 관리할 인스턴스에 대한 조치 아이콘 을 클릭하십시오. 선택할 수 있는 조치는 다음과 같습니다.

콘솔에서 가상 서버 인스턴스 이름 바꾸기

콘솔에서 가상 서버 인스턴스의 이름을 변경할 수 있습니다.

1. '가상 서버 인스턴스' 페이지에서 이름을 변경하려는 인스턴스의 '작업' 아이콘( )을 클릭한 다음, '이름 변경'을 클릭합니다.
2. 가상 서버 인스턴스의 새 이름을 입력한 다음, [이름 변경 ]을 클릭합니다.

CLI에서 가상 서버 인스턴스 나열하기

가상 서버 인스턴스를 관리하려면 먼저 해당 인스턴스의 이름이나 ID가 필요합니다. 계정에 있는 모든 가상 서버 인스턴스를 나열하려면 다음 명령어를 사용하십시오.

ibmcloud is instances

명령어 옵션의 전체 목록을 보려면 ibmcloud instances를 참조하십시오.

API를 사용하여 가상 서버 인스턴스 나열하기

가상 서버 인스턴스를 관리하려면 먼저 해당 인스턴스의 ID가 필요합니다. 계정에 있는 모든 가상 서버 인스턴스를 나열하려면 다음 요청을 수행하십시오.

curl -X GET "$vpc_api_endpoint/v1/instances?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token"

자세한 내용은 VPC API의 ‘모든 인스턴스 나열’을 참조하십시오.

CLI에서 인스턴스 세부 정보 확인하기

명령행 인터페이스(CLI)를 사용하여 IBM Cloud VPC에서 가상 서버 인스턴스를 볼 수 있습니다.

가상 서버 인스턴스의 세부 정보를 확인하려면 ibmcloud is instance 명령을 사용하십시오. INSTANCE 변수를 사용하여 보려는 가상 서버 인스턴스의 ID 또는 이름을 지정하십시오.

ibmcloud is instance INSTANCE

API를 사용하여 인스턴스 세부 정보 확인하기

API를 사용하여 IBM Cloud VPC에서 가상 서버 인스턴스 세부사항을 볼 수 있습니다.

다음 예제는 프로필 이름이 version=2021-06-22&generation=2``인 인스턴스 프로필에 대한 가상 서버 인스턴스 세부 정보를 표시합니다.

curl -X GET "$vpc_api_endpoint/v1/instance/profiles/$profile_name?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token"

자세한 정보는 VPC API에서 인스턴스 프로파일 검색 을 참조하십시오.

Terraform을 사용하여 인스턴스 세부 정보 보기

Terraform을 사용하여 기존 가상 서버 인스턴스에 대한 정보를 검색할 수 있습니다.

다음 예는 가상 서버 인스턴스에 대한 정보를 이름으로 검색하는 예제입니다:

data "ibm_is_instance" "example" {
  name        = "my-instance"
}

자세한 내용은 ibm_is_instance를 참조하세요.

CLI를 통해 가상 서버 인스턴스의 이름 변경

명령줄 인터페이스(CLI)를 사용하여 IBM Cloud VPC 의 가상 서버 인스턴스 이름을 변경할 수 있습니다.

1. 가상 서버 인스턴스의 이름을 바꾸려면 ibmcloud is instance-update INSTANCE 명령. --name NEW_NAME 옵션을 사용하여 인스턴스의 새 이름을 지정하십시오.

   다음 예제에서는 이름이 my-instance-name 인 가상 서버의 이름을 my-instance-name-new 로 바꿉니다.

   ibmcloud is instance-update my-instance-name --name my-instance-name-new
   

   명령어 옵션의 전체 목록을 보려면 [ibmcloud is instance-update](/docs/vpc?topic=vpc-vpc-reference#instance-update) 를 참조하십시오.

API를 사용하여 가상 서버 인스턴스의 이름 변경

API를 사용하여 IBM Cloud VPC에서 가상 서버 인스턴스의 이름을 바꿀 수 있습니다.

다음 예제에서는 가상 서버 인스턴스의 이름을 name에서 my-instance로 바꿉니다.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2021-06-29&generation=2" -H "Authorization: Bearer $iam_token" -d '{"name": "my-instance"}'

Terraform을 사용하여 가상 서버 인스턴스의 이름 변경하기

Terraform을 사용하여 IBM Cloud VPC 에 있는 가상 서버 인스턴스의 이름을 변경할 수 있습니다. ibm_is_instance 리소스의 name 인수를 업데이트하십시오.

다음 예제에서는 가상 서버 인스턴스의 이름을 my-renamed-instance 로 변경합니다:

resource "ibm_is_instance" "example" {
  name    = "my-renamed-instance"
  # ... other required arguments
}

자세한 내용은 ‘ ibm_is_instance ’ 리소스 문서의 ‘ name 논거 ’을 참조하십시오.

콘솔에서 가상 서버 인스턴스 중지 및 시작하기

IBM Cloud 콘솔의 ‘가상 서버 인스턴스 ’ 페이지에서 ‘중지 ’ 또는 ‘시작’을 클릭합니다.

CLI를 통해 가상 서버 인스턴스 중지하기

명령행 인터페이스(CLI)를 사용하여 IBM Cloud VPC에서 가상 서버 인스턴스를 중지할 수 있습니다.

가상 서버 인스턴스를 중지하려면 ibmcloud is instance-stop 명령을 사용하십시오. INSTANCE 변수를 사용하여 중지할 가상 서버 인스턴스의 ID 또는 이름을 지정하십시오.

ibmcloud is instance-stop INSTANCE

다음 예제는 확인을 요청하지 않고 인스턴스를 중지합니다. 가상 서버 인스턴스의 ID는 0777_e7af506a-35d4-451d-aa9e-59330e62b77e 입니다. --force 옵션은 확인 요청을 건너뛰었음을 나타냅니다.

ibmcloud is instance-stop 0777_e7af506a-35d4-451d-aa9e-59330e62b77e --force

'강제 중지' 작업이 실행되면 가상 서버 인스턴스가 전원을 껐다가 다시 켜는 방식으로 재시작됩니다.

인스턴스가 중지 상태에서 멈춰 있는 경우, 확인 절차 없이 인스턴스를 즉시 중지하도록 지정된 --force 및 --no-wait 옵션을 포함한 다음 예제 명령어를 사용할 수 있습니다. 인스턴스의 ID는 0757_5446c277-3190-48dd-ac67-5f02fab39ed5입니다. --force 옵션은 확인 요청을 건너뛰었음을 나타냅니다. --no-wait 옵션은 큐에 저장된 조치를 삭제하여 즉시 명령을 실행합니다.

ibmcloud is instance-stop 0757_5446c277-3190-48dd-ac67-5f02fab39ed5 --force --no-wait

명령어 옵션의 전체 목록을 보려면 [ibmcloud is instance-stop](/docs/vpc?topic=vpc-vpc-reference#instance-stop) 을 참조하십시오.

CLI를 통해 가상 서버 인스턴스 시작하기

명령행 인터페이스(CLI)를 사용하여 IBM Cloud VPC에서 중지된 가상 서버 인스턴스를 시작할 수 있습니다.

가상 서버 인스턴스를 시작하려면 ibmcloud is instance-start 명령을 사용하십시오. INSTANCE 변수를 사용하여 시작할 가상 서버 인스턴스의 ID 또는 이름을 지정하십시오.

ibmcloud is instance-start INSTANCE

명령 옵션의 전체 목록은 VPC CLI 참조 페이지에서 ibmcloud is instance-start 를 참조하십시오.

API를 사용하여 가상 서버 인스턴스 중지하기

API를 사용하여 IBM Cloud VPC에서 가상 서버 인스턴스를 중지할 수 있습니다.

다음 예제에서는 인스턴스 ID가 d6c3902d-1ecf-3a2c-b7ab-eb9143581000인 가상 서버 인스턴스를 중지합니다.

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/d6c3902d-1ecf-3a2c-b7ab-eb9143581000/actions?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token" -d '{"type": "stop"}'

자세한 내용은 VPC API의 ‘인스턴스 생성’ 작업을 참조하십시오.

API를 사용하여 가상 서버 인스턴스 시작하기

API를 사용하여 IBM Cloud VPC에서 중지된 가상 서버 인스턴스를 시작할 수 있습니다.

다음 예제는 인스턴스 ID가 d6c3902d-1ecf-3a2c-b7ab-eb9143581000 인 가상 서버 인스턴스를 시작합니다.

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/d6c3902d-1ecf-3a2c-b7ab-eb9143581000/actions?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token" -d '{"type": "start"}'

자세한 내용은 VPC API의 ‘인스턴스 생성’ 작업을 참조하십시오.

Terraform을 사용하여 가상 서버 인스턴스 중지하기

Terraform을 사용하여 가상 서버 인스턴스를 중지할 수 있습니다.

다음 예는 가상 서버 인스턴스를 중지하는 예제입니다:

resource "ibm_is_instance_action" "example" {
  action       = "stop"
  force_action = true
  instance     = ibm_is_instance.example.id
}

force_action 를 true 로 설정하면 즉시 중지를 강제하고 대기 중인 모든 작업을 삭제합니다.

자세한 내용은 ibm_is_instance_action을 참조하세요.

Terraform을 사용하여 가상 서버 인스턴스 시작

Terraform을 사용하여 중지된 가상 서버 인스턴스를 시작할 수 있습니다.

다음 예제는 가상 서버 인스턴스를 시작하는 예제입니다:

resource "ibm_is_instance_action" "example" {
  action   = "start"
  instance = ibm_is_instance.example.id
}

자세한 내용은 ibm_is_instance_action을 참조하세요.

콘솔에서 가상 서버 인스턴스 재부팅하기

재부트 조치는 게스트 운영 체제 다시 부팅을 트리거합니다. 게스트 운영 체제가 다시 부팅되는 동안 가상 서버 인스턴스는 실행 중 상태로 유지됩니다. 비용 청구는 계속됩니다.

Force 재시작 작업이 실행되면 가상 서버 인스턴스의 전원을 껐다가 다시 켤 수 있는 리셋이 수행됩니다.

IBM Cloud 콘솔의 ‘가상 서버 인스턴스 ’ 페이지에서 ‘재시작’을 클릭합니다.

CLI를 통해 가상 서버 인스턴스 재시작하기

재부트 조치는 게스트 운영 체제 다시 부팅을 트리거합니다. 게스트 운영 체제가 다시 부팅되는 동안 가상 서버 인스턴스는 실행 중 상태로 유지됩니다. 비용 청구는 계속됩니다.

--force 옵션을 사용하여 강제 재부팅 조치를 수행하면 가상 서버 인스턴스의 전원 주기 재설정이 트리거됩니다.

명령행 인터페이스(CLI)를 사용하여 IBM Cloud VPC에서 가상 서버 인스턴스를 다시 부팅할 수 있습니다.

가상 서버 인스턴스를 재부팅하려면 다음을 사용하십시오.ibmcloud is instance-reboot 명령. INSTANCE 변수를 사용하여 다시 부팅할 가상 서버 인스턴스의 ID 또는 이름을 지정하십시오.

ibmcloud is instance-reboot INSTANCE

명령어 옵션의 전체 목록을 보려면 [ibmcloud is instance-reboot](/docs/vpc?topic=vpc-vpc-reference#instance-reboot) 을 참조하십시오.

API를 사용하여 가상 서버 인스턴스 재시작하기

API를 사용하여 IBM Cloud VPC에서 가상 서버 인스턴스를 다시 부팅할 수 있습니다. 다음 예제에서는 지정된 가상 서버를 다시 부팅합니다.

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/d6c3902d-1ecf-3a2c-b7ab-eb9143581000/actions?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token" -d '{"type": "reboot"}'

재부트 조치는 게스트 운영 체제 다시 부팅을 트리거합니다. 게스트 운영 체제가 다시 부팅되는 동안 가상 서버 인스턴스는 실행 중 상태로 유지됩니다. 비용 청구는 계속됩니다.

Force 재시작 작업이 실행되면 가상 서버 인스턴스의 전원을 껐다가 다시 켤 수 있는 리셋이 수행됩니다.

자세한 내용은 VPC API의 ‘인스턴스 생성’ 작업을 참조하십시오.

Terraform을 사용하여 가상 서버 인스턴스 재부팅하기

Terraform을 사용하여 가상 서버 인스턴스를 재부팅할 수 있습니다.

다음 예제는 가상 서버 인스턴스를 재부팅하는 예제입니다:

resource "ibm_is_instance_action" "example" {
  action       = "reboot"
  force_action = true
  instance     = ibm_is_instance.example.id
}

재부트 조치는 게스트 운영 체제 다시 부팅을 트리거합니다. 게스트 운영 체제가 다시 부팅되는 동안 가상 서버 인스턴스는 실행 중 상태로 유지됩니다. 비용 청구는 계속됩니다.

Force 재시작 작업이 실행되면 가상 서버 인스턴스의 전원을 껐다가 다시 켤 수 있는 리셋이 수행됩니다. force_action 을 true 으로 설정하여 작업을 즉시 강제로 실행하고 대기열에 있는 모든 작업을 삭제합니다.

자세한 내용은 ibm_is_instance_action을 참조하세요.

콘솔에서 가상 서버 인스턴스의 크기 조정

vCPU 및 RAM의 할당량을 늘리거나 줄일 수 있어, 자원 요구 사항의 변화에 대응하고, 비용을 최적화하거나 워크로드 성능을 향상시키는 등 워크로드 관리에 있어 더 큰 유연성을 확보할 수 있습니다. 크기 조정이 완료되면 선택한 새 인스턴스 프로필의 시간당 요금이 청구됩니다.

콘솔에서 가상 서버 인스턴스의 크기를 조정하는 단계에 대해서는 “UI를 사용하여 가상 서버 인스턴스의 크기 조정”을 참조하십시오.

CLI를 통해 가상 서버 인스턴스의 크기 조정

vCPU 및 사용 가능한 RAM의 양을 늘리거나 줄임으로써 워크로드 관리의 유연성을 높여, 자원 요구 사항의 변화에 대응하고, 비용을 최적화하거나 워크로드 성능을 향상시킬 수 있습니다. 크기 조정이 완료되면, 선택한 새로운 인스턴스 프로필의 시간당 요금이 청구됩니다.

가상 서버 인스턴스의 크기를 조정하는 단계는 다음을 참조하세요. CLI를 사용하여 가상 서버 인스턴스 크기 조정.

API를 사용하여 가상 서버 인스턴스의 크기 조정하기

vCPU 및 사용 가능한 RAM의 양을 늘리거나 줄임으로써 워크로드 관리의 유연성을 높여, 자원 요구 사항의 변화에 대응하고, 비용을 최적화하거나 워크로드 성능을 향상시킬 수 있습니다. 크기 조정이 완료되면, 선택한 새로운 인스턴스 프로필의 시간당 요금이 청구됩니다.

가상 서버 인스턴스의 크기를 조정하는 단계는 다음을 참조하세요. API를 사용하여 가상 서버 인스턴스 크기 조정.

Terraform을 사용하여 가상 서버 인스턴스의 크기 조정하기

ibm_is_instance 리소스의 profile 인수를 업데이트하여, 워크로드 관리의 유연성을 높이기 위해 사용할 수 있는 vCPU 및 RAM의 양을 늘리거나 줄일 수 있습니다. 크기 조정이 완료되면, 새로운 인스턴스 프로필의 시간당 요금이 청구됩니다.

다음 예제는 가상 서버 인스턴스의 프로필을 업데이트합니다:

resource "ibm_is_instance" "example" {
  name    = "my-instance"
  profile = "bx2-4x16"
  # ... other required arguments
}

자세한 내용은 ‘ ibm_is_instance ’ 리소스 문서의 ‘ profile 논거 ’을 참조하십시오.

CLI를 사용하여 OS 재설치하기

CLI를 사용하여 OS를 재설치할 수 있습니다. 다음 CLI 명령을 사용하여 OS를 재로드하십시오.

데이터를 보존하고 싶다면, OS를 재설치하기 전에 모든 데이터를 백업하십시오.

이 예제에서는 BOOT_VOLUME_JSON 에 포함된 부팅 볼륨 옵션을 사용하여 IMAGE 를 통해 INSTANCE 를 재초기화합니다. 이 설정은 키로 KEY1 및 KEY2 를, 기본 신뢰할 수 있는 프로필로 DEFAULT_TRUSTED_PROFILE 를, 사용자 데이터로 DATA 를 사용합니다. --default-trusted-profile-auto-link 가 true 로 설정되어 있으므로 기본 신뢰 프로필이 자동으로 연결됩니다.

ibmcloud is instance-reinitialize INSTANCE --image IMAGE --boot-volume BOOT_VOLUME_JSON --keys KEY1,KEY2 --default-trusted-profile DEFAULT_TRUSTED_PROFILE --default-trusted-profile-auto-link true --user-data DATA

API를 사용하여 OS 재부팅하기

API를 사용하여 OS를 다시 로드할 수 있습니다. 다음 API 호출을 사용하여 OS를 다시 불러오십시오.

데이터를 보존하고 싶다면, OS를 재설치하기 전에 모든 데이터를 백업하십시오.

이 예제에서는 제공된 부팅 볼륨 연결 옵션을 사용하여 image_id 이미지를 통해 instance_id 인스턴스를 재초기화합니다. 키로는 key_id 을, 사용자 데이터로는 some_data 을, 기본 신뢰 프로필로는 profile_id 을 사용합니다. auto_link 가 true 로 설정되어 있기 때문에 기본 신뢰 프로필이 연결되어 있습니다.

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/instance_id/reinitialize?version=2026-07-01&generation=2" -H "Authorization: Bearer $iam_token" -d
'{
    "image": {
         "id": "image_id"
    },
    "boot_volume_attachment": {
      "volume":  {
        "profile": {
          "name": "general-purpose"
          }
        }
      },"keys": [{
        "id": "key_id"
	}],
	"user_data": "some_data",
	"default_trusted_profile": {
      "target": {
	    "id": "profile_id"
	   },
	   "auto_link": true
	}
}'

콘솔에서 가상 서버 인스턴스 삭제하기

콘솔에서 IBM Cloud VPC 있는 가상 서버 인스턴스를 삭제할 수 있습니다.

인스턴스에 유동 IP 주소가 포함된 경우 인스턴스를 삭제하기 전에 해당 IP 주소를 연관 해제 또는 해제해야 합니다. 유동 IP와 연관된 계정은 해제되지 않은 경우 계속 청구됩니다.

IBM Cloud 콘솔의 ‘가상 서버 인스턴스 ’ 페이지에서 ‘삭제’를 클릭합니다.

삭제 작업을 수행하면 인스턴스와 연결된 vNIC,, 그리고 관련 데이터가 계정에서 영구적으로 제거됩니다. 볼륨 자동 삭제 설정이 활성화된 경우 인스턴스 부팅 볼륨도 삭제됩니다. 기존 부트 볼륨이 가상 서버 인스턴스 프로비저닝의 일부로 연결된 경우 인스턴스가 삭제될 때 기본적으로 볼륨이 유지됩니다. 부트 볼륨이 가상 서버 인스턴스 프로비저닝의 일부로 작성된 경우 인스턴스가 삭제될 때 기본적으로 볼륨이 삭제됩니다. 삭제 조치를 확인하면 인스턴스 및 연관된 vNIC, 부트 볼륨과 데이터를 삭제하는 프로세스가 시작됩니다. 삭제 조치에는 최대 30분이 소요될 수 있지만 프로세스가 완료되면 가상 서버 인스턴스 페이지에 해당 인스턴스가 더 이상 표시되지 않습니다.

CLI에서 가상 서버 인스턴스 삭제하기

명령행 인터페이스(CLI)를 사용하여 IBM Cloud VPC에서 가상 서버 인스턴스의 이름을 삭제할 수 있습니다.

인스턴스에 유동 IP 주소가 포함된 경우 인스턴스를 삭제하기 전에 해당 IP 주소를 연관 해제 또는 해제해야 합니다. 유동 IP와 연관된 계정은 해제되지 않은 경우 계속 청구됩니다.

가상 서버 인스턴스를 삭제하려면 ibmcloud is instance-delete 명령을 사용하십시오. INSTANCE 변수를 사용하여 삭제할 가상 서버 인스턴스의 ID 또는 이름을 지정하십시오.

ibmcloud is instance-delete INSTANCE

명령어 옵션의 전체 목록을 보려면 [ibmcloud is instance-delete](/docs/vpc?topic=vpc-vpc-reference#instance-delete) 를 참조하십시오.

삭제 작업을 수행하면 인스턴스와 연결된 vNIC,, 그리고 관련 데이터가 계정에서 영구적으로 제거됩니다. 볼륨 자동 삭제 설정이 활성화된 경우 인스턴스 부팅 볼륨도 삭제됩니다. 기존 부트 볼륨이 가상 서버 인스턴스 프로비저닝의 일부로 연결된 경우 인스턴스가 삭제될 때 기본적으로 볼륨이 유지됩니다. 부트 볼륨이 가상 서버 인스턴스 프로비저닝의 일부로 작성된 경우 인스턴스가 삭제될 때 기본적으로 볼륨이 삭제됩니다. 삭제 조치를 확인하면 인스턴스 및 연관된 vNIC, 부트 볼륨과 데이터를 삭제하는 프로세스가 시작됩니다. 삭제 조치에는 최대 30분이 소요될 수 있지만 프로세스가 완료되면 가상 서버 인스턴스 페이지에 해당 인스턴스가 더 이상 표시되지 않습니다.

API를 사용하여 가상 서버 인스턴스 삭제하기

API를 사용하여 IBM Cloud VPC에서 가상 서버 인스턴스를 삭제할 수 있습니다.

인스턴스에 유동 IP 주소가 포함된 경우 인스턴스를 삭제하기 전에 해당 IP 주소를 연관 해제 또는 해제해야 합니다. 유동 IP와 연관된 계정은 해제되지 않은 경우 계속 청구됩니다.

다음 예제에서는 인스턴스를 삭제합니다.

curl -X DELETE "$vpc_api_endpoint/v1/instances/$instance_id?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token"

삭제 작업을 수행하면 인스턴스와 연결된 vNIC,, 그리고 관련 데이터가 계정에서 영구적으로 제거됩니다. 볼륨 자동 삭제 설정이 활성화된 경우 인스턴스 부팅 볼륨도 삭제됩니다. 기존 부트 볼륨이 가상 서버 인스턴스 프로비저닝의 일부로 연결된 경우 인스턴스가 삭제될 때 기본적으로 볼륨이 유지됩니다. 부트 볼륨이 가상 서버 인스턴스 프로비저닝의 일부로 작성된 경우, 인스턴스가 삭제될 때 기본적으로 볼륨이 삭제됩니다. 삭제 조치를 확인하면 인스턴스 및 연관된 vNIC, 부트 볼륨과 데이터를 삭제하는 프로세스가 시작됩니다. 삭제 조치에는 최대 30분이 소요될 수 있지만 프로세스가 완료되면 가상 서버 인스턴스 페이지에 해당 인스턴스가 더 이상 표시되지 않습니다.

자세한 정보는 VPC API에서 인스턴스 삭제 를 참조하십시오.

인스턴스 상세 정보 페이지에서 인스턴스 관리하기

인스턴스의 상세 정보를 표시하려면 다음 단계를 따르세요.

1. IBM Cloud 콘솔에서 탐색 메뉴 아이콘 아이콘 > 인프라 > 컴퓨팅 > 가상 서버 인스턴스를 클릭합니다.

2. '가상 서버 인스턴스' 페이지의 목록에서 확인하려는 인스턴스를 찾으십시오. 인스턴스 이름을 클릭하면 해당 인스턴스의 세부 정보를 확인할 수 있습니다. 인스턴스 세부 정보 페이지는 ‘개요’, ‘네트워킹’, ‘스토리지’, ‘모니터링’, ‘통합’의 다섯 가지 탭으로 구성되어 있습니다.

콘솔에서 인스턴스 세부정보 보기

가상 서버 인스턴스 페이지에서 가상 서버 인스턴스의 이름을 클릭하면 해당 인스턴스의 상세 정보를 볼 수 있는 페이지가 열립니다. 상세 정보는 다음과 같은 탭으로 구성되어 있습니다.

콘솔에서 인스턴스에 연결된 볼륨의 자동 삭제 설정 변경하기

인스턴스 프로비저닝 중에는 기본적으로 활성화된 자동 삭제 옵션을 사용하여 부팅 볼륨이 생성됩니다. 이 기능을 활성화하면 인스턴스가 삭제될 때 볼륨이 삭제됩니다.

인스턴스 프로비저닝 중에 생성된 데이터 볼륨의 경우 자동 삭제 기능이 비활성화됩니다. 데이터 볼륨은 기본적으로 분리되지만 삭제되지 않도록 되어 있으므로 가상 서버 인스턴스 수명 주기 이후에도 데이터가 지속될 수 있습니다.

이 설정은 인스턴스를 생성할 때 부팅 볼륨 편집 패널에서 변경하거나 나중에 인스턴스 세부 정보 페이지에서 변경할 수 있습니다. 자세한 내용은 가상 서버 인스턴스 만들기 및 볼륨의 자동 삭제 설정 업데이트하기를 참조하세요.

CLI에서 인스턴스에 연결된 볼륨의 자동 삭제 설정 변경하기

인스턴스 프로비저닝 중에는 기본적으로 활성화된 자동 삭제 옵션을 사용하여 부팅 볼륨이 생성됩니다. 이 기능을 활성화하면 인스턴스가 삭제될 때 볼륨이 삭제됩니다.

인스턴스 프로비저닝 중에 생성된 데이터 볼륨의 경우 자동 삭제 기능이 비활성화됩니다. 데이터 볼륨은 기본적으로 분리되지만 삭제되지 않도록 되어 있으므로 가상 서버 인스턴스 수명 주기 이후에도 데이터가 지속될 수 있습니다.

인스턴스를 생성하거나 부팅 볼륨 첨부 파일을 업데이트할 때 auto_delete 속성을 지정하여 이 설정을 변경할 수 있습니다. 자세한 내용은 가상 서버 인스턴스 생성 및 CLI에서 볼륨 연결 업데이트를 참조하세요.

API로 인스턴스에 연결된 볼륨의 자동 삭제 설정 변경하기

인스턴스 프로비저닝 중에는 기본적으로 활성화된 자동 삭제 옵션을 사용하여 부팅 볼륨이 생성됩니다. 이 기능을 활성화하면 인스턴스가 삭제될 때 볼륨이 삭제됩니다.

인스턴스 프로비저닝 중에 생성된 데이터 볼륨의 경우 자동 삭제 기능이 비활성화됩니다. 데이터 볼륨은 기본적으로 분리되지만 삭제되지 않도록 되어 있으므로 가상 서버 인스턴스 수명 주기 이후에도 데이터가 지속될 수 있습니다.

인스턴스를 만들거나 볼륨 첨부 파일을 업데이트할 때 delete_volume_on_instance_delete 속성을 지정하여 이 설정을 변경할 수 있습니다. 자세한 내용은 가상 서버 인스턴스 만들기 및 API로 볼륨 첨부 파일 업데이트하기를 참조하세요.

Terraform을 사용하여 인스턴스에 연결된 볼륨의 자동 삭제 설정 변경하기

인스턴스 프로비저닝 과정에서 부팅 볼륨은 기본적으로 ‘ auto_delete_volume ’ 옵션이 활성화된 상태로 생성됩니다. 이 옵션이 활성화되면 인스턴스가 삭제될 때 부팅 볼륨도 함께 삭제됩니다.

ibm_is_instance 리소스의 auto_delete_volume 인수를 업데이트하여 이 설정을 변경할 수 있습니다.

다음 예제는 부팅 볼륨의 자동 삭제를 비활성화합니다:

resource "ibm_is_instance" "example" {
  name              = "my-instance"
  auto_delete_volume = false
  # ... other required arguments
}

자세한 내용은 ‘ ibm_is_instance ’ 리소스 문서의 ‘ auto_delete_volume 논거 ’을 참조하십시오.

콘솔에서 인스턴스 대역폭 할당 조정

콘솔에서 인스턴스의 총 대역폭을 네트워크 대역폭과 스토리지 대역폭 간에 어떻게 할당할지 조정할 수 있습니다.

인스턴스의 대역폭을 조정하려면 다음 단계를 따르세요.

1. 가상 서비스 인스턴스로 이동합니다.
2. ‘대역폭 할당’을 선택하십시오.
3. ‘대역폭 할당 편집 ’ 화면에서 ‘저장소 대역폭 ’의 값을 조정하십시오. Block Storage 부팅 볼륨 및 연결된 데이터 볼륨에 할당된 대역폭을 늘릴 수 있습니다. 스토리지 대역폭 할당에 대한 자세한 내용은 Block Storage 볼륨에 대한 대역폭 할 당을 참조하세요. 스토리지 대역폭을 설정한 후에는 네트워크 대역폭이 자동으로 조정되므로 인스턴스의 총 대역폭은 표시된 총 대역폭 값과 같습니다. 네트워크 대역폭 또는 스토리지 대역폭의 값은 500 Mbps 미만으로 설정할 수 없습니다.

새 대역폭 할당을 보려면 인스턴스를 중지하고 시작하거나 보조 볼륨을 분리하고 다시 연결해야 합니다.

CLI에서 인스턴스 대역폭 할당 조정

CLI를 사용하여 인스턴스의 총 대역폭을 네트워크 대역폭과 스토리지 대역폭 간에 배분할 수 있습니다.

인스턴스 대역폭을 재할당하려면 instance-update 명령을 실행하고, total-volume-bandwidth 매개변수에 총 스토리지 대역폭을 메가비트/초(Mbps) 단위로 지정하십시오. 다음 구문을 사용하십시오. INSTANCE에는 인스턴스의 ID 또는 이름을 사용하십시오.

ibmcloud is instance-update INSTANCE --total-volume-bandwidth VALUE

총 스토리지 대역폭(메가비트/초 단위)은 부팅 및 연결된 데이터 볼륨에 할당된 총 대역폭을 의미합니다. 총 스토리지 대역폭을 늘리면 네트워크 대역폭에서 해당 분량이 감소합니다. 사용 가능한 최소 네트워크 대역폭은 500 Mbps이므로, 필요에 따라 총 스토리지 대역폭을 조정하십시오.

새로운 대역폭 할당 내용을 확인하려면 인스턴스를 중지했다가 다시 시작하거나, 데이터 볼륨을 분리했다가 다시 연결해야 합니다.

API를 사용하여 인스턴스 대역폭 할당 조정

API를 사용하여 기존 인스턴스의 총 스토리지 대역폭을 조정할 수 있습니다. 을 만들다 PATCH /instances 새 값을 요청하고 지정합니다.total_volume_ bandwidth. 총 스토리지 대역폭(메가비트/초 단위)은 주 부팅 볼륨 및 보조 연결 데이터 볼륨에 할당된 총 대역폭을 의미합니다. 총 스토리지 대역폭을 늘리면 네트워크 대역폭에서 해당 분량이 감소합니다. 사용 가능한 최소 네트워크 대역폭은 500 Mbps이므로, 필요에 따라 총 스토리지 대역폭을 조정하십시오. 예를 들면 다음과 같습니다.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2021-06-22&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
      "total_volume_bandwidth": 500
      }'

새로운 대역폭 할당 내용을 확인하려면 인스턴스를 중지했다가 다시 시작하거나, 데이터 볼륨을 분리했다가 다시 연결해야 합니다. 개별 볼륨에 대한 대역폭 할당은 다음을 사용하여 데이터 볼륨을 추가하면 업데이트됩니다.POST / volume_attachments 방법을 사용하거나 다음을 사용하여 볼륨을 삭제합니다.DELETE volume_attachments 방법.

Terraform을 사용하여 인스턴스 대역폭 할당량 조정하기

ibm_is_instance 리소스의 total_volume_bandwidth 인수를 업데이트하여 인스턴스의 총 대역폭을 네트워크 대역폭과 스토리지 대역폭 간에 어떻게 할당할지 조정할 수 있습니다. 총 스토리지 대역폭(메가비트/초 단위)은 부팅 볼륨 및 연결된 데이터 볼륨에 할당된 총 대역폭을 의미합니다. 총 스토리지 대역폭을 늘리면 네트워크 대역폭에서 해당 분량이 감소합니다. 최소 네트워크 대역폭은 500 Mbps입니다.

다음 예제에서는 총 스토리지 대역폭을 500 Mbps로 설정합니다:

resource "ibm_is_instance" "example" {
  name                   = "my-instance"
  total_volume_bandwidth = 500
  # ... other required arguments
}

새로운 대역폭 할당 내용을 확인하려면 인스턴스를 중지했다가 다시 시작하거나, 데이터 볼륨을 분리했다가 다시 연결해야 합니다.

자세한 내용은 ‘ ibm_is_instance ’ 리소스 문서의 ‘ total_volume_bandwidth 논거 ’을 참조하십시오.

콘솔에서 스토리지 QoS 모드 조정하기

일반 용도 - Flex, 일반 용도 3세대, 가속화된 3세대 또는 기밀 컴퓨팅 - 3세대 프로파일 중 하나를 사용하는 가상 서버 인스턴스의 Storage QoS 모드를 변경하여 연결된 데이터 볼륨에 대한 동적 대역폭 할당을 활성화할 수 있습니다.

1. 가상 서비스 인스턴스로 이동합니다.
2. 가상 서버 인스턴스 세부 정보 페이지에서 토글을 클릭하여 QoS 모드를 가중치에서 풀링으로 전환합니다.

모드 QoS 변경이 적용되려면 가상 서버 인스턴스를 중지한 후 다시 시작해야 합니다.

CLI에서 스토리지 QoS 모드 조정하기

ibmcloud is instance-update 명령을 사용하여 연결된 데이터 볼륨에 대한 동적 대역폭 할당을 사용하도록 일반 용도 - Flex, 일반 용도 3세대, 가속화된 3세대 또는 기밀 컴퓨팅 - 3세대 프로파일 중 하나를 사용하는 가상 서버 인스턴스의 저장소 QoS 모드를 변경할 수 있습니다.

ibmcloud is instance-update INSTANCE --storage_qos_modes pooled

동일한 명령을 사용하여 가중치가 적용된 QoS 모드로 되돌릴 수 있습니다.

ibmcloud is instance-update INSTANCE --storage_qos_modes weighted

모드 QoS 변경이 적용되려면 먼저 가상 서버 인스턴스를 중지해야 합니다. instance-update 명령을 실행하십시오. 그런 다음 인스턴스를 시작합니다.

API로 스토리지 QoS 모드 조정하기

다음 샘플 요청에 표시된 대로 VPC API에서 /instances/{id} 메서드를 호출하여 일반 목적 - Flex, 일반 목적 3세대, 가속화된 3세대 또는 기밀 컴퓨팅 - 3세대 프로파일 중 하나를 사용하는 가상 서버 인스턴스의 스토리지 QoS 모드를 프로그래밍 방식으로 변경할 수 있습니다.

다음 예제 요청은 3세대 가상 서버에 연결된 데이터 볼륨에 대한 동적 대역폭 할당을 활성화합니다.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-07-11&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
      "storage_qos_mode": "pooled"
      }'

다음 예제 요청은 저장소 QoS 모드를 가중치로 되돌립니다.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-07-11&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
      "storage_qos_mode": "weighted"
      }'

모드 QoS 변경이 적용되려면 먼저 가상 서버 인스턴스를 중지해야 합니다. 패치 요청을 합니다. 그런 다음 인스턴스를 시작합니다.

API에서 인스턴스 상태 및 lifecycle_state보기

• status
• 이 특성은 인스턴스 검색 요청을 통해 가상 서버 인스턴스의 상태를 제공합니다. ' status 반환하는 값은 가상 서버 인스턴스에 특화되어 있으며 실행 중, 중지 중 또는 전환 중인지 여부를 나타냅니다. 자세한 정보는 Virtual Private Cloud API 를 참조하십시오.
• lifecycle_state
• 이 특성은 인스턴스 검색 요청을 통해 자원의 상태를 제공합니다. ' lifecycle_state '이 제공하는 값은 일반적이며 배치 그룹과 같은 다양한 리소스에 적용하기 위한 것입니다. lifecycle_state '는 ' status'과 중복되는 값을 반환할 수 있습니다. lifecycle_state 에는 리소스가 일시 중단되었는지 여부를 자세히 설명하는 값도 포함됩니다.

콘솔에서 호스트 장애 시 자동 재시작 설정하기

기존 인스턴스에 대한 호스트 실패 자동 재시작을 설정하려면 다음 단계를 완료하십시오.

1. IBM Cloud 콘솔에서 탐색 메뉴 아이콘 인프라 > 인프라 > 컴퓨팅 > 가상 서버 인스턴스를 클릭합니다.
2. 가상 서버 인스턴스 페이지에서 관리할 인스턴스에 대한 조치 아이콘 을 클릭하십시오.
3. 인스턴스 세부사항 페이지에서 '호스트 장액 자동 재시작'을 찾으십시오. 편집 아이콘 를 클릭한 다음 ‘Enabled’ 또는 ‘Disabled’를 선택하여 호스트 복구 정책의 상태를 켜거나 끄십시오.

자세한 정보는 호스트 장애 복구 정책을 참조하십시오.

CLI를 통해 호스트 장애 복구 정책 설정하기

명령줄 인터페이스(CLI)를 사용하여 IBM Cloud® VPC 내의 인스턴스를 업데이트하고, 호스트 장애 발생 시 가용성 정책을 변경할 수 있습니다. ibmcloud instance-update 명령을 실행하고 --host-failure-policy 특성을 start 또는 stop(으)로 설정하십시오. 호스트 실패 정책 서비스는 기본적으로 restart(으)로 설정되어 있습니다. 여기서 INSTANCE는 인스턴스의 ID 또는 이름일 수 있습니다.

ibmcloud is instance-update INSTANCE --total-volume-bandwidth VALUE --host-failure-policy stop

API를 사용하여 호스트 장애 복구 정책 설정하기

인스턴스 업데이트 중에 host_failure 하위 속성을 사용하여 가상 서버 인스턴스의 호스트 장애 availability_policy 를 설정할 수 있습니다.

Terraform을 사용하여 호스트 장애 복구 정책 설정하기

ibm_is_instance 리소스의 availability_policy_host_failure 인수를 업데이트하여 가상 서버 인스턴스에 대한 호스트 장애 복구 정책을 설정할 수 있습니다. 기본값은 restart입니다.

다음 예제는 정책을 ‘ stop ’로 설정합니다:

resource "ibm_is_instance" "example" {
  name                              = "my-instance"
  availability_policy_host_failure  = "stop"
  # ... other required arguments
}

자세한 내용은 ‘ ibm_is_instance ’ 리소스 문서의 ‘ availability_policy_host_failure 논거 ’을 참조하십시오.

CLI에서 기밀 컴퓨팅 값 설정하기

가용성 선택

VPC용 인텔 SGX 기반 기밀 컴퓨팅 및 VPC용 인텔 TDX 기반 기밀 컴퓨팅은 달라스(us-south), 워싱턴 DC(us-east), 프랑크푸르트(eu-de) 리전에서 이용 가능합니다.

명령줄 인터페이스(CLI)를 사용하여 인스턴스를 업데이트하고 ' confidential-compute-mode '을 변경할 수 있습니다. ' ibmcloud is instance-update ' 명령을 사용합니다. 인스턴스의 경우, 인스턴스의 ID 또는 이름을 지정하고, --confidential-compute-mode 속성을 sgx 또는 tdx 로 설정합니다.

ibmcloud is instance-update INSTANCE --confidential-compute-mode sgx

API에서 기밀 계산 값 설정하기

가용성 선택

VPC용 인텔 SGX 기반 기밀 컴퓨팅 및 VPC용 인텔 TDX 기반 기밀 컴퓨팅은 달라스(us-south), 워싱턴 DC(us-east), 프랑크푸르트(eu-de) 리전에서 이용 가능합니다.

API를 사용하여 가상 서버 인스턴스를 업데이트하고 ' confidential_compute_mode ' 속성을 변경할 수 있습니다. Ibmcloud ' update-instance 명령을 사용합니다. ' PATCH /instances 요청을 하고 ' confidential_compute_mode ' 속성에 대한 새 값을 지정합니다. 기밀 컴퓨팅을 활성화하려면 이 값을 sgx 또는 tdx 로 변경하십시오.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-10-17&generation=2" -H "Authorization: Bearer $iam_token" -d '{"confidential_compute_mode": "sgx"}'

자세한 내용은 Virtual Servers for VPC 인스턴스 업데이트 작업을 참조하세요 API를 참조하세요.

Terraform을 사용하여 기밀 연산 값 설정하기

가용성 선택

VPC용 인텔 SGX 기반 기밀 컴퓨팅 및 VPC용 인텔 TDX 기반 기밀 컴퓨팅은 달라스(us-south), 워싱턴 DC(us-east), 프랑크푸르트(eu-de) 리전에서 이용 가능합니다.

ibm_is_instance 리소스의 confidential_compute_mode 인수를 업데이트하여 가상 서버 인스턴스의 기밀 컴퓨팅 모드를 업데이트할 수 있습니다.

다음 예제는 SGX 기밀 컴퓨팅을 활성화합니다:

resource "ibm_is_instance" "example" {
  name                     = "my-instance"
  confidential_compute_mode = "sgx"
  # ... other required arguments
}

자세한 내용은 ‘ ibm_is_instance ’ 리소스 문서의 ‘ confidential_compute_mode 논거 ’을 참조하십시오.

콘솔에서 보안 부팅을 사용 또는 사용하지 않도록 설정하기

기밀 컴퓨팅 인스턴스 프로필을 선택하면 기본적으로 보안 부팅 옵션이 사용 설정됩니다. 가상 서버 인스턴스에서 보안 부팅을 비활성화할 수 있지만 먼저 가상 서버 인스턴스를 중지해야 합니다. 보안 부팅을 비활성화한 후 가상 서버 인스턴스를 다시 시작할 수 있습니다.

1. IBM Cloud 콘솔의 가상 서버 인스턴스 페이지에서 가상 서버 인스턴스를 선택합니다.
2. 작업에서 중지를 클릭합니다.
3. 고급 구성 세부 정보에서 보안 부팅을 사용 안 함으로 전환합니다.
4. 작업에서 시작을 클릭합니다.

보안 부팅을 다시 사용하도록 설정하려면 다음 단계에 따라 옵션을 다시 사용으로 전환합니다

CLI에서 보안 부팅 활성화 및 비활성화하기

기밀 컴퓨팅 인스턴스 프로필을 선택하면 기본적으로 보안 부팅 옵션이 사용 설정됩니다. 가상 서버 인스턴스에서 보안 부팅을 비활성화할 수 있지만 먼저 가상 서버 인스턴스를 중지해야 합니다. 보안 부팅을 비활성화한 후 가상 서버 인스턴스를 다시 시작할 수 있습니다.

명령줄 인터페이스(CLI)를 사용하여 인스턴스를 업데이트하고 ' enable-secure-boot '을 변경할 수 있습니다. ' ibmcloud is instance-update ' 명령을 사용합니다. 인스턴스의 경우 인스턴스의 ID 또는 이름을 지정하고 ' --enable-secure-boot 속성을 ' false'로 설정합니다.

ibmcloud is instance-update INSTANCE --enable-secure-boot false

보안 부팅을 다시 사용하도록 설정하려면 동일한 단계를 따르고 --enable-secure-boot 속성을 true 으로 설정합니다.

API에서 보안 부팅 값 활성화 및 비활성화하기

기밀 컴퓨팅 인스턴스 프로필을 선택하면 기본적으로 보안 부팅 옵션이 사용 설정됩니다. 가상 서버 인스턴스에서 보안 부팅을 비활성화할 수 있지만 먼저 가상 서버 인스턴스를 중지해야 합니다. 보안 부팅을 비활성화한 후 가상 서버 인스턴스를 다시 시작할 수 있습니다.

API를 사용하여 가상 서버 인스턴스를 업데이트하고 ' enable_secure_boot ' 속성을 변경할 수 있습니다. PATCH /instances 요청을 보내고, enable_secure_boot 속성에 부울 값을 지정하십시오. 다음 예제는 보안 부팅을 비활성화합니다:

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-10-17&generation=2" -H "Authorization: Bearer $iam_token" -d '{"enable_secure_boot": false}'

보안 부팅을 다시 사용하도록 설정하려면 동일한 단계를 따르고 enable_secure_boot 속성을 true 으로 설정합니다.

자세한 내용은 Virtual Servers for VPC 인스턴스 업데이트 작업을 참조하세요 API를 참조하세요.

콘솔의 예약에서 서버 분리

콘솔의 예약에서 가상 서버를 분리할 수 있습니다.

1. 콘솔 에서 IBM Cloud 탐색 메뉴 > 인프라 > 예약을 클릭합니다.
2. 가상 서버 목록 또는 예약 세부사항 페이지에서 분리할 서버를 클릭한 후 조치 > 분리를 클릭하십시오.
3. 확인하려면 분리를 클릭하십시오.

CLI를 통해 예약에서 서버 분리하기

CLI를 사용하여 가상 서버를 예약에서 분리하는 단계에 대해서는 ‘VPC 예약 관리’를 참조하십시오.

API를 사용하여 예약에서 서버 분리하기

API를 사용하여 가상 서버를 예약에서 분리하는 단계에 대해서는 ‘VPC 예약 관리’를 참조하십시오.

콘솔에서 CSPM 추가하기

이 옵션을 선택하면 모든 리소스에 CSPM을 제공하기 위한 구성으로 워크로드 보호 인스턴스가 생성됩니다. 워크로드 보호 인스턴스가 있는 경우 이 옵션을 사용할 수 없습니다. 자세한 내용은 IBM Cloud Security Posture Management(CSPM )을 참조하세요.

가상 서버 인스턴스 페이지에서 CSPM(Cloud Security Posture Management )을 추가할 수 있습니다.

1. IBM Cloud 콘솔의 가상 서버 인스턴스 페이지에서 개별 인스턴스 이름을 클릭하여 세부 정보를 확인합니다.
2. 세부 정보 페이지에서 연동 탭으로 이동합니다.
3. 클라우드 보안 태세 관리에서 CSPM 추가를 클릭합니다.
4. CSPM(클라우드 보안 태세 관리) 추가에서 만들기를 클릭합니다.

이 설정은 계정의 기존 워크로드 보호 인스턴스에 CSPM을 추가합니다. 자세한 내용은 IBM Cloud 에 대한 CSPM(클라우드 Security Posture Management)구현을 참조하세요.

CLI를 사용하여 가상 서버 인스턴스의 소프트웨어 첨부 파일 확인하기

CLI를 사용하여 카탈로그 이미지에서 생성된 가상 서버 인스턴스의 소프트웨어 첨부 파일을 확인할 수 있습니다.

• 인스턴스에 연결된 모든 소프트웨어 첨부 항목을 나열하려면 다음을 사용하십시오. [ibmcloud is instance-software-attachments](/docs/vpc?topic=vpc-vpc-reference#instance-software-attachments-list. INSTANCE 변수는 인스턴스의 ID 또는 이름입니다.

ibmcloud is instance-software-attachments INSTANCE [--output JSON] [-q, --quiet]

다음 예제는 인스턴스 my-instance 에 대한 모든 소프트웨어 첨부 파일을 나열합니다.

ibmcloud is instance-software-attachments my-instance

• 인스턴스에 첨부된 특정 소프트웨어의 세부 정보를 보려면 다음을 사용하십시오. ibmcloud is instance-software-attachment 를 사용하십시오. INSTANCE 변수는 인스턴스의 ID 또는 이름입니다. SWAC 변수는 인스턴스 소프트웨어 첨부 파일의 ID 또는 이름입니다.

ibmcloud is instance-software-attachment INSTANCE SWAC [--output JSON] [-q, --quiet]

다음 예시는 인스턴스 my-instance 에 대한 소프트웨어 첨부 파일 my-software-attachment 의 세부 정보를 보여줍니다.

ibmcloud is instance-software-attachment my-instance my-software-attachment

CLI를 사용하여 가상 서버 인스턴스의 소프트웨어 첨부 파일 업데이트하기

CLI를 사용하여 카탈로그 이미지에서 생성된 가상 서버 인스턴스의 소프트웨어 첨부 파일을 업데이트할 수 있습니다.

인스턴스의 소프트웨어 첨부 파일 이름을 업데이트하려면 다음을 사용하십시오. ibmcloud is instance-software-attachment-update 를 사용하십시오. INSTANCE 변수는 인스턴스의 ID 또는 이름입니다. SWAC 변수는 인스턴스 소프트웨어 첨부 파일의 ID 또는 이름입니다. --name 값은 인스턴스 소프트웨어 첨부 파일의 새 이름입니다.

ibmcloud is instance-software-attachment-update INSTANCE SWAC --name NEW_NAME [--output JSON] [-q, --quiet]

다음 예제는 인스턴스 my-instance 에 대해 소프트웨어 첨부 파일 ‘ $software_attachment_id ’의 이름을 ‘ my-renamed-software-attachment ’로 변경합니다.

ibmcloud is instance-software-attachment-update my-instance my-software-attachment --name my-renamed-software-attachment

API를 사용하여 가상 서버 인스턴스의 소프트웨어 첨부 파일 확인하기

카탈로그 이미지를 기반으로 가상 서버 인스턴스를 생성할 때, 정의된 소프트웨어 과금 플랜이 구체적으로 구성된 카탈로그 이미지를 사용할 수 있습니다. 가상 서버 인스턴스를 생성한 후에는, 이제 해당 가상 서버 인스턴스의 일부가 된 소프트웨어 첨부 파일을 확인할 수 있습니다.

API를 사용하여 소프트웨어 첨부 파일을 확인하려면 GET /instances/{instance_id}/software_attachments 요청을 보내십시오.

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/instances/{instance_id}/software_attachments?version=2026-04-21" -H "Authorization: Bearer $iam_token"

API를 사용하여 인스턴스 소프트웨어 첨부 파일 나열하기

VPC API를 호출하여 가상 서버 인스턴스와 연결된 모든 소프트웨어 첨부 파일을 프로그래밍 방식으로 나열할 수 있습니다.

다음 예제는 인스턴스 ID가 $instance_id 인 인스턴스에 대한 모든 소프트웨어 첨부 파일을 나열합니다.

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/instances/$instance_id/software_attachments?version=2024-06-23&generation=2" -H "accept: application/json" -H "Authorization: Bearer $iam_token"

자세한 내용은 VPC API의 ‘인스턴스와 연결된 소프트웨어 첨부 파일 나열’을 참조하십시오.

API를 사용하여 인스턴스 소프트웨어 첨부 파일 가져오기

GET /instances/{instance_id}/software_attachments/{id} 요청을 보내고 인스턴스 소프트웨어 첨부 파일 ID와 인스턴스 ID를 지정하면 단일 인스턴스 소프트웨어 첨부 파일을 가져올 수 있습니다.

다음 예제는 인스턴스 ID가 $instance_id 인 인스턴스에 대해 ID가 $software_attachment_id 인 특정 소프트웨어 첨부 파일을 가져옵니다.

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/instances/$instance_id/software_attachments/$software_attachment_id?version=2024-06-23&generation=2" -H "accept: application/json" -H "Authorization: Bearer $iam_token"

자세한 내용은 VPC API의 ‘인스턴스 소프트웨어 첨부 파일 가져오기’를 참조하십시오.

API를 사용하여 인스턴스 소프트웨어 첨부 파일 업데이트하기

PATCH /instances/{instance_id}/software_attachments/{id} 요청을 보내고 인스턴스 소프트웨어 첨부 파일 ID와 인스턴스 ID를 지정하면 인스턴스 소프트웨어 첨부 파일을 업데이트할 수 있습니다.

다음 예제는 인스턴스 ID가 $instance_id 인 인스턴스에 대해 ID가 $software_attachment_id 인 소프트웨어 첨부 파일을 업데이트합니다.

curl -X PATCH "https://us-south.iaas.cloud.ibm.com/v1/instances/$instance_id/software_attachments/$software_attachment_id?version=2024-06-23&generation=2" -H "accept: application/json" -H "Authorization: Bearer $iam_token" -H "Content-Type: application/merge-patch+json" -d "{\"name\":\"my-software-attachment-patch\"}"

자세한 내용은 VPC API의 ‘인스턴스 소프트웨어 첨부 파일 업데이트’를 참조하십시오.

콘솔에서 코어당 스레드 수 편집하기

코어당 스레드 수는 워크로드를 최적화할 수 있는 유연성을 제공합니다. 모든 프로필에 대해 코어당 스레드 수가 표시되지만, ‘고주파’ 프로필 계열에서만 이 값을 편집할 수 있습니다. 고주파 프로파일의 경우 기본값은 2입니다. 이 값을 1로 조정할 수 있습니다.

모든 프로필에 대해 코어당 스레드 수가 표시되지만, ‘고주파’ 프로필 계열에서만 이 값을 편집할 수 있습니다. threads_per_core 속성을 변경하기 전에 가상 서버 인스턴스를 중지해야 합니다.

1. IBM Cloud 콘솔의 가상 서버 인스턴스 페이지에서 개별 인스턴스 이름을 클릭하여 세부 정보를 확인합니다.
2. 상세 페이지에서 Profiles details 로 이동한 다음, Threads per core 로 이동하세요. Edit 을 클릭하세요.
3. '코어당 스레드 수' 페이지에서 '코어당 스레드 수' 값을 수정합니다.
4. Save을(를) 클릭하십시오.

CLI를 사용하여 코어당 스레드 수 편집하기

코어당 스레드 수는 워크로드를 최적화할 수 있는 유연성을 제공합니다. 모든 프로필에 대해 코어당 스레드 수가 표시되지만, ‘고주파’ 프로필 계열에서만 이 값을 편집할 수 있습니다. 고주파 프로파일의 경우 기본값은 2입니다. 이 값을 1로 조정할 수 있습니다.

threads_per_core 속성을 변경하려면 먼저 가상 서버 인스턴스를 중지해야 합니다.

명령줄 인터페이스(CLI)를 사용하여 IBM Cloud VPC 에 있는 가상 서버 인스턴스의 ‘ --threads-per-core ’ 값을 편집할 수 있습니다. --threads-per-core 값을 업데이트하려면 ibmcloud is instance-update 명령을 사용하십시오. INSTANCE 변수를 사용하여 업데이트할 가상 서버 인스턴스의 ID 또는 이름을 지정하십시오. --threads-per-core 옵션의 경우, 1 또는 2 중 하나를 입력하십시오.

ibmcloud is instance-update INSTANCE --threads-per-core [1]

API를 사용하여 코어당 스레드 수 편집하기

코어당 스레드 수는 워크로드를 최적화할 수 있는 유연성을 제공합니다. 모든 프로필에 대해 코어당 스레드 수가 표시되지만, ‘고주파’ 프로필 계열에서만 이 값을 편집할 수 있습니다. 고주파 프로파일의 경우 기본값은 2입니다. 이 값을 1로 조정할 수 있습니다.

threads_per_core 속성을 변경하기 전에 가상 서버 인스턴스를 중지해야 합니다.

API를 사용하여 IBM Cloud VPC 내의 가상 서버 인스턴스에 대한 threads_per_core 속성을 편집합니다. ' update-instance ' 명령을 사용합니다. ' PATCH /instances 요청을 하고 ' threads_per_core ' 속성에 대한 새 값을 지정합니다.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-10-17&generation=2" -H "Authorization: Bearer $iam_token" -d '{"threads_per_core": "1"}'