> ## Documentation Index > Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt > Use this file to discover all available pages before exploring further. # Listar objetivos de política de parches > Recupera una lista paginada de objetivos de política de parches para una organización. Admite paginación, ordenación y filtrado mediante una cadena de filtros JSON. Los objetivos de política de parches definen cuándo y cómo se aplican los parches a los Workspaces. ## OpenAPI ````yaml /api-reference/openapi-v1.json get /v1/organizations/{organization_id}/patch-policy-targets openapi: 3.0.3 info: title: API Publica Portal version: 1.0.0 description: Api publica REST para portal servers: - url: https://api.staging.flxwvdexternal.com description: Staging API server security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/patch-policy-targets: get: tags: - Objetivos de política de parches summary: Listar objetivos de política de parches description: >- Recupera una lista paginada de objetivos de política de parches para una organización. Admite paginación, ordenación y filtrado mediante una cadena de filtros JSON. Los objetivos de política de parches definen cuándo y cómo se aplican los parches a los Workspaces. operationId: listPatchPolicyTargets parameters: - name: organization_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: El identificador único de la organización example: 507f1f77bcf86cd799439011 - name: page in: query required: false schema: type: integer default: 1 minimum: 1 description: 'Número de página (predeterminado: 1)' - name: per_page in: query required: false schema: type: integer default: 100 maximum: 100 minimum: 1 description: 'Elementos por página (predeterminado: 100, máx.: 100)' - name: sort in: query required: false schema: type: string description: >- Campo de ordenación con sufijo de orden opcional (:asc o :desc). Use los nombres de las propiedades de la respuesta. Campos válidos: id, name, created_at, timezone, should_restart, wake_on_lan, force_patching_configuration, is_in_maintenance, patch_policy_target_type. Ejemplo: "name:asc" o "created_at:desc" - name: fields in: query required: false schema: type: string maxLength: 2048 description: >- Lista de campos separada por comas para incluir en cada elemento de objetivo de política de parches. Campos seleccionables: id, name, created_by, created_at, timezone, should_restart, wake_on_lan, force_patching_configuration, is_in_maintenance, weeks, schedule, patch_policy_target_type, patch_policy_id. El campo id siempre se incluye. example: name,timezone,patch_policy_id - name: filters in: query required: false schema: type: string maxLength: 5120 description: >- Filtre objetivos de política de parches por uno o más criterios. Proporcione un objeto JSON con condiciones de filtro. Puede filtrar por cualquier campo devuelto en la respuesta. Use operadores de comparación (eq, ne, gt, gte, lt, lte, in, nin, contains, startsWith, endsWith, between) y combine múltiples condiciones con operadores lógicos (and, or). Longitud máxima: 5120 caracteres. examples: simple: summary: Filtrar por nombre del objetivo description: >- Devuelve objetivos de política de parches cuyo nombre contiene el texto proporcionado. value: '{"field": "name", "op": "contains", "value": "Base"}' complex-and: summary: Filtrar por tipo de objetivo y comportamiento de reinicio description: >- Devuelve objetivos de Windows que requieren reinicio después del parcheo. value: >- {"and": [{"field": "patch_policy_target_type", "op": "eq", "value": "windows"}, {"field": "should_restart", "op": "eq", "value": true}]} complex-or-and: summary: Combinar condiciones OR y AND description: >- Coincide con múltiples zonas horarias y excluye objetivos en mantenimiento. value: >- {"and": [{"or": [{"field": "timezone", "op": "eq", "value": "UTC"}, {"field": "timezone", "op": "eq", "value": "America/New_York"}]}, {"field": "is_in_maintenance", "op": "eq", "value": false}]} responses: '200': description: >- Lista paginada de objetivos de política de parches recuperada correctamente. content: application/json: schema: $ref: '#/components/schemas/PatchPolicyTargetV1ListResponseV1' examples: single-target: summary: Objetivo de política de parches único value: has_next: false data: - id: 66ab6cf4d4d2e709bafd404c name: Base created_by: 6439606652fc0c0051f1787b created_at: '2024-08-01T11:09:40.719Z' timezone: UTC should_restart: true wake_on_lan: true force_patching_configuration: false is_in_maintenance: false weeks: - 1 - 2 schedule: MONDAY: {} TUESDAY: {} WEDNESDAY: {} THURSDAY: '9': - 15 - 30 - 45 '10': - 0 - 15 - 30 - 45 '11': - 0 - 15 - 30 - 45 '12': - 0 - 15 - 30 - 45 '13': - 0 - 15 - 30 - 45 '14': - 0 - 15 - 30 - 45 '15': - 0 FRIDAY: {} SATURDAY: {} SUNDAY: {} patch_policy_target_type: windows patch_policy_id: 507f1f77bcf86cd799439011 multiple-targets: summary: Múltiples objetivos de política de parches value: has_next: true data: - id: 66ab6cf4d4d2e709bafd404c name: Base created_by: 6439606652fc0c0051f1787b created_at: '2024-08-01T11:09:40.719Z' timezone: UTC should_restart: true wake_on_lan: true force_patching_configuration: false is_in_maintenance: false weeks: - 1 - 2 schedule: MONDAY: {} TUESDAY: {} WEDNESDAY: {} THURSDAY: '9': - 15 - 30 - 45 '10': - 0 - 15 - 30 - 45 FRIDAY: {} SATURDAY: {} SUNDAY: {} patch_policy_target_type: windows patch_policy_id: 507f1f77bcf86cd799439011 - id: 66ab6cf4d4d2e709bafd404d name: Linux Base created_by: 6439606652fc0c0051f1787b created_at: '2024-08-02T10:00:00.000Z' timezone: America/New_York should_restart: false wake_on_lan: false force_patching_configuration: true is_in_maintenance: false weeks: - 1 schedule: MONDAY: '8': - 0 - 30 TUESDAY: {} WEDNESDAY: {} THURSDAY: {} FRIDAY: {} SATURDAY: {} SUNDAY: {} patch_policy_target_type: linux patch_policy_id: 507f1f77bcf86cd799439012 empty-list: summary: Lista vacía cuando no existen objetivos value: has_next: false data: [] no-patch-policy: summary: Objetivo sin política de parches asignada value: has_next: false data: - id: 66ab6cf4d4d2e709bafd404c name: Base created_by: 6439606652fc0c0051f1787b created_at: '2024-08-01T11:09:40.719Z' timezone: UTC should_restart: true wake_on_lan: true force_patching_configuration: false is_in_maintenance: false weeks: - 1 - 2 schedule: MONDAY: {} TUESDAY: {} WEDNESDAY: {} THURSDAY: {} FRIDAY: {} SATURDAY: {} SUNDAY: {} patch_policy_target_type: null patch_policy_id: null '400': $ref: '#/components/responses/BadRequest' description: Solicitud incorrecta. Paginación, ordenación o filtros no válidos. '401': $ref: '#/components/responses/Unauthorized' description: >- No autorizado: el usuario no tiene acceso a la organización, o la organización no existe '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: PatchPolicyTargetV1ListResponseV1: type: object properties: has_next: type: boolean description: Indica si hay más resultados disponibles en la siguiente página data: type: array items: $ref: '#/components/schemas/PatchPolicyTargetV1' description: Arreglo de objetos de objetivo de política de parches required: - has_next - data PatchPolicyTargetV1: type: object description: Recurso de objetivo de política de parches properties: id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: El identificador único del objetivo de política de parches example: 66ab6cf4d4d2e709bafd404c name: type: string description: Nombre del objetivo de política de parches example: Base created_by: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: ID de usuario que creó el objetivo de política de parches example: 6439606652fc0c0051f1787b created_at: type: string format: date-time description: >- Fecha y hora de creación del objetivo de política de parches (datetime ISO 8601) example: '2024-08-01T11:09:40.719Z' timezone: type: string description: >- Zona horaria para la programación de la política de parches. Identificador de zona horaria IANA o nombre de zona horaria de Windows. example: UTC should_restart: type: boolean description: Si se deben reiniciar los Workspaces después del parcheo example: true wake_on_lan: type: boolean description: Si se debe usar Wake on LAN para el parcheo example: true force_patching_configuration: type: boolean description: Si se debe forzar la configuración de parcheo example: false is_in_maintenance: type: boolean description: >- Si el objetivo de política de parches está actualmente en modo de mantenimiento example: false weeks: type: array items: type: integer minimum: 1 maximum: 4 description: >- Arreglo de números de semana (1-4) en los que debe ocurrir el parcheo example: - 1 - 2 schedule: type: object description: >- Programación que define cuándo ocurre el parcheo. Las claves son nombres de días (MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY). Los valores son objetos vacíos u objetos con claves de hora (como cadenas) que contienen arreglos de números de minuto. additionalProperties: type: object additionalProperties: type: array items: type: integer minimum: 0 maximum: 59 example: MONDAY: {} TUESDAY: {} WEDNESDAY: {} THURSDAY: '9': - 15 - 30 - 45 '10': - 0 - 15 - 30 - 45 '11': - 0 - 15 - 30 - 45 FRIDAY: {} SATURDAY: {} SUNDAY: {} patch_policy_target_type: type: string enum: - windows - linux - null nullable: true description: Tipo de objetivo de política de parches ('windows', 'linux' o null). example: windows patch_policy_id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ nullable: true description: >- El identificador único de la política de parches asociada. Null si no hay una política de parches asignada. example: 507f1f77bcf86cd799439011 required: - id ErrorResponse: type: object properties: error: type: object properties: message: type: string code: type: string details: type: string required: - message - code required: - error responses: BadRequest: description: Solicitud incorrecta content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: No autorizado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' TooManyRequests: description: Demasiadas solicitudes content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````