파일 공유, 공유 바인딩 및 마운트 대상 보기
콘솔에서 모든 파일 공유, 해당 바인딩 및 마운트 대상을 보고, CLI, API 또는 Terraform에서 해당 정보를 검색할 수 있습니다. 모든 공유, 바인딩 및 마운트 대상에 대한 정보 또는 특정 자원의 정보만 검색할 수 있습니다.
콘솔에서 파일 공유, 공유 바인딩 및 마운트 대상 보기
콘솔에서 모든 파일 공유 보기
-
IBM Cloud 콘솔에서 탐색 메뉴 아이콘
인프라 > 인프라
> 스토리지 > 파일 공유을 클릭합니다.
-
VPC용 파일 공유 목록 페이지에는 해당 영역에 생성된 모든 파일 공유가 표시됩니다. 조치 메뉴
옵션은 파일 공유를 관리하는 데 사용됩니다. 다음 표에서는 목록 페이지의 정보를 설명합니다.
필드 | 값 |
---|---|
지역 | 파일 공유에 대한 계정 지역입니다. 다른 지역을 선택하여 해당 지역 내의 구역에 대한 파일 공유를 봅니다. |
이름 | 파일 공유 이름입니다. 원본 파일 공유 또는 복제본 파일 공유일 수 있습니다. 해당 파일 공유에 대한 세부사항을 보려면 이름을 클릭하십시오. |
상태 | 파일 공유의 상태 목록은 파일 공유 수명 주기 상태를 참조하세요. |
마운트 대상 | 파일 공유와 연관된 마운트 대상의 수입니다. 파일 공유별로 VPC당 한 개의 마운트 대상을 보유할 수 있습니다. |
크기 | 파일 공유의 크기(GB)입니다. |
IOPS 프로파일 | 파일 공유와 연관된 성능 프로파일을 표시합니다. |
복제 역할 | 소스 파일 공유와의 관계. '복제본'은 파일이 연결된 소스 공유의 복제본을 공유하고 있음을 나타냅니다. '출처'는 연결된 복제본의 소스를 공유한다는 의미입니다. "없음" 은 파일 공유가 다른 공유로 복제되지 않음을 표시합니다. |
교차 계정 역할 | 이 열의 값은 없음, 원본 공유 또는 _참가자 공유_가 될 수 있습니다. 값이 _없음_인 경우 공유는 다른 계정이나 외부 서비스와 공유되지 않습니다. 값이 _원본 공유_인 경우 공유는 다른 계정 또는 외부 서비스와 공유되며 다른 계정의 액세스 권한자 공유에 바인딩됩니다. 값이 _접근자 공유_인 경우, 이 공유는 원본 공유의 데이터에 액세스하기 위한 목적으로 원본 공유에 바인딩됩니다. |
암호화 유형 | 파일 공유의 암호화 유형(공급자 관리형 또는 고객 관리형)이 표시됩니다. 고객 관리 암호화는 사용자 고유 루트 키를 사용하여 데이터를 보호합니다. UI는 또한 키 관리 서비스 (KMS), Key Protect 또는 Hyper Protect Crypto Services를 식별합니다. |
를 클릭하여 조치 메뉴에 액세스할 수 있습니다. 조치 메뉴에는 상태에 따라 파일 공유를 관리하기 위한 옵션이 있습니다. 안정 상태의 파일 공유의 경우 공유 이름을 바꾸거나, IOPS를 편집하거나, 공유의 CRN을 복사하거나, 복제본을 만들거나, 파일 공유를 삭제할 수 있습니다. 복제본 파일 공유에
복제를 이미 설정한 경우에는 삭제 및 복제본 만들기가 비활성화됩니다. 자세한 내용은 다음을 참조하세요.복제본 파일 공유 생성.
콘솔에서 파일 공유의 세부 정보 보기
-
모든 파일 공유 목록으로 이동하십시오. IBM Cloud 콘솔에서 탐색 메뉴 아이콘
인프라 > 인프라
> 스토리지 > 파일 공유을 클릭합니다.
-
세부사항 페이지를 보려면 파일 공유의 이름을 클릭하십시오. 파일 공유의 편집 가능한 이름과 상태가 표시됩니다. 파일 공유에 사용자 또는 액세스 관리 태그를 적용한 경우 해당 태그는 상태 옆에 나열됩니다. 태그 추가 를 클릭하여 새 태그 를 공유에 적용하십시오.
-
세부 정보 페이지에는 여러 탭이 있습니다. 기본적으로 개요 탭이 표시됩니다.
-
개요- 다음 표에서는 파일 공유에 사용할 수 있는 정보를 설명합니다.
파일 공유 세부 정보 페이지 필드 값 파일 공유 세부사항 이름 파일 공유 이름입니다. 편집 아이콘 을 클릭하여 이름을 변경하십시오.
파일 공유 ID 파일 공유를 만들 때 생성된 UUID입니다. 리소스 그룹 계정의 파일 공유와 연관된 리소스 그룹입니다. 작성 날짜 파일 공유가 작성된 날짜입니다. 위치 파일 공유의 위치(예: us-south-2 ). 복제 역할 소스 파일 공유 또는 복제본. 암호화 제공자 관리 또는 고객 관리 암호화 를 지정합니다. 고객이 관리하는 키를 사용하여 파일 공유를 암호화한 경우에는 암호화 인스턴스, 암호화 키 이름 및 암호화 키 CRN도 표시됩니다. 마운트 대상 액세스 모드 파일 공유에 대한 액세스는 서브넷 내의 보안 그룹 또는 VPC의 가상 서버 인스턴스에 의해 부여됩니다. 편집 아이콘 을 클릭하여 액세스 모드를 전환하십시오. 보안 그룹 액세스는
dp2
프로파일 로 작성된 파일 공유에만 사용할 수 있습니다. 자세한 정보는 마운트 대상 액세스 모드 를 참조하십시오.CRN 파일 공유의 복사 가능한 클라우드 리소스 이름입니다. 전송 모드에서 암호화 허용 이 값은 클라이언트가 파일 공유에 액세스할 때 전송 중인 암호화가 필요한지 여부를 표시합니다. 편집 아이콘 을 클릭하여 허용되는 값을 변경하십시오. 사용 가능한 값은 사용자 관리 및 없음입니다. 이 필드는 VPC 액세스 모드가 있는 파일 공유에는 적용되지 않습니다.
교차 계정 역할 사용 가능한 값은 없음, 원본, 접근자입니다. 이 필드는 VPC 액세스 모드가 있는 파일 공유에는 적용되지 않습니다. 스냅샷 수 이 값은 파일 공유에서 만든 스냅샷의 수를 나타냅니다. 이 필드는 VPC 액세스 모드가 있는 파일 공유에는 적용되지 않습니다. 모든 스냅샷에서 변경된 데이터의 크기 모든 스냅샷에서 청구 가능한 데이터의 양을 나타냅니다. 이 필드는 VPC 액세스 모드가 있는 파일 공유에는 적용되지 않습니다. 프로파일 세부사항 프로파일 파일 공유 성능을 정의하는 공유 프로필의 이름입니다. 대부분의 경우 dp2 프로필을 사용합니다. 크기 파일 공유 용량(GB). 최대 IOPS 지정한 공유의 최대 IOPS입니다. 마운트 대상 파일 공유와 연관된 마운트 대상의 수입니다. 파일 공유별로 VPC당 한 개의 마운트 대상을 보유할 수 있습니다. 기타 VPC에 대한 추가 마운트 대상을 작성할 수 있습니다. 마운트 대상의 이름을 바꾸거나 삭제하거나 마운트 경로를 보려면 을 클릭하십시오.
이름 마운트 대상의 이름. 상태 VPC에 있는 마운트 대상의 상태. Virtual Private Cloud 이 필드는 파일 공유에 VPC 액세스 모드가 있는 경우에 표시됩니다. 이름을 클릭하면 해당 VPC의 세부 정보 페이지로 이동하여 해당 VPC에 마운트 대상이 있는 파일 공유 목록을 볼 수 있습니다. 서브넷 이 필드는 파일 공유에 보안 그룹 액세스 모드가 있는 경우에 표시됩니다. 서브넷의 이름을 클릭하면 세부 정보를 확인할 수 있습니다. 보안 그룹 이 필드는 파일 공유에 보안 그룹 액세스 모드가 있는 경우에 표시됩니다. 공유가 구성원인 보안 그룹의 수입니다. 예약된 IP 이 필드는 파일 공유에 보안 그룹 액세스 모드가 있는 경우에 표시됩니다. 마운트 대상에 연결된 가상 네트워크 인터페이스의 IP 주소 전송 중 암호화 이 필드는 파일 공유에 보안 그룹 액세스 모드가 있는 경우에 표시됩니다. 이 값은 활성화 또는 비활성화할 수 있습니다. 액세서 공유 바인딩 이 섹션은 공유에 다른 VPC의 액세스 권한 공유가 있는 경우에 표시됩니다. 바인딩 ID 이 필드는 원래 공유를 액세서 공유에 연결하는 바인딩의 ID를 표시합니다. 계정 ID 액세서 공유를 통해 공유의 데이터에 액세스할 수 있는 계정의 ID입니다. 액세서 ID 이 필드는 다른 VPC에서 액세서 공유를 작성한 계정 ID를 표시합니다. 상태 액세서 파일 공유의 라이프사이클 상태를 표시합니다. status Stable
가 예상됩니다.작성 날짜 액세스 권한 공유가 생성된 날짜와 시간입니다. 파일 공유 복제 관계 소스 및 복제본 파일 공유의 이름, 위치 및 상태를 표시합니다.
- 복제본 파일 공유가 작성되지 않은 경우 복제본 작성 을 클릭하여 복제본 작성 을 클릭하십시오.
- 복제 관계를 중단하려면 복제 관계 제거를 클릭하십시오. 그런 다음 복제본 파일 공유는 독립적인 읽기/쓰기 파일 공유가 됩니다.
복제 빈도 정보 아이콘 위로 마우스를 가져가면 크론 복제 일정에 대한 설명을 볼 수 있습니다. 상태 복제 상태. 예: 일시 중지됨 또는 사용 가능. 마지막 동기화 시작 시간 마지막 복제가 시작된 날짜와 시간입니다. 마지막 동기화 완료 시간 마지막 복제가 종료된 날짜와 시간입니다. 전송 비율 마지막 동기화 중에 소스 파일 공유에서 해당 복제본으로 데이터가 복사된 속도를 표시합니다. 이체 금액 마지막 동기화 중에 소스 파일 공유에서 해당 복제본으로 복사된 데이터의 양입니다. 복제 역할 소스 또는 복제본 파일 공유. 파일 공유 이름 세부 정보를 확인하려면 파일 공유의 이름을 클릭하십시오. 위치 파일 공유의 영역 정보를 표시합니다. 상태 파일 공유의 라이프사이클 상태를 표시합니다. status Stable
가 예상됩니다. -
스냅샷- 스냅샷 탭에서 모든 스냅샷과 파일 공유에 대한 스냅샷 목록과 관련된 요약을 확인할 수 있습니다.
- 스냅샷 요약은 스냅샷 수, 스냅샷에 캡처된 전체 데이터 볼륨, 복제 역할 등의 정보를 제공합니다.
- 스냅샷 목록에는 파일 공유에서 만든 스냅샷이 표시됩니다. 스냅샷을 찍을 때 파일 공유의 이름, 크기, 스냅샷의 상태를 확인할 수 있습니다. 만들기를 클릭하여 새 스냅샷을 캡처할 수 있습니다. 작업 아이콘 작업
클릭하면 작업 메뉴가 표시됩니다. 작업 메뉴에는 두 가지 옵션이 있습니다: 복원 및 삭제입니다.
-
모니터링- 모니터링 탭에서 공유 사용량, 총 처리량, 총 IOPS에 대한 세 가지 그래프를 볼 수 있습니다. 이러한 그래프는 IBM Cloud Monitoring 인스턴스가 없어도 무료로 사용할 수 있습니다. 날짜 범위를 사용자 지정하여 시간 경과에 따른 데이터를 볼 수 있습니다.
이러한 사용률 메트릭을 모니터링하면 애플리케이션 또는 워크로드에서 수행되는 작업량을 파악하는 데 도움이 될 수 있습니다. 이 정보를 사용하여 IOPS 값을 조정해야 하는지 여부를 결정할 수 있습니다. 공유의 사용 가능한 용량을 모니터링하면 공유에 데이터를 쓰거나 복제할 때 공간이 부족해 문제가 발생하기 전에 더 많은 스토리지가 필요한지 파악하는 데 도움이 됩니다. 이러한 지표를 확인하면 청구 기간이 끝날 때 요금이 변경될 수 있음을 예상하는 데 도움이 됩니다.
이러한 메트릭은 실시간으로 업데이트되지 않습니다. 새 파일 공유의 데이터는 대시보드에 표시되는 데 최대 1시간 또는 1시간 15분 정도 걸릴 수 있습니다. 사용량 변화가 그래프에 반영되기까지 15분에서 30분 정도 소요될 수 있습니다.
IBM Cloud Monitoring 서비스 인스턴스가 있는 경우 모니터링 시작을 클릭하여 Sysdig 웹 UI를 열고 거기서 메트릭 대시보드로 작업합니다. IBM Cloud Monitoring 인스턴스 설정 방법에 대한 자세한 내용은 File Storage for VPC 에 대한 모니터링 메트릭을 참조하세요.
-
콘솔에서 VPC의 모든 파일 공유 보기
VPC 세부사항 페이지를 보고 VPC에 대한 마운트 대상이 있는 모든 파일 공유를 볼 수 있습니다.
-
VPC로 이동:
- 파일 공유 세부사항 페이지에서 마운트 대상의 목록에 있는 VPC 링크를 클릭하십시오.
- UI에서 탐색 메뉴 아이콘
> 인프라
> 네트워크 > VPC 를 클릭합니다. 목록에서 VPC의 이름을 클릭하십시오.
-
VPC 세부사항 페이지에서 이 VPC의 파일 공유를 참조하십시오.
콘솔에서 마운트 대상 세부 정보 보기
- 모든 파일 공유 목록으로 이동하십시오. IBM Cloud 콘솔에서 탐색 메뉴 아이콘
인프라 > 인프라
> 스토리지 > 파일 공유을 클릭합니다.
- 세부사항 페이지를 보려면 파일 공유의 이름을 클릭하십시오.
- 마운트 대상 섹션으로 스크롤하여 마운트 대상 목록을 확인하십시오. 목록에는 마운트 대상의 이름 및 상태와 마운트 대상이 속한 VPC가 포함되어 있습니다.
- 작업 아이콘 작업
클릭하면 작업 메뉴가 표시됩니다. 조치 메뉴에는 이름 바꾸기, 경로 보기 및 삭제의 세 가지 옵션이 있습니다.
- 마운트 명령에서 복사하여 붙여넣을 수 있는 마운트 경로 정보를 보려면 경로 보기 를 클릭하십시오.
CLI에서 파일 공유, 공유 바인딩 및 마운트 대상 보기
CLI를 사용하려면 먼저 IBM Cloud CLI 및 VPC CLI 플러그인을 설치해야 합니다. 자세한 정보는 CLI 전제조건을 참조하십시오.
CLI에서 모든 파일 공유 보기
ibmcloud is shares
명령을 사용하여 리젼의 모든 파일 공유를 나열할 수 있습니다.
ibmcloud is shares
Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID Name Lifecycle state Zone Profile Size(GB) Resource group Replication role Accessor binding role Snapshot count Snapshot size
r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 my-file-share stable us-south-2 dp2 10 defaults none none 0 0
r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940 my-file-share-2 stable us-south-2 dp2 10 defaults none none 0 0
r006-a60bfa90-a893-40ad-be34-28ab51a963f9 replica-dal-2 stable us-south-2 dp2 10 defaults replica none 0 0
r006-3f21e3c3-e12d-425f-ab77-810cabfde8df source-dal-1 stable us-south-1 dp2 10 defaults source none 0 0
r006-455b601c-8fc1-4476-8771-4708c49c8ef7 my-replica-share-dal-1 stable us-south-1 dp2 10 defaults replica none 0 0
r006-4dadac27-cd17-42df-a5fe-1388705d33e0 my-source-share-dal-2 stable us-south-2 dp2 10 defaults source none 0 0
명령 옵션에 대한 자세한 정보는 ibmcloud is shares
의 내용을 참조하십시오. lifecycle state
에 대한 자세한 정보는 파일 공유 상태 를 참조하십시오. Stable
가 예상됩니다.
CLI에서 파일 공유의 세부 정보 보기
파일 공유의 세부사항을 보려면 ibmcloud is share
명령을 실행하고 ID 또는 이름별로 파일 공유를 지정하십시오.
다음 예는 ID별로 파일 공유를 식별하는 예입니다. 이 공유는 dp2
프로파일을 기반으로 하는 복제본이며 보안 그룹을 사용하여 공유에 대한 액세스 권한을 부여합니다. 출력은 소스 파일 공유 및 복제 세부사항에 대한 정보도 제공합니다.
$ ibmcloud is share r006-455b601c-8fc1-4476-8771-4708c49c8ef7
Getting file share r006-455b601c-8fc1-4476-8771-4708c49c8ef7 under account Test Account as user test.user@ibm.com...
ID r006-455b601c-8fc1-4476-8771-4708c49c8ef7
Name my-replica-share-dal-1
CRN crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-455b601c-8fc1-4476-8771-4708c49c8ef7
Lifecycle state stable
Access control mode security_group
Accessor binding role none
Allowed transit encryption modes none,user_managed
Zone us-south-1
Profile dp2
Size(GB) 10
IOPS 100
Encryption provider_managed
Mount Targets ID Name
No mounted targets found.
Resource group ID Name
6edefe513d934fdd872e78ee6a8e73ef defaults
Created 2025-04-04T09:19:27+00:00
Latest job Job status Job status reasons
succeeded -
Latest Sync Completed At Data Transferred Started At
2025-04-18T21:00:04+00:00 3560 2025-04-18T21:00:00+00:00
Replication cron spec 00 * * * *
Replication role replica
Replication status active
Replication status reasons Status code Status message
- -
Source share ID Name Resource type
r006-4dadac27-cd17-42df-a5fe-1388705d33e0 my-source-share-dal-2 share
Snapshot count 0
Snapshot size 0
Source snapshot -
소스 공유의 이름을 사용하여 세부사항을 검색할 수 있습니다. 다음 예를 참조하십시오.
$ ibmcloud is share my-source-file-share
Getting file share my-source-file-share under account Test Account as user test.user@ibm.com...
ID r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a
Name my-source-file-share
CRN crn:v1:bluemix:public:is:us-south-2:a/a1234567b::share:r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a
Lifecycle state stable
Access control mode security_group
Accessor binding role origin
Allowed transit encryption modes user_managed,none
Zone us-south-2
Profile dp2
Size(GB) 1500
IOPS 2000
User Tags env:dev
Encryption provider_managed
Mount Targets ID Name
r006-fdbffc45-618c-49f1-bb08-ec530d7be378 my-source-mount-target
Resource group ID Name
db8e8d865a83e0aae03f25a492c5b39e Default
Created 2024-06-25T15:42:53+00:00
Latest job Job status Job status reasons
succeeded -
Replication share ID Name Resource type
r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516 my-replica-file-share share
Replication role source
Replication status active
Replication status reasons Status code Status message
- -
Snapshot count 0
Snapshot size 0
명령 옵션에 대한 자세한 정보는 ibmcloud is share
의 내용을 참조하십시오.
CLI에서 파일 공유의 공유 바인딩 보기
CLI에서 원본 공유에 연결된 액세스 권한자 공유 바인딩을 보려면 ibmcloud is share-accesssor-bindings
명령을 사용합니다. 다음 예를 참조하십시오.
$ ibmcloud is share-accessor-bindings my-origin-share
Listing accessor bindings for the share ID my-origin-share under account Test Account as user test.user@ibm.com...
ID Lifecycle state Created at Accessor CRN
r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3 stable 2024-06-25T00:50:57+05:30 crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-925214bc-ded5-4626-9d8e-bc4e2e579232
CLI에서 파일 공유의 특정 공유 바인딩 보기
CLI에서 원본 공유에 연결된 특정 액세스 권한자 공유 바인딩을 보려면 ibmcloud is share-accesssor-binding
명령을 사용합니다. 다음 예를 참조하십시오.
$ ibmcloud is share-accessor-binding my-origin-share r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Get accessor binding r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3 for the share ID my-origin-share under account Test Account as user test.user@ibm.com...
ID r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Created 2024-06-25T00:50:57+05:30
Href https://us-south.iaas.cloud.ibm.com/v1/shares/r006-d73v40a6-e08f-4d07-99e1-d28cbf2188ed/bindings/r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Resource type share_accessor_binding
Lifecycle state stable
Accessor Resource type Name CRN
share my-accessor-share crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-925214bc-ded5-4626-9d8e-bc4e2e579232
CLI에서 파일 공유를 위한 마운트 대상 보기
파일 공유에 대해 작성된 모든 마운트 대상을 보려면 ibmcloud is share-mount-targets
명령을 실행하고 파일 공유 ID를 지정하십시오.
$ ibmcloud is share-mount-targets r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a
Listing share mount target of r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID Name VPC Lifecycle state Transit Encryption
r006-fdbffc45-618c-49f1-bb08-ec530d7be378 my-source-mount-target my-vpc stable none
명령 옵션에 대한 자세한 정보는 ibmcloud is share-mount-targets
의 내용을 참조하십시오.
CLI에서 마운트 대상 세부사항 보기
마운트 대상에 대한 자세한 정보를 보려면 ibmcloud is share-mount-target
명령을 실행하고 마운트 대상 이름 또는 ID와 함께 공유 ID 또는 이름을 지정하십시오. 다음 예를 참조하십시오.
$ ibmcloud is share-mount-target r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a my-source-mount-target
Getting mount target ID my-source-mount-target for share ID r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a under account Test Account as user test.user@ibm.com...
ID r006-fdbffc45-618c-49f1-bb08-ec530d7be378
Name my-source-mount-target
VPC ID Name
r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b my-vpc
Access control mode security_group
Resource type share_mount_target
Virtual network interface ID Name
r006-3b0c00fa-0ce3-4ff8-9a5d-c7a645fbe530 my-source-vni
Lifecycle state stable
Mount path 10.240.64.6:/5975a795_e5e7_474c_82d3_46c1d4159c6a
Transit Encryption none
Created 2023-10-19T15:42:54+00:00
명령 옵션에 대한 자세한 정보는 ibmcloud is share-mount-target
의 내용을 참조하십시오.
API를 사용하여 파일 공유, 공유 바인딩 및 마운트 대상 보기
다음 샘플 요청에 표시된 대로 VPC API 에서 /shares
메소드를 호출하여 프로그래밍 방식으로 공유 및 마운트 대상을 볼 수 있습니다.
generation
매개변수를 제공하고 generation=2
를 지정해야 합니다. 자세한 내용은 Virtual Private Cloud API 참조 의 생성을 참조하세요.
API를 사용하여 복제 상태 및 lifecycle_state보기
lifecycle_state
replication_status
- 이 특성은 파일 공유 검색 메소드를 통해 파일의 현재 복제 상태를 제공합니다.
replication_status
가 리턴하는 값은 파일 공유에 특정합니다. 자세한 내용은 가상 사설 클라우드 API 콘텐츠를 참조하세요.
- 이 특성은 파일 공유 검색 메소드를 통해 파일의 현재 복제 상태를 제공합니다.
API로 모든 파일 공유 보기
GET /shares
요청을 수행하여 지역의 모든 파일 공유를 나열합니다.
curl -X GET "$vpc_api_endpoint/v1/shares?version=2023-07-18?limit=50&generation=2" -H "Authorization: $iam_token"
성공적인 응답은 다음 예제와 유사합니다. 예제에서 ' limit
쿼리 매개변수는 50개의 파일 공유 제한을 지정하지만, 예제 응답에는 1개만 포함되어 있습니다. access_control_mode
특성 값은 vpc
이며, 이는 파일 공유가 VPC의 모든 가상 서버 인스턴스에 마운트될 수 있음을 의미합니다.
{
"first": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares?limit=50"
},
"limit": 50,
"shares": [
{
"access_control_mode": "vpc",
"created_at": "2023-07-18T13:02:17Z",
"crn": "crn:[...]",
"encryption": "provider_managed",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/51bba578-0dce-4f8a-aa6e-f06c899e2c8e",
"id": "51bba578-0dce-4f8a-aa6e-f06c899e2c8e",
"iops": 3000,
"lifecycle_state": "stable",
"name": "share-name1",
"profile": {
"family": "tiered",
"href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-10iops",
"name": "tier-10iops",
"resource_type": "share_profile"
},
"resource_group": {
"crn": "crn:[...]",
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/60fc731a-1794-4f5d-ba51-ea24b5357207",
"id": "60fc731a-1794-4f5d-ba51-ea24b5357207",
"name": "Default"
},
"resource_type": "share",
"size": 40,
"mount_targets": [
{
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/51bba578-0dce-4f8a-aa6e-f06c899e2c8e/mount_targets/d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
"id": "d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
"name": "mount-target-name1",
"resource_type": "share_target",
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/c2d941de-27f5-432c-b4d0-37a8491c3216",
"id": "c2d941de-27f5-432c-b4d0-37a8491c3216",
"name": "vpc-name1",
"resource_type": "vpc"
}
}
],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1"
}
}
]
}
API로 단일 파일 공유 보기
GET /shares/{share_id}
요청을 수행하여 단일 파일 공유에 대한 세부 정보를 확인합니다.
curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id?version=2025-04-01&generation=2"\
-H "Authorization: $iam_token"
성공적인 응답은 다음 예제와 유사합니다. 이 예에서는 ' dp2
' 프로필로 공유를 만들었습니다. access_ control_mode
특성 값은 security_group
이며, 이는 공유에 대한 액세스가 보안 그룹의 규칙에 의해 판별됨을 의미합니다.
{
"access_control_mode": "security_group",
"accessor_binding_role": "none",
"accessor_bindings": [],
"allowed_transit_encryption_modes": [
"none",
"user_managed"
],
"created_at": "2025-04-04T09:17:14.000Z",
"crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
"encryption": "provider_managed",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
"id": "r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
"iops": 100,
"latest_job": {
"status": "succeeded",
"status_reasons": [],
"type": "replication_init"
},
"lifecycle_reasons": [],
"lifecycle_state": "stable",
"mount_targets": [],
"name": "my-source-share-dal-2",
"profile": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
"name": "dp2",
"resource_type": "share_profile"
},
"replica_share": {
"crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
"id": "r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
"name": "my-replica-share-dal-1",
"resource_type": "share"
},
"replication_role": "source",
"replication_status": "active",
"replication_status_reasons": [],
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
"id": "6edefe513d934fdd872e78ee6a8e73ef",
"name": "defaults"
},
"resource_type": "share",
"size": 10,
"snapshot_count": 0,
"snapshot_size": 0,
"user_tags": [],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
"name": "us-south-2"
}
}
API를 사용하여 파일 공유의 공유 바인딩 나열
GET /shares/{id}/bindings
요청을 작성하여 단일 파일 공유의 바인딩 목록을 가져오십시오. 요청은 공유에 대한 모든 바인딩을 나열합니다. 각 바인딩은 액세서 공유가 작성될 때 내재적으로 작성됩니다.
curl -X GET "$vpc_api_endpoint/v1/shares/$share_id/bindings?version=2024-03-20&generation=2"\
-H "Authorization: $iam_token"
성공적인 응답은 다음 예제와 유사합니다.
{
"bindings": [
{
"accessor": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
"id": "r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
"name": "my-accessor-share",
"resource_type": "share"
},
"account": {
"id": "a0000000000000000000000000000001",
"resource_type": "account"
},
"created_at": "2022-01-07T16:56:54Z",
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r134-df760133-3513-47e7-b980-26cca666561b",
"id": "r134-df760133-3513-47e7-b980-26cca666561b",
"lifecycle_state": "stable",
"name": "my-share-bind",
"resource_type": "share_binding"
}
],
"first": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-65f30e48-3074-4eb0-9ec4-51ce2ec968eb/bindings?limit=20"
},
"limit": 50,
"total_count": 1
}
API를 사용하여 파일 공유의 특정 바인딩 보기
GET /shares/{share_id}/bindings/{binding_id}
요청을 작성하여 파일 공유의 특정 바인딩에 대한 정보를 가져오십시오. 이 요청은 URL 식별자로 지정된 단일 바인딩을 검색합니다.
curl -X GET "$vpc_api_endpoint/v1/shares/$share_id/bindings/$binding_id?version=2024-03-20&generation=2"\
-H "Authorization: $iam_token"
성공적인 응답은 다음 예제와 유사합니다.
{
"accessor": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
"id": "r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
"name": "my-accessor-share",
"resource_type": "share"
},
"account": {
"id": "a0000000000000000000000000000001",
"resource_type": "account"
},
"created_at": "2022-01-07T16:56:54Z",
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r134-df760133-3513-47e7-b980-26cca666561b",
"id": "r134-df760133-3513-47e7-b980-26cca666561b",
"lifecycle_state": "stable",
"name": "my-share-bind",
"resource_type": "share_binding"
}
API를 사용하여 파일 공유의 모든 마운트 대상 나열
GET /shares/{share_id}/mount_targets
요청을 수행하여 파일 공유의 모든 마운트 대상을 나열합니다.
다음 예를 참조하십시오.
curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets?version=2023-07-18?limit=50&generation=2"\
-H "Authorization: $iam_token"
성공적인 응답은 다음 예와 같습니다.
{
"first": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets?limit=50"
},
"limit": 50,
"mount_targets": [
{
"access_control_mode": "security_group",
"created_at": "2023-07-18T01:59:46.000Z",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets/r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
"id": "r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
"lifecycle_reasons": [],
"lifecycle_state": "stable",
"mount_path": "fsf-dal1099a-fz.adn.networklayer.com:/nxg_s_voll_mz0716_a4cc07a3_4425_4adf_aed6_0d7e142bee0c",
"name": "my-target",
"primary_ip": {
"address": "192.0.2.0",
"href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/35984145-9c3a-4626-8ee7-52c7a8742752/reserved_ips/0716-6fd4925d-7774-4e87-829e-7e5765d454ad",
"id": "0716-6fd4925d-7774-4e87-829e-7e5765d454ad",
"name": "my-reserved-ip",
"resource_type": "subnet_reserved_ip"
},
"resource_type": "share_mount_target",
"security_groups": [
{
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/security_groups/r006-1dfeccef-3ad6-4760-8653-a202bc795db4",
"id": "r006-1dfeccef-3ad6-4760-8653-a202bc795db4",
"name": "my-security-group",
"resource_type": "security_group"
}
],
"subnet": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/35984145-9c3a-4626-8ee7-52c7a8742752",
"id": "35984145-9c3a-4626-8ee7-52c7a8742752",
"name": "my-subnet",
"resource_type": "subnet"
},
"transit_encryption": "none",
"virtual_network_interface": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interfaces/388f01db-41bb-42aa-b5cd-34ba41288d47",
"id": "388f01db-41bb-42aa-b5cd-34ba41288d47",
"name": "my-virtual-network-interface",
"resource_type": "virtual_network_interface"
},
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/4c0bb0df-5ca2-43ca-a3de-a4f86010a906",
"id": "4c0bb0df-5ca2-43ca-a3de-a4f86010a906",
"name": "my-vpc",
"resource_type": "vpc"
}
}
],
"total_count": 1
}
API로 단일 마운트 대상 보기
GET /shares/{share_id}/mount_targets/{mount_target_id}
요청을 수행하여 파일 공유의 단일 마운트 대상에 대한 정보를 확인합니다. 이 호출에는 마운트 경로 정보가 포함되어 있습니다. 마운트 경로를 사용하여 파일 공유를 인스턴스에 연결하십시오.
다음 예제를 참조하십시오.
curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$mount_target_id?version=2023-07-18&generation=2"\
-H "Authorization: $iam_token"
성공적인 응답은 다음 예제와 유사합니다. 이 예에서 전송 중인 데이터 암호화 는 사용으로 설정되지 않습니다. transit_encryption
특성 값은 provider_managed
입니다.
{
"access_control_mode": "security_group",
"created_at": "2023-07-18T01:59:46.000Z",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares//199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets/d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
"id": "d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
"lifecycle_reasons": [],
"lifecycle_state": "stable",
"mount_path": "fsf-dal1099a-fz.adn.networklayer.com:/nxg_s_vol_xyz_2891fd0a_64ea_4deb_9ed5_1159e37cb5aa",
"name": "my-mount-target2",
"primary_ip": {
"address": "192.0.2.0",
"href": "https://us-south.iaas.cloud.ibm.com/subnets/c2338e66-dcb5-4e9b-b572-108d47ca479a/reserved_ips/b96d456e-88f7-42a7-b02d-450a6d758534",
"id": "b96d456e-88f7-42a7-b02d-450a6d758534",
"name": "my-reserved-ip",
"resource_type": "subnet_reserved_ip"
},
"resource_type": "share_mount_target",
"security_groups": [
{
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/security_groups/b79365be-f626-45d4-94ae-83f16fa4edd3",
"id": "b79365be-f626-45d4-94ae-83f16fa4edd3",
"name": "my-security-group",
"resource_type": "security_group"
}
],
"subnet": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/c2338e66-dcb5-4e9b-b572-108d47ca479a",
"id": "c2338e66-dcb5-4e9b-b572-108d47ca479a",
"name": "my-subnet",
"resource_type": "subnet"
},
"transit_encryption": "provider_managed",
"virtual_network_interface": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interfaces/4551a68d-b45d-4443-b6b3-aba7a4a18c98",
"id": "4551a68d-b45d-4443-b6b3-aba7a4a18c98",
"name": "my-virtual-network-interface",
"resource_type": "virtual_network_interface"
},
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/5821d0c4-a089-4957-b5fa-03b7ac636c15",
"id": "5821d0c4-a089-4957-b5fa-03b7ac636c15",
"name": "my-vpc",
"resource_type": "vpc"
}
}
API로 복제본 파일 공유에 대한 소스 파일 공유 보기
GET /shares/{replica_id}/source
요청을 수행하고 복제본 공유 ID를 지정하여 소스 파일 공유 세부 정보를 가져옵니다.
curl -X GET \
"$vpc_api_endpoint/v1/shares/$replica_id/source?version=2023-07-18&generation=2"\
-H "Authorization: $iam_token"\
성공적인 응답은 소스 파일 공유의 세부 정보를 제공합니다. 복제 역할은 source
(이)라는 점에 유의하십시오.
{
"access_control_mode": "security_group",
"created_at": "2023-07-18T22:58:49.000Z",
"crn": "crn:[...]",
"encryption": "provider_managed",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/207721a9-aff9-4b16-9823-fe68096aeac3",
"id": "207721a9-aff9-4b16-9823-fe68096aeac3",
"iops": 14400,
"lifecycle_state": "stable",
"mount_targets": [
{
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/207721a9-aff9-4b16-9823-fe68096aeac3/mount_targets/ce244454-0919-45e2-b14b-f4285afcd856",
"id": "ce244454-0919-45e2-b14b-f4285afcd856",
"name": "my-share-mount-target",
"resource_type": "share_mount_target",
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/c8b8fa2d-ccf7-4f42-9d38-df6d123c867d",
"id": "c8b8fa2d-ccf7-4f42-9d38-df6d123c867d",
"name": "my-vpc",
"resource_type": "vpc"
}
}
],
"name": "my-share-3",
"profile": {
"family": "defined-performance",
"href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
"name": "dp2",
"resource_type": "share_profile"
},
"replication_role": "source",
"replication_status": "active",
"replication_status_reasons": [],
"resource_group": {
"crn": "crn:[...]",
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada915d32640909956",
"id": "678523bcbe2b4eada915d32640909956",
"name": "Default"
},
"resource_type": "share",
"size": 4800,
"snapshot_count": 10,
"snapshot_size": 10,
"user_tags": [],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1",
"resource_type": "zone"
}
}
Terraform으로 파일 공유 및 마운트 대상 보기
Terraform을 사용하여 파일 공유 및 마운트 대상에 대한 정보를 볼 수 있습니다.
Terraform을 사용하려면 Terraform CLI를 다운로드하고 IBM Cloud 제공자 플러그인을 구성하십시오. 자세한 정보는 Terraform 시작하기 를 참조하십시오.
VPC 인프라 서비스는 기본적으로 us-south
를 대상으로 하는 특정 지역 엔드포인트를 사용합니다. VPC가 다른 지역에서 작성되는 경우 provider.tf
파일의 제공자 블록에서 적절한 지역을 대상으로 지정해야 합니다.
기본 us-south
이외의 지역을 대상으로 지정하는 다음 예제를 참조하십시오.
provider "ibm" {
region = "eu-de"
}
Terraform과의 모든 파일 공유 보기
계정에 속하는 파일 공유 목록을 읽기 전용 데이터 소스로 가져오십시오. 공유 이름 또는 자원 그룹 ID로 필터링할 수 있습니다.
data "ibm_is_shares" "example" {
}
내보낸 속성에는 총 공유 수 및 공유 목록이 포함됩니다. 중첩된 속성에는 공유 ID, 이름, 작성 날짜, 크기, IOPS, CRN, 액세스 태그, 암호화 유형 및 키, 라이프사이클 상태, 복제 역할 및 상태, 마운트 대상 및 기타 속성이 포함됩니다.
자세한 정보는 ibm_is_shares를 참조하십시오.
Terraform을 사용하여 파일 공유 정보 보기
파일 공유의 세부사항을 읽기 전용 데이터 소스로 가져오십시오. ID 또는 이름으로 공유를 식별해야 합니다.
data "ibm_is_share" "example" {
share = ibm_is_share.example.id
}
data "ibm_is_share" "example1" {
name = ibm_is_share.example.name
}
내보낸 속성에는 ID, 이름, 작성 날짜, 크기, IOPS, CRN, 액세스 태그, 암호화 유형, 암호화 키, 라이프사이클 상태, 복제 역할 및 상태, 마운트 대상 및 기타 속성이 포함됩니다.
자세한 정보는 ibm_is_share를 참조하십시오.
Terraform과 파일 공유와 연관된 마운트 대상 보기
파일 공유와 연관된 마운트 대상 목록을 읽기 전용 데이터 소스로 가져오십시오. 해당 ID로 파일 공유를 식별하십시오.
data "ibm_is_share_targets" "example" {
share = ibm_is_share.example.id
}
내보낸 속성에는 마운트 대상 및 해당 ID, 이름, 작성 날짜, 마운트 경로, 서브넷 정보 등의 목록이 포함됩니다.
자세한 정보는 ibm_is_share_targets를 참조하십시오.
Terraform을 사용하여 마운트 대상 정보 보기
마운트 대상의 세부사항을 읽기 전용 데이터 소스로 가져오십시오. 공유 ID및 마운트 대상 ID를 지정하여 마운트 대상을 식별하십시오. 두 인수 모두 필수입니다.
data "ibm_is_share_target" "example" {
share = ibm_is_share.example.id
share_target = ibm_is_share_target.example.share_target
}
내보낸 속성에는 ID, 이름, 작성 날짜, 마운트 경로, 서브넷 정보 및 기타 속성이 포함됩니다.
자세한 정보는 ibm_is_share_target을 참조하십시오.
다음 단계
파일 공유를 마운트하십시오. 마운트는 서버의 운영 체제가 사용자가 서버의 파일 시스템을 통해 액세스할 수 있도록 스토리지 디바이스의 파일 및 디렉토리를 작성하는 프로세스입니다. 자세한 정보는 다음 주제를 참조하십시오.
- IBM Cloud File Share Mount Helper 유틸리티
- Red Hat Linux에서 파일 공유 마운트.
- CentOS에서 파일 공유 마운트.
- Ubuntu에서 파일 공유 마운트.
- z/OS
파일 공유 및 데이터를 관리하십시오.
- 파일 공유 관리. 파일 공유의 이름을 바꿀 수 있습니다. 용량을 늘리고 IOPS를 수정할 수 있습니다. 파일 공유에 마운트 대상을 추가할 수 있습니다. 마운트 대상의 이름을 바꾸거나 삭제할 수 있습니다. 더 이상 필요하지 않은 파일 공유는 삭제할 수 있습니다.
- 복제를 사용하여 파일 공유를 작성하십시오. 복제 기능을 사용하여 다른 구역에서 파일 공유의 읽기 전용 사본을 유지할 수 있습니다. 복제본 공유는 사용자가 지정하는 스케줄에 따라 소스 공유에서 업데이트됩니다. 복제는 데이터에 액세스할 수 없게 되거나 애플리케이션이 실패할 때 기본 사이트의 인시던트에서 복구하는 방법을 제공합니다. 지리적 확장에도 복제를 사용할 수 있습니다.