--- updatedAt: 2026-06-18T12:32:49.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/ip-protect/llms.txt --- # Update domain to allocate subnets Adds virtual IP addresses to the specified policy domain. In the request body, use `addVips` to specify the number of virtual IP addresses you're adding, and use `allocateIpv6` to configure the IP addressing type for these addresses. Set `allocateIpv6` to `true` to use IPv6 addressing, and either omit `allocateIpv6` or set the value to `false` to use IPv4 addressing. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's Prolexic IP Protect Configuration API", "url": "https://techdocs.akamai.com/ip-protect/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Policy domains", "version": "v1" }, "openapi": "3.0.0", "paths": { "/policy-domains/{pdName}/pd-subnets/allocate": { "put": { "description": "Adds virtual IP addresses to the specified policy domain. In the request body, use `addVips` to specify the number of virtual IP addresses you're adding, and use `allocateIpv6` to configure the IP addressing type for these addresses. Set `allocateIpv6` to `true` to use IPv6 addressing, and either omit `allocateIpv6` or set the value to `false` to use IPv4 addressing.", "externalDocs": { "description": "See documentation for this operation in Akamai's Prolexic IP Protect Configuration API", "url": "https://techdocs.akamai.com/ip-protect/reference/put-policy-domains-pdname-pd-subnets-allocate" }, "operationId": "put-policy-domains-pdname-pd-subnets-allocate", "parameters": [ { "description": "For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).", "in": "query", "name": "accountSwitchKey", "required": false, "schema": { "example": "1-5C0YLB:1-8BYUX", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "addVips": 5, "allocateIpv6": true }, "schema": { "additionalProperties": false, "description": "Specifies the number and type of the IP addresses you want to allocate.", "properties": { "addVips": { "description": "Number of virtual IP addresses to allocate.", "type": "integer" }, "allocateIpv6": { "description": "Indicates that the new virtual IP addresses use IPv6 addressing. If you omit this parameter or set it to `false`, the new addresses use IPv4 addressing.", "type": "boolean" } }, "required": [ "addVips", "allocateIpv6" ], "type": "object", "x-akamai": { "file-path": "schemas/add-vips-schema.yaml" } } } }, "required": false }, "responses": { "200": { "content": { "application/json": { "example": { "configVersionId": 1, "createdBy": "szhang", "createdTimestamp": "2020-04-29T21:02:02.942+0000", "deployState": "deployed", "ipsAllocated": 32, "ipsConfigured": 20, "pdName": "corp_na", "pdSubnets": [ { "legacyPdSubnet": false, "pdSubnet": "198.51.100.0/26", "pdSubnetId": 1, "vips": [ { "akamaiFrontend": "198.51.100.0/28", "customerBackend": "203.0.113.0/28", "legacyVip": false, "ports": "80, 443", "probePort": 10, "probeType": "TCP", "sourceIpProtocol": "PROXY_PROTOCOL_V2", "type": "PASSTHROUGH", "vipId": 1 } ] } ], "updatedBy": null, "updatedTimestamp": null }, "schema": { "additionalProperties": false, "description": "Policy domain configurations.", "properties": { "configVersionId": { "description": "Unique identifier for the configuration version.", "type": "integer" }, "createdBy": { "description": "User who created the configuration version.", "type": "string" }, "createdTimestamp": { "description": "ISO 8601 timestamp indicating the creation time of the configuration.", "format": "date-time", "type": "string" }, "deployState": { "description": "Current deployment state of the configuration version. The value `edited` indicates that changes have been made to policy domain, but haven't been deployed. The `deploying` state indicates that the configuration is in the midst of the deployment process, while `deployed` indicates that there are no outstanding changes that need deploying.", "enum": [ "deployed", "deploying", "edited" ], "type": "string" }, "ipsAllocated": { "description": "Number of virtual IP addresses assigned to the policy domain.", "type": "integer" }, "ipsConfigured": { "description": "Number of virtual IP addresses configured for the policy domain.", "type": "integer" }, "pdName": { "description": "Unique name of the policy domain.", "type": "string" }, "pdSubnets": { "description": "Subnets.", "items": { "additionalProperties": false, "properties": { "legacyPdSubnet": { "description": "Indicates whether Prolexic Proxy created the subnet.", "type": "boolean" }, "pdSubnet": { "description": "IP address of the subnet.", "type": "string" }, "pdSubnetId": { "description": "Unique identifier of the subnet.", "type": "integer" }, "vips": { "description": "Virtual IP addresses.", "items": { "additionalProperties": false, "properties": { "akamaiFrontend": { "description": "The Akamai virtual IP address that's been mapped to a back-end server or subnet.", "type": "string" }, "customerBackend": { "description": "The customer's server IP address or subnet that's been mapped to a virtual IP address.", "type": "string" }, "legacyVip": { "description": "Indicates whether Prolexic Proxy created the subnet.", "type": "boolean" }, "ports": { "description": "Virtual IP address ports open to traffic directed to a customer's website.", "type": "string" }, "probePort": { "description": "The probe port number. ", "type": "integer" }, "probeType": { "description": "The probe type, either `TCP` or `ICMP`. ", "enum": [ "TCP", "ICMP" ], "type": "string" }, "sourceIpProtocol": { "description": "Source IP propagation for network packets received at your back-end server or subnet. Refer to [Source IP protocols](https://techdocs.akamai.com/ip-protect/reference/source-ip-protocols) for more information. Either `PROXY_PROTOCOL_V2`, `PROXY_PROTOCOL_V2_UDP`, `OPTION_28`, or `NA`.", "enum": [ "PROXY_PROTOCOL_V2", "PROXY_PROTOCOL_V2_UDP", "OPTION_28", "NA" ], "type": "string" }, "type": { "description": "The type of IP address or subnet service configured.", "type": "string" }, "vipId": { "description": "Unique identifier of the virtual IP address.", "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" }, "updatedBy": { "description": "User who most recent updated the configuration version.", "nullable": true, "type": "string" }, "updatedTimestamp": { "description": "ISO 8061 timestamp indicating the time of the most recent update of the configuration version.", "format": "date-time", "nullable": true, "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/update-pd-subnet-open-response.yaml" } } } }, "description": "Successful response." } }, "summary": "Update domain to allocate subnets", "tags": [ "Subnets" ] }, "parameters": [ { "description": "Unique name of the policy domain.", "in": "path", "name": "pdName", "required": true, "schema": { "example": "documentation_na", "type": "string" }, "x-akamai": { "file-path": "parameters/pd-name-path.yaml" } } ], "x-akamai": { "file-path": "paths/allocate.yaml", "path-info": "/policy-domains/{pdName}/pd-subnets/allocate" } } }, "servers": [ { "url": "https://{hostname}/ip-protect/v1" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "02-policy-domains.yaml" }, "x-readme": { "explorer-enabled": false, "samples-languages": [ "curl", "python", "node" ] } } ```