IBM Cloud Docs
IBM Cloud Object Storage CLI

IBM Cloud Object Storage CLI

El plug-in IBM Cloud® Object Storage amplía la interfaz de línea de mandatos (CLI) de IBM Cloud con un derivador de API para trabajar con recursos de Object Storage.

Instalación y configuración

El plugin es compatible con plataformas Linux (x86_64, arm64, ppc64le, s390x), Windows ® (x64) y macOS® (amd64, arm64) que se ejecutan en procesadores de 64 bits.

Instale el plugin con el mandato plugin install.

ibmcloud plugin install cloud-object-storage

Una vez instalado el plugin, puede configurar el plugin utilizando el mandato ibmcloud cos config. Esto se puede utilizar para completar el complemento con sus credenciales, la ubicación de descarga predeterminada, elegir su autenticación, etc.

Para obtener un rendimiento óptimo, asegúrese de que el rastreo esté inhabilitado estableciendo la variable de entorno IBMCLOUD_TRACE en false.

El programa también ofrece la posibilidad de configurar el directorio local predeterminado para los archivos descargados y de establecer una región predeterminada. Para establecer la ubicación de descarga predeterminada, escriba ibmcloud cos config ddl y especifique en el programa una vía de acceso de archivo válida. Para establecer una región predeterminada, escriba ibmcloud cos config region y especifique en el programa un código de región, como por ejemplo us-south. El valor predeterminado es us-geo.

Puedes ver tu actual IBM Cloud Object Storage credenciales solicitando ibmcloud cos config list. Como el plugin genera el archivo de configuración, es mejor no editar el archivo de forma manual.

$ ibmcloud cos config list
Key                     Value
Last Updated            Tuesday, April 28 2020 at 19:35:57
Default Region          us-south
Download Location       /home/ibmuser/Downloads
CRN                     8f275e7b-c076-49e2-b9c5-f985704cf678
AccessKeyID             9eib1eejar6HaezaohveV5hikei4aNg2ooV0qu
SecretAccessKey         ********************************************
Authentication Method   IAM
URL Style               VHost

Autenticación de IAM

Si está utilizando la autenticación de IAM, debe configurar el cliente con un ID de instancia para utilizar algunos de los mandatos. Para recuperar el ID de la instancia, puede escribir ibmcloud resource service-instance <INSTANCE_NAME> --id, reemplazar <INSTANCE_NAME> con el alias único que asignó a su instancia de servicio. En los ejemplos siguientes, el valor 8f275e7b-c076-49e2-b9c5-f985704cf678 es un ID de instancia de ejemplo.

En primer lugar, recupere el CRN y el ID con el nombre de la instancia. Asegúrese de utilizar comillas (') en el nombre de instancia y de que ha iniciado sesión en IBM Cloud. Sólo se necesita la última parte del CRN, la parte posterior a ::.

$ ibmcloud resource service-instance 'My Awesome Cloud Object Storage'  --id
Retrieving service instance My Awesome Cloud Object Storage in all resource groups under account IBM as ibmuser@us.ibm.com...
crn:v1:bluemix:public:cloud-object-storage:global:a/94400e98c553415c9599db39b9be9219:3b7d66c8-9fdf-4f81-b7e6-08d187f07288:: 8f275e7b-c076-49e2-b9c5-f985704cf678

Establezca el CRN con el mandato ibmcloud cos config crn. Es posible que le avise sobre la sobrescritura. Si no desea proporcionar el CRN de forma interactiva, puede proporcionarlo en el mismo mandato con el distintivo --crn.

$ ibmcloud cos config crn
Resource Instance ID CRN:  ()> 8f275e7b-c076-49e2-b9c5-f985704cf678
Saving new Service Instance ID...
OK
Successfully stored your service instance ID.

Verifique la configuración:

$ ibmcloud cos config crn --list
Key   Value
CRN   8f275e7b-c076-49e2-b9c5-f985704cf678

De forma alternativa, puede abrir la consola web, seleccionar Credenciales de servicio en la barra lateral y crear un nuevo conjunto de credenciales (o visualizar un archivo de credenciales existente que ya haya creado).

Credenciales de HMAC

Si lo prefiere, puede utilizar credenciales de HMAC de ID de servicio en lugar de la clave de API. Ejecute ibmcloud cos config hmac para especificar las credenciales de HMAC y luego cambie el método de autorización mediante ibmcloud cos config auth.

Si opta por utilizar la autenticación de señal con su propia clave de API, no es necesario que proporcione ninguna credencial ya que el programa le autentica automáticamente.

En cualquier momento, para conmutar entre la autenticación HMAC e IAM, puede escribir ibmcloud cos config auth. Para obtener más información sobre la autenticación y autorización en IBM Cloud, consulte la documentación de Identity and Access Management.

Habilitar el rastreo en la interfaz de línea de mandatos

El rastreo se puede habilitar estableciendo la variable de entorno IBMCLOUD_TRACE en true (no se tienen en cuenta mayúsculas y minúsculas). Cuando el rastreo está habilitado, la información de depuración adicional se imprime en el terminal.

En el terminal Linux/macOS:

export IBMCLOUD_TRACE=true

En el símbolo del sistema de Windows:

SET IBMCLOUD_TRACE=true

Para inhabilitar el rastreo, establezca la variable de entorno IBMCLOUD_TRACE en false (no se tienen en cuenta mayúsculas y minúsculas).

Índice de mandatos

Cada operación tiene una explicación de lo que hace, cómo usarla y cualquier parámetro opcional o requerido. A menos que se especifique como opcional, todo parámetro de la lista es obligatorio.

El plugin de CLI todavía no da soporte a la suite completa de características disponibles en Object Storage. La CLI no puede utilizar Aspera High-Speed Transfer, Object Storageinmutable, creando grupos de Key Protect o cortafuegos de grupo.

Terminación anómala de una carga de varias partes

  • Acción: terminar de forma anómala una instancia de carga de varias partes finalizando la carga en el grupo en la cuenta de IBM Cloud Object Storage del usuario.
  • Uso: ibmcloud cos multipart-upload-abort --bucket BUCKET_NAME --key KEY --upload-id ID [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • ID de carga que identifica la carga de varias partes.
      • Distintivo: --upload-id ID
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Configurar un sitio web estático

  • Acción: Configura un grupo para alojar un sitio web estático.

  • Uso: ibmcloud cos bucket-website-put --bucket BUCKET_NAME [--region REGION] [--output FORMAT]

  • Parámetros que se deben proporcionar:

    • El nombre del grupo.

      • Distintivo: --bucket BUCKET_NAME
    • La configuración del sitio web en forma de una estructura JSON. El prefijo file:// se utiliza para cargar la estructura JSON desde el archivo especificado, como por ejemplo --website-configuration file://<filename.json>.

      • Distintivo: --website-configuration STRUCTURE Los parámetros siguientes están disponibles para configurar el comportamiento estático del sitio web. No se requiere ninguno. Para obtener más detalles, consulte la documentación.

        {
          "ErrorDocument": {
            "Key": "string"
          },
          "IndexDocument": {
            "Suffix": "string"
          },
          "RoutingRules": [
            {
              "Condition": {
                "HttpErrorCodeReturnedEquals": "string",
                "KeyPrefixEquals": "string"
              },
              "Redirect": {
                "HostName": "string",
                "HttpRedirectCode": "string",
                "Protocol": "http"|"https",
                "ReplaceKeyPrefixWith": "string",
                "ReplaceKeyWith": "string"
              }
            }
            ...
          ]
        }
        

        De forma alternativa, si el sitio web del grupo está configurado para redirigir el tráfico, debe ser el único parámetro configurado:

        	  "RedirectAllRequestsTo": {
        	    "HostName": "string",
        	    "Protocol": "http"|"https"
        	  }
        	  ```
        
        
        
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.

      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.

      • Distintivo: --output FORMAT

Copia de un objeto del grupo

Si desea añadir metadatos a un objeto durante la copia (utilizando la característica --metadata ), debe añadir el atributo --metadata-directive REPLACE ya que los metadatos se copian durante la operación de forma predeterminada (un --metadata-directive COPY implícito).

  • Acción: copiar un objeto del grupo de origen en el grupo de destino.
  • Uso: ibmcloud cos object-copy --bucket BUCKET_NAME --key KEY --copy-source SOURCE [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-type MIME] [--copy-source-if-match ETAG] [--copy-source-if-modified-since TIMESTAMP] [--copy-source-if-none-match ETAG] [--copy-source-if-unmodified-since TIMESTAMP] [--metadata MAP] [--metadata-directive DIRECTIVE] [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del depósito de destino.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • (FUENTE) El nombre del depósito de origen y el nombre de clave del objeto de origen, que está separado por una barra diagonal (/). Debe estar codificado en URL.
      • Distintivo: --copy-source SOURCE
    • Opcional : Especifica CACHING_DIRECTIVES para la cadena de solicitud y respuesta.
      • Distintivo: --cache-control CACHING_DIRECTIVES
    • Opcional : Especifica información de presentación (DIRECTIVES ).
      • Distintivo: --content-disposition DIRECTIVES
    • Opcional : Especifica qué codificaciones de contenido (CONTENT_ENCODING) se aplican al objeto y, por lo tanto, qué mecanismos de decodificación se deben aplicar para obtener el tipo de medio al que hace referencia el campo de encabezado Content-Type.
      • Distintivo: --content-encoding CONTENT_ENCODING
    • Opcional : El IDIOMA en el que se encuentra el contenido.
      • Distintivo: --content-language LANGUAGE
    • Opcional : Un tipo MIME estándar que describe el formato de los datos del objeto.
      • Distintivo: --content-type MIME
    • Opcional : Copia el objeto si su etiqueta de entidad (Etag ) coincide con la etiqueta especificada (ETAG ).
      • Distintivo: --copy-source-if-match ETAG
    • Opcional : Copia el objeto si ha sido modificado desde el momento especificado (TIMESTAMP).
      • Distintivo: --copy-source-if-modified-since TIMESTAMP
    • Opcional : Copia el objeto si su etiqueta de entidad (ETag ) es diferente a la etiqueta especificada (ETAG ).
      • Distintivo: --copy-source-if-none-match ETAG
    • Opcional : Copia el objeto si no ha sido modificado desde el tiempo especificado (TIMESTAMP).
      • Distintivo: --copy-source-if-unmodified-since TIMESTAMP
    • Opcional : Un MAP de metadatos para almacenar.
      • Distintivo: --metadata MAP Sintaxis JSON: El distintivo --metadata toma el prefijo file:// que se utiliza para cargar la estructura JSON desde el archivo especificado.
      {
        "file_name": "file_20xxxxxxxxxxxx45.zip",
        "label": "texas",
        "state": "Texas",
        "Date_to": "2019-11-09T16:00:00.000Z",
        "Sha256sum": "9e39dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx8ce6b68ede3a47",
        "Timestamp": "Thu, 17 Oct 2019 09:22:13 GMT"
      }
      ```

   * _Optional_: Specifies whether the metadata is copied from the source object or replaced with metadata provided in the request. DIRECTIVE values: COPY,REPLACE.
        * Flag: ` --metadata-directive DIRECTIVE`
    * _Optional_: The REGION where the bucket is present. If this flag is not provided, the program uses the default option that is specified in config.
        * Flag: `--region REGION`
    * _Optional_: Output FORMAT can be only json or text.
        * Flag: `--output FORMAT`

Creación de un nuevo grupo

  • Acción: crear un grupo en una instancia de IBM Cloud Object Storage.
  • Uso: ibmcloud cos bucket-create --bucket BUCKET_NAME [--class CLASS_NAME][--class onerate_active] [--ibm-service-instance-id ID] [--region REGION] [--output FORMAT]
    • Tenga en cuenta que debe proporcionar un CRN si utiliza la autenticación de IAM. Esto se puede establecer utilizando el mandato ibmcloud cos config crn.
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : El nombre de la clase.
      • Distintivo: --class CLASS_NAME
    • El usuario debe especificar onerate_active al crear un depósito.
      • Distintivo: --class onerate_active
    • Opcional: establece el IBM ID de instancia de servicio en la solicitud.
      • Distintivo: --ibm-service-instance-id ID
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Crea un nuevo depósito con Key Protect

  • Acción: Crea un cubo con Key Protect en un IBM Cloud Object Storage instancia.
  • Uso: bucket-create --bucket BUCKET_NAME [--ibm-service-instance-id ID] [--class CLASS_NAME] [--region REGION] --kms-root-key-crn CUSTOMERROOTKEYCRN --kms-encryption-algorithm ALGORITHM [--output FORMAT] [--json]
    • Tenga en cuenta que debe proporcionar un CRN si utiliza la autenticación de IAM. Esto se puede establecer utilizando el mandato ibmcloud cos config crn.
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • El CUSTOMERROOTKEYCRN de la clave raíz de KMS que se asociará con el depósito para el cifrado de datos.
      • Distintivo: --kms-root-key-crn CUSTOMERROOTKEYCRN
    • Opcional : El ALGORITMO y el TAMAÑO que se utilizarán con la clave de cifrado almacenada mediante protección de clave.
      • Distintivo: --kms-encryption-algorithm ALGORITHM
    • Opcional : El nombre de la clase.
      • Distintivo: --class CLASS_NAME
    • Opcional: establece el IBM ID de instancia de servicio en la solicitud.
      • Distintivo: --ibm-service-instance-id ID
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT
    • (En desuso): Salida devuelta en formato JSON sin formato.
      • Distintivo: --json

Ejemplo:

ibmcloud cos bucket-create --bucket bucket-name --kms-root-key-crn crn:v1:staging:public:kms:us-south:a/9978e0xxxxxxxxxxxxxxxxxxxxxx8654:dfdxxxxx-xxxx-xxxx-xxxx-xxxxxxba6eb0:key:7cea005e-75d4-4a08-ad2f-5e56141f6a96 --kms-encryption-algorithm AES256

Crear un nuevo grupo con Hyper Protect Crypto Services

  • Acción: Cree un nuevo grupo con Hyper Protect Crypto Services.
  • Uso: bucket-create --bucket BUCKET_NAME [--ibm-service-instance-id ID] [--class CLASS_NAME] [--region REGION] --kms-root-key-crn CUSTOMERROOTKEYCRN --kms-encryption-algorithm ALGORITHM [--output FORMAT] [--json]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • El CUSTOMERROOTKEYCRN de la clave raíz de KMS que se asociará con el depósito para el cifrado de datos.
      • Distintivo: --kms-root-key-crn CUSTOMERROOTKEYCRN
    • Opcional : El ALGORITMO y el TAMAÑO que se utilizarán con la clave de cifrado almacenada mediante protección de clave.
      • Distintivo: --kms-encryption-algorithm ALGORITHM
    • Opcional : El nombre de la clase.
      • Distintivo: --class CLASS_NAME
    • Opcional: establece el IBM ID de instancia de servicio en la solicitud.
      • Distintivo: --ibm-service-instance-id ID
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT
    • (En desuso): Salida devuelta en formato JSON sin formato.
      • Distintivo: --json

Ejemplo:

ibmcloud cos bucket-create --bucket bucket-name --kms-root-key-crn crn:v1:bluemix:public:hs-crypto:us-south:a/ee747e4xxxxxxxxxxxxxxxxxxxxxx7559:ac6xxxxx-xxxx-xxxx-xxxx-xxxxxx1bea99:key:e7451f36-d7ea-4f55-bc1c-ce4bcceb7018

Creación de una nueva carga de varias partes

  • Acción: comenzar el proceso de carga de un archivo en varias partes creando una nueva instancia de carga de varias partes.

  • Uso: ibmcloud cos multipart-upload-create --bucket BUCKET_NAME --key KEY [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-type MIME] [--metadata MAP] [--region REGION] [--output FORMAT]

  • Parámetros que se deben proporcionar:

    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • Opcional : Especifica CACHING_DIRECTIVES para la cadena de solicitud y respuesta.
      • Distintivo: --cache-control CACHING_DIRECTIVES
    • Opcional : Especifica información de presentación (DIRECTIVES ).
      • Distintivo: --content-disposition DIRECTIVES
    • Opcional : Especifica la codificación del contenido (CONTENT_ENCODING ) del objeto..
      • Distintivo: --content-encoding CONTENT_ENCODING
    • Opcional : El IDIOMA en el que se encuentra el contenido.
      • Distintivo: --content-language LANGUAGE
    • Opcional : Un tipo MIME estándar que describe el formato de los datos del objeto.
      • Distintivo: --content-type MIME
    • Opcional : Un MAP de metadatos para almacenar.
      • Distintivo: --metadata MAP Sintaxis JSON: El distintivo --metadata toma el prefijo file:// que se utiliza para cargar la estructura JSON desde el archivo especificado.
    {
      "file_name": "file_20xxxxxxxxxxxx45.zip",
      "label": "texas",
      "state": "Texas",
      "Date_to": "2019-11-09T16:00:00.000Z",
      "Sha256sum": "9e39dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx8ce6b68ede3a47",
      "Timestamp": "Thu, 17 Oct 2019 09:22:13 GMT"
    }
    
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Supresión de un grupo existente

  • Acción: suprimir un grupo existente en una instancia de IBM Cloud Object Storage.
  • Uso: ibmcloud cos bucket-delete --bucket BUCKET_NAME [--region REGION] [--force] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : La operación no pedirá confirmación.
      • Distintivo: --force
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Supresión de CORS de grupo

  • Acción: suprimir la configuración de CORS en un grupo en la cuenta de IBM Cloud Object Storage de un usuario.
  • Uso: ibmcloud cos bucket-cors-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Suprimir una configuración de sitio web estático

  • Acción: Elimina la configuración de sitio web estático de un grupo.
  • Uso: ibmcloud cos bucket-website-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.

      • Distintivo: --bucket BUCKET_NAME
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Supresión de un objeto

  • Acción: suprimir un objeto de un grupo en la cuenta de IBM Cloud Object Storage de un usuario.
  • Uso: ibmcloud cos object-delete --bucket BUCKET_NAME --key KEY [--region REGION] [--force] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : La operación no pedirá confirmación.
      • Distintivo: --force
      • Opcional : El FORMATO de salida solo puede ser json o texto.
        • Distintivo: --output FORMAT

Supresión de varios objetos

  • Acción: suprimir varios objetos de un grupo en la cuenta de IBM Cloud Object Storage de un usuario.

  • Uso: ibmcloud cos objects-delete --bucket BUCKET_NAME --delete STRUCTURE [--region REGION] [--output FORMAT]

  • Parámetros que se deben proporcionar:

    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Una estructura (STRUCTURE) que utiliza la sintaxis abreviada o JSON.
      • Distintivo: --delete STRUCTURE
      • Sintaxis abreviada: --delete 'Objects=[{Key=string},{Key=string}],Quiet=boolean'
      • Sintaxis JSON: --delete file://<filename.json>

        El mandato --delete toma una estructura JSON que lista los objetos a suprimir. En este ejemplo, se utiliza el prefijo file:// para cargar la estructura JSON desde el archivo especificado.
    	{
    	"Objects": [
    	{
    	"Key": "string",
    	"VersionId": "string"
    	}
    ...
    	],
    	"Quiet": true|false
    	}
    
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Descarga de un objeto

  • Acción: descargar un objeto de un grupo en la cuenta de IBM Cloud Object Storage de un usuario.
  • Uso: ibmcloud cos object-get --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--response-cache-control HEADER] [--response-content-disposition HEADER] [--response-content-encoding HEADER] [--response-content-language HEADER] [--response-content-type HEADER] [--response-expires HEADER] [--region REGION] [--output FORMAT] [OUTFILE]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • Opcional : Devuelve el objeto sólo si su etiqueta de entidad (ETag ) es lo mismo que el ETAG especificado; de lo contrario, devolverá un 412 (la condición previa falló).
      • Distintivo: --if-match ETAG
    • Opcional : Devuelve el objeto solo si se ha modificado desde la TIMESTAMP especificada; de lo contrario, devuelve un 304 (no modificado).
      • Distintivo: --if-modified-since TIMESTAMP
    • Opcional : Devuelve el objeto sólo si su etiqueta de entidad (ETag ) es diferente de la ETAG especificado; de lo contrario, devolverá un 304 (no modificado).
      • Distintivo: --if-none-match ETAG
    • Opcional : Devuelve el objeto solo si no se ha modificado desde la TIMESTAMP especificada; de lo contrario, devuelve un 412 (la condición previa falló).
      • Distintivo: --if-unmodified-since TIMESTAMP
    • Opcional : Descarga los bytes de RANGE especificados de un objeto.
      • Distintivo: --range RANGE
    • Opcional : Establece el ENCABEZADO de Cache-Control de la respuesta.
      • Distintivo: --response-cache-control HEADER
    • Opcional : Establece el ENCABEZADO de disposición de contenido de la respuesta.
      • Distintivo: --response-content-disposition HEADER
    • Opcional : establece el ENCABEZADO de codificación de contenido de la respuesta.
      • Distintivo: --response-content-encoding HEADER
    • Opcional : establece el ENCABEZADO del idioma del contenido de la respuesta.
      • Distintivo: --response-content-language HEADER
    • Opcional : establece el ENCABEZADO del tipo de contenido de la respuesta.
      • Distintivo: --response-content-type HEADER
    • Opcional : Establece el ENCABEZADO de Expira de la respuesta.
      • Distintivo: --response-expires HEADER
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT
    • Opcional : La ubicación donde guardar el contenido del objeto. Si no se especifica este parámetro, el programa utiliza la ubicación predeterminada.
      • Parámetro: OUTFILE

Descargar objetos usando S3Manager

  • Acción: descargar los objetos de S3 de forma simultánea.
  • Uso: ibmcloud cos download --bucket BUCKET_NAME --key KEY [--concurrency value] [--part-size SIZE] [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--response-cache-control HEADER] [--response-content-disposition HEADER] [--response-content-encoding HEADER] [--response-content-language HEADER] [--response-content-type HEADER] [--response-expires HEADER] [--region REGION] [--output FORMAT] [OUTFILE]
  • Parámetros que se deben proporcionar:
    • El nombre (BUCKET_NAME) del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • Opcional : El número de rutinas Go que se activarán en paralelo por llamada para descargar al enviar piezas. El valor predeterminado es 5.
      • Distintivo: --concurrency value
    • Opcional: El TAMAÑO del búfer (en bytes) que se utilizará al almacenar datos en búfer en fragmentos y finalizarlos como partes para S3. El tamaño mínimo de parte permitido es 5 MB.
      • Distintivo: --part-size SIZE
    • Opcional : Devuelve el objeto sólo si su etiqueta de entidad (ETag ) es lo mismo que el ETAG especificado; de lo contrario, devolverá un 412 (la condición previa falló).
      • Distintivo: --if-match ETAG
    • Opcional : Devuelve el objeto solo si se ha modificado desde la TIMESTAMP especificada; de lo contrario, devuelve un 304 (no modificado).
      • Distintivo: --if-modified-since TIMESTAMP
    • Opcional : Devuelve el objeto sólo si su etiqueta de entidad (ETag ) es diferente de la ETAG especificado; de lo contrario, devolverá un 304 (no modificado).
      • Distintivo: --if-none-match ETAG
    • Opcional : Devuelve el objeto solo si no se ha modificado desde la TIMESTAMP especificada; de lo contrario, devuelve un 412 (la condición previa falló).
      • Distintivo: --if-unmodified-since TIMESTAMP
    • Opcional : Descarga los bytes de RANGE especificados de un objeto. Para obtener más información acerca de la cabecera Range de HTTP, pulse aquí.
      • Distintivo: --range RANGE
    • Opcional : Establece el ENCABEZADO de Cache-Control de la respuesta.
      • Distintivo: --response-cache-control HEADER
    • Opcional : Establece el ENCABEZADO de disposición de contenido de la respuesta.
      • Distintivo: --response-content-disposition HEADER
    • Opcional : establece el ENCABEZADO de codificación de contenido de la respuesta.
      • Distintivo: --response-content-encoding HEADER
    • Opcional : establece el ENCABEZADO del idioma del contenido de la respuesta.
      • Distintivo: --response-content-language HEADER
    • Opcional : establece el ENCABEZADO del tipo de contenido de la respuesta.
      • Distintivo: --response-content-type HEADER
    • Opcional : Establece el ENCABEZADO de Expira de la respuesta.
      • Distintivo: --response-expires HEADER
    • Opcional : La REGIÓN donde está presente el depósito. Si este distintivo no se proporciona, el programa utilizará la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT
    • Opcional : La ubicación donde guardar el contenido del objeto. Si no se especifica este parámetro, el programa utiliza la ubicación predeterminada.
      • Parámetro: OUTFILE

Búsqueda de un grupo

  • Acción: determinar la región y la clase de un grupo en una instancia de IBM Cloud Object Storage.
  • Uso: ibmcloud cos bucket-location-get --bucket BUCKET_NAME [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Obtención de la clase de un grupo

  • Acción: determinar la clase de un grupo en una instancia de IBM Cloud Object Storage.
  • Uso: ibmcloud cos bucket-class-get --bucket BUCKET_NAME [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Obtención de CORS de grupo

  • Acción: devuelve la configuración de CORS de un grupo en la cuenta de IBM Cloud Object Storage de un usuario.
  • Uso: ibmcloud cos bucket-cors-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Obtención de las cabeceras de un grupo

  • Acción: determinar si un grupo existe en una instancia de IBM Cloud Object Storage.
  • Uso: ibmcloud cos bucket-head --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Finalización de una carga de varias partes

  • Acción: finalizar una instancia de carga de varias partes ensamblando las partes cargadas y cargando el archivo en el grupo de la cuenta la cuenta de IBM Cloud Object Storage del usuario.
  • Uso: ibmcloud cos multipart-upload-complete --bucket BUCKET_NAME --key KEY --upload-id ID --multipart-upload STRUCTURE [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.

      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.

      • Distintivo: --key KEY
    • ID de carga que identifica la carga de varias partes.

      • Distintivo: --upload-id ID
    • La estructura (STRUCTURE) de MultipartUpload que se va a definir.

      • Distintivo: --multipart-upload STRUCTURE
      • Sintaxis abreviada: --multipart-upload 'Parts=[{ETag=string,PartNumber=integer},{ETag=string,PartNumber=integer}]'
      • Sintaxis JSON: --multipart-upload file://<filename.json>

        El mandato --multipart-upload toma una estructura JSON que describe las partes de la carga de varias partes que se deben volver a ensamblar en el archivo completo. En este ejemplo, se utiliza el prefijo file:// para cargar la estructura JSON desde el archivo especificado.
      		{
      		"Parts": [
      			{
      			 "ETag": "string",
      			 "PartNumber": integer
      			}
      			...
      			]
      		}
      
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.

      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.

      • Distintivo: --output FORMAT

Configuración del programa

  • Acción: configurar las preferencias del programa.
  • Uso: ibmcloud cos config [COMMAND]
  • Mandatos:
    • Cambiar entre autenticación de HMAC y de IAM.
      • Mandato: auth
    • Guardar CRN en la configuración.
      • Mandato: crn
    • Guardar la ubicación de descarga predeterminada en la configuración.
      • Mandato: ddl
    • Guardar las credenciales de HMAC en la configuración.
      • Mandato: hmac
    • Mostrar la configuración.
      • Mandato: list
    • Guardar la región predeterminada en la configuración.
      • Mandato: region
    • Cambiar entre VHost y estilo de URL de ruta.
      • Mandato: url-style
    • Establezca el punto final de servicio predeterminado.
      • Mandato: endpoint-url
        • Parámetros:

          • --list muestra el punto final de servicio predeterminado actual, si se ha establecido. De lo contrario, estará vacío.
          • --url some.end.point.url cambiará el punto final de servicio por el valor especificado.
          • --clear elimina el URL de punto final de servicio predeterminado que se ha establecido.

Obtener una configuración de sitio web estático

  • Acción: Obtiene la configuración estática del sitio web de un grupo.
  • Uso: ibmcloud cos bucket-website-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.

      • Distintivo: --bucket BUCKET_NAME
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Obtención de las cabeceras de un objeto

  • Acción: determinar si un archivo existe en un grupo en la cuenta de IBM Cloud Object Storage de un usuario.
  • Uso: ibmcloud cos object-head --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • Opcional : Devuelve el objeto sólo si su etiqueta de entidad (ETag ) es lo mismo que el ETAG especificado; de lo contrario, devolverá un 412 (la condición previa falló).
      • Distintivo: --if-match ETAG
    • Opcional : Devuelve el objeto solo si se ha modificado desde la TIMESTAMP especificada; de lo contrario, devuelve un 304 (no modificado).
      • Distintivo: --if-modified-since TIMESTAMP
    • Opcional : Devuelve el objeto sólo si su etiqueta de entidad (ETag ) es diferente de la ETAG especificado; de lo contrario, devolverá un 304 (no modificado).
      • Distintivo: --if-none-match ETAG
    • Opcional : Devuelve el objeto solo si no se ha modificado desde la TIMESTAMP especificada; de lo contrario, devuelve un 412 (la condición previa falló).
      • Distintivo: --if-unmodified-since TIMESTAMP
    • Descarga los bytes RANGE especificados de un objeto.
      • Distintivo: --range RANGE
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Obtención de una lista de todos los grupos

  • Acción: mostrar una lista de todos los grupos de la cuenta de IBM Cloud Object Storage de un usuario. Los grupos se pueden encontrar en diferentes regiones.
  • Uso: ibmcloud cos buckets [--ibm-service-instance-id ID] [--output FORMAT]
    • Tenga en cuenta que debe proporcionar un CRN si utiliza la autenticación de IAM. Esto se puede establecer utilizando el mandato ibmcloud cos config crn.
  • Parámetros que se deben proporcionar:
    • No hay parámetros que especificar.
      • Opcional: establece el IBM ID de instancia de servicio en la solicitud.
        • Distintivo: --ibm-service-instance-id
      • Opcional : El FORMATO de salida solo puede ser json o texto.
        • Distintivo: --output FORMAT

Lista ampliada de grupos

  • Acción: mostrar una lista de todos los grupos de la cuenta de IBM Cloud Object Storage de un usuario. Los grupos se pueden encontrar en diferentes regiones.
  • Uso: ibmcloud cos buckets-extended [--ibm-service-instance-id ID] [--marker KEY] [--prefix PREFIX] [--page-size SIZE] [--max-items NUMBER] [--output FORMAT]
    • Tenga en cuenta que debe proporcionar un CRN si utiliza la autenticación de IAM. Esto se puede establecer utilizando el mandato ibmcloud cos config crn.
  • Parámetros que se deben proporcionar:
    • No hay parámetros que especificar.
      • Opcional: establece el IBM ID de instancia de servicio en la solicitud.
        • Distintivo: --ibm-service-instance-id
      • Opcional : Especifica la CLAVE con la que comenzar al enumerar objetos en un depósito.
        • Distintivo: --marker KEY
      • Opcional : Limita la respuesta a claves que comienzan con el PREFIJO especificado.
        • Distintivo: --prefix PREFIX
      • Opcional : El TAMAÑO de cada página para ingresar en la llamada de servicio. Esto no afecta al número de elementos que se devuelven en la salida del mandato. Si se establece un tamaño de página menor, se generan más llamadas al servicio y se recuperan menos elementos en cada llamada. Esto puede ayudar a evitar que las llamadas de servicio superen el tiempo de espera.
        • Distintivo: --page-size SIZE
      • Opcional : El NÚMERO total de elementos que se devolverán en la salida del comando.
        • Distintivo: --max-items NUMBER
      • Opcional : El FORMATO de salida solo puede ser json o texto.
        • Distintivo: --output FORMAT

Obtención de una lista de las cargas de varias partes en curso

  • Acción: mostrar las cargas de varias partes en curso.
  • Uso: ibmcloud cos multipart-uploads --bucket BUCKET_NAME [--delimiter DELIMITER] [--encoding-type METHOD] [--prefix PREFIX] [--key-marker value] [--upload-id-marker value] [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : UN DELIMITER es un carácter que se utiliza para agrupar claves.
      • Distintivo: --delimiter DELIMITER
    • Opcional : Solicita codificar las claves del objeto en la respuesta y especifica el MÉTODO de codificación a utilizar.
      • Distintivo: --encoding-type METHOD
    • Opcional : Limita la respuesta a claves que comienzan con el PREFIJO especificado.
      • Distintivo: --prefix PREFIX
    • Opcional : Junto con upload-id-marker, este parámetro especifica la carga multiparte después de la cual debe comenzar el listado.
      • Distintivo: --key-marker value
    • Opcional : Junto con el marcador de clave, especifica la carga de varias partes después de la cual debe comenzar el listado. Si no se especifica key-marker, el parámetro upload-id-marker se pasa por alto.
      • Distintivo: --upload-id-marker value
    • Opcional : El TAMAÑO de cada página para ingresar en la llamada de servicio. Esto no afecta al número de elementos que se devuelven en la salida del mandato. Si se establece un tamaño de página menor, se generan más llamadas al servicio y se recuperan menos elementos en cada llamada. Esto puede ayudar a evitar que se agote el tiempo de espera de las llamadas de servicio. (predeterminado: 1000).
      • Distintivo: --page-size SIZE
    • Opcional : El NÚMERO total de elementos que se devolverán en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un valor NextToken en la salida del mandato. Para reanudar la paginación, proporcione la NextToken valor en el argumento del token inicial de un comando posterior. (predeterminado: 0).
      • Distintivo: --max-items NUMBER
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Obtención de una lista de objetos

  • Acción: obtener una lista de los archivos contenidos en un grupo en la cuenta de IBM Cloud Object Storage de un usuario. Esta operación se limita actualmente a los 1000 últimos objetos creados y no se puede filtrar.
  • Uso: ibmcloud cos objects --bucket BUCKET_NAME [--delimiter DELIMITER] [--encoding-type METHOD] [--prefix PREFIX] [--starting-token TOKEN] [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : UN DELIMITER es un carácter que se utiliza para agrupar claves.
      • Distintivo: --delimiter DELIMITER
    • Opcional : Solicita codificar las claves del objeto en la respuesta y especifica el MÉTODO de codificación a utilizar.
      • Distintivo: --encoding-type METHOD
    • Opcional : Limita la respuesta a claves que comienzan con el PREFIJO especificado.
      • Distintivo: --prefix PREFIX
    • Opcional : UN TOKEN para especificar dónde comenzar a paginar. Es el valor NextToken de una respuesta truncada anterior.
      • Distintivo: --starting-token TOKEN
    • Opcional : El TAMAÑO de cada página para ingresar en la llamada de servicio. Esto no afecta al número de elementos que se devuelven en la salida del mandato. Si se establece un tamaño de página menor, se generan más llamadas al servicio y se recuperan menos elementos en cada llamada. Esto puede ayudar a evitar que se agote el tiempo de espera de las llamadas de servicio. (predeterminado: 1000)
      • Distintivo: --page-size SIZE
    • Opcional : El NÚMERO total de elementos que se devolverán en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un valor NextToken en la salida del mandato. Para reanudar la paginación, proporcione la NextToken valor en el argumento del token inicial de un comando posterior. (predeterminado: 0)
      • Distintivo: --max-items NUMBER
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Listar objetos v2

  • Acción: Enumere todos los objetos en un depósito específico.
  • Uso: list-objects-v2 --bucket BUCKET_NAME [--starting-token Starting Token] [--delimiter DELIMITER] [--encoding-type METHOD] [--fetch-owner Boolean] [--max-items NUMBER] [--prefix PREFIX] [--start-after Start After] [--page-size SIZE] [--region REGION] [--output FORMAT] [--json]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : UN DELIMITER es un carácter que se utiliza para agrupar claves.
      • Distintivo: --delimiter DELIMITER
    • Opcional : Solicita codificar las claves del objeto en la respuesta y especifica el MÉTODO de codificación a utilizar.
      • Distintivo: --encoding-type METHOD
    • Opcional : Limita la respuesta a claves que comienzan con el PREFIJO especificado.
      • Distintivo: --prefix PREFIX
    • Opcional : UN TOKEN para especificar dónde comenzar a paginar. Es el valor NextToken de una respuesta truncada anterior.
      • Distintivo: --starting-token TOKEN
    • Opcional : El TAMAÑO de cada página para ingresar en la llamada de servicio. Esto no afecta al número de elementos que se devuelven en la salida del mandato. Si se establece un tamaño de página menor, se generan más llamadas al servicio y se recuperan menos elementos en cada llamada. Esto puede ayudar a evitar que se agote el tiempo de espera de las llamadas de servicio. (predeterminado: 1000)
      • Distintivo: --page-size SIZE
    • Opcional : El NÚMERO total de elementos que se devolverán en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un valor NextToken en la salida del mandato. Para reanudar la paginación, proporcione la NextToken valor en el argumento del token inicial de un comando posterior. (predeterminado: 0)
      • Distintivo: --max-items NUMBER
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT
    • Opcional: El booleano no está presente en listV2 De forma predeterminada, si desea devolver el campo del propietario con cada clave en el resultado, establezca el campo de recuperación del propietario en verdadero.
      • Distintivo: --fetch-owner Boolean
    • Opcional: Empezar después es donde quieres S3 para comenzar a enumerar. S3 inicia el listado tras la clave especificada. StartAfter puede ser cualquier clave del grupo.
      • Distintivo: --start-after Start After
    • Obsoleto : Salida devuelta en formato JSON sin formato.
      • Distintivo: --json

Obtención de una lista de las partes

  • Acción: mostrar información sobre una instancia de carga de varias partes en curso.
  • Uso: ibmcloud cos parts --bucket BUCKET_NAME --key KEY --upload-id ID --part-number-marker VALUE [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • ID de carga que identifica la carga de varias partes.
      • Distintivo: --upload-id ID
    • El valor de número de parte tras el que comienza la lista (valor predeterminado: 1)
      • Distintivo: --part-number-marker VALUE
    • Opcional : El TAMAÑO de cada página para ingresar en la llamada de servicio. Esto no afecta al número de elementos que se devuelven en la salida del mandato. Si se establece un tamaño de página menor, se generan más llamadas al servicio y se recuperan menos elementos en cada llamada. Esto puede ayudar a evitar que se agote el tiempo de espera de las llamadas de servicio. (predeterminado: 1000)
      • Distintivo: --page-size SIZE
    • Opcional : El NÚMERO total de elementos que se devolverán en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un valor NextToken en la salida del mandato. Para reanudar la paginación, proporcione la NextToken valor en el argumento del token inicial de un comando posterior. (predeterminado: 0)
      • Distintivo: --max-items NUMBER
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Establecimiento de CORS de grupo

  • Acción: establecer la configuración de CORS de un grupo en la cuenta de IBM Cloud Object Storage de un usuario.

  • Uso: ibmcloud cos bucket-cors-put --bucket BUCKET_NAME [--cors-configuration STRUCTURE] [--region REGION] [--output FORMAT]

  • Parámetros que se deben proporcionar:

    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : UNA ESTRUCTURA que utiliza la sintaxis JSON en un archivo.
      • Distintivo: --cors-configuration STRUCTURE
      • Sintaxis JSON: --cors-configuration file://<filename.json>

        El mandato --cors-configuration toma una estructura JSON que describe la configuración CORS. En este ejemplo, se utiliza el prefijo file:// para cargar la estructura JSON desde el archivo especificado.
    	{
    	"CORSRules": [
    	{
      	"AllowedHeaders": ["string", ...],
      	"AllowedMethods": ["string", ...],
      	"AllowedOrigins": ["string", ...],
      	"ExposeHeaders": ["string", ...],
      	"MaxAgeSeconds": integer
    	}
    	...
    	]
    	}
    
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Transferencia de un objeto

  • Acción: cargar un objeto a un grupo en la cuenta de IBM Cloud Object Storage de un usuario.

  • Uso: ibmcloud cos object-put --bucket BUCKET_NAME --key KEY [--body FILE_PATH] [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-length SIZE] [--content-md5 MD5] [--content-type MIME] [--metadata MAP] [--region REGION] [--output FORMAT]

  • Parámetros que se deben proporcionar:

    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • Opcional : Ubicación de los datos del objeto (FILE_PATH ).
      • Distintivo: --body FILE_PATH
    • Opcional : Especifica CACHING_DIRECTIVES para la cadena de solicitud y respuesta.
      • Distintivo: --cache-control CACHING_DIRECTIVES
    • Opcional : Especifica información de presentación (DIRECTIVES ).
      • Distintivo: --content-disposition DIRECTIVES
    • Opcional : Especifica la codificación del contenido (CONTENT_ENCODING ) del objeto.
      • Distintivo: --content-encoding CONTENT_ENCODING
    • Opcional : El IDIOMA en el que se encuentra el contenido.
      • Distintivo: --content-language LANGUAGE
    • Opcional : TAMAÑO del cuerpo en bytes. Este parámetro es útil cuando el tamaño del cuerpo no se puede determinar automáticamente. (predeterminado: 0)
      • Distintivo: --content-length SIZE
    • Opcional: El base64-encoded 128 bits MD5 resumen de los datos.
      • Distintivo: --content-md5 MD5
    • Opcional : Un tipo MIME estándar que describe el formato de los datos del objeto.
      • Distintivo: --content-type MIME
    • Opcional : Un MAP de metadatos para almacenar.
      • Distintivo: --metadata MAP Sintaxis JSON: El distintivo --metadata toma el prefijo file:// que se utiliza para cargar la estructura JSON desde el archivo especificado.
    {
      "file_name": "file_20xxxxxxxxxxxx45.zip",
      "label": "texas",
      "state": "Texas",
      "Date_to": "2019-11-09T16:00:00.000Z",
      "Sha256sum": "9e39dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx8ce6b68ede3a47",
      "Timestamp": "Thu, 17 Oct 2019 09:22:13 GMT"
    }
    
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Cargar objetos usando S3Manager

  • Acción: Cargue objetos en COS simultáneamente.

  • Uso: ibmcloud cos upload --bucket BUCKET_NAME --key KEY --file PATH [--concurrency value] [--max-upload-parts PARTS] [--part-size SIZE] [--leave-parts-on-errors] [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-length SIZE] [--content-md5 MD5] [--content-type MIME] [--metadata MAP] [--region REGION] [--output FORMAT]

  • Parámetros que se deben proporcionar:

    • El nombre (BUCKET_NAME) del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • La vía de acceso (PATH) al archivo que se va a cargar.
      • Distintivo: --file PATH
    • Opcional : El número de rutinas Go que se activarán en paralelo por llamada a Cargar al enviar piezas. El valor predeterminado es 5.
      • Distintivo: --concurrency value
    • Opcional: Número máximo de PIEZAS que se cargarán en S3 que calcula el tamaño de la parte del objeto a cargar. El límite es 10.000 partes.
      • Distintivo: --max-upload-parts PARTS
    • Opcional: El TAMAÑO del búfer (en bytes) que se utilizará al almacenar datos en búfer en fragmentos y finalizarlos como partes para S3. El tamaño mínimo de parte permitido es 5 MB.
      • Distintivo: --part-size SIZE
    • Opcional: Establecer este valor en verdadero hará que el SDK evite llamar AbortMultipartUpload en caso de error, dejando todas las piezas cargadas correctamente en S3 para recuperación manual.
      • Distintivo: --leave-parts-on-errors
    • Opcional : Especifica CACHING_DIRECTIVES para la cadena de solicitud/respuesta.
      • Distintivo: --cache-control CACHING_DIRECTIVES
    • Opcional : Especifica información de presentación (DIRECTIVAS).
      • Distintivo: --content-disposition DIRECTIVES
    • Opcional : Especifica qué codificaciones de contenido (CONTENT_ENCODING) se han aplicado al objeto y, por tanto, qué mecanismos de decodificación se deben aplicar para obtener el tipo de medio al que hace referencia el campo de encabezado Content-Type.
      • Distintivo: --content-encoding CONTENT_ENCODING
    • Opcional : El IDIOMA en el que se encuentra el contenido.
      • Distintivo: --content-language LANGUAGE
    • Opcional : TAMAÑO del cuerpo en bytes. Este parámetro es útil cuando el tamaño del cuerpo no se puede determinar automáticamente.
      • Distintivo: --content-length SIZE
    • Opcional: El base64-encoded 128 bits MD5 resumen de los datos.
      • Distintivo: --content-md5 MD5
    • Opcional : Un tipo MIME estándar que describe el formato de los datos del objeto.
      • Distintivo: --content-type MIME
    • Opcional : Un MAP de metadatos para almacenar.
      • Distintivo: --metadata MAP Sintaxis JSON: El distintivo --metadata toma el prefijo file:// que se utiliza para cargar la estructura JSON desde el archivo especificado.
    {
      "file_name": "file_20xxxxxxxxxxxx45.zip",
      "label": "texas",
      "state": "Texas",
      "Date_to": "2019-11-09T16:00:00.000Z",
      "Sha256sum": "9e39dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx8ce6b68ede3a47",
      "Timestamp": "Thu, 17 Oct 2019 09:22:13 GMT"
    }
    
    • Opcional : La REGIÓN donde está presente el depósito. Si este distintivo no se proporciona, el programa utilizará la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Control manual de las cargas de varias partes

El IBM Cloud Object Storage CLI proporciona a los usuarios la posibilidad de cargar archivos grandes en varias partes mediante el uso de AWS Funciones de carga multiparte. Para iniciar una nueva carga multiparte, ejecute el multipart-upload-create comando, que devuelve el ID de carga de la nueva instancia de carga. Para continuar con el proceso de carga, debe guardar el ID de carga para cada mandato siguiente. Este mandato requiere que genere un hash MD5:

{object data} | openssl dgst -md5 -binary | openssl enc -base64

Después de ejecutar el mandato multipart-upload-complete, ejecute part-upload para cada parte de archivo que desee cargar. Para cargas de varias partes, cada parte del archivo (excepto la última parte) debe tener al menos 5 MB. Para dividir un archivo en varias partes, puede ejecutar split en una ventana de terminal. Por ejemplo, si tiene un archivo de 13 MB llamado TESTFILE en el escritorio y desea dividirlo en partes de archivo de 5 MB cada una, puede ejecutar split -b 3m ~/Desktop/TESTFILE part-file-. Este mandato genera tres partes del archivo en dos partes de archivo de 5 MB cada una, y una parte de archivo de 3 MB, llamadas part-file-aa, part-file-ab y part-file-ac. As each file part is uploaded, the CLI print its ETag . You must save this ETag into a formatted JSON file, along with the part number. Use this template to create your own Archivo de datos JSON de ETag.

{
    "Parts": [
    {
      "PartNumber": 1,
      "ETag": "The ETag of the first file part goes here."
    },
    {
      "PartNumber": 2,
      "ETag": "The ETag of the second file part goes here."
    }
    ]
}

Añada más entradas a esta plantilla JSON según sea necesario.

Para ver el estado de su instancia de carga multiparte, siempre puede ejecutar el part-list comando, proporcionando el nombre del depósito, la clave y el ID de carga. Esto imprime información sin procesar sobre su instancia de carga multiparte. Una vez que haya completado la carga de cada parte del archivo, ejecute el multipart-upload-complete comando con los parámetros necesarios. Si todo funciona correctamente, recibirá una confirmación de que el archivo se ha cargado correctamente en el grupo deseado.

Carga de una parte

  • Acción: cargar una parte de un archivo en una instancia de carga de varias partes existente.
  • Uso: ibmcloud cos part-upload --bucket BUCKET_NAME --key KEY --upload-id ID --part-number NUMBER [--body FILE_PATH] [--region REGION] [--output FORMAT]
    • Tenga en cuenta que debe guardar el número de cada parte del archivo cargado y ETag (que la CLI imprimirá por usted) para cada parte en un archivo JSON. Consulte la "Guía de carga en varias partes" a continuación para obtener más información.
  • Parámetros que se deben proporcionar:
    • El nombre del grupo donde tiene lugar la carga de varias partes.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • ID de carga que identifica la carga de varias partes.
      • Distintivo: --upload-id ID
    • El número de la parte que se está cargando. Este es un número entero positivo en el rango de 1 a 10.000. (predeterminado: 1)
      • Distintivo: --part-number NUMBER
    • Opcional : Ubicación de los datos del objeto (FILE_PATH ).
      • Distintivo: --body FILE_PATH
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Carga de una copia de una parte

  • Acción: cargar una parte copiando los datos de un objeto existente.
  • Uso: ibmcloud cos part-upload-copy --bucket BUCKET_NAME --key KEY --upload-id ID --part-number NUMBER --copy-source SOURCE [--copy-source-if-match ETAG] [--copy-source-if-modified-since TIMESTAMP] [--copy-source-if-none-match ETAG] [--copy-source-if-unmodified-since TIMESTAMP] [--copy-source-range value] [--region REGION] [--output FORMAT]
    • Tenga en cuenta que debe guardar el número de cada parte del archivo cargado y ETag (que la CLI imprimirá por usted) para cada parte en un archivo JSON. Consulte la "Guía de carga en varias partes" para obtener más información.
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • ID de carga que identifica la carga de varias partes.
      • Distintivo: --upload-id ID
    • El número de la parte que se está cargando. Es un entero positivo comprendido entre 1 y 10.000.
      • Distintivo: --part-number PART_NUMBER
    • (FUENTE) El nombre del depósito de origen y el nombre de clave del objeto de origen, que está separado por una barra diagonal (/). Debe estar codificado en URL.
      • Distintivo: --copy-source SOURCE
    • Opcional : Copia el objeto si su etiqueta de entidad (Etag ) coincide con la etiqueta especificada (ETAG ).
      • Distintivo: --copy-source-if-match ETAG
    • Opcional : Copia el objeto si ha sido modificado desde el momento especificado (TIMESTAMP).
      • Distintivo: --copy-source-if-modified-since TIMESTAMP
    • Opcional : Copia el objeto si su etiqueta de entidad (ETag ) es diferente a la etiqueta especificada (ETAG ).
      • Distintivo: --copy-source-if-none-match ETAG
    • Opcional : Copia el objeto si no ha sido modificado desde el tiempo especificado (TIMESTAMP).
      • Distintivo: --copy-source-if-unmodified-since TIMESTAMP
    • Opcional : El rango de bytes para copiar del objeto de origen. El valor de rango debe utilizar el formato bytes=primero-último, donde el primero y el último son los desplazamientos de byte con base cero que se deben copiar. Por ejemplo, bytes=0-9 indica que desea copiar los diez primeros bytes del origen. Solo puede copiar un rango si el objeto de origen tiene más de 5 MB.
      • Distintivo: --copy-source-range value
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Configuración de bloqueo de objeto

Configuración de bloqueo de objetos de colocación

En los días y años de retención predeterminados no se pueden proporcionar al mismo tiempo.

  • Acción: Establezca la configuración de bloqueo de objetos en un depósito.
  • Uso: object-lock-configuration-put --bucket BUCKET_NAME [--object-lock-configuration STRUCTURE] [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Una ESTRUCTURA que utiliza la sintaxis JSON. Consulte Documentación deIBM Cloud.
      • Distintivo: --object-lock-configuration STRUCTURE

        	{
        	"ObjectLockEnabled": "Enabled",
        	"Rule": {
        		"DefaultRetention": {
        		"Mode": "COMPLIANCE",
        		"Days": integer,
        		"Years": integer
        		}
        	}
        	}
        
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Ejemplo:

ibmcloud cos object-lock-configuration-put --bucket bucket-name --object-lock-configuration '{ "ObjectLockEnabled": "Enabled", "Rule": { "DefaultRetention": { "Mode": "COMPLIANCE", "Days": 30 }}}'

Obtener configuración de bloqueo de objeto

  • Acción: Obtenga la configuración de bloqueo de objetos en un depósito.
  • Uso: object-lock-configuration-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Una ESTRUCTURA que utiliza la sintaxis JSON. Consulte Documentación deIBM Cloud.
      • Distintivo: --object-lock-configuration STRUCTURE

        	{
        	"ObjectLockEnabled": "Enabled",
        	"Rule": {
        		"DefaultRetention": {
        		"Mode": "COMPLIANCE",
        		"Days": integer,
        		"Years": integer
        		}
        	}
        	}
        
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

        	{
        	"ObjectLockEnabled": "Enabled",
        	"Rule": {
        		"DefaultRetention": {
        		"Mode": "COMPLIANCE",
        		"Days": integer,
        		"Years": integer
        		}
        	}
        	}
        

Ejemplo:

ibmcloud cos object-lock-configuration-get --bucket bucket-name --region us-south

Retención de objetos

Retención de objetos de colocación

  • Acción: Establecer retención en un objeto.
  • Uso: object-retention-put --bucket BUCKET_NAME --key KEY [--retention STRUCTURE] [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • Una ESTRUCTURA que utiliza la sintaxis JSON. Consulte Documentación deIBM Cloud.
      • Distintivo: --retention STRUCTURE

        	{
        	  "Mode": "COMPLIANCE",
        	  "RetainUntilDate": timestamp
        	}
        
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Ejemplo:

ibmcloud cos object-retention-put --bucket bucket-name --key file-name.txt --retention '{ "Mode": "COMPLIANCE", "RetainUntilDate": "2024-02-02T00:00:00"}’

Obtener retención de objetos

  • Acción: Obtener retención sobre un objeto.
  • Uso: object-retention-get --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • La clave (KEY) del objeto.
      • Distintivo: --key KEY
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

        	{
        		"Retention": {
        			"Mode": "COMPLIANCE",
        			"RetainUntilDate": "2024-02-02T00:00:00.000Z"
        		}
        	}
        

Ejemplo:

ibmcloud cos object-retention-put --bucket bucket-name --key file-name.txt --region us-south

Configurar réplica de grupo

Configuración para configurar un grupo replicado.

Poner réplica de grupo

  • Acción: Establezca la configuración de replicación en un depósito.
  • Uso: bucket-replication-put --bucket BUCKET_NAME [--replication-configuration STRUCTURE] [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

        	{
        		"Rules": [
        			{
        				"Status": "Enabled",
        				"Priority": 1,
        				"Filter" : { "Prefix": ""},
        				"DeleteMarkerReplication": {
        					"Status": "Disabled"
        				},
        				"Destination": {
        					"Bucket": "DEST-BUCKET-NAME"
        				}
        			}
        		]
        	}
        

Ejemplo:

ibmcloud cos bucket-replication-put --bucket SOURCE-BUCKET-NAME --replication-configuration file://replication.json

Obtener réplica de grupo

  • Acción: Obtenga la configuración de replicación para un depósito.
  • Uso: bucket-replication-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

        	{
        		"ReplicationConfiguration": {
        			"Rules": [
        				{
        					"Status": "Enabled",
        					"Prefix": "",
        					"Destination": {
        						"Bucket": "DEST-BUCKET-NAME",
        						"StorageClass": "STANDARD"
        					},
        				}
        			],
        		}
        	}
        

Ejemplo:

 ibmcloud cos bucket-replication-get --bucket SOURCE-BUCKET-NAME

Suprimir réplica de grupo

  • Acción: Elimine la configuración de replicación de un depósito.
  • Uso: bucket-replication-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
  • Parámetros que se deben proporcionar:
    • El nombre del grupo.
      • Distintivo: --bucket BUCKET_NAME
    • Opcional : La REGIÓN donde está presente el depósito. Si no se especifica este distintivo, el programa utiliza la opción predeterminada especificada en la configuración.
      • Distintivo: --region REGION
    • Opcional : El FORMATO de salida solo puede ser json o texto.
      • Distintivo: --output FORMAT

Ejemplo:

 ibmcloud cos bucket-replication-delete --bucket SOURCE-BUCKET-NAME

Próximos pasos

Como cada procedimiento siempre va exactamente como se ha planificado, es posible que no haya visto ninguno de los códigos de cabecera y error comunes. Para obtener más información, consulte la Referencia de API.