Todos os produtos
Search
Central de documentação

Elasticsearch:UpdatePublicWhiteIps

Última atualização: Jun 27, 2026

Atualiza a lista de permissões da rede pública de uma instância do Elasticsearch.

Notas de uso

  • A lista de permissões não pode ser atualizada quando a instância está no estado Activating, Invalid ou Inactive.
  • Dois métodos de atualização mutuamente exclusivos estão disponíveis, cada um usando parâmetros diferentes além de InstanceId e clientToken:
    • Lista de permissões de IP: publicIpWhitelist
    • Grupo de lista de permissões de IP: modifyMode e whiteIpGroup
  • As listas de permissões da rede pública não podem conter endereços IP privados. As listas de permissões da rede privada não podem conter endereços IP públicos.

Depuração

O OpenAPI Explorer calcula automaticamente a assinatura e gera o código de exemplo do SDK.

Cabeçalhos de solicitação

Esta operação usa apenas cabeçalhos de solicitação comuns.

Sintaxe da solicitação

PATCHPOST /openapi/instances/{InstanceId}/public-white-ips HTTP/1.1

Parâmetros da solicitação

Parâmetro Tipo Posição Obrigatório Exemplo Descrição
InstanceId String Path Sim es-cn-tl329rbpc0001****

O ID da instância.

clientToken String Query Não 5A2CFF0E-5718-45B5-9D4D-70B3FF****

Garante a idempotência. Deve ser exclusivo, somente ASCII e ter até 64 caracteres.

modifyMode String Query Não Cover

O método de modificação. Valores válidos:

  • Cover (padrão): substitui a lista de permissões pelos endereços IP especificados em ips.
  • Append: adiciona endereços IP à lista de permissões.
  • Delete: remove endereços IP da lista de permissões. Pelo menos um deve ser mantido.

Corpo da solicitação

Propriedade

Tipo

Obrigatório

Exemplo

Descrição

publicIpWhitelist

List<String>

Sim

["0.0.0.0/0","0.0.0.0/1"]

A lista de permissões de endereços IP, aplicada ao grupo Default. Disponível apenas quando whiteIpGroup está vazio.

Mutuamente exclusivo com whiteIpGroup.

whiteIpGroup

Object

Não

O grupo de lista de permissões a ser atualizado. Apenas um grupo por solicitação.

Mutuamente exclusivo com publicIpWhitelist.

└ groupName

String

Não

test_group_name

O nome do grupo de lista de permissões. Obrigatório quando whiteIpGroup é especificado.

└ ips

List<String>

Não

["0.0.0.0", "10.2.XX.XX"]

Os endereços IP no grupo de lista de permissões. Obrigatório quando whiteIpGroup é especificado.

Importante Somente o modo Cover pode adicionar ou excluir grupos de lista de permissões. Append e Delete modificam apenas a lista de endereços IP em um grupo existente.
  • Cover: se ips estiver vazio, o grupo é excluído. Se groupName não existir, um novo grupo é criado.
  • Delete: pelo menos um endereço IP deve ser mantido no grupo.
  • Append: o grupo de lista de permissões já deve existir. Caso contrário, um erro NotFound é retornado.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
RequestId String C82758DD-282F-4D48-934F-92170A33****

O ID da solicitação.

Result Object

O corpo da resposta.

publicIpWhitelist Array of String ["0.0.0.0","10.2.XX.XX","110.0.XX.XX/8"]

A lista de permissões da rede pública atualizada.

Nota Apenas os parâmetros listados acima são garantidos. Outros parâmetros são apenas para referência e não devem ser utilizados programaticamente. Todos os parâmetros disponíveis estão documentados em ListInstance.

Exemplo

Exemplo de solicitação

PATCH /openapi/instances/es-cn-tl329rbpc0001****/public-white-ips HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json
{
    "publicIpWhitelist": [
        "110.0.XX.XX/8"
    ]
}
or
{
    "whiteIpGroup": {
        "groupName": "test_group_name",
        "ips": [
            "0.0.0.0",
            "10.2.XX.XX"
        ]
    }
}

Exemplos de respostas bem-sucedidas

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Result" : {
    "instanceId" : "es-cn-tl329rbpc0001****",
    "version" : "7.10.0_with_X-Pack",
    "description" : "test",
    "nodeAmount" : 0,
    "paymentType" : "postpaid",
    "status" : "active",
    "privateNetworkIpWhiteList" : [ "11.22.XX.XX", "0.0.XX.XX/0" ],
    "enablePublic" : true,
    "nodeSpec" : { },
    "dataNode" : false,
    "networkConfig" : {
      "vpcId" : "vpc-bp1jy348ibzulk6h***",
      "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" : "default",
        "ips" : [ "110.0.XX.XX/8" ],
        "whiteIpType" : "PUBLIC_ES"
      }, {
        "groupName" : "test_group_name",
        "ips" : [ "0.0.0.0", "10.2.XX.XX" ],
        "whiteIpType" : "PUBLIC_ES"
      } ],
      "type" : "vpc"
    },
    "createdAt" : "2021-07-21T01:29:38.510Z",
    "updatedAt" : "2021-07-21T06:40:32.438Z",
    "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" : [ "::1", "110.0.XX.XX/9" ],
    "kibanaPrivateIPWhitelist" : [ "192.168.XX.XX/24" ],
    "publicIpWhitelist" : [ "0.0.0.0", "10.2.XX.XX", "110.0.XX.XX/8" ],
    "kibanaDomain" : "es-cn-tl329rbpc0001****.kibana.elasticsearch.aliyuncs.com",
    "kibanaPort" : 5601,
    "kibanaPrivateDomain" : "es-cn-tl329rbpc0001****-kibana.internal.elasticsearch.aliyuncs.com",
    "kibanaPrivatePort" : 5601,
    "publicPort" : 9200,
    "publicDomain" : "es-cn-tl329rbpc0001****.public.elasticsearch.aliyuncs.com",
    "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" : "9E5466DE-E29A-4F87-9019-4AA7B80E60DE"
}

Códigos de erro

HttpCode Código de erro Mensagem de erro Descrição
400 InstanceActivating Instance is activating. A instância está sendo ativada.
400 InstanceNotFound The instanceId provided does not exist. A instância especificada não existe. Verifique o ID da instância.

Os códigos de erro estão listados na Central de Erros da API.