指定された Elasticsearch クラスタの Kibana コンソールへのアクセスのための IP アドレス ホワイトリストを更新します。
使用上の注意
- この操作を呼び出す前に、インスタンスが activating、invalid、または inactive 状態ではないことを確認してください。
- ホワイトリストは、IP アドレス ホワイトリストと IP アドレス ホワイトリストグループの 2 つの方法で更新できます。 2 つの方法は同時には使用できません。 InstanceId と clientToken に加えて、2 つの方法は以下のように異なるパラメータをサポートしています。
- IP アドレス ホワイトリスト: kibanaIPWhitelist
- IP アドレス ホワイトリストグループ: modifyMode と whiteIpGroup
- パブリックネットワークアクセス ホワイトリストは、プライベート IP アドレスの構成をサポートしていません。 プライベートネットワークアクセス ホワイトリストは、パブリック IP アドレスの構成をサポートしていません。
デバッグ
リクエストヘッダー
この操作では、共通のリクエストヘッダーのみを使用します。 詳細については、「共通のリクエストヘッダー」をご参照ください。
リクエスト構文
PATCH|POST /openapi/instances/{InstanceId}/kibana-white-ips HTTP/1.1リクエストパラメータ
| パラメータ | タイプ | 場所 | 必須 | 例 | 説明 |
| InstanceId | String | Path | はい | es-cn-tl329rbpc0001**** | インスタンス ID。 |
| clientToken | String | Query | いいえ | 5A2CFF0E-5718-45B5-9D4D-70B3FF**** | リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。 |
| modifyMode | String | Query | いいえ | Cover | 変更方法。有効な値:
|
| Object | Body | いいえ | リクエストの本文。 | ||
| kibanaIPWhitelist | String の配列 | Body | いいえ | ["110.0.XX.XX/8"] | IP アドレス ホワイトリストのリスト。 このパラメータは、whiteIpGroup が空のままの場合に利用可能です。 このパラメータの値は、デフォルトのホワイトリストグループの IP アドレス ホワイトリスト構成を更新します。 kibanaIPWhitelist と whiteIpGroup の両方を構成することはできません。 |
| whiteIpGroup | Object | Body | いいえ | ホワイトリストグループを使用して、Kibana ホワイトリストの構成を更新できます。 1 つのホワイトリストグループのみ更新できます。 kibanaIPWhitelist と whiteIpGroup の両方を構成することはできません。 | |
| groupName | String | Body | いいえ | test_group_name | ホワイトリストグループのグループ名。 whiteIpGroup パラメータがオプションの場合は、このパラメータが必要です。 |
| whiteIpType | String | Body | いいえ | PUBLIC_KIBANA | ホワイトリストのタイプ。 PUBLIC_KIBANA (パブリックネットワーク ホワイトリスト) のみがサポートされています。 |
| ips | String の配列 | Body | いいえ | ["0.0.0.0", "10.2.XX.XX"] | ホワイトリストグループの IP アドレスのリスト。 whiteIpGroup パラメータがオプションの場合は、このパラメータが必要です。 |
- modifyMode パラメータが Cover に設定されている場合、ips が空の場合、ホワイトリストグループは削除されます。 groupName が既存のホワイトリストグループ名のリストにない場合は、ホワイトリストグループが作成されます。
- modifyMode パラメータが Delete に設定されている場合、削除された ips に対して少なくとも 1 つの IP アドレスを保持する必要があります。
- modifyMode パラメータが Append に設定されている場合、ホワイトリストグループ名が作成されていることを確認してください。 そうでない場合、NotFound エラーメッセージが表示されます。
レスポンスパラメーター
| パラメーター | タイプ | 例 | 説明 |
| RequestId | String | E5EF11F1-DBAE-4020-AC24-DFA6C4345CAE | リクエスト ID。 |
| Result | Object | 対応する Elasticsearch インスタンスの詳細を返します。 | |
| kibanaPrivateIPWhitelist | String の配列 | [ "192.168.XX.XX/24" ] | Kibana プライベートネットワークアクセスホワイトリストのリスト。 |
| kibanaIPWhitelist | String の配列 | ["0.0.XX.XX", "10.2.XX.XX", "110.0.XX.XX/9"] | Kibana アクセスホワイトリストのリスト。 |
| networkConfig | Object | ネットワーク構成情報。 | |
| vpcId | String | vpc-bp1jy348ibzulk6hn**** | 仮想プライベートクラウド ( VPC) の ID。 |
| vswitchId | String | vsw-bp1a0mifpletdd1da**** | インスタンスが接続されている vSwitch の ID。 |
| vsArea | String | cn-hangzhou-h | インスタンスを作成するリージョンの ID。 |
| type | String | vpc | インスタンスのネットワークタイプ。有効な値: |
| whiteIpGroupList | whiteIpGroupList の配列 | ホワイトリストのリスト。 | |
| groupName | String | test_group_name | ホワイトリストグループの名前。 |
| ips | String の配列 | ["0.0.0.0", "10.2.XX.XX"] | ホワイトリストグループの IP アドレスのリスト。 |
| whiteIpType | String | PUBLIC_KIBANA | ホワイトリストのタイプ。 |
例
リクエストの例
PATCH /openapi/instances/es-cn-tl329rbpc0001****/kibana-white-ips HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json
{
"kibanaIPWhitelist": [
"110.0.XX.XX/8"
]
}
Or
{
"whiteIpGroup": {
"groupName": "test_group_name",
"ips": [
"0.0.0.0",
"10.2.XX.XX"
]
}
}レスポンスの例
JSON フォーマット
HTTP/1.1 200 OK
Content-Type:application/json
{
"Result" : {
"instanceId" : "es-cn-tl329rbpc0001****",
"version" : "7.10.0_with_X-Pack",
"description" : "lrr",
"nodeAmount" : 0,
"paymentType" : "postpaid",
"status" : "active",
"privateNetworkIpWhiteList" : [ "11.22.XX.XX", "0.0.XX.XX/0" ],
"enablePublic" : false,
"nodeSpec" : { },
"dataNode" : false,
"networkConfig" : {
"vpcId" : "vpc-bp1jy348ibzulk6hn****",
"vswitchId" : "vsw-bp1a0mifpletdd1da****",
"vsArea" : "cn-hangzhou-h",
"whiteIpGroupList" : [ {
"groupName" : "default",
"ips" : [ "0.0.XX.XX/0", "11.22.XX.XX" ],
"whiteIpType" : "PRIVATE_ES"
}, {
"groupName" : "default",
"ips" : [ "110.0.XX.XX/9" ],
"whiteIpType" : "PUBLIC_KIBANA"
}, {
"groupName" : "default",
"ips" : [ "192.168.XX.XX/24" ],
"whiteIpType" : "PRIVATE_KIBANA"
}, {
"groupName" : "test_group_name",
"ips" : [ "0.0.XX.XX", "10.2.XX.XX" ],
"whiteIpType" : "PUBLIC_KIBANA"
} ],
"type" : "vpc"
},
"createdAt" : "2021-07-21T01:29:38.510Z",
"updatedAt" : "2021-07-21T06:12:12.370Z",
"commodityCode" : "elasticsearch",
"extendConfigs" : [ {
"configType" : "usageScenario",
"value" : "log"
}, {
"configType" : "maintainTime",
"maintainStartTime" : "02:00Z",
"maintainEndTime" : "06:00Z"
}, {
"configType" : "aliVersion",
"aliVersion" : "ali1.4.0"
}, {
"configType" : "followCube",
"followClusterEnabled" : true
} ],
"endTime" : 4782556800000,
"clusterTasks" : [ ],
"vpcInstanceId" : "es-cn-tl329rbpc0001****-worker",
"resourceGroupId" : "rg-acfmxxkk2p7****",
"zoneCount" : 1,
"protocol" : "HTTP",
"zoneInfos" : [ {
"zoneId" : "cn-hangzhou-h",
"status" : "NORMAL"
} ],
"instanceType" : "elasticsearch",
"inited" : true,
"tags" : [ {
"tagKey" : "acs:rm:rgId",
"tagValue" : "rg-acfmxxkk2p7****"
} ],
"serviceVpc" : true,
"domain" : "es-cn-tl329rbpc0001****.elasticsearch.aliyuncs.com",
"port" : 9200,
"esVersion" : "7.10.0_with_X-Pack",
"esConfig" : {
"action.destructive_requires_name" : "true",
"xpack.watcher.enabled" : "false",
"action.auto_create_index" : "+.*,-*"
},
"esIPWhitelist" : [ "11.22.XX.XX", "0.0.XX.XX/0" ],
"esIPBlacklist" : [ ],
"kibanaProtocol" : "HTTPS",
"kibanaIPWhitelist" : [ "0.0.0.0", "10.2.XX.XX", "110.0.XX.XX/9" ],
"kibanaPrivateIPWhitelist" : [ "192.168.XX.XX/24" ],
"publicIpWhitelist" : [ ],
"kibanaDomain" : "es-cn-tl329rbpc0001****.kibana.elasticsearch.aliyuncs.com",
"kibanaPort" : 5601,
"kibanaPrivateDomain" : "es-cn-tl329rbpc0001****-kibana.internal.elasticsearch.aliyuncs.com",
"kibanaPrivatePort" : 5601,
"haveKibana" : true,
"instanceCategory" : "IS",
"dedicateMaster" : false,
"advancedDedicateMaster" : false,
"masterConfiguration" : { },
"haveClientNode" : false,
"warmNode" : true,
"warmNodeConfiguration" : {
"spec" : "elasticsearch.d1.2xlarge",
"amount" : 3
},
"clientNodeConfiguration" : { },
"kibanaConfiguration" : {
"spec" : "elasticsearch.n4.small",
"amount" : 1,
"disk" : 0
},
"elasticDataNodeConfiguration" : { },
"haveElasticDataNode" : false,
"dictList" : [ {
"name" : "SYSTEM_MAIN.dic",
"fileSize" : 2782602,
"sourceType" : "ORIGIN",
"type" : "MAIN"
}, {
"name" : "SYSTEM_STOPWORD.dic",
"fileSize" : 132,
"sourceType" : "ORIGIN",
"type" : "STOP"
} ],
"synonymsDicts" : [ ],
"ikHotDicts" : [ ],
"aliwsDicts" : [ ],
"haveGrafana" : false,
"haveCerebro" : false,
"enableKibanaPublicNetwork" : true,
"enableKibanaPrivateNetwork" : true,
"advancedSetting" : {
"gcName" : "CMS"
},
"enableMetrics" : true,
"readWritePolicy" : {
"writeHa" : false
}
},
"RequestId" : "E815C5C9-E82D-4B10-BDE0-D25340C2ACEF"
}レスポンスパラメータ
エラーコードのリストについては、「API エラーセンター」をご参照ください。