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> Elastic Load Balance> Referencia de la API> API del balanceador de carga dedicado> Política de seguridad> Consulta de políticas de seguridad personalizadas

Actualización más reciente 2022-11-17 GMT+08:00

Ver PDF

Consulta de políticas de seguridad personalizadas

Función

Esta API se utiliza para consultar políticas de seguridad personalizadas.Personalizar la política de seguridad no es compatible en la región eu-nl. Por favor, no lo use.

Restricciones

Esta API tiene las siguientes restricciones:

Los parámetros marker, limit y page_reverse se utilizan para la consulta de paginación.
Los parámetros marker y page_reverse solo tienen efecto cuando se usan junto con el parámetro limit.

URI

GET /v3/{project_id}/elb/security-policies

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	Especifica el ID del proyecto.

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
marker	No	String	Especifica el identificador del último registro de la página anterior. Nota: Este parámetro debe usarse junto con limit. Si no se especifica este parámetro, se consultará la primera página. Este parámetro no se puede dejar en blanco ni establecer un ID no válido.
limit	No	Integer	Especifica el número de registros de cada página. Mínimo: 0 Máximo: 2000 Predeterminado: 2000
page_reverse	No	Boolean	Especifica si se va a utilizar la consulta inversa. Valores: true: consulta la página anterior. false (predeterminado): consulta la página siguiente. Nota: Este parámetro debe usarse junto con limit. Si page_reverse se establece en true y desea consultar la página anterior, establezca el valor de marker en el valor de previous_marker.
id	No	Array	Especifica el ID de la política de seguridad personalizada. Se pueden consultar múltiples ID en el formato id=xxx&id=xxx.
name	No	Array	Especifica el nombre de la política de seguridad personalizada. Se pueden consultar varios nombres con el formato name=xxx&name=xxx.
description	No	Array	Proporciona información adicional acerca de la política de seguridad personalizada. Se pueden consultar varias descripciones en el formato de description=xxx&description=xxx.
protocols	No	Array	Especifica los protocolos TLS admitidos por la política de seguridad personalizada. (Múltiples protocolos se separan usando espacios.) Se pueden consultar múltiples protocolos en el formato de protocols=xxx&protocols=xxx.
ciphers	No	Array	Especifica los conjuntos de cifrado admitidos por la política de seguridad personalizada. (Múltiples conjuntos de cifrado se separan usando dos puntos.) Se pueden consultar varias suites de cifrado en el formato de ciphers=xxx&ciphers=xxx.

Parámetros de solicitud

**Tabla 3** Parámetros de cabecera de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Especifica el token utilizado para la autenticación IAM.

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
security_policies	Array of SecurityPolicy objects	Muestra las políticas de seguridad.
request_id	String	Especifica el ID de la solicitud. El valor se genera automáticamente.
page_info	PageInfo object	Muestra información de paginación.

**Tabla 5** SecurityPolicy
Parámetro	Tipo	Descripción
id	String	Especifica el ID de la política de seguridad personalizada.
project_id	String	Especifica el ID de proyecto de la política de seguridad personalizada.
name	String	Especifica el nombre de la política de seguridad personalizada.
description	String	Proporciona información adicional acerca de la política de seguridad personalizada.
listeners	Array of ListenerRef objects	Especifica las oyentes que utilizan las políticas de seguridad personalizadas.
protocols	Array of strings	Muestra los protocolos TLS admitidos por la política de seguridad personalizada.
ciphers	Array of strings	Enumera los conjuntos de cifrado admitidos por la política de seguridad personalizada.
created_at	String	Especifica la hora en que se creó la política de seguridad personalizada.
updated_at	String	Especifica la hora en que se actualizó la política de seguridad personalizada.

**Tabla 6** ListenerRef
Parámetro	Tipo	Descripción
id	String	Especifica el ID de oyente.

**Tabla 7** PageInfo
Parámetro	Tipo	Descripción
previous_marker	String	Especifica el ID del primer registro del resultado de la consulta de paginación. Establezca este parámetro para consultar la página anterior.
next_marker	String	Especifica el ID del último registro del resultado de la consulta de paginación. Establezca este parámetro para consultar la página siguiente.
current_count	Integer	Especifica el número de registros.

Ejemplo de las solicitudes

Consulta de políticas de seguridad personalizadas en cada página

GET https://{ELB_Endpoint}/v3/7a9941d34fc1497d8d0797429ecfd354/elb/security-policies?limit=2

Ejemplo de las respuestas

Código de estado: 200

Solicitud exitosa.

{
  "request_id" : "88424a61-6fa1-4850-aa8b-ce31d78abcf2",
  "security_policies" : [ {
    "id" : "03cf511a-d130-445e-9b02-12d7049ddabf",
    "name" : "test_security_policy",
    "project_id" : "7a9941d34fc1497d8d0797429ecfd354",
    "description" : "",
    "protocols" : [ "TLSv1", "TLSv1.3" ],
    "ciphers" : [ "AES128-SHA", "TLS_AES_128_GCM_SHA256", "TLS_AES_256_GCM_SHA384", "TLS_CHACHA20_POLY1305_SHA256", "TLS_AES_128_CCM_SHA256", "TLS_AES_128_CCM_8_SHA256" ],
    "listeners" : [ {
      "id" : "6f7c0d75-81c4-4735-87a0-dc5df0f27f5a"
    } ],
    "created_at" : "2021-02-06T10:07:10Z",
    "updated_at" : "2021-02-06T10:07:10Z"
  }, {
    "id" : "04e5d426-628c-42db-867c-fcaefbed2cab",
    "name" : "update_securitypolicy",
    "project_id" : "7a9941d34fc1497d8d0797429ecfd354",
    "description" : "",
    "protocols" : [ "TLSv1.2", "TLSv1.1", "TLSv1.3" ],
    "ciphers" : [ "CAMELLIA128-SHA", "TLS_AES_256_GCM_SHA384", "TLS_CHACHA20_POLY1305_SHA256", "TLS_AES_128_CCM_SHA256", "TLS_AES_128_CCM_8_SHA256" ],
    "listeners" : [ {
      "id" : "e19b7379-807e-47fb-b53d-46aff540580c"
    } ],
    "created_at" : "2021-02-06T10:01:58Z",
    "updated_at" : "2021-03-20T07:18:59Z"
  } ],
  "page_info" : {
    "next_marker" : "04e5d426-628c-42db-867c-fcaefbed2cab",
    "previous_marker" : "03cf511a-d130-445e-9b02-12d7049ddabf",
    "current_count" : 2
  }
}