最近更新时间:2024.04.09 15:04:00
首次发布时间:2023.11.30 14:19:26
调用 DescribeInstance 接口,查询指定实例的配置详情。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeInstance | 接口名称。当前 API 的名称为 DescribeInstance 。 |
Version | String | 是 | 2023-01-01 | 接口版本。当前 API 的版本为 2023-01-01 。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
InstanceId | String | 是 | o-0080**iu98 | 需要查询配置详情的实例 ID。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
InstanceInfo | Object of ESInstanceInfoDTO | 实例配置详情信息。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
ESEip | String | 180.*.*.* | 实例所绑定的 EIP。 |
Status | String |
| 实例当前状态。 |
UserId | String | 210***34 | 实例所有者的用户 ID。 |
ESEipId | String | eip-mij5ztefl98** | 实例所绑定的 EIP 的 ID。 |
ClusterId | String | 16a119e0d***41ae2627b0 | 实例所属集群的 ID。 |
KibanaEip | String | 180.*.*.* | Kibana 所绑定的 EIP。 |
CreateTime | String | 2024-03-21T10:32:24+08:00 | 实例的创建时间。 |
ExpireDate | String | 2023-11-11T15:59:59.000+00:00 | 包年包月实例的付费过期时间。 |
InstanceId | String | o-00k***o718 | 实例 ID。 |
TotalNodes | Integer | 12 | 实例的总节点数。 |
KibanaEipId | String | eip-mij5ztefl98** | Kibana 所绑定的 EIP 的 ID。 |
KibanaConfig | Object of ESKibanaConfig | Kibana 参数配置。 | |
ResourceTags | Array of TagInfo | 实例的标签信息。 | |
SubInstances | Array of ESSubInstanceDTO | 企业级 SQL 分析实例配置信息。 | |
TransferInfo | Object of TransferInfo | 数据迁移任务信息。 | |
ChargeEnabled | Boolean | true | 实例是否开启了计费。取值说明如下: |
CerebroEnabled | Boolean | true | 是否开启 cerebro。 |
MaintenanceDay | Array of String | ["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"] | 实例的可维护日期。 |
MaintenanceTime | String | 03:00-06:00 | 实例的可维护时间段。 |
ESPublicEndpoint | String | https://elasticsearch-o-00k***o718..escloud.volces.com:9200 | 实例公网访问地址。 |
ESPrivateEndpoint | String | https://elasticsearch-o-00k***o718.escloud.ivolces.com:9200 | 实例私网访问地址。 |
DeletionProtection | Boolean |
| 实例是否开启删除保护功能。 说明 开启实例删除保护后,您将无法通过控制台或者 API 删除实例。 |
KibanaPublicDomain | String |
| Kibana 公网访问地址。 说明 如果是历史实例,访问地址有可能是 |
CerebroPublicDomain | String |
| cerebro 公网访问地址。 说明 Cerebro 和 Kibana 共享域名。如果是历史实例,访问地址有可能是 |
ESPublicIpWhitelist | String |
| 实例公网地址访问白名单。
|
KibanaPrivateDomain | String |
| Kibana 私网访问地址。 说明 如果是历史实例,访问地址有可能是 |
CerebroPrivateDomain | String |
| cerebro 私网访问地址。 说明 Cerebro 和 Kibana 共享域名。如果是历史实例,访问地址有可能是 |
ESPrivateIpWhitelist | String |
| 实例私网地址访问白名单。
|
EnableESPublicNetwork | Boolean | true | 实例是否开启了公网访问。 |
InstanceConfiguration | Object of EsInstanceConfigurationInfoDTO | 实例配置详情信息。 | |
EnableESPrivateNetwork | Boolean | true | 实例是否开启了私网访问。 |
KibanaPublicIpWhitelist | String |
| Kibana 公网白名单。只有添加到白名单中的 IP 地址才可以访问可视化工具。 说明 Cerebro 和 Kibana 共用一套白名单 |
KibanaPrivateIpWhitelist | String |
| Kibana 私网白名单。只有添加到白名单中的 IP 地址才可以访问可视化工具。 说明 Cerebro 和 Kibana 共用一套白名单。 |
EnableKibanaPublicNetwork | Boolean | true | Kibana 是否开启公网访问。 |
EnableKibanaPrivateNetwork | Boolean | true | Kibana 是否开启私网访问。 |
EnableESPrivateDomainPublic | Boolean | true | 实例是否开启私网地址公网解析。 |
EnableKibanaPrivateDomainPublic | Boolean | true | Kibana 是否开启私网地址公网解析。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
SessionTTL | Long |
| 会话有效时长,默认为 3600000 毫秒(1 小时)。 |
RequestTimeout | Long |
| 接口请求超时时长,默认为 30000 毫秒,即后端响应时长超过 30 秒时将出现 |
SessionKeepAlive | Boolean |
| 是否主动延长会话有效期。
|
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Type | String |
| 节点标签的类型。
|
TagKvs | JSON Map | user | 标签键。 |
TagKeys | Array of String | tom | 标签值。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
SubInstanceId | String | k-00g0oh** | 企业级 SQL 分析实例 ID。 |
SubInstanceType | String | sql | 实例类型。 |
SubInstanceStatus | String | AVAILABLE | 实例状态。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
TransferStatus | String | FINISH | 数据迁移任务状态。 |
TransferTaskId | String | 88dbdf2431b44f36** | 数据迁移任务 ID。 |
ReduceSpecConfig | Object of ReduceSpecConfig | 资源信息。 | |
TransferProgress | Double | 100 | 数据迁移任务进度,百分制。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
VPC | Object of VpcInfo | 实例的私有网络 VPC 信息。 | |
Subnet | Object of SubnetInfo | 实例的子网信息。 | |
ZoneId | String | cn-beijing-a | 实例所在可用区。 |
Version | String | V7_10 | 实例版本。V6_7 和V7_10 OPEN_SEARCH_2_9 |
RegionId | String | cn-beijing | 实例所在区域。 |
ChargeType | String | PostPaid | 实例计费类型。 |
MainZoneId | String | cn-beijing-a | 主可用区。 |
ZoneNumber | Integer | 1 | 实例的可用区数量。 |
EnableHttps | Boolean |
| 是否启用 HTTPS 访问协议。 说明 如果使用 HTTP 访问,将无需安全认证即可访问,并使用 HTTP 明文传输数据。您需要确保访问环境的安全性,且不要将访问接口暴露在公网环境上 |
ProjectName | String |
| 实例所属的项目。 |
InstanceName | String | doc-test | 实例名称。 |
AdminUserName | String | admin | 实例管理员账号,固定为 admin |
HotNodeNumber | Integer | 3 | 数据节点数量。 |
ColdNodeNumber | Integer | 3 | 冷节点数量。 |
WarmNodeNumber | Integer | 3 | 温节点数量。 |
EnablePureMaster | Boolean | true | Master 节点是否独立。 |
KibanaNodeNumber | Integer | 1 | kibana 节点数量。 |
MasterNodeNumber | Integer | 3 | master 节点数量。 |
HotNodeStorageSpec | Object of StorageSpecs | 数据节点的存储规格配置详情。 | |
ColdNodeStorageSpec | Object of StorageSpecs | 冷节点的存储规格配置详情。 | |
HotNodeResourceSpec | Object of ResourceSpecs | 数据节点的节点规格配置详情。 | |
WarmNodeStorageSpec | Object of StorageSpecs | 温节点的存储规格配置详情。 | |
ColdNodeResourceSpec | Object of ResourceSpecs | 冷节点的节点规格配置详情。 | |
WarmNodeResourceSpec | Object of ResourceSpecs | 温节点的节点规格配置详情。 | |
CoordinatorNodeNumber | Integer | 3 | 协调节点数量。 |
MasterNodeStorageSpec | Object of StorageSpecs | Master 节点的存储规格配置详情。 | |
KibanaNodeResourceSpec | Object of ResourceSpecs | Kibana 节点的节点规格配置详情。 | |
MasterNodeResourceSpec | Object of ResourceSpecs | Master 节点的节点规格配置详情。 | |
CoordinatorNodeStorageSpec | Object of StorageSpecs | 协调节点的存储规格配置详情。 | |
CoordinatorNodeResourceSpec | Object of ResourceSpecs | 协调节点的节点规格配置详情。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
ColdNodeNum | Integer | 0 | 冷节点数量。 |
DataNodeNum | Integer | 3 | 数据节点数量。 |
WarmNodeNum | Integer | 3 | 温节点数量。 |
MasterNodeNum | Integer | 3 | Master 节点数量。 |
EnablePureMaster | Boolean |
| Master 节点是否独立。
|
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
VpcId | String | vpc-274uhjap8u72**** | VPC ID |
VpcName | String | vpc_nameA | VPC 名称 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
SubnetId | String | subnet-1323sdda**** | Subnet ID |
SubnetName | String | subnet_nameA | Subnet 名称 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Name | String | es.volume.essd.pl0 | 存储规格,当前的规格如下: es.volume.essd.pl0:标准版-高性能云盘-pl0 |
Size | Integer | 20 | 配置的可用磁盘空间大小。 |
MaxSize | Integer | 10000 | 存储规格的最大值,单位为 GiB。 |
MinSize | Integer | 20 | 存储规格最小值,单位为 GiB。 |
Description | String | 标准版-高性能云盘-pl0 | 存储规格的描述信息。 |
DisplayName | String | ESSD-PL0 | 存储规格的显示名称。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
CPU | Integer | 2 | 节点规格的 CPU 资源,单位为核(Core)。 |
Name | String | es.x2.medium | 节点规格。如需了解节点规格类型和详情,请参见产品规格。 |
Memory | Integer | 4 | 节点规格的内存容量,单位 GiB。 |
Description | String | 标准版-2C4G节点 | 节点规格的描述信息。 |
DisplayName | String | 2核4GiB | 节点规格的显示名称。 |
POST https://open.volcengineapi.com?Action=DescribeInstance&Version=2023-01-01 Content-Type: application/json X-Date: 20231003T104027Z Authorization: HMAC-SHA256 Credential=AKLTMjI2ODVlYzI3ZGY1NGU4ZjhjYWRjMTlmNTM5OTZ****/20231003/cn-beijing/ESCloud/request, SignedHeaders=content-type;host;x-date, Signature=88dd0a9ea555d8609ec83eb46054b52f6cd4f79b8d5094fa784c66fa3f2b**** { "InstanceId": "o-0080**iu98" }
{ "ResponseMetadata": { "RequestId": "202403211143454EE027B0F2EA4**", "Action": "DescribeInstance", "Version": "2023-01-01", "Service": "escloud", "Region": "cn-beijing" }, "Result": { "InstanceInfo": { "ChargeEnabled": true, "CreateTime": "2024-03-21T10:32:24+08:00", "DeletionProtection": false, "KibanaPrivateIpWhitelist": "", "KibanaPublicIpWhitelist": "", "EnableESPrivateNetwork": true, "EnableESPublicNetwork": false, "EnableKibanaPrivateNetwork": true, "EnableKibanaPublicNetwork": false, "EnableESPrivateDomainPublic": false, "EnableKibanaPrivateDomainPublic": false, "KibanaEipId": "", "KibanaEip": "", "ExpireDate": "", "InstanceConfiguration": { "AdminUserName": "admin", "ChargeType": "PostPaid", "EnableHttps": true, "EnablePureMaster": true, "ProjectName": "default", "RegionId": "cn-beijing", "ZoneId": "cn-beijing-a", "ZoneNumber": 1, "Subnet": { "SubnetId": "subnet-rrzpagjr7ncw***", "SubnetName": "wuch_A_sub" }, "Version": "V7_10", "ColdNodeNumber": 0, "HotNodeNumber": 3, "HotNodeResourceSpec": { "Name": "es.x2.medium", "DisplayName": "2核4GiB", "Description": "标准版-2C4G节点", "Memory": 4, "CPU": 2 }, "HotNodeStorageSpec": { "Name": "es.volume.essd.pl0", "DisplayName": "ESSD-PL0", "Description": "标准版-高性能云盘-pl0", "MaxSize": 15000, "MinSize": 20, "Size": 20, "Type": "" }, "CoordinatorNodeNumber": 2, "CoordinatorNodeResourceSpec": { "Name": "es.x2.medium", "DisplayName": "2核4GiB", "Description": "标准版-2C4G节点", "Memory": 4, "CPU": 2 }, "CoordinatorNodeStorageSpec": { "Name": "es.volume.essd.pl0", "DisplayName": "ESSD-PL0", "Description": "标准版-高性能云盘-pl0", "MaxSize": 15000, "MinSize": 20, "Size": 20, "Type": "" }, "InstanceName": "doc-test", "KibanaNodeNumber": 1, "KibanaNodeResourceSpec": { "Name": "kibana.x2.small", "DisplayName": "1核2GiB", "Description": "Kibana专用-1C2G节点", "Memory": 2, "CPU": 1 }, "MasterNodeNumber": 3, "MasterNodeResourceSpec": { "Name": "es.x2.medium", "DisplayName": "2核4GiB", "Description": "标准版-2C4G节点", "Memory": 4, "CPU": 2 }, "MasterNodeStorageSpec": { "Name": "es.volume.essd.pl0", "DisplayName": "ESSD-PL0", "Description": "标准版-高性能云盘-pl0", "MaxSize": 15000, "MinSize": 20, "Size": 20, "Type": "" }, "WarmNodeNumber": 3, "WarmNodeResourceSpec": { "Name": "es.x2.medium", "DisplayName": "2核4GiB", "Description": "标准版-2C4G节点", "Memory": 4, "CPU": 2 }, "WarmNodeStorageSpec": { "Name": "es.volume.essd.pl0", "DisplayName": "ESSD-PL0", "Description": "标准版-高性能云盘-pl0", "MaxSize": 15000, "MinSize": 20, "Size": 20, "Type": "" }, "VPC": { "VpcId": "vpc-13fsccvrjxla83n6***", "VpcName": "wuch_vpc0110" } }, "MetricsVersion": "2.0.0", "InstanceId": "o-00c00wd***", "KibanaPrivateDomain": "https://visual-o-00c00**.escloud.ivolces.com:5601", "KibanaPublicDomain": "", "MaintenanceDay": [ "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ], "MaintenanceTime": "02:00-06:00", "Status": "Running", "TransferInfo": {}, "ResourceTags": [ { "Type": "SYSTEM", "TagKvs": {} }, { "Type": "CUSTOM", "TagKvs": { "doc": "test" } } ], "TotalNodes": 12, "UserId": "21001***", "SubInstances": [ { "SubInstanceId": "k-00g04q**", "SubInstanceType": "Sql", "SubInstanceStatus": "AVAILABLE" } ], "Encrypted": false, "CerebroEnabled": false, "CerebroPrivateDomain": "", "CerebroPublicDomain": "", "ESInnerEndpoint": "", "ESPrivateDomain": "", "ESPrivateEndpoint": "https://elasticsearch-o-00c00w**.escloud.ivolces.com:9200", "ESPublicDomain": "", "ESPublicEndpoint": "", "ESPrivateIpWhitelist": "", "ESPublicIpWhitelist": "", "ESEipId": "", "ESEip": "" } } }