HCSMachineConfigPool [infrastructure.cluster.x-k8s.io/v1beta1]

描述: HCSMachineConfigPool is the Schema for the hcsmachineconfigpools API. It provides a pool of pre-defined machine configurations (hostname, network settings) that can be claimed by HCSMachine resources.
类型: object
必填: spec

规格

属性	类型	描述
`apiVersion`	`string`	APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`string`	Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata`	`ObjectMeta`	ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
`spec`	`object`	spec defines the desired state of HCSMachineConfigPool
`status`	`object`	status defines the observed state of HCSMachineConfigPool

.spec

描述: spec defines the desired state of HCSMachineConfigPool
类型: object

属性	类型	描述
`configs`	`array`	Configs lists machine configurations claimable by HCSMachines.

.spec.configs

描述: Configs lists machine configurations claimable by HCSMachines.
类型: array

.spec.configs[]

描述: MachineConfig defines the configuration for a single machine in the pool.
类型: object
必填: hostnamenetworks

属性	类型	描述
`hostname`	`string`	Hostname is the hostname to assign to the machine.
`networks`	`array`	Networks is the list of network configurations for the machine.
`persistentDisks`	`array`	PersistentDisks declares EVS disks that survive HCSMachine delete-recreate. Each disk is bound to the (Hostname, Slot) identity and re-attached to the new ECS on rolling upgrade. Slots must be unique and contiguous from 0.

.spec.configs[].networks

描述: Networks is the list of network configurations for the machine.
类型: array

.spec.configs[].networks[]

描述: MachineConfigNetworkConfig defines the network configuration for a machine.
类型: object
必填: ipAddress

属性	类型	描述
`ipAddress`	`string`	IpAddress is the static IP address to assign to the machine.
`subenetName`	`string`	SubenetName is the deprecated legacy key kept for backward compatibility. Use subnetName instead.
`subnetId`	`string`	SubnetId is the ID of the subnet to use.
`subnetName`	`string`	SubnetName is the name of the subnet to use.

.spec.configs[].persistentDisks

描述: PersistentDisks declares EVS disks that survive HCSMachine delete-recreate. Each disk is bound to the (Hostname, Slot) identity and re-attached to the new ECS on rolling upgrade. Slots must be unique and contiguous from 0.
类型: array

.spec.configs[].persistentDisks[]

描述: PersistentDisk defines a persistent EVS disk attached to a fixed machine slot in the pool. Persistent disks survive HCSMachine delete-recreate cycles (e.g. rolling upgrades), while temporary disks declared in HCSMachineTemplate.spec.dataVolumes[] are removed together with their ECS.
类型: object
必填: sizeslottype

属性	类型	描述
`format`	`string`	Format is the filesystem format; empty normalises to xfs. Already-formatted disks are not re-formatted. Immutable once accepted (validating webhook).
`mountOptions`	`array`	MountOptions overrides the default ("defaults,noatime"); takes effect on next rebuild.
`mountPath`	`string`	MountPath is the guest filesystem mount path; empty means block device only (no fs_setup/mount). Immutable once accepted (validating webhook).
`size`	`integer`	Size is the EVS volume size in GB. CRD lower bound is 1 to accept legacy claimed volumes; the controller enforces the EVS [10, 32768] range only for new volumes. Immutable once accepted (validating webhook).
`slot`	`integer`	Slot is the disk position within the MachineConfig. Unique and contiguous from 0; combined with hostname it keys the underlying EVS volume.
`type`	`string`	Type is the EVS volume type name (e.g. SSD, SATA, hcs_global_ssd). Availability is checked at reconcile via CinderListVolumeTypes; no static whitelist. Immutable once accepted (validating webhook).

.spec.configs[].persistentDisks[].mountOptions

描述: MountOptions overrides the default ("defaults,noatime"); takes effect on next rebuild.
类型: array

.spec.configs[].persistentDisks[].mountOptions[]

类型: string

.status

描述: status defines the observed state of HCSMachineConfigPool
类型: object

属性	类型	描述
`availableCount`	`integer`	AvailableCount is the number of available configurations in the pool.
`persistentDiskStatus`	`array`	PersistentDiskStatus records the runtime state of every persistent disk owned by this pool, keyed by (Hostname, Slot).
`totalCount`	`integer`	TotalCount is the total number of configurations in the pool.
`usedConfigs`	`array`	UsedConfigs is the list of configurations that have been claimed by HCSMachines.

.status.persistentDiskStatus

描述: PersistentDiskStatus records the runtime state of every persistent disk owned by this pool, keyed by (Hostname, Slot).
类型: array

.status.persistentDiskStatus[]

描述: PersistentDiskStatus records the runtime state of a single persistent disk, keyed by (Hostname, Slot). Spec fields (size/type/format/mountPath) are not duplicated here.
类型: object
必填: hostnameslot

属性	类型	描述
`attachedServerID`	`string`	AttachedServerID is the ECS server id where the disk is currently attached. Cleared during reconcileDelete after the EVS has returned to available.
`availabilityZone`	`string`	AvailabilityZone of the EVS volume; the controller locks the ECS AZ to this value.
`device`	`string`	Device is the guest-visible device path (e.g. /dev/vdc) computed from the current (len(spec.dataVolumes), slot). Cleared during reconcileDelete.
`hostname`	`string`	Hostname identifies which MachineConfig the disk belongs to.
`lastError`	`string`	LastError records the last error message, set when Phase=Error.
`lastTransitionTime`	`string`	LastTransitionTime marks the most recent phase change.
`name`	`string`	Name is the stable EVS volume name produced by PersistentVolumeName().
`ownerMachineName`	`string`	OwnerMachineName is the name of the HCSMachine currently bound to this disk.
`ownerMachineUID`	`string`	OwnerMachineUID is the UID of the HCSMachine currently bound to this disk.
`phase`	`string`	Phase is the current lifecycle phase.
`slot`	`integer`	Slot is the disk slot within the MachineConfig (matches spec).
`volumeID`	`string`	VolumeID is the HCS EVS volume id.

.status.usedConfigs

描述: UsedConfigs is the list of configurations that have been claimed by HCSMachines.
类型: array

.status.usedConfigs[]

描述: UsedConfig represents a machine configuration that has been claimed by a HCSMachine.
类型: object
必填: hostnamemachineRef

属性	类型	描述
`hostname`	`string`	HostName is the hostname of the claimed configuration.
`machineRef`	`string`	MachineRef is the name of the HCSMachine that claimed this configuration.

API 端点

可用的 API 端点如下：

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools
- DELETE: delete collection of HCSMachineConfigPool
- GET: list objects of kind HCSMachineConfigPool
- POST: create a new HCSMachineConfigPool
/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools/{name}
- DELETE: delete the specified HCSMachineConfigPool
- GET: read the specified HCSMachineConfigPool
- PATCH: partially update the specified HCSMachineConfigPool
- PUT: replace the specified HCSMachineConfigPool
/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools/{name}/status
- GET: read status of the specified HCSMachineConfigPool
- PATCH: partially update status of the specified HCSMachineConfigPool
- PUT: replace status of the specified HCSMachineConfigPool

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools

HTTP 方法: DELETE
描述: delete collection of HCSMachineConfigPool
HTTP 响应

HTTP 状态码	响应体
200 - OK	`Status` schema
401 - Unauthorized	Empty

HTTP 方法: GET
描述: list objects of kind HCSMachineConfigPool
HTTP 响应

HTTP 状态码	响应体
200 - OK	`HCSMachineConfigPoolList` schema
401 - Unauthorized	Empty

HTTP 方法: POST
描述: create a new HCSMachineConfigPool

查询参数

参数	类型	描述
`dryRun`	`string`	When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
`fieldValidation`	`string`	fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.

请求体参数

参数	类型	描述
`body`	`HCSMachineConfigPool` schema	`application/json` formatted

HTTP 响应

HTTP 状态码	响应体
200 - OK	`HCSMachineConfigPool` schema
201 - Created	`HCSMachineConfigPool` schema
202 - Accepted	`HCSMachineConfigPool` schema
401 - Unauthorized	Empty

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools/{name}

HTTP 方法: DELETE
描述: delete the specified HCSMachineConfigPool

查询参数

参数	类型	描述
`dryRun`	`string`	When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed

HTTP 响应

HTTP 状态码	响应体
200 - OK	`Status` schema
202 - Accepted	`Status` schema
401 - Unauthorized	Empty

HTTP 方法: GET
描述: read the specified HCSMachineConfigPool
HTTP 响应

HTTP 状态码	响应体
200 - OK	`HCSMachineConfigPool` schema
401 - Unauthorized	Empty

HTTP 方法: PATCH
描述: partially update the specified HCSMachineConfigPool

查询参数

参数	类型	描述
`dryRun`	`string`	When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
`fieldValidation`	`string`	fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.

HTTP 响应

HTTP 状态码	响应体
200 - OK	`HCSMachineConfigPool` schema
401 - Unauthorized	Empty

HTTP 方法: PUT
描述: replace the specified HCSMachineConfigPool

查询参数

参数	类型	描述
`dryRun`	`string`	When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
`fieldValidation`	`string`	fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.

请求体参数

参数	类型	描述
`body`	`HCSMachineConfigPool` schema	`application/json` formatted

HTTP 响应

HTTP 状态码	响应体
200 - OK	`HCSMachineConfigPool` schema
201 - Created	`HCSMachineConfigPool` schema
401 - Unauthorized	Empty

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools/{name}/status

HTTP 方法: GET
描述: read status of the specified HCSMachineConfigPool
HTTP 响应

HTTP 状态码	响应体
200 - OK	`HCSMachineConfigPool` schema
401 - Unauthorized	Empty

HTTP 方法: PATCH
描述: partially update status of the specified HCSMachineConfigPool

查询参数

参数	类型	描述
`dryRun`	`string`	When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
`fieldValidation`	`string`	fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.

HTTP 响应

HTTP 状态码	响应体
200 - OK	`HCSMachineConfigPool` schema
401 - Unauthorized	Empty

HTTP 方法: PUT
描述: replace status of the specified HCSMachineConfigPool

查询参数

参数	类型	描述
`dryRun`	`string`	When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
`fieldValidation`	`string`	fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.

请求体参数

参数	类型	描述
`body`	`HCSMachineConfigPool` schema	`application/json` formatted

HTTP 响应

HTTP 状态码	响应体
200 - OK	`HCSMachineConfigPool` schema
201 - Created	`HCSMachineConfigPool` schema
401 - Unauthorized	Empty

#HCSMachineConfigPool [infrastructure.cluster.x-k8s.io/v1beta1]

#规格

#.spec

#.spec.configs

#.spec.configs[]

#.spec.configs[].networks

#.spec.configs[].networks[]

#.spec.configs[].persistentDisks

#.spec.configs[].persistentDisks[]

#.spec.configs[].persistentDisks[].mountOptions

#.spec.configs[].persistentDisks[].mountOptions[]

#.status

#.status.persistentDiskStatus

#.status.persistentDiskStatus[]

#.status.usedConfigs

#.status.usedConfigs[]

API 端点#

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools#

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools/{name}#

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools/{name}/status#

HCSMachineConfigPool [infrastructure.cluster.x-k8s.io/v1beta1]

规格

.spec

.spec.configs

.spec.configs[]

.spec.configs[].networks

.spec.configs[].networks[]

.spec.configs[].persistentDisks

.spec.configs[].persistentDisks[]

.spec.configs[].persistentDisks[].mountOptions

.spec.configs[].persistentDisks[].mountOptions[]

.status

.status.persistentDiskStatus

.status.persistentDiskStatus[]

.status.usedConfigs

.status.usedConfigs[]

API 端点

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools/{name}

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/hcsmachineconfigpools/{name}/status