Carga un objeto en un bucket.
Notas de uso
El objeto a cargar no puede superar los 5 GB.
De forma predeterminada, si ya existe un objeto con el mismo nombre y usted cuenta con los permisos de acceso, el nuevo objeto lo sobrescribirá.
Permisos
De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos completos. Los usuarios de RAM o los roles de RAM bajo una cuenta de Alibaba Cloud no tienen ningún permiso predeterminado. La cuenta de Alibaba Cloud o el administrador de la cuenta deben otorgar los permisos de operación mediante RAM policies o Bucket Policy.
|
API |
Action |
Descripción |
|
PutObject |
|
Carga un objeto. |
|
|
Obligatorio si especifica etiquetas de objeto mediante el encabezado |
|
|
|
Obligatorio si el encabezado |
|
|
|
Sintaxis del comando
ossutil api put-object --bucket value --key value [flags]|
Parámetro |
Tipo |
Descripción |
|
--body |
string |
El cuerpo de la solicitud. |
|
--bucket |
string |
El nombre del bucket. |
|
--cache-control |
string |
El comportamiento de caché del objeto. |
|
--content-disposition |
string |
El nombre de archivo de descarga del objeto. |
|
--content-encoding |
string |
El formato de codificación del contenido del objeto. |
|
--expires |
string |
La fecha de caducidad. |
|
--forbid-overwrite |
boolean |
Indica si se prohíbe sobrescribir un objeto con el mismo nombre. |
|
--key |
string |
La ruta completa del objeto. |
|
--metadata |
stringArray |
Los metadatos del objeto. Use parámetros con el prefijo x-oss-meta-* para metadatos personalizados. |
|
--object-acl |
string |
La lista de control de acceso (ACL) del objeto. |
|
--server-side-data-encryption |
string |
El algoritmo de cifrado del lado del servidor para el objeto. |
|
--server-side-encryption |
string |
El método de cifrado del lado del servidor. |
|
--server-side-encryption-key-id |
string |
El ID de la clave maestra del cliente (CMK) administrada por KMS. |
|
--storage-class |
string |
La clase de almacenamiento del objeto. |
|
--tagging |
string |
Las etiquetas del objeto. Especifique varias etiquetas con el formato TagA=A&TagB=B. |
El comando put-object corresponde a la operación de la API PutObject. Para obtener más información sobre los parámetros de la operación PutObject, consulte PutObject.
Para obtener más información sobre las opciones globales de línea de comandos compatibles, consulte Global command-line options.
Ejemplos
-
Cargue un objeto desde una cadena.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" -
Cargue un objeto desde un archivo local.
ossutil api put-object --bucket examplebucket --key exampleobject --body file://uploadFile -
Cargue una cadena con metadatos personalizados.
ossutil api put-object --bucket examplebucket --key exampleobject --metadata user=aliyun --metadata email=ali***@aliyuncs.com --body "hi oss" -
Cargue una cadena con etiquetas.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --tagging "TagA=A&TagB=B" -
Cargue una cadena con una ACL y una clase de almacenamiento específicas.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --object-acl private --storage-class IA -
Cargue una cadena con cifrado del lado del servidor.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --server-side-encryption KMS --server-side-data-encryption SM4 --server-side-encryption-key-id 9468da86-3509-4f8d-a61e-6eab1eac**** -
Cargue una cadena sin sobrescribir un objeto con el mismo nombre.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --forbid-overwrite true -
Cargue una cadena con configuración de control de caché.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --cache-control no-cache -
Cargue una cadena con un nombre de archivo de descarga personalizado.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --content-disposition "attachment;filename=oss_download.jpg"