published on Monday, Jun 1, 2026 by Volcengine
published on Monday, Jun 1, 2026 by Volcengine
GTM address pool resource, belongs to a GTM instance and is used to carry the target address set and routing capacity configuration
Example Usage
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
resources:
gTMPoolDemo:
type: volcenginecc:gtm:Pool
name: GTMPoolDemo
properties:
addresses:
- rectified_geos:
- cn_telecom_shanghai
capacity: 20
mode: auto
value: 2001:db8::2
weight: 20
- rectified_geos:
- cn_telecom_beijing
capacity: 40
mode: auto
value: 2001:db8::3
weight: 21
gtmId: 162ca39d-*******
addrType: ipv6
capacityMode: pool
capacity: 90
name: testpool
remark: testdes
Example coming soon!
Create Pool Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Pool(name: string, args: PoolArgs, opts?: CustomResourceOptions);@overload
def Pool(resource_name: str,
args: PoolArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Pool(resource_name: str,
opts: Optional[ResourceOptions] = None,
addresses: Optional[Sequence[PoolAddressArgs]] = None,
gtm_id: Optional[str] = None,
name: Optional[str] = None,
addr_type: Optional[str] = None,
capacity: Optional[int] = None,
capacity_mode: Optional[str] = None,
remark: Optional[str] = None)func NewPool(ctx *Context, name string, args PoolArgs, opts ...ResourceOption) (*Pool, error)public Pool(string name, PoolArgs args, CustomResourceOptions? opts = null)type: volcenginecc:gtm:Pool
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "volcenginecc_gtm_pool" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args PoolArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args PoolArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args PoolArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args PoolArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args PoolArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var poolResource = new Volcenginecc.Gtm.Pool("poolResource", new()
{
Addresses = new[]
{
new Volcenginecc.Gtm.Inputs.PoolAddressArgs
{
Value = "string",
Capacity = 0,
Mode = "string",
RectifiedGeos = new[]
{
"string",
},
Weight = 0,
},
},
GtmId = "string",
Name = "string",
AddrType = "string",
Capacity = 0,
CapacityMode = "string",
Remark = "string",
});
example, err := gtm.NewPool(ctx, "poolResource", >m.PoolArgs{
Addresses: gtm.PoolAddressArray{
>m.PoolAddressArgs{
Value: pulumi.String("string"),
Capacity: pulumi.Int(0),
Mode: pulumi.String("string"),
RectifiedGeos: pulumi.StringArray{
pulumi.String("string"),
},
Weight: pulumi.Int(0),
},
},
GtmId: pulumi.String("string"),
Name: pulumi.String("string"),
AddrType: pulumi.String("string"),
Capacity: pulumi.Int(0),
CapacityMode: pulumi.String("string"),
Remark: pulumi.String("string"),
})
resource "volcenginecc_gtm_pool" "poolResource" {
addresses {
value = "string"
capacity = 0
mode = "string"
rectified_geos = ["string"]
weight = 0
}
gtm_id = "string"
name = "string"
addr_type = "string"
capacity = 0
capacity_mode = "string"
remark = "string"
}
var poolResource = new Pool("poolResource", PoolArgs.builder()
.addresses(PoolAddressArgs.builder()
.value("string")
.capacity(0)
.mode("string")
.rectifiedGeos("string")
.weight(0)
.build())
.gtmId("string")
.name("string")
.addrType("string")
.capacity(0)
.capacityMode("string")
.remark("string")
.build());
pool_resource = volcenginecc.gtm.Pool("poolResource",
addresses=[{
"value": "string",
"capacity": 0,
"mode": "string",
"rectified_geos": ["string"],
"weight": 0,
}],
gtm_id="string",
name="string",
addr_type="string",
capacity=0,
capacity_mode="string",
remark="string")
const poolResource = new volcenginecc.gtm.Pool("poolResource", {
addresses: [{
value: "string",
capacity: 0,
mode: "string",
rectifiedGeos: ["string"],
weight: 0,
}],
gtmId: "string",
name: "string",
addrType: "string",
capacity: 0,
capacityMode: "string",
remark: "string",
});
type: volcenginecc:gtm:Pool
properties:
addrType: string
addresses:
- capacity: 0
mode: string
rectifiedGeos:
- string
value: string
weight: 0
capacity: 0
capacityMode: string
gtmId: string
name: string
remark: string
Pool Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Pool resource accepts the following input properties:
- Addresses
List<Volcengine.
Pool Address> - Gtm
Id string - UUID of the associated GTM instance
- Name string
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- Addr
Type string - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- Capacity int
- Address pool capacity
- Capacity
Mode string - Capacity mode, indicates whether to configure address pool capacity or address capacity
- Remark string
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- Addresses
[]Pool
Address Args - Gtm
Id string - UUID of the associated GTM instance
- Name string
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- Addr
Type string - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- Capacity int
- Address pool capacity
- Capacity
Mode string - Capacity mode, indicates whether to configure address pool capacity or address capacity
- Remark string
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- addresses list(object)
- gtm_
id string - UUID of the associated GTM instance
- name string
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- addr_
type string - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- capacity number
- Address pool capacity
- capacity_
mode string - Capacity mode, indicates whether to configure address pool capacity or address capacity
- remark string
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- addresses
List<Pool
Address> - gtm
Id String - UUID of the associated GTM instance
- name String
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- addr
Type String - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- capacity Integer
- Address pool capacity
- capacity
Mode String - Capacity mode, indicates whether to configure address pool capacity or address capacity
- remark String
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- addresses
Pool
Address[] - gtm
Id string - UUID of the associated GTM instance
- name string
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- addr
Type string - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- capacity number
- Address pool capacity
- capacity
Mode string - Capacity mode, indicates whether to configure address pool capacity or address capacity
- remark string
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- addresses
Sequence[Pool
Address Args] - gtm_
id str - UUID of the associated GTM instance
- name str
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- addr_
type str - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- capacity int
- Address pool capacity
- capacity_
mode str - Capacity mode, indicates whether to configure address pool capacity or address capacity
- remark str
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- addresses List<Property Map>
- gtm
Id String - UUID of the associated GTM instance
- name String
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- addr
Type String - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- capacity Number
- Address pool capacity
- capacity
Mode String - Capacity mode, indicates whether to configure address pool capacity or address capacity
- remark String
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
Outputs
All input properties are implicitly available as output properties. Additionally, the Pool resource produces the following output properties:
- Create
Time string - Creation time
- Deletable bool
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- Id string
- The provider-assigned unique ID for this managed resource.
- Pool
Id string - Address pool ID
- Update
Time string - Update time
- Create
Time string - Creation time
- Deletable bool
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- Id string
- The provider-assigned unique ID for this managed resource.
- Pool
Id string - Address pool ID
- Update
Time string - Update time
- create_
time string - Creation time
- deletable bool
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- id string
- The provider-assigned unique ID for this managed resource.
- pool_
id string - Address pool ID
- update_
time string - Update time
- create
Time String - Creation time
- deletable Boolean
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- id String
- The provider-assigned unique ID for this managed resource.
- pool
Id String - Address pool ID
- update
Time String - Update time
- create
Time string - Creation time
- deletable boolean
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- id string
- The provider-assigned unique ID for this managed resource.
- pool
Id string - Address pool ID
- update
Time string - Update time
- create_
time str - Creation time
- deletable bool
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- id str
- The provider-assigned unique ID for this managed resource.
- pool_
id str - Address pool ID
- update_
time str - Update time
- create
Time String - Creation time
- deletable Boolean
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- id String
- The provider-assigned unique ID for this managed resource.
- pool
Id String - Address pool ID
- update
Time String - Update time
Look up Existing Pool Resource
Get an existing Pool resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: PoolState, opts?: CustomResourceOptions): Pool@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
addr_type: Optional[str] = None,
addresses: Optional[Sequence[PoolAddressArgs]] = None,
capacity: Optional[int] = None,
capacity_mode: Optional[str] = None,
create_time: Optional[str] = None,
deletable: Optional[bool] = None,
gtm_id: Optional[str] = None,
name: Optional[str] = None,
pool_id: Optional[str] = None,
remark: Optional[str] = None,
update_time: Optional[str] = None) -> Poolfunc GetPool(ctx *Context, name string, id IDInput, state *PoolState, opts ...ResourceOption) (*Pool, error)public static Pool Get(string name, Input<string> id, PoolState? state, CustomResourceOptions? opts = null)public static Pool get(String name, Output<String> id, PoolState state, CustomResourceOptions options)resources: _: type: volcenginecc:gtm:Pool get: id: ${id}import {
to = volcenginecc_gtm_pool.example
id = "${id}"
}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Addr
Type string - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- Addresses
List<Volcengine.
Pool Address> - Capacity int
- Address pool capacity
- Capacity
Mode string - Capacity mode, indicates whether to configure address pool capacity or address capacity
- Create
Time string - Creation time
- Deletable bool
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- Gtm
Id string - UUID of the associated GTM instance
- Name string
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- Pool
Id string - Address pool ID
- Remark string
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- Update
Time string - Update time
- Addr
Type string - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- Addresses
[]Pool
Address Args - Capacity int
- Address pool capacity
- Capacity
Mode string - Capacity mode, indicates whether to configure address pool capacity or address capacity
- Create
Time string - Creation time
- Deletable bool
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- Gtm
Id string - UUID of the associated GTM instance
- Name string
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- Pool
Id string - Address pool ID
- Remark string
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- Update
Time string - Update time
- addr_
type string - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- addresses list(object)
- capacity number
- Address pool capacity
- capacity_
mode string - Capacity mode, indicates whether to configure address pool capacity or address capacity
- create_
time string - Creation time
- deletable bool
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- gtm_
id string - UUID of the associated GTM instance
- name string
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- pool_
id string - Address pool ID
- remark string
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- update_
time string - Update time
- addr
Type String - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- addresses
List<Pool
Address> - capacity Integer
- Address pool capacity
- capacity
Mode String - Capacity mode, indicates whether to configure address pool capacity or address capacity
- create
Time String - Creation time
- deletable Boolean
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- gtm
Id String - UUID of the associated GTM instance
- name String
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- pool
Id String - Address pool ID
- remark String
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- update
Time String - Update time
- addr
Type string - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- addresses
Pool
Address[] - capacity number
- Address pool capacity
- capacity
Mode string - Capacity mode, indicates whether to configure address pool capacity or address capacity
- create
Time string - Creation time
- deletable boolean
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- gtm
Id string - UUID of the associated GTM instance
- name string
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- pool
Id string - Address pool ID
- remark string
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- update
Time string - Update time
- addr_
type str - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- addresses
Sequence[Pool
Address Args] - capacity int
- Address pool capacity
- capacity_
mode str - Capacity mode, indicates whether to configure address pool capacity or address capacity
- create_
time str - Creation time
- deletable bool
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- gtm_
id str - UUID of the associated GTM instance
- name str
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- pool_
id str - Address pool ID
- remark str
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- update_
time str - Update time
- addr
Type String - Target address type of the address pool. If you do not set this parameter, Cloud Scheduling GTM will automatically determine the target address type. ipv4: IPv4 address. ipv6: IPv6 address. cname: Domain name
- addresses List<Property Map>
- capacity Number
- Address pool capacity
- capacity
Mode String - Capacity mode, indicates whether to configure address pool capacity or address capacity
- create
Time String - Creation time
- deletable Boolean
- Whether the address pool can be deleted. true: The address pool is not referenced by any routing rule and can be deleted. false: The address pool is referenced by one or more routing rules and cannot be deleted
- gtm
Id String - UUID of the associated GTM instance
- name String
- Address pool name. UTF-8 format. Maximum length is 64 UTF-8 characters
- pool
Id String - Address pool ID
- remark String
- Address pool remarks. Default is an empty string. UTF-8 format. Maximum length is 128 UTF-8 characters
- update
Time String - Update time
Supporting Types
PoolAddress, PoolAddressArgs
- Value string
- Target address value
- Capacity int
- Address capacity
- Mode string
- Address availability mode
- Rectified
Geos List<string> - List of geographic route codes to be corrected
- Weight int
- Address weight
- Value string
- Target address value
- Capacity int
- Address capacity
- Mode string
- Address availability mode
- Rectified
Geos []string - List of geographic route codes to be corrected
- Weight int
- Address weight
- value string
- Target address value
- capacity number
- Address capacity
- mode string
- Address availability mode
- rectified_
geos list(string) - List of geographic route codes to be corrected
- weight number
- Address weight
- value String
- Target address value
- capacity Integer
- Address capacity
- mode String
- Address availability mode
- rectified
Geos List<String> - List of geographic route codes to be corrected
- weight Integer
- Address weight
- value string
- Target address value
- capacity number
- Address capacity
- mode string
- Address availability mode
- rectified
Geos string[] - List of geographic route codes to be corrected
- weight number
- Address weight
- value str
- Target address value
- capacity int
- Address capacity
- mode str
- Address availability mode
- rectified_
geos Sequence[str] - List of geographic route codes to be corrected
- weight int
- Address weight
- value String
- Target address value
- capacity Number
- Address capacity
- mode String
- Address availability mode
- rectified
Geos List<String> - List of geographic route codes to be corrected
- weight Number
- Address weight
Import
$ pulumi import volcenginecc:gtm/pool:Pool example "gtm_id|pool_id"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- volcenginecc volcengine/pulumi-volcenginecc
- License
- MPL-2.0
- Notes
- This Pulumi package is based on the
volcengineccTerraform Provider.
published on Monday, Jun 1, 2026 by Volcengine