Returns list of details of certificate chains by given parameters.
name | type | description | constraints |
---|---|---|---|
source | query | ||
source-type | query | "BACKUP_DESTINATION" or "HYPERVISOR" or "HYPERVISOR_MANAGER" or "STORAGE_PROVIDER" | |
type | query | "SSH_HOST_FINGERPRINT" or "X509" |
media type | data type | description |
---|---|---|
application/json | array of TrustedCertificateChainDetails (JSON) | list of details of certificate chains |
GET /certificates
Content-Type: */*
Accept: application/json
...
HTTP/1.1 200 OK
Content-Type: application/json
[ {
"guid" : "...",
"creationTime" : 12345,
"hypervisor" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"hypervisorManager" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"storageProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"backupDestination" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"trustedCertificates" : [ {
"guid" : "...",
"value" : "...",
"notAfter" : 12345
}, {
"guid" : "...",
"value" : "...",
"notAfter" : 12345
} ],
"type" : "X509"
} ]
Adds a certificate
media type | data type | description |
---|---|---|
application/json | TrustedCertificateChainRequest (JSON) | specify details of a certificate |
media type | data type | description |
---|---|---|
application/json | TrustedCertificateChainDetails (JSON) | details of a certificate |
POST /certificates
Content-Type: application/json
Accept: application/json
{
"sourceId" : "...",
"sourceType" : "HYPERVISOR",
"trustedCertificates" : [ {
"value" : "...",
"notAfter" : 12345
}, {
"value" : "...",
"notAfter" : 12345
} ],
"type" : "SSH_HOST_FINGERPRINT"
}
HTTP/1.1 201 Created
Content-Type: application/json
{
"guid" : "...",
"creationTime" : 12345,
"hypervisor" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"hypervisorManager" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"storageProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"backupDestination" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"trustedCertificates" : [ {
"guid" : "...",
"value" : "...",
"notAfter" : 12345
}, {
"guid" : "...",
"value" : "...",
"notAfter" : 12345
} ],
"type" : "X509"
}
Returns details of a certificate.
name | type | description |
---|---|---|
guid | path | specify local unique identifier for certificate (use by vProtect) |
media type | data type | description |
---|---|---|
application/json | TrustedCertificateChainDetails (JSON) | details of a certificate |
GET /certificates/{guid}
Content-Type: */*
Accept: application/json
...
HTTP/1.1 200 OK
Content-Type: application/json
{
"guid" : "...",
"creationTime" : 12345,
"hypervisor" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"hypervisorManager" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"storageProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"backupDestination" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"trustedCertificates" : [ {
"guid" : "...",
"value" : "...",
"notAfter" : 12345
}, {
"guid" : "...",
"value" : "...",
"notAfter" : 12345
} ],
"type" : "X509"
}
Deletes a certificate by source
name | type | description | constraints |
---|---|---|---|
source | path | specify source of a certificate | |
sourceType | path | specify source type of certificate | "BACKUP_DESTINATION" or "HYPERVISOR" or "HYPERVISOR_MANAGER" or "STORAGE_PROVIDER" |
DELETE /certificates/source/{source}/{sourceType}
Content-Type: */*
...
HTTP/1.1 204 No Content
Returns details of a certificate chain by given parameters.
name | type | description | constraints |
---|---|---|---|
source | path | guid of source of specified type | |
sourceType | path | specify type of source | "BACKUP_DESTINATION" or "HYPERVISOR" or "HYPERVISOR_MANAGER" or "STORAGE_PROVIDER" |
type | path | a type of certificate chain | "SSH_HOST_FINGERPRINT" or "X509" |
media type | data type | description |
---|---|---|
application/json | TrustedCertificateChainDetails (JSON) | details of a certificate |
GET /certificates/{sourceType}/{source}/{type}
Content-Type: */*
Accept: application/json
...
HTTP/1.1 200 OK
Content-Type: application/json
{
"guid" : "...",
"creationTime" : 12345,
"hypervisor" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"hypervisorManager" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"storageProvider" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"backupDestination" : {
"guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
"name" : "Entity name"
},
"trustedCertificates" : [ {
"guid" : "...",
"value" : "...",
"notAfter" : 12345
}, {
"guid" : "...",
"value" : "...",
"notAfter" : 12345
} ],
"type" : "SSH_HOST_FINGERPRINT"
}