

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Chaves de API
<a name="api-keys"></a>

Você pode fazer chamadas à API do Amazon Bedrock facilmente gerando uma chave de API do Amazon Bedrock e usando-a para autenticar sua identidade ao fazer solicitações à API do Amazon Bedrock.

**nota**  
Para fins de auditoria e conformidade, todas as chamadas de API são registradas AWS CloudTrail. As chaves de API do Amazon Bedrock são transmitidas como cabeçalhos de autorização para solicitações de API e não são registradas em log.  
As chaves de API do Amazon Bedrock estão restritas às ações do [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) e do [Amazon Bedrock Runtime](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html). Não é possível usar as seguintes operações de API:  
[InvokeModelWithBidirectionalStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithBidirectionalStream.html).
Operações de API dos recursos [Agentes para Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) ou [Agentes para Amazon Bedrock Runtime](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html).
Operações de API da [Automação de Dados para Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Data_Automation_for_Amazon_Bedrock.html) ou do [Runtime para Automação de Dados do Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Runtime_for_Amazon_Bedrock_Data_Automation).

O Amazon Bedrock permite que você gere os seguintes tipos de chave de API do Amazon Bedrock:
+ **Curto prazo**: crie uma chave de API do Amazon Bedrock que dure o mesmo tempo de sua sessão (e não mais que 12 horas). Você já deve ter uma [entidade principal do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_identity-management.html#intro-structure-terms) configurada com as permissões adequadas para usar o Amazon Bedrock. Essa opção é preferível às chaves de longo prazo para ambientes de produção que exigem a alteração regular de credenciais para aumentar a segurança.

  As chaves de curto prazo têm as seguintes propriedades:
  + São válidas para valores mais curtos do que os seguintes valores:
    + 12 horas
    + A duração da sessão gerada pela entidade principal do IAM usada para gerar a chave.
  + Herdam as permissões associadas à entidade principal usada para gerar a chave.
  + Só pode ser usado na AWS região da qual você o gerou.
+ **Longo prazo**: crie uma chave de API do Amazon Bedrock com permissões para fazer solicitações básicas de API no Amazon Bedrock. Essa opção fácil de um clique permite que você comece a explorar rapidamente a API Amazon Bedrock sem precisar entender a infraestrutura de segurança subjacente ou configurar manualmente as permissões. AWS Identity and Access Management Se você está experimentando o Amazon Bedrock pela primeira vez, pode experimentar o exemplo em [Comece a usar as chaves de API do Amazon Bedrock: gere uma chave de trinta dias e faça sua primeira chamada de API](getting-started-api-keys.md) para ver um tutorial fácil para criar uma chave de longo prazo e começar a usar o Amazon Bedrock.
**Atenção**  
É altamente recomendável restringir o uso das chaves de API do Amazon Bedrock à exploração do Amazon Bedrock. Quando estiver tudo pronto para incorporar o Amazon Bedrock em aplicações com maiores requisitos de segurança, você deve mudar para credenciais de curto prazo. Para ter mais informações, consulte [Alternativas para chaves de acesso de longo prazo](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds-programmatic-access.html#security-creds-alternatives-to-long-term-access-keys) no “Guia do usuário do IAM”.

Selecione um tópico para saber mais sobre as chaves de API do Amazon Bedrock. Há várias opções para diferentes tipos de chave do Amazon Bedrock e de métodos para personalizá-las. Para ver um tutorial de início rápido sobre como gerar uma chave de API de longo prazo do Amazon Bedrock e usá-la para fins exploratórios, consulte [Comece a usar as chaves de API do Amazon Bedrock: gere uma chave de trinta dias e faça sua primeira chamada de API](getting-started-api-keys.md).

**Topics**
+ [Como a API do Amazon Bedrock funciona](api-keys-how.md)
+ [Regiões suportadas e kits AWS de desenvolvimento de software (SDKs) para chaves de API do Amazon Bedrock](api-keys-supported.md)
+ [Gerar uma chave de API do Amazon Bedrock](api-keys-generate.md)
+ [Usar uma chave de API do Amazon Bedrock](api-keys-use.md)
+ [Modificar as permissões para chaves de API de longo e curto prazos do Amazon Bedrock](api-keys-modify.md)
+ [Lidar com chaves de API de longo e curto prazo comprometidas do Amazon Bedrock](api-keys-revoke.md)
+ [Controlar as permissões para gerar e usar as chaves de API do Amazon Bedrock](api-keys-permissions.md)