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/ Consulta de registros de lista blanca de un servicio de punto de conexión de VPC

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

Ver PDF

Consulta de registros de lista blanca de un servicio de punto de conexión de VPC

Función

Esta API se utiliza para consultar los registros de lista blanca de un servicio de punto de conexión de VPC. Nota: Su cuenta está en la lista blanca de su propio servicio de punto de conexión de VPC por defecto.

Método de invocación

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

URI

GET /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}/permissions

**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

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
permission	No	String	Especifica el ID de cuenta de permisos en formato iam:domain::domain_id. domain_id indica el ID de cuenta del usuario autorizado, por ejemplo, iam:domain::6e9dfd51d1124e8d8498dce894923a0d. Se soporta la búsqueda difusa. Mínimo: 1 Máximo: 1000
limit	No	Integer	Especifica la cantidad de registros de lista blanca devueltos del servicio de punto de conexión de VPC en cada página. El valor oscila entre 0 y 500 y generalmente es de 10, 20 o 50. El número predeterminado es 10. Mínimo: 1 Máximo: 500 Predeterminado: 10
offset	No	Integer	Especifica el desfase. Se consultarán todos los servicios de punto de conexión de VPC después de este desfase. El desfase debe ser un entero mayor que 0 pero menor que la cantidad de servicios punto de conexión de VPC. Mínimo: 0
sort_key	No	String	Especifica el campo de ordenación de los registros de la lista blanca. El valor es create_at, que indica la hora en que se agrega el registro de lista blanca. Valor predeterminado: create_at
sort_dir	No	String	Especifica el método de ordenación de los registros de la lista blanca, que puede ser: ● desc: Los registros de la lista blanca se ordenan en la orden descendente. ● asc: Los registros de la lista blanca se ordenan en la orden ascendente. El método predeterminado es desc. Predeterminado: desc

Parámetros de solicitud

**Tabla 3** 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

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
permissions	Array of PermissionObject objects	Especifica los permisos.
total_count	Integer	Especifica el número total de registros de lista blanca que cumplen los criterios de búsqueda. El número no se ve afectado por limit ni offset.

**Tabla 5** PermissionObject
Parámetro	Tipo	Descripción
id	String	Especifica el ID único del permiso. Mínimo: 1 Máximo: 64
permission	String	Specifies the permissions. El formato de permiso es iam:domain::domain_id u organizations:orgPath::org_path. iam:domain:: y organizations:orgPath:: son formatos fijos. domain_id indica el ID de la cuenta en la que se pueden crear puntos de conexión de VPC para acceder al servicio de punto de conexión de VPC. org_path indica el enrutamiento de la organización bajo la cual las cuentas pueden crear punto de conexión de VPC para acceder al servicio de punto de conexión de VPC. domain_id solo puede contener letras y dígitos. org_path solo puede contener letras, dígitos, barras diagonales (/) y guiones (-). También puede escribir un asterisco para domain_id u org_path que indica que este servicio de punto de conexión de VPC permite accesos desde cualquier punto de conexión de VPC. Ejemplo: iam:domain::6e9dfd51d1124e8d8498dce894923a0dd u organizations:orgPath::o-3j59d1231uprgk9yuvlidra7zbzfi578/r-rldbu1vmxdw5ahdkknxnvd5rgag77m2z/ou-7tuddd8nh99rebxltawsm6qct5z7rklv/* Mínimo: 1 Máximo: 1024
permission_type	String	Especifica el tipo de lista blanca del servicio de punto de conexión de VPC. domainId: indica el ID de la cuenta que puede crear puntos de conexión de VPC para conectarse al servicio de punto de conexión de VPC. orgPath: indica el enrutamiento de organización incluida en la lista blanca bajo la cual las cuentas pueden crear puntos de conexión de VPC para conectarse al servicio de punto de conexión de VPC.
created_at	String	Especifica la hora en que se agregará el registro de lista blanca. El formato de hora UTC aplicado es AAAA-MMDDTHH:MM:SSZ.

Ejemplo de solicitudes

Consulta de registros de lista blanca de un servicio de punto de conexión de VPC

GET https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2-d380272eed88/permissions?permission={permission}&sort_dir={sort_dir}&limit={limit}&offset={offset}

This request is to query whitelist records of the VPC endpoint service whose ID is 4189d3c2-8882-4871-a3c2-d380272eed88. GET https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2-d380272eed88/permissions

Ejemplo de respuestas

Código de estado: 200

El servidor procesó correctamente la solicitud.

{
  "permissions" : [ {
    "id" : "f2659906-c622-480a-83e9-ef42bdb67b90",
    "permission" : "*",
    "created_at" : "2018-10-18T13:26:40Z"
  } ],
  "total_count" : 1
}