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.
Actualización más reciente 2022-11-08 GMT+08:00

Consulta de políticas AS (V2)

Función

Esta API se utiliza para consultar políticas AS basadas en criterios de búsqueda. Los resultados se muestran por página.

  • La diferencia entre las API V2 y V1 para consultar políticas AS es que V2 contiene tipos de recursos de escala en mensajes de respuesta.
  • Los criterios de búsqueda pueden ser el nombre de política de AS, el tipo de política, el ID de política, el número de línea de inicio y el número de registros.
  • Si no se especifica ningún criterio de búsqueda, se puede consultar un máximo de 20 políticas AS para recursos especificados para un tenant de forma predeterminada.

URI

GET /autoscaling-api/v2/{project_id}/scaling_policy/{scaling_resource_id}/list

Puede escribir el signo de interrogación (?) y ampersand (&) al final del URI para definir varios criterios de búsqueda. Las políticas AS se pueden buscar por todos los parámetros opcionales en la siguiente tabla. Para obtener más información, consulte la solicitud de ejemplo.

Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

Especifica el ID del proyecto.

scaling_resource_id

String

Especifica el ID del recurso de ajuste.

scaling_policy_name

No

String

Especifica el nombre de política AS.

Soporta búsqueda difusa.

scaling_policy_type

No

String

Especifica el tipo de política AS.

  • ALARM: política de alarmas
  • SCHEDULED: política programada
  • RECURRENCE: política periódica
  • INTERVAL_ALARM (correspondiente a alarm_id): indica que la acción de ajuste se desencadena mediante una política de ajuste refinada.

scaling_policy_id

No

String

Especifica el ID de política AS.

start_number

No

Integer

Especifica el número de línea inicial. El valor predeterminado es 0. El valor mínimo del parámetro es 0.

limit

No

Integer

Especifica el número de registros de consulta. El valor predeterminado es 20. El rango de valores es de 0 a 100.

Mensaje de solicitud

  • Parámetros de solicitud

    No hay

  • Ejemplo de la solicitud
    Este ejemplo muestra cómo consultar todas las políticas AS periódicas para recursos con 8ade64b5-d685-40b8-8582-4ce306ea37a6.
    GET https://{Endpoint}/autoscaling-api/v2/{project_id}/scaling_policy/8ade64b5-d685-40b8-8582-4ce306ea37a6/list?scaling_policy_type=RECURRENCE

Mensaje de la respuesta

  • Parámetros de respuesta
    Tabla 2 Parámetros de respuesta

    Parámetro

    Tipo

    Descripción

    total_number

    Integer

    Especifica el número total de registros de consulta.

    start_number

    Integer

    Especifica el número de línea inicial.

    limit

    Integer

    Especifica el número máximo de recursos que se van a consultar.

    scaling_policies

    Array of scaling_policies objects

    Especifica las políticas AS. Para más detalles, consulte Tabla 3.

    Tabla 3 Descripción del campo scaling_policies

    Parámetro

    Tipo

    Descripción

    scaling_policy_name

    String

    Especifica el nombre de política AS.

    Soporta búsqueda difusa.

    scaling_policy_id

    String

    Especifica el ID de política AS.

    scaling_resource_id

    String

    Especifica el ID del recurso de ajuste.

    scaling_resource_type

    String

    Especifica el tipo de recurso de ajuste.

    • Grupo de AS: SCALING_GROUP
    • Ancho de banda: BANDWIDTH

    policy_status

    String

    Especifica el estado de la política AS.

    • INSERVICE: La política AS está habilitada.
    • PAUSED: La política AS está deshabilitada.
    • EXECUTING: Se está ejecutando la política AS.

    scaling_policy_type

    String

    Especifica el tipo de política AS.

    • ALARM: indica que la acción de ajuste se activa mediante una alarma. Se devuelve un valor para alarm_id y no se devuelve ningún valor para scheduled_policy.
    • SCHEDULED: indica que la acción de ajuste se activa según lo programado. Se devuelve un valor para scheduled_policy y no se devuelve ningún valor para alarm_id, recurrence_type, recurrence_value, start_time, o end_time.
    • RECURRENCE: indica que la acción de ajuste se activa periódicamente. Los valores se devuelven para scheduled_policy, recurrence_type, recurrence_value, start_time, y end_time, y no se devuelve ningún valor para alarm_id.
    • INTERVAL_ALARM: indica que la acción de ajuste se desencadena mediante una política de ajuste refinada. Se devuelve un valor para alarm_id y no se devuelve ningún valor para scheduled_policy.

    alarm_id

    String

    Especifica el ID de alarma.

    scheduled_policy

    scheduled_policy object

    Especifica la política AS periódica o programada. Para más detalles, consulte Tabla 4.

    scaling_policy_action

    scaling_policy_action object

    Especifica la acción de ajuste de la política AS. Para más detalles, consulte Tabla 5.

    interval_alarm_actions

    Array of interval_alarm_actions objects

    Especifica la acción de escala aplicada cuando se establece scaling_policy_type en INTERVAL_ALARM. Para más detalles, consulte Tabla 6

    cool_down_time

    Integer

    Especifica el período o los períodos de enfriamiento.

    create_time

    String

    Especifica la hora en que se creó una política AS. El formato de tiempo cumple con UTC.

    meta_data

    meta_data object

    Proporciona información adicional. Para más detalles, consulte Tabla 7.

    description

    String

    Especifica la descripción de la política AS.

    Tabla 4 Descripción del campo scheduled_policy

    Parámetro

    Tipo

    Descripción

    launch_time

    String

    Especifica la hora a la que se activa la acción de ajuste. El formato de tiempo cumple con UTC.

    • Si el valor scaling_policy_type es SCHEDULED, el formato de tiempo es YYYY-MM-DDThh:mmZ.
    • Si se establece scaling_policy_type a RECURRENCE, el formato de hora es hh:mm.

    recurrence_type

    String

    Especifica el tipo de una acción de ajuste desencadenada periódicamente.

    • Daily: indica que la acción de ajuste se activa una vez al día.
    • Weekly: indica que la acción de ajuste se activa una vez a la semana.
    • Monthly: indica que la acción de ajuste se activa una vez al mes.

    recurrence_value

    String

    Especifica la frecuencia con la que se activan las acciones de ajuste.

    • Si recurrence_type se establece en Diario, el valor es null, lo que indica que la acción de ajuste se activa una vez al día.
    • Si recurrence_type se establece en Weekly, el valor oscila entre 1 (domingo) y 7 (sábado). Los dígitos se refieren a las fechas de cada semana y separados por una coma, como 1,3,5.
    • Si recurrence_type se establece en Monthly, el valor varía de 1 a 31. Los dígitos se refieren a las fechas de cada mes y separados por una coma, como 1,10,13,28.

    start_time

    String

    Especifica la hora de inicio de la acción de escala que se activa periódicamente. El formato de tiempo cumple con UTC.

    El formato de hora es YYYY-MM-DDThh:mmZ.

    end_time

    String

    Especifica la hora de finalización de la acción de escala que se activa periódicamente. El formato de tiempo cumple con UTC.

    El formato de hora es YYYY-MM-DDThh:mmZ.

    Tabla 5 Descripción del campo scaling_policy_action

    Parámetro

    Tipo

    Descripción

    operation

    String

    Especifica la acción de ajuste.

    • ADD: indica la adición de instancias.
    • REDUCE: indica la reducción de instancias.
    • SET: indica establecer el número de instancias en un valor especificado.

    size

    Integer

    Especifica el número de instancias que se van a operar.

    percentage

    Integer

    Especifica el porcentaje de instancias que se van a operar.

    limits

    Integer

    Especifica las restricciones de operación.

    Tabla 6 Descripción del campo interval_alarm_actions

    Parámetro

    Obligatorio

    Tipo

    Descripción

    lower_bound

    No

    Double

    Especifica el límite inferior del rango de valores.

    upper_bound

    No

    Double

    Especifica el límite superior del rango de valores.

    operation

    No

    String

    Especifica la operación que se va a realizar.
    • ADD: indica la adición de instancias.
    • REDUCE: indica la reducción de instancias.
    • SET: indica establecer el número de instancias en un valor especificado.

    size

    No

    Integer

    Especifica el tamaño de la operación.

    percentage

    No

    Integer

    Especifica el porcentaje de instancias que se van a operar.

    limits

    No

    Integer

    Especifica las restricciones de operación.

    Tabla 7 Descripción del campo meta_data

    Parámetro

    Tipo

    Descripción

    metadata_bandwidth_share_type

    String

    Especifica el tipo de uso compartido de ancho de banda en la política de escala de ancho de banda.

    metadata_eip_id

    String

    Especifica el ID de EIP para el ancho de banda en la política de escala de ancho de banda.

    metadata_eip_address

    String

    Especifica el EIP para el ancho de banda en la política de escala de ancho de banda.

  • Ejemplo de la respuesta
    {
        "limit": 20,
        "total_number": 3,
        "start_number": 0,
        "scaling_policies": [
            {
                "scaling_policy_id": "803a35a5-38fb-4d27-a042-496c14bc1fb8",
                "scaling_policy_name": "as-policy-7a75",
                "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
                "scaling_resource_type": "SCALING_GROUP",
                "scaling_policy_type": "RECURRENCE",
                "scheduled_policy": {
                    "launch_time": "03:30",
                    "recurrence_type": "Daily",
                    "start_time": "2017-08-28T03:08Z",
                    "end_time": "2017-09-01T03:08Z"
                },
                "cool_down_time": 900,
                "scaling_policy_action": {
                    "operation": "ADD",
                    "size": 1
                },
                "policy_status": "INSERVICE",
                "create_time": "2017-08-31T03:02:41Z"
            },
            {
                "scaling_policy_id": "535fd67e-276b-409c-879e-52f4e09e14bb",
                "scaling_policy_name": "as-policy-7a75",
                "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
                "scaling_resource_type": "SCALING_GROUP",
                "scaling_policy_type": "RECURRENCE",
                "scheduled_policy": {
                    "launch_time": "21:30",
                    "recurrence_type": "Daily",
                    "start_time": "2017-08-27T21:08Z",
                    "end_time": "2017-08-31T21:08Z"
                },
                "cool_down_time": 900,
                "scaling_policy_action": {
                    "operation": "ADD",
                    "size": 1
                },
                "policy_status": "INSERVICE",
                "create_time": "2017-08-31T07:35:05Z"
            },
            {
                "scaling_policy_id": "37df92f8-73cb-469e-a420-c15f445d2ee1",
                "scaling_policy_name": "as-policy-7a75",
                "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
                "scaling_resource_type": "SCALING_GROUP",
                "scaling_policy_type": "RECURRENCE",
                "scheduled_policy": {
                    "launch_time": "22:30",
                    "recurrence_type": "Daily",
                    "start_time": "2017-08-27T22:08Z",
                    "end_time": "2017-08-31T22:08Z"
                },
                "cool_down_time": 900,
                "scaling_policy_action": {
                    "operation": "ADD",
                    "size": 1
                },
                "policy_status": "INSERVICE",
                "create_time": "2017-08-31T07:41:06Z"
            }
        ]
    }

Valores devueltos

  • Normal

    200

  • Anormal

    Valores devueltos

    Descripción

    400 Bad Request

    Se produjo un error en el servidor al procesar la solicitud.

    401 Unauthorized

    Debe introducir el nombre de usuario y la contraseña para acceder a la página solicitada.

    403 Forbidden

    Está prohibido el acceso a la página solicitada.

    404 Not Found

    No se pudo encontrar la página solicitada.

    405 Method Not Allowed

    No se le permite utilizar el método especificado en la solicitud.

    406 Not Acceptable

    El cliente no pudo aceptar la respuesta generada por el servidor.

    407 Proxy Authentication Required

    Debe utilizar el servidor proxy para la autenticación para que la solicitud pueda procesarse.

    408 Request Timeout

    Se agotó el tiempo de espera de la solicitud.

    409 Conflict

    La solicitud no se pudo procesar debido a un conflicto.

    500 Internal Server Error

    Se produjo un error al completar la solicitud debido a un problema de servicio interno.

    501 Not Implemented

    Error al completar la solicitud porque el servidor no admite la función solicitada.

    502 Bad Gateway

    Error al completar la solicitud porque la solicitud no es válida.

    503 Service Unavailable

    Error al completar la solicitud porque el sistema no está disponible.

    504 Gateway Timeout

    Se ha producido un error de tiempo de espera de la puerta de enlace.

Códigos de error

Consulte Códigos de error