Elastic Compute Service:Share a snapshot

Console

1. Go to ECS console - Snapshots.

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

3. On the Disk Snapshots tab, find the target snapshot, then 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 shared resources and principals together.

   

5. (Required only for New Resource Share) 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 itself, 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 is a member of one: Set Principal Type to Resource Directory or Folder (Organizational Unit). For folders, enter the folder ID.

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

   Note

   - If Principal Scope is set to 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. For details, see Manage shared resources as a resource owner. - When sharing with an entire resource directory or folder, all accounts within it can access the snapshot. New accounts that join automatically receive access. Removed accounts automatically lose access.

7. Click OK.

API

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

1. Download the snapshot sharing sample project. The project 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. For details, see Java SDK call examples.

   Note

   SDK packages are updated frequently. Get the latest dependency 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. Add the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables and set them to your AccessKey ID and AccessKey secret.

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

5. Compile and run each code sample as needed.

6. Verify the results in the console. For example, 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.