Riferimento alle autorizzazioni di Amazon Q Developer

Amazon Q Developer utilizza due tipi di servizi APIs per fornire il servizio:

• Autorizzazioni utente e amministratore, che possono essere utilizzate nelle politiche per controllare l'utilizzo di Amazon Q

• Altro APIs utilizzato per fornire il servizio, che non può essere utilizzato nelle politiche per il controllo dell'utilizzo di Amazon Q

Questa sezione fornisce informazioni sugli strumenti APIs utilizzati da Amazon Q Developer e sulla loro funzione.

Autorizzazioni Amazon Q Developer

Puoi utilizzare le seguenti autorizzazioni come riferimento quando configuri l'autenticazione con le identità in Amazon Q e scrivi politiche di autorizzazione da allegare a un'identità IAM (politiche basate sull'identità).

La tabella seguente mostra le autorizzazioni Amazon Q Developer a cui puoi consentire o negare l'accesso nelle policy.

Importante

Per chattare con Amazon Q, un'identità IAM necessita delle autorizzazioni per le seguenti azioni:

• StartConversation

• SendMessage

• GetConversation (solo console)

• ListConversations (solo console)

Se una di queste azioni non è esplicitamente consentita da una policy allegata, viene restituito un errore di autorizzazione IAM quando tenti di chattare con Amazon Q.

Nota

Il codewhisperer prefisso è un nome legacy di un servizio che si è unito ad Amazon Q Developer. Per ulteriori informazioni, consulta Amazon Q Developer rename - Riepilogo delle modifiche.

Autorizzazioni Amazon Q Developer

Nome	Descrizione dell'autorizzazione concessa	Necessario per chattare con Amazon Q?
Autorizzazioni degli utenti
codewhisperer:GenerateRecommendations	Ottieni suggerimenti sul codice in Amazon Q per ambienti di AWS codifica	No
q:GenerateCodeFromCommands	Genera codice dai comandi CLI in Amazon Q	No
q:GetConversation	Recupero dei singoli messaggi associati a una conversazione specifica con Amazon Q	Sì (solo nella console)
q:GetIdentityMetaData	Consenti ad Amazon Q di recuperare i metadati relativi all'identità dell'applicazione	No
q:GetTroubleshootingResults	Recupero dei risultati di risoluzione dei problemi con Amazon Q	No
q:ListConversations	Elenca le singole conversazioni associate a un utente Amazon Q specifico	Sì (solo su console)
q:PassRequest	Consenti ad Amazon Q di eseguire azioni che un'identità IAM è autorizzata a eseguire	No
q:SendMessage	Invio di un messaggio ad Amazon Q	Sì
q:StartConversation	Avvio di una conversazione con Amazon Q	Sì
q:StartTroubleshootingAnalysis	Avvio di un'analisi di risoluzione dei problemi con Amazon Q	No
q:StartTroubleshootingResolutionExplanation	Avvio di una spiegazione della risoluzione dei problemi con Amazon Q	No
q:UsePlugin	Accedi ai plugin dalla chat di Amazon Q	No
q:UpdateTroubleshootingCommandResult	Consenti ad Amazon Q di analizzare le risorse per risolvere un errore della console	No
Autorizzazioni di amministratore
codewhisperer:CreateCustomization	Crea una personalizzazione di Amazon Q dalla tua fonte di dati	No
codewhisperer:DeleteCustomization	Eliminare una personalizzazione di Amazon Q	No
codewhisperer:GetCustomization	Ottieni dettagli su una personalizzazione di Amazon Q	No
codewhisperer:ListCustomizations	Elenca le personalizzazioni di Amazon Q in base al loro stato	No
codewhisperer:ListProfiles	Elenca profili Amazon Q	No
codewhisperer:ListTagsForResource	Elenca tutti i tag associati a una risorsa Amazon Q nella console	No
codewhisperer:TagResource	Aggiungere o creare un tag per una risorsa Amazon Q	No
codewhisperer:UnTagResource	Rimuovere un tag da una risorsa Amazon Q	No
codewhisperer:UpdateCustomization	Attivazione o disattivazione di una personalizzazione di Amazon Q	No
codewhisperer:ListCustomizationVersions	Elenca le versioni di una personalizzazione di Amazon Q	No
codewhisperer:UpdateProfile	Aggiornamento di un profilo Amazon Q	No
q:CreateAssignment	Crea un'assegnazione di utenti o gruppi per un profilo di sviluppatore Amazon Q	No
q:CreatePlugin	Crea e configura un plug-in di terze parti in Amazon Q	No
q:DeleteAssignment	Eliminare l'assegnazione di un utente o di un gruppo per un profilo di sviluppatore Amazon Q	No
q:DeletePlugin	Eliminare un plug-in configurato in Amazon Q	No
q:GetPlugin	Visualizza informazioni su uno specifico plug-in Amazon Q	No
q:ListPlugins	Visualizza i plugin configurati in Amazon Q	No
q:ListPluginProviders	Visualizza i plugin disponibili in Amazon Q	No
q:ListTagsForResource	Elenca tutti i tag associati a una risorsa Amazon Q nella console	No
q:TagResource	Aggiungere o creare un tag per una risorsa Amazon Q	No
q:UntagResource	Rimuovere un tag da una risorsa Amazon Q	No

Usando q: PassRequest

q:PassRequestè un'autorizzazione Amazon Q che consente ad Amazon Q di effettuare chiamate per tuo AWS APIs conto. Quando aggiungi l'q:PassRequestautorizzazione a un'identità IAM, Amazon Q ottiene l'autorizzazione a chiamare qualsiasi API che l'identità IAM è autorizzata a chiamare. Ad esempio, se un ruolo IAM dispone dell's3:ListAllMyBucketsautorizzazione e dell'q:PassRequestautorizzazione, Amazon Q è in grado di chiamare l'ListAllMyBucketsAPI quando un utente che assume quel ruolo IAM chiede ad Amazon Q di elencare i propri bucket Amazon S3.

Puoi creare policy IAM che limitano l'ambito dell'autorizzazione. q:PassRequest Ad esempio, puoi impedire ad Amazon Q di eseguire un'azione specifica o consentire ad Amazon Q di eseguire solo un sottoinsieme di azioni per un servizio. Puoi anche specificare in quali regioni Amazon Q può effettuare chiamate quando esegue azioni per tuo conto.

Per esempi di policy IAM che controllano l'uso diq:PassRequest, consulta i seguenti esempi di policy basate sull'identità:

• Consenti ad Amazon Q di eseguire azioni per tuo conto in chat

• Negare ad Amazon Q l'autorizzazione a eseguire azioni specifiche per tuo conto

• Consenti ad Amazon Q di eseguire azioni specifiche per tuo conto

• Consenti ad Amazon Q di eseguire azioni per tuo conto in regioni specifiche

• Negare ad Amazon Q l'autorizzazione a eseguire azioni per tuo conto

Autorizzazioni degli abbonamenti utente Amazon Q

Gli amministratori di Amazon Q Developer devono disporre delle seguenti autorizzazioni per creare e gestire abbonamenti per utenti e gruppi della propria organizzazione.

La seguente terminologia è utile per comprendere a cosa servono le autorizzazioni degli abbonamenti:

Utente

Un singolo utente, rappresentato all'interno AWS IAM Identity Center da un ID utente univoco.

Group (Gruppo)

Una raccolta di utenti, rappresentata all'interno AWS IAM Identity Center da un ID di gruppo univoco.

Subscription

Un abbonamento è legato a un singolo utente di Identity Center e gli dà diritto a utilizzare le funzionalità di Amazon Q. Un abbonamento non autorizza un utente a utilizzare le funzionalità di Amazon Q. Ad esempio, se Adam è abbonato ad Amazon Q Developer Pro, ha il diritto di utilizzare le funzionalità di Amazon Q Developer, ma non ha accesso a tali funzionalità finché l'amministratore non concede loro le autorizzazioni necessarie.

Autorizzazioni degli abbonamenti utente Amazon Q

Nome	Descrizione dell'azione
user-subscriptions:CreateClaim	Crea un abbonamento utente
user-subscriptions:DeleteClaim	Eliminare un abbonamento utente
user-subscriptions:ListApplicationClaims	Elenca tutte le sottoscrizioni utente per una determinata applicazione
user-subscriptions:ListClaims	Elenca tutte le sottoscrizioni degli utenti
user-subscriptions:ListUserSubscriptions	Elenca tutte le sottoscrizioni utente per un determinato utente
user-subscriptions:UpdateClaim	Aggiornare l'abbonamento di un utente

Altri sviluppatori Amazon Q APIs

La tabella seguente mostra APIs le funzionalità utilizzate da Amazon Q nell'IDE. APIs Non vengono utilizzati per controllare l'accesso alle funzionalità di Amazon Q, ma verranno visualizzati nei AWS CloudTrail log degli account di gestione quando gli utenti accedono alla funzionalità associata.

Nota

Il codewhisperer prefisso è un nome legacy di un servizio che si è unito ad Amazon Q Developer. Per ulteriori informazioni, consulta Amazon Q Developer rename - Riepilogo delle modifiche.

Amazon Q Developer APIs per fornire il servizio

Nome	Descrizione dell'azione
codewhisperer:AllowVendedLogDeliveryForResource	Consente ad Amazon Q Developer di pubblicare i log su Amazon CloudWatch in modo asincrono
codewhisperer:CreateTaskAssistConversation	Inizia una conversazione con Amazon Q Developer Agent for software development
codewhisperer:CreateUploadUrl	Crea l'URL per caricare i file di codice che verranno utilizzati per lo sviluppo con Amazon Q nell'IDE.
codewhisperer:DeleteTaskAssistConversation	Elimina una conversazione con Amazon Q Developer Agent for software development
codewhisperer:ExportResultArchive	Esporta un archivio di output di Amazon Q Developer per il download
codewhisperer:GenerateAssistantResponse	Restituisce una risposta in Amazon Q in chat nell'IDE
codewhisperer:GenerateCompletions	Ottiene suggerimenti sul codice in linea
codewhisperer:GenerateTaskAssistPlan	Genera un piano di implementazione da Amazon Q Developer Agent for software development
codewhisperer:GetCodeAnalysis	Ottiene lo stato di una scansione di sicurezza in corso
codewhisperer:GetTaskAssistCodeGeneration	Ottiene il codice generato da Amazon Q Developer Agent for software development
codewhisperer:GetTransformation	Restituisce una trasformazione del codice da Amazon Q Developer Agent for code transformation
codewhisperer:GetTransformationPlan	Restituisce il piano di trasformazione dal Amazon Q Developer Agent for software development
codewhisperer:ListAvailableCustomizations	Restituisce l'elenco delle personalizzazioni che sono state create e sono disponibili per l'uso
codewhisperer:ListCodeAnalysisFindings	Restituisce l'elenco di tutti i problemi di sicurezza nei file scansionati
codewhisperer:ListFeatureEvaluations	Elenca le configurazioni pertinenti per le funzionalità lato client di Amazon Q Developer
codewhisperer:SendTelemetryEvent	Invia informazioni di telemetria AWS sull'utilizzo di Amazon Q nell'IDE
codewhisperer:StartTaskAssistCodeGeneration	Avvia la generazione del codice con Amazon Q Developer Agent for software development
codewhisperer:StartCodeAnalysis	Avvia una scansione di sicurezza
codewhisperer:StartTransformation	Inizia una trasformazione con Amazon Q Developer Agent for code transformation
codewhisperer:StopTransformation	Interrompe una trasformazione con Amazon Q Developer Agent for code transformation

Q Developer trasforma l'esperienza web APIs

• q: CreateArtifactUploadUrl

• q: CreateArtifactDownloadUrl

• q: ListArtifacts

• q: CompleteArtifactUpload

• q: CreateSession

• q: GetLoginRedirectUri

• q: GetUserDetails

• q: VerifySession

• q: RevokeSession

• q: PutUserRoleMappings

• q: DetectIsAllowedForOperation

• q: BatchGetMessage

• q: ListMessages

• q: SendMessage

• q: CreateConnector

• q: GetConnector

• q: ListConnectors

• q: DeleteConnector

• q: GetHitlTask

• q: SubmitStandardHitlTask

• q: SubmitCriticalHitlTask

• q: UpdateHitlTask

• q: ListHitlTasks

• q: GetJob

• q: ListJobs

• q: CreateJob

• q: UpdateJob

• q: StartJob

• q: StopJob

• q: ListJobPlanSteps

• q: ListPlanUpdates

• q: ListWorklogs

• q: CreateWorkspace

• q: GetWorkspace

• q: ListWorkspaces

• q: UpdateWorkspace

• q: ListUserRoleMappings