Sobre as Políticas do Speech

Saiba mais sobre as políticas de recursos, incluindo permissões de API.

Para controlar quem tem acesso ao Speech e o tipo de acesso de cada grupo de usuários, crie políticas. Por padrão, somente os usuários do grupo Administradores têm acesso a todos os recursos do Speech.

Para todos os outros que estiverem usando o serviço, você deverá criar políticas que designem a eles direitos apropriados aos recursos Speech. Para obter uma lista completa das políticas do OCI, consulte a Referência de Políticas.

Tipos de Recurso

O Speech oferece tipos de recursos agregados e individuais para criação de políticas. Você pode usar tipos de recursos agregados para criar menos políticas. Por exemplo, em vez de permitir que um grupo gerencie todos os tipos de recursos individuais, você pode ter uma política que permita que o grupo gerencie o tipo de recurso agregado, ai-service-speech-family.

Tipos de Recurso Individual
ai-service-speech-transcription-job
ai-service-speech-synthesize-voice
ai-service-speech-synthesize
Tipo de Recurso Agregado
ai-service-speech-family

Políticas Obrigatórias do Serviço IAM

Para trabalhar com Speech, um administrador deve conceder acesso em uma política de IAM.

Se você receber uma mensagem de que não tem permissão ou que não está autorizado, verifique com o administrador o tipo de acesso que você tem.

Você deve fornecer acesso ao Object Storage para ler arquivos de mídia e gerar transcrições para um bucket criando políticas.

Crie uma política com uma das seguintes políticas para gerenciar objetos:

allow <group-name> SpeechUsers to manage object-family in tenancy

Crie uma política com uma das seguintes políticas para gerenciar jobs de transcrição:

allow <subject> to
          manage ai-service-speech-family in tenancy
          group <group-name> | group
          id <group-ocid> |
          dynamic-group <dynamic-group-name> |
        dynamic-group id <dynamic-group-ocid> |
        any-user

Exemplos de Política

Essas políticas permitem que os usuários do grupo SpeechUsers gerenciem jobs de transcrição de Fala:

allow group SpeechUsers to manage ai-service-speech-family in tenancy
allow group SpeechUsers to manage object-family in tenancy
allow group SpeechUsers to read tag-namespaces in tenancy
allow group SpeechUsers to inspect tag-namespaces in tenancy

Se você quiser limitar o acesso a um compartimento específico, crie um grupo e defina estas políticas nesse compartimento:

allow group SpeechUsers to manage ai-service-speech-family in compartment <compartment-name>
allow group SpeechUsers to manage object-family in compartment <compartment-name>
allow group SpeechUsers to read tag-namespaces in compartment <compartment-name>
allow group SpeechUsers to inspect tag-namespaces in compartment <compartment-name>

Permita que todos os usuários gerenciem todos os recursos de Fala usando o recurso agregado:

allow any-user to manage ai-service-speech-family in tenancy

Para ter acesso a todos os recursos de Speech:

allow group <SpeechUsers> to manage ai-service-speech-family in tenancy
or
allow group <SpeechUsers> to manage ai-service-speech-synthesize in tenancy

Para ter acesso a todos os recursos de Texto para Fala apenas:

allow group <SpeechUsers> to manage ai-service-speech-synthesize-voice in tenancy
allow group <SpeechUsers> to manage ai-service-speech-synthesize in tenancy

Tipos de Recursos e Permissões

Recurso Permissões
ai-service-speech-transcription-job AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_INSPECT
AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_CREATE
AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_READ
AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_UPDATE
AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_CANCEL
AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_DELETE
AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_MOVE

Permissões Exigidas para cada Operação de API

Você pode usar os tipos de recursos individuais com chamadas de API para interagir com o serviço.

A tabela a seguir lista as operações de API para o serviço Speech em ordem lógica, agrupadas por tipo de recurso, e as permissões necessárias para os tipos de recurso:

Operação de API Permissão

CreateTranscriptionJob

AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_CREATE

ListTranscriptionJobs

AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_INSPECT

GetTranscriptionJob

AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_READ

UpdateTranscriptionJob

AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_UPDATE
CancelTranscriptionJob AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_CANCEL
DeleteTranscriptionJob AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_READAI_SERVICE_SPEECH_TRANSCRIPTION_JOB_DELETE
ChangeTranscriptionJobCompartment AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_MOVE
ListTranscriptionTasks AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_READ
GetTranscriptionTask AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_READ
CancelTranscriptionTask

AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_READ

AI_SERVICE_SPEECH_TRANSCRIPTION_JOB_CANCEL