Todos os produtos
Search
Central de documentação

Elasticsearch:CreateVpcEndpoint

Última atualização: Jun 27, 2026

Cria um endpoint de VPC na conta de serviço para estabelecer uma conexão privada unidirecional com o serviço de endpoint na VPC do usuário.

Para obter mais informações sobre esta operação de API, consulte Configure uma conexão privada com uma instância.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código 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 detalhes, consulte os parâmetros de requisição comuns.

Sintaxe da requisição

POST /openapi/instances/{InstanceId}/vpc-endpoints HTTP/1.1

Parâmetro da requisição

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

O ID da instância.

ClientToken String Query Não 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1D***

Token gerado pelo cliente para garantir a idempotência da requisição. Deve ser único entre requisições, conter apenas caracteres ASCII e não exceder 64 caracteres.

dryRun Boolean Query Não false

Defina se deve ser executada uma simulação (dry run) da requisição. Valores válidos:

  • true: Valida apenas a requisição sem criar o endpoint. O sistema verifica se seu par de AccessKey é válido, se o usuário RAM possui autorização e se os parâmetros obrigatórios foram definidos.
  • false (padrão): Cria o endpoint imediatamente.
Object Body Não

Informações sobre o serviço de endpoint.

serviceId String Body Não epsrv-hp3xdsq46ael67lo****

ID do serviço de endpoint a ser associado ao endpoint do lado da VPC.

zoneId String Body Não cn-hangzhou-i

ID da zona do serviço de endpoint criado.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

F99407AB-2FA9-489E-A259-40CF6DCC47D9

ID da requisição.

Result

Object

Resultado retornado.

serviceId

String

epsrv-bp1w0p3jdirbfmt6****

ID do serviço de endpoint do usuário associado ao endpoint.

endpointDomain

String

ep-bp1tah7zbrwmkjef**.epsrv-bp1w0p3jdirbfmt6**.cn-hangzhou.privatelink.aliyuncs.com

Nome de domínio do endpoint usado para configurar a conexão.

endpointId

String

ep-bp1tah7zbrwmkjef****

ID do endpoint no lado da VPC de serviço.

endpointName

String

vpcElasticSearchABC

Nome do endpoint no lado da VPC de serviço.

Exemplos

Exemplos de requisição

POST /openapi/instances/es-cn-2r429tctl000d****/vpc-endpoints HTTP/1.1
Content-Type:application/json

{
  "serviceId" : "epsrv-hp3xdsq46ael67lo****",
  "zoneId" : "cn-hangzhou-i"
}

Exemplos de resposta de sucesso

Formato JSON

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

{
  "RequestId" : "F99407AB-2FA9-489E-A259-40CF6DCC47D9",
  "Result" : {
    "serviceId" : "epsrv-hp3vpx8yqxblby3i****",
    "endpointName" : "vpcElasticSearchABC",
    "endpointId" : "ep-hp33b2e43fays7s8****",
    "endpointDomain" : "ep-hp33b2e43fays7s8****.epsrv-hp3xdsq46ael67lo****.cn-huhehaote.privatelink.aliyuncs.com"
  }
}

Códigos de erro

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