콘솔에서 파일 공유 이름 바꾸기

1. 파일 공유 세부사항 페이지에서 파일 공유 이름 옆에 있는 편집 아이콘 을 클릭하십시오.

2. 파일 공유의 새 이름을 제공하십시오.

올바른 파일 공유 이름에는 최대 63자의 소문자 영숫자 문자(a-z, 0-9) 및 하이픈(-)이 포함될 수 있습니다. 파일 공유 이름은 소문자로 시작해야 합니다.

콘솔에서 파일 공유의 마운트 대상 이름 변경하기

1. 파일 공유 세부사항 페이지로 이동하십시오.
2. 조치 아이콘 을 클릭하십시오.
3. 이름 바꾸기를 선택하십시오.
4. 새 이름을 입력하고 이름 바꾸기를 클릭하십시오.

올바른 마운트 대상 이름에는 최대 63자의 소문자 영숫자 문자(a-z, 0-9) 및 하이픈(-)이 포함될 수 있습니다. 마운트 대상 이름은 소문자로 시작되어야 합니다.

콘솔에서 파일 공유 프로필 업데이트하기

이 지침은 영역 파일 공유 베타 릴리스에서 사용되었던 이전 세대의 파일 공유 프로필(범용, 5-iops, 10-iops 또는 사용자 지정)을 위한 것입니다. 2026년 5월 6일부로 이러한 공유 프로필은 [사용되지] 않습니다{: tag-deprecated}. 현재 기능에 액세스하려면 공유의 IOPS 프로필을 dp2 으로 변경해야 합니다. dp2 또는 rfs 프로필로 만든 파일 공유의 프로필은 변경할 수 없습니다.

파일 공유에 대한 프로파일을 현재 프로파일에서 다른 IOPS 티어 프로파일, 사용자 정의 프로파일 또는 고성능 dp2 프로파일로 변경할 수 있습니다. 청구는 선택한 프로필에 따라 조정됩니다.

1. 파일 공유 세부사항 페이지로 이동하십시오.
2. 현재 프로파일 옆에 있는 편집 아이콘 을 클릭하거나 조치 메뉴 를 사용하여 IOPS 프로파일 편집을 선택하십시오. 사이드 패널은 현재 프로파일, 파일 공유 크기 및 최대 IOPS를 표시합니다.
3. 새 프로파일의 경우 아래로 화살표를 클릭하십시오. 새 IOPS 티어, 사용자 정의 프로파일 또는 dp2를 선택할 수 있습니다. 사용자 정의 IOPS 또는 dp2 의 경우, 파일 공유 크기를 기반으로 새 최대 IOPS를 지정하십시오. 파일 공유 가격은 사용자의 선택에 따라 자동으로 계산됩니다.
4. ‘저장 후 계속’을 클릭하세요.

콘솔에서 허용된 전송 암호화 모드 업데이트하기

공유 소유자는 허용되는 전송 암호화 모드를 변경할 수 있습니다. 그러나 이 특성을 변경하기 전에 모든 바인딩을 삭제해야 합니다. 바인딩을 삭제하면 원본 파일 공유와 액세서 공유 사이의 네트워크 경로가 분리되고 액세서 공유에 첨부된 마운트 대상이 실패 상태가 됩니다. 자세한 정보는 다른 계정에서 파일 공유에 대한 액세스 제거 를 참조하십시오.

1. 파일 공유 목록에서 파일 공유를 선택하십시오.
2. 파일 공유 세부사항 페이지에서 허용되는 전송 암호화 모드를 찾으십시오.
3. 편집 아이콘 을 클릭하여 현재 값을 변경하십시오.

CLI를 통해 파일 공유 이름 변경하기

1. ibmcloud is shares 명령으로 리젼의 파일 공유를 나열하여 이름을 바꿀 파일 공유를 찾으십시오. 파일 공유의 이름과 ID를 메모해 두세요.

   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
   r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f   my-old-file-share       stable            us-south-1   tier-3iops 40         defaults         none               -                       -                -
   

2. ibmcloud is share-update 명령을 실행하고 --name 옵션을 사용하여 새 파일 공유 이름을 지정하십시오.

   ibmcloud is share-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 --name my-renamed-share
   

   Updating file share r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 under account Test Account as user test.user@ibm.com...
   ID                           r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
   Name                         my-renamed-share
   CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
   Lifecycle state              stable
   Access control mode          vpc
   Zone                         us-south-2
   Profile                      dp2
   Size(GB)                     100
   IOPS                         100
   Encryption                   ipsec
   Mount Targets                ID                          Name
                                No mounted targets found.
   Resource group               ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults
   Created                      2023-08-01T17:02:01+00:00
   Encryption key               crn:v1:bluemix:public:kms:eu-de:a/a1234567:key:f602ae93-b915-49bc-a0e1-af29c73e7788
   Latest job                   Job status   Job status reasons
                                -            -
   Replication cron spec        00 11 * * 0
   Replication role             replica
   Replication status           none
   Replication status reasons   Status code   Status message
                                -             -
   Snapshot count               0
   Snapshot size                0
   Source snapshot              -
   Allowed Access Protocols     nfs4
   Availability Mode            zonal
   Bandwidth(Mbps)              1
   Storage Generation           1
   

올바른 파일 공유 이름에는 최대 63자의 소문자 영숫자 문자(a-z, 0-9) 및 하이픈(-)이 포함될 수 있습니다. 파일 공유 이름은 소문자로 시작해야 합니다.

명령 옵션에 대한 자세한 정보는 ibmcloud is share-update 의 내용을 참조하십시오.

CLI를 통해 파일 공유의 마운트 대상 이름 변경하기

1. ibmcloud is shares 명령을 사용하여 리젼의 파일 공유를 나열하십시오. 이름을 바꿀 마운트 대상이 있는 파일 공유의 이름 및 ID를 기록해 두십시오.

2. 공유의 이름 또는 ID를 사용하여 ibmcloud is share-mount-targets 명령으로 마운트 대상을 찾으십시오.

   ibmcloud is share-mount-targets r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
   

   Listing share mount target of r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 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
   

3. 마운트 대상의 이름을 바꾸려면 파일 공유 이름 또는 ID및 마운트 대상 이름을 사용하여 share-mount-target-update 명령을 실행하십시오. --name 옵션을 사용하여 새 마운트 대상 이름을 지정하십시오.

   ibmcloud is share-mount-target-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 r006-fdbffc45-618c-49f1-bb08-ec530d7be378 --name my-renamed-mount-target
   

올바른 마운트 대상 이름에는 최대 63자의 소문자 영숫자 문자(a-z, 0-9) 및 하이픈(-)이 포함될 수 있습니다. 마운트 대상 이름은 소문자로 시작되어야 합니다.

명령 옵션에 대한 자세한 정보는 ibmcloud is share-mount-target-update 의 내용을 참조하십시오.

CLI에서 파일 공유 프로필 업데이트하기

이 지침은 영역 파일 공유 베타 릴리스에서 사용되었던 이전 세대의 파일 공유 프로필(범용, 5-iops, 10-iops 또는 사용자 지정)을 위한 것입니다. 2026년 5월 6일부로 이러한 공유 프로필은 [사용되지] 않습니다{: tag-deprecated}. 현재 기능에 액세스하려면 공유의 IOPS 프로필을 dp2 으로 변경해야 합니다. dp2 또는 rfs 프로필로 만든 파일 공유의 프로필은 변경할 수 없습니다.

1. 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
   r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f   my-old-file-share       stable            us-south-1   tier-3iops 40         defaults         none               -                       -                -
   

2. share-update 명령을 --profile 매개변수와 함께 사용하여 새 파일 공유 프로파일을 이름별로 표시하십시오.

   ibmcloud is share-update my-old-file-share --profile dp2 --size 1000 --iops 3000
   

   Updating file share my-file-share-8 under account Test Account as user test.user@ibm.com...
   ID                           r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f
   Name                         my-old-file-share
   CRN                          crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f
   Lifecycle state              updating
   Access control mode          vpc
   Zone                         us-south-1
   Profile                      dp2
   Size(GB)                     1000
   IOPS                         3000
   User Tags                    env:dev,env:prod
   Encryption                   provider_managed
   Mount Targets                ID                                          Name
                                r006-c9d82a15-7ead-4388-abc8-88e81c12ed28   my-target121
   Resource group               ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults
   Created                      2023-03-27T20:43:36+00:00
   Replication role             none
   Replication status           none
   Replication status reasons   Status code   Status message
                                -             -
   Snapshot count               0
   Snapshot size                0
   Source snapshot              -
   Allowed Access Protocols     nfs4
   Availability Mode            zonal
   Bandwidth(Mbps)              1
   Storage Generation           1
   

명령 옵션에 대한 자세한 정보는 ibmcloud is share-update 의 내용을 참조하십시오.

CLI에서 허용된 전송 암호화 모드 업데이트하기

공유 소유자는 허용된 전송 암호화 모드를 다음 값으로 업데이트할 수 있습니다.

• 영역 파일 공유의 경우 허용되는 값은 ipsec,none,ipsec 또는 none 입니다.
• 지역 파일 공유의 경우 허용되는 값은 stunnel,none, stunnel, 또는 none 입니다.

그러나 이 속성을 변경하려면 먼저 모든 바인딩과 마운트 대상을 삭제해야 합니다. 바인딩을 삭제하면 원본 파일 공유와 액세서 공유 사이의 네트워크 경로가 분리되고 액세서 공유에 첨부된 마운트 대상이 실패 상태가 됩니다. 자세한 내용은 다른 계정에서 파일 공유에 대한 액세스 권한 제거하기를 참조하세요.

ibmcloud is share-update my-origin-share --allowed-transit-encryption-modes ipsec

Updating file share my-file-share under account Test Account as user test.user@ibm.com...
ID                               r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Name                             my-origin-share
CRN                              crn:v1:bluemix:public:is:us-south-2:a/1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state                  stable
Access control mode              security_group
Accessor binding role            origin
Allowed transit encryption modes ipsec
Origin share CRN                                                                                             Name            Remote account  Remote region
                                 crn:v1:bluemix:public:is:us-south-2:a/7654321::share:r006-d73v40a6-e08f-4d07-99e1-d28cbf2188ed  my-origin-share a7654321        -
Zone                             us-south-2
Profile                          dp2
Size(GB)                         1000
IOPS                             1000
Encryption                       provider_managed
Mount Targets                    ID                          Name
                                 No mounted targets found.
Resource group                   ID                                 Name
                                 db8e8d865a83e0aae03f25a492c5b39e   Default
Created                          2024-06-25T22:15:15+00:00
Replication role                 none
Replication status               none
Replication status reasons       Status code   Status message
                                 -             -
 Allowed Access Protocols        nfs4
 Availability Mode               zonal
 Bandwidth(Mbps)                 1
 Storage Generation              1

API를 사용하여 파일 공유 이름 변경하기

특정 파일 공유의 이름을 바꾸려면 PATCH /shares/$share_id 호출을 수행하십시오. 다음 예를 참조하십시오.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"\
  -d '{"name": "share-renamed1"}'

성공적인 응답은 다음 예제와 유사합니다.

{
  "access_control_mode": "vpc",
  "created_at": "2023-07-17T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "id": "0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "share-renamed1",
  "profile": {
    "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/bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "id": "bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 100,
  "mount_targets": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

올바른 파일 공유 이름에는 최대 63자의 소문자 영숫자 문자(a-z, 0-9) 및 하이픈(-)이 포함될 수 있습니다. 파일 공유 이름은 소문자로 시작해야 합니다.

API를 사용하여 파일 공유의 마운트 대상 이름 변경하기

PATCH /shares/$share_id/mount_targets/$target_id 호출을 수행하여 파일 공유의 마운트 대상 이름을 변경합니다. 다음 예를 참조하십시오.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$target_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d '{"name": "target-renamed1"}

성공적인 응답은 다음 예제와 유사합니다.

{
  "access_control_mode": "vpc",
  "created_at": "2023-07-18T23:31:59Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "lifecycle_state": "stable",
  "mount_path": "domain.com:/vol_xyz_2891fd0a_64ea_4deb_9ed5_1159e37cb5aa",
  "name": "target-renamed1",
  "resource_type": "share_target",
  "transit_encryption": "none",
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs8c95b3c1-fe3c-45c-97a6-e43d14088287",
    "id": "82a7b841-9586-43b4-85dc-c0ab5e8b1c7a",
    "name": "vpc-name1",
    "resource_type": "vpc"
  }
}

올바른 마운트 대상 이름에는 최대 63자의 소문자 영숫자 문자(a-z, 0-9) 및 하이픈(-)이 포함될 수 있습니다. 마운트 대상 이름은 소문자로 시작되어야 합니다.

API를 사용하여 파일 공유 프로필 업데이트하기

이 지침은 영역 파일 공유 베타 릴리스에서 사용되었던 이전 세대의 파일 공유 프로필(범용, 5-iops, 10-iops 또는 사용자 지정)을 위한 것입니다. 2026년 5월 6일부로 이러한 공유 프로필은 [사용되지] 않습니다{: tag-deprecated}. 현재 기능에 액세스하려면 공유의 IOPS 프로필을 dp2 으로 변경해야 합니다. dp2 또는 rfs 프로필로 만든 파일 공유의 프로필은 변경할 수 없습니다.

PATCH /shares/{share_ID} 호출을 작성하고 profile 특성에 프로파일 이름을 지정하십시오. 다음 예제는 프로파일을 dp2 프로파일로 변경합니다.

curl -X PATCH "$vpc_api_endpoint/v1/shares/432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{"profile": {"name": "dp2"}}'

API를 사용하여 허용된 전송 암호화 모드 업데이트

공유 소유자는 허용된 전송 암호화 모드를 다음 값으로 업데이트할 수 있습니다.

• 영역 파일 공유의 경우 허용되는 값은 ipsec,none,ipsec 또는 none 입니다.
• 지역 파일 공유의 경우 허용되는 값은 stunnel,none, stunnel, 또는 none 입니다.

그러나 이 속성을 변경하려면 먼저 모든 바인딩과 마운트 대상을 삭제해야 합니다. 바인딩을 삭제하면 원본 파일 공유와 액세서 공유 사이의 네트워크 경로가 분리되고 액세서 공유에 첨부된 마운트 대상이 실패 상태가 됩니다. 자세한 정보는 다른 계정에서 파일 공유에 대한 액세스 제거 를 참조하십시오.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"
  -d '{"allowed_transit_encryption_modes": "ipsec"}'

Terraform을 사용하여 파일 공유의 속성 업데이트

ibm_is_share 자원을 업데이트하여 파일 공유의 속성 (예: 이름, 크기, 프로파일, 태그) 을 변경하십시오. 적용되면 다음 예제는 공유 이름을 new_name 으로 업데이트합니다.

resource "ibm_is_share" "example" {
  name    = "new_name"
  size    = 300
  iops    = 5000
  profile = "dp2"
  zone    = "us-south-2"
}

파일 공유 및 마운트 대상에 사용할 수 있는 유효한 이름은 소문자 영숫자(a-z, 0-9)와 하이픈(-)을 조합하여 최대 63자까지 구성할 수 있습니다. 파일 공유 이름은 소문자로 시작해야 합니다.

프로필, 허용된 전송 암호화 모드 및 미사용 암호화와 같은 일부 속성은 액세스 권한자 공유에 대해 편집할 수 없습니다.

공유 소유자는 허용된 전송 암호화 모드를 다음 값으로 업데이트할 수 있습니다.

• 영역 파일 공유의 경우 허용되는 값은 ipsec,none,ipsec 또는 none 입니다.
• 지역 파일 공유의 경우 허용되는 값은 stunnel,none, stunnel, 또는 none 입니다.

그러나 이 속성을 변경하려면 먼저 모든 바인딩과 마운트 대상을 삭제해야 합니다. 바인딩을 삭제하면 원본 파일 공유와 액세서 공유 사이의 네트워크 경로가 분리되고 액세서 공유에 첨부된 마운트 대상이 실패 상태가 됩니다. 자세한 내용은 다른 계정에서 파일 공유에 대한 액세스 권한 제거하기를 참조하세요.

인수 및 속성에 대한 자세한 정보는 ibm_is_share를 참조하십시오.

Terraform을 사용하여 마운트 대상의 속성 업데이트

ibm_is_share_mount_target 자원을 업데이트하여 마운트 대상의 이름을 변경하십시오. 적용되면 다음 자원이 마운트 대상의 이름을 my-new-share-target 로 변경합니다.

resource "ibm_is_share_mount_target" "is_share_target" {
  access_protocol    = "nfs4"
  name               = "my-new-share-target"
  share              = is_share.is_share.id
  subnet             = ibm_is_subnet.example.id
}`

인수 및 속성에 대한 자세한 정보는 ibm_is_share_target을 참조하십시오.