Autenticazione IAM

Se si utilizza l'autenticazione IAM, è necessario configurare il client specificando un ID istanza per poter utilizzare alcuni comandi. Per ulteriori informazioni sulla creazione di un'istanza di servizio, vedere Creazione di un'istanza di servizio. Per recuperare l'ID dell'istanza, puoi digitare ibmcloud resource service-instance <INSTANCE_NAME> --id, sostituendo <INSTANCE_NAME> con l'alias univoco che hai assegnato alla tua istanza del servizio. Negli esempi seguenti, il valore “ 8f275e7b-c076-49e2-b9c5-f985704cf678 ” rappresenta un ID di istanza di esempio.

Per prima cosa, richiama il CRN e l'ID con il nome della tua istanza. Assicurati di utilizzare le virgolette (') nel tuo nome istanza e di aver eseguito l'accesso a IBM Cloud. È necessaria solo l'ultima parte del CRN, la parte dopo ::.

$ 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

Impostare CRN con il comando ibmcloud cos config crn. Potrebbe avvisarti della sovrascrittura. Se non vuoi fornire il CRN in modo interattivo, puoi fornirlo nello stesso comando con l'indicatore --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.

Verifica la configurazione:

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

In alternativa, puoi utilizzare la console basata su web, selezionare Credenziali del servizio nella barra laterale e creare una nuova serie di credenziali (o visualizzare un file di credenziali esistente che hai già creato).

Credenziali HMAC

Se si preferisce, è possibile utilizzare le credenziali HMAC di un ID servizio anziché la chiave API. Esegui ibmcloud cos config hmac per immettere le credenziali HMAC, quindi cambia il metodo di autenticazione utilizzando ibmcloud cos config auth.

Se scegli di utilizzare l'autenticazione tramite token con la tua propria chiave API, non hai bisogno di fornire le credenziali poiché il programma ti autentica automaticamente.

In qualsiasi momento, per passare tra l'autenticazione HMAC e IAM, puoi immettere ibmcloud cos config auth. Per ulteriori informazioni sull'autenticazione e l'autorizzazione in IBM Cloud, consulta la documentazione diIdentity and Access Management.

Scarica gli oggetti utilizzando Aspera

• Azione: scaricare un oggetto da un bucket utilizzando un trasferimento ad alta velocità Aspera.
• Istruzioni per l'uso: ibmcloud cos aspera-download --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT] [OUTFILE]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto da scaricare.
    • Indicatore: --key KEY
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT
  • Facoltativo : percorso locale in cui viene salvato il file scaricato. Se non specificato, il file viene salvato nella cartella predefinita per i download con il nome del file corrispondente alla chiave dell'oggetto.
    • Argomento: OUTFILE

Esempio:

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

Carica file o cartelle utilizzando Aspera

• Azione: caricare un file o una cartella in un bucket tramite un trasferimento ad alta velocità Aspera.
• Istruzioni per l'uso: ibmcloud cos aspera-upload --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT] [SRCFILE]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La chiave (nome dell'oggetto di destinazione) nel bucket.
    • Indicatore: --key KEY
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT
  • Facoltativo : percorso locale del file o della cartella da caricare.
    • Argomento: SRCFILE

Esempio:

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

Impostare la configurazione del ciclo di vita su un bucket

• Azione: impostare la configurazione del ciclo di vita di un bucket.
• Istruzioni per l'uso: ibmcloud cos bucket-lifecycle-configuration-put --bucket BUCKET_NAME --lifecycle-configuration STRUCTURE [--region REGION] [--output FORMAT]
• Parametri da fornire:

  • Il nome del bucket.

    • Indicatore: --bucket BUCKET_NAME

  • Una STRUTTURA che utilizza la sintassi JSON. Il prefisso file:// può essere utilizzato per caricare la struttura JSON da un file, ad esempio --lifecycle-configuration file://<filename.json>.

    • Indicatore: --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
      	      }
      	    }
      	  ]
      	}
      

  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.

    • Indicatore: --region REGION

  • Opzionale : il FORMATO di output può essere solo json o testo.

    • Indicatore: --output FORMAT

Esempio — utilizzo di un file:

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

Esempio — inline:

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

Richiamare la configurazione del ciclo di vita per un bucket

• Azione: recuperare la configurazione del ciclo di vita di un bucket.
• Istruzioni per l'uso: ibmcloud cos bucket-lifecycle-configuration-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos bucket-lifecycle-configuration-get --bucket my-bucket

Eliminare la configurazione del ciclo di vita da un bucket

• Azione: eliminare la configurazione del ciclo di vita da un bucket.
• Istruzioni per l'uso: ibmcloud cos bucket-lifecycle-configuration-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos bucket-lifecycle-configuration-delete --bucket my-bucket

Replica bucket di inserimento

• Azione: impostare la configurazione della replica su un bucket.
• Istruzioni per l'uso: ibmcloud cos bucket-replication-put --bucket BUCKET_NAME --replication-configuration STRUCTURE [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT
  • Una STRUTTURA che utilizza la sintassi JSON.

    • Indicatore: --replication-configuration STRUCTURE

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

Esempio — utilizzo di un file:

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

Esempio — inline:

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

Richiama replica bucket

• Azione: recuperare la configurazione di replica di un bucket.
• Istruzioni per l'uso: ibmcloud cos bucket-replication-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

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

Elimina replica bucket

• Azione: eliminare la configurazione di replica da un bucket.
• Istruzioni per l'uso: ibmcloud cos bucket-replication-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

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

Elenca gli errori di replica relativi a un bucket

• Azione: Elenca gli errori di replica relativi a un bucket.
• Istruzioni per l'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]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : un TOKEN utilizzato per specificare da dove iniziare la pagina successiva dei risultati.
    • Indicatore: --starting-token TOKEN
  • Facoltativo : richiede la codifica delle chiavi degli oggetti nella risposta e specifica il METODO di codifica da utilizzare.
    • Indicatore: --encoding-type METHOD
  • Opzionale : filtra i risultati in modo da includere solo gli errori per cui il primo tentativo di sincronizzazione è stato effettuato prima del TIMESTAMP specificato (formato ISO 8601).
    • Indicatore: --first-sync-attempted-before TIMESTAMP
  • Facoltativo : il NUMERO massimo di chiavi da restituire.
    • Indicatore: --max-keys NUMBER
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos bucket-replication-failures --bucket my-bucket

Riprovare la replica per gli oggetti non replicati correttamente in un bucket

• Azione: riprovare la replica degli oggetti per cui si è verificato un errore in un bucket.
• Istruzioni per l'uso: ibmcloud cos bucket-replication-reattempt --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos bucket-replication-reattempt --bucket my-bucket

Impostare la configurazione di gestione versioni su un bucket

• Azione: impostare la configurazione della gestione delle versioni su un bucket.
• Istruzioni per l'uso: ibmcloud cos bucket-versioning-put --bucket BUCKET_NAME --versioning-configuration STRUCTURE [--region REGION] [--output FORMAT]
• Parametri da fornire:

  • Il nome del bucket.

    • Indicatore: --bucket BUCKET_NAME

  • Una STRUTTURA che utilizza la sintassi JSON per specificare lo stato di versione. I valori validi per Status sono Enabled e Suspended``.

    • Indicatore: --versioning-configuration STRUCTURE

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

  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.

    • Indicatore: --region REGION

  • Opzionale : il FORMATO di output può essere solo json o testo.

    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos bucket-versioning-put --bucket my-bucket --versioning-configuration '{"Status": "Enabled"}'

Ottenere la configurazione di gestione versioni per un bucket

• Azione: recuperare la configurazione delle versioni di un bucket.
• Istruzioni per l'uso: ibmcloud cos bucket-versioning-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos bucket-versioning-get --bucket my-bucket

Crea un nuovo bucket con Key Protect

• Azione: creare un bucket con l' Key Protect e in un'istanza di IBM Cloud Object Storage.
• Istruzioni per l'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]
  • Tieni presente che se stai utilizzando l'autenticazione IAM devi fornire un CRN. Questo può essere impostato utilizzando il comando ibmcloud cos config crn.
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Il CUSTOMERROOTKEYCRN della chiave radice KMS da associare al bucket per la crittografia dei dati.
    • Indicatore: --kms-root-key-crn CUSTOMERROOTKEYCRN
  • Facoltativo : l'ALGORITMO e la DIMENSIONE da utilizzare con la chiave di crittografia salvata tramite la funzione di protezione delle chiavi.
    • Indicatore: --kms-encryption-algorithm ALGORITHM
  • Facoltativo : il nome della classe.
    • Indicatore: --class CLASS_NAME
  • Facoltativo : imposta l'ID dell'istanza del servizio " IBM " nella richiesta.
    • Indicatore: --ibm-service-instance-id ID
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT
  • (Obsoleto): Risultato restituito in formato JSON non elaborato.
    • Indicatore: --json

Esempio:

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

Crea un nuovo bucket con Hyper Protect Crypto Services

• Azione Crea un nuovo bucket con Hyper Protect Crypto Services.
• Istruzioni per l'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]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Il CUSTOMERROOTKEYCRN della chiave radice KMS da associare al bucket per la crittografia dei dati.
    • Indicatore: --kms-root-key-crn CUSTOMERROOTKEYCRN
  • Facoltativo : l'ALGORITMO e la DIMENSIONE da utilizzare con la chiave di crittografia salvata tramite la funzione di protezione delle chiavi.
    • Indicatore: --kms-encryption-algorithm ALGORITHM
  • Facoltativo : il nome della classe.
    • Indicatore: --class CLASS_NAME
  • Facoltativo : imposta l'ID dell'istanza del servizio " IBM " nella richiesta.
    • Indicatore: --ibm-service-instance-id ID
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT
  • (Obsoleto): Risultato restituito in formato JSON non elaborato.
    • Indicatore: --json

Esempio:

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

Scarica gli oggetti utilizzando S3Manager

• Azione: scarica gli oggetti da S3 contemporaneamente.
• Istruzioni per l'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]
• Parametri da fornire:
  • Il nome (BUCKET_NAME) del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto.
    • Indicatore: --key KEY
  • Opzionale : il numero di routine "go" da avviare in parallelo per ogni chiamata di download durante l'invio di parti. Il valore predefinito è 5.
    • Indicatore: --concurrency value
  • Facoltativo : la DIMENSIONE del buffer (in byte) da utilizzare quando si memorizzano i dati in blocchi e li si inviano come parti all'indirizzo S3. La dimensione minima consentita per la parte è 5 MB.
    • Indicatore: --part-size SIZE
  • Opzionale : restituisce l'oggetto solo se il suo tag di entità (ETag) corrisponde all' ETAG specificato; in caso contrario, restituisce un codice di stato 412 (precondizione non soddisfatta).
    • Indicatore: --if-match ETAG
  • Opzionale : restituisce l'oggetto solo se è stato modificato dopo il TIMESTAMP specificato; in caso contrario, restituisce un codice di stato 304 (non modificato).
    • Indicatore: --if-modified-since TIMESTAMP
  • Opzionale : restituisce l'oggetto solo se il suo tag entità (ETag) è diverso dall' ETAG specificato; in caso contrario, restituisce un codice di stato 304 (non modificato).
    • Indicatore: --if-none-match ETAG
  • Opzionale : restituisce l'oggetto solo se non è stato modificato dal TIMESTAMP specificato; in caso contrario, restituisce un codice di errore 412 (precondizione non soddisfatta).
    • Indicatore: --if-unmodified-since TIMESTAMP
  • Opzionale : scarica i byte specificati nell'INTERVALLO di un oggetto. Per ulteriori informazioni sull'intestazione " HTTP ", consultare la specifica relativa all'intestazione " HTTP ".
    • Indicatore: --range RANGE
  • Opzionale : imposta l'intestazione Cache-Control della risposta.
    • Indicatore: --response-cache-control HEADER
  • Opzionale : imposta l'intestazione Content-Disposition della risposta.
    • Indicatore: --response-content-disposition HEADER
  • Opzionale : imposta l'intestazione Content-Encoding della risposta.
    • Indicatore: --response-content-encoding HEADER
  • Opzionale : imposta l'intestazione Content-Language della risposta.
    • Indicatore: --response-content-language HEADER
  • Opzionale : imposta l'intestazione Content-Type della risposta.
    • Indicatore: --response-content-type HEADER
  • Opzionale : imposta l'intestazione Expires della risposta.
    • Indicatore: --response-expires HEADER
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizzerà l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT
  • Facoltativo : la posizione in cui salvare il contenuto dell'oggetto. Se questo parametro non viene fornito, il programma utilizza l'ubicazione predefinita.
    • Parametro: OUTFILE

Elenco bucket esteso

• Azione: stampa un elenco di tutti i bucket nell'account IBM Cloud Object Storage di un utente. I bucket potrebbero trovarsi in regioni diverse.
• Istruzioni per l'uso: ibmcloud cos buckets-extended [--ibm-service-instance-id ID] [--marker KEY] [--prefix PREFIX] [--page-size SIZE] [--max-items NUMBER] [--output FORMAT]
  • Tieni presente che se stai utilizzando l'autenticazione IAM devi fornire un CRN. Questo può essere impostato utilizzando il comando ibmcloud cos config crn.
• Parametri da fornire:
  • Nessun parametro da fornire.
  • Facoltativo : imposta l'ID dell'istanza del servizio " IBM " nella richiesta.
    • Indicatore: --ibm-service-instance-id
  • Facoltativo : specifica la CHIAVE da cui partire per elencare gli oggetti in un bucket.
    • Indicatore: --marker KEY
  • Opzionale : limita la risposta ai tasti che iniziano con il PREFIX specificato.
    • Indicatore: --prefix PREFIX
  • Facoltativo : la DIMENSIONE di ciascuna pagina da ricevere durante l'intervento di assistenza. Questa non influisce sul numero di elementi restituiti nell'output del comando. L'impostazione di una dimensione di pagina inferiore comporta più chiamate al servizio, recuperando meno elementi in ciascuna chiamata. Questo può aiutare a prevenire il timeout delle chiamate al servizio.
    • Indicatore: --page-size SIZE
  • Facoltativo : il NUMERO totale di elementi da restituire nell'output del comando.
    • Indicatore: --max-items NUMBER
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Caricare una parte

• Azione: carica un parte di un file in un'istanza di caricamento in più parti esistente.
• Istruzioni per l'uso: ibmcloud cos part-upload --bucket BUCKET_NAME --key KEY --upload-id ID --part-number NUMBER [--body FILE_PATH] [--region REGION] [--output FORMAT]
  • Si noti che è necessario salvare in un file JSON il numero e l' ETag (che la CLI visualizzerà automaticamente) di ciascuna parte del file caricato. Per ulteriori informazioni, fai riferimento alla "Guida al caricamento in più parti" riportata di seguito.
• Parametri da fornire:
  • Il nome del bucket in cui sta avvenendo il caricamento in più parti.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto.
    • Indicatore: --key KEY
  • ID di caricamento che identifica il caricamento in più parti.
    • Indicatore: --upload-id ID
  • NUMERO di parte della parte che viene caricata. Si tratta di un numero intero positivo compreso tra 1 e 10.000. (valore predefinito: 1)
    • Indicatore: --part-number NUMBER
  • Facoltativo : posizione dei dati dell'oggetto (FILE_PATH).
    • Indicatore: --body FILE_PATH
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Carica una copia della parte

• Azione: carica una parte copiando i dati da un oggetto esistente.
• Istruzioni per l'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]
  • Si noti che è necessario salvare in un file JSON il numero e l' ETag (che la CLI visualizzerà automaticamente) di ciascuna parte del file caricato. Per ulteriori informazioni, fai riferimento alla "Guida al caricamento in più parti".
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto.
    • Indicatore: --key KEY
  • ID di caricamento che identifica il caricamento in più parti.
    • Indicatore: --upload-id ID
  • NUMERO di parte della parte che viene caricata. Questo è un numero intero positivo compreso tra 1 e 10.000.
    • Indicatore: --part-number PART_NUMBER
  • (FONTE) Il nome del bucket di origine e il nome della chiave dell'oggetto di origine, separati da una barra (/). Devono essere codificati secondo lo standard " URL ".
    • Indicatore: --copy-source SOURCE
  • Opzionale : copia l'oggetto se il suo tag di entità (Etag) corrisponde al tag specificato (ETAG).
    • Indicatore: --copy-source-if-match ETAG
  • Opzionale : copia l'oggetto se è stato modificato dopo l'ora specificata (TIMESTAMP).
    • Indicatore: --copy-source-if-modified-since TIMESTAMP
  • Opzionale : copia l'oggetto se il suo tag di entità (ETag) è diverso dal tag specificato (ETAG).
    • Indicatore: --copy-source-if-none-match ETAG
  • Opzionale : copia l'oggetto se non è stato modificato dal momento specificato (TIMESTAMP).
    • Indicatore: --copy-source-if-unmodified-since TIMESTAMP
  • Facoltativo : l'intervallo di byte da copiare dall'oggetto di origine. Il valore dell'intervallo deve utilizzare il formato bytes=first-last, dove il primo e l'ultimo sono gli offset di byte in base zero da copiare. Ad esempio, bytes=0-9 indica che vuoi copiare i primi dieci byte dell'origine. Puoi copiare un intervallo solo se l'oggetto di origine è maggiore di 5 MB.
    • Indicatore: --copy-source-range value
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Metti oggetto in attesa legale

• Azione: impostare il blocco legale su un oggetto.
• Istruzioni per l'uso: ibmcloud cos object-legal-hold-put --bucket BUCKET_NAME --key KEY [--legal-hold STRUCTURE] [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto.
    • Indicatore: --key KEY
  • Una STRUTTURA che utilizza la sintassi JSON. Vedi la documentazione diIBM Cloud.

    • Indicatore: --legalhold STRUCTURE

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

  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos object-legal-hold-put --bucket bucket-name --key file-name.txt --legal-hold '{"Status": "ON"}'

Acquisisci blocco legale oggetto

• Azione: applicare il blocco legale a un oggetto.
• Istruzioni per l'uso: ibmcloud cos object-legal-hold-get --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto.
    • Indicatore: --key KEY
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos object-legal-hold-get --bucket bucket-name --key file-name.txt --region us-south

Risposta di esempio:

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

Configurazione blocco oggetto di inserimento

In giorni e anni di conservazione predefiniti non possono essere forniti contemporaneamente.

• Azione: imposta la configurazione del blocco degli oggetti su un bucket.
• Istruzioni per l'uso: ibmcloud cos object-lock-configuration-put --bucket BUCKET_NAME [--object-lock-configuration STRUCTURE] [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Una STRUTTURA che utilizza la sintassi JSON. Vedi la documentazione diIBM Cloud.

    • Indicatore: --object-lock-configuration STRUCTURE

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

  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

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

Ottieni configurazione blocco oggetto

• Azione: recuperare la configurazione del blocco degli oggetti su un bucket.
• Istruzioni per l'uso: ibmcloud cos object-lock-configuration-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

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

Risposta di esempio:

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

Conservazione oggetti di inserimento

• Azione: impostare il periodo di conservazione di un oggetto.
• Istruzioni per l'uso: ibmcloud cos object-retention-put --bucket BUCKET_NAME --key KEY [--retention STRUCTURE] [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto.
    • Indicatore: --key KEY
  • Una STRUTTURA che utilizza la sintassi JSON. Vedi la documentazione diIBM Cloud.

    • Indicatore: --retention STRUCTURE

      	{
      	  "Mode": "COMPLIANCE",
      	  "RetainUntilDate": timestamp
      	}
      

  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

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

Ottieni conservazione oggetto

• Azione: ottenere la ritenzione su un oggetto.
• Istruzioni per l'uso: ibmcloud cos object-retention-get --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto.
    • Indicatore: --key KEY
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

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

Risposta di esempio:

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

Impostare tag su un oggetto

• Azione: assegnare tag a un oggetto.
• Istruzioni per l'uso: ibmcloud cos object-tagging-put --bucket BUCKET_NAME --key KEY --tagging STRUCTURE [--version-id VERSION_ID] [--region REGION] [--output FORMAT]
• Parametri da fornire:

  • Il nome del bucket.

    • Indicatore: --bucket BUCKET_NAME

  • La CHIAVE dell'oggetto.

    • Indicatore: --key KEY

  • Una STRUTTURA che utilizza la sintassi JSON e contiene l'insieme di tag. Il prefisso file:// può essere utilizzato per caricare la struttura JSON da un file, ad esempio --tagging file://<filename.json>.

    • Indicatore: --tagging STRUCTURE

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

  • Facoltativo : il VERSION_ID dell'oggetto da contrassegnare. Se non specificato, viene contrassegnata la versione corrente.

    • Indicatore: --version-id VERSION_ID

  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.

    • Indicatore: --region REGION

  • Opzionale : il FORMATO di output può essere solo json o testo.

    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos object-tagging-put --bucket my-bucket --key my-object.txt --tagging '{"TagSet": [{"Key": "env", "Value": "production"}]}'

Acquisire i tag per un oggetto

• Azione: recuperare i tag di un oggetto.
• Istruzioni per l'uso: ibmcloud cos object-tagging-get --bucket BUCKET_NAME --key KEY [--version-id VERSION_ID] [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto.
    • Indicatore: --key KEY
  • Facoltativo : il VERSION_ID della versione specifica dell'oggetto per cui si desidera recuperare i tag.
    • Indicatore: --version-id VERSION_ID
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos object-tagging-get --bucket my-bucket --key my-object.txt

Rimuovere i tag da un oggetto

• Azione: rimuovere i tag da un oggetto.
• Istruzioni per l'uso: ibmcloud cos object-tagging-delete --bucket BUCKET_NAME --key KEY [--version-id VERSION_ID] [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto.
    • Indicatore: --key KEY
  • Facoltativo : il VERSION_ID della versione specifica dell'oggetto da cui rimuovere i tag.
    • Indicatore: --version-id VERSION_ID
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos object-tagging-delete --bucket my-bucket --key my-object.txt

Impostare la configurazione del blocco di accesso pubblico su un bucket

• Azione: impostare la configurazione del blocco dell'accesso pubblico su un bucket.
• Istruzioni per l'uso: ibmcloud cos public-access-block-put --bucket BUCKET_NAME --public-access-block-configuration STRUCTURE [--region REGION] [--output FORMAT]
• Parametri da fornire:

  • Il nome del bucket.

    • Indicatore: --bucket BUCKET_NAME

  • Una STRUTTURA che utilizza la sintassi JSON. Il prefisso file:// può essere utilizzato per caricare la struttura JSON da un file, ad esempio --public-access-block-configuration file://<filename.json>.

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

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

  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.

    • Indicatore: --region REGION

  • Opzionale : il FORMATO di output può essere solo json o testo.

    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos public-access-block-put --bucket my-bucket --public-access-block-configuration '{"BlockPublicAcls": true, "IgnorePublicAcls": true, "BlockPublicPolicy": true, "RestrictPublicBuckets": true}'

Ottenere la configurazione del blocco di accesso pubblico su un bucket

• Azione: recuperare la configurazione del blocco di accesso pubblico su un bucket.
• Istruzioni per l'uso: ibmcloud cos public-access-block-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos public-access-block-get --bucket my-bucket

Rimuovere la configurazione del blocco di accesso pubblico da un bucket

• Azione: rimuovere la configurazione del blocco dell'accesso pubblico da un bucket.
• Istruzioni per l'uso: ibmcloud cos public-access-block-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.
    • Indicatore: --region REGION
  • Opzionale : il FORMATO di output può essere solo json o testo.
    • Indicatore: --output FORMAT

Esempio:

ibmcloud cos public-access-block-delete --bucket my-bucket

Carica gli oggetti utilizzando S3Manager

• Azione: carica oggetti in COS contemporaneamente.
• Istruzioni per l'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]
• Parametri da fornire:

  • Il nome (BUCKET_NAME) del bucket.

    • Indicatore: --bucket BUCKET_NAME

  • La CHIAVE dell'oggetto.

    • Indicatore: --key KEY

  • Il PERCORSO del file da caricare.

    • Indicatore: --file PATH

  • Opzionale : il numero di routine "go" da avviare in parallelo per ogni chiamata alla funzione Upload durante l'invio delle parti. Il valore predefinito è 5.

    • Indicatore: --concurrency value

  • Facoltativo : numero massimo di PARTI che verranno caricate su S3, sito che calcola le dimensioni delle singole parti dell'oggetto da caricare. Il limite è di 10.000 parti.

    • Indicatore: --max-upload-parts PARTS

  • Facoltativo : la DIMENSIONE del buffer (in byte) da utilizzare quando si memorizzano i dati in blocchi e li si inviano come parti all'indirizzo S3. La dimensione minima consentita per la parte è 5 MB.

    • Indicatore: --part-size SIZE

  • Opzionale : impostando questo valore su "true", l'SDK eviterà di chiamare AbortMultipartUpload in caso di errore, lasciando tutte le parti caricate con successo su S3 per il recupero manuale.

    • Indicatore: --leave-parts-on-errors

  • Opzionale : specifica le CACHING_DIRECTIVES per la catena di richieste/risposte.

    • Indicatore: --cache-control CACHING_DIRECTIVES

  • Facoltativo : specifica informazioni relative alla presentazione (DIRETTIVE).

    • Indicatore: --content-disposition DIRECTIVES

  • Facoltativo : specifica quali codifiche dei contenuti (CONTENT_ENCODING) sono state applicate all'oggetto e, di conseguenza, quali meccanismi di decodifica devono essere applicati per ottenere il tipo di media a cui fa riferimento il campo di intestazione Content-Type.

    • Indicatore: --content-encoding CONTENT_ENCODING

  • Facoltativo : la LINGUA in cui è redatto il contenuto.

    • Indicatore: --content-language LANGUAGE

  • Facoltativo : DIMENSIONE del corpo in byte. Questo parametro è utile quando la dimensione del corpo non può essere determinata automaticamente.

    • Indicatore: --content-length SIZE

  • Facoltativo : il digest dei dati generato dall’ base64-encoded, a 128 bit, con algoritmo MD5.

    • Indicatore: --content-md5 MD5

  • Facoltativo : un tipo MIME standard che descrive il formato dei dati dell'oggetto.

    • Indicatore: --content-type MIME

  • Facoltativo : una MAP contenente i metadati da memorizzare. Il prefisso file:// può essere utilizzato per caricare la struttura JSON da un file.

    • Indicatore: --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"
      	}
      

  • Facoltativo : la REGIONE in cui si trova il bucket. Se questo indicatore non viene fornito, il programma utilizza l'opzione predefinita specificata nella configurazione.

    • Indicatore: --region REGION

  • Opzionale : il FORMATO di output può essere solo json o testo.

    • Indicatore: --output FORMAT

bucket-esiste

• Azione: attendere fino a quando non si riceve una risposta 200 durante l'interrogazione tramite head-bucket.
• Istruzioni per l'uso: ibmcloud cos wait bucket-exists --bucket BUCKET_NAME [--region REGION]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket.
    • Indicatore: --region REGION

Esempio:

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

il-contenitore-non-esiste

• Azione: attendere fino a quando non viene ricevuta una risposta 404 durante l'interrogazione dell'indirizzo head-bucket.
• Istruzioni per l'uso: ibmcloud cos wait bucket-not-exists --bucket BUCKET_NAME [--region REGION]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • Facoltativo : la REGIONE in cui si trova il bucket.
    • Indicatore: --region REGION

Esempio:

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

oggetto-esiste

• Azione: attendere fino a quando non si riceve una risposta 200 durante l'interrogazione tramite head-object.
• Istruzioni per l'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]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto.
    • Indicatore: --key KEY
  • Opzionale : restituisce l'oggetto solo se il suo tag di entità (ETag) corrisponde all'ETAG fornito.
    • Indicatore: --if-match ETAG
  • Opzionale : restituisce l'oggetto solo se è stato modificato dopo il TIMESTAMP specificato.
    • Indicatore: --if-modified-since TIMESTAMP
  • Opzionale : restituisci l'oggetto solo se il suo ETag non corrisponde all'ETAG fornito.
    • Indicatore: --if-none-match ETAG
  • Opzionale : restituisce l'oggetto solo se non è stato modificato a partire dal TIMESTAMP specificato.
    • Indicatore: --if-unmodified-since TIMESTAMP
  • Opzionale : scarica l'INTERVALLO di byte specificato di un oggetto.
    • Indicatore: --range RANGE
  • Facoltativo : NUMERO di parte dell'oggetto che si sta leggendo.
    • Indicatore: --part-number NUMBER
  • Facoltativo : la REGIONE in cui si trova il bucket.
    • Indicatore: --region REGION

Esempio:

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

oggetto-non-esistente

• Azione: attendere fino a quando non viene ricevuta una risposta 404 durante l'interrogazione dell'indirizzo head-object.
• Istruzioni per l'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]
• Parametri da fornire:
  • Il nome del bucket.
    • Indicatore: --bucket BUCKET_NAME
  • La CHIAVE dell'oggetto.
    • Indicatore: --key KEY
  • Opzionale : restituisce l'oggetto solo se il suo tag di entità (ETag) corrisponde all'ETAG fornito.
    • Indicatore: --if-match ETAG
  • Opzionale : restituisce l'oggetto solo se è stato modificato dopo il TIMESTAMP specificato.
    • Indicatore: --if-modified-since TIMESTAMP
  • Opzionale : restituisci l'oggetto solo se il suo ETag non corrisponde all'ETAG fornito.
    • Indicatore: --if-none-match ETAG
  • Opzionale : restituisce l'oggetto solo se non è stato modificato a partire dal TIMESTAMP specificato.
    • Indicatore: --if-unmodified-since TIMESTAMP
  • Opzionale : scarica l'INTERVALLO di byte specificato di un oggetto.
    • Indicatore: --range RANGE
  • Facoltativo : NUMERO di parte dell'oggetto che si sta leggendo.
    • Indicatore: --part-number NUMBER
  • Facoltativo : la REGIONE in cui si trova il bucket.
    • Indicatore: --region REGION

Esempio:

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