Todos los productos
Search
Centro de documentos

Quick BI:IpWhiteListConfig

Última actualización: Sep 09, 2026

Configura la lista blanca de IP para la seguridad de los datos.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

quickbi-public:IpWhiteListConfig

update

*Todos los recursos.

*

Ninguna Ninguna

Sintaxis de la solicitud

POST  HTTP/1.1

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

IpWhiteList

string

No

Obligatorio para las operaciones de adición y eliminación. La lista blanca de IP. Separe varias direcciones IP con comas.

60.205.254.120

Operation

string

Sí

El tipo de operación. Valores válidos:

  • ADD: Agrega entradas de forma incremental.

  • DELETE: Elimina entradas.

  • QUERY: Consulta entradas.

add

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

RequestId

string

El ID de la solicitud.

D787E1A3-A93C-424A-B626-C2B05DF8D885

Result

object

La lista blanca de IP.

IpWhiteList

array

El arreglo de la lista blanca de IP.

string

IP

*.*.*.*

Success

boolean

Indica si la solicitud se realizó correctamente.

true

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "D787E1A3-A93C-424A-B626-C2B05DF8D885",
  "Result": {
    "IpWhiteList": [
      "*.*.*.*"
    ]
  },
  "Success": true
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

297 Invalid.Parameter The length of the parameter must not exceed 1000. El número de parámetros excede el límite de 1000.
400 Internal.System.Error An internal system error occurred. Ocurrió un error interno del sistema.
400 Invalid.Parameter.Error The parameter is invalid:%s. Parámetro no válido: %s.
400 Parameter.Error The input parameter is invalid. El parámetro de entrada no es válido.
400 LoginIp.Format.Error Invalid IP address format: %s. Only public IPv4 addresses or CIDR format are supported. Formato de dirección IP no válido: %s. Solo se admiten direcciones IPv4 públicas o formato CIDR.
400 LoginIp.Private.Error Does not support private IP addresses: %s. No se admiten direcciones IP privadas: %s.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.