Elastic Compute Service:Share a snapshot

Console

1. Open the ECS console - Snapshots page.

2. In the top navigation bar, select the region and resource group.

3. On the Disk Snapshots tab, find the snapshot and choose > Share Snapshot in the Actions column.

4. In the Add to Resource Share dialog box, set Method to Existing Resource Share or New Resource Share:

   Note

   Snapshot sharing uses Resource Sharing from Resource Management. A resource share groups resources and principals together.

   

5. (For New Resource Share only) Set the Principal Scope:

   • All Accounts: Share with any Alibaba Cloud account.

   • Objects Within Resource Directory: Share only within your resource directory. The management account or members can share with the directory, its folders, and its members.

6. Click Add Principals and configure the recipients. Share with a specific Alibaba Cloud account: Set Principal Type to Alibaba Cloud Account and enter the recipient's Alibaba Cloud account ID in Principal ID. Share within a resource directory:

   • If the sharer has not enabled the resource directory feature but belongs to one: Set Principal Type to Resource Directory or Folder (Organizational Unit). For folders, enter the folder ID.

     After you select Resource Directory, the Resource Directory ID automatically shows the current directory ID. Note: The resource is shared with the entire organization, including all folders and member accounts. Click OK to complete.

   • If the sharer has enabled the resource directory feature: Select the target directory or folder from the list, or add them manually.

   Note

   - If Principal Scope is Objects Within Resource Directory, only accounts within the directory are available. - To share with multiple accounts, add each one separately.

   Note

   - You can also share snapshots from the Resource Management console. See Manage shared resources as a resource owner. - When you share with an entire resource directory or folder, all accounts in it can access the snapshot. New accounts automatically receive access. Removed accounts automatically lose access.

7. Click OK.

API

A Java SDK sample project demonstrates cross-account snapshot sharing and disk creation from a shared snapshot.

1. Download the snapshot sharing sample project. It includes three code samples:

   Sample	Description
   CreateResourceShare	The sharer creates a resource share and initiates snapshot sharing
   ReceiveResourceShare	The recipient accepts the sharing invitation
   UseResourceShare	The recipient creates a cloud disk from the shared snapshot

2. Configure SDK dependencies in pom.xml. See Java SDK call examples.

   Note

   SDK packages are updated frequently. Get the latest version from the GitHub links in SDK overview.

      <!--Resource Sharing SDK-->
      <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>resourcesharing20200110</artifactId>
        <version>${lastVersion}</version>
      </dependency>
      <!--ECS SDK-->
      <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>alibabacloud-ecs20140526</artifactId>
        <version>${lastVersion}</version>
      </dependency>

3. Set the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables to your AccessKey ID and AccessKey secret.

4. Replace placeholder variables with your actual values, such as the snapshot ID, recipient's account UID, and disk type.

5. Compile and run each sample as needed.

6. Verify the results. The sharer can check the Resource Management console for the new resource share, and the recipient can check the ECS console for the shared snapshot and created disk.