fix: improve access request error message

[feichashao]

Assisted by AI.

What type of PR is this?

• fix (Bug Fix)
• feat (New Feature)
• docs (Documentation)
• test (Test Coverage)
• chore (Clean Up / Maintenance Tasks)
• other (Anything that doesn't fit the above)

What this PR does / Why we need it?

Improve the error message.

When I was oncall, I got an error like the below:

ocm-backplane accessrequest create -r xxxxx
ERRO[0003] issue 'OHSS-xxxxx' passed with the --notification-issue option is invalid: You do not have the permission to see the specified issue.: request failed. Please analyze the request body for more details. Status code: 401 

The actual reason is that I am missing the Jira token.

This PR improves the error message, so the user knows to check the Jira token.

Which Jira/Github issue(s) does this PR fix?

• Related Issue #
• Closes #

Special notes for your reviewer

Unit Test Coverage

Guidelines

• If it's a new sub-command or new function to an existing sub-command, please cover at least 50% of the code
• If it's a bug fix for an existing sub-command, please cover 70% of the code

Test coverage checks

• Added unit tests
• Created jira card to add unit test
• This PR may not need unit tests

Pre-checks (if applicable)

• Ran unit tests locally
• Validated the changes in a cluster
• Included documentation changes with PR
• Backward compatible

/label tide/merge-method-squash

[openshift-ci]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: feichashao

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [feichashao]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[feichashao]

/hold

I haven't validated it locally after change. Not easy to find another lockbox cluster for testing.

[openshift-ci]

@feichashao: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 52.91%. Comparing base (bf30077) to head (f32bf6d).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #874   +/-   ##
=======================================
  Coverage   52.91%   52.91%           
=======================================
  Files          86       86           
  Lines        6525     6525           
=======================================
  Hits         3453     3453           
  Misses       2610     2610           
  Partials      462      462           

Files with missing lines	Coverage Δ
pkg/accessrequest/accessRequest.go	66.44% <100.00%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[feichashao]

There's already a message if the Jira token is not defined. My issue seems to be another issue.

ERRO[0002] failed to create the notification issue, consider creating the issue separately and passing it with the --notification-issue option: failed to create JIRA notification issue: JIRA token is not defined, consider defining it running 'ocm-backplane config set jira-token <token value>'

I am closing this PR.