Help Center/ ModelArts/ Model Development/ Using a Notebook Instance for AI Development Through JupyterLab/ Uploading Files to JupyterLab/ Uploading OBS Files to JupyterLab
Updated on 2026-08-27 GMT+08:00
View PDF
Share

Uploading OBS Files to JupyterLab

In JupyterLab, you can upload files from OBS to a notebook instance. Ensure that the file is not larger than 50 GB. Otherwise, the upload will fail.

  1. Use JupyterLab to open a running notebook instance.
  2. Click in the navigation bar on the top of the JupyterLab window. In the displayed window, click on the left to go to the OBS file upload page.
    Figure 1 OBS file upload

  3. Set an OBS file path in either of the following ways:
    • Method 1: Enter a valid OBS file path in the text box and click Upload.
      Figure 2 Entering a valid OBS file path

    Enter an OBS file path instead of a folder path. Otherwise, the upload fails.

  • Method 2: Click Browse, select an OBS bucket or parallel file system path as required, and click OK.
  • Upload: Start uploading the file.
    Figure 3 Uploading an OBS File

Error Handling

There are three typical scenarios in which uploading a file failed.

  • Exception 1: Failed to upload the file (Not Found)

    Possible causes:

    • The OBS path is set to a folder instead of a file path.
    • The file in OBS is encrypted. In this case, go to the OBS console and ensure that the file is encrypted.

    • The OBS bucket and notebook instance are not in the same region. Ensure that the OBS bucket to be read is in the same region as the notebook instance. You cannot access an OBS bucket in another region. For details, see How Do I Check Whether ModelArts and an OBS Bucket Are in the Same Region?
    • The account does not have the permission to access the OBS bucket. In this case, ensure that the notebook account has the permission to read data in the OBS bucket. For details, see Check Whether You Have Permission to Access the OBS Bucket.
    • The OBS file has been deleted. In this case, make sure that the OBS file to be uploaded is available.

  • Exception 2: Failed to upload the file (the file name contains special characters)

    Possible causes:

    The file name contains special characters such as <>'";\`=#$%^&.

  • Exception 3: Failed to upload the file (the file is too large)

    Possible causes:

    The uploaded file exceeded 50 GB.

Parent Topic: Uploading Files to JupyterLab