DNS Pool Member CNAME¶

Overview¶

This document describes the API to configure DNS CNAME pool members and their properties.

REST Endpoint: /mgmt/cm/dns/working-config/pool/cname/*/members¶

Requests¶

GET /mgmt/cm/dns/working-config/pool/cname/<id>/members/<pool-member-id>¶

Request Parameters¶

None

Query Parameters¶

None

Response¶

HTTP/1.1 200 OK

Name	Type	Description
enabled	boolean	Specifies whether the system can include the pool member in its load balancing calculations
memberOrder	number	Specifies the order number of the pool member. The system uses this number with load balancing methods that involve prioritizing pool members, such as the Ratio load balancing method
ratio	number	Specifies the weight to the pool member for load balancing purposes
staticTarget	string	Specifies that the member’s name specifies a static DNAME rather than a name linked to a Wide IP defined on the system. Configuring Static Target might be required if the target DNAME is not owned by the organization or configured on DNS. One side-effect of using a static target is that the member is always considered available for load balancing. The default is disabled
wideIpAReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpAaaaReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpSrvReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpCnameReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpMxReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpNaptrReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
name	string	Displays the name of the pool
description	string	A description of the pool member

Permissions¶

Role	Allow
Application_Editor	Yes
DNS_Viewer	Yes
DNS_Deployer	Yes
Service_Catalog_Viewer	Yes
DNS_Editor	Yes
Service_Catalog_Editor	Yes
Application_Manager	Yes
Application_Viewer	Yes
Trust_Discovery_Import	Yes
DNS_Manager	Yes

POST /mgmt/cm/dns/working-config/pool/cname/<id>/members¶

Request Parameters¶

Name	Type	Required	Description
enabled	boolean	False	Specifies whether the system can include the pool member in its load balancing calculations
memberOrder	number	False	Specifies the order number of the pool member. The system uses this number with load balancing methods that involve prioritizing pool members, such as the Ratio load balancing method
ratio	number	False	Specifies the weight to the pool member for load balancing purposes
staticTarget	string	False	Specifies that the member’s name specifies a static DNAME rather than a name linked to a Wide IP defined on the system. Configuring Static Target might be required if the target DNAME is not owned by the organization or configured on DNS. One side-effect of using a static target is that the member is always considered available for load balancing. The default is disabled
wideIpAReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
wideIpAaaaReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
wideIpSrvReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
wideIpCnameReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
wideIpMxReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
wideIpNaptrReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
name	string	False	Displays the name of the pool
description	string	False	A description of the pool member

Query Parameters¶

None

Response¶

HTTP/1.1 200 OK

Name	Type	Description
enabled	boolean	Specifies whether the system can include the pool member in its load balancing calculations
memberOrder	number	Specifies the order number of the pool member. The system uses this number with load balancing methods that involve prioritizing pool members, such as the Ratio load balancing method
ratio	number	Specifies the weight to the pool member for load balancing purposes
staticTarget	string	Specifies that the member’s name specifies a static DNAME rather than a name linked to a Wide IP defined on the system. Configuring Static Target might be required if the target DNAME is not owned by the organization or configured on DNS. One side-effect of using a static target is that the member is always considered available for load balancing. The default is disabled
wideIpAReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpAaaaReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpSrvReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpCnameReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpMxReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpNaptrReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
name	string	Displays the name of the pool
description	string	A description of the pool member

Permissions¶

Role	Allow
Application_Editor	No
DNS_Viewer	No
DNS_Deployer	No
Service_Catalog_Viewer	No
DNS_Editor	Yes
Service_Catalog_Editor	No
Application_Manager	No
Application_Viewer	No
Trust_Discovery_Import	No
DNS_Manager	Yes

PATCH /mgmt/cm/dns/working-config/pool/cname/<id>/members/<pool-member-id>¶

Request Parameters¶

Name	Type	Required	Description
enabled	boolean	False	Specifies whether the system can include the pool member in its load balancing calculations
memberOrder	number	False	Specifies the order number of the pool member. The system uses this number with load balancing methods that involve prioritizing pool members, such as the Ratio load balancing method
ratio	number	False	Specifies the weight to the pool member for load balancing purposes
staticTarget	string	False	Specifies that the member’s name specifies a static DNAME rather than a name linked to a Wide IP defined on the system. Configuring Static Target might be required if the target DNAME is not owned by the organization or configured on DNS. One side-effect of using a static target is that the member is always considered available for load balancing. The default is disabled
wideIpAReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
wideIpAaaaReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
wideIpSrvReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
wideIpCnameReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
wideIpMxReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
wideIpNaptrReference	reference	False	A reference of the Wide IP for the pool member to use
link	string	True	URI link of the reference.
description	string	False	A description of the pool member

Query Parameters¶

None

Response¶

HTTP/1.1 200 OK

Name	Type	Description
enabled	boolean	Specifies whether the system can include the pool member in its load balancing calculations
memberOrder	number	Specifies the order number of the pool member. The system uses this number with load balancing methods that involve prioritizing pool members, such as the Ratio load balancing method
ratio	number	Specifies the weight to the pool member for load balancing purposes
staticTarget	string	Specifies that the member’s name specifies a static DNAME rather than a name linked to a Wide IP defined on the system. Configuring Static Target might be required if the target DNAME is not owned by the organization or configured on DNS. One side-effect of using a static target is that the member is always considered available for load balancing. The default is disabled
wideIpAReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpAaaaReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpSrvReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpCnameReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpMxReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpNaptrReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
name	string	Displays the name of the pool
description	string	A description of the pool member

Permissions¶

Role	Allow
Application_Editor	No
DNS_Viewer	No
DNS_Deployer	No
Service_Catalog_Viewer	No
DNS_Editor	Yes
Service_Catalog_Editor	No
Application_Manager	No
Application_Viewer	No
Trust_Discovery_Import	No
DNS_Manager	Yes

DELETE /mgmt/cm/dns/working-config/pool/cname/<id>/members/<pool-member-id>¶

Request Parameters¶

None

Query Parameters¶

None

Response¶

HTTP/1.1 200 OK

Name	Type	Description
enabled	boolean	Specifies whether the system can include the pool member in its load balancing calculations
memberOrder	number	Specifies the order number of the pool member. The system uses this number with load balancing methods that involve prioritizing pool members, such as the Ratio load balancing method
ratio	number	Specifies the weight to the pool member for load balancing purposes
staticTarget	string	Specifies that the member’s name specifies a static DNAME rather than a name linked to a Wide IP defined on the system. Configuring Static Target might be required if the target DNAME is not owned by the organization or configured on DNS. One side-effect of using a static target is that the member is always considered available for load balancing. The default is disabled
wideIpAReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpAaaaReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpSrvReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpCnameReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpMxReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
wideIpNaptrReference	reference	A reference of the Wide IP for the pool member to use
name	string	Name of the resource
link	string	URI link of the reference.
name	string	Displays the name of the pool
description	string	A description of the pool member

Permissions¶

Role	Allow
Application_Editor	No
DNS_Viewer	No
DNS_Deployer	No
Service_Catalog_Viewer	No
DNS_Editor	Yes
Service_Catalog_Editor	No
Application_Manager	No
Application_Viewer	No
Trust_Discovery_Import	No
DNS_Manager	Yes

Examples¶

Get a pool member of a given CNAME pool¶

GET /mgmt/cm/dns/working-config/pool/cname/<id>/members/<pool-member-id>

Response¶

HTTP/1.1 200 OK
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "ratio": No example value specified    ,
    "staticTarget": No example value specified    ,
    "wideIpAReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpAaaaReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpSrvReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpCnameReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpMxReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpNaptrReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "name": "pool_member_1"    ,
    "description": "example pool member"
}

Get all pool members of a given CNAME pool¶

GET /mgmt/cm/dns/working-config/pool/cname/<id>/members

Response¶

HTTP/1.1 200 OK
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "ratio": No example value specified    ,
    "staticTarget": No example value specified    ,
    "wideIpAReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpAaaaReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpSrvReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpCnameReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpMxReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpNaptrReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "name": "pool_member_1"    ,
    "description": "example pool member"
}

Create a new pool member for a given CNAME pool¶

POST /mgmt/cm/dns/working-config/pool/cname/<id>/members
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "ratio": No example value specified    ,
    "staticTarget": No example value specified    ,
    "wideIpAReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpAaaaReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpSrvReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpCnameReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpMxReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpNaptrReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "name": "pool_member_1"    ,
    "description": "example pool member"
}

Response¶

HTTP/1.1 200 OK
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "ratio": No example value specified    ,
    "staticTarget": No example value specified    ,
    "wideIpAReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpAaaaReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpSrvReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpCnameReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpMxReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpNaptrReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "name": "pool_member_1"    ,
    "description": "example pool member"
}

Update pool member for a given CNAME pool¶

PATCH /mgmt/cm/dns/working-config/pool/cname/<id>/members/<pool-member-id>
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "ratio": No example value specified    ,
    "staticTarget": No example value specified    ,
    "wideIpAReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpAaaaReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpSrvReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpCnameReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpMxReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpNaptrReference": {
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "description": "example pool member"
}

Response¶

HTTP/1.1 200 OK
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "ratio": No example value specified    ,
    "staticTarget": No example value specified    ,
    "wideIpAReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpAaaaReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpSrvReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpCnameReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpMxReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpNaptrReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "name": "pool_member_1"    ,
    "description": "example pool member"
}

Delete CNAME pool member¶

DELETE /mgmt/cm/dns/working-config/pool/cname/<id>

Response¶

HTTP/1.1 200 OK
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "ratio": No example value specified    ,
    "staticTarget": No example value specified    ,
    "wideIpAReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpAaaaReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpSrvReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpCnameReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpMxReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "wideIpNaptrReference": {
        "name": "resourceName"    ,
        "link": "https://localhost/mgmt/shared/foo/bar/866cfd8a-4d03-48e9-ba94-bb21a4bc2346"
    },
    "name": "pool_member_1"    ,
    "description": "example pool member"
}

Previous Next