Object Storage Service:DeleteMultipleObjects

注意事項

• DeleteMultipleObjects 操作の呼び出しでは、最大 1,000 個のオブジェクトを削除できます。

• バケットにデータレプリケーションルールが設定されており、オブジェクトの作成、変更、削除を含むすべてのデータ変更 (追加/削除/変更) を同期するように設定されている場合、DeleteMultipleObjects 操作を呼び出して格納されているオブジェクトを削除すると、レプリケーションポリシーに関連付けられたデスティネーションバケットからレプリケートされたオブジェクトが削除されます。 さらに、このバケットでバージョン管理も有効になっている場合、DeleteMultipleObjects 操作を呼び出すと、削除されたオブジェクトの削除マーカーがソースバケットに作成され、デスティネーションバケットにレプリケートされます。

• 削除されたオブジェクトは復元できません。 慎重に行ってください。 オブジェクトの削除方法の詳細については、「オブジェクトの削除」をご参照ください。

バージョン管理

DeleteMultipleObjects 操作を呼び出して、バージョン管理されたバケットから複数のオブジェクトを削除できます。 リクエストで削除するオブジェクトのバージョン ID を指定しない場合、オブジェクトに削除マーカーが追加されます。 リクエストで削除するオブジェクトのバージョン ID を指定した場合、指定されたオブジェクトバージョンは完全に削除されます。

リクエスト構文

POST /?delete HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length: ContentLength
Content-MD5: MD5Value
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<Delete>
  <Quiet>true</Quiet>
  <Object>
    <Key>key</Key>
  </Object>
...
</Delete>

リクエストヘッダー

Object Storage Service (OSS) は、以下のヘッダーに基づいて DeleteMultipleObjects リクエストの本文を検証し、検証が成功した場合にのみ指定されたオブジェクトを削除します。

リクエスト要素

レスポンス要素

例

• Quiet モードが無効になっているサンプルリクエスト

  POST /?delete HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Wed, 29 Feb 2012 12:26:16 GMT
  Content-Length:151
  Content-MD5: ohhnqLBJFiKkPSBO1eNaUA==
  Authorization: OSS qn6q**************:77Dv****************
  
  <?xml version="1.0" encoding="UTF-8"?>
  <Delete> 
    <Quiet>false</Quiet>  
    <Object> 
      <Key>multipart.data</Key> 
    </Object>  
    <Object> 
      <Key>test.jpg</Key> 
    </Object>  
    <Object> 
      <Key>demo.jpg</Key> 
    </Object> 
  </Delete>

  サンプルレスポンス

  HTTP/1.1 200 OK
  x-oss-request-id: 78320852-7eee-b697-75e1-b6db0f4849e7
  Date: Wed, 29 Feb 2012 12:26:16 GMT
  Content-Length: 244
  Content-Type: application/xml
  Connection: keep-alive
  Server: AliyunOSS
  
  <?xml version="1.0" encoding="UTF-8"?>
  <DeleteResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
      <Deleted>
         <Key>multipart.data</Key>
      </Deleted>
      <Deleted>
         <Key>test.jpg</Key>
      </Deleted>
      <Deleted>
         <Key>demo.jpg</Key>
      </Deleted>
  </DeleteResult>

• Quiet モードが有効になっているサンプルリクエスト

  POST /?delete HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Wed, 29 Feb 2012 12:33:45 GMT
  Content-Length:151
  Content-MD5: ohhnqLBJFiKkPSBO1eNaUA==
  Authorization: OSS qn6q**************:77Dv****************
  
  <?xml version="1.0" encoding="UTF-8"?>
  <Delete> 
    <Quiet>true</Quiet>  
    <Object> 
      <Key>multipart.data</Key> 
    </Object>  
    <Object> 
      <Key>test.jpg</Key> 
    </Object>  
    <Object> 
      <Key>demo.jpg</Key> 
    </Object> 
  </Delete>

  サンプルレスポンス

  HTTP/1.1 200 OK
  x-oss-request-id: 559CC9BDC755F95A64485981
  Date: Wed, 29 Feb 2012 12:33:45 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

• バージョン ID が指定されていないサンプルリクエスト

  POST /?delete HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 04:20:03 GMT
  Content-MD5: xSLOYWaPC86RPwWXNiFeXg==
  Authorization: OSS qn6q**************:77Dv****************
  
  <?xml version="1.0" encoding="UTF-8"?>
  <Delete> 
    <Quiet>false</Quiet>  
    <Object> 
      <Key>multipart.data</Key>
    </Object>  
    <Object> 
      <Key>test.jpg</Key> 
    </Object>
  </Delete>

  サンプルレスポンス

  次の例では、削除する 2 つのオブジェクト (multipart.dat と test.jpg) のバージョン ID が指定されていません。 そのため、OSS は 2 つのオブジェクトに削除マーカーを追加し、<DeleteMarker>true</DeleteMarker> と <DeleteMarkerVersionId>XXXXXX</DeleteMarkerVersionId> を返します。

  HTTP/1.1 200 OK
  x-oss-request-id: 5CAC1D73B7AEADE01700****
  Date: Tue, 09 Apr 2019 04:20:03 GMT
  Content-Type: application/xml
  Connection: keep-alive
  Server: AliyunOSS
  
  <?xml version="1.0" encoding="UTF-8"?>
  <DeleteResult>
      <Deleted>
         <Key>multipart.data</Key>
         <DeleteMarker>true</DeleteMarker>
         <DeleteMarkerVersionId>CAEQMhiBgIDXiaaB0BYiIGQzYmRkZGUxMTM1ZDRjOTZhNjk4YjRjMTAyZjhl****</DeleteMarkerVersionId>
      </Deleted>
      <Deleted>
         <Key>test.jpg</Key>
         <DeleteMarker>true</DeleteMarker>
         <DeleteMarkerVersionId>CAEQMhiBgIDB3aWB0BYiIGUzYTA3YzliMzVmNzRkZGM5NjllYTVlMjYyYWEy****</DeleteMarkerVersionId>
      </Deleted>
  </DeleteResult>

• バージョン ID が指定されているサンプルリクエスト

  説明

  Key 要素と VersionId 要素の両方を指定する必要があります。

  POST /?delete HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 06:09:34 GMT
  Content-Length:151
  Content-MD5: 2Tpk+dL/tGyuSA+YCEuSVg==
  Authorization: OSS qn6q**************:77Dv****************
  
  <?xml version="1.0" encoding="UTF-8"?>
  <Delete> 
    <Quiet>false</Quiet>  
    <Object> 
      <Key>multipart.data</Key>
      <VersionId>CAEQNRiBgIDyz.6C0BYiIGQ2NWEwNmVhNTA3ZTQ3MzM5ODliYjM1ZTdjYjA4****</VersionId>
    </Object>
  </Delete>

  サンプルレスポンス

  この例では、削除されたオブジェクトのキーとバージョン ID が返されます。

  HTTP/1.1 200 OK
  x-oss-request-id: 5CAC371EB7AEADE01700****
  Date: Tue, 09 Apr 2019 06:09:34 GMT
  Content-Length: 244
  Content-Type: application/xml
  Connection: keep-alive
  Server: AliyunOSS
  
  <?xml version="1.0" encoding="UTF-8"?>
  <DeleteResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
      <Deleted>
         <Key>multipart.data</Key>
         <VersionId>CAEQNRiBgIDyz.6C0BYiIGQ2NWEwNmVhNTA3ZTQ3MzM5ODliYjM1ZTdjYjA4****</VersionId>
      </Deleted>
  </DeleteResult>

• versionId 要素を指定して削除マーカーを削除するサンプルリクエスト

  POST /?delete HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 06:14:50 GMT
  Content-Length: 178
  Content-MD5: dX9IFePFgYhmINvAhG30Bg==
  Authorization: OSS qn6q**************:77Dv****************
  
  <?xml version="1.0" encoding="UTF-8"?>
  <Delete> 
    <Quiet>false</Quiet>  
    <Object> 
      <Key>multipart.data</Key>
      <VersionId>CAEQNRiBgICEoPiC0BYiIGMxZWJmYmMzYjE0OTQ0ZmZhYjgzNzkzYjc2NjZk****</VersionId>
    </Object>
  </Delete>

  サンプルレスポンス

  • Key 要素は削除されたオブジェクトの名前を示し、VersionId 要素はオブジェクトの削除されたバージョンを示します。

  • DeleteMarker は、削除マーカーが削除されたことを示します。 DeleteMarkerVersionId は、削除マーカーのバージョン ID を示します。 この場合、VersionId と DeleteMarkerVersionId の値は同じであり、DeleteMarker と DeleteMarkerVersionId は一緒に返されます。

  HTTP/1.1 200 OK
  x-oss-request-id: 5CAC385AB7AEADE01700****
  Date: Tue, 09 Apr 2019 06:14:50 GMT
  Content-Length: 364
  Content-Type: application/xml
  Connection: keep-alive
  Server: AliyunOSS
  
  <?xml version="1.0" encoding="UTF-8"?>
  <DeleteResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
      <Deleted>
         <Key>demo.jpg</Key>
         <VersionId>CAEQNRiBgICEoPiC0BYiIGMxZWJmYmMzYjE0OTQ0ZmZhYjgzNzkzYjc2NjZk****</VersionId>
         <DeleteMarker>true</DeleteMarker>
         <DeleteMarkerVersionId>THUQNRiBgICEoPiC0BYiIGMxZWJmYmMzYjE0OTQ0ZmZhYjgzNzkzYjc2NjZk****</DeleteMarkerVersionId>
      </Deleted>
  </DeleteResult>

OSS SDK

次のプログラミング言語の OSS SDK を使用して、DeleteMultipleObjects 操作を呼び出すことができます。

• Java

• Python

• PHP

• Go V2

• C

• .NET

• iOS

• Node.js

• Browser.js

• Ruby

ossutil

DeleteMultipleObjects 操作に対応する ossutil コマンドについては、「delete-multiple-objects」をご参照ください。

関連情報

• 単一のオブジェクトを削除するために呼び出すことができる API 操作の詳細については、「DeleteObject」をご参照ください。

• オブジェクトを自動的に削除する方法については、「ライフサイクル」をご参照ください。

エラーコード