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/ Servicios de punto de conexión de VPC/ Esta API se utiliza para actualizar la descripción de la conexión de punto de conexión de VPC.
Actualización más reciente 2024-09-14 GMT+08:00

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

Función

Esta API se utiliza para actualizar la descripción de un punto de conexión de VPC conectado a 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}/connections/description

Tabla 1 Parámetros de enrutamiento

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

Especifica el ID del tenant.

Mínimo: 1

Máximo: 64

vpc_endpoint_service_id

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 del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

connections

Array of ConnectionsDesc objects

Especifica las conexiones de punto de conexión de VPC.

Tabla 3 ConnectionsDesc

Parámetro

Obligatorio

Tipo

Descripción

id

String

Especifica el ID del punto de conexión de VPC en formato UUID.

Mínimo: 1

Máximo: 64

description

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

Parámetros de respuesta

Código de estado: 200

Tabla 4 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

connections

Array of ConnectionEndpoints objects

Especifica la lista de conexiones.

Tabla 5 ConnectionEndpoints

Parámetro

Tipo

Descripción

id

String

Especifica el ID único del punto de conexión de VPC.

Mínimo: 1

Máximo: 64

marker_id

Integer

Especifica el ID de paquete del punto de conexión de VPC.

created_at

String

Especifica el tiempo de creación del punto de conexión de la VPC. El formato de hora UTC aplicado es AAAA-MMDDTHH:MM:SSZ.

updated_at

String

Especifica el tiempo de actualización del punto de conexión de VPC. El formato de hora UTC aplicado es AAAA-MMDDTHH:MM:SSZ.

domain_id

String

ID de dominio de un usuario.

Mínimo: 1

Máximo: 64

error

Array of QueryError objects

Especifica el mensaje de error. Este campo se devuelve cuando el punto de conexión de VPC es anormal, es decir, el valor de status es failed.

status

String

Especifica el estado de conexión del punto de conexión de la VPC. ● pendingAcceptance: Se aceptará el punto de conexión de VPC. ● creating: Se está creando la conexión de punto de conexión de VPC. ● accepted: Se ha aceptado la conexión de punto de conexión de VPC. ● rejected: Se ha rechazado la conexión de punto de conexión de VPC. ● failed: Error en la conexión de punto de conexión de VPC. ● deleting: se está eliminando la conexión de punto de conexión de VPC.

description

String

Especifica la descripción de una conexión del punto de conexión de VPC.

Mínimo: 0

Máximo: 512

Tabla 6 QueryError

Parámetro

Tipo

Descripción

error_code

String

Código de error.

Mínimo: 0

Máximo: 10

error_message

String

Mensaje de error.

Mínimo: 0

Máximo: 1024

Ejemplo de las solicitudes

Actualización de la descripción de un punto de conexión de VPC

https://{endpoint}/v1/{project_id}/vpc-endpoint-services/813d9300-8473-405b-bfcd-f711117bad65/connections/description

{
  "connections" : [ {
    "id" : "0df78897-35b0-4a93-ad17-0bc0585f546b",
    "description" : "Specifies the VPC endpoint 1, which belongs to account [0605767a3300d5762fb7c0186d9e1779]abc_26."
  }, {
    "id" : "0d837f75-90d5-4528-bd11-5d974238ebca",
    "description" : "Specifies the VPC endpoint 2, which belongs to account [7876999999999]abc_26."
  } ]
}

Ejemplo de las respuestas

Código de estado: 200

El servidor procesó correctamente la solicitud.

{
  "connections" : [ {
    "id" : "0d837f75-90d5-4528-bd11-5d974238ebca",
    "status" : "accepted",
    "description" : "Specifies the VPC endpoint 2, which belongs to account [7876999999999]abc_26.",
    "marker_id" : 302008767,
    "domain_id" : "05b5408a0a80d2b10f06c0184a774460",
    "created_at" : "2022-04-14T02:09:08Z",
    "updated_at" : "2022-04-14T07:55:40Z"
  }, {
    "id" : "0df78897-35b0-4a93-ad17-0bc0585f546b",
    "status" : "accepted",
    "description" : "Specifies the VPC endpoint 1, which belongs to account [0605767a3300d5762fb7c0186d9e1779]abc_26.",
    "marker_id" : 302001833,
    "domain_id" : "05b5408a0a80d2b10f06c0184a774460",
    "created_at" : "2022-04-14T01:59:31Z",
    "updated_at" : "2022-04-14T07:57:39Z"
  } ]
}

Ejemplo de código del SDK

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

Java

Actualización de la descripción de un punto de conexión de VPC

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
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 UpdateEndpointConnectionsDescSolution {

    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();
        UpdateEndpointConnectionsDescRequest request = new UpdateEndpointConnectionsDescRequest();
        UpdateEpConnections body = new UpdateEpConnections();
        List<ConnectionsDesc> listbodyConnections = new ArrayList<>();
        listbodyConnections.add(
            new ConnectionsDesc()
                .withId("0df78897-35b0-4a93-ad17-0bc0585f546b")
                .withDescription("Specifies the VPC endpoint 1, which belongs to account [0605767a3300d5762fb7c0186d9e1779]abc_26.")
        );
        listbodyConnections.add(
            new ConnectionsDesc()
                .withId("0d837f75-90d5-4528-bd11-5d974238ebca")
                .withDescription("Specifies the VPC endpoint 2, which belongs to account [7876999999999]abc_26.")
        );
        body.withConnections(listbodyConnections);
        request.withBody(body);
        try {
            UpdateEndpointConnectionsDescResponse response = client.updateEndpointConnectionsDesc(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 la descripción de un punto de conexión de VPC

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# 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 = UpdateEndpointConnectionsDescRequest()
        listConnectionsbody = [
            ConnectionsDesc(
                id="0df78897-35b0-4a93-ad17-0bc0585f546b",
                description="Specifies the VPC endpoint 1, which belongs to account [0605767a3300d5762fb7c0186d9e1779]abc_26."
            ),
            ConnectionsDesc(
                id="0d837f75-90d5-4528-bd11-5d974238ebca",
                description="Specifies the VPC endpoint 2, which belongs to account [7876999999999]abc_26."
            )
        ]
        request.body = UpdateEpConnections(
            connections=listConnectionsbody
        )
        response = client.update_endpoint_connections_desc(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 la descripción de un punto de conexión de VPC

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
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.UpdateEndpointConnectionsDescRequest{}
	var listConnectionsbody = []model.ConnectionsDesc{
        {
            Id: "0df78897-35b0-4a93-ad17-0bc0585f546b",
            Description: "Specifies the VPC endpoint 1, which belongs to account [0605767a3300d5762fb7c0186d9e1779]abc_26.",
        },
        {
            Id: "0d837f75-90d5-4528-bd11-5d974238ebca",
            Description: "Specifies the VPC endpoint 2, which belongs to account [7876999999999]abc_26.",
        },
    }
	request.Body = &model.UpdateEpConnections{
		Connections: listConnectionsbody,
	}
	response, err := client.UpdateEndpointConnectionsDesc(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.