reserved instanceIBM Cloud

List trust store certificates - go

Get the list of certificates in the queue manager's certificate trust store.

(mqcloud *MqcloudV1) ListTrustStoreCertificates(listTrustStoreCertificatesOptions *ListTrustStoreCertificatesOptions) (result *TrustStoreCertificateDetailsCollection, response *core.DetailedResponse, err error)
(mqcloud *MqcloudV1) ListTrustStoreCertificatesWithContext(ctx context.Context, listTrustStoreCertificatesOptions *ListTrustStoreCertificatesOptions) (result *TrustStoreCertificateDetailsCollection, response *core.DetailedResponse, err error)

Request

Instantiate the ListTrustStoreCertificatesOptions struct and set the fields to provide parameter values for the ListTrustStoreCertificates method.

parameter WithContext method only
ctx
Context
 A context.Context instance that you can use to specify a timeout for the operation or to cancel an in-flight request.
CreateTrustStorePemCertificateOptions The CreateTrustStorePemCertificate options.
ServiceInstanceGuid
Required*
string

The GUID that uniquely identifies the IBM® MQ as a Service instance.

Possible values: length = 36, Value must match regular expression ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Example: a2b4d4bc-dadb-4637-bcec-9b7d1e723af8
QueueManagerID
Required*
string

The id of the queue manager to retrieve its full details.

Possible values: length = 32, Value must match regular expression /^[0-9a-fA-F]{32}$/

Examples: b8e1aeda078009cf3db74e90d5d42328

Example request

listTrustStoreCertificatesOptions := mqcloudService.NewListTrustStoreCertificatesOptions(
  "a2b4d4bc-dadb-4637-bcec-9b7d1e723af8",
  "b8e1aeda078009cf3db74e90d5d42328",
)

trustStoreCertificateDetailsCollection, response, err := mqcloudService.ListTrustStoreCertificates(listTrustStoreCertificatesOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(trustStoreCertificateDetailsCollection, "", "  ")
fmt.Println(string(b))

Response

TrustStoreCertificateDetailsCollection

A list of certificates in a queue manager's certificate trust store
TotalCount
int32

The total count of trust store certificates.

Example: 1
TrustStore

The list of trust store certificates.

Possible values: 0 ≤ number of items ≤ 50
 
  • ID
    Always included*
    string

    Id of the certificate.

    Possible values: 1 ≤ length ≤ 16, Value must match regular expression ^[0-9a-fA-F]*$

  • Label
    Always included*
    string

    Certificate label in queue manager store.

    Possible values: 1 ≤ length ≤ 64, Value must match regular expression ^[a-zA-Z0-9_.]*$

  • CertificateType
    Always included*
    string

    The type of certificate.

    Possible values: [trust_store]

  • FingerprintSha256
    Always included*
    string

    Fingerprint SHA256.

    Possible values: Value must match regular expression ^[A-F0-9]{2}(:[A-F0-9]{2}){31}$

  • SubjectDn
    Always included*
    string

    Subject's Distinguished Name.

  • SubjectCn
    Always included*
    string

    Subject's Common Name.

  • IssuerDn
    Always included*
    string

    Issuer's Distinguished Name.

  • IssuerCn
    Always included*
    string

    Issuer's Common Name.

  • Issued
    Always included*
    date-time

    The Date the certificate was issued.

  • Expiry
    Always included*
    date-time

    Expiry date for the certificate.

  • Trusted
    Always included*
    boolean

    Indicates whether a certificate is trusted.

  • Href
    Always included*
    string

    The URL for this trust store certificate.
Status code  
200 An object containing a list of trust store certificates
301 URI has permanently Moved
400 Bad Request
401 Unauthorized
404 Resource not found
429 Service Is Overused
500 Internal Server Error

Example response

Success example

{
  "total_count": 1,
  "trust_store": [
    {
      "id": "693d09e6f00e89d",
      "label": "qmgrcert",
      "certificate_type": "trust_store",
      "fingerprint_sha256": "BB:C2:09:2B:0C:68:EC:D2:1A:09:DA:F7:51:8D:29:F3:64:88:21:65:40:02:BD:20:1B:11:91:50:8D:90:8B:66",
      "subject_dn": "CN=*.qm1.eu-de.mq.appdomain.cloud",
      "subject_cn": "*.qm1.eu-de.mq.appdomain.cloud",
      "issuer_dn": "CN=R3,O=Let's Encrypt,C=US",
      "issuer_cn": "R3",
      "issued": "2023-05-29T11:17:00Z",
      "expiry": "2023-08-27T11:16:59Z",
      "trusted": true,
      "href": "https://api.private.eu-de.mq2.cloud.ibm.com/v1/a2b4d4bc-dadb-4637-bcec-9b7d1e723af8/queue_managers/b8e1aeda078009cf3db74e90d5d42328/certificates/trust_store/693d09e6f00e89d"
    }
  ]
}