From 8137832ef9e5163fca232e7152c4ba55b7ef6350 Mon Sep 17 00:00:00 2001 From: Fiete Ostkamp Date: Tue, 13 Dec 2022 21:05:47 +0000 Subject: Update openapi files in the docs - add yaml versions of the spec to the offered apis section - rename swagger files to openapi Issue-ID: SDC-4308 Signed-off-by: Fiete Ostkamp Change-Id: Ie34e562ccf294c8d9f19d3cad30a5a626c3db0ba --- docs/swagger/swagger-sdce-6.json | 573 --------------------------------------- 1 file changed, 573 deletions(-) delete mode 100644 docs/swagger/swagger-sdce-6.json (limited to 'docs/swagger/swagger-sdce-6.json') diff --git a/docs/swagger/swagger-sdce-6.json b/docs/swagger/swagger-sdce-6.json deleted file mode 100644 index 394bd5c64b..0000000000 --- a/docs/swagger/swagger-sdce-6.json +++ /dev/null @@ -1,573 +0,0 @@ -{ - "openapi":"3.0.1", - "info":{ - "contact":{ - "email":"onap-discuss@lists.onap.org", - "name":"ONAP", - "url":"https://onap.readthedocs.io" - }, - "description":"SDC API for distribution subscription (SDCE-6)", - "license":{ - "name":"Apache 2.0", - "url":"http://www.apache.org/licenses/LICENSE-2.0" - }, - "title":"SPC API: SDCE-6", - "version":"1.0" - }, - "servers":[ - { - "description":"SDCE-6 APIs", - "url":"/sdc" - } - ], - "paths":{ - "/v1/artifactTypes":{ - "get":{ - "description":"Artifact types list", - "operationId":"getValidArtifactTypes", - "parameters":[ - { - "description":"X-ECOMP-RequestID header", - "in":"header", - "name":"X-ECOMP-RequestID", - "schema":{ - "type":"string" - } - }, - { - "description":"X-ECOMP-InstanceID header", - "in":"header", - "name":"X-ECOMP-InstanceID", - "required":true, - "schema":{ - "type":"string" - } - }, - { - "description":"The username and password", - "in":"header", - "name":"Authorization", - "required":true, - "schema":{ - "type":"string" - } - }, - { - "description":"The username and password", - "in":"header", - "name":"Accept", - "required":true, - "schema":{ - "type":"string" - } - } - ], - "responses":{ - "200":{ - "content":{ - "application/json":{ - "schema":{ - "type":"array", - "items":{ - "type":"string" - } - } - } - }, - "description":"Artifact types list fetched successfully" - }, - "400":{ - "description":"Missing 'X-ECOMP-InstanceID' HTTP header - POL5001" - }, - "401":{ - "description":"ECOMP component should authenticate itself and to re-send again HTTP request with its Basic Authentication credentials - POL5002" - }, - "403":{ - "description":"ECOMP component is not authorized - POL5003" - }, - "405":{ - "description":"Method Not Allowed : Invalid HTTP method type used to register for distribution ( POST,PUT,DELETE will be rejected) - POL4050" - }, - "500":{ - "description":"The registration failed due to internal SDC problem or Cambria Service failure ECOMP Component should continue the attempts to register for distribution - POL5000" - } - }, - "servers":[ - { - "url":"/sdc", - "variables":{ - - } - } - ], - "summary":"Fetches available artifact types list", - "tags":[ - "SDCE-6 APIs" - ] - } - },"/v1/distributionUebCluster" : { - "get" : { - "description" : "UEB Server List", - "operationId" : "getUebServerList", - "parameters" : [ { - "description" : "X-ECOMP-RequestID header", - "in" : "header", - "name" : "X-ECOMP-RequestID", - "schema" : { - "type" : "string" - } - }, { - "description" : "X-ECOMP-InstanceID header", - "in" : "header", - "name" : "X-ECOMP-InstanceID", - "required" : true, - "schema" : { - "type" : "string" - } - }, { - "description" : "Determines the format of the body of the response", - "in" : "header", - "name" : "Accept", - "schema" : { - "type" : "string" - } - }, { - "description" : "The username and password", - "in" : "header", - "name" : "Authorization", - "required" : true, - "schema" : { - "type" : "string" - } - } ], - "responses" : { - "200" : { - "content" : { - "application/json" : { - "schema" : { - "type" : "array", - "items" : { - "$ref" : "#/components/schemas/ServerListResponse" - } - } - } - }, - "description" : "ECOMP component is authenticated and list of Cambria API server’s FQDNs is returned" - }, - "400" : { - "description" : "Missing 'X-ECOMP-InstanceID' HTTP header - POL5001" - }, - "401" : { - "description" : "ECOMP component should authenticate itself and to re-send again HTTP request with its credentials for Basic Authentication - POL5002" - }, - "403" : { - "description" : "ECOMP component is not authorized - POL5003" - }, - "405" : { - "description" : "Method Not Allowed: Invalid HTTP method type used ( PUT,DELETE,POST will be rejected) - POL4050" - }, - "500" : { - "description" : "The GET request failed either due to internal SDC problem or Cambria Service failure. ECOMP Component should continue the attempts to get the needed information - POL5000" - } - }, - "servers" : [ { - "url" : "/sdc", - "variables" : { } - } ], - "summary" : "return the available UEB Server List", - "tags" : [ "SDCE-6 APIs" ] - } - }, - "/v1/distributionKafkaData":{ - "get":{ - "description":"Kafka bootstrap server and topic list", - "operationId":"getKafkaData", - "parameters":[ - { - "description":"X-ECOMP-RequestID header", - "in":"header", - "name":"X-ECOMP-RequestID", - "schema":{ - "type":"string" - } - }, - { - "description":"X-ECOMP-InstanceID header", - "in":"header", - "name":"X-ECOMP-InstanceID", - "required":true, - "schema":{ - "type":"string" - } - }, - { - "description":"Determines the format of the body of the response", - "in":"header", - "name":"Accept", - "schema":{ - "type":"string" - } - }, - { - "description":"The username and password", - "in":"header", - "name":"Authorization", - "required":true, - "schema":{ - "type":"string" - } - } - ], - "responses":{ - "200":{ - "content":{ - "application/json":{ - "schema":{ - "type":"array", - "items":{ - "$ref":"#/components/schemas/KafkaDataResponse" - } - } - } - }, - "description":"ECOMP component is authenticated and kafka endpoint and topic list is returned" - }, - "400":{ - "description":"Missing 'X-ECOMP-InstanceID' HTTP header - POL5001" - }, - "401":{ - "description":"ECOMP component should authenticate itself and to re-send again HTTP request with its credentials for Basic Authentication - POL5002" - }, - "403":{ - "description":"ECOMP component is not authorized - POL5003" - }, - "405":{ - "description":"Method Not Allowed: Invalid HTTP method type used ( PUT,DELETE,POST will be rejected) - POL4050" - }, - "500":{ - "description":"The GET request failed either due to internal SDC problem or Cambria Service failure. ECOMP Component should continue the attempts to get the needed information - POL5000" - } - }, - "servers":[ - { - "url":"/sdc", - "variables":{ - - } - } - ], - "summary":"return the Kafka bootstrap server and topic list", - "tags":[ - "SDCE-6 APIs" - ] - } - }, - "/v1/registerForDistribution":{ - "post":{ - "description":"Subscription status", - "operationId":"registerForDistribution", - "parameters":[ - { - "description":"X-ECOMP-RequestID header", - "in":"header", - "name":"X-ECOMP-RequestID", - "schema":{ - "type":"string" - } - }, - { - "description":"X-ECOMP-InstanceID header", - "in":"header", - "name":"X-ECOMP-InstanceID", - "required":true, - "schema":{ - "type":"string" - } - }, - { - "description":"Determines the format of the body of the response", - "in":"header", - "name":"Accept", - "schema":{ - "type":"string" - } - }, - { - "description":"Determines the format of the body of the request", - "in":"header", - "name":"Content-Type", - "required":true, - "schema":{ - "type":"string" - } - }, - { - "description":"Length of the request body", - "in":"header", - "name":"Content-Length", - "required":true, - "schema":{ - "type":"string" - } - }, - { - "description":"The username and password", - "in":"header", - "name":"Authorization", - "required":true, - "schema":{ - "type":"string" - } - } - ], - "responses":{ - "200":{ - "content":{ - "application/json":{ - "schema":{ - "type":"array", - "items":{ - "$ref":"#/components/schemas/TopicRegistrationResponse" - } - } - } - }, - "description":"ECOMP component is successfully registered for distribution" - }, - "400":{ - "description":"Invalid Body : Specified 'distrEnvName' doesn’t exist - POL4137" - }, - "401":{ - "description":"ECOMP component should authenticate itself and to re-send again HTTP request with its Basic Authentication credentials - POL5002" - }, - "403":{ - "description":"ECOMP component is not authorized - POL5003" - }, - "405":{ - "description":"Method Not Allowed : Invalid HTTP method type used to register for distribution ( PUT,DELETE,GET will be rejected) - POL4050" - }, - "500":{ - "description":"The registration failed due to internal SDC problem or Cambria Service failure ECOMP Component should continue the attempts to register for distribution - POL5000" - } - }, - "servers":[ - { - "url":"/sdc", - "variables":{ - - } - } - ], - "summary":"Subscribes for distribution notifications", - "tags":[ - "SDCE-6 APIs" - ] - } - }, - "/v1/unRegisterForDistribution":{ - "post":{ - "description":"Subscription status", - "operationId":"unRegisterForDistribution", - "parameters":[ - { - "description":"X-ECOMP-RequestID header", - "in":"header", - "name":"X-ECOMP-RequestID", - "schema":{ - "type":"string" - } - }, - { - "description":"X-ECOMP-InstanceID header", - "in":"header", - "name":"X-ECOMP-InstanceID", - "required":true, - "schema":{ - "type":"string" - } - }, - { - "description":"Determines the format of the body of the response", - "in":"header", - "name":"Accept", - "schema":{ - "type":"string" - } - }, - { - "description":"Determines the format of the body of the request", - "in":"header", - "name":"Content-Type", - "required":true, - "schema":{ - "type":"string" - } - }, - { - "description":"Length of the request body", - "in":"header", - "name":"Content-Length", - "required":true, - "schema":{ - "type":"string" - } - }, - { - "description":"The username and password", - "in":"header", - "name":"Authorization", - "required":true, - "schema":{ - "type":"string" - } - } - ], - "responses":{ - "204":{ - "content":{ - "application/json":{ - "schema":{ - "type":"array", - "items":{ - "$ref":"#/components/schemas/TopicUnregistrationResponse" - } - } - } - }, - "description":"ECOMP component is successfully unregistered" - }, - "400":{ - "description":"Invalid Body : Specified 'distrEnvName' doesn’t exist - POL4137" - }, - "401":{ - "description":"ECOMP component should authenticate itself and to re-send again HTTP request with its Basic Authentication credentials - POL5002" - }, - "403":{ - "description":"ECOMP component is not authorized - POL5003" - }, - "405":{ - "description":"Method Not Allowed : Invalid HTTP method type used to register for distribution ( PUT,DELETE,GET will be rejected) - POL4050" - }, - "500":{ - "description":"The registration failed due to internal SDC problem or Cambria Service failure ECOMP Component should continue the attempts to register for distribution - POL5000" - } - }, - "servers":[ - { - "url":"/sdc", - "variables":{ - - } - } - ], - "summary":"Removes from subscription for distribution notifications", - "tags":[ - "SDCE-6 APIs" - ] - } - } - }, - "components":{ - "schemas":{ - "RegistrationRequest":{ - "type":"object", - "properties":{ - "apiPublicKey":{ - "type":"string" - }, - "distEnvEndPoints":{ - "type":"array", - "items":{ - "type":"string" - } - }, - "distrEnvName":{ - "type":"string" - }, - "isConsumerToSdcDistrStatusTopic":{ - "type":"boolean" - }, - "managerApiPublicKey":{ - "type":"string" - }, - "managerApiSecretKey":{ - "type":"string" - } - } - }, - "ServerListResponse":{ - "type":"object", - "properties":{ - "uebServerList":{ - "type":"array", - "items":{ - "type":"string" - } - } - } - }, - "KafkaDataResponse":{ - "type":"object", - "properties":{ - "kafkaBootStrapServer":{ - "type":"string" - }, - "distrNotificationTopicName":{ - "type":"string" - }, - "distrStatusTopicName":{ - "type":"string" - } - } - }, - "TopicRegistrationResponse":{ - "type":"object", - "properties":{ - "distrNotificationTopicName":{ - "type":"string" - }, - "distrStatusTopicName":{ - "type":"string" - } - } - }, - "TopicUnregistrationResponse":{ - "type":"object", - "properties":{ - "distrNotificationTopicName":{ - "type":"string" - }, - "distrStatusTopicName":{ - "type":"string" - }, - "notificationUnregisterResult":{ - "type":"string", - "enum":[ - "OK", - "CONNNECTION_ERROR", - "NOT_FOUND", - "TOPIC_ALREADY_EXIST", - "OBJECT_NOT_FOUND", - "INTERNAL_SERVER_ERROR", - "AUTHENTICATION_ERROR", - "UNKNOWN_HOST_ERROR" - ] - }, - "statusUnregisterResult":{ - "type":"string", - "enum":[ - "OK", - "CONNNECTION_ERROR", - "NOT_FOUND", - "TOPIC_ALREADY_EXIST", - "OBJECT_NOT_FOUND", - "INTERNAL_SERVER_ERROR", - "AUTHENTICATION_ERROR", - "UNKNOWN_HOST_ERROR" - ] - } - } - } - } - } -} \ No newline at end of file -- cgit 1.2.3-korg