Autenticación de IAM

Si utiliza la autenticación IAM, debe configurar su cliente con un ID de instancia para poder utilizar algunos de los comandos. Para obtener más información sobre cómo crear una instancia de servicio, consulte Creación de una instancia de servicio. Para obtener el ID de la instancia, puede escribir ibmcloud resource service-instance <INSTANCE_NAME> --id, sustituyendo por <INSTANCE_NAME> el alias único que haya asignado a su instancia de servicio. En los siguientes ejemplos, 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.

Descarga los objetos utilizando Aspera

• Acción: Descargar un objeto de un depósito mediante una transferenci Aspera e de alta velocidad.
• Uso: ibmcloud cos aspera-download --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT] [OUTFILE]
• Parámetros que se deben proporcionar:
  • El nombre del grupo.
    • Distintivo: --bucket BUCKET_NAME
  • La CLAVE del objeto que se va a descargar.
    • Distintivo: --key KEY
  • Opcional : la REGIÓN en la que se encuentra 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 : ruta local donde se guarda el archivo descargado. Si no se especifica, el archivo se guarda en la ubicación de descarga predeterminada con el nombre de archivo de la clave del objeto.
    • Argumento: OUTFILE

Ejemplo:

export IBMCLOUD_API_KEY=<your-api-key>
ibmcloud cos aspera-download --bucket my-bucket --key videos/demo.mp4 /tmp/demo.mp4

Sube archivos o directorios utilizando Aspera

• Acción: Subir un archivo o un directorio a un depósito mediante una transferenci Aspera e de alta velocidad.
• Uso: ibmcloud cos aspera-upload --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT] [SRCFILE]
• Parámetros que se deben proporcionar:
  • El nombre del grupo.
    • Distintivo: --bucket BUCKET_NAME
  • La clave (nombre del objeto de destino) en el bucket.
    • Distintivo: --key KEY
  • Opcional : la REGIÓN en la que se encuentra 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 : ruta local del archivo o directorio que se va a subir.
    • Argumento: SRCFILE

Ejemplo:

export IBMCLOUD_API_KEY=<your-api-key>
ibmcloud cos aspera-upload --bucket my-bucket --key videos/demo.mp4 /tmp/demo.mp4

Establecer la configuración del ciclo de vida en un grupo

• Acción: Configurar el ciclo de vida de un depósito.
• Uso: ibmcloud cos bucket-lifecycle-configuration-put --bucket BUCKET_NAME --lifecycle-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. El prefijo file:// se puede utilizar para cargar la estructura JSON desde un archivo, como por ejemplo --lifecycle-configuration file://<filename.json>.

    • Distintivo: --lifecycle-configuration STRUCTURE

      	{
      	  "Rules": [
      	    {
      	      "ID": "string",
      	      "Status": "Enabled"|"Disabled",
      	      "Filter": {
      	        "Prefix": "string"
      	      },
      	      "Expiration": {
      	        "Days": integer,
      	        "Date": "YYYY-MM-DDTHH:mm:ssZ",
      	        "ExpiredObjectDeleteMarker": true|false
      	      },
      	      "Transitions": [
      	        {
      	          "Days": integer,
      	          "Date": "YYYY-MM-DDTHH:mm:ssZ",
      	          "StorageClass": "string"
      	        }
      	      ],
      	      "NoncurrentVersionExpiration": {
      	        "NoncurrentDays": integer
      	      },
      	      "AbortIncompleteMultipartUpload": {
      	        "DaysAfterInitiation": integer
      	      }
      	    }
      	  ]
      	}
      

  • Opcional : la REGIÓN en la que se encuentra 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 — utilizando un archivo:

ibmcloud cos bucket-lifecycle-configuration-put --bucket my-bucket --lifecycle-configuration file://lifecycle.json

Ejemplo — en el texto:

ibmcloud cos bucket-lifecycle-configuration-put \
  --bucket my-bucket \
  --lifecycle-configuration '{
    "Rules": [
      {
        "ID": "expire-noncurrent-versions",
        "Status": "Enabled",
        "Filter": { "Prefix": "" },
        "NoncurrentVersionExpiration": {
          "NoncurrentDays": 30
        }
      },
      {
        "ID": "clean-delete-markers",
        "Status": "Enabled",
        "Filter": { "Prefix": "" },
        "Expiration": {
          "ExpiredObjectDeleteMarker": true
        }
      }
    ]
  }' \
  --region us-south

Obtener la configuración del ciclo de vida de un grupo

• Acción: Obtener la configuración del ciclo de vida de un depósito.
• Uso: ibmcloud cos bucket-lifecycle-configuration-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 en la que se encuentra 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-lifecycle-configuration-get --bucket my-bucket

Suprimir la configuración del ciclo de vida de un grupo

• Acción: Eliminar la configuración del ciclo de vida de un depósito.
• Uso: ibmcloud cos bucket-lifecycle-configuration-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 en la que se encuentra 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-lifecycle-configuration-delete --bucket my-bucket

Poner réplica de grupo

• Acción: Configurar la replicación en un depósito.
• Uso: ibmcloud cos 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 en la que se encuentra 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
  • Una ESTRUCTURA que utiliza la sintaxis JSON.

    • Distintivo: --replication-configuration STRUCTURE

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

Ejemplo — utilizando un archivo:

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

Ejemplo — en el texto:

ibmcloud cos bucket-replication-put --bucket SOURCE-BUCKET-NAME \
  --replication-configuration '{
    "Rules": [
      {
        "Status": "Enabled",
        "Priority": 1,
        "Filter": {},
        "DeleteMarkerReplication": { "Status": "Disabled" },
        "Destination": { "Bucket": "DEST-BUCKET-CRN" }
      }
    ]
  }' \
  --region us-south

Obtener réplica de grupo

• Acción: Obtener la configuración de replicación de un bucket.
• Uso: ibmcloud cos 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 en la que se encuentra 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-get --bucket SOURCE-BUCKET-NAME

Suprimir réplica de grupo

• Acción: Eliminar la configuración de replicación de un bucket.
• Uso: ibmcloud cos 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 en la que se encuentra 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

Enumerar los errores de replicación de un bucket

• Acción: Enumerar los errores de replicación de un depósito.
• Uso: ibmcloud cos bucket-replication-failures --bucket BUCKET_NAME [--starting-token TOKEN] [--encoding-type METHOD] [--first-sync-attempted-before TIMESTAMP] [--max-keys NUMBER] [--region REGION] [--output FORMAT]
• Parámetros que se deben proporcionar:
  • El nombre del grupo.
    • Distintivo: --bucket BUCKET_NAME
  • Opcional : un TOKEN que se utiliza para especificar dónde debe comenzar la siguiente página de resultados.
    • Distintivo: --starting-token TOKEN
  • Opcional : Solicita que se codifiquen las claves de los objetos en la respuesta y especifica el MÉTODO de codificación que se debe utilizar.
    • Distintivo: --encoding-type METHOD
  • Opcional : Filtra los resultados para incluir únicamente los fallos en los que se intentó la primera sincronización antes de la marca de tiempo indicada (formato ISO 8601).
    • Distintivo: --first-sync-attempted-before TIMESTAMP
  • Opcional : el NÚMERO máximo de claves que se van a devolver.
    • Distintivo: --max-keys NUMBER
  • Opcional : la REGIÓN en la que se encuentra 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-failures --bucket my-bucket

Volver a intentar la replicación de los objetos que han fallado en un depósito

• Acción: volver a intentar la replicación de los objetos que han fallado en un depósito.
• Uso: ibmcloud cos bucket-replication-reattempt --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 en la que se encuentra 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-reattempt --bucket my-bucket

Establecer la configuración del mantenimiento de versiones en un grupo

• Acción: Configurar el control de versiones en un depósito.
• Uso: ibmcloud cos bucket-versioning-put --bucket BUCKET_NAME --versioning-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 para especificar el estado de control de versiones. Los valores válidos para Status son Enabled y Suspended.

    • Distintivo: --versioning-configuration STRUCTURE

      	{
      	  "Status": "Enabled"|"Suspended"
      	}
      

  • Opcional : la REGIÓN en la que se encuentra 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-versioning-put --bucket my-bucket --versioning-configuration '{"Status": "Enabled"}'

Obtener la configuración del mantenimiento de versiones de un grupo

• Acción: Obtener la configuración de control de versiones de un depósito.
• Uso: ibmcloud cos bucket-versioning-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 en la que se encuentra 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-versioning-get --bucket my-bucket

Crea un nuevo depósito con Key Protect

• Acción: Crear un bucket con Key Protect en una instancia de IBM Cloud Object Storage.
• Uso: ibmcloud cos 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 va a asociar al depósito para el cifrado de datos.
    • Distintivo: --kms-root-key-crn CUSTOMERROOTKEYCRN
  • Opcional : el ALGORITMO y el TAMAÑO que se deben utilizar con la clave de cifrado almacenada mediante Key Protect.
    • Distintivo: --kms-encryption-algorithm ALGORITHM
  • Opcional : el nombre de la clase.
    • Distintivo: --class CLASS_NAME
  • Opcional : Establece el ID de la instancia del servicio IBM en la solicitud.
    • Distintivo: --ibm-service-instance-id ID
  • Opcional : la REGIÓN en la que se encuentra 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
  • (Obsoleto): Resultado devuelto en formato JSON sin procesar.
    • 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: ibmcloud cos 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 va a asociar al depósito para el cifrado de datos.
    • Distintivo: --kms-root-key-crn CUSTOMERROOTKEYCRN
  • Opcional : el ALGORITMO y el TAMAÑO que se deben utilizar con la clave de cifrado almacenada mediante Key Protect.
    • Distintivo: --kms-encryption-algorithm ALGORITHM
  • Opcional : el nombre de la clase.
    • Distintivo: --class CLASS_NAME
  • Opcional : Establece el ID de la instancia del servicio IBM en la solicitud.
    • Distintivo: --ibm-service-instance-id ID
  • Opcional : la REGIÓN en la que se encuentra 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
  • (Obsoleto): Resultado devuelto en formato JSON sin procesar.
    • 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

Descarga los objetos utilizando 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 deben iniciar en paralelo por cada llamada de descarga al enviar partes. El valor predeterminado es 5.
    • Distintivo: --concurrency value
  • Opcional : el TAMAÑO del búfer (en bytes) que se utilizará al almacenar datos en bloques y enviarlos como partes a S3. El tamaño mínimo de parte permitido es 5 MB.
    • Distintivo: --part-size SIZE
  • Opcional : Devuelve el objeto solo si su etiqueta de entidad (ETag) coincide con la ETAG especificada; en caso contrario, devuelve un 412 (condición previa no cumplida).
    • Distintivo: --if-match ETAG
  • Opcional : Devuelve el objeto solo si se ha modificado desde el TIMESTAMP especificado; de lo contrario, devuelve un 304 (no modificado).
    • Distintivo: --if-modified-since TIMESTAMP
  • Opcional : Devuelve el objeto solo si su etiqueta de entidad (ETag) es diferente de la especificada ETAG ; en caso contrario, devuelve un 304 (no modificado).
    • Distintivo: --if-none-match ETAG
  • Opcional : Devuelve el objeto solo si no se ha modificado desde el TIMESTAMP especificado; de lo contrario, devuelve un 412 (condición previa no cumplida).
    • Distintivo: --if-unmodified-since TIMESTAMP
  • Opcional : descarga los bytes especificados en RANGE de un objeto. Para obtener más información sobre el encabezado HTTP Range, consulta la especificación del encabezado HTTP Range.
    • Distintivo: --range RANGE
  • Opcional : Establece el encabezado Cache-Control de la respuesta.
    • Distintivo: --response-cache-control HEADER
  • Opcional : Establece el encabezado Content-Disposition de la respuesta.
    • Distintivo: --response-content-disposition HEADER
  • Opcional : Establece el encabezado Content-Encoding de la respuesta.
    • Distintivo: --response-content-encoding HEADER
  • Opcional : Establece el encabezado Content-Language de la respuesta.
    • Distintivo: --response-content-language HEADER
  • Opcional : Establece el encabezado Content-Type de la respuesta.
    • Distintivo: --response-content-type HEADER
  • Opcional : Establece el encabezado Expires de la respuesta.
    • Distintivo: --response-expires HEADER
  • Opcional : la REGIÓN en la que se encuentra 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

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 ID de la instancia del servicio IBM en la solicitud.
    • Distintivo: --ibm-service-instance-id
  • Opcional : especifica la clave con la que se debe comenzar al enumerar los objetos de un depósito.
    • Distintivo: --marker KEY
  • Opcional : Limita la respuesta a las claves que comienzan por el PREFIX especificado.
    • Distintivo: --prefix PREFIX
  • Opcional : el TAMAÑO de cada página que se incluirá en la solicitud 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 mostrarán en el resultado comando comando.
    • Distintivo: --max-items NUMBER
  • Opcional : el FORMATO de salida solo puede ser json o texto.
    • Distintivo: --output FORMAT

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]
  • Ten en cuenta que debes guardar el número de cada parte del archivo subido y ( ETag que la CLI te mostrará) 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. Se trata de un número entero positivo comprendido entre 1 y 10 000. (valor por defecto: 1)
    • Distintivo: --part-number NUMBER
  • Opcional : Ubicación de los datos del objeto (FILE_PATH).
    • Distintivo: --body FILE_PATH
  • Opcional : la REGIÓN en la que se encuentra 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]
  • Ten en cuenta que debes guardar el número de cada parte del archivo subido y ( ETag que la CLI te mostrará) 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 la clave del objeto de origen, separados por una barra (/). Debe estar codificado segun 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 la hora especificada (TIMESTAMP).
    • Distintivo: --copy-source-if-modified-since TIMESTAMP
  • Opcional : copia el objeto si su etiqueta de entidad (ETag) es diferente de la etiqueta especificada (ETAG).
    • Distintivo: --copy-source-if-none-match ETAG
  • Opcional : copia el objeto si no se ha modificado desde la hora especificada (TIMESTAMP).
    • Distintivo: --copy-source-if-unmodified-since TIMESTAMP
  • Opcional : El rango de bytes que se van a 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 en la que se encuentra 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

Poner retención legal de objeto

• Acción: Establecer la retención legal de un objeto.
• Uso: ibmcloud cos object-legal-hold-put --bucket BUCKET_NAME --key KEY [--legal-hold 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: --legalhold STRUCTURE

      	{
      	   "Status": "ON"|"OFF"
      	}
      

  • Opcional : la REGIÓN en la que se encuentra 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-legal-hold-put --bucket bucket-name --key file-name.txt --legal-hold '{"Status": "ON"}'

Obtener retención legal de objeto

• Acción: Aplicar una retención legal a un objeto.
• Uso: ibmcloud cos object-legal-hold-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 en la que se encuentra 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-legal-hold-get --bucket bucket-name --key file-name.txt --region us-south

Respuesta de ejemplo:

{
	"LegalHold": {
		"Status": "ON"
	}
}

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: Establecer la configuración de bloqueo de objetos en un depósito.
• Uso: ibmcloud cos 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 en la que se encuentra 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: Obtener la configuración del bloqueo de objetos en un bucket.
• Uso: ibmcloud cos 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
  • Opcional : la REGIÓN en la que se encuentra 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-get --bucket bucket-name --region us-south

Respuesta de ejemplo:

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

Retención de objetos de colocación

• Acción: Establecer la retención de un objeto.
• Uso: ibmcloud cos 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 en la que se encuentra 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 información sobre la retención de un objeto.
• Uso: ibmcloud cos 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 en la que se encuentra 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-get --bucket bucket-name --key file-name.txt --region us-south

Respuesta de ejemplo:

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

Establecer etiquetas en un objeto

• Acción: Asignar etiquetas a un objeto.
• Uso: ibmcloud cos object-tagging-put --bucket BUCKET_NAME --key KEY --tagging STRUCTURE [--version-id VERSION_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

  • Una ESTRUCTURA que utiliza la sintaxis JSON y contiene el conjunto de etiquetas. El prefijo file:// se puede utilizar para cargar la estructura JSON desde un archivo, como por ejemplo --tagging file://<filename.json>.

    • Distintivo: --tagging STRUCTURE

      	{
      	  "TagSet": [
      	    {
      	      "Key": "string",
      	      "Value": "string"
      	    }
      	  ]
      	}
      

  • Opcional : el VERSION_ID del objeto que se va a etiquetar. Si no se especifica lo contrario, se indica la versión actual.

    • Distintivo: --version-id VERSION_ID

  • Opcional : la REGIÓN en la que se encuentra 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-tagging-put --bucket my-bucket --key my-object.txt --tagging '{"TagSet": [{"Key": "env", "Value": "production"}]}'

Obtener etiquetas para un objeto

• Acción: Obtener etiquetas para un objeto.
• Uso: ibmcloud cos object-tagging-get --bucket BUCKET_NAME --key KEY [--version-id VERSION_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
  • Opcional : el VERSION_ID de la versión específica del objeto para la que se desean recuperar las etiquetas.
    • Distintivo: --version-id VERSION_ID
  • Opcional : la REGIÓN en la que se encuentra 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-tagging-get --bucket my-bucket --key my-object.txt

Eliminar etiquetas de un objeto

• Acción: Eliminar etiquetas de un objeto.
• Uso: ibmcloud cos object-tagging-delete --bucket BUCKET_NAME --key KEY [--version-id VERSION_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
  • Opcional : el VERSION_ID de la versión específica del objeto del que se van a eliminar las etiquetas.
    • Distintivo: --version-id VERSION_ID
  • Opcional : la REGIÓN en la que se encuentra 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-tagging-delete --bucket my-bucket --key my-object.txt

Establecer la configuración del bloqueo de acceso público en un grupo

• Acción: Configurar el bloqueo de acceso público en un depósito.
• Uso: ibmcloud cos public-access-block-put --bucket BUCKET_NAME --public-access-block-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. El prefijo file:// se puede utilizar para cargar la estructura JSON desde un archivo, como por ejemplo --public-access-block-configuration file://<filename.json>.

    • Distintivo: --public-access-block-configuration STRUCTURE

      	{
      	  "BlockPublicAcls": true|false,
      	  "IgnorePublicAcls": true|false,
      	  "BlockPublicPolicy": true|false,
      	  "RestrictPublicBuckets": true|false
      	}
      

  • Opcional : la REGIÓN en la que se encuentra 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 public-access-block-put --bucket my-bucket --public-access-block-configuration '{"BlockPublicAcls": true, "IgnorePublicAcls": true, "BlockPublicPolicy": true, "RestrictPublicBuckets": true}'

Obtener la configuración del bloqueo de acceso público en un grupo

• Acción: Obtener la configuración del bloque de acceso público en un bucket.
• Uso: ibmcloud cos public-access-block-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 en la que se encuentra 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 public-access-block-get --bucket my-bucket

Eliminar la configuración de bloqueo de acceso público de un grupo

• Acción: Eliminar la configuración de bloqueo de acceso público de un depósito.
• Uso: ibmcloud cos public-access-block-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 en la que se encuentra 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 public-access-block-delete --bucket my-bucket

Carga objetos utilizando 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 deben ejecutar en paralelo por cada llamada a Upload al enviar partes. El valor predeterminado es 5.

    • Distintivo: --concurrency value

  • Opcional : número máximo de PARTES que se subirán a S3, que calcula el tamaño de cada parte del objeto que se va a subir. 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 bloques y enviarlos como partes a S3. El tamaño mínimo de parte permitido es 5 MB.

    • Distintivo: --part-size SIZE

  • Opcional : si se establece este valor en true, el SDK evitará llamar a AbortMultipartUpload en caso de error, dejando todas las partes cargadas correctamente en S3 para su 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 sobre la presentación (DIRECTRICES).

    • Distintivo: --content-disposition DIRECTIVES

  • Opcional : especifica qué codificaciones de contenido (CONTENT_ENCODING) se han aplicado al objeto y, por lo tanto, qué mecanismos de decodificación deben aplicarse 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 está redactado 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 resumen de los datos en formato MD5 de 128 bits de la base64-encoded.

    • Distintivo: --content-md5 MD5

  • Opcional : un tipo MIME estándar que describa el formato de los datos del objeto.

    • Distintivo: --content-type MIME

  • Opcional : un mapa de metadatos que se van a almacenar. El prefijo file:// se puede utilizar para cargar la estructura JSON desde un archivo.

    • Distintivo: --metadata MAP

      	{
      		"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 en la que se encuentra 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

bucket-exists

• Acción: Esperar hasta recibir una respuesta 200 al realizar una consulta con head-bucket.
• Uso: ibmcloud cos wait bucket-exists --bucket BUCKET_NAME [--region REGION]
• Parámetros que se deben proporcionar:
  • El nombre del grupo.
    • Distintivo: --bucket BUCKET_NAME
  • Opcional : la REGIÓN en la que se encuentra el depósito.
    • Distintivo: --region REGION

Ejemplo:

ibmcloud cos wait bucket-exists --bucket my-bucket

bucket-not-exists

• Acción: Esperar hasta recibir una respuesta 404 al realizar la consulta con head-bucket.
• Uso: ibmcloud cos wait bucket-not-exists --bucket BUCKET_NAME [--region REGION]
• Parámetros que se deben proporcionar:
  • El nombre del grupo.
    • Distintivo: --bucket BUCKET_NAME
  • Opcional : la REGIÓN en la que se encuentra el depósito.
    • Distintivo: --region REGION

Ejemplo:

ibmcloud cos wait bucket-not-exists --bucket my-bucket

objeto-existe

• Acción: Esperar hasta recibir una respuesta 200 al realizar una consulta con head-object.
• Uso: ibmcloud cos wait object-exists --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--part-number NUMBER] [--region REGION]
• 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 solo si su etiqueta de entidad (ETag) coincide con el ETAG proporcionado.
    • Distintivo: --if-match ETAG
  • Opcional : Devuelve el objeto solo si se ha modificado desde la marca de tiempo (TIMESTAMP) especificada.
    • Distintivo: --if-modified-since TIMESTAMP
  • Opcional : Devuelve el objeto solo si su ETag no coincide con el ETAG proporcionado.
    • Distintivo: --if-none-match ETAG
  • Opcional : Devuelve el objeto solo si no se ha modificado desde el TIMESTAMP especificado.
    • Distintivo: --if-unmodified-since TIMESTAMP
  • Opcional : Descarga el RANGO de bytes especificado de un objeto.
    • Distintivo: --range RANGE
  • Opcional : NÚMERO de pieza del objeto que se está leyendo.
    • Distintivo: --part-number NUMBER
  • Opcional : la REGIÓN en la que se encuentra el depósito.
    • Distintivo: --region REGION

Ejemplo:

ibmcloud cos wait object-exists --bucket my-bucket --key my-object.txt

el objeto no existe

• Acción: Esperar hasta recibir una respuesta 404 al realizar la consulta con head-object.
• Uso: ibmcloud cos wait object-not-exists --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--part-number NUMBER] [--region REGION]
• 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 solo si su etiqueta de entidad (ETag) coincide con el ETAG proporcionado.
    • Distintivo: --if-match ETAG
  • Opcional : Devuelve el objeto solo si se ha modificado desde la marca de tiempo (TIMESTAMP) especificada.
    • Distintivo: --if-modified-since TIMESTAMP
  • Opcional : Devuelve el objeto solo si su ETag no coincide con el ETAG proporcionado.
    • Distintivo: --if-none-match ETAG
  • Opcional : Devuelve el objeto solo si no se ha modificado desde el TIMESTAMP especificado.
    • Distintivo: --if-unmodified-since TIMESTAMP
  • Opcional : Descarga el RANGO de bytes especificado de un objeto.
    • Distintivo: --range RANGE
  • Opcional : NÚMERO de pieza del objeto que se está leyendo.
    • Distintivo: --part-number NUMBER
  • Opcional : la REGIÓN en la que se encuentra el depósito.
    • Distintivo: --region REGION

Ejemplo:

ibmcloud cos wait object-not-exists --bucket my-bucket --key my-object.txt