É possível usar a AWS Command Line Interface (AWS CLI) ou um dos SDKs da AWS para especificar o endpoint usado pelo AWS CodeBuild. Há um endpoint para cada região de disponibilidade do CodeBuild. Além de um endpoint regional, quatro regiões também têm um endpoint do Federal Information Processing Standard (FIPS). Para obter mais informações sobre os endpoints FIPS, consulte Visão geral da publicação 140-2 da FIPS
A especificação de um endpoint é opcional. Se você não informar explicitamente ao CodeBuild qual endpoint usar, o serviço usará o endpoint associado à região da conta da AWS. O valor padrão do endpoint do CodeBuild nunca é um endpoint do FIPS. Se você quiser usar um endpoint do FIPS, deverá associar o CodeBuild a ele usando um dos métodos a seguir.
nota
É possível usar um alias ou nome de região para especificar um endpoint usando um SDK da AWS. Se você usar a AWS CLI, deverá usar o nome completo do endpoint.
Para conhecer os endpoints que podem ser usados com o CodeBuild, consulte CodeBuild regions and endpoints.
Tópicos
Especificar o endpoint do AWS CodeBuild (AWS CLI)
É possível usar a AWS CLI para especificar o endpoint por meio do qual o AWS CodeBuild é acessado usando o argumento --endpoint-url
em qualquer comando do CodeBuild. Por exemplo, execute esse comando para obter uma lista de nomes de compilação de projetos usando o endpoint do Federal Information Processing Standards (FIPS) na região do Leste dos EUA (Norte da Virgínia):
aws codebuild list-projects --endpoint-url https://codebuild-fips.us-east-1.amazonaws.com
Inclua https://
no início do endpoint.
O argumento --endpoint-url
da AWS CLI está disponível para todos os serviços da AWS. Para obter mais informações sobre esse e outros argumentos da AWS CLI, consulte AWS CLI Command Reference.
Especificar o endpoint do AWS CodeBuild (AWS SDK)
É possível usar um SDK da AWS para especificar o endpoint por meio do qual o AWS CodeBuild é acessado. Embora este exemplo use o SDK da AWS para Java
Use o método withEndpointConfiguration
ao criar o cliente AWSCodeBuild. Este é o formato a ser usado:
AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("endpoint
", "region
")).
withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
build();
Para obter informações sobre AWSCodeBuildClientBuilder
, consulte Class AWSCodeBuildClientBuilder.
As credenciais usadas em withCredentials
devem ser do tipo AWSCredentialsProvider
. Para obter mais informações, consulte Trabalhar com credenciais da AWS.
Não inclua https://
no início do endpoint.
Se você quiser especificar um endpoint diferente de FIPS, poderá usar a região, em vez do próprio endpoint. Por exemplo, para especificar o endpoint na região do Leste dos EUA (Norte da Virgínia), é possível usar us-east-1
em vez do nome completo do endpoint, codebuild.us-east-1.amazonaws.com
.
Se você quiser especificar um endpoint do FIPS, use um alias para simplificar o código. Somente endpoints do FIPS têm um alias. Outros endpoints devem ser especificados usando a região ou o nome completo.
A seguinte tabela indica o alias de cada um dos quatro endpoints do FIPS disponíveis:
Nome da região | Região | Endpoint | Alias |
---|---|---|---|
Leste dos EUA (N. da Virgínia) | us-east-1 | codebuild-fips.us-east-1.amazonaws.com | us-east-1-fips |
Leste dos EUA (Ohio) | us-east-2 | codebuild-fips.us-east-2.amazonaws.com | us-east-2-fips |
Oeste dos EUA (N. da Califórnia) | us-west-1 | codebuild-fips.us-west-1.amazonaws.com | us-west-1-fips |
Oeste dos EUA (Oregon) | us-west-2 | codebuild-fips.us-west-2.amazonaws.com | us-west-2-fips |
Para especificar o uso do endpoint do FIPS na região do Oeste dos EUA (Oregon) usando um alias:
AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("us-west-2-fips", "us-west-2")).
withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
build();
Para especificar o uso do endpoint diferente do FIPS na região do Leste dos EUA (Norte da Virgínia):
AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("us-east-1", "us-east-1")).
withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
build();
Para especificar o uso do endpoint diferente do FIPS na região da Ásia-Pacífico (Mumbai):
AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("ap-south-1", "ap-south-1")).
withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
build();