Get Descendant Assets
get
/rest/v7/assets/{id}/descendantAssets
This operation retrieves all descendant assets of the specified asset.
Request
Path Parameters
-
id: integer
Primary Key of Asset Resource.
Query Parameters
-
expand(optional): string
Allows expansion of relationships.
-
fields(optional): string
Restrict which fields shall be returned. The value is a comma delimited string and each token is a field name.
-
limit(optional): integer
The requested page size, which limits the number of elements the collection should max return.
-
offset(optional): integer
The offset of the page. By default, offset is 0, which means first page will be returned.
-
orderby(optional): string
Specifies a comma-separated list of pairs to order the response by.
-
q(optional): string
Allows to specify one or more filtering criteria. By default, no filtering is applied.
-
totalResults(optional): boolean
Specifies that the total count of records should be included in the response when doing pagination.
Response
Default Response
Root Schema : Assets-collection
Type:
Show Source
object-
count(optional):
integer
The number of resource instances returned in the current range.
-
hasMore(optional):
boolean
Returns true if more resources are available on the server than the subset returned in current page.
-
items(optional):
array items
-
limit(optional):
integer
The actual paging size used by the server.
-
offset(optional):
integer
The offset used in the current page.
-
totalResults(optional):
integer
Capture the total count of the resource instances, which not only includes the instances in the current range, but all instances on the server that satisfy the request.
Nested Schema : Assets
Type:
objectTitle:
Show Source
Assets-
_proxy_id(optional):
string
Title:
_proxy_idtemporary record identifier; optional field applicable only in the context of synchronize action -
_sync_action(optional):
string
Title:
_sync_actionrecord level operation; optional field applicable only in the context of synchronize action -
assetDescription(optional):
string
Title:
Asset DescriptionDescription of the asset. -
assetKey(optional):
string
Title:
Asset KeyAn invariant key that uniquely identifies the asset / component for the lifetime of the asset. It will be unique across all asset repositories. -
attributes(optional):
string
Title:
AttributesA collection (JSON) of key/value pair attributes that define the configuration of this asset/component. -
billingAccount(optional):
string
Title:
Billing AccountThe billing account associated with this asset. -
billingProfile(optional):
string
Title:
Billing ProfileThe billing profile associated with this asset. -
contractReference(optional):
string
Title:
ContractContract associated with this asset. -
currency(optional):
object Currency
Title:
CurrencyCurrency Code for the asset -
customer(optional):
string
Title:
CustomerThe customer that owns the product. This is the value stored in main doc XML attribute _customer_id. -
dateAdded(optional):
string
Title:
Date AddedSystem field indicating the date on which the Resource was created. -
dateModified(optional):
string
Title:
Date ModifiedSystem field indicating the date on which the Resource was last modified. -
discountAmount(optional):
object DiscountAmount
Title:
DiscountAmountThe amount of discount received -
discountPercent(optional):
number
Title:
DiscountPercentThe percent of discount received. -
displayKey(optional):
string
Title:
DisplayThe public, non-unique key for the product instance. For example, phone number or serial number. -
endDate(optional):
string
Title:
Ends OnDate on which the service contract ends -
fixedRecurringAmount(optional):
object Fixed Recurring Amount
Title:
Fixed Recurring AmountThe recurring charge for the product. For example, $10 per month. -
fixedRecurringPeriod(optional):
string
Title:
Fixed Recurring PeriodThe period for the fixed recurring charge. For example, Per Month. -
id(optional):
integer
Title:
IdPrimary Key of Asset Resource. -
installDate(optional):
string
Title:
Installed OnDate on which asset was installed. -
oneTimeNetAmount(optional):
object One Time Net Amount
Title:
One Time Net AmountThe price paid to purchase the product -
parentAsset(optional):
object Parent Asset Id
Title:
Parent Asset IdThe parent component of the asset bill of materials tree -
parentDisplay(optional):
string
Title:
Parent DisplayThe display key of the parent asset. -
parentPartNumber(optional):
string
Title:
Parent Part NumberThe part number of the parent asset. -
partDescription(optional):
string
Title:
Part DescriptionThe description of the part. -
partNumber(optional):
string
Title:
Part NumberPart Number of the referenced product instance. -
paymentTerm(optional):
string
Title:
Payment TermThe payment terms. For example, Net 30. -
purchaseDate(optional):
string
Title:
Purchased OnDate on which the product/service was purchased. -
quantity(optional):
number
Title:
QuantityThe quantity of the asset. -
registeredDate(optional):
string
Title:
Registered OnDate on which product was registered. -
resumeDate(optional):
string
Title:
Resumed OnDate on which the service contract was resumed -
rootAsset(optional):
object Root Asset Id
Title:
Root Asset IdThe root component in the asset bill of materials tree. -
rootDisplay(optional):
string
Title:
Root DisplayThe display key of the root asset. -
rootPartNumber(optional):
string
Title:
Root Part NumberThe part number of the root asset. -
serialNumber(optional):
string
Title:
Serial NumberSerial Number of the asset. -
serviceAccount(optional):
string
Title:
Service AccountThe service account associated with this asset. -
serviceAddress(optional):
string
Title:
Service AddressThe service address associated with this asset. -
startDate(optional):
string
Title:
Starts OnDate on which the service contract starts -
status(optional):
object Status
Title:
StatusThe status of the asset -
suspendDate(optional):
string
Title:
Suspended OnDate on which the service contract was suspended -
usageNetAmount(optional):
object Usage Net Amount
Title:
Usage Net AmountThe variable, usage price for the product. For example, $0.10 per Copy. -
usageUnitOfMeasure(optional):
string
Title:
Usage Unit of MeasureThe unit of measure for the usage charges. For example, Per Copy or Per Minute. -
warrantyEndDate(optional):
string
Title:
Warranty Ends OnDate on which warranty ends. -
warrantyStartDate(optional):
string
Title:
Warranty Starts OnDate on which warranty starts.
Nested Schema : Currency
Type:
objectTitle:
CurrencyCurrency Code for the asset
Show Source
-
currencyCode(optional):
string
Title:
Currency CodeUnique currency code for the currency.
Nested Schema : DiscountAmount
Type:
objectTitle:
DiscountAmountThe amount of discount received
Show Source
-
currency(optional):
string
Title:
currency -
value(optional):
number
Title:
value
Nested Schema : Fixed Recurring Amount
Type:
objectTitle:
Fixed Recurring AmountThe recurring charge for the product. For example, $10 per month.
Show Source
-
currency(optional):
string
Title:
currency -
value(optional):
number
Title:
value
Nested Schema : One Time Net Amount
Type:
objectTitle:
One Time Net AmountThe price paid to purchase the product
Show Source
-
currency(optional):
string
Title:
currency -
value(optional):
number
Title:
value
Nested Schema : Parent Asset Id
Type:
objectTitle:
Parent Asset IdThe parent component of the asset bill of materials tree
Show Source
-
assetKey(optional):
string
Title:
Asset KeyAn invariant key that uniquely identifies the asset / component for the lifetime of the asset. It will be unique across all asset repositories. -
id(optional):
integer
Title:
IdPrimary Key of Asset Resource.
Nested Schema : Root Asset Id
Type:
objectTitle:
Root Asset IdThe root component in the asset bill of materials tree.
Show Source
-
assetKey(optional):
string
Title:
Asset KeyAn invariant key that uniquely identifies the asset / component for the lifetime of the asset. It will be unique across all asset repositories. -
id(optional):
integer
Title:
IdPrimary Key of Asset Resource.
Nested Schema : Status
Type:
objectTitle:
StatusThe status of the asset
Show Source
-
displayValue(optional):
string
Title:
Display ValueTranslated display name of the type for which fixed list of values can be defined. -
id(optional):
integer
Title:
IdPrimary Key of the fixed list of value resource. -
lookupCode(optional):
string
Title:
Lookup CodeLanguage independent code of the fixed list of value.
Nested Schema : Usage Net Amount
Type:
objectTitle:
Usage Net AmountThe variable, usage price for the product. For example, $0.10 per Copy.
Show Source
-
currency(optional):
string
Title:
currency -
value(optional):
number
Title:
value
Examples
The following example shows how to retrieve Descendant Asset items by submitting a GET request to the REST resource using cURL.
curl -X GET -i -H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQg" -H "Accept: application/json" https://sitename.oracle.com/rest/v7/18399848/actions/descendantAssets
Example of Response Body
The following example shows the contents of the response body in JSON format:
{
"items": [{
"startDate": null,
"dateModified": "2017-01-06T10:56:32.707Z",
"oneTimeNetAmount": {
"value": 300,
"currency": "USD"
},
"rootDisplay": "display-100-2-1234",
"parentDisplay": "display-100-2-1234",
"fixedRecurringPeriod": null,
"dateAdded": "2017-01-06T10:54:58.703Z",
"endDate": null,
"customer": "SpecialAccount100",
"discountAmount": {
"value": 15,
"currency": "USD"
},
"rootAsset": {
"id": 18399848,
"assetKey": "rootAssetForAll",
"links": [{
"rel": "domain",
"href": "https://sitename.oracle.com/rest/v7/assets"
}, {
"rel": "canonical",
"href": "https://sitename.oracle.com/rest/v7/assets/18399848"
}
]
},
"currency": {
"currencyCode": "USD",
"links": [{
"rel": "domain",
"href": "https://sitename.oracle.com/rest/v7/currencies"
}, {
"rel": "canonical",
"href": "https://sitename.oracle.com/rest/v7/currencies/USD"
}
]
},
"id": 18399853,
"fixedRecurringAmount": {
"value": 50,
"currency": "USD"
},
"parentAsset": {
"id": 18399848,
"assetKey": "rootAssetForAll",
"links": [{
"rel": "domain",
"href": "https://sitename.oracle.com/rest/v7/assets"
}, {
"rel": "canonical",
"href": "https://sitename.oracle.com/rest/v7/assets/18399848"
}
]
},
"rootPartNumber": "part1",
"quantity": 1,
"usageNetAmount": null,
"partNumber": "part1",
"displayKey": "display-100-2-1234",
"status": null,
"parentPartNumber": "part1",
"paymentTerm": null,
"usageUnitOfMeasure": null,
"assetKey": "asset1",
"attributes": null,
"discountPercent": 5,
"links": [{
"rel": "self",
"href": "https://sitename.oracle.com/rest/v7/assets/18399848/descendantAssets/18399853"
}, {
"name": "childAssets",
"rel": "child",
"href": "https://sitename.oracle.com/rest/v7/assets/18399848/descendantAssets/18399853/childAssets",
"kind": ""
}, {
"name": "descendantAssets",
"rel": "child",
"href": "https://sitename.oracle.com/rest/v7/assets/18399848/descendantAssets/18399853/descendantAssets",
"kind": ""
}, {
"rel": "parent",
"href": "https://sitename.oracle.com/rest/v7/assets/18399848"
}
]
}
],
"links": [{
"rel": "self",
"href": "https://sitename.oracle.com/rest/v7/assets/18399848/descendantAssets"
}
]
}