Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

En esta página

Función
Método de invocación
URI
Parámetros de solicitud
Parámetros de respuesta
Ejemplo de solicitudes
Ejemplo de respuestas
Ejemplo de código del SDK
Java
Python
Go
Otro más
Códigos de estado
Códigos de error

Mostrar todo

Centro de ayuda/ VPC Endpoint/ Referencia de la API/ API/ Servicios de punto de conexión de VPC/ Modificación de un servicio de punto de conexión de VPC

Modificación de un servicio de punto de conexión de VPC

Actualización más reciente 2024-09-14 GMT+08:00

Ver PDF

Función

Esta API se utiliza para modificar un servicio de punto de conexión de VPC.

Método de invocación

Para obtener más información, consulte Invocación a las API.

URI

PUT /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}

**Tabla 1** Parámetros de enrutamiento
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto. Mínimo: 1 Máximo: 64
vpc_endpoint_service_id	Sí	String	Especifica el ID del servicio de punto de conexión de VPC. Mínimo: 1 Máximo: 64

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Especifica el token de usuario. Se puede obtener invocando a la API de IAM. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.
Content-Type	No	String	Especifica el tipo MIME del cuerpo de la solicitud. Se recomienda el valor application/json. Para las API utilizadas para cargar objetos o imágenes, el tipo MIME varía en función del tipo de flujo. Valor predeterminado: application/json

**Tabla 3** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
approval_enabled	No	Boolean	Especifica si se requiere aprobación. ● false: No se requiere aprobación. El punto de conexión de VPC creada se encuentra en el estado aceptado por defecto. ● true: Se requiere la aprobación. La conexión de punto de conexión creada solo puede utilizarse después de que se aprueba por el usuario del servicio de punto de conexión de VPC. El valor predeterminado es true. Predeterminado: true
service_name	No	String	Especifica el nombre del servicio de punto de conexión de VPC. El nombre puede contener un máximo de 16 caracteres, incluidos letras, dígitos, guiones bajos (_) y guiones (-). Mínimo: 0 Máximo: 16
ports	No	Array of PortList objects	Especifica la lista de mapeo de puertos del servicio. No se permiten mapeos de puertos duplicados en el mismo servicio de punto de conexión de VPC. Si varios servicios de punto de conexión de VPC comparten el mismo ID de puerto, los puertos de servicio y los puertos de terminal de todos estos servicios de punto de conexión no se pueden duplicar cuando el protocolo es el mismo. Se puede crear un máximo de 200 mapeos de puertos a la vez. El nuevo valor de este parámetro será el existente.
port_id	No	String	Especifica el ID que identifica el recurso backend del servicio de punto de conexión de VPC. El ID está en formato UUID. El valor puede ser: LB: indica el ID del puerto de la dirección IP privada de un balanceador de carga (recomendado). Para obtener más detalles, consulte la sección "Consulta de detalles de un balanceador de carga" en la Referencia de las API de Elastic Load Balance. VM: indica el ID de NIC de una dirección IP de ECS. Para obtener más detalles, consulte el campo port_id en los parámetros de respuesta de la sección "Consulta de las NIC de un ECS" en la Referencia de las API de Elastic Cloud Server. VIP: indica el ID de NIC del servidor virtual para el que se configura la dirección IP virtual. (Este valor ha sido descartado. Se recomienda LB.) Nota: Si el recurso backend es un balanceador de carga, el tipo de recurso backend solo se puede cambiar al mismo tipo. Por ejemplo, si el balanceador de carga original es un balanceador de carga compartido, el nuevo balanceador de carga no puede ser uno dedicado. Mínimo: 1 Máximo: 64
tcp_proxy	No	String	Especifica si se va a transferir al servidor información del cliente, como direcciones IP de origen, números de puerto de origen e ID de marcadores. La información se puede enviar al servidor de las siguientes maneras: TCP TOA: La información del cliente se coloca en el campo tcp option y se envía al servidor. Nota: TCP TOA solo está disponible cuando el recurso backend es OBS. Proxy Protocol: La información del cliente se coloca en el campo tcp payload y se envía al servidor. tcp_proxy solo está disponible cuando el servidor puede analizar los campos tcp option y tcp payload. El valor puede ser uno de los siguientes: close: No se transporta información de TCP TOA ni de Proxy Protocol. toa_open: Se transporta información de TCP TOA. proxy_open: Se transporta la información de Proxy Protocol. open: Se transporta información tanto de TCP TOA como de Proxy Protocol. proxy_vni: Solo se transporta información de Proxy Protocol y de Proxy VNI. close es el valor predeterminado.
description	No	String	Especifica el campo de descripción. El valor puede contener caracteres como letras y dígitos, pero no puede contener los signo menor que (<) ni signo mayor que (>). Mínimo: 0 Máximo: 512

**Tabla 4** PortList
Parámetro	Obligatorio	Tipo	Descripción
client_port	No	Integer	Especifica el puerto al que accederá un punto de conexión de VPC. Este puerto es provisto por el punto de conexión de VPC, lo que permite acceder al servicio de punto de conexión de VPC. Rango soportado: 1 a 65535. Mínimo: 1 Máximo: 65535 Mínimo: 1 Máximo: 65535
server_port	No	Integer	Especifica el puerto para acceder al servicio de punto de conexión de VPC. Este puerto se asocia con recursos backend para brindar servicios de punto de conexión de VPC. Rango soportado: 1 a 65535 Mínimo: 1 Máximo: 65535 Mínimo: 1 Máximo: 65535
protocol	No	String	Protocolo de mapeo de puertos. Se soporta TCP. Predeterminado: TCP

Parámetros de respuesta

Código de estado: 200

**Tabla 5** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
id	String	Especifica el ID único del servicio de punto de conexión de VPC. Mínimo: 1 Máximo: 64
port_id	String	Especifica el ID que identifica el recurso backend del servicio de punto de conexión de VPC. El ID está en formato UUID. El valor puede ser: LB: indica el ID del puerto de la dirección IP privada de un balanceador de carga (recomendado). VM: indica el ID de NIC de una dirección IP de ECS. VIP: indica el ID de NIC del servidor virtual para el que se configura la dirección IP virtual. (Este valor ha sido descartado. Se recomienda LB) Mínimo: 1 Máximo: 64
service_name	String	Especifica el nombre del servicio de punto de conexión de VPC. Mínimo: 0 Máximo: 128
server_type	String	Especifica el tipo de recurso. VM: servidor en nube VIP: dirección IP virtual LB: balanceador de carga mejorado
vpc_id	String	Especifica el ID de la VPC donde se encuentra el recurso backend del servicio de punto de conexión de la VPC. Mínimo: 1 Máximo: 64
pool_id	String	Especifica el ID del clúster del servicio de punto de conexión de VPC.
approval_enabled	Boolean	Especifica si se requiere la aprobación de la conexión. false: no se requiere la aprobación de conexión. El punto de conexión de VPC creada se encuentra en estado accepted. true: Se requiere la aprobación de la conexión. El punto de conexión de VPC creado se encuentra en el estado de pendingAcceptance, y solo puede ser utilizado después de ser aprobado por el usuario del servicio punto de conexión de VPC.
status	String	Especifica el estado del servicio de punto de conexión de VPC. creating: Se está creando el servicio de punto de conexión de VPC. available: Se puede conectar el servicio de punto de conexión de VPC. failed: No se pudo crear el servicio de punto de conexión de VPC.
service_type	String	Especifica el tipo del servicio de punto de conexión de VPC. Existen dos tipos de servicios de punto de conexión de VPC: interfaz y gateway. gateway: Indica los servicios de punto de conexión de VPC configurados por el personal de O&M. Puede usarlos directamente sin crearlos usted mismo. interface: indica los servicios en la nube configurados por el personal de O&M y los servicios privados creados por ustedes. No puede configurar estos servicios en la nube, pero puede utilizarlos. Se pueden crear puntos de conexión de VPC para conectarse a servicios de puntos de conexión de VPC de gateway y de interfaz. Mínimo: 1 Máximo: 16
created_at	String	Especifica cuándo se creó el servicio de punto de conexión de VPC. Se utiliza el formato de hora UTC AAAA-MMDDTHH:MM:SSZ.
updated_at	String	Especifica cuándo se actualizó el servicio de punto de conexión de VPC. Se utiliza el formato de hora UTC AAAA-MMDDTHH:MM:SSZ.
project_id	String	Especifica el ID del proyecto. Mínimo: 1 Máximo: 64
ports	Array of PortList objects	Especifica los mapeos de puertos abiertos para el servicio de punto de conexión de VPC. No se permiten mapeos de puertos duplicados en el mismo servicio de punto de conexión de VPC. Si varios servicios de punto de conexión de VPC comparten un port_id, debe ser único server_port o protocol, o ambos server_port y protocol de cada uno de estos servicios de punto de conexión.
tcp_proxy	String	Especifica si se va a transferir al servidor información del cliente, como direcciones IP de origen, números de puerto de origen e ID de marcadores. La información se puede enviar al servidor de las siguientes maneras: TCP TOA: La información del cliente se coloca en el campo tcp option y se envía al servidor. Nota: TCP TOA solo está disponible cuando el recurso backend es OBS. Proxy Protocol: La información del cliente se coloca en el campo tcp payload y se envía al servidor. tcp_proxy solo está disponible cuando el servidor puede analizar los campos tcp option y tcp payload. El valor puede ser uno de los siguientes: close: No se transporta información de TCP TOA ni de Proxy Protocol. toa_open: Se transporta información de TCP TOA. proxy_open: Se transporta la información de Proxy Protocol. open: Se transporta información tanto de TCP TOA como de Proxy Protocol. proxy_vni: Solo se transporta información de Proxy Protocol y de Proxy VNI. close es el valor predeterminado.
tags	Array of TagList objects	Especifica etiquetas de recursos.
description	String	Especifica el campo de descripción. El valor puede contener caracteres como letras y dígitos, pero no puede contener signos menores que (<) ni mayores que signos (>). Mínimo: 0 Máximo: 512
enable_policy	Boolean	Especifica si la política de punto de conexión de VPC está habilitada. false: no se puede configurar la política de punto de conexión de VPC. true: Se puede configurar la política de punto de conexión de VPC. El valor predeterminado es false.

**Tabla 6** PortList
Parámetro	Tipo	Descripción
client_port	Integer	Especifica el puerto al que accederá un punto de conexión de VPC. Este puerto es provisto por el punto de conexión de VPC, lo que permite acceder al servicio de punto de conexión de VPC. Rango soportado: 1 a 65535. Mínimo: 1 Máximo: 65535 Mínimo: 1 Máximo: 65535
server_port	Integer	Especifica el puerto para acceder al servicio de punto de conexión de VPC. Este puerto se asocia con recursos backend para brindar servicios de punto de conexión de VPC. Rango soportado: 1 a 65535 Mínimo: 1 Máximo: 65535 Mínimo: 1 Máximo: 65535
protocol	String	Protocolo de mapeo de puertos. Se soporta TCP. Predeterminado: TCP

**Tabla 7** TagList
Parámetro	Tipo	Descripción
key	String	Especifica la clave de etiqueta. Una clave de etiqueta contiene un máximo de 36 caracteres de Unicode. No puede quedar en blanco. No puede contener signos iguales (=), asteriscos (*), menos que signos (<), mayor que signos (>), barras invertidas (), comas (,), barras verticales (\|), y barras (/), y los caracteres primero y último no pueden ser espacios. Mínimo: 1 Máximo: 36
value	String	Especifica la clave de etiqueta. Un valor de etiqueta contiene un máximo de 43 caracteres y puede ser una cadena vacía. No puede contener signos iguales (=), asteriscos (*), menos que signos (<), mayor que signos (>), barras invertidas (), comas (,), barras verticales (\|), y barras (/), y los caracteres primero y último no pueden ser espacios. Mínimo: 1 Máximo: 43

Ejemplo de solicitudes

Modificación de un servicio de punto de conexión de VPC (Establezca approval_enabled a true, client_port a 8081 y a 8082 y server_port a 22 y a 23)

PUT https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2- d380272eed88

{
  "approval_enabled" : true,
  "service_name" : "test",
  "ports" : [ {
    "client_port" : 8081,
    "server_port" : 22,
    "protocol" : "TCP"
  }, {
    "client_port" : 8082,
    "server_port" : 23,
    "protocol" : "TCP"
  } ]
}

Ejemplo de respuestas

Código de estado: 200

El servidor procesó correctamente la solicitud.

{
  "id" : "4189d3c2-8882-4871-a3c2-d380272eed83",
  "port_id" : "4189d3c2-8882-4871-a3c2-d380272eed88",
  "vpc_id" : "4189d3c2-8882-4871-a3c2-d380272eed80",
  "pool_id" : "5289d3c2-8882-4871-a3c2-d380272eed80",
  "status" : "available",
  "approval_enabled" : false,
  "service_name" : "test123",
  "service_type" : "interface",
  "server_type" : "VM",
  "project_id" : "6e9dfd51d1124e8d8498dce894923a0d",
  "created_at" : "2022-04-14T09:35:47Z",
  "ports" : [ {
    "client_port" : 8080,
    "server_port" : 90,
    "protocol" : "TCP"
  }, {
    "client_port" : 8081,
    "server_port" : 80,
    "protocol" : "TCP"
  } ],
  "tcp_proxy" : "proxy_open"
}

Ejemplo de código del SDK

El ejemplo de código del SDK es el siguiente.

Java

Modificación de un servicio de punto de conexión de VPC (Establezca approval_enabled a true, client_port a 8081 y a 8082 y server_port a 22 y a 23)

    
     
       
       package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.vpcep.v1.region.VpcepRegion;
import com.huaweicloud.sdk.vpcep.v1.*;
import com.huaweicloud.sdk.vpcep.v1.model.*;

import java.util.List;
import java.util.ArrayList;

public class UpdateEndpointServiceSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");

        ICredential auth = new BasicCredentials()
                .withAk(ak)
                .withSk(sk);

        VpcepClient client = VpcepClient.newBuilder()
                .withCredential(auth)
                .withRegion(VpcepRegion.valueOf("cn-north-4"))
                .build();
        UpdateEndpointServiceRequest request = new UpdateEndpointServiceRequest();
        UpdateEndpointServiceRequestBody body = new UpdateEndpointServiceRequestBody();
        List<PortList> listbodyPorts = new ArrayList<>();
        listbodyPorts.add(
            new PortList()
                .withClientPort(8081)
                .withServerPort(22)
                .withProtocol(PortList.ProtocolEnum.fromValue("TCP"))
        );
        listbodyPorts.add(
            new PortList()
                .withClientPort(8082)
                .withServerPort(23)
                .withProtocol(PortList.ProtocolEnum.fromValue("TCP"))
        );
        body.withPorts(listbodyPorts);
        body.withServiceName("test");
        body.withApprovalEnabled(true);
        request.withBody(body);
        try {
            UpdateEndpointServiceResponse response = client.updateEndpointService(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

      

    
   

Python

Modificación de un servicio de punto de conexión de VPC (Establezca approval_enabled a true, client_port a 8081 y a 8082 y server_port a 22 y a 23)

    
     
       
       # coding: utf-8

from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkvpcep.v1.region.vpcep_region import VpcepRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkvpcep.v1 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.getenv("CLOUD_SDK_AK")
    sk = os.getenv("CLOUD_SDK_SK")

    credentials = BasicCredentials(ak, sk) \

    client = VpcepClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(VpcepRegion.value_of("cn-north-4")) \
        .build()

    try:
        request = UpdateEndpointServiceRequest()
        listPortsbody = [
            PortList(
                client_port=8081,
                server_port=22,
                protocol="TCP"
            ),
            PortList(
                client_port=8082,
                server_port=23,
                protocol="TCP"
            )
        ]
        request.body = UpdateEndpointServiceRequestBody(
            ports=listPortsbody,
            service_name="test",
            approval_enabled=True
        )
        response = client.update_endpoint_service(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

      

    
   

Go

Modificación de un servicio de punto de conexión de VPC (Establezca approval_enabled a true, client_port a 8081 y a 8082 y server_port a 22 y a 23)

    
     
       
       package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    vpcep "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/vpcep/v1"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/vpcep/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/vpcep/v1/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        Build()

    client := vpcep.NewVpcepClient(
        vpcep.VpcepClientBuilder().
            WithRegion(region.ValueOf("cn-north-4")).
            WithCredential(auth).
            Build())

    request := &model.UpdateEndpointServiceRequest{}
	clientPortPorts:= int32(8081)
	serverPortPorts:= int32(22)
	protocolPorts:= model.GetPortListProtocolEnum().TCP
	clientPortPorts1:= int32(8082)
	serverPortPorts1:= int32(23)
	protocolPorts1:= model.GetPortListProtocolEnum().TCP
	var listPortsbody = []model.PortList{
        {
            ClientPort: &clientPortPorts,
            ServerPort: &serverPortPorts,
            Protocol: &protocolPorts,
        },
        {
            ClientPort: &clientPortPorts1,
            ServerPort: &serverPortPorts1,
            Protocol: &protocolPorts1,
        },
    }
	serviceNameUpdateEndpointServiceRequestBody:= "test"
	approvalEnabledUpdateEndpointServiceRequestBody:= true
	request.Body = &model.UpdateEndpointServiceRequestBody{
		Ports: &listPortsbody,
		ServiceName: &serviceNameUpdateEndpointServiceRequestBody,
		ApprovalEnabled: &approvalEnabledUpdateEndpointServiceRequestBody,
	}
	response, err := client.UpdateEndpointService(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

      

    
   

Otro más

Para obtener un ejemplo de código del SDK de más lenguajes de programación, consulta la ficha Ejemplo de código en API Explorer. El ejemplo de código del SDK se puede generar automáticamente.

Códigos de estado

Código de estado	Descripción
200	El servidor procesó correctamente la solicitud.

Códigos de error

Consulte Códigos de error.

Tema principal: Servicios de punto de conexión de VPC

Tema anterior: Consulta de detalles de un servicio de punto de conexión de VPC

Tema siguiente: Eliminación de un servicio de punto de conexión de VPC

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar