alicloud.alikafka.Instance
Explore with Pulumi AI
Import
AliKafka instance can be imported using the id, e.g.
$ pulumi import alicloud:alikafka/instance:Instance instance <id>
Create Instance Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Instance(name: string, args: InstanceArgs, opts?: CustomResourceOptions);
@overload
def Instance(resource_name: str,
args: InstanceArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Instance(resource_name: str,
opts: Optional[ResourceOptions] = None,
vswitch_id: Optional[str] = None,
deploy_type: Optional[int] = None,
disk_size: Optional[int] = None,
disk_type: Optional[int] = None,
partition_num: Optional[int] = None,
selected_zones: Optional[Sequence[str]] = None,
io_max_spec: Optional[str] = None,
kms_key_id: Optional[str] = None,
name: Optional[str] = None,
paid_type: Optional[str] = None,
config: Optional[str] = None,
resource_group_id: Optional[str] = None,
security_group: Optional[str] = None,
io_max: Optional[int] = None,
service_version: Optional[str] = None,
spec_type: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
topic_quota: Optional[int] = None,
vpc_id: Optional[str] = None,
eip_max: Optional[int] = None,
zone_id: Optional[str] = None)
func NewInstance(ctx *Context, name string, args InstanceArgs, opts ...ResourceOption) (*Instance, error)
public Instance(string name, InstanceArgs args, CustomResourceOptions? opts = null)
public Instance(String name, InstanceArgs args)
public Instance(String name, InstanceArgs args, CustomResourceOptions options)
type: alicloud:alikafka:Instance
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args InstanceArgs
- 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 InstanceArgs
- 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 InstanceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args InstanceArgs
- 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 instanceResource = new AliCloud.AliKafka.Instance("instanceResource", new()
{
VswitchId = "string",
DeployType = 0,
DiskSize = 0,
DiskType = 0,
PartitionNum = 0,
SelectedZones = new[]
{
"string",
},
IoMaxSpec = "string",
KmsKeyId = "string",
Name = "string",
PaidType = "string",
Config = "string",
ResourceGroupId = "string",
SecurityGroup = "string",
IoMax = 0,
ServiceVersion = "string",
SpecType = "string",
Tags =
{
{ "string", "string" },
},
VpcId = "string",
EipMax = 0,
ZoneId = "string",
});
example, err := alikafka.NewInstance(ctx, "instanceResource", &alikafka.InstanceArgs{
VswitchId: pulumi.String("string"),
DeployType: pulumi.Int(0),
DiskSize: pulumi.Int(0),
DiskType: pulumi.Int(0),
PartitionNum: pulumi.Int(0),
SelectedZones: pulumi.StringArray{
pulumi.String("string"),
},
IoMaxSpec: pulumi.String("string"),
KmsKeyId: pulumi.String("string"),
Name: pulumi.String("string"),
PaidType: pulumi.String("string"),
Config: pulumi.String("string"),
ResourceGroupId: pulumi.String("string"),
SecurityGroup: pulumi.String("string"),
IoMax: pulumi.Int(0),
ServiceVersion: pulumi.String("string"),
SpecType: pulumi.String("string"),
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
VpcId: pulumi.String("string"),
EipMax: pulumi.Int(0),
ZoneId: pulumi.String("string"),
})
var instanceResource = new Instance("instanceResource", InstanceArgs.builder()
.vswitchId("string")
.deployType(0)
.diskSize(0)
.diskType(0)
.partitionNum(0)
.selectedZones("string")
.ioMaxSpec("string")
.kmsKeyId("string")
.name("string")
.paidType("string")
.config("string")
.resourceGroupId("string")
.securityGroup("string")
.ioMax(0)
.serviceVersion("string")
.specType("string")
.tags(Map.of("string", "string"))
.vpcId("string")
.eipMax(0)
.zoneId("string")
.build());
instance_resource = alicloud.alikafka.Instance("instanceResource",
vswitch_id="string",
deploy_type=0,
disk_size=0,
disk_type=0,
partition_num=0,
selected_zones=["string"],
io_max_spec="string",
kms_key_id="string",
name="string",
paid_type="string",
config="string",
resource_group_id="string",
security_group="string",
io_max=0,
service_version="string",
spec_type="string",
tags={
"string": "string",
},
vpc_id="string",
eip_max=0,
zone_id="string")
const instanceResource = new alicloud.alikafka.Instance("instanceResource", {
vswitchId: "string",
deployType: 0,
diskSize: 0,
diskType: 0,
partitionNum: 0,
selectedZones: ["string"],
ioMaxSpec: "string",
kmsKeyId: "string",
name: "string",
paidType: "string",
config: "string",
resourceGroupId: "string",
securityGroup: "string",
ioMax: 0,
serviceVersion: "string",
specType: "string",
tags: {
string: "string",
},
vpcId: "string",
eipMax: 0,
zoneId: "string",
});
type: alicloud:alikafka:Instance
properties:
config: string
deployType: 0
diskSize: 0
diskType: 0
eipMax: 0
ioMax: 0
ioMaxSpec: string
kmsKeyId: string
name: string
paidType: string
partitionNum: 0
resourceGroupId: string
securityGroup: string
selectedZones:
- string
serviceVersion: string
specType: string
tags:
string: string
vpcId: string
vswitchId: string
zoneId: string
Instance Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Instance resource accepts the following input properties:
- Deploy
Type int - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- Disk
Size int - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- Disk
Type int - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- Vswitch
Id string - The ID of attaching vswitch to instance.
- Config string
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- Eip
Max int - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - Io
Max int - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- Io
Max stringSpec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- Kms
Key stringId - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- Name string
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- Paid
Type string - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- Partition
Num int - The number of partitions.
- Resource
Group stringId - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- Security
Group string - The ID of security group for this instance. If the security group is empty, system will create a default one.
- Selected
Zones List<string> The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- Service
Version string - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - Spec
Type string - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- Dictionary<string, string>
- A mapping of tags to assign to the resource.
- Topic
Quota int - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - Vpc
Id string - The VPC ID of the instance.
- Zone
Id string - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
- Deploy
Type int - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- Disk
Size int - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- Disk
Type int - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- Vswitch
Id string - The ID of attaching vswitch to instance.
- Config string
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- Eip
Max int - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - Io
Max int - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- Io
Max stringSpec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- Kms
Key stringId - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- Name string
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- Paid
Type string - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- Partition
Num int - The number of partitions.
- Resource
Group stringId - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- Security
Group string - The ID of security group for this instance. If the security group is empty, system will create a default one.
- Selected
Zones []string The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- Service
Version string - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - Spec
Type string - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- map[string]string
- A mapping of tags to assign to the resource.
- Topic
Quota int - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - Vpc
Id string - The VPC ID of the instance.
- Zone
Id string - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
- deploy
Type Integer - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- disk
Size Integer - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- disk
Type Integer - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- vswitch
Id String - The ID of attaching vswitch to instance.
- config String
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- eip
Max Integer - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - io
Max Integer - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- io
Max StringSpec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- kms
Key StringId - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- name String
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- paid
Type String - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- partition
Num Integer - The number of partitions.
- resource
Group StringId - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- security
Group String - The ID of security group for this instance. If the security group is empty, system will create a default one.
- selected
Zones List<String> The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- service
Version String - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - spec
Type String - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- Map<String,String>
- A mapping of tags to assign to the resource.
- topic
Quota Integer - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - vpc
Id String - The VPC ID of the instance.
- zone
Id String - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
- deploy
Type number - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- disk
Size number - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- disk
Type number - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- vswitch
Id string - The ID of attaching vswitch to instance.
- config string
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- eip
Max number - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - io
Max number - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- io
Max stringSpec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- kms
Key stringId - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- name string
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- paid
Type string - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- partition
Num number - The number of partitions.
- resource
Group stringId - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- security
Group string - The ID of security group for this instance. If the security group is empty, system will create a default one.
- selected
Zones string[] The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- service
Version string - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - spec
Type string - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- {[key: string]: string}
- A mapping of tags to assign to the resource.
- topic
Quota number - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - vpc
Id string - The VPC ID of the instance.
- zone
Id string - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
- deploy_
type int - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- disk_
size int - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- disk_
type int - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- vswitch_
id str - The ID of attaching vswitch to instance.
- config str
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- eip_
max int - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - io_
max int - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- io_
max_ strspec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- kms_
key_ strid - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- name str
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- paid_
type str - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- partition_
num int - The number of partitions.
- resource_
group_ strid - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- security_
group str - The ID of security group for this instance. If the security group is empty, system will create a default one.
- selected_
zones Sequence[str] The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- service_
version str - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - spec_
type str - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- Mapping[str, str]
- A mapping of tags to assign to the resource.
- topic_
quota int - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - vpc_
id str - The VPC ID of the instance.
- zone_
id str - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
- deploy
Type Number - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- disk
Size Number - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- disk
Type Number - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- vswitch
Id String - The ID of attaching vswitch to instance.
- config String
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- eip
Max Number - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - io
Max Number - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- io
Max StringSpec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- kms
Key StringId - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- name String
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- paid
Type String - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- partition
Num Number - The number of partitions.
- resource
Group StringId - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- security
Group String - The ID of security group for this instance. If the security group is empty, system will create a default one.
- selected
Zones List<String> The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- service
Version String - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - spec
Type String - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- Map<String>
- A mapping of tags to assign to the resource.
- topic
Quota Number - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - vpc
Id String - The VPC ID of the instance.
- zone
Id String - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
Outputs
All input properties are implicitly available as output properties. Additionally, the Instance resource produces the following output properties:
- End
Point string - The EndPoint to access the kafka instance.
- Group
Left int - (Available since v1.214.1) The number of available groups.
- Group
Used int - (Available since v1.214.1) The number of used groups.
- Id string
- The provider-assigned unique ID for this managed resource.
- Is
Partition intBuy - (Available since v1.214.1) The method that you use to purchase partitions.
- Partition
Left int - (Available since v1.214.1) The number of available partitions.
- Partition
Used int - (Available since v1.214.1) The number of used partitions.
- Status int
- The status of the instance.
- Topic
Left int - (Available since v1.214.1) The number of available topics.
- Topic
Num intOf Buy - (Available since v1.214.1) The number of purchased topics.
- Topic
Used int - (Available since v1.214.1) The number of used topics.
- End
Point string - The EndPoint to access the kafka instance.
- Group
Left int - (Available since v1.214.1) The number of available groups.
- Group
Used int - (Available since v1.214.1) The number of used groups.
- Id string
- The provider-assigned unique ID for this managed resource.
- Is
Partition intBuy - (Available since v1.214.1) The method that you use to purchase partitions.
- Partition
Left int - (Available since v1.214.1) The number of available partitions.
- Partition
Used int - (Available since v1.214.1) The number of used partitions.
- Status int
- The status of the instance.
- Topic
Left int - (Available since v1.214.1) The number of available topics.
- Topic
Num intOf Buy - (Available since v1.214.1) The number of purchased topics.
- Topic
Used int - (Available since v1.214.1) The number of used topics.
- end
Point String - The EndPoint to access the kafka instance.
- group
Left Integer - (Available since v1.214.1) The number of available groups.
- group
Used Integer - (Available since v1.214.1) The number of used groups.
- id String
- The provider-assigned unique ID for this managed resource.
- is
Partition IntegerBuy - (Available since v1.214.1) The method that you use to purchase partitions.
- partition
Left Integer - (Available since v1.214.1) The number of available partitions.
- partition
Used Integer - (Available since v1.214.1) The number of used partitions.
- status Integer
- The status of the instance.
- topic
Left Integer - (Available since v1.214.1) The number of available topics.
- topic
Num IntegerOf Buy - (Available since v1.214.1) The number of purchased topics.
- topic
Used Integer - (Available since v1.214.1) The number of used topics.
- end
Point string - The EndPoint to access the kafka instance.
- group
Left number - (Available since v1.214.1) The number of available groups.
- group
Used number - (Available since v1.214.1) The number of used groups.
- id string
- The provider-assigned unique ID for this managed resource.
- is
Partition numberBuy - (Available since v1.214.1) The method that you use to purchase partitions.
- partition
Left number - (Available since v1.214.1) The number of available partitions.
- partition
Used number - (Available since v1.214.1) The number of used partitions.
- status number
- The status of the instance.
- topic
Left number - (Available since v1.214.1) The number of available topics.
- topic
Num numberOf Buy - (Available since v1.214.1) The number of purchased topics.
- topic
Used number - (Available since v1.214.1) The number of used topics.
- end_
point str - The EndPoint to access the kafka instance.
- group_
left int - (Available since v1.214.1) The number of available groups.
- group_
used int - (Available since v1.214.1) The number of used groups.
- id str
- The provider-assigned unique ID for this managed resource.
- is_
partition_ intbuy - (Available since v1.214.1) The method that you use to purchase partitions.
- partition_
left int - (Available since v1.214.1) The number of available partitions.
- partition_
used int - (Available since v1.214.1) The number of used partitions.
- status int
- The status of the instance.
- topic_
left int - (Available since v1.214.1) The number of available topics.
- topic_
num_ intof_ buy - (Available since v1.214.1) The number of purchased topics.
- topic_
used int - (Available since v1.214.1) The number of used topics.
- end
Point String - The EndPoint to access the kafka instance.
- group
Left Number - (Available since v1.214.1) The number of available groups.
- group
Used Number - (Available since v1.214.1) The number of used groups.
- id String
- The provider-assigned unique ID for this managed resource.
- is
Partition NumberBuy - (Available since v1.214.1) The method that you use to purchase partitions.
- partition
Left Number - (Available since v1.214.1) The number of available partitions.
- partition
Used Number - (Available since v1.214.1) The number of used partitions.
- status Number
- The status of the instance.
- topic
Left Number - (Available since v1.214.1) The number of available topics.
- topic
Num NumberOf Buy - (Available since v1.214.1) The number of purchased topics.
- topic
Used Number - (Available since v1.214.1) The number of used topics.
Look up Existing Instance Resource
Get an existing Instance 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?: InstanceState, opts?: CustomResourceOptions): Instance
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
config: Optional[str] = None,
deploy_type: Optional[int] = None,
disk_size: Optional[int] = None,
disk_type: Optional[int] = None,
eip_max: Optional[int] = None,
end_point: Optional[str] = None,
group_left: Optional[int] = None,
group_used: Optional[int] = None,
io_max: Optional[int] = None,
io_max_spec: Optional[str] = None,
is_partition_buy: Optional[int] = None,
kms_key_id: Optional[str] = None,
name: Optional[str] = None,
paid_type: Optional[str] = None,
partition_left: Optional[int] = None,
partition_num: Optional[int] = None,
partition_used: Optional[int] = None,
resource_group_id: Optional[str] = None,
security_group: Optional[str] = None,
selected_zones: Optional[Sequence[str]] = None,
service_version: Optional[str] = None,
spec_type: Optional[str] = None,
status: Optional[int] = None,
tags: Optional[Mapping[str, str]] = None,
topic_left: Optional[int] = None,
topic_num_of_buy: Optional[int] = None,
topic_quota: Optional[int] = None,
topic_used: Optional[int] = None,
vpc_id: Optional[str] = None,
vswitch_id: Optional[str] = None,
zone_id: Optional[str] = None) -> Instance
func GetInstance(ctx *Context, name string, id IDInput, state *InstanceState, opts ...ResourceOption) (*Instance, error)
public static Instance Get(string name, Input<string> id, InstanceState? state, CustomResourceOptions? opts = null)
public static Instance get(String name, Output<String> id, InstanceState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- 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.
- Config string
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- Deploy
Type int - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- Disk
Size int - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- Disk
Type int - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- Eip
Max int - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - End
Point string - The EndPoint to access the kafka instance.
- Group
Left int - (Available since v1.214.1) The number of available groups.
- Group
Used int - (Available since v1.214.1) The number of used groups.
- Io
Max int - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- Io
Max stringSpec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- Is
Partition intBuy - (Available since v1.214.1) The method that you use to purchase partitions.
- Kms
Key stringId - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- Name string
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- Paid
Type string - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- Partition
Left int - (Available since v1.214.1) The number of available partitions.
- Partition
Num int - The number of partitions.
- Partition
Used int - (Available since v1.214.1) The number of used partitions.
- Resource
Group stringId - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- Security
Group string - The ID of security group for this instance. If the security group is empty, system will create a default one.
- Selected
Zones List<string> The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- Service
Version string - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - Spec
Type string - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- Status int
- The status of the instance.
- Dictionary<string, string>
- A mapping of tags to assign to the resource.
- Topic
Left int - (Available since v1.214.1) The number of available topics.
- Topic
Num intOf Buy - (Available since v1.214.1) The number of purchased topics.
- Topic
Quota int - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - Topic
Used int - (Available since v1.214.1) The number of used topics.
- Vpc
Id string - The VPC ID of the instance.
- Vswitch
Id string - The ID of attaching vswitch to instance.
- Zone
Id string - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
- Config string
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- Deploy
Type int - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- Disk
Size int - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- Disk
Type int - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- Eip
Max int - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - End
Point string - The EndPoint to access the kafka instance.
- Group
Left int - (Available since v1.214.1) The number of available groups.
- Group
Used int - (Available since v1.214.1) The number of used groups.
- Io
Max int - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- Io
Max stringSpec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- Is
Partition intBuy - (Available since v1.214.1) The method that you use to purchase partitions.
- Kms
Key stringId - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- Name string
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- Paid
Type string - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- Partition
Left int - (Available since v1.214.1) The number of available partitions.
- Partition
Num int - The number of partitions.
- Partition
Used int - (Available since v1.214.1) The number of used partitions.
- Resource
Group stringId - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- Security
Group string - The ID of security group for this instance. If the security group is empty, system will create a default one.
- Selected
Zones []string The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- Service
Version string - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - Spec
Type string - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- Status int
- The status of the instance.
- map[string]string
- A mapping of tags to assign to the resource.
- Topic
Left int - (Available since v1.214.1) The number of available topics.
- Topic
Num intOf Buy - (Available since v1.214.1) The number of purchased topics.
- Topic
Quota int - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - Topic
Used int - (Available since v1.214.1) The number of used topics.
- Vpc
Id string - The VPC ID of the instance.
- Vswitch
Id string - The ID of attaching vswitch to instance.
- Zone
Id string - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
- config String
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- deploy
Type Integer - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- disk
Size Integer - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- disk
Type Integer - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- eip
Max Integer - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - end
Point String - The EndPoint to access the kafka instance.
- group
Left Integer - (Available since v1.214.1) The number of available groups.
- group
Used Integer - (Available since v1.214.1) The number of used groups.
- io
Max Integer - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- io
Max StringSpec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- is
Partition IntegerBuy - (Available since v1.214.1) The method that you use to purchase partitions.
- kms
Key StringId - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- name String
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- paid
Type String - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- partition
Left Integer - (Available since v1.214.1) The number of available partitions.
- partition
Num Integer - The number of partitions.
- partition
Used Integer - (Available since v1.214.1) The number of used partitions.
- resource
Group StringId - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- security
Group String - The ID of security group for this instance. If the security group is empty, system will create a default one.
- selected
Zones List<String> The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- service
Version String - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - spec
Type String - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- status Integer
- The status of the instance.
- Map<String,String>
- A mapping of tags to assign to the resource.
- topic
Left Integer - (Available since v1.214.1) The number of available topics.
- topic
Num IntegerOf Buy - (Available since v1.214.1) The number of purchased topics.
- topic
Quota Integer - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - topic
Used Integer - (Available since v1.214.1) The number of used topics.
- vpc
Id String - The VPC ID of the instance.
- vswitch
Id String - The ID of attaching vswitch to instance.
- zone
Id String - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
- config string
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- deploy
Type number - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- disk
Size number - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- disk
Type number - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- eip
Max number - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - end
Point string - The EndPoint to access the kafka instance.
- group
Left number - (Available since v1.214.1) The number of available groups.
- group
Used number - (Available since v1.214.1) The number of used groups.
- io
Max number - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- io
Max stringSpec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- is
Partition numberBuy - (Available since v1.214.1) The method that you use to purchase partitions.
- kms
Key stringId - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- name string
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- paid
Type string - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- partition
Left number - (Available since v1.214.1) The number of available partitions.
- partition
Num number - The number of partitions.
- partition
Used number - (Available since v1.214.1) The number of used partitions.
- resource
Group stringId - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- security
Group string - The ID of security group for this instance. If the security group is empty, system will create a default one.
- selected
Zones string[] The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- service
Version string - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - spec
Type string - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- status number
- The status of the instance.
- {[key: string]: string}
- A mapping of tags to assign to the resource.
- topic
Left number - (Available since v1.214.1) The number of available topics.
- topic
Num numberOf Buy - (Available since v1.214.1) The number of purchased topics.
- topic
Quota number - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - topic
Used number - (Available since v1.214.1) The number of used topics.
- vpc
Id string - The VPC ID of the instance.
- vswitch
Id string - The ID of attaching vswitch to instance.
- zone
Id string - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
- config str
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- deploy_
type int - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- disk_
size int - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- disk_
type int - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- eip_
max int - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - end_
point str - The EndPoint to access the kafka instance.
- group_
left int - (Available since v1.214.1) The number of available groups.
- group_
used int - (Available since v1.214.1) The number of used groups.
- io_
max int - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- io_
max_ strspec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- is_
partition_ intbuy - (Available since v1.214.1) The method that you use to purchase partitions.
- kms_
key_ strid - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- name str
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- paid_
type str - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- partition_
left int - (Available since v1.214.1) The number of available partitions.
- partition_
num int - The number of partitions.
- partition_
used int - (Available since v1.214.1) The number of used partitions.
- resource_
group_ strid - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- security_
group str - The ID of security group for this instance. If the security group is empty, system will create a default one.
- selected_
zones Sequence[str] The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- service_
version str - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - spec_
type str - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- status int
- The status of the instance.
- Mapping[str, str]
- A mapping of tags to assign to the resource.
- topic_
left int - (Available since v1.214.1) The number of available topics.
- topic_
num_ intof_ buy - (Available since v1.214.1) The number of purchased topics.
- topic_
quota int - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - topic_
used int - (Available since v1.214.1) The number of used topics.
- vpc_
id str - The VPC ID of the instance.
- vswitch_
id str - The ID of attaching vswitch to instance.
- zone_
id str - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
- config String
- The initial configurations of the ApsaraMQ for Kafka instance. The values must be valid JSON strings. The
config
supports the following parameters:enable.vpc_sasl_ssl
: Specifies whether to enable VPC transmission encryption. Default value:false
. Valid values:
- deploy
Type Number - The deployment type of the instance. NOTE: From version 1.161.0, this attribute supports to be updated. Valid values:
- 4: eip/vpc instance
- 5: vpc instance.
- disk
Size Number - The disk size of the instance. When modify this value, it only supports adjust to a greater value.
- disk
Type Number - The disk type of the instance. 0: efficient cloud disk , 1: SSD.
- eip
Max Number - The max bandwidth of the instance. It will be ignored when
deploy_type = 5
. When modify this value, it only supports adjust to a greater value. - end
Point String - The EndPoint to access the kafka instance.
- group
Left Number - (Available since v1.214.1) The number of available groups.
- group
Used Number - (Available since v1.214.1) The number of used groups.
- io
Max Number - The max value of io of the instance. When modify this value, it only support adjust to a greater value.
- io
Max StringSpec - The traffic specification of the instance. We recommend that you configure this parameter.
- You should specify one of the
io_max
andio_max_spec
parameters, andio_max_spec
is recommended. - For more information about the valid values, see Billing.
- You should specify one of the
- is
Partition NumberBuy - (Available since v1.214.1) The method that you use to purchase partitions.
- kms
Key StringId - The ID of the key that is used to encrypt data on standard SSDs in the region of the instance.
- name String
- Name of your Kafka instance. The length should between 3 and 64 characters. If not set, will use instance id as instance name.
- paid
Type String - The paid type of the instance. Support two type, "PrePaid": pre paid type instance, "PostPaid": post paid type instance. Default is PostPaid. When modify this value, it only support adjust from post pay to pre pay.
- partition
Left Number - (Available since v1.214.1) The number of available partitions.
- partition
Num Number - The number of partitions.
- partition
Used Number - (Available since v1.214.1) The number of used partitions.
- resource
Group StringId - The ID of the resource group. Note: Once you set a value of this property, you cannot set it to an empty string anymore.
- security
Group String - The ID of security group for this instance. If the security group is empty, system will create a default one.
- selected
Zones List<String> The zones among which you want to deploy the instance.
NOTE: Arguments io_max, disk_size, topic_quota, eip_max should follow the following constraints.
| io_max | disk_size(min-max:lag) | topic_quota(min-max:lag) | eip_max(min-max:lag) | |------|-------------|:----:|:-----:| |20 | 500-6100:100 | 50-450:1 | 1-160:1 | |30 | 800-6100:100 | 50-450:1 | 1-240:1 | |60 | 1400-6100:100 | 80-450:1 | 1-500:1 | |90 | 2100-6100:100 | 100-450:1 | 1-500:1 | |120 | 2700-6100:100 | 150-450:1 | 1-500:1 |
- service
Version String - The version of the ApsaraMQ for Kafka instance. Default value:
2.2.0
. Valid values:2.2.0
,2.6.2
. - spec
Type String - The spec type of the instance. Support two type, "normal": normal version instance, "professional": professional version instance. Default is normal. When modify this value, it only support adjust from normal to professional. Note only pre paid type instance support professional specific type.
- status Number
- The status of the instance.
- Map<String>
- A mapping of tags to assign to the resource.
- topic
Left Number - (Available since v1.214.1) The number of available topics.
- topic
Num NumberOf Buy - (Available since v1.214.1) The number of purchased topics.
- topic
Quota Number - The max num of topic can be creation of the instance.
It has been deprecated since version 1.194.0 and using
partition_num
instead. Currently, its value only can be set to 50 when creating it, and finally depends onpartition_num
value: <topic_quota
> = 1000 + <partition_num
>. Therefore, you can update it by updating thepartition_num
, and it is the only updating path. - topic
Used Number - (Available since v1.214.1) The number of used topics.
- vpc
Id String - The VPC ID of the instance.
- vswitch
Id String - The ID of attaching vswitch to instance.
- zone
Id String - The zone ID of the instance. The value can be in zone x or region id-x format. NOTE: When the available zone is insufficient, another availability zone may be deployed.
Package Details
- Repository
- Alibaba Cloud pulumi/pulumi-alicloud
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
alicloud
Terraform Provider.