List Ancestors (AWS)
For AWS only. Lists the ancestors of the given member accounts and organizational units (OUs) for the specified cloud account ID. A successful response returns an array of accounts and/or OUs each of which is mapped to an array of ancestor resource IDs.
Path Parameters
Account ID
Request Body required
Cloud Account JSON
AWS Account ID
Possible values: [organization
]
Cloud Account Type
Cloud Account Status. Whether or not the account is enabled
Name
Array of resource IDs (account IDs and/or OU IDs)
AWS Role ARN
- 200
- 400
- 404
- 412
- 500
success
Schema
- Array [
- Array [
- ]
- ]
ancestors object[]
List of ancestors
Display name
Possible values: [true
, false
]
Has Child
Node ID
Parent
Possible values: [ORG
, FOLDER
, PROJECT
, SUBSCRIPTION
, MANAGEMENT_GROUP
, TENANT
, ACCOUNT
, OU
]
Node type
Resource ID
Response code
Status
[
{
"ancestors": [
{
"displayName": "string",
"hasChild": true,
"id": "string",
"parent": "string",
"type": "ORG"
}
],
"resourceId": "string",
"responseCode": 0,
"status": "string"
}
]
bad_request / unauthorized_access
invalid_account_id_format
external_id_empty_or_not_generated. To generate CFT and externalId call Generate and Download the AWS CFT Template endpoint or Generate the AWS CFT Template Link Endpoint
internal_error