DNS Pool Member SRV¶

Overview¶

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

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

Requests¶

GET /mgmt/cm/dns/working-config/pool/srv/<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
port	number	Specifies the Port associated with the pool member
priority	number	Specifies the response resource record’s priority RDATA field value when this member is picked. The default is 10
ratio	number	Specifies the weight of the pool member for load balancing purposes. The default is 1
weight	number	Specifies the response resource record’s weight RDATA field value when this member is picked. The default value is 10
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.
name	string
description	string

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/srv/<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
port	number	False	Specifies the Port associated with the pool member
priority	number	False	Specifies the response resource record’s priority RDATA field value when this member is picked. The default is 10
ratio	number	False	Specifies the weight of the pool member for load balancing purposes. The default is 1
weight	number	False	Specifies the response resource record’s weight RDATA field value when this member is picked. The default value is 10
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.
name	string	False
description	string	False

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
port	number	Specifies the Port associated with the pool member
priority	number	Specifies the response resource record’s priority RDATA field value when this member is picked. The default is 10
ratio	number	Specifies the weight of the pool member for load balancing purposes. The default is 1
weight	number	Specifies the response resource record’s weight RDATA field value when this member is picked. The default value is 10
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.
name	string
description	string

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/srv/<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
port	number	False	Specifies the Port associated with the pool member
priority	number	False	Specifies the response resource record’s priority RDATA field value when this member is picked. The default is 10
ratio	number	False	Specifies the weight of the pool member for load balancing purposes. The default is 1
weight	number	False	Specifies the response resource record’s weight RDATA field value when this member is picked. The default value is 10
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.
description	string	False

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
port	number	Specifies the Port associated with the pool member
priority	number	Specifies the response resource record’s priority RDATA field value when this member is picked. The default is 10
ratio	number	Specifies the weight of the pool member for load balancing purposes. The default is 1
weight	number	Specifies the response resource record’s weight RDATA field value when this member is picked. The default value is 10
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.
name	string
description	string

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/srv/<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
port	number	Specifies the Port associated with the pool member
priority	number	Specifies the response resource record’s priority RDATA field value when this member is picked. The default is 10
ratio	number	Specifies the weight of the pool member for load balancing purposes. The default is 1
weight	number	Specifies the response resource record’s weight RDATA field value when this member is picked. The default value is 10
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.
name	string
description	string

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 SRV pool¶

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

Response¶

HTTP/1.1 200 OK
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "port": 80    ,
    "priority": No example value specified    ,
    "ratio": No example value specified    ,
    "weight": 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"
    },
    "name": No example value specified    ,
    "description": No example value specified
}

Get all pool members of a given SRV pool¶

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

Response¶

HTTP/1.1 200 OK
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "port": 80    ,
    "priority": No example value specified    ,
    "ratio": No example value specified    ,
    "weight": 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"
    },
    "name": No example value specified    ,
    "description": No example value specified
}

Create a new pool member for a given SRV pool¶

POST /mgmt/cm/dns/working-config/pool/srv/<id>/members
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "port": 80    ,
    "priority": No example value specified    ,
    "ratio": No example value specified    ,
    "weight": 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"
    },
    "name": No example value specified    ,
    "description": No example value specified
}

Response¶

HTTP/1.1 200 OK
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "port": 80    ,
    "priority": No example value specified    ,
    "ratio": No example value specified    ,
    "weight": 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"
    },
    "name": No example value specified    ,
    "description": No example value specified
}

Update pool member for a given SRV pool¶

PATCH /mgmt/cm/dns/working-config/pool/srv/<id>/members/<pool-member-id>
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "port": 80    ,
    "priority": No example value specified    ,
    "ratio": No example value specified    ,
    "weight": 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"
    },
    "description": No example value specified
}

Response¶

HTTP/1.1 200 OK
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "port": 80    ,
    "priority": No example value specified    ,
    "ratio": No example value specified    ,
    "weight": 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"
    },
    "name": No example value specified    ,
    "description": No example value specified
}

Delete SRV pool member¶

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

Response¶

HTTP/1.1 200 OK
{
    "enabled": No example value specified    ,
    "memberOrder": No example value specified    ,
    "port": 80    ,
    "priority": No example value specified    ,
    "ratio": No example value specified    ,
    "weight": 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"
    },
    "name": No example value specified    ,
    "description": No example value specified
}

Previous Next