reserved instanceIBM Cloud

Get a trust store certificate - go

Get a trust store certificate from a queue manager.

(mqcloud *MqcloudV1) GetTrustStoreCertificate(getTrustStoreCertificateOptions *GetTrustStoreCertificateOptions) (result *TrustStoreCertificateDetails, response *core.DetailedResponse, err error)
(mqcloud *MqcloudV1) GetTrustStoreCertificateWithContext(ctx context.Context, getTrustStoreCertificateOptions *GetTrustStoreCertificateOptions) (result *TrustStoreCertificateDetails, response *core.DetailedResponse, err error)

Request

Instantiate the GetTrustStoreCertificateOptions struct and set the fields to provide parameter values for the GetTrustStoreCertificate 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
CertificateFile
Required*
io.ReadCloser

The filename and path of the certificate to be uploaded.

Possible values: 1500 ≤ length ≤ 65537

Examples: [B@36ab3814

Example request

getTrustStoreCertificateOptions := mqcloudService.NewGetTrustStoreCertificateOptions(
  "a2b4d4bc-dadb-4637-bcec-9b7d1e723af8",
  "b8e1aeda078009cf3db74e90d5d42328",
  "9b7d1e723af8233",
)

trustStoreCertificateDetails, response, err := mqcloudService.GetTrustStoreCertificate(getTrustStoreCertificateOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(trustStoreCertificateDetails, "", "  ")
fmt.Println(string(b))

Response

TrustStoreCertificateDetails The details of a trust store certificate in a queue manager certificate trust store
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.
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 details of the trust store certificate
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

{
  "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"
}