`datastage xml-schema-library upload`

Important: IBM Cloud Pak® for Data Version 4.7 will reach end of support (EOS) on 31 July, 2025. For more information, see the Discontinuance of service announcement for IBM Cloud Pak for Data Version 4.X.

Upgrade to IBM Software Hub Version 5.1 before IBM Cloud Pak for Data Version 4.7 reaches end of support. For more information, see Upgrading IBM Software Hub in the IBM Software Hub Version 5.1 documentation.

Upload a file to an existing DataStage XML schema library in a specified project or catalog. You must set either project_id or catalog_id.

Syntax

cpd-cli datastage xml-schema-library upload \
--body=<upload-file-content> \
[--catalog-id=<catalog-id>] \
[--context=<catalog-project-or-space-id>] \
[--cpd-config=<cpd-config-location>] \
[--cpd-scope=<cpd-scope>] \
[--file-name=<file-to-upload>] \
[--jmes-query=<jmespath-query>] \
--library-id=<xml-schema-library-id> \
[--output=json|yaml|table] \
[--output-file=<output-file-location>] \
--profile=<cpd-configuration-profile-name> \
[--project-id=<cpd-project-id>] \
[--quiet] \
[--raw-output=true|false] \
[--space-id=<space-identifier>] \
[--verbose]

Arguments

The datastage xml-schema-library upload command has no arguments.

Options

Option	Description
`--body`	Specify the content of the file to upload. Status Required. Syntax `--body=<upload-file-content>` Default value No default. Valid values Any valid file content.
`--catalog-id`	Specify either a catalog ID, project ID, or space ID (specify only one). Status Optional. Syntax `--catalog-id=<catalog-id>` Default value No default. Valid values A valid catalog, project or space ID.
`--context`	Specify the configuration context  name. Status Optional. Syntax `--context=<catalog-project-or-space-id>` Default value Not applicable. Valid values A valid configuration context name.
`--cpd-config`	The Cloud Pak for Data  configuration location. For example, $HOME/.cpd-cli/config. Status Required. Syntax `--cpd-config=<cpd-config-location>` Default value $HOME/.cpd-cli/config Valid values A valid Cloud Pak for Data configuration location.
`--cpd-scope`	The Cloud Pak for Data space, project, or catalog scope. For example, cpd://default-context/spaces/7bccdda4-9752-4f37-868e-891de6c48135. Status Optional. Syntax `--cpd-scope=<cpd-scope>` Default value No default. Valid values A valid Cloud Pak for Data space, project, or catalog scope.
`--file-name`	Specify the file name that you want to upload to the specified XML schema library. Status Optional. Syntax `--file-name=<file-to-upload>` Default value No default. Valid values A valid file name.
`--help` `-h`	Display command help. Status Optional. Syntax `--help` Default value No default. Valid values Not applicable.
`--jmes-query`	The Lucene query. Status Required. Syntax `--query=<lucene-query>` Default value No default. Valid values A valid Lucene query.
`--library-id`	Specify the XML schema library ID. Status Required. Syntax `--library-id=<xml-schema-library-id>` Default value `No default.`
`--output`	Specify an output format. Valid formats include json, yaml, or text (the default format). Status Optional. Syntax `--output=json\|yaml\|text` Default value `text` Valid values `json\|yaml\|text`
`--output-file`	Specify a file path where all output is redirected. Status Optional. Syntax `--output-file=<output-file-location>` Default value No default. Valid values A valid output file path location.
`--profile`	The name of the profile that you created to store information about an instance of Cloud Pak for Data and your credentials for the instance. Status Required. Syntax `--profile=<cpd-configuration-profile-name>` Default value No default. Valid values The name of the profile that you created.
`--project-id`	Specify a Cloud Pak for Data project instance. Status Required. Syntax `--project-id=<cpd-project-id>` Default value No default. Valid values A valid project identifier.
`--quiet`	Suppress verbose messages. Status Optional. Syntax `--quiet` Default value No default. Valid values Not applicable.
`--raw-output`	When set to true, single values in  JSON output mode are not surrounded by quotes. Status Optional. Syntax `--raw-output=true\|false` Default value `false` Valid values `false` Single values in JSON output mode are surrounded by quotation marks. `true` Single values in JSON output mode are not surrounded by quotation marks.
`--space-id`	Specify a space identifier. Status Required. Syntax `--space-id=<space-identifier>` Default value No default. Valid values A valid space identifier.
`--verbose`	Logs include more detailed messages. Status Optional. Syntax `--verbose` Default value No default. Valid values Not applicable.

Table 1: Command options