SealAppendObject 操作を呼び出して、追加可能オブジェクトへのコンテンツの追加を停止します。この操作を呼び出すと、オブジェクトは追加不可になります。これにより、ライフサイクルルールを使用してオブジェクトのストレージクラスをコールドアーカイブまたはディープコールドアーカイブに変更し、ストレージコストを削減できます。追加可能オブジェクトをシールする前は、ストレージクラスを低頻度アクセス (IA) またはアーカイブストレージにのみ変更できます。
SealAppendObject 操作を呼び出すには、チケットを送信してアクセスをリクエストする必要があります。
権限
デフォルトでは、Alibaba Cloud アカウントはすべての権限を持ちます。Alibaba Cloud アカウント下の RAM ユーザーまたは RAM ロールは、デフォルトでは何の権限も持ちません。Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを通じて操作権限を付与する必要があります。
API | アクション | 説明 |
SealAppendObject |
| 追加可能オブジェクトへのコンテンツの追加を停止し、その状態を追加不可に変更します。 |
他の操作との関連
操作 | 説明 |
SealAppendObject 操作を使用してシールされたオブジェクトに対して、HeadObject は x-oss-sealed-time ヘッダーを返します。それ以外の場合、このヘッダーは返されません。 | |
SealAppendObject 操作を使用してシールされたオブジェクトに対して、GetObject は x-oss-sealed-time ヘッダーを返します。それ以外の場合、このヘッダーは返されません。 | |
デフォルトでは、ライフサイクルサービスは追加可能オブジェクトのストレージクラスをコールドアーカイブまたはディープコールドアーカイブに変更することをサポートしていません。ただし、シールされた追加可能オブジェクトの場合は、そのストレージクラスをコールドアーカイブまたはディープコールドアーカイブに変更できます。 |
リクエスト構文
POST /ObjectName?seal&position=Position HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Content-Length: 0
Date: GMT Date
Authorization: SignatureValueリクエストパラメーター
名前 | タイプ | 必須 | 説明 |
seal | string | はい | SealAppendObject 操作を開始するために使用されます。 |
position | string | はい | SealAppendObject 操作を呼び出す際のオブジェクトの期待される長さを指定します。OSS は、この長さがオブジェクトの実際の長さと一致するかどうかをチェックします。長さが一致しない場合、リクエストは失敗し、PositionNotEqualToLength エラーが返されます。 |
リクエストヘッダー
この操作は、共通リクエストヘッダーのみを使用します。詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンスヘッダー
レスポンスヘッダー | タイプ | 例 | 説明 |
x-oss-sealed-time | string | Wed, 07 May 2025 23:00:00 GMT | オブジェクトに対して SealAppendObject 操作が最初に実行された GMT 時間。このタイムスタンプは、操作が再度実行されても変更されません。 |
例
リクエスト例
POST /test.jpg?seal&position=344606 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 07 May 2025 23:00:00 GMT
Content-Length: 0
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250507/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3****レスポンス例
HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
x-oss-object-type: Appendable
x-oss-storage-class: Standard
x-oss-sealed-time: Wed, 07 May 2025 23:00:00 GMT
Date: Wed, 07 May 2025 23:00:00 GMT
Last-Modified: Mon, 07 Apr 2025 07:32:52 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSSエラーコード
エラーコード | HTTP ステータスコード | 説明 |
AppendSealedObjectNotAllowed | 409 | SealAppendObject 操作が追加不可オブジェクトに対して実行されました。 |
PositionNotEqualToLength | 409 | リクエスト内の position パラメーターの値が、ファイルの実際の長さと異なります。 |