すべてのプロダクト
Search
ドキュメントセンター

Elasticsearch:UpdateKibanaWhiteIps

最終更新日:Mar 17, 2025

指定された Elasticsearch クラスタの Kibana コンソールへのアクセスのための IP アドレス ホワイトリストを更新します。

使用上の注意

  • この操作を呼び出す前に、インスタンスが activating、invalid、または inactive 状態ではないことを確認してください。
  • ホワイトリストは、IP アドレス ホワイトリストと IP アドレス ホワイトリストグループの 2 つの方法で更新できます。 2 つの方法は同時には使用できません。 InstanceId と clientToken に加えて、2 つの方法は以下のように異なるパラメータをサポートしています。
    • IP アドレス ホワイトリスト: kibanaIPWhitelist
    • IP アドレス ホワイトリストグループ: modifyMode と whiteIpGroup
  • パブリックネットワークアクセス ホワイトリストは、プライベート IP アドレスの構成をサポートしていません。 プライベートネットワークアクセス ホワイトリストは、パブリック IP アドレスの構成をサポートしていません。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストヘッダー

この操作では、共通のリクエストヘッダーのみを使用します。 詳細については、「共通のリクエストヘッダー」をご参照ください。

リクエスト構文

PATCH|POST /openapi/instances/{InstanceId}/kibana-white-ips HTTP/1.1

リクエストパラメータ

パラメータタイプ場所必須説明
InstanceIdStringPathはいes-cn-tl329rbpc0001****

インスタンス ID。

clientTokenStringQueryいいえ5A2CFF0E-5718-45B5-9D4D-70B3FF****

リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

modifyModeStringQueryいいえCover

変更方法。有効な値:

  • Cover (デフォルト): 元の IP アドレス ホワイトリストを ips パラメータの値で上書きします。
  • Append: ips パラメータに入力された IP アドレスを元の IP アドレス ホワイトリストに追加します。
  • Delete: 元の IP アドレス ホワイトリストから ips パラメータに入力された IP アドレスを削除します。少なくとも 1 つの IP アドレスを保持する必要があります。
ObjectBodyいいえ

リクエストの本文。

kibanaIPWhitelistString の配列Bodyいいえ["110.0.XX.XX/8"]

IP アドレス ホワイトリストのリスト。 このパラメータは、whiteIpGroup が空のままの場合に利用可能です。 このパラメータの値は、デフォルトのホワイトリストグループの IP アドレス ホワイトリスト構成を更新します。

kibanaIPWhitelist と whiteIpGroup の両方を構成することはできません。

whiteIpGroupObjectBodyいいえ

ホワイトリストグループを使用して、Kibana ホワイトリストの構成を更新できます。 1 つのホワイトリストグループのみ更新できます。

kibanaIPWhitelist と whiteIpGroup の両方を構成することはできません。

groupNameStringBodyいいえtest_group_name

ホワイトリストグループのグループ名。 whiteIpGroup パラメータがオプションの場合は、このパラメータが必要です。

whiteIpTypeStringBodyいいえPUBLIC_KIBANA

ホワイトリストのタイプ。 PUBLIC_KIBANA (パブリックネットワーク ホワイトリスト) のみがサポートされています。

ipsString の配列Bodyいいえ["0.0.0.0", "10.2.XX.XX"]

ホワイトリストグループの IP アドレスのリスト。 whiteIpGroup パラメータがオプションの場合は、このパラメータが必要です。

重要 ホワイトリストグループの追加と削除は、modifyMode を Cover に呼び出すことによって実装されます。 Delete と Append は、ホワイトリストグループを同時に追加または削除できません。 ホワイトリストグループの IP アドレスリストのみ変更できます。 以下の項目に注意してください。
  • modifyMode パラメータが Cover に設定されている場合、ips が空の場合、ホワイトリストグループは削除されます。 groupName が既存のホワイトリストグループ名のリストにない場合は、ホワイトリストグループが作成されます。
  • modifyMode パラメータが Delete に設定されている場合、削除された ips に対して少なくとも 1 つの IP アドレスを保持する必要があります。
  • modifyMode パラメータが Append に設定されている場合、ホワイトリストグループ名が作成されていることを確認してください。 そうでない場合、NotFound エラーメッセージが表示されます。

レスポンスパラメーター

パラメータータイプ説明
RequestIdStringE5EF11F1-DBAE-4020-AC24-DFA6C4345CAE

リクエスト ID。

ResultObject

対応する Elasticsearch インスタンスの詳細を返します。

kibanaPrivateIPWhitelistString の配列[ "192.168.XX.XX/24" ]

Kibana プライベートネットワークアクセスホワイトリストのリスト。

kibanaIPWhitelistString の配列["0.0.XX.XX", "10.2.XX.XX", "110.0.XX.XX/9"]

Kibana アクセスホワイトリストのリスト。

networkConfigObject

ネットワーク構成情報。

vpcIdStringvpc-bp1jy348ibzulk6hn****

仮想プライベートクラウド ( VPC) の ID。

vswitchIdStringvsw-bp1a0mifpletdd1da****

インスタンスが接続されている vSwitch の ID。

vsAreaStringcn-hangzhou-h

インスタンスを作成するリージョンの ID。

typeStringvpc

インスタンスのネットワークタイプ。有効な値:

whiteIpGroupListwhiteIpGroupList の配列

ホワイトリストのリスト。

groupNameStringtest_group_name

ホワイトリストグループの名前。

ipsString の配列["0.0.0.0", "10.2.XX.XX"]

ホワイトリストグループの IP アドレスのリスト。

whiteIpTypeStringPUBLIC_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 エラーセンター」をご参照ください。