VPC에 대한 예약 관리

예약을 프로비저닝한 후 다음 조치를 사용하여 예약을 관리할 수 있습니다.

가상 서버 예약 관리를 위한 작업
조치 설명
모든 예약 나열 해당 지역의 모든 예약을 나열해 주세요.
예약 작성 해당 지역에서 예약을 생성하세요.
예약 삭제 inactive 예약을 삭제합니다. active 예약을 삭제할 수 없습니다. 이 조치는 되돌릴 수 없습니다.
예약 검색 URL 에서 식별자로 지정된 예약을 검색합니다.
예약 업데이트 새 정보로 예약을 업데이트하십시오.
예약 활성화 inactive 예약을 활성화하십시오.

시작하기 전에

가상 서버를 연결하기 전에 예약을 프로비저닝해야 합니다. 자세한 정보는 가상 서버에 대한 예약 프로비저닝 을 참조하십시오.

계정 관리자가 아닌 경우에는 사용자 계정에 예약된 용량 관리 권한이 포함되어 있어야 합니다. 권한 업데이트에 대한 자세한 정보는 VPC 인프라 서비스에 대한 IAM 액세스 관리 를 참조하십시오.

UI를 사용하여 예약 관리

UI를 사용하여 예약 및 연결된 서버를 관리할 수 있습니다.

UI를 사용하여 예약에 가상 서버 인스턴스 연결하기

예약에 가상 서버를 연결할 수 있습니다.

  1. IBM Cloud 콘솔 에서 탐색 메뉴 아이콘을 클릭한 다음, 메뉴 아이콘 > 인프라 VPC 아이콘 > 예약 순으로 선택합니다.
  2. 예약 세부사항 페이지에서 예약을 선택하십시오.
  3. 가상 서버 목록에서 조치 > 첨부를 클릭하십시오.
  4. 예약에 연결할 서버를 선택하고 연결을 클릭합니다.

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

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

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

인스턴스가 중지되었다가 다시 시작되면 만료된 예약을 가리키더라도 시작이 허용되고 종량제 요금으로 청구됩니다.

예약 삭제 시 특별 고려 사항

' inactive 예약을 삭제할 수 있으며 다음 필드를 패치할 수 있습니다.

  • 선호도_정책
  • capacity.total
  • committed_use.expiration_policy
  • committed_use.term
  • 이름
  • 프로파일

다른 필드를 변경하려면 예약을 삭제하고 다시 생성해야 합니다.

그러나 예약이 활성화되고 ' active'이 되면 예약의 많은 부분이 예약 기간 동안 영구적으로 유지됩니다. 예약을 활성화하기 전에 예약을 검토하여 구성이 올바른지 확인하세요. ' active 예약에 패치할 수 있는 필드는 ' name '와 ' committed_use.expiration_policy'뿐입니다.

UI를 통해 예약 삭제하기

예약을 삭제할 수 있습니다.

  1. IBM Cloud 콘솔 에서 탐색 메뉴 아이콘을 클릭한 다음, 메뉴 아이콘 > 인프라 VPC 아이콘 > 예약 순으로 선택합니다.
  2. 예약 목록에서 조치 > 예약 삭제를 누르십시오.
  3. 확인하려면 삭제를 클릭하십시오.

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개까지 늘릴 수 있습니다.

다음 특성 값을 사용하여 목록을 추가로 필터링할 수 있습니다.

  • name
  • resource_group.id
  • zone.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"