feat: Add new metric kube_job_status_suspended

[Indresh2410]

What this PR does / why we need it:
Kubernetes has released a new feature which can suspend a job
https://kubernetes.io/docs/concepts/workloads/controllers/job/#suspending-a-job

Emit metrics if the job is suspended

How does this change affect the cardinality of KSM: (increases, decreases or does not change cardinality)
Increases

Which issue(s) this PR fixes (optional, in fixes #<issue number>(, fixes #<issue_number>, ...) format, will close the issue(s) when PR gets merged)
Fixes # #2511

[k8s-ci-robot]

This issue is currently awaiting triage.

If kube-state-metrics contributors determine this is a relevant issue, they will accept it by applying the triage/accepted label and provide further guidance.

The triage/accepted label can be added by org members by writing /triage accepted in a comment.

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.

[k8s-ci-robot]

Welcome @Indresh2410!

It looks like this is your first PR to kubernetes/kube-state-metrics 🎉. Please refer to our pull request process documentation to help your PR have a smooth ride to approval.

You will be prompted by a bot to use commands during the review process. Do not be afraid to follow the prompts! It is okay to experiment. Here is the bot commands documentation.

You can also check if kubernetes/kube-state-metrics has its own contribution guidelines.

You may want to refer to our testing guide if you run into trouble with your tests not passing.

If you are having difficulty getting your pull request seen, please follow the recommended escalation practices. Also, for tips and tricks in the contribution process you may want to read the Kubernetes contributor cheat sheet. We want to make sure your contribution gets all the attention it needs!

Thank you, and welcome to Kubernetes. 😃

[CatherineF-dev]

We can follow other metrics to have only 2 labels: job_name and namespace name.
https://github.com/kubernetes/kube-state-metrics/blob/a6cb8ded1e9c3688e475f94e0dabbff35a5d2396/docs/metrics/workload/job-metrics.md

[Indresh2410]

Thanks @CatherineF-dev . Have addressed them. Can you please check once?

[CatherineF-dev]

/lgtm

[Indresh2410]

@CatherineF-dev have updated doc. Because of which label got removed. Can you please check once again. SFIC

[CatherineF-dev]

/lgtm

[mrueg]

Can you rebase this on latest main branch? Thanks!

[Indresh2410]

Have rebased @mrueg . Can you please check once?

[mrueg]

@Indresh2410 it looks like the newline is missing in the doc. Could you add it?

[Indresh2410]

Thanks @mrueg . Have addressed it. Can you please check once?

[mrueg]

/lgtm

Thanks for your contribution!

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: CatherineF-dev, Indresh2410, mrueg

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

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [mrueg]

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