addServerImageSharingPermission

Available in VPC

Add sharing permissions to a server image.

Syntax

The addServerImageSharingPermission syntax is as follows:

./ncloud vserver addServerImageSharingPermission \
    --serverImageNo <server-image-no> \
    --targetLoginIdList <target-login-id-list> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running addServerImageSharingPermission.

Required options

The following options are required for addServerImageSharingPermission.

Options	Type	Required	Description
`--serverImageNo`	String	Required	Server image number See getServerImageList.
`--targetLoginIdList`	List	Required	NAVER Cloud Platform account login ID list You can enter multiple items separated by spaces. (e.g., `--targetLoginIdList id1@example.com id2@example.com`)

Common options

For information about the options common to all vserver subcommands, see Server (VPC) options.

Examples

If the request to add sharing permissions to a server image is successful, the server image's identification information and the list of sharing recipients are returned.

Command

The command example is as follows:

./ncloud vserver addServerImageSharingPermission \
    --serverImageNo 45678901 \
    --targetLoginIdList recipient@example.com \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "addServerImageSharingPermissionResponse": {
    "totalRows": 1,
    "serverImageList": [
      {
        "serverImageNo": "45678901",
        "serverImageName": "test-server-image-01",
        "serverImageDescription": "Test server image",
        "serverImageType": {
          "code": "SELF",
          "codeName": "SELF server image"
        },
        "serverImageLifeCyclePhase": {
          "code": "IN_SERVICE",
          "codeName": "In Service"
        },
        "hypervisorType": {
          "code": "KVM",
          "codeName": "KVM"
        },
        "cpuArchitectureType": {
          "code": "X86_64",
          "codeName": "x86 64bit"
        },
        "osCategoryType": {
          "code": "LINUX",
          "codeName": "LINUX"
        },
        "osType": {
          "code": "NAVIX",
          "codeName": "NAVIX"
        },
        "serverImageStatus": {
          "code": "CREAT",
          "codeName": "NSI CREATED state"
        },
        "serverImageOperation": {
          "code": "NULL",
          "codeName": "NSI NULL OP"
        },
        "serverImageStatusName": "created",
        "shareStatus": {
          "code": "SHARE",
          "codeName": "NSI Share SHARE State"
        },
        "blockStorageMappingList": [
          {
            "order": 0,
            "blockStorageSnapshotInstanceNo": 90123456,
            "blockStorageSnapshotName": "n01234567890abcd",
            "blockStorageSize": 10737418240,
            "blockStorageVolumeType": {
              "code": "CB1",
              "codeName": "Common BlockStorage 1"
            },
            "iops": 100,
            "throughput": 104857600,
            "isEncryptedVolume": false
          }
        ],
        "sharedLoginIdList": [
          "<login-id-redacted>"
        ],
        "serverImageProductCode": "SW.VSVR.OS.LNX64.NAVIX.09.G003",
        "createDate": "2026-05-14T16:25:00+0900",
        "platformCategoryCode": "OS"
      }
    ],
    "requestId": "18901234-5678-9012-1234-890123456789",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

Documentation Index