Retrieve an application asset for a managed cluster
GET /accounts/{account_id}/topology/v1/managedClusters/{managedCluster_id}/apps/{app_id}/appAssets/{appAsset_id}
Returns the stored Application Asset API resource in the JSON response body.
Parameters
Name | Type | In | Required | Description |
---|---|---|---|---|
account_id |
string |
path |
True |
ID of the containing account resource
|
managedCluster_id |
string |
path |
True |
ID of the containing managedCluster resource |
app_id |
string |
path |
True |
ID of the containing app resource |
appAsset_id |
string |
path |
True |
ID of the appAsset collection to list |
Response
Status: 200, Returns the stored Application Asset API resource in the JSON response body.
Name | Type | Required | Description |
---|---|---|---|
type |
string |
True |
Media type of the resource. Defined values are:
|
version |
string |
True |
Version of the resource. Defined values are:
|
id |
string |
True |
Globally unique identifier of the resource. Defined values are:
|
assetType |
string |
True |
JSON string containing a value indicating what type of asset is being described as obtained from Kubernetes. Defined values are:
|
creationTimestamp |
string |
True |
JSON string containing a timestamp indicating when the Kubernetes metadata was created. Defined values are:
|
GVK |
True |
JSON object containing a Kubernetes group/version/kind. |
|
resource |
False |
JSON object containing the entire content of the Kubernetes resource definition. |
|
assetID |
string |
True |
JSON string containing an identifier assigned by Kubernetes. Defined values are:
|
labels |
array[labels] |
True |
JSON array of JSON objects, each containing a Kubernetes labels associated with the asset. If no details are available, this array will be empty.
|
assetName |
string |
True |
JSON string containing a name assigned by Kubernetes. Defined values are:
|
namespace |
string |
False |
JSON string containing a namespace assigned by Kubernetes. Defined values are:
|
metadata |
True |
Client and service-specified metadata associated with the resource. Defined values are:
|
Example response
Response
Status: 401, Unauthorized
Name | Type | Required | Description |
---|---|---|---|
type |
string |
True |
|
title |
string |
True |
|
detail |
string |
True |
|
status |
string |
True |
|
correlationID |
string |
False |
Example response
Response
Status: 400, Bad request
Name | Type | Required | Description |
---|---|---|---|
type |
string |
True |
|
title |
string |
True |
|
detail |
string |
True |
|
status |
string |
True |
|
correlationID |
string |
False |
|
invalidParams |
array[invalidParams] |
False |
List of invalid query parameters |
Example response
Response
Status: 403, Forbidden
Name | Type | Required | Description |
---|---|---|---|
type |
string |
True |
|
title |
string |
True |
|
detail |
string |
True |
|
status |
string |
True |
|
correlationID |
string |
False |
Example response
Error
Status: 404, Not found
Name | Type | Required | Description |
---|---|---|---|
type |
string |
True |
|
title |
string |
True |
|
detail |
string |
True |
|
status |
string |
True |
|
correlationID |
string |
False |
Example error response
Definitions
See Definitions
GVK
JSON object containing a Kubernetes group/version/kind.
Name | Type | Required | Description |
---|---|---|---|
group |
string |
False |
JSON string containing a group identifier assigned by Kubernetes. Defined values are:
|
kind |
string |
False |
JSON string containing a kind identifier assigned by Kubernetes. Defined values are:
|
version |
string |
False |
JSON string containing a version identifier assigned by Kubernetes. Defined values are:
|
type_json
JSON object containing the entire content of the Kubernetes resource definition.
labels
Name | Type | Required | Description |
---|---|---|---|
name |
string |
True |
JSON string containing the label name Defined values are:
|
value |
string |
True |
JSON string containing the label value Defined values are:
|
type_astra_label
Name | Type | Required | Description |
---|---|---|---|
name |
string |
True |
|
value |
string |
True |
type_astra_metadata
Client and service-specified metadata associated with the resource. Defined values are:
-
Conforms to the Astra Metadata Schema
Name | Type | Required | Description |
---|---|---|---|
labels |
array[type_astra_label] |
True |
|
creationTimestamp |
string |
True |
|
modificationTimestamp |
string |
True |
|
createdBy |
string |
True |
|
modifiedBy |
string |
False |
invalidParams
Name | Type | Required | Description |
---|---|---|---|
name |
string |
True |
Name of the invalid query parameter |
reason |
string |
True |
Reason why the query parameter is invalid |