> ## 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 alvos de política de patches > Recupera uma lista paginada de alvos de política de patches para uma organização. Suporta paginação, ordenação e filtração mediante uma cadeia de filtros JSON. Os alvos de política de patches definem quando e como os patches são aplicados aos Workspaces. ## OpenAPI ````yaml /pt-BR/api-reference/openapi.pt-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 para portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/patch-policy-targets: get: tags: - Alvos de política de patches summary: Listar alvos de política de patches description: >- Recupera uma lista paginada de alvos de política de patches para uma organização. Suporta paginação, ordenação e filtração mediante uma cadeia de filtros JSON. Os alvos de política de patches definem quando e como os patches são aplicados aos Workspaces. operationId: listPatchPolicyTargets parameters: - name: organization_id in: path required: true schema: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: O identificador único da organização example: 507f1f77bcf86cd799439011 - name: page in: query required: false schema: type: integer default: 1 minimum: 1 description: 'Número da página (padrão: 1)' - name: per_page in: query required: false schema: type: integer default: 100 maximum: 100 minimum: 1 description: 'Itens por página (padrão: 100, máx.: 100)' - name: sort in: query required: false schema: type: string description: >- Campo de ordenação com sufixo de ordem opcional (:asc ou :desc) Use os nomes das propriedades da resposta Campos válidos: id, name, created_at, timezone, should_restart, wake_on_lan, force_patching_configuration, is_in_maintenance, patch_policy_target_type Exemplo: "name:asc" ou "created_at:desc" - name: fields in: query required: false schema: type: string maxLength: 2048 description: >- Lista de campos separados por vírgulas para incluir em cada elemento de objetivo de política de patches. Campos selecionáveis: 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. O campo id sempre é incluído. example: name,timezone,patch_policy_id - name: filters in: query required: false schema: type: string maxLength: 5120 description: >- Filtere alvos de política de patches por um ou mais critérios. Forneça um objeto JSON com condições de filtro. Pode filtrar por qualquer campo retornado na resposta. Use operadores de comparação (eq, ne, gt, gte, lt, lte, in, nin, contains, startsWith, endsWith, between) e combine múltiplas condições com operadores lógicos (and, or). Tamanho máximo: 5120 caracteres. examples: simple: summary: Filtrar por nome do alvo description: >- Retorna alvos de política de patch cujo nome contém o texto fornecido. value: '{"field": "name", "op": "contains", "value": "Base"}' complex-and: summary: Filtrar por tipo de alvo e comportamento de reinício description: >- Retorna alvos do Windows que requerem reinício após a aplicação de patches. value: >- {"and": [{"field": "patch_policy_target_type", "op": "eq", "value": "windows"}, {"field": "should_restart", "op": "eq", "value": true}]} complex-or-and: summary: Combinar condições OU e E description: >- Coincidir com múltiplos fusos horários e excluir alvos em manutenção. 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 alvos de política de patches recuperada corretamente. content: application/json: schema: $ref: '#/components/schemas/PatchPolicyTargetV1ListResponseV1' examples: single-target: summary: Alvo de política de patches ú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últiplos alvos de política de patches 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 vazia quando não existem alvos value: has_next: false data: [] no-patch-policy: summary: Alvo sem política de patches atribuída 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: Solicitação incorreta. Paginação, ordenação ou filtros inválidos. '401': $ref: '#/components/responses/Unauthorized' description: >- Não autorizado: o usuário não tem acesso à organização, ou a organização não existe '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: PatchPolicyTargetV1ListResponseV1: type: object properties: has_next: type: boolean description: Indica se há mais resultados disponíveis na próxima página data: type: array items: $ref: '#/components/schemas/PatchPolicyTargetV1' description: Array de objetos de destino de política de patches required: - has_next - data PatchPolicyTargetV1: type: object description: Recurso de destino de política de patches properties: id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: O identificador único do destino de política de patches example: 66ab6cf4d4d2e709bafd404c name: type: string description: Nome do destino de política de patches example: Base created_by: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ description: ID do usuário que criou o objetivo de política de patches example: 6439606652fc0c0051f1787b created_at: type: string format: date-time description: >- Data e hora de criação do objetivo de política de patches (datetime ISO 8601) example: '2024-08-01T11:09:40.719Z' timezone: type: string description: >- Zona horária para o cronograma da política de patches. Identificador de zona horária IANA ou nome de zona horária do Windows. example: UTC should_restart: type: boolean description: Se os Workspaces devem ser reiniciados após o patching example: true wake_on_lan: type: boolean description: Se deve usar Wake on LAN para aplicar patches example: true force_patching_configuration: type: boolean description: Se a configuração de patching deve ser forçada example: false is_in_maintenance: type: boolean description: >- Se o destino de política de patches está atualmente em modo de manutenção example: false weeks: type: array items: type: integer minimum: 1 maximum: 4 description: Array de números de semana (1-4) nos quais o patching deve ocorrer example: - 1 - 2 schedule: type: object description: >- Cronograma que define quando ocorre o patching. As chaves são nomes de dias (MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY). Os valores são objetos vazios ou objetos com chaves de hora (como cordas) que contêm arrays 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 destino de política de patches ('windows', 'linux' ou null). example: windows patch_policy_id: type: string maxLength: 24 pattern: ^[0-9a-f]{24}$ nullable: true description: >- O identificador único da política de patches associada. Null se não houver uma política de patches atribuída. 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: Solicitação incorreta content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: Não autorizado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' TooManyRequests: description: Solicitações em excesso content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Erro interno do servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````