/scalemgmt/v3/clusters/trust: GET

Lists all certified authority (CA) chains that are currently trusted by the local cluster.

Availability

Available on all IBM Storage Scale editions.

Description

The GET clusters trust request lists all certified authority (CA) chains that are currently trusted by the local cluster. For more information about the fields in the data structures that are returned, see scalectl cluster command.

Request URL

https://<IP address or host name of API server>:<port>/scalemgmt/v3/clusters/trust
where
clusters/trust
Specifies to list the trusted CA chains.

Request headers

Accept: application/json

Parameters

The following parameters can be used in the request URL to customize the request:
Table 1. List of parameters
Parameter name Description and applicable keywords Required/optional
end_point Filters the results by the specified endpoint subject name. Optional.
X-StorageScaleDomain The domain to be authorized against for the request. The default value is StorageScaleDomain. Optional.

Request data

No request data.

Response data

  • 200: A successful response.
    {
  "ca_chains": [
    {
      "cert_chain": [
        {
          "issuer": "string",
          "not_after": "string",
          "not_before": "string",
          "subject": "string"
        }
      ],
      "end_point": {
        "issuer": "string",
        "not_after": "string",
        "not_before": "string",
        "subject": "string"
      }
    }
  ]
}
  • default: An unexpected error response.
    {
  "code": 0,
  "details": [
    {
      "@type": "string",
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  ],
  "message": "string"
}

Examples

The following example gets information about the certified authority (CA) chains that are trusted by local cluster:

Request data: 
curl -n -k -X 'GET' 'https://localhost:46443/scalemgmt/v3/clusters/trust?end_point=?end_point=CN%3Dgpfs-dev-1.gpfs.net%20-%20CA%20endpoint%20certificate%2COU%3DStorage%2BOU%3DStorage%20Scale%2BOU%3DGPFS%20Core%2CO%3DIBM%20Corp%2CL%3DHOU%2CST%3DTX%2CC%3DUS -H 'accept: application/json' -d {}
Response data: 
{
	"ca_chains": [
		{
			"end_point": {
				"subject": "CN=gpfs-dev-1.gpfs.net - CA endpoint certificate,OU=Storage+OU=Storage Scale+OU=GPFS Core,O=IBM Corp,L=HOU,ST=TX,C=US",
				"issuer": "CN=gpfs-dev-1.gpfs.net - CA interm2 certificate,OU=Storage+OU=Storage Scale+OU=GPFS Core,O=IBM Corp,L=HOU,ST=TX,C=US",
				"not_before": "2025-07-08 16:14:39 +0000 UTC",
				"not_after": "2035-07-06 16:14:39 +0000 UTC"
			},
			"cert_chain": [
				{
					"subject": "CN=gpfs-dev-1.gpfs.net - CA interm2 certificate,OU=Storage+OU=Storage Scale+OU=GPFS Core,O=IBM Corp,L=HOU,ST=TX,C=US",
					"issuer": "CN=gpfs-dev-1.gpfs.net - CA interm1 certificate,OU=Storage+OU=Storage Scale+OU=GPFS Core,O=IBM Corp,L=HOU,ST=TX,C=US",
					"not_before": "2025-07-08 16:14:35 +0000 UTC",
					"not_after": "2035-07-06 16:14:35 +0000 UTC"
				},
				{
					"subject": "CN=gpfs-dev-1.gpfs.net - CA interm1 certificate,OU=Storage+OU=Storage Scale+OU=GPFS Core,O=IBM Corp,L=HOU,ST=TX,C=US",
					"issuer": "CN=gpfs-dev-1.gpfs.net - CA root certificate,OU=Storage+OU=Storage Scale+OU=GPFS Core,O=IBM Corp,L=HOU,ST=TX,C=US",
					"not_before": "2025-07-08 16:14:32 +0000 UTC",
					"not_after": "2035-07-06 16:14:32 +0000 UTC"
				},
				{
					"subject": "CN=gpfs-dev-1.gpfs.net - CA root certificate,OU=Storage+OU=Storage Scale+OU=GPFS Core,O=IBM Corp,L=HOU,ST=TX,C=US",
					"issuer": "CN=gpfs-dev-1.gpfs.net - CA root certificate,OU=Storage+OU=Storage Scale+OU=GPFS Core,O=IBM Corp,L=HOU,ST=TX,C=US",
					"not_before": "2025-07-08 16:14:29 +0000 UTC",
					"not_after": "2035-07-06 16:14:29 +0000 UTC"
				}
			]
		}
	]
}