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.

Centro de ayuda/ VPC Endpoint/ Referencia de la API/ API/ Puntos de conexión de VPC/ Esta API se utiliza para actualizar un punto de conexión de VPC.

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

Ver PDF

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

Función

Esta API se utiliza para actualizar o eliminar la lista blanca de un 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-endpoints/{vpc_endpoint_id}

**Tabla 1** Parámetros de enrutamiento
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	Especifica el ID del proyecto. Para obtener detalles sobre cómo obtener el ID de proyecto, consulte "Obtención de un ID de proyecto". Mínimo: 1 Máximo: 64
vpc_endpoint_id	Sí	String	Especifica el ID del punto de conexión de la 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
whitelist	No	Array of strings	Especifica la lista blanca actualizada o eliminada para controlar el acceso a los puntos de conexión de VPC. El valor puede ser una dirección IPv4 o un bloque CIDR. Las descripciones de los ajustes son las siguientes: ● Si se especifica el valor, la lista blanca se actualiza al valor especificado. ● Si este parámetro se deja en blanco, se eliminan todas las listas blancas. De forma predeterminada, la lista blanca se deja en blanco. Mínimo: 0 Máximo: 32 Longitud del arreglo: 1 - 1000
enable_whitelist	No	Boolean	Especifica si se debe habilitar el aislamiento de ACL de red. ● true: el aislamiento de ACL de red está habilitado. ● false: el aislamiento de ACL de red está deshabilitado. El valor predeterminado es false.

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
id	String	Especifica el ID único del punto de conexión de VPC. Mínimo: 1 Máximo: 64
service_type	String	Especifica el tipo de servicio de punto de conexión de VPC al que se conecta el punto de conexión de VPC. 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. Puede consultar los servicios de punto de conexión públicos de VPC para ver los servicios de punto de conexión de VPC visibles y accesibles para todos los usuarios y configurados por el personal de O&M. Se pueden crear servicios de punto de conexión de VPC de interfaz.
status	String	Especifica el estado del punto de conexión de la VPC. pendingAcceptance: Se aceptará el punto de conexión de VPC. creating: Se está creando el punto de conexión de VPC. accepted: Se ha aceptado el punto de conexión de VPC. rejected: Se ha rechazado el punto de conexión de VPC. failed: No se pudo crear el punto de conexión de VPC. deleting: Se está eliminando el punto de conexión de VPC.
ip	String	Especifica la dirección IP para acceder al servicio de punto de conexión de VPC asociado. Este parámetro solo se devuelve en las siguientes condiciones: Se consulta un punto de conexión de VPC para acceder a un servicio de punto de conexión de VPC de interfaz. La aprobación de conexión está habilitada para el servicio de punto de conexión de VPC y la conexión ha sido aprobada. status del punto de conexión de VPC puede ser accepted o rejected. El estado rejected solo aparece cuando se acepta y luego se rechaza el punto de conexión de VPC. Mínimo: 1 Máximo: 64
active_status	Array of strings	Especifica el estado de la cuenta. frozen: La cuenta está congelada. active: La cuenta está normal.
endpoint_service_name	String	Especifica el nombre del servicio de punto de conexión de VPC.
marker_id	Integer	Especifica el ID de paquete del punto de conexión de VPC.
endpoint_service_id	String	Especifica el ID del servicio de punto de conexión de VPC. Mínimo: 1 Máximo: 64
enable_dns	Boolean	Especifica si se debe crear un nombre de dominio. true: cree un nombre de dominio. false: no cree un nombre de dominio. Nota Al crear un punto de conexión de VPC para conectarse a un servicio de punto de conexión de VPC de gateway, no se crea ningún nombre de dominio, independientemente de si enable_dns está configurado como true o false.
dns_names	Array of strings	Especifica el nombre de dominio para acceder al servicio de punto de conexión de VPC asociado. Este parámetro está disponible cuando enable_dns se establece en true. Mínimo: 0 Máximo: 32
subnet_id	String	Especifica el ID de la subred en la VPC especificada por vpc_id. El ID está en formato UUID. Mínimo: 1 Máximo: 64
vpc_id	String	Especifica el ID de la VPC donde se creará el punto de conexión de VPC. Mínimo: 1 Máximo: 64
created_at	String	Especifica cuándo se creó el punto de conexión de VPC. Se utiliza el formato de hora de UTC AAAA-MM-DDTHH:MM:SSZ.
updated_at	String	Especifica el tiempo de actualización del punto de conexión de VPC. Se utiliza el formato de hora de UTC AAAA-MM-DDTHH:MM:SSZ.
project_id	String	Especifica el ID del proyecto. Para obtener detalles sobre cómo obtener el ID de proyecto, consulte "Obtención de un ID de proyecto". Mínimo: 1 Máximo: 64
tags	Array of TagList objects	Especifica la lista de etiquetas consultadas. Si no hay ninguna etiqueta coincidente, se devuelve una matriz vacía.
whitelist	Array of strings	Especifica la lista blanca para controlar el acceso al punto de conexión de VPC. Si no especifica este parámetro, se devolverá una lista blanca vacía. Este parámetro solo está disponible cuando se crea un punto de conexión de VPC para conectarse a un servicio de punto de conexión de VPC de interfaz. Mínimo: 0 Máximo: 32 Longitud del arreglo: 1 - 1000
enable_whitelist	Boolean	Especifica si el control de acceso está habilitado. true: El control de acceso está habilitado. false: El control de acceso está desactivado. Si no especifica este parámetro, se desactiva el control de acceso. Este parámetro solo está disponible cuando se crea un punto de conexión de VPC para conectarse a un servicio de punto de conexión de VPC de interfaz.

**Tabla 5** 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 las solicitudes

Actualización de un punto de conexión de VPC (Serán whitelist a 192.168.1.1 y a 192.168.1.2 y enable_whitelist a true.)

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

{ 
  "whitelist":
             [
              "192.168.1.1",
              "192.168.1.2"
             ],
  "enable_whitelist":true,
}

Ejemplo de las respuestas

Código de estado: 200

El servidor procesó correctamente la solicitud.

{
  "id" : "4189d3c2-8882-4871-a3c2-d380272eed83",
  "service_type" : "interface",
  "status" : "accepted",
  "ip" : "10.32.xx.xx",
  "marker_id" : 322312312312,
  "vpc_id" : "4189d3c2-8882-4871-a3c2-d380272eed83",
  "enable_dns" : true,
  "endpoint_service_name" : "test123",
  "endpoint_service_id" : "test123",
  "project_id" : "6e9dfd51d1124e8d8498dce894923a0d",
  "whitelist" : [ "192.168.1.1", "192.168.1.2" ],
  "enable_whitelist" : true,
  "created_at" : "2022-04-14T09:35:47Z",
  "updated_at" : "2022-04-14T09:36:47Z",
  "tags" : [ {
    "key" : "test1",
    "value" : "test1"
  } ]
}

Ejemplo de código del SDK

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

Java

Actualización de un punto de conexión de VPC (Serán whitelist a 192.168.1.1 y a 192.168.1.2 y enable_whitelist a true.)

    
     
       
       
         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 UpdateEndpointWhiteSolution {

    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();
        UpdateEndpointWhiteRequest request = new UpdateEndpointWhiteRequest();
        UpdateEndpointWhiteRequestBody body = new UpdateEndpointWhiteRequestBody();
        List<String> listbodyWhitelist = new ArrayList<>();
        listbodyWhitelist.add("192.168.1.1");
        listbodyWhitelist.add("192.168.1.2");
        body.withEnableWhitelist(true);
        body.withWhitelist(listbodyWhitelist);
        request.withBody(body);
        try {
            UpdateEndpointWhiteResponse response = client.updateEndpointWhite(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

Actualización de un punto de conexión de VPC (Serán whitelist a 192.168.1.1 y a 192.168.1.2 y enable_whitelist a true.)

    
     
       
       
         # 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 = UpdateEndpointWhiteRequest()
        listWhitelistbody = [
            "192.168.1.1",
            "192.168.1.2"
        ]
        request.body = UpdateEndpointWhiteRequestBody(
            enable_whitelist=True,
            whitelist=listWhitelistbody
        )
        response = client.update_endpoint_white(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

Actualización de un punto de conexión de VPC (Serán whitelist a 192.168.1.1 y a 192.168.1.2 y enable_whitelist a true.)

    
     
       
       
         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.UpdateEndpointWhiteRequest{}
	var listWhitelistbody = []string{
        "192.168.1.1",
	    "192.168.1.2",
    }
	enableWhitelistUpdateEndpointWhiteRequestBody:= true
	request.Body = &model.UpdateEndpointWhiteRequestBody{
		EnableWhitelist: &enableWhitelistUpdateEndpointWhiteRequestBody,
		Whitelist: &listWhitelistbody,
	}
	response, err := client.UpdateEndpointWhite(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.