Skip to content

Cloud Integration Update Service Properties

Make changes to an existing Cloud Integration entity's service properties.

The changes to make can be provided by a combination of methods:

  1. Standard input, as a JSON object.
  2. Command line options
  3. Command line parameter JSON object, or @@ file reference

For example, the following invocations produce equivalent results:

# using standard input
echo '{"alternateName":"Big Site"}' \
    |s10k cloud-integrations integrations update-service-properties \
        --integration-id 100

# using parameter value
s10k cloud-integrations integrations update-service-properties \
    --integration-id 100 '{"alternateName":"Big Site"}'

# using parameter file reference - my-file.json contains '{"alternateName":"Big Site"}'
s10k cloud-integrations integrations update-service-properties \
    --integration-id 100 @@my-file.json

# using option
s10k cloud-integrations integrations update-service-properties \
    --integration-id 100 --service-property 'alternateName:Big Site'

The methods can be combined, with each method overriding settings duplicated in previous methods. For example the following ends up changing alternateName to Small Site because the command line parameter override both the --service-property option and standard input values:

echo '{"alternateName":"Big Site"}' \
    |s10k cloud-integrations integrations update-service-properties \
        --integration-id 100 \
        --service-property 'alternateName:Medium Site' \
        '{"alternateName":"Small Site"}'

Usage

s10k cloud-integrations integrations update-service-properties
    [-I]
    -i=<integrationId>
    [-g=<mode>]
    [-prop=serviceProperty]...
    [-mode=<displayMode>]
    [<config>]
Option Long Version Description
-g= --merge-mode= one of Simple, RecursiveObjects, or RecursiveObjectsAndArrays to control the merge style; see here for details
-I --ignore-input ignore standard input, instead of treating that as a JSON settings object
-prop= --service-property a service property, in the form path:value or @@file.json; see here for details
-i= --integration-id= the integration ID to update
-mode= --display-mode= the format to display the output as, one of CSV, JSON, or PRETTY; defaults to PRETTY

Tip

Use the --dry-run global option to preview the update, without actually changing anything. For example:

s10k --dry-run cloud-integrations integrations update-service-properties \
     --integration-id 100 --service-property 'alternateName:My Site'

Output

The updated integration service properties (or a preview of the update if the --dry-run option was given).

Examples

s10k cloud-integrations integrations update-service-properties \
    --integration-id 100 \
    --service-property 'username:theusername'

You can use c2c instead of cloud-integrations and i9n instead of integrations and update-props instead of update-service-properties, for example:

s10k c2c i9n update-props --integration-id 100 --service-property 'username:theusername'

+-------------------+------------------------------------------+
| Property          | Value                                    |
+-------------------+------------------------------------------+
| username          | theusername                              |
+-------------------+------------------------------------------+
| password          | {SSHA-256}7PHQ1aQIT+oQ/X1k7m6RPGuz...    |
+-------------------+------------------------------------------+

Property,Value
username,theusername
password,{SSHA-256}7PHQ1aQIT+oQ/X1k7m6RPGuz...

{
    "username": "theuesrname",
    "password": "{SSHA-256}7PHQ1aQIT+oQ/X1k7m6RPGuz..."
}