{
"operation-name" : "read-resource",
"description" : "Reads a model resource's attribute values along with either basic or complete information about any child resources",
"request-properties" : {
"recursive" : {
"type" : {
"TYPE_MODEL_VALUE" : "BOOLEAN"
},
"description" : "Whether to include complete information about child resources, recursively. If absent, false is the default",
"expressions-allowed" : false,
"required" : false,
"nillable" : true,
"stability" : "default"
},
"recursive-depth" : {
"type" : {
"TYPE_MODEL_VALUE" : "INT"
},
"description" : "The depth to which information about child resources should be included.",
"expressions-allowed" : false,
"required" : false,
"nillable" : true,
"min" : 0,
"max" : 2147483647,
"stability" : "default"
},
"proxies" : {
"type" : {
"TYPE_MODEL_VALUE" : "BOOLEAN"
},
"description" : "Whether to include remote resources in a recursive query (i.e. host level resources in a query of the domain root; running server resources in a query of a host). If absent, false is the default.",
"expressions-allowed" : false,
"required" : false,
"nillable" : true,
"default" : false,
"stability" : "default"
},
"include-runtime" : {
"type" : {
"TYPE_MODEL_VALUE" : "BOOLEAN"
},
"description" : "Whether to include runtime attributes (i.e. those whose value does not come from the persistent configuration) in the response. If absent, false is the default.",
"expressions-allowed" : false,
"required" : false,
"nillable" : true,
"default" : false,
"stability" : "default"
},
"include-defaults" : {
"type" : {
"TYPE_MODEL_VALUE" : "BOOLEAN"
},
"description" : "Boolean to enable/disable default reading. In case it is set to false only attribute set by user are returned ignoring undefined.",
"expressions-allowed" : false,
"required" : false,
"nillable" : true,
"default" : true,
"stability" : "default"
},
"attributes-only" : {
"type" : {
"TYPE_MODEL_VALUE" : "BOOLEAN"
},
"description" : "Whether or not to only read the attributes on the specified resource. Cannot be used in conjunction with 'recursive' or 'recursive-depth'.",
"expressions-allowed" : false,
"required" : false,
"nillable" : true,
"default" : false,
"stability" : "default"
},
"include-aliases" : {
"type" : {
"TYPE_MODEL_VALUE" : "BOOLEAN"
},
"description" : "If 'true' and recursive, include children which are aliases.",
"expressions-allowed" : false,
"required" : false,
"nillable" : true,
"default" : false,
"stability" : "default"
},
"include-undefined-metric-values" : {
"type" : {
"TYPE_MODEL_VALUE" : "BOOLEAN"
},
"description" : "Whether to include undefined metric values. If the underlying metric value can not be computed, this flag ensures that the value will remain undefined (without being replaced by a possible 'undefined metric value' from the attribute definition.",
"expressions-allowed" : false,
"required" : false,
"nillable" : true,
"default" : false,
"stability" : "default"
}
},
"reply-properties" : {
"type" : {
"TYPE_MODEL_VALUE" : "OBJECT"
},
"description" : "The resource's attribute values along with information about any child resources"
},
"stability" : "default",
"read-only" : true,
"runtime-only" : false
}