List tenant service group ancestors

POST 
/tenancy/v1/tenant_service_groups/:tsg_id/operations/list_ancestors

List the ancestor tenants of the tenant service group specified in this request. If the TSG ID supplied in this API's path does not match the TSG ID contained in the access token used to authenticate this request, this request will fail.

Request

Path Parameters

tsg_id _idrequired

Possible values: >= 10 characters and <= 10 characters, Value must match regular expression ^1[0-9]+$

A unique identifier for the tenant service group.

Query Parameters

sort string
Possible values: [asc, desc]
Identifies the response structure's sort order:
• asc : From root to leaf.
• desc : From leaf to root.
include_self boolean

Indicates if the TSG used to generate this hierarchy is included in the resulting TSG list. true to include self. Default is false.

fields string

Provide a comma-separated list of fields you want returned.

Responses

200

Successful response.

application/json

Schema

Schema

count integerrequired

Total count of the items

items object[]required
Array [
display_name string
The tenant service group's display name.
id _id (string)required
Possible values: >= 10 characters and <= 10 characters, Value must match regular expression ^1[0-9]+$
The tenant service group's ID.
parent_id _reference_id (string)
Possible values: >= 10 characters and <= 10 characters, Value must match regular expression ^1[0-9]+$
The TSG ID for this tenant service group's parent.
support_contact string
The email address of the person or organization that should be contacted for support of this TSG.
vertical string
Possible values: [High Tech, Education, Manufacturing, Hospitality, Professional & Legal Services, Wholesale & Retail, Finance, Telecommunications, State & Local Government, Transportation & Logistics, Federal Government, Media & Entertainment, Nonclassifiable Establishments, Healthcare, Utilities & Energy, Insurance, Agriculture, Pharma & Life Sciences, Construction, Aerospace & Defense, Real Estate, Restaurant/Food Industry, Other]
A token that identifies the business vertical supported by the SASE products managed by this TSG.
]

Example (from schema)

{
  "count": 1
}

include_self=false&sort=asc

{
  "count": 4,
  "items": [
    {
      "display_name": "Root TSG",
      "id": "1809106289"
    },
    {
      "display_name": "Org TSG",
      "id": "1179022506",
      "parent_id": "1809106289",
      "vertical": "High Tech"
    },
    {
      "display_name": "Suborg TSG",
      "id": "1957242655",
      "parent_id": "1179022506"
    },
    {
      "display_name": "ParentTSG",
      "id": "1739543876",
      "parent_id": "1957242655",
      "support_contact": "user@example.com",
      "vertical": "High Tech"
    }
  ]
}

include_self=true&sort=asc

{
  "count": 5,
  "items": [
    {
      "display_name": "Root TSG",
      "id": "1809106289"
    },
    {
      "display_name": "Org TSG",
      "id": "1179022506",
      "parent_id": "1809106289",
      "vertical": "High Tech"
    },
    {
      "display_name": "Suborg TSG",
      "id": "1957242655",
      "parent_id": "1179022506"
    },
    {
      "display_name": "ParentTSG",
      "id": "1739543876",
      "parent_id": "1957242655",
      "support_contact": "user@example.com",
      "vertical": "High Tech"
    },
    {
      "display_name": "TargetTSG",
      "id": "1995877003",
      "parent_id": "1739543876",
      "support_contact": "user@example.com",
      "vertical": "High Tech"
    }
  ]
}

include_self=true&sort=desc

{
  "count": 5,
  "items": [
    {
      "display_name": "TargetTSG",
      "id": "1995877003",
      "parent_id": "1739543876",
      "support_contact": "user@example.com",
      "vertical": "High Tech"
    },
    {
      "display_name": "ParentTSG",
      "id": "1739543876",
      "parent_id": "1957242655",
      "support_contact": "user@example.com",
      "vertical": "High Tech"
    },
    {
      "display_name": "Suborg TSG",
      "id": "1957242655",
      "parent_id": "1179022506"
    },
    {
      "display_name": "Org TSG",
      "id": "1179022506",
      "parent_id": "1809106289",
      "vertical": "High Tech"
    },
    {
      "display_name": "Root TSG",
      "id": "1809106289"
    }
  ]
}

401

JWT Expired

text/plain

Schema

Schema

any

Jwt Expired

Jwt is expired

403

Forbidden

application/json

Schema

Schema

any

Forbidden

{
  "error": "Forbidden",
  "message": "Forbidden",
  "statusCode": 403
}

404

Not Found

application/json

Schema

Schema

any

Tenant Service Group Not Found

{
  "error": "Not Found",
  "message": "Not Found",
  "statusCode": 404
}

500

Internal Error

application/json

Schema

Schema

any

Internal Error

{
  "error": "Internal Server Error",
  "message": "An internal server error occurred",
  "statusCode": 500
}

Loading...