OpenAPI / Swagger service plan resources are missing properties - Githubissues

openservicebrokerapi / servicebroker

Open Service Broker API Specification

https://openservicebrokerapi.org/

Apache License 2.0

1.19k stars 436 forks source link

OpenAPI / Swagger service plan resources are missing properties #739

Closed WalkerGriggs closed 3 years ago

WalkerGriggs commented 3 years ago

What is the problem?

The service broker spec lists 11 properties for the service plan resource. Of those 11:

openapi.yaml is missing:

plan_updateable
maximum_polling_duration
binding_rotatable

swagger.yaml is missing:

binding_rotatable

Who does this affect?

This affects all authors and developers looking to adopt the OpenAPI v2/3 spec.

Do you have any proposed solutions?

Add the additional properties to their respective spec files.

Additional context

https://github.com/openservicebrokerapi/servicebroker/blob/45c50bb4e14fc073d7098e9891f6385949d69ecb/openapi.yaml#L697-L714

https://github.com/openservicebrokerapi/servicebroker/blob/45c50bb4e14fc073d7098e9891f6385949d69ecb/swagger.yaml#L549-L570