POST api/Kdm
Uploads a KDM or KDM Bundle to Cinergy.
Request Information
URI Parameters
None.
Body Parameters
KDM/KDM Bundle| Name | Description | Type | Additional information |
|---|---|---|---|
| File |
KDM .xml or a .zip/.tar bundle of KDM .xmls |
Object |
None. |
HTTP Header Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| X-FacilityID |
(optional) Sets the intended delivery endpoint for the uploaded KDM(s). |
string |
ex. cloudcinemas.com:1234 |
Response Information
Resource Description
A receipt that contains information of the upload status of the keys into Cinergy.
KdmUploadResult| Name | Description | Type | Additional information |
|---|---|---|---|
| FileId |
The assigned unique identifier of the upload. |
globally unique identifier |
None. |
| FileCount |
The number of files in the request. |
integer |
None. |
| Results |
A list of upload results for each individual file uploaded. |
Collection of KdmStatusResult |
None. |
HTTP Status Codes
Successful responses: 202 Accepted
Unsuccessful responses: 400 Bad Request, 401 Unauthorized, 415 Unsupported Media Type
Response Formats
application/json, text/json
Samples:
{
"FileId": "200b252a-4c0c-47fd-91f7-a6af64bd90af",
"FileCount": 1,
"Results": [
{
"Filename": "example-kdm-1.xml",
"KdmUuid": "200b252a-4c0c-47fd-91f7-a6af64bd90af",
"Status": "Accepted"
}
]
}
{
"FileId": "9e00b322-acc9-4db6-a379-d2f2ef03375b",
"FileCount": 3,
"Results": [
{
"Filename": "example-kdm-1.xml",
"KdmUuid": "27117b2b-49a8-4ee4-97f3-186509a7ba5e",
"Status": "Pending"
},
{
"Filename": "example-kdm-2.xml",
"KdmUuid": "9b509bb7-6fdf-4e16-8b42-efd12f7eaf2b",
"Status": "Accepted"
},
{
"Filename": "example-kdm-3.xml",
"KdmUuid": "1e4a47ae-17d8-47c2-9be0-05a638d6c135",
"Status": "Pending"
}
]
}
application/xml, text/xml
Samples:
<KdmUploadResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Dcip.Cloud.KeyVault.Core.Api">
<FileCount>1</FileCount>
<FileId>200b252a-4c0c-47fd-91f7-a6af64bd90af</FileId>
<Results>
<KdmStatusResult>
<ErrorMessage i:nil="true" />
<Filename>example-kdm-1.xml</Filename>
<KdmUuid>200b252a-4c0c-47fd-91f7-a6af64bd90af</KdmUuid>
<Status>Accepted</Status>
</KdmStatusResult>
</Results>
</KdmUploadResult>
<KdmUploadResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Dcip.Cloud.KeyVault.Core.Api">
<FileCount>3</FileCount>
<FileId>9e00b322-acc9-4db6-a379-d2f2ef03375b</FileId>
<Results>
<KdmStatusResult>
<ErrorMessage i:nil="true" />
<Filename>example-kdm-1.xml</Filename>
<KdmUuid>27117b2b-49a8-4ee4-97f3-186509a7ba5e</KdmUuid>
<Status>Pending</Status>
</KdmStatusResult>
<KdmStatusResult>
<ErrorMessage i:nil="true" />
<Filename>example-kdm-2.xml</Filename>
<KdmUuid>9b509bb7-6fdf-4e16-8b42-efd12f7eaf2b</KdmUuid>
<Status>Accepted</Status>
</KdmStatusResult>
<KdmStatusResult>
<ErrorMessage i:nil="true" />
<Filename>example-kdm-3.xml</Filename>
<KdmUuid>1e4a47ae-17d8-47c2-9be0-05a638d6c135</KdmUuid>
<Status>Pending</Status>
</KdmStatusResult>
</Results>
</KdmUploadResult>