Get Status For Cluster | Telco Cloud Foundation Manager API

Get Status For Cluster

This API is to be used for getting the status for a Cluster.

Request

URI

GET

https://{api_host}/hybridity/api/ztp/v1/clusters/{cluster_id}/status

COPY

Path Parameters

string

cluster_id

Required

The ID of the Cluster.

Query Parameters

string

sort

Optional

The key to use for sorting the resultant list of status. The value is to be an attribute based sorting expression. The supported attributes for sorting are as follows: [ id, name, type, progress, status, statusMessage, domainId, startTime, endTime, createdTimestamp, lastUpdatedTimestamp ] The supported sorting orders are: [asc,desc]

sort example

startTime,desc

string

filter

Optional

Attribute-based filtering expression according to clause 5.2 of ETSI GS NFV SOL 013. The supported filter types are [cont, eq]. "cont" refers to contains (substring check). It is applicable only for string type targets. "eq" refers to exact match. If target type is a string, then case is ignored. The supported attributes for "eq" filtering are: [id, name, type, progress, status, statusMessage, domainId]. The supported attributes for "cont" filtering are: [id, name, type, status, statusMessage, domainId].

filter example

(cont,name,provisioning)

string

nextpage_opaque_marker

Optional

Marker to obtain the next page of a paged response according to clause 5.4.2.1 of ETSI GS NFV SOL 013 for this resource. The marker expression will contain page number and page size.

nextpage_opaque_marker example

page_no=1,page_size=10

Authentication

This operation uses the following authentication methods.

x-hm-authorization

Responses

200

Response includes list of status as specified by the request parameters.

Returns InlineZtpV1ClustersCluster_idStatus200Response of type(s) application/json

{
    "status": "string",
    "steps": [
        {
            "id": "string",
            "name": "string",
            "type": "string",
            "progress": 0,
            "status": "string",
            "startTime": 0,
            "endTime": 0,
            "statusMessage": "string",
            "domainId": "string",
            "hostId": "string",
            "createdTimestamp": 0,
            "lastUpdatedTimestamp": 0
        }
    ]
}

string

status

Optional

The status of provisioning of the domain. It can be one of: [NOT_PROVISIONED, PROVISIONED, IN_PROGRESS, FAILED].

array of object

steps

Optional

The list of tasks under this domain.

Response Headers

integer

X-TotalPageCount

The total number of pages for status present on the server.

integer

X-TotalRowCount

The total number of status present on the server.

301

API endpoint has permanently moved.

Returns InlineZtpV1ClustersCluster_idStatus301Response of type(s) application/json

{
    "redirectURL": "string"
}

string

redirectURL

Optional

redirectURL

Response Headers

string

Location

URI where the client will find the new endpoint.

400

Response may include details of why the request is bad.

Returns InlineZtpV1ClustersCluster_idStatus400Response of type(s) application/json

{
    "warnings": [
        {
            "code": "string",
            "message": "string",
            "stack": "string"
        }
    ],
    "errors": [
        {
            "code": "string",
            "message": "string",
            "stack": "string"
        }
    ]
}

array of object

warnings

Optional

The list of warnings.

array of object

errors

Optional

The list of errors.

401

User is not authenticated to invoke this endpoint.

Operation doesn't return any data structure

403

User is not authorized to invoke this endpoint.

Operation doesn't return any data structure

422

The request parameters couldn't be processed by the server.

Returns InlineZtpV1ClustersCluster_idStatus422Response of type(s) application/json

{
    "warnings": [
        {
            "code": "string",
            "message": "string",
            "stack": "string"
        }
    ],
    "errors": [
        {
            "code": "string",
            "message": "string",
            "stack": "string"
        }
    ]
}

array of object

warnings

Optional

The list of warnings.

array of object

errors

Optional

The list of errors.

500

An internal server error has occurred.

Returns InlineZtpV1ClustersCluster_idStatus500Response of type(s) application/json

{
    "warnings": [
        {
            "code": "string",
            "message": "string",
            "stack": "string"
        }
    ],
    "errors": [
        {
            "code": "string",
            "message": "string",
            "stack": "string"
        }
    ]
}

array of object

warnings

Optional

The list of warnings.

array of object

errors

Optional

The list of errors.

On This Page

Description

Request

Path Parameters