すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:命名規則に準拠するためのオブジェクトの名前変更

最終更新日:Nov 09, 2025

Object Storage Service (OSS) でデータを移行または再編成する場合、オブジェクトの名前を変更して、命名の一貫性と構造の正確性を確保できます。バケットで階層型名前空間機能が有効になっている場合、バケット内のオブジェクトを直接名前変更できます。

シナリオ

  • 命名規則の適用: 新しいオブジェクトの命名規則を実装する際、既存のオブジェクトの名前を変更して、データ管理の効率と一貫性を向上させることができます。

  • データの移行と再編成: 組織図の調整、システムの移行、またはアプリケーションのアップグレードを行う際、OSS 内のデータの名前変更と再編成が必要になる場合があります。

  • ストレージレイアウトの最適化: データ取得のパフォーマンスと組織構造を改善するために、ストレージレイアウトと仮想ディレクトリ構造を最適化するためにオブジェクトの名前を変更する必要がある場合があります。

使用上の注意

  • バケットで階層型名前空間機能が有効になっている場合、RenameObject 操作を呼び出してオブジェクトを直接名前変更できます。

    階層型名前空間の詳細については、「階層型名前空間の使用」をご参照ください。

  • バケットで階層型名前空間機能が有効になっていない場合、オブジェクトを直接名前変更することはできません。バケット内のオブジェクトの名前を変更するには、CopyObject 操作を呼び出してソースオブジェクトを宛先オブジェクトにコピーし、次に DeleteObject 操作を呼び出してソースオブジェクトを削除する必要があります。

手順

OSS コンソールの使用

重要

OSS コンソールでは、任意のサイズのオブジェクトの名前を変更できますが、移動できるのは 1 GB 以下のオブジェクトのみです。

  1. OSS コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、バケット をクリックします。[バケット] ページで、目的のバケットを見つけてクリックします。

  3. オブジェクトの名前を変更します。

    • バケットで階層型名前空間機能が有効になっていない場合

      左側のナビゲーションウィンドウで、オブジェクト管理 > オブジェクト を選択します。ターゲットオブジェクトにマウスポインターを合わせ、edit アイコンをクリックしてオブジェクトの名前を変更します。オブジェクトの名前を変更するときは、オブジェクト名にファイル拡張子が含まれていることを確認してください。

    • バケットで階層型名前空間機能が有効になっている場合

      左側のナビゲーションウィンドウで、オブジェクト管理 > オブジェクト を選択します。次に、オブジェクトの名前を変更するか、移動します。

      シナリオ

      操作

      オブジェクトの名前を変更する

      ターゲットオブジェクトにマウスポインターを合わせ、edit アイコンをクリックしてオブジェクトの名前を変更します。オブジェクトの名前を変更するときは、オブジェクト名にファイル拡張子が含まれていることを確認してください。

      オブジェクトを移動する

      オブジェクトリストでターゲットオブジェクトを見つけ、操作 列で 詳細 > ファイルの移動 を選択します。ファイルの移動 パネルで、次のシナリオに基づいて宛先ディレクトリを指定します。

      • オブジェクトを現在のバケットのルートディレクトリに移動するには、宛先ディレクトリを空のままにします。

      • オブジェクトを現在のバケットの特定のディレクトリに移動するには、宛先ディレクトリを入力します。たとえば、オブジェクトを destdir 親ディレクトリの subdir サブディレクトリに移動するには、宛先ディレクトリとして destdir/subdir と入力します。

Alibaba Cloud SDK の使用

次のサンプルコードは、examplebucket バケット内の srcobject.txt の名前を destobject.txt に変更する方法を示しています。

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.RenameObjectRequest;

public class Demo {

    public static void main(String[] args) throws Exception {
        // この例では、中国 (杭州) リージョンのエンドポイントを使用します。実際のエンドポイントを指定してください。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // プロジェクトコードにアクセス資格情報を保存しないことを強くお勧めします。そうしないと、アクセス資格情報が漏洩し、すべてのリソースにセキュリティリスクが生じる可能性があります。この例では、環境変数からアクセス資格情報を取得する方法を示します。この例を実行する前に、環境変数を設定してください。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // バケット名を指定します。
        String bucketName = "examplebucket";
        // ソースオブジェクトの完全なパスを指定します。完全なパスにバケット名を含めることはできません。
        String sourceObject = "srcobject.txt";
        // 宛先オブジェクトの完全なパスを指定します。完全なパスにバケット名を含めることはできません。
        String destinationObject = "destobject.txt";

        // OSSClient インスタンスを作成します。
        OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);

        try {
            // バケットで階層型名前空間機能が有効になっている場合は、次のコードを使用してオブジェクトの名前を変更します。
            // バケット内のソースオブジェクトの絶対パスを宛先オブジェクトの絶対パスに変更します。
            RenameObjectRequest renameObjectRequest = new RenameObjectRequest(bucketName, sourceObject, destinationObject);
            ossClient.renameObject(renameObjectRequest);

            // バケットで階層型名前空間機能が有効になっていない場合は、次のコードを使用してオブジェクトの名前を変更します。
            // examplebucket バケット内の srcobject.txt オブジェクトを同じバケット内の destobject.txt オブジェクトにコピーします。
            // ossClient.copyObject(bucketName, sourceObject, bucketName, destinationObject);

            // srcobject.txt オブジェクトを削除します。
            // ossClient.deleteObject(bucketName, sourceObject);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}
const OSS = require('ali-oss');
const client = new OSS({
  // バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを oss-cn-hangzhou に設定します。 
  region: 'oss-cn-hangzhou',
  // 環境変数からアクセス資格情報を取得します。サンプルコードを実行する前に、環境変数 OSS_ACCESS_KEY_ID と OSS_ACCESS_KEY_SECRET を設定していることを確認してください。 
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // バケットの名前を指定します。 
  bucket: 'examplebucket',
})

async function renameObject() {
  try {
    // srcobject.txt オブジェクトを同じバケット内の destobject.txt オブジェクトにコピーします。 
    const r = await client.copy('destobject.txt', 'srcobject.txt');
    console.log ('Copied', r);
    // srcobject.txt オブジェクトを削除します。 
    const deleteResult = await client.delete('srcobject.txt');
    console.log(deleteResult);
  } catch (e) {
    console.log(e);
  }
}

renameObject();
// バケットの名前を指定します。 
String bucketName = "examplebucket";
// ソースオブジェクトの完全なパスを指定します。完全なパスにバケット名を含めないでください。例: srcobject.txt。 
String sourceObjectKey = "srcobject.txt";
// 宛先オブジェクトの完全なパスを指定します。完全なパスにバケット名を含めないでください。例: destobject.txt。 
String objectKey = "destobject.txt";
try {
    CopyObjectRequest copyObjectRequest = new CopyObjectRequest(bucketName, sourceObjectKey, bucketName, objectKey);
    oss.copyObject(copyObjectRequest);
    // srcobject.txt オブジェクトを削除します。 
    DeleteObjectRequest deleteObjectRequest = new DeleteObjectRequest(bucketName, sourceObjectKey);
    oss.deleteObject(deleteObjectRequest);
} catch (ClientException e) {
    // ネットワークエラーなどのクライアント側の例外を処理します。 
    e.printStackTrace();
} catch (ServiceException e) {
    // サーバー側の例外を処理します。 
    Log.e("RequestId", e.getRequestId());
    Log.e("ErrorCode", e.getErrorCode());
    Log.e("HostId", e.getHostId());
    Log.e("RawMessage", e.getRawMessage());
}
// バケットの名前を指定します。 
NSString *bucketName = @"examplebucket";
// ソースオブジェクトの完全なパスを指定します。完全なパスにバケット名を含めないでください。例: srcobject.txt。 
NSString *sourceObjectKey = @"sourceObjectKey";
// 宛先オブジェクトの完全なパスを指定します。完全なパスにバケット名を含めないでください。例: destobject.txt。 
NSString *objectKey = @"destobject.txt";
[[[OSSTask taskWithResult:nil] continueWithBlock:^id _Nullable(OSSTask * _Nonnull task) {
    // srcobject.txt オブジェクトを同じバケット内の destobject.txt オブジェクトにコピーします。 
    OSSCopyObjectRequest *copyRequest = [OSSCopyObjectRequest new];
    copyRequest.bucketName = bucketName;
    copyRequest.sourceBucketName = bucketName;
    copyRequest.sourceObjectKey = sourceObjectKey;
    copyRequest.objectKey = objectKey;
    OSSTask *copyTask = [client copyObject:copyRequest];
    [copyTask waitUntilFinished];
    if (copyTask.error) {
        return copyTask;
    }
    // srcobject.txt オブジェクトを削除します。 
    OSSDeleteObjectRequest *deleteObject = [OSSDeleteObjectRequest new];
    deleteObject.bucketName = bucketName;
    deleteObject.objectKey = sourceObjectKey;
    OSSTask *deleteTask = [client deleteObject:deleteObject];
    [deleteTask waitUntilFinished];
    if (deleteTask.error) {
        return deleteTask;
    }
    return nil;
}] continueWithBlock:^id _Nullable(OSSTask * _Nonnull task) {
    if (task.error) {
        NSLog(@"rename fail! error: %@", task.error);
    } else {
        NSLog(@"rename success!");
    }
    return nil;
}];
import argparse
import alibabacloud_oss_v2 as oss

# コマンドライン引数パーサーを作成します。
parser = argparse.ArgumentParser(description="copy object sample")

# バケットが配置されているリージョンを指定する --region コマンドライン引数を追加します。これは必須パラメーターです。
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
# 宛先バケットの名前を指定する --bucket コマンドライン引数を追加します。これは必須パラメーターです。
parser.add_argument('--bucket', help='The name of the destination bucket.', required=True)
# 他のサービスが OSS にアクセスするために使用できるエンドポイントを指定する --endpoint コマンドライン引数を追加します。これはオプションのパラメーターです。
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
# 宛先オブジェクトの名前を指定する --key コマンドライン引数を追加します。これは必須パラメーターです。
parser.add_argument('--key', help='The name of the destination object.', required=True)
# ソースオブジェクトの名前を指定する --source_key コマンドライン引数を追加します。これは必須パラメーターです。
parser.add_argument('--source_key', help='The name of the source object.', required=True)
# ソースバケットの名前を指定する --source_bucket コマンドライン引数を追加します。これは必須パラメーターです。
parser.add_argument('--source_bucket', help='The name of the source bucket.', required=True)

def main():
    # コマンドライン引数を解析します。
    args = parser.parse_args()

    # ID 検証のために環境変数から資格情報を読み込みます。
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # SDK のデフォルト設定を読み込み、資格情報プロバイダーを設定します。
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # 設定でリージョンを設定します。
    cfg.region = args.region

    # エンドポイントが指定されている場合は、設定でエンドポイントを設定します。
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # 指定された設定で OSS クライアントを作成します。
    client = oss.Client(cfg)

    # オブジェクトをコピーするリクエストを送信します。
    result = client.copy_object(oss.CopyObjectRequest(
        bucket=args.bucket,  # 宛先バケットの名前を指定します。
        key=args.key,  # 宛先オブジェクトのキーを指定します。
        source_key=args.source_key,  # ソースオブジェクトのキーを指定します。
        source_bucket=args.source_bucket,  # ソースバケットの名前を指定します。
    ))
    
    # 元のオブジェクトを削除します。
    client.delete_object(oss.DeleteObjectRequest(
        bucket=args.source_bucket,
        key=args.source_key
    ))

    # コピー操作の結果を出力します。
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' version id: {result.version_id},'
          f' hash crc64: {result.hash_crc64},'
          f' source version id: {result.source_version_id},'
          f' server side encryption: {result.server_side_encryption},'
          f' server side data encryption: {result.server_side_data_encryption},'
          f' last modified: {result.last_modified},'
          f' etag: {result.etag},'
    )

# スクリプトが直接実行されたときに main 関数を呼び出します。
if __name__ == "__main__":
    main()  # スクリプトのエントリポイント。ファイルが直接実行されると main 関数が呼び出されます。
<?php

// 依存ライブラリが正しく読み込まれるように、オートローダーファイルをインポートします。
require_once __DIR__ . '/../vendor/autoload.php';

use AlibabaCloud\Oss\V2 as Oss;

// コマンドライン引数の説明を定義します。
$optsdesc = [
    "region" => ['help' => 'The region in which the bucket is located.', 'required' => True], // バケットが配置されているリージョン。(必須)
    "endpoint" => ['help' => 'The domain names that other services can use to access OSS.', 'required' => False], // エンドポイント。(オプション)
    "bucket" => ['help' => 'The name of the bucket', 'required' => True], // 宛先バケットの名前。(必須)
    "key" => ['help' => 'The name of the object', 'required' => True], // 宛先オブジェクトの名前。(必須)
    "src-bucket" => ['help' => 'The name of the source bucket', 'required' => False], // ソースバケットの名前。(オプション)
    "src-key" => ['help' => 'The name of the source object', 'required' => True], // ソースオブジェクトの名前。(必須)
];

// 引数の説明を getopt で必要なロングオプション形式に変換します。
// 各引数の後のコロン (:) は、引数が値を必要とすることを示します。
$longopts = \array_map(function ($key) {
    return "$key:";
}, array_keys($optsdesc));

// コマンドライン引数を解析します。
$options = getopt("", $longopts);

// 必須の引数が指定されていることを確認します。
foreach ($optsdesc as $key => $value) {
    if ($value['required'] === True && empty($options[$key])) {
        $help = $value['help']; // 引数のヘルプ情報を取得します。
        echo "Error: the following arguments are required: --$key, $help" . PHP_EOL;
        exit(1); // 必須の引数が欠落している場合は、プログラムを終了します。
    }
}

// 解析された引数から値を抽出します。
$region = $options["region"]; // バケットが配置されているリージョン。
$bucket = $options["bucket"]; // 宛先バケットの名前。
$key = $options["key"];       // 宛先オブジェクトの名前。
$srcKey = $options["src-key"]; // ソースオブジェクトの名前。

// 環境変数から資格情報を読み込みます。
// EnvironmentVariableCredentialsProvider を使用して、環境変数からアクセスキー ID とアクセスキーシークレットを読み取ります。
$credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider();

// SDK のデフォルト設定を使用します。
$cfg = Oss\Config::loadDefault();
$cfg->setCredentialsProvider($credentialsProvider); // 資格情報プロバイダーを設定します。
$cfg->setRegion($region); // バケットが配置されているリージョンを設定します。
if (isset($options["endpoint"])) {
    $cfg->setEndpoint($options["endpoint"]); // エンドポイントが指定されている場合は、エンドポイントを設定します。
}

// OSS クライアントインスタンスを作成します。
$client = new Oss\Client($cfg);

// オブジェクトをコピーするための CopyObjectRequest オブジェクトを作成します。
$request = new Oss\Models\CopyObjectRequest(
            bucket: $bucket,
            key: $key,
            sourceKey: $srcKey,
            sourceBucket: $bucket);

if (!empty($options["src-bucket"])) {
    $request->sourceBucket = $options["src-bucket"]; // ソースバケット名が指定されている場合は、sourceBucket を設定します。
}
$request->sourceKey = $srcKey; // ソースオブジェクト名を設定します。

// オブジェクトのコピー操作を実行します。
$result = $client->copyObject($request);

// コピー結果を出力します。
printf(
    'status code:' . $result->statusCode . PHP_EOL . // HTTP ステータスコード。たとえば、200 は成功を示します。
    'request id:' . $result->requestId . PHP_EOL     // リクエスト ID。デバッグやリクエストの追跡に使用されます。
);

他の SDK を使用してオブジェクトの名前を変更する方法のサンプルコードについては、「SDK の概要」をご参照ください。

ossbrowser の使用

ossbrowser は、OSS コンソールでサポートされているものと同様のバケットレベルの操作をサポートしています。ossbrowser UI の指示に従ってオブジェクトの名前を変更します。ossbrowser の使用方法の詳細については、「一般的な操作」をご参照ください。

ossutil の使用

たとえば、examplebucket1 バケット内の examplefile.txt の名前を example.txt に変更するには、次のコマンドを実行します。

ossutil cp oss://examplebucket1/examplefile.txt oss://examplebucket1/example.txt 
ossutil rm oss://examplebucket1/examplefile.txt

ossutil を使用してオブジェクトの名前を変更する方法の詳細については、「cp (ファイルのコピー)」および「rm (オブジェクトまたはパーツの削除)」をご参照ください。

REST API の使用

プログラムに高度にカスタマイズされた要件がある場合は、REST API リクエストを送信できます。REST API リクエストを送信する場合は、署名を計算するためのコードを手動で記述する必要があります。詳細については、「RenameObject」をご参照ください。

リファレンス