Registration command of the Storage Management Information (Google Cloud Storage)

Parameter explanation

[COMMON-OPTIONS]

These options are common to all utilities.

-r, --replace

Replacement (optional)

This parameter overwrites the existing Send Storage Management Information or Receive Storage Management Information.

If you try to overwrite the existing Storage Management Information without specifying this option, an error occurs.

Note

To overwrite the existing Send Storage Management Information or Receive Storage Management Information, specify the value that is already set with the [MANAGEMENT-OPTIONS].

If the information that is already set is not specified again, it is overwritten with the value "Use the default value.".

-f, --force

Omission of confirmation (optional)

This parameter registers information without confirmation of the registered information.

When you specify the existing Send Storage Management Information or Receive Storage Management Information, the information is overwritten even if you do not specify "-r" or "--replace".

When you omit it, the following confirmation message is output before registration of the Send Storage Management Information or the Receive Storage Management Information:

Are you sure to register? [y/n]:

Input "y" or "Y" to register the Send Storage Management Information or the Receive Storage Management Information specified by the command.

Input other than "y" or "Y" ends in an error.

[REQUIRED]

These parameters cannot be omitted.

-t, --type {snd|rcv}

Type of management information (mandatory)

This parameter specifies the type of Storage Management Information that you want to register.

snd:

Send Storage Management Information

rcv:

Receive Storage Management Information

--id ID

ID (mandatory)

This ID identifies the storage that you use for transferring.

When you register information from the Send Storage Management Information, specify the Send Storage Management Information ID.

When you register information from the Receive Storage Management Information, specify the Receive Storage Management Information ID.

Specify from 3 to 63 bytes of ASCII printable characters.

If you include single-byte spaces, "/", or "*", an error occurs.

= Remarks =

We recommend that you specify the bucket name for the Send Storage Management Information ID. The Send Storage Management Information IDs (bucket names) that you specified for File Name in the Send Management Information are output in the Send Log.

We recommend that you specify the bucket name for the Receive Storage Management Information ID. The Receive Storage Management Information IDs (bucket names) that you specified for File Name in the Receive Management Information are output in the Receive Log.

[MANAGEMENT-OPTIONS]

These are options for setting of the Send Storage Management Information or the Receive Storage Management Information.

--bucket BUCKET

Bucket name (optional)

This parameter specifies the bucket name of the upload destination or the download source for the transfer target file. We recommend that you specify the bucket name as the Storage Management Information ID by using "--id", not by using "--bucket". Use "--bucket" in the case of configuring other transfer settings for one bucket name.

Specify from 3 to 255 bytes of ASCII printable characters.

When you omit specification of this option, the value "Use the default value." is set. In this case, the Storage Management Information ID that has been specified with "--id" is used for the bucket name during transfer.

--timeout SEC

Storage timeout (seconds) (optional)

This parameter specifies the time until a timeout for an HTTP request occurs.

Specify from "10" to "259200", or "999999". When you specify "999999", waiting time is infinite.

When you omit specification of this option, the value "Use the default value." is set. In this case, the value set in the default information is used during transfer.

--parallels NUM

Maximum number of parallels per transfer (optional)

This parameter specifies the maximum number of parallel uploads or downloads per transfer.

If you specify Receive Storage Management Information for the type of Storage Management Information, the maximum number for parallel uploads is specified. If you specify the Send Storage Management Information, the maximum number for parallel downloads is specified.

Specify from "2" to "999".

When you omit specification of this option, the value "Use the default value." is set. In this case, the value set in the default information is used during transfer.

= Remarks =

The maximum number of parallels per transfer is limited, as shown below, to the total number of parallels set in Cloud Storage System Environment Settings.

• Even if you set a value larger than the total number of parallel uploads set in Cloud Storage System Environment Settings, this total number of parallel uploads prevails as the limit. Specify a value smaller than the total number of parallel uploads.

• Even if you set a value larger than the total number of parallel downloads set in Cloud Storage System Environment Settings, this total number of parallel downloads prevails as the limit. Specify a value smaller than the total number of parallel downloads.

--partsize MBYTES

Part size (MB) (optional)

This parameter specifies the part size for parallel uploads or downloads executed at one time.

Specify from "5" to "100".

When you omit specification of this option, the value "Use the default value." is set. In this case, the value set in the default information is used during transfer.

Note

If you change the Part Size to a larger value than the value of "5" that is used when the field is not specified, the load on the system may be high depending on the operating environment. Be aware of this fact when you change the Part Size.

--auth-id ID

Storage Authentication Information ID (optional)

This parameter specifies the ID of the Storage Authentication Information that you want to associate with the Send Storage Management Information or the Receive Storage Management Information.

Specify from 3 to 63 bytes of ASCII printable characters.

If you include single-byte spaces, "/", or "*", an error occurs.

When you omit specification of this option, the value "Use the default value." is set. In this case, the value set in the default information for the Send Storage Management Information or the Receive Storage Management Information is used during transfer.

Supplement

• As shown below, you can specify either with a space or an equals sign (=) between the parameter and the setting value.

    --parameter Value 
    --parameter=Value

• If you specify "-h" or "--help" for the parameter, the usage is output.