All Products
Search

This Product

    Data Lake Formation:Location registration

    Document Center

    Data Lake Formation:Location registration

    Last Updated:Mar 26, 2026

    Location hosting lets you bring Object Storage Service (OSS) buckets under Data Lake Formation (DLF) management without moving your data. After registering an OSS path as a location, DLF provides:

    Important

    When you register a location, DLF users gain access to existing data at that OSS path. Review your current access patterns before registering to make sure existing data remains secure.

    Register a location

    Prerequisites

    Before you begin, ensure that you have:

    • An OSS bucket containing the data you want to manage

    • A RAM role with the required permissions (default: AliyunDLFWorkFlowDefaultRole)

    Steps

    1. Log on to the DLF console.

    2. In the left-side navigation pane, click Lake Management > Location Hosting.

    3. Click Register Location.

    4. On the Register Location page, configure the following parameters and click OK.

      Important

      Enabling bucket inventory incurs additional storage fees, as does enabling OSS logging

      Parameter Description
      Select OSS Path Select one or more OSS buckets to manage. Format: oss://<your_BucketName>OSS console. To find your bucket name, go to the OSS console.
      RAM Role Select the RAM role DLF uses to access your OSS data. Default: AliyunDLFWorkFlowDefaultRole.
      Enable OSS Bucket Inventory Enabled by default. Powers Storage overview and Lifecycle management. Data is automatically cleaned up every 7 days to reduce storage costs. If you have already enabled this feature in the OSS console, you cannot enable it again.
      Enable OSS Logging Enabled by default. Keeps data access frequency and other metrics up to date. Data is automatically cleaned up every 7 days.

    5. In the confirmation dialog, click OK.

    The registered location appears in the list.

    Edit a location

    1. In the left-side navigation pane, click Lake Management > Location Hosting.

    2. Find the location and click Edit in the Actions column.

    3. Enable or disable OSS bucket inventory and OSS logging as needed, then click OK.

    OSS bucket inventory and OSS logging that were not originally enabled by DLF cannot be disabled from the Update Location page.

    Delete a location

    1. In the left-side navigation pane, click Lake Management > Location Hosting.

    2. Find the location and click Delete in the Actions column.

    Important

    Deleting a location has the following effects:

    • OSS bucket inventory and logging that DLF enabled are automatically removed. Features you enabled manually in the OSS console are not affected.

    • DLF loses permission to manage the storage data at that path. All or part of Storage overview, Lifecycle management, and Data overview of data tables will no longer be available for that location.