VPC에 대한 예약 관리
예약을 프로비저닝한 후 다음 조치를 사용하여 예약을 관리할 수 있습니다.
| 조치 | 설명 |
|---|---|
| 모든 예약 나열 | 해당 지역의 모든 예약을 나열해 주세요. |
| 예약 작성 | 해당 지역에서 예약을 생성하세요. |
| 예약 삭제 | inactive 예약을 삭제합니다. active 예약을 삭제할 수 없습니다. 이 조치는 되돌릴 수 없습니다. |
| 예약 검색 | URL 에서 식별자로 지정된 예약을 검색합니다. |
| 예약 업데이트 | 새 정보로 예약을 업데이트하십시오. |
| 예약 활성화 | inactive 예약을 활성화하십시오. |
시작하기 전에
가상 서버를 연결하기 전에 예약을 프로비저닝해야 합니다. 자세한 정보는 가상 서버에 대한 예약 프로비저닝 을 참조하십시오.
계정 관리자가 아닌 경우에는 사용자 계정에 예약된 용량 관리 권한이 포함되어 있어야 합니다. 권한 업데이트에 대한 자세한 정보는 VPC 인프라 서비스에 대한 IAM 액세스 관리 를 참조하십시오.
UI를 사용하여 예약 관리
UI를 사용하여 예약 및 연결된 서버를 관리할 수 있습니다.
UI를 사용하여 예약에 가상 서버 인스턴스 연결하기
예약에 가상 서버를 연결할 수 있습니다.
- IBM Cloud 콘솔 에서 탐색 메뉴 아이콘을 클릭한 다음,
> 인프라
> 예약 순으로 선택합니다.
- 예약 세부사항 페이지에서 예약을 선택하십시오.
- 가상 서버 목록에서 조치 > 첨부를 클릭하십시오.
- 예약에 연결할 서버를 선택하고 연결을 클릭합니다.
UI를 사용하여 예약에서 서버 분리
예약에서 가상 서버를 분리할 수 있습니다.
- IBM Cloud 콘솔 에서 탐색 메뉴 아이콘을 클릭한 다음,
> 인프라
> 예약 순으로 선택합니다.
- 가상 서버 목록 또는 예약 세부사항 페이지에서 분리할 서버를 클릭한 후 조치 > 분리를 클릭하십시오.
- 확인하려면 분리를 클릭하십시오.
인스턴스가 중지되었다가 다시 시작되면 만료된 예약을 가리키더라도 시작이 허용되고 종량제 요금으로 청구됩니다.
예약 삭제 시 특별 고려 사항
' inactive 예약을 삭제할 수 있으며 다음 필드를 패치할 수 있습니다.
- 선호도_정책
- capacity.total
- committed_use.expiration_policy
- committed_use.term
- 이름
- 프로파일
다른 필드를 변경하려면 예약을 삭제하고 다시 생성해야 합니다.
그러나 예약이 활성화되고 ' active'이 되면 예약의 많은 부분이 예약 기간 동안 영구적으로 유지됩니다. 예약을 활성화하기 전에 예약을 검토하여 구성이 올바른지 확인하세요. ' active 예약에 패치할 수 있는 필드는 ' name '와 ' committed_use.expiration_policy'뿐입니다.
UI를 통해 예약 삭제하기
예약을 삭제할 수 있습니다.
- IBM Cloud 콘솔 에서 탐색 메뉴 아이콘을 클릭한 다음,
> 인프라
> 예약 순으로 선택합니다.
- 예약 목록에서 조치 > 예약 삭제를 누르십시오.
- 확인하려면 삭제를 클릭하십시오.
CLI를 사용하여 예약 관리
CLI를 사용하여 예약을 관리할 수 있습니다.
예약 활성화
명령행 인터페이스 (CLI) 를 사용하여 예약을 활성화할 수 있습니다. CLI를 사용하여 특정 예약을 활성화하려면 ibmcloud is reservation-activate 명령을 사용하십시오. 가져오려는 특정 예약에 대해 RESERVATION_NAME 를 사용하여 특정 예약의 이름 또는 ID를 지정해야 합니다.
ibmcloud is reservation-activate RESERVATION
다음 예를 참조하십시오.
ibmcloud is reservation-activate b4735ce6-f83d-45d1-b41b-4d47451c8396
Activating reservation b4735ce6-f83d-45d1-b41b-4d47451c8396 under account ACCOUNT as user user@ibm.com...
Successfully activated reservation.
여기서 다음 인수 및 옵션 값이 사용됩니다
- 예약: 예약 번호 또는 예약자 이름.
- --output: 출력 형식을 지정하십시오. JSON만 지원됩니다. 다음 중 하나: JSON
- -q, --quiet: 상세 출력 억제
예약 인스턴스 가져오기
명령행 인터페이스 (CLI) 를 사용하여 사용자 지역에서 예약된 인스턴스를 가져올 수 있습니다. CLI를 사용하여 특정 인스턴스 예약을 가져오려면 ibmcloud is instance 명령을 사용하십시오. 가져오려는 특정 인스턴스에 대해 INSTANCE_NAME 을 사용하여 특정 인스턴스의 이름 또는 ID를 지정해야 합니다.
ibmcloud is instance INSTANCE_NAME
다음 예를 참조하십시오.
ibmcloud is instance instance-cli-test-patch-reservation-1
Getting instance instance-cli-test-patch-reservation-1 under account VPCUI-DEV as user user@ibm.com...
ID aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name aaa-default-reservation-2
CRN crn:v1:bluemix:public:is:jp-tok:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status active
Zone us-east-1
Lifecycle state stable
Affinity Policy open
Resource group -
Profile Name mx2-2x16
Created At 2023-06-05T10:41:51.401+05:30
Expiration At Policy Term
2026-08-28T05:11:51.401Z renew three_year
Capacity Allocated Available Total Used Status
8 8 8 0 -
예약 삭제하기
명령행 인터페이스 (CLI) 를 사용하여 사용자 지역에서 IBM Cloud VPC 예약을 삭제할 수 있습니다. CLI를 사용하여 예약을 삭제하려면 ibmcloud is reservation-delete 명령을 사용하십시오. 삭제하려는 특정 예약에 대해 RESERVATION_NAME 를 사용하여 특정 예약의 이름 또는 ID를 지정해야 합니다.
ibmcloud is reservation-delete RESERVATION_NAME
다음 예를 참조하십시오.
ibmcloud is reservation-delete e9e537f0-59f5-4759-b06e-86bb5cd4068e
This will delete reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e and cannot be undone. Continue [y/N] ?> y
Deleting reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e under account ACCOUNT as user user@ibm.com...
OK
Reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e is deleted.
여기서 다음 인수 및 옵션 값이 사용됩니다
- RESERVATION1: 예약 번호 또는 예약명.
- RESERVATION2: 예약 번호 또는 예약명.
- --force, -f: 확인 없이 작업을 강제로 실행
- --output: 출력 형식을 지정하십시오. JSON만 지원됩니다. 다음 중 하나: JSON
- -q, --quiet: 자세한 출력 정보를 표시하지 않도록 합니다.
모든 예약 목록 보기
명령행 인터페이스 (CLI) 를 사용하여 사용자 지역의 모든 IBM Cloud VPC 예약을 나열할 수 있습니다. CLI를 사용하여 모든 예약을 나열하려면 ibmcloud is reservations 명령을 사용하십시오.
ibmcloud is reservations
다음 예를 참조하십시오.
ibmcloud is reservations
Listing reservations in all resource groups and region us-south under account VPCUI-DEV as user user@ibm.com...
ID Name Status Zone Profile Resource group
0735_73b1e3e5-10a2-44b0-a113-c8d6cd8c42e7 reservation-cli-test-1 active us-south-3 cx2-2x4 Default
0735_4e245881-c9c8-49f3-a21b-d890a13835bb reservation-cli-test-3 active us-south-3 cx2-2x4 Default
예약 검색하기
명령행 인터페이스 (CLI) 를 사용하여 사용자 지역에서 특정 IBM Cloud VPC 예약을 검색할 수 있습니다. CLI를 사용하여 특정 예약을 검색하려면 ibmcloud is reservation 명령을 사용하십시오. 검색하려는 특정 예약에 대해 RESERVATION_NAME 를 사용하여 특정 예약의 이름 또는 ID를 지정해야 합니다.
ibmcloud is reservation RESERVATION_NAME
다음 예를 참조하십시오.
ibmcloud is reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Getting reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa under account ACCOUNT as user user@ibm.com...
ID aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name aaa-default-reservation-2
CRN crn:v1:bluemix:public:is:jp-tok:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status active
Zone us-east-1
Lifecycle state stable
Affinity Policy open
Resource group -
Profile Name mx2-2x16
Created At 2023-06-05:10:41:51.401+05:30
Expiration At Policy Term
2026-08-28T05:11:51.401Z renew three_year
Capacity Allocated Available Total Used Status
8 8 8 0 -
예약 업데이트
CLI(명령줄 인터페이스)를 사용하여 해당 지역의 특정 IBM Cloud VPC 예약을 업데이트할 수 있습니다. CLI를 사용하여 특정 예약을 업데이트하려면 ibmcloud is reservation-update 명령을 사용하십시오. 업데이트하려는 특정 예약에 대해 RESERVATION_NAME 를 사용하여 특정 예약의 이름 또는 ID를 지정해야 합니다. --name 옵션에서 NEW_NAME 변수를 사용하여 예약의 이름을 바꾸십시오.
ibmcloud is reservation-update RESERVATION_NAME [--name NEW_NAME]
다음 예를 참조하십시오.
ibmcloud is reservation-update aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa --name aaa-default-reservation-2-renamed
Updating reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa under account ACCOUNT as user user@ibm.com...
ID aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name aaa-default-reservation-2-renamed
CRN crn:v1:bluemix:public:is:us-east:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status active
Zone us-east-1
Lifecycle state stable
Affinity Policy open
Resource group -
Profile Name mx2-2x16
Created At 2023-06-14T10:58:17.92+05:30
Expiration At Policy Term
2026-08-28T05:28:17.920Z release three_year
Capacity Allocated Available Total Used Status
5 - 5 - -
여기서 다음 인수 및 옵션 값이 사용됩니다
- --name: 예약의 새 이름.
- --capacity: 이 예약에 대한 수용 인원 구성.
- --term: 예약 기간. one_year, three_year중 하나입니다.
- --profile: 이 예약에 사용할 프로필 이름.
- --profile-resource-type: 프로필의 리소스 유형. instance_profile중 하나입니다.
- ----expiration-policy: 커밋된 사용 기간이 만료될 때 적용되는 정책입니다. 릴리스, 갱신 중 하나입니다.
- --output: 출력 형식을 지정하십시오. JSON만 지원됩니다. 다음 중 하나: JSON
- -q, --quiet: 자세한 출력 정보를 표시하지 않도록 합니다.
예약 조건이 포함된 인스턴스 프로필 나열
명령행 인터페이스 (CLI) 를 사용하여 사용자 지역에서 예약 용어가 있는 인스턴스 프로파일을 나열할 수 있습니다. CLI를 사용하여 예약 조건이 있는 인스턴스 프로파일을 나열하려면 ibmcloud is instance-profiles 명령을 사용하십시오.
ibmcloud is instance-profiles
다음 예를 참조하십시오.
ibmcloud is instance-profiles
Listing instance profiles in region us-south under account VPCUI-DEV as user user@ibm.com...
Name vCPU Manufacturer Architecture Family vCPUs Memory(GiB) Bandwidth(Mbps) Volume bandwidth(Mbps) GPUs Storage(GB) Min NIC Count Max NIC Count Status Reservation Terms
bx2-2x8 intel amd64 balanced 2 8 4000 1000 - - 1 5 current -
bx2-2x8-sriov intel amd64 balanced 2 8 4000 1000 - - 1 5 current -
bx2a-2x8 amd amd64 balanced 2 8 2000 500 - - 1 5 current -
bx2d-2x8 intel amd64 balanced 2 8 4000 1000 - 1x75 1 5 previous one_year,three_year
bx3-2x10 intel amd64 balanced 2 10 4000 1000 - - 1 5 current -
bx3d-2x10 intel amd64 balanced 2 10 4000 1000 - 1x65 1 5 current one_year,three_year
예약이 있는 인스턴스 나열하기
명령행 인터페이스 (CLI) 를 사용하여 사용자 지역에서 예약 조건이 있는 인스턴스를 나열할 수 있습니다. CLI를 사용하여 예약 조건이 있는 인스턴스를 나열하려면 ibmcloud is instances 명령을 사용하십시오. 나열하려는 특정 인스턴스에 대해 ' INSTANCE_NAME '을 사용하여 특정 인스턴스의 이름 또는 ID를 지정해야 합니다.
ibmcloud is instances
다음 예를 참조하십시오.
ibmcloud is instance instance-cli-test-patch-reservation-1
Getting instance instance-cli-test-patch-reservation-1 under account VPCUI-DEV as user user@ibm.com...
ID 0735_78c1b310-6dc3-45d4-9c01-0335dc526135
Name instance-cli-test-patch-reservation-1
CRN crn:v1:bluemix:public:is:us-south-3:a/a1234567::instance:0735_78c1b310-6dc3-45d4-9c01-0335dc526135
Status running
Availability policy on host failure restart
Startable true
Profile cx2-2x4
Architecture amd64
vCPU Manufacturer intel
vCPUs 2
Memory(GiB) 4
Bandwidth(Mbps) 4000
Volume bandwidth(Mbps) 1000
Network bandwidth(Mbps) 3000
Lifecycle Reasons Code Message
- -
Lifecycle State stable
Metadata service Enabled Protocol Response hop limit
false http 1
Image ID Name
r006-f47cc24c-e020-4db5-ad96-1e5be8b5853b ibm-centos-7-9-minimal-amd64-11
Numa Count 1
VPC ID Name
r006-832aa717-816d-4351-8c44-65399dbfe069 test
Zone us-south-3
Resource group ID Name
11caaa983d9c4beb82690daab08717e9 Default
Created 2023-10-18T18:39:48+05:30
Network Interfaces Interface Name ID Subnet Subnet ID Floating IP Security Groups Allow source IP spoofing Reserved IP
Primary primary 0735-a51439ba-9a96-4f17-867c-89cffcd76c31 sn-20231006-01 0735-3edc7506-bece-4ee6-9c5c-916c750dab57 - dream-grove-spleen-tinwork false 10.240.128.18
Boot volume ID Name Attachment ID Attachment name
r006-4ca2ad61-98c8-4182-a095-82cbd5db2f1f dynastic-thyself-hunter-compile 0735-7cd56e60-025d-4dda-ab17-003457d2df30 sterilize-handlebar-transpire-blender
Reservation Affinity Policy manual
Reservation Affinity Pool ID Name CRN Resource type
0735-4d504e68-b22b-41ed-9a13-6df324301a9f reservation-cli-test-1 crn:v1:bluemix:public:is:us-south-3:a/a1234567::reservation:0735-4d504e68-b22b-41ed-9a13-6df324301a9f reservation
Reservation ID Name CRN Resource type
0735-4d504e68-b22b-41ed-9a13-6df324301a9f reservation-cli-test-1 crn:v1:bluemix:public:is:us-south-3:a/a1234567::reservation:0735-4d504e68-b22b-41ed-9a13-6df324301a9f reservation
Health State ok
예약 조건이 포함된 인스턴스 프로필 가져오기
명령행 인터페이스 (CLI) 를 사용하여 사용자 지역에서 예약 조건이 있는 인스턴스 프로파일을 가져올 수 있습니다. CLI를 사용하여 예약 조건이 있는 인스턴스 프로파일을 가져오려면 ibmcloud is instance-profile 명령을 사용하십시오.
ibmcloud is instance-profile PROFILE_NAME
다음 예를 참조하십시오.
ibmcloud is instance-profile bx2-2x8
Getting instance profile bx2-2x8 under account VPCUI-DEV as user user@ibm.com...
Name vCPU Manufacturer Architecture Family vCPUs Memory(GiB) Bandwidth(Mbps) Volume bandwidth(Mbps) GPUs Storage(GB) Min NIC Count Max NIC Count Status Reservation Terms
bx2-2x8 intel amd64 balanced 2 8 4000 1000 - - 1 5 current -
API를 통한 예약 관리
API(애플리케이션 프로그래밍 인터페이스)를 사용하여 예약을 관리하려면 다음 작업이 포함된 IAM 역할이 필요합니다. 자세한 정보는 VPC 인프라 서비스에 대한 IAM 액세스 관리 를 참조하십시오.
- is.reservation.reservation.list
- is.reservation.reservation.read
- is.reservation.reservation.create
- is.reservation.reservation.delete
- is.reservation.reservation.read
- is.reservation.reservation.update
모든 예약 목록 보기
API (Application Programming Interface) 를 사용하여 사용자 지역의 모든 IBM Cloud VPC 예약을 나열할 수 있습니다. API를 사용하여 모든 예약을 나열하려면 모든 이미지 나열 을 사용하십시오.
GET /reservations 요청을 지정하여 모든 예약을 나열하십시오. 다음 예를 참조하십시오.
curl -X GET "$vpc_api_endpoint/v1/reservations?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token"
예약은 먼저 create_at 특성 값을 기준으로 정렬됩니다. 최신 예약이 먼저 나열됩니다. 예약에 동일한 created_at 특성 값이 있는 경우 name 특성 값별로 정렬됩니다. 예약 목록의 기본값은 50개이지만 최대 100개까지 늘릴 수 있습니다.
다음 특성 값을 사용하여 목록을 추가로 필터링할 수 있습니다.
nameresource_group.idzone.name
예약 삭제하기
API (Application Programming Interface) 를 사용하여 리젼에서 IBM Cloud VPC 예약을 삭제할 수 있습니다. API를 사용하여 예약을 삭제하려면 예약 삭제 를 사용하십시오.
예약을 삭제하려면 ' DELETE /reservation 요청을 지정하세요. 다음 예를 참조하십시오.
curl -X DELETE "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" - H "Authorization: Bearer $iam_token"
예약 검색하기
API (Application Programming Interface) 를 사용하여 리젼에서 특정 IBM Cloud VPC 예약을 검색할 수 있습니다. API를 사용하여 특정 예약을 검색하려면 예약 검색 을 사용하십시오.
특정 예약을 검색하려면 ' GET /reservation/{id} 요청을 지정하고, 여기서 ' id '는 검색하려는 예약의 예약 식별자입니다. 식별자는 URL 에 있습니다. 다음 예를 참조하십시오.
curl -X GET "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" - H "Authorization: Bearer $iam_token"
예약 업데이트
API (Application Programming Interface) 를 사용하여 리젼에서 특정 IBM Cloud VPC 예약을 업데이트합니다. API를 사용하여 특정 예약을 업데이트하려면 예약 업데이트 를 사용하십시오.
PATCH /reservations/{id} 요청을 지정하여 특정 예약을 업데이트하십시오. 여기서 id 는 검색 중인 예약의 예약 ID입니다. 식별자는 URL 에 있습니다. 다음 예를 참조하십시오.
curl -X PATCH "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token" -d '{
"committed_use": {
"expiration_policy": "release"
}
}'
예약 활성화
API(애플리케이션 프로그래밍 인터페이스)를 사용하여 해당 지역의 특정 IBM Cloud VPC 예약을 활성화할 수 있습니다. API를 사용하여 특정 예약을 활성화하려면 예약 활성화를 사용하세요.
POST /reservations/{id}/activate 요청을 지정하여 특정 예약을 업데이트하십시오. 여기서 id 는 검색 중인 예약의 예약 ID입니다. 식별자는 URL 에 있습니다. 다음 예를 참조하십시오.
curl -X POST "$vpc_api_endpoint/v1/reservations/$id/activate?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token"