UpdateDescription - Elasticsearch: Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Cabeçalhos da requisição

Esta operação utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte o tópico sobre parâmetros de requisição comuns.

Sintaxe da requisição

PATCH|POST /openapi/instances/{InstanceId}/description HTTP/1.1

Parâmetros da requisição

Parâmetro	Tipo	Posição	Obrigatório	Exemplo	Descrição
InstanceId	String	Path	Sim	es-cn-n6w1ptcb30009****	ID da instância.
clientToken	String	Query	Não	5A2CFF0E-5718-45B5-9D4D-70B350****	Token do cliente usado para garantir a idempotência da requisição. Gere o valor com o cliente, mas assegure que seja exclusivo entre requisições distintas. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres.
	Object	Body	Não		Parâmetro RequestBody.
description	String	Body	Não	aliyunes_name_test	Novo nome da instância.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	FDF34727-1664-44C1-A8DA-3EB72D60****	ID da requisição.
Result	Object		Resultados retornados.
description	String	aliyunes_test_name	Novo nome da instância.

Nota

No exemplo de retorno a seguir, apenas os parâmetros na lista de dados de retorno têm inclusão garantida; os demais servem apenas como referência. Para obter mais detalhes sobre os parâmetros, consulte

ListInstance

. Não force dependências no programa para obter esses parâmetros.

Exemplos

Exemplos de requisição

PATCH /openapi/instances/es-cn-n6w1ptcb30009****/description HTTP/1.1
Content-Type:application/json

{
  "description" : "aliyunes_name_test"
}

Exemplos de resposta

Formato JSON

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

{
  "Result" : {
    "instanceId" : "es-cn-n6w1ptcb30009****",
    "version" : "5.5.3_with_X-Pack",
    "description" : "aliyunes_name_test",
    "nodeAmount" : 3,
    "paymentType" : "postpaid",
    "status" : "activating",
    "privateNetworkIpWhiteList" : [ "0.0.0.0/0" ],
    "enablePublic" : true,
    "nodeSpec" : {
      "spec" : "elasticsearch.n4.small",
      "disk" : 40,
      "diskType" : "cloud_ssd",
      "diskEncryption" : false
    },
    "networkConfig" : {
      "vpcId" : "vpc-bp16k1dvzxtmagcva****",
      "vswitchId" : "vsw-bp1k4ec6s7sjdbudw****",
      "vsArea" : "cn-hangzhou-i",
      "type" : "vpc"
    },
    "createdAt" : "2020-06-28T08:25:52.895Z",
    "updatedAt" : "2020-07-06T09:21:11.615Z",
    "commodityCode" : "elasticsearch",
    "extendConfigs" : [ {
      "configType" : "usageScenario",
      "value" : "general"
    }, {
      "configType" : "maintainTime",
      "maintainStartTime" : "02:00Z",
      "maintainEndTime" : "06:00Z"
    } ],
    "endTime" : 4749724800000,
    "clusterTasks" : [ {
      "type" : "updating",
      "progress" : 59.84375,
      "status" : "RUNNING",
      "canCancelable" : false,
      "interruptible" : true,
      "subTasks" : [ {
        "type" : "ecs",
        "progress" : 100,
        "detail" : {
          "totalNodeCount" : 4,
          "completedNodeCount" : 4
        },
        "status" : "FINISHED",
        "canCancelable" : false,
        "interruptible" : false,
        "subTasks" : [ ]
      }, {
        "type" : "hippo",
        "progress" : 100,
        "detail" : { },
        "status" : "FINISHED",
        "canCancelable" : false,
        "interruptible" : false,
        "subTasks" : [ ]
      }, {
        "type" : "rolling",
        "progress" : 39.375,
        "detail" : {
          "totalNodeCount" : 4,
          "completedNodeCount" : 1
        },
        "status" : "RUNNING",
        "canCancelable" : false,
        "interruptible" : false,
        "subTasks" : [ ]
      }, {
        "type" : "finally",
        "progress" : 0,
        "detail" : { },
        "status" : "READY",
        "canCancelable" : false,
        "interruptible" : false,
        "subTasks" : [ ]
      } ]
    } ],
    "vpcInstanceId" : "es-cn-n6w1ptcb30009****-worker",
    "resourceGroupId" : "rg-acfm2h5vbzd****",
    "zoneCount" : 1,
    "protocol" : "HTTP",
    "zoneInfos" : [ {
      "zoneId" : "cn-hangzhou-i",
      "status" : "NORMAL"
    } ],
    "instanceType" : "elasticsearch",
    "inited" : true,
    "tags" : [ ],
    "domain" : "es-cn-n6w1ptcb30009****.elasticsearch.aliyuncs.com",
    "port" : 9200,
    "esVersion" : "5.5.3_with_X-Pack",
    "esConfig" : {
      "action.destructive_requires_name" : "true",
      "xpack.security.audit.outputs" : "index",
      "xpack.watcher.enabled" : "false",
      "xpack.security.audit.enabled" : "false",
      "action.auto_create_index" : "true"
    },
    "esIPWhitelist" : [ "0.0.0.0/0" ],
    "esIPBlacklist" : [ ],
    "kibanaIPWhitelist" : [ "0.0.0.0/0", "::/0" ],
    "kibanaPrivateIPWhitelist" : [ ],
    "publicIpWhitelist" : [ "::1", "0.0.0.0/0" ],
    "kibanaDomain" : "es-cn-n6w1ptcb30009****.kibana.elasticsearch.aliyuncs.com",
    "kibanaPort" : 5601,
    "publicPort" : 9200,
    "publicDomain" : "es-cn-n6w1ptcb30009****.public.elasticsearch.aliyuncs.com",
    "haveKibana" : true,
    "instanceCategory" : "x-pack",
    "dedicateMaster" : false,
    "advancedDedicateMaster" : false,
    "masterConfiguration" : { },
    "haveClientNode" : false,
    "warmNode" : false,
    "warmNodeConfiguration" : { },
    "clientNodeConfiguration" : { },
    "kibanaConfiguration" : {
      "spec" : "elasticsearch.n4.small",
      "amount" : 1,
      "disk" : 0
    },
    "dictList" : [ {
      "name" : "SYSTEM_MAIN.dic",
      "fileSize" : 3058510,
      "sourceType" : "ORIGIN",
      "type" : "MAIN"
    }, {
      "name" : "SYSTEM_STOPWORD.dic",
      "fileSize" : 164,
      "sourceType" : "ORIGIN",
      "type" : "STOP"
    } ],
    "synonymsDicts" : [ ],
    "ikHotDicts" : [ ],
    "aliwsDicts" : [ ],
    "haveGrafana" : false,
    "haveCerebro" : false,
    "enableKibanaPublicNetwork" : true,
    "enableKibanaPrivateNetwork" : false,
    "advancedSetting" : {
      "gcName" : "CMS"
    }
  },
  "RequestId" : "24A68E4C-94B4-45E4-9068-CB12F33C****"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros da API.