Globus Connect Server Storage Gateway Show
Description
The globus-connect-server storage-gateway show command displays information about a single storage gateway.
There is one required argument to this command: STORAGE_GATEWAY_ID.
This is the id of the storage gateway to show. The id value is displayed when the
storage gateway is created, or may be found by running the
globus-connect-server storage-gateway list command.
By default, this command displays a textual list of properties of the collection. Alternatively, it can display a JSON document containing the list results. Use the -F json command-line option to enable this output format.
You can add the --include-private-policies flag to include private storage gateway configuration data. Some private policy fields contain complex JSON data. These are not shown in the text output format but are included in the JSON output format.
In order to view private configuration data for a storage gateway, you must have an administrator role on the storage gateway assigned to one of your identities. You must have authenticated this identity within the authentication timeout of the storage gateway in order to view this data. For high assurance storage gateways you must perform the authentication within the active CLI session. If you do not meet the authentication timeout requirements, the public policies are still returned, but the private policies are omitted. Note that if there are multiple storage gateways on an endpoint with different authentication policies, the results may be a mix of those which include private policies and those that don’t.
Use the globus-connect-server session update command to update your session if you are not seeing the private policies due to the authentication timeout.
Options
- -h, --help
-
Show help message and exit.
- --version
-
Show the version and exit.
- --include-private-policies
-
Flag to include the private policies. See above for information about requirements to view private policies.
- -F, --format "text"|"json"
-
Output format for this command. If the format is json, then the collection document is displayed.
- --use-explicit-host IP_ADDRESS (new in 5.4.23)
-
IP address of the GCS node to use for this request. If not specified, any available GCS node in the endpoint will be used.
Example
This example shows a storage gateway in the default text format.
globus-connect-server storage-gateway show 9753aa17-066e-46e8-b87c-6c3a34dab602
Display Name: Data Storage Gateway ID: 9753aa17-066e-46e8-b87c-6c3a34dab602 Connector: POSIX High Assurance: False Authentication Timeout: 15840 Allowed Domains: ['example.org']
This example shows a storage gateway in the json format.
globus-connect-server storage-gateway show 9753aa17-066e-46e8-b87c-6c3a34dab602 -F json
{
"DATA_TYPE": "storage_gateway#1.0.0",
"allowed_domains": [
"example.org"
],
"authentication_timeout_mins": 10,
"connector_id": "145812c8-decc-41f1-83cf-bb2a85a2a70b",
"display_name": "Data Storage Gateway",
"high_assurance": false,
"id": "9753aa17-066e-46e8-b87c-6c3a34dab602",
"policies": {
"DATA_TYPE": "posix_storage_policies#1.0.0"
},
"require_high_assurance": false
}