rules: info-title-format: description: API title must reference Amazon Global Accelerator severity: warn given: "$.info.title" then: function: pattern functionOptions: match: "^Amazon Global Accelerator" info-description-required: description: API must have a description severity: error given: "$.info" then: field: description function: truthy info-version-required: description: API must have a version severity: error given: "$.info" then: field: version function: truthy servers-required: description: Servers must be defined severity: error given: "$" then: field: servers function: truthy operation-summary-required: description: Every operation must have a summary severity: error given: "$.paths[*][get,post,put,patch,delete]" then: field: summary function: truthy operation-summary-company-prefix: description: Operation summaries must start with Amazon Global Accelerator severity: warn given: "$.paths[*][get,post,put,patch,delete].summary" then: function: pattern functionOptions: match: "^Amazon Global Accelerator" operation-id-required: description: Every operation must have an operationId severity: error given: "$.paths[*][get,post,put,patch,delete]" then: field: operationId function: truthy operation-description-required: description: Every operation must have a description severity: warn given: "$.paths[*][get,post,put,patch,delete]" then: field: description function: truthy response-success-required: description: Operations must have at least one success response severity: error given: "$.paths[*][get,post,put,patch,delete].responses" then: function: schema functionOptions: schema: type: object anyOf: - required: ["200"] - required: ["201"] - required: ["204"] response-description-required: description: Responses must have descriptions severity: warn given: "$.paths[*][get,post,put,patch,delete].responses[*]" then: field: description function: truthy security-schemes-defined: description: Security schemes should be defined in components severity: warn given: "$" then: field: components.securitySchemes function: truthy schema-properties-typed: description: Schema properties should have types severity: info given: "$.components.schemas[*].properties[*]" then: field: type function: truthy no-empty-descriptions: description: Descriptions must not be empty severity: error given: "$..description" then: function: pattern functionOptions: match: ".+" microcks-operation-extension: description: Operations should have x-microcks-operation severity: info given: "$.paths[*][get,post,put,patch,delete]" then: field: x-microcks-operation function: truthy