> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Elencare i profili di code scan (API Devin)
> Elenca i profili di code scan Devin disponibili per un Enterprise, inclusi i profili discover e ingest di proprietà delle org e condivisi a livello di account
## Autorizzazioni
Richiede un [utente di servizio](/it/api-reference/v3/service-users/members-service-users) o un [token di accesso personale](/it/api-reference/personal-access-tokens) con l'autorizzazione `ViewAccountCodeScans` a livello Enterprise.
## Comportamento
Restituisce i riepiloghi dei profili (senza il testo di guidance) in ordine dal più recente al meno recente, inclusi sia i profili di proprietà dell'organizzazione sia quelli condivisi a livello di account (`org_id` è `null` per i profili condivisi). Ogni riepilogo include il `mode` del profilo (`discover` o `ingest`) e `scan_type`, che determinano se può essere passato a [Avvia Code Scan](/it/api-reference/v3/code-scans/enterprise-code-scans-start) o [Avvia scansione di ingestione](/it/api-reference/v3/code-scans/enterprise-code-scans-start-ingestion).
Facoltativamente, filtra in base a `org_ids`; i risultati sono paginati tramite un cursore opaco (`after` / `first`). Usa [Ottieni profilo di Code Scan](/it/api-reference/v3/code-scans/enterprise-code-scans-profile) per leggere la guidance completa di un profilo. L'equivalente nell'ambito dell'organizzazione è [Elenca profili di Code Scan (organizzazione)](/it/api-reference/v3/code-scans/organizations-code-scans-profiles).
## OpenAPI
````yaml it/v3-openapi.yaml GET /v3/enterprise/code-scans/profiles
openapi: 3.1.0
info:
description: API Devin v3 con autenticazione utente di servizio e RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/enterprise/code-scans/profiles:
get:
tags:
- code-scans
summary: Elencare i profili di code scan
description: >-
Elenca i profili di code scan per l'account Enterprise.
Restituisce i riepiloghi dei profili (senza indicazioni) dal più recente
al meno recente, inclusi sia i profili di proprietà delle organizzazioni
sia quelli condivisi a livello di account. Filtra facoltativamente per
``org_ids``; i risultati sono paginati con un cursore opaco (``after`` /
``first``).
operationId: handle_list_code_scan_profiles_v3_enterprise_code_scans_profiles_get
parameters:
- in: query
name: after
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: After
- in: query
name: first
required: false
schema:
default: 100
maximum: 200
minimum: 1
title: First
type: integer
- description: >-
Restituisce solo i profili visibili a queste organizzazioni. Per
impostazione predefinita, include tutte le organizzazioni
dell'account.
in: query
name: org_ids
required: false
schema:
anyOf:
- items:
type: string
type: array
- type: 'null'
description: >-
Restituisce solo i profili visibili a queste organizzazioni. Per
impostazione predefinita, include tutte le organizzazioni
dell'account.
title: Org Ids
responses:
'200':
content:
application/json:
schema:
$ref: >-
#/components/schemas/PaginatedResponse_CodeScanProfileSummaryResponse_
description: Risposta riuscita
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Non autorizzato
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Accesso vietato
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Non trovato
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflitto
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Contenuto non elaborabile
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Troppe richieste
components:
schemas:
PaginatedResponse_CodeScanProfileSummaryResponse_:
properties:
end_cursor:
anyOf:
- type: string
- type: 'null'
description: >-
Cursor per recuperare la pagina successiva, oppure None se questa è
l'ultima pagina.
title: End Cursor
has_next_page:
default: false
description: Indica se sono disponibili altri elementi dopo questa pagina.
title: Has Next Page
type: boolean
items:
items:
$ref: '#/components/schemas/CodeScanProfileSummaryResponse'
title: Items
type: array
total:
anyOf:
- type: integer
- type: 'null'
description: >-
Conteggio totale facoltativo (può essere omesso per motivi di
prestazioni).
title: Total
required:
- items
title: PaginatedResponse[CodeScanProfileSummaryResponse]
type: object
ProblemDetail:
description: >-
Corpo dell'errore application/problem+json RFC 9457 per l'API v3.
detail è mantenuto dal corpo legacy {"detail": ...} per
retrocompatibilità; gli
altri membri sono aggiuntivi. errors contiene gli errori di validazione
a livello di campo
(solo 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: >-
Una spiegazione leggibile dall'utente, specifica per questa
occorrenza.
title: Detail
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Errori di convalida a livello di campo (solo per le risposte 422).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: >-
Un riferimento URI (il percorso della richiesta) per questa
occorrenza.
title: Instance
status:
description: Il codice di stato HTTP.
title: Status
type: integer
title:
description: Un breve riepilogo del tipo di problema, leggibile dall'utente.
title: Title
type: string
type:
default: about:blank
description: Un riferimento URI che identifica il tipo di problema.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
CodeScanProfileSummaryResponse:
description: Riepilogo di un profilo di code scan, senza le relative indicazioni.
properties:
created_at:
description: Momento in cui il profilo è stato creato (secondi Unix).
title: Created At
type: integer
description:
anyOf:
- type: string
- type: 'null'
description: Descrizione del profilo, se presente.
title: Description
mode:
description: 'Modalità del profilo: discover o ingest.'
enum:
- discover
- ingest
title: Mode
type: string
name:
description: Nome del profilo.
title: Name
type: string
org_id:
anyOf:
- type: string
- type: 'null'
description: >-
Organizzazione proprietaria del profilo. Null quando il profilo è
condiviso a livello di account.
title: Org Id
profile_id:
description: Identificatore univoco del profilo.
title: Profile Id
type: string
scan_type:
description: Tipo di scan configurato dal profilo.
enum:
- security
- performance
- db-queries
- test-coverage
- dead-code
- code-quality
- telemetry
- accessibility
- general
- migration-docs
title: Scan Type
type: string
visibility:
description: >-
Indica se il profilo appartiene a una singola organizzazione o è
condiviso a livello di account.
enum:
- org
- account
title: Visibility
type: string
required:
- profile_id
- name
- description
- visibility
- org_id
- scan_type
- mode
- created_at
title: CodeScanProfileSummaryResponse
type: object
securitySchemes:
bearerAuth:
description: 'Credenziale dell''utente del servizio (prefisso: cog_)'
scheme: bearer
type: http
````