IBM Cloud Object Storage CLI

Il plugin IBM Cloud® Object Storage estende l'interfaccia di riga comando (CLI) IBM Cloud con un wrapper API per utilizzare le risorse Object Storage.

Installazione e configurazione

Il plugin è compatibile con le piattaforme Linux (x86_64, arm64, ppc64le, s390x), Windows ® (x64) e macOS® (amd64, arm64) in esecuzione su processori a 64 - bit.

Installa il plugin utilizzando il comando plugin install.

ibmcloud plugin install cloud-object-storage

Una volta installato il plug-in, è possibile configurarlo utilizzando il comando ibmcloud cos config. Questo può essere utilizzato per inserire nel plug-in le tue credenziali, la posizione predefinita per il download, la modalità di autenticazione e così via.

Per prestazioni ottimali, assicurarsi che la traccia sia disattivata impostando la variabile d'ambiente IBMCLOUD_TRACE su false.

Il programma ti offre inoltre la possibilità di impostare la directory locale predefinita per i file scaricati e di impostare una regione predefinita. Per impostare l'ubicazione di download predefinita, immetti ibmcloud cos config ddl e inserisci nel programma un percorso file valido. Per impostare una regione predefinita, immetti ibmcloud cos config region e inserisci nel programma un codice regione, ad esempio us-south. Per impostazione predefinita, questo valore è impostato su us-geo.

È possibile visualizzare le proprie credenziali attuali di IBM Cloud Object Storage accedendo all'indirizzo ibmcloud cos config list. Poiché il file di configurazione viene generato dal plugin, è meglio non modificarlo manualmente.

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

Autenticazione IAM

Se stai utilizzando l'autenticazione IAM, devi configurare il tuo client con un ID istanza per utilizzare alcuni dei 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 è un esempio di ID di istanza.

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.

Abilita traccia nella CLI (command line interface)

La traccia può essere abilitata impostando la variabile di ambiente IBMCLOUD_TRACE su true (maiuscole / minuscole ignorate). Quando la traccia è abilitata, ulteriori informazioni di debug vengono stampate sul terminale.

SU Linux/macOS terminale:

export IBMCLOUD_TRACE=true

Su richiesta Windows:

SET IBMCLOUD_TRACE=true

Per disabilitare la traccia, impostare la variabile di ambiente IBMCLOUD_TRACE su false (caso ignorato).

Indice dei comandi

Per ogni operazione è presente una descrizione che spiega a cosa serve, come utilizzarla e quali sono i parametri opzionali o obbligatori. A meno che non siano specificati come facoltativi, tutti i parametri elencati sono obbligatori.

Il plug-in CLI non supporta ancora l'intera suite di funzionalità disponibili in Object Storage. Aspera High-Speed Transfer, Immutable Object Storage, creazione di bucket Key Protect o Bucket Firewall non possono essere utilizzati dalla CLI.

Interrompi un caricamento in più parti

Azione: interrompe un'istanza di caricamento in più parti terminando il caricamento nel bucket nell'account IBM Cloud Object Storage dell'utente.
Istruzioni per l'uso: ibmcloud cos multipart-upload-abort --bucket BUCKET_NAME --key KEY --upload-id ID [--region REGION] [--output FORMAT]
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
- 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

Configurare un sito web statico

Azione: configura un bucket per ospitare un sito web statico.
Istruzioni per l'uso: ibmcloud cos bucket-website-put --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- La configurazione del sito Web sotto forma di una struttura JSON. Il prefisso file:// è utilizzato per caricare la struttura JSON dal file specificato, ad esempio --website-configuration file://<filename.json>.
  - Indicatore: --website-configuration STRUCTURE I seguenti parametri sono disponibili per la configurazione del comportamento statico del sito. Nessuno è obbligatorio. Per ulteriori dettagli, consultare la documentazione.
```
{
  "ErrorDocument": {
    "Key": "string"
  },
  "IndexDocument": {
    "Suffix": "string"
  },
  "RoutingRules": [
    {
      "Condition": {
        "HttpErrorCodeReturnedEquals": "string",
        "KeyPrefixEquals": "string"
      },
      "Redirect": {
        "HostName": "string",
        "HttpRedirectCode": "string",
        "Protocol": "http"|"https",
        "ReplaceKeyPrefixWith": "string",
        "ReplaceKeyWith": "string"
      }
    }
    ...
  ]
}
```
    In alternativa, se il sito web del bucket è configurato per reindirizzare il traffico, deve essere l'unico parametro configurato:
```
	  "RedirectAllRequestsTo": {
	    "HostName": "string",
	    "Protocol": "http"|"https"
	  }
	  ```
```
- 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

Copia un oggetto dal bucket

Se si desidera aggiungere metadati a un oggetto durante la copia (utilizzando la funzione --metadata ), è necessario aggiungere l'attributo --metadata-directive REPLACE poiché i metadati vengono copiati durante l'operazione per impostazione predefinita (un --metadata-directive COPY implicito).

Azione: copia un oggetto dal bucket di origine al bucket di destinazione.
Istruzioni per l'uso: ibmcloud cos object-copy --bucket BUCKET_NAME --key KEY --copy-source SOURCE [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-type MIME] [--copy-source-if-match ETAG] [--copy-source-if-modified-since TIMESTAMP] [--copy-source-if-none-match ETAG] [--copy-source-if-unmodified-since TIMESTAMP] [--metadata MAP] [--metadata-directive DIRECTIVE] [--region REGION] [--output FORMAT]
Parametri da fornire:
- Il nome del bucket di destinazione.
  - Indicatore: --bucket BUCKET_NAME
- La CHIAVE dell'oggetto.
  - Indicatore: --key KEY
- (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 : specifica " CACHING_DIRECTIVES " per la catena di richieste e risposte.
  - Indicatore: --cache-control CACHING_DIRECTIVES
- Facoltativo : specifica le informazioni relative alla presentazione (DIRECTIVES).
  - Indicatore: --content-disposition DIRECTIVES
- Facoltativo : specifica quali codifiche dei contenuti (CONTENT_ENCODING) vengono applicate all'oggetto e, di conseguenza, quali meccanismi di decodifica devono essere utilizzati 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 : un tipo MIME standard che descrive il formato dei dati dell'oggetto.
  - Indicatore: --content-type MIME
- 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 : una MAP dei metadati da memorizzare.
  - Indicatore: --metadata MAP Sintassi JSON: L'indicatore --metadata utilizza il prefisso file:// utilizzato per caricare la struttura JSON dal file specificato.

      {
        "file_name": "file_20xxxxxxxxxxxx45.zip",
        "label": "texas",
        "state": "Texas",
        "Date_to": "2019-11-09T16:00:00.000Z",
        "Sha256sum": "9e39dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx8ce6b68ede3a47",
        "Timestamp": "Thu, 17 Oct 2019 09:22:13 GMT"
      }
      ```

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

Creare un nuovo bucket

Azione: crea un bucket in un'istanza IBM Cloud Object Storage.
Istruzioni per l'uso: ibmcloud cos bucket-create --bucket BUCKET_NAME [--class CLASS_NAME][--class onerate_active] [--ibm-service-instance-id ID] [--region REGION] [--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:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- Facoltativo : il nome della classe.
  - Indicatore: --class CLASS_NAME
- L'utente deve specificare onerate_active durante la creazione di un bucket.
  - Indicatore: --class onerate_active
- 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

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: 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
- Opzionale : 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: 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
- Opzionale : 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

Crea un nuovo caricamento in più parti

Azione: inizia il processo di caricamento file in più parti creando una nuova istanza di caricamento in più parti.
Istruzioni per l'uso: ibmcloud cos multipart-upload-create --bucket BUCKET_NAME --key KEY [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-type MIME] [--metadata MAP] [--region REGION] [--output FORMAT]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- La CHIAVE dell'oggetto.
  - Indicatore: --key KEY
- Opzionale : specifica " CACHING_DIRECTIVES " per la catena di richieste e risposte.
  - Indicatore: --cache-control CACHING_DIRECTIVES
- Facoltativo : specifica le informazioni relative alla presentazione (DIRECTIVES).
  - Indicatore: --content-disposition DIRECTIVES
- Facoltativo : specifica la codifica del contenuto (CONTENT_ENCODING) dell'oggetto.
  - Indicatore: --content-encoding CONTENT_ENCODING
- Facoltativo : la LINGUA in cui è redatto il contenuto.
  - Indicatore: --content-language LANGUAGE
- Facoltativo : un tipo MIME standard che descrive il formato dei dati dell'oggetto.
  - Indicatore: --content-type MIME
- Facoltativo : una MAP dei metadati da memorizzare.
  - Indicatore: --metadata MAP Sintassi JSON: L'indicatore --metadata utilizza il prefisso file:// utilizzato per caricare la struttura JSON dal file specificato.
```
{
  "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

Eliminare un bucket esistente

Azione: elimina un bucket esistente in un'istanza IBM Cloud Object Storage.
Istruzioni per l'uso: ibmcloud cos bucket-delete --bucket BUCKET_NAME [--region REGION] [--force] [--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 : l'operazione non richiederà alcuna conferma.
  - Indicatore: --force
- Opzionale : il FORMATO di output può essere solo json o testo.
  - Indicatore: --output FORMAT

Elimina il CORS del bucket

Azione: elimina la configurazione CORS su un bucket nell'account IBM Cloud Object Storage di un utente.
Istruzioni per l'uso: ibmcloud cos bucket-cors-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

Elimina una configurazione del sito Web statica

Azione: rimuove la configurazione statica di un sito Web del bucket.
Istruzioni per l'uso: ibmcloud cos bucket-website-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

Elimina un oggetto

Azione: elimina un oggetto da un bucket nell'account IBM Cloud Object Storage di un utente.
Istruzioni per l'uso: ibmcloud cos object-delete --bucket BUCKET_NAME --key KEY [--region REGION] [--force] [--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 : l'operazione non richiederà alcuna conferma.
  - Indicatore: --force
  - Opzionale : il FORMATO di output può essere solo json o testo.
    - Indicatore: --output FORMAT

Elimina più oggetti

Azione: elimina più oggetti da un bucket nell'account IBM Cloud Object Storage di un utente.
Istruzioni per l'uso: ibmcloud cos objects-delete --bucket BUCKET_NAME --delete STRUCTURE [--region REGION] [--output FORMAT]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- Una STRUTTURA che utilizza la sintassi abbreviata o JSON.
  - Indicatore: --delete STRUCTURE
  - Sintassi abbreviata: --delete 'Objects=[{Key=string},{Key=string}],Quiet=boolean'
  - Sintassi JSON: --delete file://<filename.json>
    Il comando --delete utilizza una struttura JSON che elenca gli oggetti da eliminare. In questo esempio, viene utilizzato il prefisso file:// per caricare la struttura JSON dal file specificato.
```
	{
	"Objects": [
	{
	"Key": "string",
	"VersionId": "string"
	}
...
	],
	"Quiet": 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

Scarica un oggetto

Azione: scarica un oggetto da un bucket nell'account IBM Cloud Object Storage di un utente.
Istruzioni per l'uso: ibmcloud cos object-get --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--response-cache-control HEADER] [--response-content-disposition HEADER] [--response-content-encoding HEADER] [--response-content-language HEADER] [--response-content-type HEADER] [--response-expires HEADER] [--region REGION] [--output FORMAT] [OUTFILE]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- La CHIAVE dell'oggetto.
  - Indicatore: --key KEY
- Opzionale : restituire l'oggetto solo se il suo tag di entità (ETag) corrisponde all' ETAG specificato; in caso contrario, restituire 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 di 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 (condizione preliminare non soddisfatta).
  - Indicatore: --if-unmodified-since TIMESTAMP
- Opzionale : scarica i byte specificati nell'INTERVALLO di un oggetto.
  - 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 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 : il percorso in cui salvare il contenuto dell'oggetto. Se questo parametro non viene fornito, il programma utilizza l'ubicazione predefinita.
  - Parametro: OUTFILE

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 delle parti. Il valore predefinito è 5.
  - Indicatore: --concurrency value
- Facoltativo : la dimensione (in byte) del buffer da utilizzare per raggruppare i dati in blocchi e inviarli come parti all'indirizzo S3. La dimensione minima consentita per la parte è 5 MB.
  - Indicatore: --part-size SIZE
- Opzionale : restituire l'oggetto solo se il suo tag di entità (ETag) corrisponde all' ETAG specificato; in caso contrario, restituire 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 di 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 (condizione preliminare non soddisfatta).
  - Indicatore: --if-unmodified-since TIMESTAMP
- Opzionale : scarica i byte specificati nell'INTERVALLO di un oggetto. Per ulteriori informazioni sull'intestazione HTTP Range, fai clic qui.
  - 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 : il percorso in cui salvare il contenuto dell'oggetto. Se questo parametro non viene fornito, il programma utilizza l'ubicazione predefinita.
  - Parametro: OUTFILE

Trova un bucket

Azione: determina la regione e la classe di un bucket in un'istanza IBM Cloud Object Storage.
Istruzioni per l'uso: ibmcloud cos bucket-location-get --bucket BUCKET_NAME [--output FORMAT]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- Opzionale : il FORMATO di output può essere solo json o testo.
  - Indicatore: --output FORMAT

Ottieni la classe di un bucket

Azione: determina la classe di un bucket in un'istanza IBM Cloud Object Storage.
Istruzioni per l'uso: ibmcloud cos bucket-class-get --bucket BUCKET_NAME [--output FORMAT]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- Opzionale : il FORMATO di output può essere solo json o testo.
  - Indicatore: --output FORMAT

Ottieni il CORS del bucket

Azione: restituisce la configurazione CORS per il bucket nell'account IBM Cloud Object Storage di un utente.
Istruzioni per l'uso: ibmcloud cos bucket-cors-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

Ottieni le intestazioni di un bucket

Azione: determina se esiste un bucket in un'istanza IBM Cloud Object Storage.
Istruzioni per l'uso: ibmcloud cos bucket-head --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

Completa un caricamento in più parti

Azione: completa un'istanza di caricamento in più parti assemblando le parti attualmente caricate e caricando il file nel bucket nell'account IBM Cloud Object Storage dell'utente.
Istruzioni per l'uso: ibmcloud cos multipart-upload-complete --bucket BUCKET_NAME --key KEY --upload-id ID --multipart-upload STRUCTURE [--region REGION] [--output FORMAT]
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
- La STRUTTURA del caricamento in più parti da impostare.
  - Indicatore: --multipart-upload STRUCTURE
  - Sintassi abbreviata: --multipart-upload 'Parts=[{ETag=string,PartNumber=integer},{ETag=string,PartNumber=integer}]'
  - Sintassi JSON: --multipart-upload file://<filename.json>
    Il comando --multipart-upload utilizza una struttura JSON che descrive le parti del caricamento in più parti che devono essere riassemblate nel file completo. In questo esempio, viene utilizzato il prefisso file:// per caricare la struttura JSON dal file specificato.
```
		{
		"Parts": [
			{
			 "ETag": "string",
			 "PartNumber": 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

Configura il programma

Azione: configura le preferenze del programma.
Istruzioni per l'uso: ibmcloud cos config [COMMAND]
Comandi:
- Alterna l'autenticazione HMAC e IAM.
  - Command: auth
- Memorizza il CRN nella configurazione.
  - Command: crn
- Memorizza l'ubicazione di download predefinita nella configurazione.
  - Command: ddl
- Memorizza le credenziali HMAC nella configurazione.
  - Command: hmac
- Elenca configurazione.
  - Command: list
- Memorizza la regione predefinita nella configurazione.
  - Command: region
- Passa dallo stile " VHost " a quello "Path" URL.
  - Command: url-style
- Imposta endpoint di servizio predefinito.
  - Command: endpoint-url
    - Parametri:
      
      --list visualizza l'endpoint del servizio predefinito corrente, se è stato impostato. Altrimenti, sarà vuoto.
      
      --url some.end.point.url modificherà l'endpoint del servizio nel valore fornito.
      
      --clear rimuove il Service Endpoint predefinito URL che è stato impostato.

Ottieni una configurazione statica del sito web

Azione: Ottiene la configurazione statica del sito Web di un bucket.
Istruzioni per l'uso: ibmcloud cos bucket-website-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

Ottieni le intestazioni di un oggetto

Azione: determina se esiste un file in un bucket nell'account IBM Cloud Object Storage di un utente.
Istruzioni per l'uso: ibmcloud cos object-head --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--region REGION] [--output FORMAT]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- La CHIAVE dell'oggetto.
  - Indicatore: --key KEY
- Opzionale : restituire l'oggetto solo se il suo tag di entità (ETag) corrisponde all' ETAG specificato; in caso contrario, restituire 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 di 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 (condizione preliminare non soddisfatta).
  - Indicatore: --if-unmodified-since TIMESTAMP
- Scarica i byte dell'INTERVALLO specificato di un oggetto.
  - Indicatore: --range RANGE
- 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

Elenca tutti i bucket

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 [--ibm-service-instance-id ID] [--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
  - Opzionale : il FORMATO di output può essere solo json o testo.
    - Indicatore: --output FORMAT

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

Elenca i caricamenti in più parti in corso

Azione: elenca i caricamenti in più parti in corso.
Istruzioni per l'uso: ibmcloud cos multipart-uploads --bucket BUCKET_NAME [--delimiter DELIMITER] [--encoding-type METHOD] [--prefix PREFIX] [--key-marker value] [--upload-id-marker value] [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- Facoltativo : un DELIMITORE è un carattere che si utilizza per raggruppare le chiavi.
  - Indicatore: --delimiter DELIMITER
- Facoltativo : richiede la codifica delle chiavi dell'oggetto nella risposta e specifica il METODO di codifica da utilizzare.
  - Indicatore: --encoding-type METHOD
- Opzionale : limita la risposta ai tasti che iniziano con il PREFIX specificato.
  - Indicatore: --prefix PREFIX
- Opzionale : insieme al parametro upload-id-marker, questo parametro specifica il caricamento multipart a partire dal quale deve iniziare l'elenco.
  - Indicatore: --key-marker value
- Opzionale : insieme al parametro "key-marker", specifica il punto di caricamento multiparte a partire dal quale deve iniziare l'elenco. Se key-marker non viene specificato, il parametro upload-id-marker viene ignorato.
  - Indicatore: --upload-id-marker value
- 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. Ciò può aiutare a evitare che le chiamate di servizio vadano in timeout. (impostazione predefinita: 1000).
  - Indicatore: --page-size SIZE
- Facoltativo : il NUMERO totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è superiore al valore specificato, nell'output del comando viene fornito un valore NextToken. Per riprendere l'impaginazione, specificare il valore " NextToken " nell'argomento "starting-token" di un comando successivo. (valore predefinito: 0).
  - Indicatore: --max-items 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

Elenca gli oggetti

Azione: elenca i file presenti in un bucket nell'account IBM Cloud Object Storage di un utente. Questa operazione è attualmente limitata ai 1000 oggetti creati più di recente e non può essere filtrata.
Istruzioni per l'uso: ibmcloud cos objects --bucket BUCKET_NAME [--delimiter DELIMITER] [--encoding-type METHOD] [--prefix PREFIX] [--starting-token TOKEN] [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- Facoltativo : un DELIMITORE è un carattere che si utilizza per raggruppare le chiavi.
  - Indicatore: --delimiter DELIMITER
- Facoltativo : richiede la codifica delle chiavi dell'oggetto nella risposta e specifica il METODO di codifica da utilizzare.
  - Indicatore: --encoding-type METHOD
- Opzionale : limita la risposta ai tasti che iniziano con il PREFIX specificato.
  - Indicatore: --prefix PREFIX
- Facoltativo : un TOKEN per specificare da dove iniziare l'impaginazione. Questo è il NextToken di una risposta precedentemente troncata.
  - Indicatore: --starting-token TOKEN
- 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. Ciò può aiutare a evitare che le chiamate al servizio scadano per timeout. (impostazione predefinita: 1000)
  - Indicatore: --page-size SIZE
- Facoltativo : il NUMERO totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è superiore al valore specificato, nell'output del comando viene fornito un valore NextToken. Per riprendere l'impaginazione, specificare il valore " NextToken " nell'argomento "starting-token" di un comando successivo. (impostazione predefinita: 0)
  - Indicatore: --max-items 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

Elenca oggetti v2

Azione: Elencare tutti gli oggetti presenti in un bucket specifico.
Istruzioni per l'uso: list-objects-v2 --bucket BUCKET_NAME [--starting-token Starting Token] [--delimiter DELIMITER] [--encoding-type METHOD] [--fetch-owner Boolean] [--max-items NUMBER] [--prefix PREFIX] [--start-after Start After] [--page-size SIZE] [--region REGION] [--output FORMAT] [--json]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- Facoltativo : un DELIMITORE è un carattere che si utilizza per raggruppare le chiavi.
  - Indicatore: --delimiter DELIMITER
- Facoltativo : richiede la codifica delle chiavi dell'oggetto nella risposta e specifica il METODO di codifica da utilizzare.
  - Indicatore: --encoding-type METHOD
- Opzionale : limita la risposta ai tasti che iniziano con il PREFIX specificato.
  - Indicatore: --prefix PREFIX
- Facoltativo : un TOKEN per specificare da dove iniziare l'impaginazione. Questo è il NextToken di una risposta precedentemente troncata.
  - Indicatore: --starting-token TOKEN
- 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. Ciò può aiutare a evitare che le chiamate al servizio scadano per timeout. (impostazione predefinita: 1000)
  - Indicatore: --page-size SIZE
- Facoltativo : il NUMERO totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è superiore al valore specificato, nell'output del comando viene fornito un valore NextToken. Per riprendere l'impaginazione, specificare il valore " NextToken " nell'argomento "starting-token" di un comando successivo. (impostazione predefinita: 0)
  - Indicatore: --max-items 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
- Opzionale : l'impostazione booleana non è presente per impostazione predefinita in listV2; se si desidera restituire il campo "owner" con ogni chiave nel risultato, impostare l'opzione "fetch owner field" su "true".
  - Indicatore: --fetch-owner Boolean
- Opzionale : "Start After" indica il punto da cui desideri che " S3 " inizi l'elenco. S3 inizia l'elenco dopo questa chiave specificata. StartAfter può essere qualsiasi chiave nel bucket.
  - Indicatore: --start-after Start After
- Avviso : l'output è stato restituito in formato JSON non elaborato.
  - Indicatore: --json

Elenca le parti

Azione: stampa le informazioni relative a un'istanza di caricamento in più parti in corso
Istruzioni per l'uso: ibmcloud cos parts --bucket BUCKET_NAME --key KEY --upload-id ID --part-number-marker VALUE [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
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
- VALORE del numero di parte dopo il quale inizia l'elenco (valore predefinito: 1)
  - Indicatore: --part-number-marker VALUE
- 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. Ciò può aiutare a evitare che le chiamate al servizio scadano per timeout. (impostazione predefinita: 1000)
  - Indicatore: --page-size SIZE
- Facoltativo : il NUMERO totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è superiore al valore specificato, nell'output del comando viene fornito un valore NextToken. Per riprendere l'impaginazione, specificare il valore " NextToken " nell'argomento "starting-token" di un comando successivo. (impostazione predefinita: 0)
  - Indicatore: --max-items 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

Imposta il CORS del bucket

Azione: imposta la configurazione CORS per un bucket nell'account IBM Cloud Object Storage dell'utente.
Istruzioni per l'uso: ibmcloud cos bucket-cors-put --bucket BUCKET_NAME [--cors-configuration STRUCTURE] [--region REGION] [--output FORMAT]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- Facoltativo : una STRUTTURA che utilizza la sintassi JSON in un file.
  - Indicatore: --cors-configuration STRUCTURE
  - Sintassi JSON: --cors-configuration file://<filename.json>
    Il comando --cors-configuration accetta una struttura JSON che descrive la configurazione di CORS. In questo esempio, viene utilizzato il prefisso file:// per caricare la struttura JSON dal file specificato.
```
	{
	"CORSRules": [
	{
  	"AllowedHeaders": ["*"],
  	"AllowedMethods": ["PUT", "GET", "DELETE"],
  	"AllowedOrigins": ["http://www.example.com"],
  	"ExposeHeaders": ["ExposeHeader7","ExposeHeader8"],
  	"MaxAgeSeconds": 75
	}
	...
	]
	}
```
- 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

Inserisci l'oggetto

Azione: carica un oggetto in un bucket nell'account IBM Cloud Object Storage di un utente.
Istruzioni per l'uso: ibmcloud cos object-put --bucket BUCKET_NAME --key KEY [--body FILE_PATH] [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-length SIZE] [--content-md5 MD5] [--content-type MIME] [--metadata MAP] [--region REGION] [--output FORMAT]
Parametri da fornire:
- Il nome del bucket.
  - Indicatore: --bucket BUCKET_NAME
- La CHIAVE dell'oggetto.
  - Indicatore: --key KEY
- Facoltativo : posizione dei dati dell'oggetto (FILE_PATH).
  - Indicatore: --body FILE_PATH
- Opzionale : specifica " CACHING_DIRECTIVES " per la catena di richieste e risposte.
  - Indicatore: --cache-control CACHING_DIRECTIVES
- Facoltativo : specifica le informazioni relative alla presentazione (DIRECTIVES).
  - Indicatore: --content-disposition DIRECTIVES
- Facoltativo : specifica la codifica del contenuto (CONTENT_ENCODING) dell'oggetto.
  - 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 non è possibile determinare automaticamente la dimensione del corpo. (impostazione predefinita: 0)
  - 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 dei metadati da memorizzare.
  - Indicatore: --metadata MAP Sintassi JSON: L'indicatore --metadata utilizza il prefisso file:// utilizzato per caricare la struttura JSON dal file specificato.
```
{
  "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

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 (in byte) del buffer da utilizzare per raggruppare i dati in blocchi e inviarli 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 correttamente 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 (DIRECTIVES).
  - 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 dei metadati da memorizzare.
  - Indicatore: --metadata MAP Sintassi JSON: L'indicatore --metadata utilizza il prefisso file:// utilizzato per caricare la struttura JSON dal file specificato.
```
{
  "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 utilizzerà l'opzione predefinita specificata nella configurazione.
  - Indicatore: --region REGION
- Opzionale : il FORMATO di output può essere solo json o testo.
  - Indicatore: --output FORMAT

Controllo manuale dei caricamenti in più parti

La CLI di IBM Cloud Object Storage offre agli utenti la possibilità di caricare file di grandi dimensioni in più parti utilizzando le funzioni di caricamento multipart di AWS. Per avviare un nuovo caricamento in più parti, eseguire il comando multipart-upload-create , che restituisce l'ID del caricamento della nuova istanza. Per continuare con il processo di caricamento, devi salvare l'ID caricamento per ciascun comando successivo. Questo comando richiede la generazione di un hash MD5:

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

Dopo aver eseguito il comando multipart-upload-complete, eseguire part-upload per ogni parte di file che si desidera caricare. Per i caricamenti in più parti, ogni parte del file (ad eccezione dell'ultima) deve avere una dimensione minima di 5 MB. Per suddividere un file in parti separate, puoi eseguire split in una finestra di terminale. Ad esempio, se sul tuo desktop hai un file da 13 MB denominato TESTFILE e vuoi suddividerlo in parti da 5 MB ciascuna, puoi eseguire split -b 3m ~/Desktop/TESTFILE part-file-. Questo comando genera tre parti del file con due parti da 5 MB ciascuna e una parte da 3 MB, denominate part-file-aa, part-file-ab e part-file-ac. As each file part is uploaded, the CLI print its ETag . You must save this ETag into a formatted JSON file, along with the part number. Use this template to create your own File di dati JSON ETag.

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

Aggiungi altre voci a questo template JSON secondo necessità.

Per verificare lo stato del tuo upload multiparte, puoi sempre eseguire il comando part-list , specificando il nome del bucket, la chiave e l'ID dell'upload. Questo comando visualizza le informazioni grezze relative all'istanza di caricamento multiparte. Una volta completato il caricamento di ciascuna parte del file, esegui il comando multipart-upload-complete con i parametri necessari. Se tutto va bene, ricevi una conferma che il file è stato caricato correttamente nel bucket desiderato.

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

Configurazione blocco oggetti

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: 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: object-lock-configuration-get --bucket BUCKET_NAME [--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
```
	{
	"ObjectLockEnabled": "Enabled",
	"Rule": {
		"DefaultRetention": {
		"Mode": "COMPLIANCE",
		"Days": integer,
		"Years": integer
		}
	}
	}
```

Esempio:

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

Conservazione oggetto

Conservazione oggetti di inserimento

Azione: Impostare il periodo di conservazione di un oggetto.
Istruzioni per l'uso: 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: 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
```
	{
		"Retention": {
			"Mode": "COMPLIANCE",
			"RetainUntilDate": "2024-02-02T00:00:00.000Z"
		}
	}
```

Esempio:

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

Blocco legale oggetto

Metti oggetto in attesa legale

Azione: impostare il blocco legale su un oggetto.
Istruzioni per l'uso: 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: 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
```
	{
		"LegalHold": {
			"Status": "ON"
		}
	}
```

Esempio:

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

Configura replica bucket

Configurazione per la configurazione di un bucket replicato.

Replica bucket di inserimento

Azione: impostare la configurazione della replica su un bucket.
Istruzioni per l'uso: 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-NAME"
				}
			}
		]
	}
```

Esempio:

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

Richiama replica bucket

Azione: recuperare la configurazione di replica di un bucket.
Istruzioni per l'uso: 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
```
	{
		"ReplicationConfiguration": {
			"Rules": [
				{
					"Status": "Enabled",
					"Prefix": "",
					"Destination": {
						"Bucket": "DEST-BUCKET-NAME",
						"StorageClass": "STANDARD"
					},
				}
			],
		}
	}
```

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: 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

Passi successivi

Poiché ogni procedura viene sempre eseguita esattamente come pianificato, è possibile che non sia stato visualizzato alcuno dei codici di errore e di intestazione comuni. Per ulteriori informazioni, consulta la Guida di riferimento API.

IBM Cloud Object Storage CLI

IBM Cloud Object Storage CLI

Installazione e configurazione

Autenticazione IAM

Credenziali HMAC

Abilita traccia nella CLI (command line interface)

Indice dei comandi

Interrompi un caricamento in più parti

Configurare un sito web statico

Il nome del bucket.

Copia un oggetto dal bucket

Creare un nuovo bucket

Crea un nuovo bucket con Key Protect

Crea un nuovo bucket con Hyper Protect Crypto Services

Crea un nuovo caricamento in più parti

Eliminare un bucket esistente

Elimina il CORS del bucket

Elimina una configurazione del sito Web statica

Il nome del bucket.

Elimina un oggetto

Elimina più oggetti

Sintassi JSON: --delete file://<filename.json>

Scarica un oggetto

Scarica gli oggetti utilizzando S3Manager

Trova un bucket

Ottieni la classe di un bucket

Ottieni il CORS del bucket

Ottieni le intestazioni di un bucket

Completa un caricamento in più parti

Sintassi JSON: --multipart-upload file://<filename.json>

Configura il programma

Parametri:

Ottieni una configurazione statica del sito web

Il nome del bucket.

Ottieni le intestazioni di un oggetto

Elenca tutti i bucket

Elenco bucket esteso

Elenca i caricamenti in più parti in corso

Elenca gli oggetti

Elenca oggetti v2

Elenca le parti

Imposta il CORS del bucket

Sintassi JSON: --cors-configuration file://<filename.json>

Inserisci l'oggetto

Carica gli oggetti utilizzando S3Manager

Controllo manuale dei caricamenti in più parti

Caricare una parte

Carica una copia della parte

Configurazione blocco oggetti

Configurazione blocco oggetto di inserimento

Ottieni configurazione blocco oggetto

Conservazione oggetto

Conservazione oggetti di inserimento

Ottieni conservazione oggetto

Blocco legale oggetto

Metti oggetto in attesa legale

Acquisisci blocco legale oggetto

Configura replica bucket

Replica bucket di inserimento

Richiama replica bucket

Elimina replica bucket

Passi successivi

Sintassi JSON: `--delete file://<filename.json>`

Sintassi JSON: `--multipart-upload file://<filename.json>`

Sintassi JSON: `--cors-configuration file://<filename.json>`