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"
}