> ## 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. # Llistar objectius de política de pedaços > Recupera una llista paginada d'objectius de política de parxes per a una organització. Admet paginació, ordenació i filtrat mitjançant una cadena de filtres JSON. Els objectius de política de parxes defineixen quan i com s'apliquen els parxes als Workspaces. ## OpenAPI ````yaml /ca/api-reference/openapi.ca-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 pública REST per al portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/patch-policy-targets: get: tags: - Objectius de política de parxes summary: Llistar objectius de política de pedaços description: >- Recupera una llista paginada d'objectius de política de parxes per a una organització. Admet paginació, ordenació i filtrat mitjançant una cadena de filtres JSON. Els objectius de política de parxes defineixen quan i com s'apliquen els parxes als Workspaces. operationId: listPatchPolicyTargets parameters: - name: organization_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: El identificador únic de l'organització example: 507f1f77bcf86cd799439011 - name: page in: query required: false schema: type: integer default: 1 minimum: 1 description: 'Número de pàgina (predeterminat: 1)' - name: per_page in: query required: false schema: type: integer default: 100 maximum: 100 minimum: 1 description: 'Elements per pàgina (predeterminat: 100, màx.: 100)' - name: sort in: query required: false schema: type: string description: >- Camp de ordenació amb sufix d'ordre opcional (:asc o :desc). Useu els noms de les propietats de la resposta. Camps vàlids: id, name, created_at, timezone, should_restart, wake_on_lan, force_patching_configuration, is_in_maintenance, patch_policy_target_type. Exemple: "name:asc" o "created_at:desc" - name: fields in: query required: false schema: type: string maxLength: 2048 description: >- Llista de camps separada per comes per incloure en cada element d'objectiu de política de pedaços. Camps 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 camp id sempre s'inclou. example: name,timezone,patch_policy_id - name: filters in: query required: false schema: type: string maxLength: 5120 description: >- Filtre objectius de política de parxes per un o més criteris. Proporcioneu un objecte JSON amb condicions de filtre. Es pot filtrar per qualsevol camp retornat en la resposta. Useu operadors de comparació (eq, ne, gt, gte, lt, lte, in, nin, contains, startsWith, endsWith, between) i combineu múltiples condicions amb operadors lògics (and, or). Longitud màxima: 5120 caràcters. examples: simple: summary: Filtrar per nom de l'objectiu description: >- Retorna objectius de política de pegats el nom dels quals conté el text proporcionat. value: '{"field": "name", "op": "contains", "value": "Base"}' complex-and: summary: Filtrar per tipus d'objectiu i comportament de reinici description: >- Retorna objectius de Windows que requereixen reinici després de l'aplicació de pegats. value: >- {"and": [{"field": "patch_policy_target_type", "op": "eq", "value": "windows"}, {"field": "should_restart", "op": "eq", "value": true}]} complex-or-and: summary: Combina condicions OR i AND description: >- Coincideix amb múltiples zones horàries i exclou objectius en manteniment. 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: >- Llista paginada d'objectius de política de parxes recuperada correctament. content: application/json: schema: $ref: '#/components/schemas/PatchPolicyTargetV1ListResponseV1' examples: single-target: summary: Objectiu de política de parxes únic 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 objectius de política de parxes 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: Llista buida quan no existeixen objectius value: has_next: false data: [] no-patch-policy: summary: Objectiu sense política de parxes assignada 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: Sol·licitud incorrecta. Paginació, ordenació o filtres no vàlids. '401': $ref: '#/components/responses/Unauthorized' description: >- No autoritzat: l'usuari no té accés a l'organització, o l'organització no existeix '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: PatchPolicyTargetV1ListResponseV1: type: object properties: has_next: type: boolean description: Indica si hi ha més resultats disponibles a la següent pàgina data: type: array items: $ref: '#/components/schemas/PatchPolicyTargetV1' description: Arreglament d'objectes de destí de política de pegats required: - has_next - data PatchPolicyTargetV1: type: object description: Recurs de destí de política de pegats properties: id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: El identificador únic del destí de política de pegats example: 66ab6cf4d4d2e709bafd404c name: type: string description: Nom del destí de política de pegats example: Base created_by: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: ID d'usuari que va crear l'objectiu de política de pedaços example: 6439606652fc0c0051f1787b created_at: type: string format: date-time description: >- Data i hora de creació de l'objectiu de política de pedaços (datetime ISO 8601) example: '2024-08-01T11:09:40.719Z' timezone: type: string description: >- Zona horària per a la programació de la política de pegats. Identificador de zona horària IANA o nom de zona horària de Windows. example: UTC should_restart: type: boolean description: Si s'han de reiniciar els Workspaces després del pegat example: true wake_on_lan: type: boolean description: Si s'ha d'utilitzar Wake on LAN per al parche example: true force_patching_configuration: type: boolean description: Si s'ha de forçar la configuració de pegat example: false is_in_maintenance: type: boolean description: >- Si el destí de política de pegats està actualment en mode de manteniment example: false weeks: type: array items: type: integer minimum: 1 maximum: 4 description: >- Arreglament de números de setmana (1-4) en les quals ha d'ocórrer el pegat example: - 1 - 2 schedule: type: object description: >- Programació que defineix quan ocorre el pegat. Les claus són noms de dies (MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY). Els valors són objectes buits o objectes amb claus d'hora (com cadenes) que contenen arregles de números de minut. 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: Tipus de destí de política de pegats ('windows', 'linux' o null). example: windows patch_policy_id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ nullable: true description: >- El identificador únic de la política de pegats associada. Null si no hi ha una política de pegats assignada. 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: Sol·licitud incorrecta content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: No autoritzat content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' TooManyRequests: description: Masses sol·licituds content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Error intern del servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````