1 deployment-handler API 4.1.0
2 ============================
11 High-level API for deploying/undeploying composed DCAE services using Cloudify Manager.
21 `Apache 2.0 <http://www.apache.org/licenses/LICENSE-2.0.html>`_
30 operations on dcae-deployments
36 DELETE ``/dcae-deployments/{deploymentId}``
37 -------------------------------------------
46 Uninstall the DCAE service and remove all associated data from the orchestrator.
54 :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
55 :widths: 20, 15, 10, 10, 10, 20, 30
57 deploymentId | path | Yes | string | | | Deployment identifier for the service to be uninstalled.
70 Success: The dispatcher has initiated the uninstall operation.
74 Type: :ref:`DCAEDeploymentResponse <d_6157bd3de5c8c7de78f2ab86397667e0>`
78 .. code-block:: javascript
83 "status": "somestring"
85 "requestId": "somestring"
91 Bad request: See the message in the response for details.
95 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
99 .. code-block:: javascript
102 "message": "somestring",
109 Problem on the server side. See the message
110 in the response for more details.
114 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
118 .. code-block:: javascript
121 "message": "somestring",
128 Error reported to the dispatcher by a downstream system. See the message
129 in the response for more details.
133 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
137 .. code-block:: javascript
140 "message": "somestring",
147 Error communicating with a downstream system. See the message
148 in the response for more details.
152 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
156 .. code-block:: javascript
159 "message": "somestring",
167 GET ``/dcae-deployments``
168 -------------------------
177 List service deployments known to the orchestrator, optionally restricted to a single service type
185 :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
186 :widths: 20, 15, 10, 10, 10, 20, 30
188 serviceTypeId | query | No | string | | | Service type identifier for the type whose deployments are to be listed
201 Success. (Note that if no matching deployments are found, the request is still a success; the
202 deployments array is empty in that case.)
206 Type: :ref:`DCAEDeploymentsListResponse <d_c51e57d9583f6119caf83dd017cf214c>`
210 .. code-block:: javascript
221 "requestId": "somestring"
227 Problem on the server side. See the message
228 in the response for more details.
232 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
236 .. code-block:: javascript
239 "message": "somestring",
246 Error reported to the dispatcher by a downstream system. See the message
247 in the response for more details.
251 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
255 .. code-block:: javascript
258 "message": "somestring",
265 Error communicating with a downstream system. See the message
266 in the response for more details.
270 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
274 .. code-block:: javascript
277 "message": "somestring",
285 GET ``/dcae-deployments/{deploymentId}/operation/{operationId}``
286 ----------------------------------------------------------------
295 Get status of a deployment operation
303 :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
304 :widths: 20, 15, 10, 10, 10, 20, 30
306 deploymentId | path | Yes | string | | |
307 operationId | path | Yes | string | | |
320 Status information retrieved successfully
323 Type: :ref:`DCAEOperationStatusResponse <d_f0103f05736b04468a4f85fe90da2e16>`
327 .. code-block:: javascript
330 "error": "somestring",
332 "self": "somestring",
333 "uninstall": "somestring"
335 "operationType": "somestring",
336 "requestId": "somestring",
337 "status": "somestring"
343 The operation information does not exist (possibly because the service has been uninstalled and deleted).
346 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
350 .. code-block:: javascript
353 "message": "somestring",
360 Problem on the server side. See the message
361 in the response for more details.
365 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
369 .. code-block:: javascript
372 "message": "somestring",
379 Error reported to the dispatcher by a downstream system. See the message
380 in the response for more details.
384 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
388 .. code-block:: javascript
391 "message": "somestring",
398 Error communicating with a downstream system. See the message
399 in the response for more details.
403 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
407 .. code-block:: javascript
410 "message": "somestring",
418 PUT ``/dcae-deployments/{deploymentId}``
419 ----------------------------------------
428 Request deployment of a DCAE service
436 :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
437 :widths: 20, 15, 10, 10, 10, 20, 30
439 deploymentId | path | Yes | string | | | Unique deployment identifier assigned by the API client.
447 .. _d_eea14e4929853a5aa415f44cd4868302:
452 Request for deploying a DCAE service.
457 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
458 :widths: 20, 10, 15, 15, 30, 25
460 inputs | No | :ref:`inputs <i_51dfb5d178ebacb6d6617c15cefffa86>` | | | Object containing inputs needed by the service blueprint to create an instance of the service.
461 Content of the object depends on the service being deployed.
463 serviceTypeId | Yes | string | | | The service type identifier (a unique ID assigned by DCAE inventory) for the service to be deployed.
466 .. _i_51dfb5d178ebacb6d6617c15cefffa86:
471 Object containing inputs needed by the service blueprint to create an instance of the service.
472 Content of the object depends on the service being deployed.
477 .. code-block:: javascript
481 "serviceTypeId": "somestring"
490 Success: The content that was posted is valid, the dispatcher has
491 found the needed blueprint, created an instance of the topology in the orchestrator,
492 and started an installation workflow.
496 Type: :ref:`DCAEDeploymentResponse <d_6157bd3de5c8c7de78f2ab86397667e0>`
500 .. code-block:: javascript
504 "self": "somestring",
505 "status": "somestring"
507 "requestId": "somestring"
513 Bad request: See the message in the response for details.
517 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
521 .. code-block:: javascript
524 "message": "somestring",
531 A service with the specified deployment Id already exists. Using PUT to update the service is not a supported operation.
535 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
539 .. code-block:: javascript
542 "message": "somestring",
549 Bad request: The Content-Type header does not indicate that the content is
554 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
558 .. code-block:: javascript
561 "message": "somestring",
568 Problem on the server side. See the message
569 in the response for more details.
573 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
577 .. code-block:: javascript
580 "message": "somestring",
587 Error reported to the dispatcher by a downstream system. See the message
588 in the response for more details.
592 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
596 .. code-block:: javascript
599 "message": "somestring",
606 Error communicating with a downstream system. See the message
607 in the response for more details.
611 Type: :ref:`DCAEErrorResponse <d_74f3f4f847dfb6bd181fcae06ad880b4>`
615 .. code-block:: javascript
618 "message": "somestring",
645 Returns version information and links to API operations
661 Type: :ref:`DispatcherInfo <d_01a325801d3165f9b15dbdaa15b94815>`
665 .. code-block:: javascript
668 "apiVersion": "somestring",
670 "events": "somestring",
673 "serverVersion": "somestring"
683 policy update API consumed by policy-handler and debug API to find policies on components
689 GET ``/policy/components``
690 --------------------------
699 debug API to find policies on components
712 deployment-handler found components with or without policies in cloudify
729 policy update API consumed by policy-handler
737 .. _d_6ea6e6f48a0302e963a67833bbd0ff4a:
742 request to update policies on DCAE components.
746 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
747 :widths: 20, 10, 15, 15, 30, 25
749 latest_policies | Yes | :ref:`latest_policies <i_22fec92398d6fc407cf75f0b4c0f3614>` | | | dictionary of (policy_id -> Policy object). In example: replace additionalProp1,2,3 with policy_id1,2,3 values
751 .. _i_22fec92398d6fc407cf75f0b4c0f3614:
753 **Latest_policies schema:**
756 dictionary of (policy_id -> Policy object). In example: replace additionalProp1,2,3 with policy_id1,2,3 values
758 Map of {"key":":ref:`DCAEPolicy <d_1e3e880a733b457b648bd8c99e6c859c>`"}
762 .. code-block:: javascript
769 "policyName": "somestring",
770 "policyVersion": "somestring"
772 "policy_id": "somestring"
783 deployment-handler always responds with ok to /policy before processing the request
792 .. _d_eea14e4929853a5aa415f44cd4868302:
794 DCAEDeploymentRequest Model Structure
795 -------------------------------------
797 Request for deploying a DCAE service.
802 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
803 :widths: 20, 10, 15, 15, 30, 25
805 inputs | No | :ref:`inputs <i_51dfb5d178ebacb6d6617c15cefffa86>` | | | Object containing inputs needed by the service blueprint to create an instance of the service.
806 Content of the object depends on the service being deployed.
808 serviceTypeId | Yes | string | | | The service type identifier (a unique ID assigned by DCAE inventory) for the service to be deployed.
811 .. _i_51dfb5d178ebacb6d6617c15cefffa86:
816 Object containing inputs needed by the service blueprint to create an instance of the service.
817 Content of the object depends on the service being deployed.
822 .. _d_6157bd3de5c8c7de78f2ab86397667e0:
824 DCAEDeploymentResponse Model Structure
825 --------------------------------------
827 Response body for a PUT or DELETE to /dcae-deployments/{deploymentId}
832 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
833 :widths: 20, 10, 15, 15, 30, 25
835 links | No | :ref:`DCAEDeploymentResponse_links <d_e5951c399cff33430222aefe098fbbbb>` | | |
836 requestId | Yes | string | | | Unique identifier for the request
839 .. _d_e5951c399cff33430222aefe098fbbbb:
841 DCAEDeploymentResponse_links Model Structure
842 --------------------------------------------
844 Links that the API client can access.
849 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
850 :widths: 20, 10, 15, 15, 30, 25
852 self | No | string | | | Link used to retrieve information about the service being deployed
854 status | No | string | | | Link used to retrieve information about the status of the installation workflow
856 .. _d_c51e57d9583f6119caf83dd017cf214c:
858 DCAEDeploymentsListResponse Model Structure
859 -------------------------------------------
861 Object providing a list of deployments
866 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
867 :widths: 20, 10, 15, 15, 30, 25
869 deployments | Yes | array of :ref:`DCAEDeploymentsListResponse_deployments <d_bf53389ec58f942852b6e44f2f35173c>` | | |
870 requestId | Yes | string | | | Unique identifier for the request
873 .. _d_bf53389ec58f942852b6e44f2f35173c:
875 DCAEDeploymentsListResponse_deployments Model Structure
876 -------------------------------------------------------
880 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
881 :widths: 20, 10, 15, 15, 30, 25
883 href | No | string | | | URL for the service deployment
886 .. _d_74f3f4f847dfb6bd181fcae06ad880b4:
888 DCAEErrorResponse Model Structure
889 ---------------------------------
891 Object reporting an error.
896 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
897 :widths: 20, 10, 15, 15, 30, 25
899 message | No | string | | | Human-readable description of the reason for the error
900 status | Yes | integer | | | HTTP status code for the response
902 .. _d_f0103f05736b04468a4f85fe90da2e16:
904 DCAEOperationStatusResponse Model Structure
905 -------------------------------------------
907 Response body for a request for status of an installation or uninstallation operation.
912 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
913 :widths: 20, 10, 15, 15, 30, 25
915 error | No | string | | | If status is 'failed', this field will be present and contain additional information about the reason the operation failed.
917 links | No | :ref:`DCAEOperationStatusResponse_links <d_d0c8dc90669705fbfd08cca966a5fcae>` | | |
918 operationType | Yes | string | | | Type of operation being reported on. ('install' or 'uninstall')
920 requestId | Yes | string | | | A unique identifier assigned to the request. Useful for tracing a request through logs.
922 status | Yes | string | | | Status of the installation or uninstallation operation. Possible values are 'processing',
923 'succeeded', and 'failed'
926 .. _d_d0c8dc90669705fbfd08cca966a5fcae:
928 DCAEOperationStatusResponse_links Model Structure
929 -------------------------------------------------
931 If the operation succeeded, links that the client can follow to take further action. Note that a successful 'uninstall' operation removes the DCAE service instance completely, so there are no possible further actions, and no links.
936 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
937 :widths: 20, 10, 15, 15, 30, 25
939 self | No | string | | | Link used to retrieve information about the service.
941 uninstall | No | string | | | Link used to trigger an 'uninstall' operation for the service. (Use the DELETE method.)
943 .. _d_1e3e880a733b457b648bd8c99e6c859c:
945 DCAEPolicy Model Structure
946 --------------------------
952 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
953 :widths: 20, 10, 15, 15, 30, 25
955 policy_body | Yes | :ref:`DCAEPolicyBody <d_7ffe00ee1aaae6811199d64ff3fea344>` | | |
956 policy_id | Yes | string | | | unique identifier of policy regardless of its version
958 .. _d_7ffe00ee1aaae6811199d64ff3fea344:
960 DCAEPolicyBody Model Structure
961 ------------------------------
963 policy_body - the whole object received from policy-engine
967 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
968 :widths: 20, 10, 15, 15, 30, 25
970 config | Yes | :ref:`config <i_4926bbee050a2d1f47c3281f6c9095cf>` | | | the policy-config - the config data provided by policy owner
971 policyName | Yes | string | | | unique policy name that contains the version and extension
972 policyVersion | Yes | string | | | stringified int that is autoincremented by policy-engine
974 .. _i_4926bbee050a2d1f47c3281f6c9095cf:
979 the policy-config - the config data provided by policy owner
983 .. _d_6ea6e6f48a0302e963a67833bbd0ff4a:
985 DCAEPolicyRequest Model Structure
986 ---------------------------------
988 request to update policies on DCAE components.
992 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
993 :widths: 20, 10, 15, 15, 30, 25
995 latest_policies | Yes | :ref:`latest_policies <i_22fec92398d6fc407cf75f0b4c0f3614>` | | | dictionary of (policy_id -> Policy object). In example: replace additionalProp1,2,3 with policy_id1,2,3 values
997 .. _i_22fec92398d6fc407cf75f0b4c0f3614:
999 **Latest_policies schema:**
1002 dictionary of (policy_id -> Policy object). In example: replace additionalProp1,2,3 with policy_id1,2,3 values
1004 Map of {"key":":ref:`DCAEPolicy <d_1e3e880a733b457b648bd8c99e6c859c>`"}
1008 .. _d_01a325801d3165f9b15dbdaa15b94815:
1010 DispatcherInfo Model Structure
1011 ------------------------------
1015 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
1016 :widths: 20, 10, 15, 15, 30, 25
1018 apiVersion | No | string | | | version of API supported by this server
1020 links | No | :ref:`DispatcherInfo_links <d_0a18e12425d91480a8516b17efe05340>` | | |
1021 serverVersion | No | string | | | version of software running on this server
1024 .. _d_0a18e12425d91480a8516b17efe05340:
1026 DispatcherInfo_links Model Structure
1027 ------------------------------------
1029 Links to API resources
1034 :header: "Name", "Required", "Type", "Format", "Properties", "Description"
1035 :widths: 20, 10, 15, 15, 30, 25
1037 events | No | string | | | path for the events endpoint
1039 info | No | string | | | path for the server information endpoint