@itentialopensource/adapter-onap_sdc

{ "swagger": "2.0", "info": { "version": "1.2.0", "title": "onap_sdc" }, "basePath": "/sdc", "tags": [ { "name": "Distribution Catalog Servlet" }, { "name": "Distribution Servlet" }, { "name": "Artifact External Servlet" }, { "name": "Asset Metadata External Servlet" }, { "name": "CRUD External Servlet" }, { "name": "Service Activation External Servlet" } ], "paths": { "/v1/catalog/services/{serviceName}/{serviceVersion}/artifacts/{artifactName}": { "get": { "tags": [ "Distribution Catalog Servlet" ], "summary": "Download service artifact", "description": "Returns downloaded artifact", "operationId": "downloadServiceArtifact", "consumes": [ "application/json" ], "produces": [ "application/octet-stream" ], "parameters": [ { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "name": "serviceName", "in": "path", "required": true, "type": "string" }, { "name": "serviceVersion", "in": "path", "required": true, "type": "string" }, { "name": "artifactName", "in": "path", "required": true, "type": "string" } ], "responses": { "200": { "description": "The artifact is found and streamed.", "schema": { "type": "string" } }, "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" }, "404": { "description": "Specified artifact is not found - SVC4505" }, "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" } } } }, "/v1/catalog/services/{serviceName}/{serviceVersion}/resourceInstances/{resourceInstanceName}/artifacts/{artifactName}": { "get": { "tags": [ "Distribution Catalog Servlet" ], "summary": "Download resource instance artifact", "description": "Returns downloaded artifact", "operationId": "downloadResourceInstanceArtifactByName", "consumes": [ "application/json" ], "produces": [ "application/octet-stream" ], "parameters": [ { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "name": "serviceName", "in": "path", "required": true, "type": "string" }, { "name": "serviceVersion", "in": "path", "required": true, "type": "string" }, { "name": "resourceInstanceName", "in": "path", "required": true, "type": "string" }, { "name": "artifactName", "in": "path", "required": true, "type": "string" } ], "responses": { "200": { "description": "The artifact is found and streamed.", "schema": { "type": "string" } }, "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" }, "404": { "description": "Specified artifact is not found - SVC4505" }, "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" } } } }, "/v1/catalog/services/{serviceName}/{serviceVersion}/resources/{resourceName}/{resourceVersion}/artifacts/{artifactName}": { "get": { "tags": [ "Distribution Catalog Servlet" ], "summary": "Download resource artifact", "description": "Returns downloaded artifact", "operationId": "downloadResourceArtifact", "consumes": [ "application/json" ], "produces": [ "application/octet-stream" ], "parameters": [ { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "name": "serviceName", "in": "path", "required": true, "type": "string" }, { "name": "serviceVersion", "in": "path", "required": true, "type": "string" }, { "name": "resourceName", "in": "path", "required": true, "type": "string" }, { "name": "resourceVersion", "in": "path", "required": true, "type": "string" }, { "name": "artifactName", "in": "path", "required": true, "type": "string" } ], "responses": { "200": { "description": "The artifact is found and streamed.", "schema": { "type": "string" } }, "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" }, "404": { "description": "Specified artifact is not found - SVC4505" }, "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" } } } }, "/v1/registerForDistribution": { "post": { "tags": [ "Distribution Servlet" ], "summary": "Subscription status", "description": "Subscribes for distribution notifications", "operationId": "registerForDistribution", "consumes": [ "application/json" ], "produces": [ "application/json" ], "parameters": [ { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Content-Type", "in": "header", "description": "Determines the format of the body of the request", "required": true, "type": "string" }, { "name": "Content-Length", "in": "header", "description": "Length of the request body", "required": true, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "in": "body", "name": "requestJson", "description": "json describe the artifact", "required": true, "schema": { "$ref": "#/definitions/RegistrationRequest" } } ], "responses": { "200": { "description": "ECOMP component is successfully registered for distribution", "schema": { "$ref": "#/definitions/TopicRegistrationResponse" } }, "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" } } } }, "/v1/artifactTypes": { "get": { "tags": [ "Distribution Servlet" ], "summary": "Artifact types list", "description": "Fetches available artifact types list", "operationId": "getValidArtifactTypes", "consumes": [ "application/json" ], "produces": [ "application/json" ], "parameters": [ { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "The username and password", "required": true, "type": "string" } ], "responses": { "200": { "description": "Artifact types list fetched successfully", "schema": { "type": "string" } }, "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" } } } }, "/v1/unRegisterForDistribution": { "post": { "tags": [ "Distribution Servlet" ], "summary": "Subscription status", "description": "Removes from subscription for distribution notifications", "operationId": "unRegisterForDistribution", "consumes": [ "application/json" ], "produces": [ "application/json" ], "parameters": [ { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Content-Type", "in": "header", "description": "Determines the format of the body of the request", "required": true, "type": "string" }, { "name": "Content-Length", "in": "header", "description": "Length of the request body", "required": true, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "in": "body", "name": "requestJson", "description": "json describe the artifact", "required": true, "schema": { "$ref": "#/definitions/RegistrationRequest" } } ], "responses": { "204": { "description": "ECOMP component is successfully unregistered", "schema": { "$ref": "#/definitions/TopicUnregistrationResponse" } }, "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" } } } }, "/v1/distributionUebCluster": { "get": { "tags": [ "Distribution Servlet" ], "summary": "UEB Server List", "description": "return the available UEB Server List", "operationId": "getUebServerList", "consumes": [ "application/json" ], "produces": [ "application/json" ], "parameters": [ { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" } ], "responses": { "200": { "description": "ECOMP component is authenticated and list of Cambria API server’s FQDNs is returned", "schema": { "$ref": "#/definitions/ServerListResponse" } }, "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" } } } }, "/v1/catalog/{assetType}/{uuid}/artifacts": { "post": { "tags": [ "Artifact External Servlet" ], "summary": "uploads of artifact to a resource or service", "description": "uploads of artifact to a resource or service", "operationId": "uploadArtifact", "produces": [ "application/json" ], "parameters": [ { "name": "Content-Type", "in": "header", "description": "Determines the format of the body of the request", "required": true, "type": "string" }, { "name": "Content-MD5", "in": "header", "description": "The value for this header must be the MD5 checksum over the whole json body", "required": true, "type": "string" }, { "name": "USER_ID", "in": "header", "description": "The user ID of the DCAE Designer. This user must also have Designer role in SDC", "required": true, "type": "string" }, { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "name": "assetType", "in": "path", "description": "The requested asset type", "required": true, "type": "string", "enum": [ "resources", "services" ] }, { "name": "uuid", "in": "path", "description": "The uuid of the asset as published in the metadata", "required": true, "type": "string" }, { "in": "body", "name": "body", "description": "json describe the artifact", "required": true, "schema": { "$ref": "#/definitions/ArtifactDefinition" } } ], "responses": { "200": { "description": "Artifact uploaded", "schema": { "$ref": "#/definitions/ArtifactDefinition" } }, "400": { "description": "Restricted Operation – the user provided does not have role of Designer or the asset is being used by another designer - SVC4301" }, "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" }, "404": { "description": "Specified resource is not found - SVC4063" }, "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" } } } }, "/v1/catalog/{assetType}/{uuid}/artifacts/{artifactUUID}": { "get": { "tags": [ "Artifact External Servlet" ], "summary": "Download component artifact", "description": "Returns downloaded artifact", "operationId": "downloadComponentArtifact", "produces": [ "application/octet-stream" ], "parameters": [ { "name": "USER_ID", "in": "header", "description": "The user ID of the DCAE Designer. This user must also have Designer role in SDC", "required": true, "type": "string" }, { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "name": "assetType", "in": "path", "description": "The requested asset type", "required": true, "type": "string", "enum": [ "resources", "services" ] }, { "name": "uuid", "in": "path", "description": "The uuid of the asset as published in the metadata", "required": true, "type": "string" }, { "name": "artifactUUID", "in": "path", "description": "The uuid of the artifact as published in the asset detailed metadata or in the response of the upload / update operation", "required": true, "type": "string" } ], "responses": { "200": { "description": "Artifact downloaded", "schema": { "type": "string" } }, "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" }, "404": { "description": "Artifact was not found - SVC4505" }, "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" } } }, "post": { "tags": [ "Artifact External Servlet" ], "summary": "updates an artifact on a resource or service", "description": "uploads of artifact to a resource or service", "operationId": "updateArtifact", "produces": [ "application/json" ], "parameters": [ { "name": "Content-Type", "in": "header", "description": "Determines the format of the body of the request", "required": true, "type": "string" }, { "name": "Content-MD5", "in": "header", "description": "The value for this header must be the MD5 checksum over the whole json body", "required": true, "type": "string" }, { "name": "USER_ID", "in": "header", "description": "The user ID of the DCAE Designer. This user must also have Designer role in SDC", "required": true, "type": "string" }, { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "name": "assetType", "in": "path", "description": "The requested asset type", "required": true, "type": "string", "enum": [ "resources", "services" ] }, { "name": "uuid", "in": "path", "description": "The uuid of the asset as published in the metadata", "required": true, "type": "string" }, { "name": "artifactUUID", "in": "path", "description": "The uuid of the artifact as published in the asset detailed metadata or in the response of the upload / update operation", "required": true, "type": "string" }, { "in": "body", "name": "body", "description": "json describe the artifact", "required": true, "schema": { "$ref": "#/definitions/ArtifactDefinition" } } ], "responses": { "200": { "description": "Artifact updated", "schema": { "$ref": "#/definitions/ArtifactDefinition" } }, "400": { "description": "Artifact name is missing in input - SVC4128" }, "401": { "description": "ECOMP component should authenticate itself and to re-send again HTTP request with its Basic Authentication credentials - POL5002" }, "403": { "description": "Asset is being edited by different user. Only one user can checkout and edit an asset on given time. The asset will be available for checkout after the other user will checkin the asset - SVC4086" }, "404": { "description": "Specified resource is not found - SVC4063" }, "405": { "description": "Method Not Allowed: Invalid HTTP method type used (PUT,DELETE,POST will be rejected) - POL4050" }, "409": { "description": "Restricted Operation – the user provided does not have role of Designer or the asset is being used by another designer - SVC4301" }, "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" } } }, "delete": { "tags": [ "Artifact External Servlet" ], "summary": "deletes an artifact of a resource or service", "description": "deletes an artifact of a resource or service", "operationId": "deleteArtifact", "produces": [ "application/json" ], "parameters": [ { "name": "USER_ID", "in": "header", "description": "The user ID of the DCAE Designer. This user must also have Designer role in SDC", "required": true, "type": "string" }, { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "name": "assetType", "in": "path", "description": "The requested asset type", "required": true, "type": "string", "enum": [ "resources", "services" ] }, { "name": "uuid", "in": "path", "description": "The uuid of the asset as published in the metadata", "required": true, "type": "string" }, { "name": "artifactUUID", "in": "path", "description": "The uuid of the artifact as published in the asset detailed metadata or in the response of the upload / update operation", "required": true, "type": "string" } ], "responses": { "200": { "description": "Artifact deleted", "schema": { "$ref": "#/definitions/ArtifactDefinition" } }, "400": { "description": "Artifact name is missing in input - SVC4128" }, "401": { "description": "ECOMP component should authenticate itself and to re-send again HTTP request with its Basic Authentication credentials - POL5002" }, "403": { "description": "Asset is being edited by different user. Only one user can checkout and edit an asset on given time. The asset will be available for checkout after the other user will checkin the asset - SVC4086" }, "404": { "description": "Specified resource is not found - SVC4063" }, "405": { "description": "Method Not Allowed: Invalid HTTP method type used (PUT,DELETE,POST will be rejected) - POL4050" }, "409": { "description": "Restricted Operation – the user provided does not have role of Designer or the asset is being used by another designer - SVC4301" }, "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" } } } }, "/v1/catalog/{assetType}/{uuid}/resourceInstances/{resourceInstanceName}/artifacts": { "post": { "tags": [ "Artifact External Servlet" ], "summary": "uploads an artifact to a resource instance", "description": "uploads an artifact to a resource instance", "operationId": "uploadArtifactToInstance", "produces": [ "application/json" ], "parameters": [ { "name": "Content-Type", "in": "header", "description": "Determines the format of the body of the request", "required": true, "type": "string" }, { "name": "Content-MD5", "in": "header", "description": "The value for this header must be the MD5 checksum over the whole json body", "required": true, "type": "string" }, { "name": "USER_ID", "in": "header", "description": "The user ID of the DCAE Designer. This user must also have Designer role in SDC", "required": true, "type": "string" }, { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "name": "assetType", "in": "path", "description": "The requested asset type", "required": true, "type": "string", "enum": [ "resources", "services" ] }, { "name": "uuid", "in": "path", "description": "The uuid of the asset as published in the metadata", "required": true, "type": "string" }, { "name": "resourceInstanceName", "in": "path", "description": "The component instance name (as publishedin the response of the detailed query)", "required": true, "type": "string" }, { "in": "body", "name": "body", "description": "json describe the artifact", "required": true, "schema": { "$ref": "#/definitions/ArtifactDefinition" } } ], "responses": { "200": { "description": "Artifact uploaded", "schema": { "$ref": "#/definitions/ArtifactDefinition" } }, "400": { "description": "Restricted Operation – the user provided does not have role of Designer or the asset is being used by another designer - SVC4301" }, "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" }, "404": { "description": "Specified resource is not found - SVC4063" }, "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" } } } }, "/v1/catalog/{assetType}/{uuid}/resourceInstances/{resourceInstanceName}/artifacts/{artifactUUID}": { "get": { "tags": [ "Artifact External Servlet" ], "summary": "Download resource instance artifact", "description": "Returns downloaded artifact", "operationId": "downloadResourceInstanceArtifact", "produces": [ "application/octet-stream" ], "parameters": [ { "name": "USER_ID", "in": "header", "description": "The user ID of the DCAE Designer. This user must also have Designer role in SDC", "required": true, "type": "string" }, { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "name": "assetType", "in": "path", "description": "The requested asset type", "required": true, "type": "string", "enum": [ "resources", "services" ] }, { "name": "uuid", "in": "path", "description": "The uuid of the asset as published in the metadata", "required": true, "type": "string" }, { "name": "artifactUUID", "in": "path", "description": "The uuid of the artifact as published in the asset detailed metadata or in the response of the upload / update operation", "required": true, "type": "string" }, { "name": "resourceInstanceName", "in": "path", "description": "The component instance name (as publishedin the response of the detailed query)", "required": true, "type": "string" } ], "responses": { "200": { "description": "Artifact downloaded", "schema": { "type": "string" } }, "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" }, "404": { "description": "Artifact was not found - SVC4505" }, "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" } } }, "post": { "tags": [ "Artifact External Servlet" ], "summary": "updates an artifact on a resource instance", "description": "uploads of artifact to a resource or service", "operationId": "updateArtifactOnResourceInstance", "produces": [ "application/json" ], "parameters": [ { "name": "Content-Type", "in": "header", "description": "Determines the format of the body of the request", "required": true, "type": "string" }, { "name": "Content-MD5", "in": "header", "description": "The value for this header must be the MD5 checksum over the whole json body", "required": true, "type": "string" }, { "name": "USER_ID", "in": "header", "description": "The user ID of the DCAE Designer. This user must also have Designer role in SDC", "required": true, "type": "string" }, { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "header", "description": "Determines the format of the body of the response", "required": false, "type": "string" }, { "name": "Authorization", "in": "header", "description": "The username and password", "required": true, "type": "string" }, { "name": "assetType", "in": "path", "description": "The requested asset type", "required": true, "type": "string", "enum": [ "resources", "services" ] }, { "name": "uuid", "in": "path", "description": "The uuid of the asset as published in the metadata", "required": true, "type": "string" }, { "name": "artifactUUID", "in": "path", "description": "The uuid of the artifact as published in the asset detailed metadata or in the response of the upload / update operation", "required": true, "type": "string" }, { "name": "resourceInstanceName", "in": "path", "description": "The component instance name (as publishedin the response of the detailed query)", "required": true, "type": "string" }, { "in": "body", "name": "body", "description": "json describe the artifact", "required": true, "schema": { "$ref": "#/definitions/ArtifactDefinition" } } ], "responses": { "200": { "description": "Artifact updated", "schema": { "$ref": "#/definitions/ArtifactDefinition" } }, "400": { "description": "Artifact name is missing in input - SVC4128" }, "401": { "description": "ECOMP component should authenticate itself and to re-send again HTTP request with its Basic Authentication credentials - POL5002" }, "403": { "description": "Asset is being edited by different user. Only one user can checkout and edit an asset on given time. The asset will be available for checkout after the other user will checkin the asset - SVC4086" }, "404": { "description": "Specified resource is not found - SVC4063" }, "405": { "description": "Method Not Allowed: Invalid HTTP method type used (PUT,DELETE,POST will be rejected) - POL4050" }, "409": { "description": "Restricted Operation – the user provided does not have role of Designer or the asset is being used by another designer - SVC4301" }, "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" } } }, "delete": { "tags": [ "Artifact External Servlet" ], "summary": "deletes an artifact of a resource insatnce", "description": "deletes an artifact of a resource insatnce", "operationId": "deleteArtifactOnResourceInstance", "produces": [ "application/json" ], "parameters": [ { "name": "USER_ID", "in": "header", "description": "The user ID of the DCAE Designer. This user must also have Designer role in SDC", "required": true, "type": "string" }, { "name": "X-ECOMP-RequestID", "in": "header", "description": "X-ECOMP-RequestID header", "required": false, "type": "string" }, { "name": "X-ECOMP-InstanceID", "in": "header", "description": "X-ECOMP-InstanceID header", "required": true, "type": "string" }, { "name": "Accept", "in": "he