创建图
功能介绍
创建一个图。
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
graph |
是 |
graph object |
图类型。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
图名称（输入长度在4位到50位之间，必须以字母开头，可以包含字母、数字或者下划线，不能包含其他的特殊字符）。 |
|
graph_size_type_index |
是 |
String |
图规模类型索引。
|
|
arch |
否 |
String |
图实例CPU架构类型，取值为x86_64和aarch64。默认取x86_64。
|
|
vpc_id |
是 |
String |
虚拟私有云ID。 |
|
subnet_id |
是 |
String |
指定虚拟私有云下的子网ID。 |
|
security_group_id |
是 |
String |
安全组ID。 |
|
public_ip |
否 |
public_ip object |
公网IP地址，如果未指定，则默认不使用公网连接。 |
|
enable_multi_az |
否 |
Boolean |
创建的图是否支持跨可用区（AZ），默认值是false，如果设置为true，系统将会把图中的ECS建在两个可用区中。 如果创建图时，不加该参数，则会将图中的ECS都建在一个可用区中。 |
|
lts_operation_trace |
否 |
lts_operation_trace object |
图实例是否开启审计日志，默认不开启。 |
|
sys_tags |
否 |
Array of sys_tags objects |
企业项目信息，如果未指定则不开启，默认不开启。 |
|
tags |
否 |
Array of tags objects |
支持标签TMS，做费用归集，默认不开启。 |
|
enable_rbac |
否 |
Boolean |
创建的图是否启用细粒度权限控制，默认不启用，值为false。如果设置为true，创建的图所有用户都没有权限，需要调用业务面细粒度权限控制API进行授权操作才可以访问图。 |
|
enable_full_text_index |
否 |
Boolean |
创建的图是否开启全文索引控制，默认不启用，值为false。 如果设置为true，十亿增强版-规格版图支持全文索引，创建图时会创建云搜索服务集群。
说明：
开启全文索引功能。如果CSS服务已经部署，图实例会自动创建CSS集群，图创建时间较长。如果CSS服务没有部署则图创建失败。 |
|
enable_hyg |
否 |
Boolean |
该参数只对持久化版规格图生效。 |
|
crypt_algorithm |
是 |
String |
图实例加密算法，取值为：
|
|
enable_https |
是 |
Boolean |
是否开启安全模式，开启安全模式会对性能有较大影响 |
|
product_type |
否 |
String |
图产品类型，取值为InMemory和Persistence，默认为InMemory，当graph_size_type_index取值为"6"时，默认为Persistence。
|
|
vertex_id_type |
否 |
vertex_id_type object |
点的id类型，仅持久化图需要填写。
说明：
点ID类型确定后，将无法更改，请用户谨慎选择! |
|
enable_multi_label |
否 |
Boolean |
是否启用多标签 。 |
|
capacity_ratio |
否 |
Integer |
图的容量倍率。该参数只有持久化版百亿规格图支持。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
public_bind_type |
否 |
String |
弹性IP绑定类型，取值如下。
|
|
eip_id |
否 |
String |
弹性IP的id，当publicBindType设置为bind_existing时，该值为用户某个已创建但尚未绑定的EIP的ID；当publicBindType设置为auto_assign时，该值设置为空。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
enable_audit |
否 |
Boolean |
是否开启图审计，默认“false”。 |
|
audit_log_group_name |
否 |
String |
LTS日志组名称。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
key |
否 |
String |
企业项目的key填：_sys_enterprise_project_id。 |
|
value |
否 |
String |
企业项目的id。可以从企业项目获取。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
id_type |
是 |
String |
id类型，目前支持固定长度fixedLengthString和hash。
|
|
id_length |
否 |
Integer |
当id_type取值为fixedLengthString时必填，取值范围：1-128。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
图ID。 |
|
name |
String |
图名称。 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_msg |
String |
系统提示信息。
|
|
error_code |
String |
系统提示信息。
|
请求示例
创建一个图，图名称为demo，图规模类型索引为一万边，图实例CPU架构类型为X86 64位架构 ，虚拟私有云ID为f07ed478-c31e-47ed-92d4-8fae6fd16981，子网ID为70bc9d11-b172-479b-8bce-1ad1ade02224，安全组ID为65de00b0-45f5-432f-8346-d8bb5f30940d。
{
"graph": {
"name": "demo",
"graph_size_type_index": 0,
"capacity_ratio": "",
"arch": "x86_64",
"vpc_id": "f07ed478-c31e-47ed-92d4-8fae6fd16981",
"subnet_id": "70bc9d11-b172-479b-8bce-1ad1ade02224",
"security_group_id": "65de00b0-45f5-432f-8346-d8bb5f30940d",
"public_ip": {
"public_bind_type": "bind_existing",
"eip_id": "b6e3bc7d-1ced-4690-9219-ef41d25e171e"
},
"enable_multi_az": false,
"lts_operation_trace": {
"enable_audit": true,
"audit_log_group_name": "test"
},
"sys_tags": [
{
"key": "_sys_enterprise_project_id",
"value": "0"
}
],
"enable_hyg":false,
"crypt_algorithm": "generalCipher",
"enable_https" : false
}
}
响应示例
状态码： 200
成功响应示例
{
"id" : "f1529b88-c958-493e-8452-fccfe932cde1",
"name" : "demo"
}
状态码： 400
失败响应示例
{
"error_code" : "GES.7016",
"error_msg" : "The parameter [subnetId] is not exist."
}
状态码
|
返回值 |
说明 |
|---|---|
|
400 Bad Request |
请求错误 |
|
401 Unauthorized |
鉴权失败 |
|
403 Forbidden |
没有操作权限 |
|
404 Not Found |
找不到资源 |
|
500 Internal Server Error |
服务内部错误 |
|
503 Service Unavailable |
服务不可用 |
错误码
请参见错误码。
