콘솔에서 File Storage for Classic 볼륨 목록 보기

리소스 목록에서 볼륨을 확인하거나, File Storage for Classic 볼륨 목록으로 이동하여 볼륨을 확인할 수 있습니다.

1. IBM Cloud® 콘솔로 이동하십시오. 메뉴에서 인프라 > 클래식 인프라를 선택합니다.
2. 스토리지 > File Storage for Classic를 클릭하십시오. 파일 공유 목록이 표시됩니다.
3. )을 클릭하고 위치를 선택하거나 특정 용량을 입력하여 목록을 필터링할 수 있습니다. ‘적용’을 클릭하여 선택을 확인하세요.
4. 목록에서 적절한 볼륨 이름을 클릭하십시오.

클릭하면 목록을 PDF( CSV ) 형식으로 다운로드할 수 있습니다.

이 표에는 이름, 위치, 상태, 스토리지 유형, 최대 IOPS, 용량, 사용량, 스냅샷 용량, 시작 날짜 및 참고 사항과 같은 볼륨에 대한 정보가 표시되며, 이 정보는 편집할 수 있습니다.

CLI에서 File Storage for Classic 볼륨 목록 보기

시작하기 전에 사용할 CLI 클라이언트를 결정하십시오.

• ibmcloud plugin install sl 를 사용하여 IBM Cloud CLI 를 설치하고 SL 플러그인을 설치할 수 있습니다. 자세한 정보는 플러그인을 사용하여 IBM Cloud CLI 확장 을 참조하십시오.
• 또는 SLCLI를 설치할 수 있습니다.

ibmcloud sl file volume-list -d dal13 -t endurance --sortby capacity_gb

id          username              datacenter   storage_type             capacity_gb   bytes_used   IOPs   ip_addr                                lunId   active_transactions   rep_partner_count   notes
233039512   IBM02SEV1414935_79    dal13        endurance_file_storage   20            0            -      fsf-dal1303g-fz.adn.networklayer.com   -       0                     1                   -
703233985   IBM02SEV1414935_538   dal13        endurance_file_storage   20            0            -      fsf-dal1303d-fz.adn.networklayer.com   -       0                     0                   -
221349094   IBM02SEV1414935_68    dal13        endurance_file_storage   30            0            -      fsf-dal1302c-fz.adn.networklayer.com   -       0                     1                   Testing

$ slcli file volume-list --help
Usage: slcli file volume-list [OPTIONS]

        List file storage.

Example::
        slcli file volume-list -d dal10 --storage-type endurance --sortby capacity_gb

┌────┬────────────────┬──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ -u │ --username     │ Volume username                                                                                                                                                              │
│ -d │ --datacenter   │ Datacenter shortname                                                                                                                                                         │
│ -o │ --order        │ Filter by ID of the order that purchased the block storage                                                                                                                   │
│    │ --storage-type │ Type of storage volume Choices: performance, endurance                                                                                                                       │
│    │ --sortby       │ Column to sort by                                                                                                                                                            │
│    │ --columns      │ Columns to display. Options: id, username, datacenter, storage_type, capacity_gb, bytes_used, ip_addr, active_transactions, mount_addr, rep_partner_count, created_by, notes │
│ -h │ --help         │ Show this message and exit.                                                                                                                                                  │
└────┴────────────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

API로 File Storage for Classic 볼륨 목록 보기

API로 File Storage for Classic 볼륨 목록을 검색하려면 list_file_volumes 메서드를 사용하고 datacenter, storage_type (내구성 또는 성능) 및 order 매개 변수를 사용하여 결과를 필터링할 수 있습니다. 요청은 세부 정보가 포함된 파일 볼륨 목록을 반환합니다.

다음 예제와 같은 curl 명령을 사용하여 스토리지 볼륨의 다양한 측면을 쿼리할 수도 있습니다. 이 예에서는 현재 사용 중인 바이트 수를 반환합니다.

curl -g -u $SL_USER:$SL_APIKEY -X GET \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/{volume_ID}/collectBytesUsed'

다음 요청은 볼륨의 최대 IOPS 값을 반환합니다.

curl -g -u $SL_USER:$SL_APIKEY -X GET \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/{volume_ID}/getIops'

자세한 내용은 SoftLayer_Network_Storage 문서를 참조하세요.

콘솔에서 볼륨의 노트 업데이트하기

1. IBM Cloud® 콘솔로 이동하십시오. 메뉴에서 인프라 > 클래식 인프라를 선택합니다.
2. 스토리지 > File Storage for Classic를 클릭하십시오.
3. 업데이트할 볼륨을 찾으십시오. 볼륨 이름을 클릭하면 볼륨 세부정보 페이지를 볼 수 있습니다.
4. 참고 옆에 있는 편집 아이콘 을 클릭하고 텍스트를 입력합니다.

CLI에서 볼륨의 메모 업데이트하기

ibmcloud sl call-api 명령을 사용해 볼륨에 노트를 추가하고 수정할 수 있습니다.

$ ibmcloud sl call-api --help
NAME:
  call-api - Call arbitrary API endpoints

USAGE:
  ibmcloud sl call-api SERVICE METHOD [OPTIONS]

OPTIONS:
  --filter value      Object filters
  -h, --help          Usage information.
  --init value        Init parameter
  --limit value       Result limit
  --mask value        Object mask: use to limit fields returned
  --offset value      Result offset
  --output value      Specify output format, only JSON is supported now.
  --parameters value  Append parameters to web call

--init 옵션에서 볼륨 ID를 지정하고 --parameters 옵션을 사용해 새 노트를 설정합니다. 다음 예를 참조하십시오.

ibmcloud sl call-api SoftLayer_Network_Storage editObject --init 562193766 --parameters '[{"notes":"Testing."}]'

자세한 내용은 ibmcloud sl call-api를 참조하세요.

API를 사용하여 볼륨의 메모 업데이트하기

API를 사용해 볼륨의 노트를 업데이트하려면 POST /SoftLayer_Network_Storage/$VOLUME_ID/editObject.json curl 요청을 하면 됩니다. 다음 API 예제는 스토리지 볼륨에 "Testing"이라는 단어를 메모로 추가합니다.

curl -u $SL_USER:$SL_APIKEY -X POST -H "Accept: */*" -H "Accept-Encoding: gzip, deflate, compress" -d '{"parameters": [{"notes": "Testing"}]}' 'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/123456789/editObject.json'

또는 API Python 클라이언트에서 volume_set_note 메서드를 사용할 수 있습니다.

콘솔에서 ‘ File Storage for Classic ’ 볼륨에 액세스할 권한이 있는 호스트 목록 확인하기

1. IBM Cloud® 콘솔로 이동하십시오. 메뉴에서 인프라 > 클래식 인프라를 선택합니다.
2. 스토리지 > File Storage for Classic를 클릭하고 볼륨 이름을 클릭하십시오.
3. 파일 공유에 대한 액세스 권한이 있는 컴퓨팅 인스턴스를 표시하려면 권한 부여된 호스트를 클릭하십시오.
4. 줄임표 클릭하고 호스트 세부정보 보기를 선택합니다. 장치 이름, IP 주소, 사용자 이름, 비밀번호 등의 세부 정보가 표시된 사이드 패널이 표시됩니다. 액세스 제어 목록 섹션도 표시됩니다. 접근 제어 목록 섹션에서 서브넷을 추가하거나 제거할 수 있습니다.

대상 주소는 스토리지 세부사항 페이지에 나열되어 있습니다. NFS의 경우 대상 주소는 DNS 이름으로 설명되고, iSCSI의 경우 대상 발견 포털의 IP 주소로 설명됩니다.

CLI를 통해 File Storage for Classic 볼륨에 액세스할 수 있는 권한이 있는 호스트 목록 확인

ibmcloud sl file access-list 12345678 --sortby id

$ slcli file access-list --help
Usage: slcli file access-list [OPTIONS] VOLUME_ID

Options:
 --sortby TEXT   Column to sort by
 --columns TEXT  Columns to display. Options: id, name, type,
                 private_ip_address, source_subnet, host_iqn, username,
                 password, allowed_host_id
 -h, --help      Show this message and exit.

콘솔에서 호스트가 액세스 권한이 있는 File Storage for Classic 볼륨 확인하기

호스트가 액세스할 수 있는 볼륨을 확인할 수 있으며, 여기에는 연결에 필요한 정보(볼륨 이름, 스토리지 유형, 대상 주소, 용량, 위치)가 포함됩니다.

1. IBM Cloud® 콘솔로 이동하십시오.
2. 메뉴에서 인프라 > 클래식 인프라를 선택합니다.
3. 디바이스 > 디바이스 목록을 클릭하십시오.
4. 적절한 디바이스를 클릭하십시오.
5. 스토리지 탭을 선택하십시오.

스토리지 유형(블록, 파일, 기타)별로 모두 그룹화된, 이 특정 호스트가 액세스할 수 있는 스토리지 볼륨의 목록이 표시됩니다. 각각의 조치 메뉴에서 추가 스토리지에 권한을 부여하거나 액세스를 제거할 수 있습니다.

콘솔에서 호스트의 File Storage for Classic 접속 권한 취소

특정 스토리지 볼륨에 대한 호스트의 액세스를 중지하려면 액세스를 취소할 수 있습니다. 액세스 권한이 취소되면 해당 호스트 연결이 볼륨에서 삭제됩니다. 운영 체제 및 애플리케이션이 더 이상 볼륨과 통신할 수 없게 됩니다.

호스트 측 문제를 방지하려면, 누락된 드라이브나 데이터 손상을 피할 수 있도록 액세스 권한을 취소하기 전에 운영 체제에서 해당 스토리지 볼륨을 마운트 해제하십시오.

스토리지 보기 또는 디바이스 목록의 스토리지에서 액세스를 취소할 수 있습니다.

CLI를 통해 호스트의 File Storage for Classic 접속 권한 취소

ibmcloud sl file access-revoke 12345678 --virtual-id 87654321

$ slcli file access-revoke --help
Usage: slcli file access-revoke [OPTIONS] VOLUME_ID

Options:
  -h, --hardware-id TEXT    The ID of one hardware server to revoke authorization.
  -v, --virtual-id TEXT     The ID of one virtual server to revoke authorization.
  -i, --ip-address-id TEXT  The ID of one IP address to revoke authorization.
  -p, --ip-address TEXT     An IP address to revoke authorization.
  -s, --subnet-id TEXT      An ID of one subnet to revoke authorization.
  --help                    Show this message and exit.

API로 호스트의 File Storage for Classic 액세스 권한 취소하기

파일 볼륨에 액세스할 수 있는 호스트 권한을 취소하려면 API Python 클라이언트에서 deauthorize_host_to_volume 메서드를 사용하면 됩니다. hardware_ids (베어 메탈 서버의 경우),virtual_guest_ids (가상 서버 인스턴스의 경우), ip_address_ids, subnet_ids 중 하나를 제공하여 volume_id 및 컴퓨트 호스트를 지정해야 합니다. 요청은 지정된 볼륨에 액세스할 수 있는 SoftLayer_Network_Storage_Allowed_Host 오브젝트 배열을 반환하므로 요청된 컴퓨팅 호스트가 제거되었는지 확인할 수 있습니다.

콘솔에서 스토리지 볼륨 삭제하기

특정 볼륨이 더 이상 필요하지 않은 경우 파일 공유를 삭제할 수 있습니다. 스토리지 볼륨을 취소하려면 먼저 모든 호스트에서 액세스 권한을 취소해야 합니다.

1. IBM Cloud® 콘솔로 이동하십시오. 메뉴에서 인프라 > 클래식 인프라를 선택합니다.

2. 스토리지 > File Storage for Classic를 클릭하십시오.

3. 취소할 볼륨에 대한 조치 를 클릭하고 삭제 File Storage for Classic 를 선택하십시오.

4. 볼륨을 즉시 삭제할지, 아니면 볼륨이 프로비저닝된 날짜의 기념일에 삭제할지 확인하십시오.

   지정일에 볼륨을 취소하는 옵션을 선택하는 경우, 해당 지정일 이전에 취소 요청을 무효화할 수 있습니다.

5. 계속 또는 닫기를 클릭하십시오.

6. 확인란을 선택한 다음 ‘확인’을 클릭하세요.

볼륨이 취소되면 요청 뒤에 24시간재생 대기 기간이 옵니다. 이 24시간 동안에는 콘솔에서 해당 볼륨을 계속 확인할 수 있습니다. 볼륨에 대한 비용 청구는 즉시 중지됩니다. 재확보 기간이 만료되면 데이터가 영구 삭제되고 콘솔에서 볼륨이 제거됩니다. 자세한 정보는 FAQ를 참조하십시오.

활성 복제본 및 종속 복제본은 스토리지 볼륨의 재확보를 차단할 수 있습니다. 원래 볼륨을 삭제하기 전에 볼륨이 더 이상 마운트되지 않고 호스트 권한이 취소되었고 복제가 취소되었고 종속 복제본이 없는지 확인하십시오.

CLI에서 스토리지 볼륨 삭제하기

볼륨이 취소되면 요청 뒤에 24시간재생 대기 기간이 옵니다. 이 24시간 동안에는 콘솔에서 해당 볼륨을 계속 확인할 수 있습니다. 볼륨에 대한 비용 청구는 즉시 중지됩니다. 재확보 기간이 만료되면 데이터가 영구 삭제되고 콘솔에서 볼륨이 제거됩니다. 자세한 정보는 FAQ를 참조하십시오.

활성 복제본 및 종속 복제본은 스토리지 볼륨의 재확보를 차단할 수 있습니다. 원래 볼륨을 삭제하기 전에 볼륨이 더 이상 마운트되지 않고 호스트 권한이 취소되었고 복제가 취소되었고 종속 복제본이 없는지 확인하십시오.

ibmcloud sl file volume-cancel 12345678 --immediate -f

$ slcli file volume-cancel --help
Usage: slcli file volume-cancel [OPTIONS] VOLUME_ID

Options:
  --reason TEXT  An optional reason for cancellation.
  --immediate    Cancels the File Storage volume immediately instead of on the
                 billing anniversary.
  -h, --help     Show this message and exit.

API를 사용하여 스토리지 볼륨 삭제하기

볼륨이 취소되면 요청 뒤에 24시간재생 대기 기간이 옵니다. 이 24시간 동안에는 콘솔에서 해당 볼륨을 계속 확인할 수 있습니다. 볼륨에 대한 비용 청구는 즉시 중지됩니다. 재확보 기간이 만료되면 데이터가 영구 삭제되고 콘솔에서 볼륨이 제거됩니다. 자세한 정보는 FAQ를 참조하십시오.

활성 복제본 및 종속 복제본은 스토리지 볼륨의 재확보를 차단할 수 있습니다. 원래 볼륨을 삭제하기 전에 볼륨이 더 이상 마운트되지 않고 호스트 권한이 취소되었고 복제가 취소되었고 종속 복제본이 없는지 확인하십시오.

그런 다음 API Python 클라이언트에서 cancel_volume 메서드를 사용할 수 있습니다. volume_id 를 지정하고, 구독을 즉시 해지할지 아니면 갱신일에 해지할지 선택하십시오 (immediate=False 또는 immediate=True). 원한다면 해지 사유도 함께 기재할 수 있습니다 (reason='No longer needed').

Terraform을 사용하여 스토리지 볼륨 삭제

terraform destroy 명령을 사용하면 단일 파일 공유와 같은 원격 개체를 편리하게 제거할 수 있습니다. 다음 예는 ID가 ibm_file_share.example.id 인 파일 공유를 취소합니다.

terraform destroy --target ibm_file_share.example.id

자세한 정보는 terraform destroy를 참조하십시오.

볼륨이 취소되면 요청 뒤에 24시간재생 대기 기간이 옵니다. 이 24시간 동안에는 콘솔에서 해당 볼륨을 계속 확인할 수 있습니다. 볼륨에 대한 비용 청구는 즉시 중지됩니다. 재확보 기간이 만료되면 데이터가 영구 삭제되고 콘솔에서 볼륨이 제거됩니다. 자세한 정보는 FAQ를 참조하십시오.

활성 복제본 및 종속 복제본은 스토리지 볼륨의 재확보를 차단할 수 있습니다. 원래 볼륨을 삭제하기 전에 볼륨이 더 이상 마운트되지 않고 호스트 권한이 취소되었고 복제가 취소되었고 종속 복제본이 없는지 확인하십시오.