Skip to content

Latest commit

 

History

History
566 lines (533 loc) · 32.9 KB

deliveryservices.rst

File metadata and controls

566 lines (533 loc) · 32.9 KB

deliveryservices

GET

Retrieves Delivery Services

Auth. Required

Yes

Roles Required

None1

Response Type

Array

Request Structure

Request Query Parameters
Name Required Description
cdn no Show only the Delivery Services belonging to the ds-cdn identified by this integral, unique identifier
id no Show only the Delivery Service that has this integral, unique identifier
logsEnabled no Show only the Delivery Services that have ds-logs-enabled set or not based on this boolean
profile no Return only Delivery Services using the Profile that has this profile-id
tenant no Show only the Delivery Services belonging to the Tenant identified by this integral, unique identifier
topology no Show only the Delivery Services assigned to the Topology identified by this unique name
type no Return only Delivery Services of the Delivery Service ds-types identified by this integral, unique identifier
accessibleTo no Return the Delivery Services accessible from a Tenant or it's children identified by this integral, unique identifier
serviceCategory no Show only the Delivery Services belonging to the Service Category that has this name
xmlId no Show only the Delivery Service that has this text-based, unique identifier
orderby no Choose the ordering of the results - must be the name of one of the fields of the objects in the response array
sortOrder no Changes the order of sorting. Either ascending (default or "asc") or descending ("desc")
limit no Choose the maximum number of results to return
offset no The number of results to skip before beginning to return results. Must use in conjunction with limit
page no Return the nth page of results, where "n" is the value of this parameter, pages are limit long and the first page is 1. If offset was defined, this query parameter has no effect. limit must be defined to make use of page.
active no Show only the Delivery Services that have ds-active set or not based on this boolean (whether or not they are active)

Response Structure

active

A boolean that defines ds-active.

anonymousBlockingEnabled

A boolean that defines ds-anonymous-blocking

cacheurl

A ds-cacheurl

ATCv3.0 This field has been deprecated in Traffic Control 3.x and is subject to removal in Traffic Control 4.x or later

ccrDnsTtl

The ds-dns-ttl - named "ccrDnsTtl" for legacy reasons

cdnId

The integral, unique identifier of the ds-cdn to which the Delivery Service belongs

cdnName

Name of the ds-cdn to which the Delivery Service belongs

checkPath

A ds-check-path

consistentHashRegex

A ds-consistent-hashing-regex

consistentHashQueryParams

An array of ds-consistent-hashing-qparams

deepCachingType

The ds-deep-caching setting for this Delivery Service

displayName

The ds-display-name

dnsBypassCname

A ds-dns-bypass-cname

dnsBypassIp

A ds-dns-bypass-ip

dnsBypassIp6

A ds-dns-bypass-ipv6

dnsBypassTtl

The ds-dns-bypass-ttl

dscp

A ds-dscp to be used within the Delivery Service

ecsEnabled

A boolean that defines the ds-ecs setting on this Delivery Service

edgeHeaderRewrite

A set of ds-edge-header-rw-rules

exampleURLs

An array of ds-example-urls

firstHeaderRewrite

A set of ds-first-header-rw-rules

fqPacingRate

The ds-fqpr

geoLimit

An integer that defines the ds-geo-limit

geoLimitCountries

A string containing a comma-separated list defining the ds-geo-limit-countries

geoLimitRedirectUrl

A ds-geo-limit-redirect-url

geoProvider

The ds-geo-provider

globalMaxMbps

The ds-global-max-mbps

globalMaxTps

The ds-global-max-tps

httpBypassFqdn

A ds-http-bypass-fqdn

id

An integral, unique identifier for this Delivery Service

infoUrl

An ds-info-url

initialDispersion

The ds-initial-dispersion

innerHeaderRewrite

A set of ds-inner-header-rw-rules

ipv6RoutingEnabled

A boolean that defines the ds-ipv6-routing setting on this Delivery Service

lastHeaderRewrite

A set of ds-last-header-rw-rules

lastUpdated

The date and time at which this Delivery Service was last updated, in non-rfc-datetime

logsEnabled

A boolean that defines the ds-logs-enabled setting on this Delivery Service

longDesc

The ds-longdesc of this Delivery Service

longDesc1

The 2nd long description of this Delivery Service

longDesc2

the 3rd long description of this Delivery Service

matchList

The Delivery Service's ds-matchlist

pattern

A regular expression - the use of this pattern is dependent on the type field (backslashes are escaped)

setNumber

An integer that provides explicit ordering of ds-matchlist items - this is used as a priority ranking by Traffic Router, and is not guaranteed to correspond to the ordering of items in the array.

type

The type of match performed using pattern.

maxDnsAnswers

The ds-max-dns-answers allowed for this Delivery Service

maxOriginConnections

The ds-max-origin-connections

maxRequestHeaderBytes

The ds-max-request-header-bytes

midHeaderRewrite

A set of ds-mid-header-rw-rules

missLat

The ds-geo-miss-default-latitude used by this Delivery Service

missLong

The ds-geo-miss-default-longitude used by this Delivery Service

multiSiteOrigin

A boolean that defines the use of ds-multi-site-origin by this Delivery Service

orgServerFqdn

The ds-origin-url

originShield

A ds-origin-shield string

profileDescription

The profile-description of the ds-profile with which this Delivery Service is associated

profileId

The profile-id of the ds-profile with which this Delivery Service is associated

profileName

The profile-name of the ds-profile with which this Delivery Service is associated

protocol

An integral, unique identifier that corresponds to the ds-protocol used by this Delivery Service

qstringIgnore

An integral, unique identifier that corresponds to the ds-qstring-handling setting on this Delivery Service

rangeRequestHandling

An integral, unique identifier that corresponds to the ds-range-request-handling setting on this Delivery Service

regexRemap

A ds-regex-remap

regionalGeoBlocking

A boolean defining the ds-regionalgeo setting on this Delivery Service

remapText

ds-raw-remap

serviceCategory

The name of the ds-service-category with which the Delivery Service is associated

signed

true if and only if signingAlgorithm is not null, false otherwise

signingAlgorithm

Either a ds-signing-algorithm or null to indicate URL/URI signing is not implemented on this Delivery Service

rangeSliceBlockSize

An integer that defines the byte block size for the ATS Slice Plugin. It can only and must be set if rangeRequestHandling is set to 3.

sslKeyVersion

This integer indicates the ds-ssl-key-version

tenantId

The integral, unique identifier of the ds-tenant who owns this Delivery Service

topology

The unique name of the Topology that this Delivery Service is assigned to

trRequestHeaders

If defined, this defines the ds-tr-req-headers used by Traffic Router for this Delivery Service

trResponseHeaders

If defined, this defines the ds-tr-resp-headers used by Traffic Router for this Delivery Service

type

The ds-types of this Delivery Service

typeId

The integral, unique identifier of the ds-types of this Delivery Service

xmlId

This Delivery Service's ds-xmlid

HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie
Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE
Access-Control-Allow-Origin: *
Content-Type: application/json
Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 18 Nov 2019 17:40:54 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: mCLMjvACRKHNGP/OSx4javkOtxxzyiDdQzsV78IamUhVmvyKyKaCeOKRmpsG69w+nhh3OkPZ6e9MMeJpcJSKcA==
X-Server-Name: traffic_ops_golang/
Date: Thu, 15 Nov 2018 19:04:29 GMT
Transfer-Encoding: chunked

{ "response": [{
    "active": true,
    "anonymousBlockingEnabled": false,
    "cacheurl": null,
    "ccrDnsTtl": null,
    "cdnId": 2,
    "cdnName": "CDN-in-a-Box",
    "checkPath": null,
    "displayName": "Demo 1",
    "dnsBypassCname": null,
    "dnsBypassIp": null,
    "dnsBypassIp6": null,
    "dnsBypassTtl": null,
    "dscp": 0,
    "edgeHeaderRewrite": null,
    "firstHeaderRewrite": null,
    "geoLimit": 0,
    "geoLimitCountries": null,
    "geoLimitRedirectURL": null,
    "geoProvider": 0,
    "globalMaxMbps": null,
    "globalMaxTps": null,
    "httpBypassFqdn": null,
    "id": 1,
    "infoUrl": null,
    "initialDispersion": 1,
    "innerHeaderRewrite": null,
    "ipv6RoutingEnabled": true,
    "lastHeaderRewrite": null,
    "lastUpdated": "2019-05-15 14:32:05+00",
    "logsEnabled": true,
    "longDesc": "Apachecon North America 2018",
    "longDesc1": null,
    "longDesc2": null,
    "matchList": [
        {
            "type": "HOST_REGEXP",
            "setNumber": 0,
            "pattern": ".*\\.demo1\\..*"
        }
    ],
    "maxDnsAnswers": null,
    "midHeaderRewrite": null,
    "missLat": 42,
    "missLong": -88,
    "multiSiteOrigin": false,
    "originShield": null,
    "orgServerFqdn": "http://origin.infra.ciab.test",
    "profileDescription": null,
    "profileId": null,
    "profileName": null,
    "protocol": 2,
    "qstringIgnore": 0,
    "rangeRequestHandling": 0,
    "regexRemap": null,
    "regionalGeoBlocking": false,
    "remapText": null,
    "routingName": "video",
    "signed": false,
    "sslKeyVersion": null,
    "tenantId": 1,
    "type": "HTTP",
    "typeId": 1,
    "xmlId": "demo1",
    "exampleURLs": [
        "http://video.demo1.mycdn.ciab.test",
        "https://video.demo1.mycdn.ciab.test"
    ],
    "deepCachingType": "NEVER",
    "fqPacingRate": null,
    "signingAlgorithm": null,
    "tenant": "root",
    "trResponseHeaders": null,
    "trRequestHeaders": null,
    "consistentHashRegex": null,
    "consistentHashQueryParams": [
        "abc",
        "pdq",
        "xxx",
        "zyx"
    ],
    "maxOriginConnections": 0,
    "maxRequestHeaderBytes": 131072,
    "ecsEnabled": false,
    "rangeSliceBlockSize": null,
    "topology": null
    "serviceCategory": null
}]}

POST

Allows users to create Delivery Service.

Auth. Required

Yes

Roles Required

"admin" or "operations"2

Response Type

Array

Request Structure

active

A boolean that defines ds-active.

anonymousBlockingEnabled

A boolean that defines ds-anonymous-blocking

cacheurl

A ds-cacheurl

ATCv3.0 This field has been deprecated in Traffic Control 3.x and is subject to removal in Traffic Control 4.x or later

ccrDnsTtl

The ds-dns-ttl - named "ccrDnsTtl" for legacy reasons

cdnId

The integral, unique identifier of the ds-cdn to which the Delivery Service belongs

checkPath

A ds-check-path

consistentHashRegex

A ds-consistent-hashing-regex

consistentHashQueryParams

An array of ds-consistent-hashing-qparams

deepCachingType

The ds-deep-caching setting for this Delivery Service

displayName

The ds-display-name

dnsBypassCname

A ds-dns-bypass-cname

dnsBypassIp

A ds-dns-bypass-ip

dnsBypassIp6

A ds-dns-bypass-ipv6

dnsBypassTtl

The ds-dns-bypass-ttl

dscp

A ds-dscp to be used within the Delivery Service

ecsEnabled

A boolean that defines the ds-ecs setting on this Delivery Service

edgeHeaderRewrite

A set of ds-edge-header-rw-rules

firstHeaderRewrite

A set of ds-first-header-rw-rules

fqPacingRate

The ds-fqpr

geoLimit

An integer that defines the ds-geo-limit

geoLimitCountries

A string containing a comma-separated list defining the ds-geo-limit-countries

geoLimitRedirectUrl

A ds-geo-limit-redirect-url

geoProvider

The ds-geo-provider

globalMaxMbps

The ds-global-max-mbps

globalMaxTps

The ds-global-max-tps

httpBypassFqdn

A ds-http-bypass-fqdn

infoUrl

An ds-info-url

initialDispersion

The ds-initial-dispersion

innerHeaderRewrite

A set of ds-inner-header-rw-rules

ipv6RoutingEnabled

A boolean that defines the ds-ipv6-routing setting on this Delivery Service

lastHeaderRewrite

A set of ds-last-header-rw-rules

logsEnabled

A boolean that defines the ds-logs-enabled setting on this Delivery Service

longDesc

The ds-longdesc of this Delivery Service

longDesc1

An optional field containing the 2nd long description of this Delivery Service

longDesc2

An optional field containing the 3rd long description of this Delivery Service

maxDnsAnswers

The ds-max-dns-answers allowed for this Delivery Service

maxOriginConnections

The ds-max-origin-connections

maxRequestHeaderBytes

The ds-max-request-header-bytes

midHeaderRewrite

A set of ds-mid-header-rw-rules

missLat

The ds-geo-miss-default-latitude used by this Delivery Service

missLong

The ds-geo-miss-default-longitude used by this Delivery Service

multiSiteOrigin

A boolean that defines the use of ds-multi-site-origin by this Delivery Service

orgServerFqdn

The ds-origin-url

originShield

A ds-origin-shield string

profileId

An optional profile-id of a ds-profile with which this Delivery Service shall be associated

protocol

An integral, unique identifier that corresponds to the ds-protocol used by this Delivery Service

qstringIgnore

An integral, unique identifier that corresponds to the ds-qstring-handling setting on this Delivery Service

rangeRequestHandling

An integral, unique identifier that corresponds to the ds-range-request-handling setting on this Delivery Service

regexRemap

A ds-regex-remap

regionalGeoBlocking

A boolean defining the ds-regionalgeo setting on this Delivery Service

remapText

ds-raw-remap

serviceCategory

The name of the ds-service-category with which the Delivery Service is associated - or null if there is to be no such category

signed

true if and only if signingAlgorithm is not null, false otherwise

signingAlgorithm

Either a ds-signing-algorithm or null to indicate URL/URI signing is not implemented on this Delivery Service

rangeSliceBlockSize

An integer that defines the byte block size for the ATS Slice Plugin. It can only and must be set if rangeRequestHandling is set to 3. It can only be between (inclusive) 262144 (256KB) - 33554432 (32MB).

sslKeyVersion

This integer indicates the ds-ssl-key-version

tenantId

The integral, unique identifier of the ds-tenant who owns this Delivery Service

topology

The unique name of the Topology that this Delivery Service is assigned to

trRequestHeaders

If defined, this defines the ds-tr-req-headers used by Traffic Router for this Delivery Service

trResponseHeaders

If defined, this defines the ds-tr-resp-headers used by Traffic Router for this Delivery Service

type

The ds-types of this Delivery Service

typeId

The integral, unique identifier of the ds-types of this Delivery Service

xmlId

This Delivery Service's ds-xmlid

POST /api/3.0/deliveryservices HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 761
Content-Type: application/json

{
    "active": false,
    "anonymousBlockingEnabled": false,
    "cdnId": 2,
    "deepCachingType": "NEVER",
    "displayName": "test",
    "dscp": 0,
    "ecsEnabled": true,
    "geoLimit": 0,
    "geoProvider": 0,
    "initialDispersion": 1,
    "ipv6RoutingEnabled": false,
    "logsEnabled": true,
    "longDesc": "A Delivery Service created expressly for API documentation examples",
    "missLat": 0,
    "missLong": 0,
    "maxOriginConnections": 0,
    "maxRequestHeaderBytes": 131072,
    "multiSiteOrigin": false,
    "orgServerFqdn": "http://origin.infra.ciab.test",
    "protocol": 0,
    "qstringIgnore": 0,
    "rangeRequestHandling": 0,
    "regionalGeoBlocking": false,
    "routingName": "test",
    "serviceCategory": null,
    "signed": false,
    "tenant": "root",
    "tenantId": 1,
    "typeId": 1,
    "xmlId": "test"
}

Response Structure

active

A boolean that defines ds-active.

anonymousBlockingEnabled

A boolean that defines ds-anonymous-blocking

cacheurl

A ds-cacheurl

ATCv3.0 This field has been deprecated in Traffic Control 3.x and is subject to removal in Traffic Control 4.x or later

ccrDnsTtl

The ds-dns-ttl - named "ccrDnsTtl" for legacy reasons

cdnId

The integral, unique identifier of the ds-cdn to which the Delivery Service belongs

cdnName

Name of the ds-cdn to which the Delivery Service belongs

checkPath

A ds-check-path

consistentHashRegex

A ds-consistent-hashing-regex

consistentHashQueryParams

An array of ds-consistent-hashing-qparams

deepCachingType

The ds-deep-caching setting for this Delivery Service

displayName

The ds-display-name

dnsBypassCname

A ds-dns-bypass-cname

dnsBypassIp

A ds-dns-bypass-ip

dnsBypassIp6

A ds-dns-bypass-ipv6

dnsBypassTtl

The ds-dns-bypass-ttl

dscp

A ds-dscp to be used within the Delivery Service

ecsEnabled

A boolean that defines the ds-ecs setting on this Delivery Service

edgeHeaderRewrite

A set of ds-edge-header-rw-rules

exampleURLs

An array of ds-example-urls

firstHeaderRewrite

A set of ds-first-header-rw-rules

fqPacingRate

The ds-fqpr

geoLimit

An integer that defines the ds-geo-limit

geoLimitCountries

A string containing a comma-separated list defining the ds-geo-limit-countries

geoLimitRedirectUrl

A ds-geo-limit-redirect-url

geoProvider

The ds-geo-provider

globalMaxMbps

The ds-global-max-mbps

globalMaxTps

The ds-global-max-tps

httpBypassFqdn

A ds-http-bypass-fqdn

id

An integral, unique identifier for this Delivery Service

infoUrl

An ds-info-url

initialDispersion

The ds-initial-dispersion

innerHeaderRewrite

A set of ds-inner-header-rw-rules

ipv6RoutingEnabled

A boolean that defines the ds-ipv6-routing setting on this Delivery Service

lastHeaderRewrite

A set of ds-last-header-rw-rules

lastUpdated

The date and time at which this Delivery Service was last updated, in non-rfc-datetime

logsEnabled

A boolean that defines the ds-logs-enabled setting on this Delivery Service

longDesc

The ds-longdesc of this Delivery Service

longDesc1

The 2nd long description of this Delivery Service

longDesc2

the 3rd long description of this Delivery Service

matchList

The Delivery Service's ds-matchlist

pattern

A regular expression - the use of this pattern is dependent on the type field (backslashes are escaped)

setNumber

An integer that provides explicit ordering of ds-matchlist items - this is used as a priority ranking by Traffic Router, and is not guaranteed to correspond to the ordering of items in the array.

type

The type of match performed using pattern.

maxDnsAnswers

The ds-max-dns-answers allowed for this Delivery Service

maxOriginConnections

The ds-max-origin-connections

maxRequestHeaderBytes

The ds-max-request-header-bytes

midHeaderRewrite

A set of ds-mid-header-rw-rules

missLat

The ds-geo-miss-default-latitude used by this Delivery Service

missLong

The ds-geo-miss-default-longitude used by this Delivery Service

multiSiteOrigin

A boolean that defines the use of ds-multi-site-origin by this Delivery Service

orgServerFqdn

The ds-origin-url

originShield

A ds-origin-shield string

profileDescription

The profile-description of the ds-profile with which this Delivery Service is associated

profileId

The profile-id of the ds-profile with which this Delivery Service is associated

profileName

The profile-name of the ds-profile with which this Delivery Service is associated

protocol

An integral, unique identifier that corresponds to the ds-protocol used by this Delivery Service

qstringIgnore

An integral, unique identifier that corresponds to the ds-qstring-handling setting on this Delivery Service

rangeRequestHandling

An integral, unique identifier that corresponds to the ds-range-request-handling setting on this Delivery Service

regexRemap

A ds-regex-remap

regionalGeoBlocking

A boolean defining the ds-regionalgeo setting on this Delivery Service

remapText

ds-raw-remap

serviceCategory

The name of the ds-service-category with which the Delivery Service is associated

signed

true if and only if signingAlgorithm is not null, false otherwise

signingAlgorithm

Either a ds-signing-algorithm or null to indicate URL/URI signing is not implemented on this Delivery Service

rangeSliceBlockSize

An integer that defines the byte block size for the ATS Slice Plugin. It can only and must be set if rangeRequestHandling is set to 3.

sslKeyVersion

This integer indicates the ds-ssl-key-version

tenantId

The integral, unique identifier of the ds-tenant who owns this Delivery Service

topology

The unique name of the Topology that this Delivery Service is assigned to

trRequestHeaders

If defined, this defines the ds-tr-req-headers used by Traffic Router for this Delivery Service

trResponseHeaders

If defined, this defines the ds-tr-resp-headers used by Traffic Router for this Delivery Service

type

The ds-types of this Delivery Service

typeId

The integral, unique identifier of the ds-types of this Delivery Service

xmlId

This Delivery Service's ds-xmlid

HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie
Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE
Access-Control-Allow-Origin: *
Content-Type: application/json
Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 18 Nov 2019 17:40:54 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: SVveQ5hGwfPv8N5APUskwLOzwrTUVA+z8wuFLsSLCr1/vVnFJJ0VQOGMUctg1NbqhAuQ795MJmuuAaAwR8dSOQ==
X-Server-Name: traffic_ops_golang/
Date: Mon, 19 Nov 2018 19:45:49 GMT
Content-Length: 1404

{ "alerts": [
    {
        "text": "Deliveryservice creation was successful.",
        "level": "success"
    }
],
"response": [
    {
        "active": false,
        "anonymousBlockingEnabled": false,
        "cacheurl": null,
        "ccrDnsTtl": null,
        "cdnId": 2,
        "cdnName": "CDN-in-a-Box",
        "checkPath": null,
        "displayName": "test",
        "dnsBypassCname": null,
        "dnsBypassIp": null,
        "dnsBypassIp6": null,
        "dnsBypassTtl": null,
        "dscp": 0,
        "edgeHeaderRewrite": null,
        "firstHeaderRewrite": null,
        "geoLimit": 0,
        "geoLimitCountries": null,
        "geoLimitRedirectURL": null,
        "geoProvider": 0,
        "globalMaxMbps": null,
        "globalMaxTps": null,
        "httpBypassFqdn": null,
        "id": 2,
        "infoUrl": null,
        "initialDispersion": 1,
        "innerHeaderRewrite": null,
        "ipv6RoutingEnabled": false,
        "lastHeaderRewrite": null,
        "lastUpdated": "2018-11-19 19:45:49+00",
        "logsEnabled": true,
        "longDesc": "A Delivery Service created expressly for API documentation examples",
        "longDesc1": null,
        "longDesc2": null,
        "matchList": [
            {
                "type": "HOST_REGEXP",
                "setNumber": 0,
                "pattern": ".*\\.test\\..*"
            }
        ],
        "maxDnsAnswers": null,
        "maxOriginConnections": 0,
        "maxRequestHeaderBytes": 131072,
        "midHeaderRewrite": null,
        "missLat": -1,
        "missLong": -1,
        "multiSiteOrigin": false,
        "originShield": null,
        "orgServerFqdn": "http://origin.infra.ciab.test",
        "profileDescription": null,
        "profileId": null,
        "profileName": null,
        "protocol": 0,
        "qstringIgnore": 0,
        "rangeRequestHandling": 0,
        "regexRemap": null,
        "regionalGeoBlocking": false,
        "remapText": null,
        "routingName": "test",
        "serviceCategory": null,
        "signed": false,
        "sslKeyVersion": null,
        "tenantId": 1,
        "type": "HTTP",
        "typeId": 1,
        "xmlId": "test",
        "exampleURLs": [
            "http://test.test.mycdn.ciab.test"
        ],
        "deepCachingType": "NEVER",
        "signingAlgorithm": null,
        "tenant": "root",
        "ecsEnabled": true,
        "rangeSliceBlockSize": null,
        "topology": null
    }
]}

  1. Only those Delivery Services assigned to Tenants that are the requesting user's Tenant or children thereof will appear in the output of a GET request, and the same constraints are placed on the allowed values of the tenantId field of a POST request to create a new Delivery Service

  2. Only those Delivery Services assigned to Tenants that are the requesting user's Tenant or children thereof will appear in the output of a GET request, and the same constraints are placed on the allowed values of the tenantId field of a POST request to create a new Delivery Service