Spécifiez le AWS CodeBuild point de terminaison

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) ou l'un des AWS SDKs pour spécifier le point de terminaison utilisé par AWS CodeBuild. Un point de terminaison CodeBuild est disponible pour chaque région. Outre un point de terminaison régional, quatre régions disposent également d'un point de terminaison des normes fédérales de traitement de l'information (FIPS). Pour plus d'informations sur les FIPS points de terminaison, consultez la section Présentation de FIPS140-2.

La spécification d'un point de terminaison est facultative. Si vous n'indiquez pas explicitement CodeBuild quel point de terminaison utiliser, le service utilise le point de terminaison associé à la région utilisée par votre AWS compte. CodeBuildne prend jamais par défaut un FIPS point de terminaison. Si vous souhaitez utiliser un FIPS point de terminaison, vous devez l' CodeBuild associer à l'aide de l'une des méthodes suivantes.

Note

Vous pouvez utiliser un alias ou un nom de région pour spécifier un point de terminaison à l'aide d'un AWS SDK. Si vous utilisez le AWS CLI, vous devez utiliser le nom complet du point de terminaison.

Pour les points de terminaison pouvant être utilisés avec CodeBuild, voir CodeBuild Régions et points de terminaison.

Spécifiez le AWS CodeBuild point de terminaison (AWS CLI)

Vous pouvez utiliser le AWS CLI pour spécifier le point de terminaison par lequel AWS CodeBuild on accède en utilisant l'--endpoint-urlargument dans n'importe quelle CodeBuild commande. Par exemple, exécutez cette commande pour obtenir une liste des noms de version de projet à l'aide du point de terminaison Federal Information Processing Standards (FIPS) dans la région USA Est (Virginie du Nord) :

aws codebuild list-projects --endpoint-url https://codebuild-fips.us-east-1.amazonaws.com

Incluez https:// au début du point de terminaison.

L'--endpoint-url AWS CLI argument est disponible pour tous les AWS services. Pour plus d'informations à ce sujet et sur d'autres AWS CLI arguments, consultez AWS CLI la section Référence des commandes.

Spécifiez le AWS CodeBuild point de terminaison (AWS SDK)

Vous pouvez utiliser an AWS SDK pour spécifier le point de terminaison par AWS CodeBuild lequel vous accédez. Bien que cet exemple utilise le AWS SDKpour Java, vous pouvez spécifier le point de terminaison avec l'autre AWS SDKs.

Utilisez withEndpointConfiguration cette méthode lors de la construction du AWSCodeBuild client. Voici le format à utiliser :

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
    withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("endpoint", "region")).
    withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
    build();
        

Pour plus d'informations surAWSCodeBuildClientBuilder, voir Classe AWSCodeBuildClientBuilder.

Les informations d'identification utilisées dans withCredentials doivent être de type AWSCredentialsProvider. Pour plus d'informations, consultez la section Utilisation des AWS informations d'identification.

N'incluez pas https:// au début du point de terminaison.

Si vous souhaitez spécifier un point de terminaison autre que le point de FIPS terminaison, vous pouvez utiliser la région au lieu du point de terminaison réel. Par exemple, pour spécifier le point de terminaison dans la région de l'est des États-Unis (Virginie du Nord), vous pouvez utiliser à la us-east-1 place du nom complet du point de terminaison,codebuild.us-east-1.amazonaws.com.

Si vous souhaitez spécifier un FIPS point de terminaison, vous pouvez utiliser un alias pour simplifier votre code. Seuls les FIPS points de terminaison ont un alias. Les autres points de terminaison doivent être spécifiés à l'aide de leur nom de région ou de leur nom complet.

Le tableau suivant répertorie l'alias de chacun des quatre FIPS points de terminaison disponibles :

Nom de la région	Région	Point de terminaison	Alias
US East (Virginie du Nord)	us-east-1	codebuild-fips.us-east-1.amazonaws.com	us-east-1-fips
USA Est (Ohio)	us-east-2	codebuild-fips.us-east-2.amazonaws.com	us-east-2-fips
USA Ouest (Californie du Nord)	us-west-1	codebuild-fips.us-west-1.amazonaws.com	us-west-1-fips
USA Ouest (Oregon)	us-west-2	codebuild-fips.us-west-2.amazonaws.com	us-west-2-fips

Pour spécifier l'utilisation du FIPS point de terminaison dans la région ouest des États-Unis (Oregon) à l'aide d'un alias :

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
    withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("us-west-2-fips", "us-west-2")).
    withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
    build();
    

Pour spécifier l'utilisation du FIPS non-point de terminaison dans la région de l'est des États-Unis (Virginie du Nord) :

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
    withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("us-east-1", "us-east-1")).
    withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
    build();
    

Pour spécifier l'utilisation du FIPS non-endpoint dans la région Asie-Pacifique (Mumbai) :

AWSCodeBuild awsCodeBuild = AWSCodeBuildClientBuilder.standard().
    withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration("ap-south-1", "ap-south-1")).
    withCredentials(new AWSStaticCredentialsProvider(sessionCredentials)).
    build();