Skip to content

Inconsistent swagger description with implementation (Alerts) #1022

@te-koyanagi

Description

@te-koyanagi

Issue/Feature Description:
Found an inconsistentency in the swagger description with implementation (openapi-spec/swagger.yaml) about Alerts.

Why this issue to fixed / feature is needed(give scenarios or use cases):
It must be correct for better user experience as no API document exists other than this swagger description.

How to reproduce, in case of a bug:
Following API works as expected, but not in the swagger.yaml.

$ curl -s -X GET http://192.168.231.101:31000/v1/storages/014a38ed-c60e-4994-9f5a-fc7b7f0a5d4d/alerts | jq .
{
  "alerts": [
    {
      "alert_id": 65766686728,
      "alert_name": "CA Certificate Has Expired",
      "severity": "Critical",
      "category": "Fault",
      "type": "NotSpecified",
      "sequence_number": 21168209,
      "occur_time": 1698715016000,
      "description": "The (CA certificate of Call Home authentication, use (N/A)) has expired, and a new one must be imported and activated.",
      "recovery_advice": "Generate and import a valid CA certificate.",
      "resource_type": "Storage",
      "location": "CertificateType=8,Deadline=2023-10-30,use=N/A",
      "storage_id": "014a38ed-c60e-4994-9f5a-fc7b7f0a5d4d",
      "storage_name": "OceanStor",
      "vendor": "Huawei",
      "model": "dorado01",
      "serial_number": "2102352KRP10K1000001"
    }
  ]
}

Other Notes / Environment Information: (Please give the env information, log link or any useful information for this issue)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions