Spécification du point de terminaison AWS CodeBuild

Vous pouvez utiliser l'AWS Command Line Interface (AWS CLI) ou un des kits SDK AWS pour spécifier le point de terminaison utilisé par AWS CodeBuild. Il existe un point de terminaison pour chaque région dans laquelle CodeBuild est disponible. En plus d'un point de terminaison régional, quatre régions ont également un point de terminaison FIPS (Federal Information Processing Standards). Pour de plus amples informations sur les points de terminaison FIPS, veuillez consulter Présentation de FIPS 140-2.

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

Note

Vous pouvez utiliser un alias ou un nom de région pour spécifier un point de terminaison avec un kit de développement logiciel (SDK) AWS. Si vous utilisez l'AWS CLI, vous devez utiliser le nom de point de terminaison complet.

Pour connaître les points de terminaison pouvant être utilisés avec CodeBuild, veuillez consulter Régions et points de terminaison CodeBuild.

Spécification du point de terminaison AWS CodeBuild (AWS CLI)

Vous pouvez utiliser l'interface AWS CLI pour spécifier le point de terminaison via lequel AWS CodeBuild est accédé par l'intermédiaire de l'argument --endpoint-url dans n'importe quelle commande CodeBuild. Par exemple, exécutez cette commande pour obtenir la liste des noms de version du projet à l'aide du point de terminaison FIPS (Federal Information Processing Standards) 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'argument AWS CLI --endpoint-url est disponible pour tous les services AWS. Pour plus d'informations sur cetAWS CLI argument et sur d'autres, consultez AWS CLICommand Reference.

Spécification du point de terminaison AWS CodeBuild (kit SDK AWS)

Vous pouvez utiliser un kit de développement logiciel (SDK) AWS pour spécifier le point de terminaison via lequel AWS CodeBuild est accédé. Bien que cet exemple utilise le kit de développement logiciel (SDK) AWS pour Java, vous pouvez spécifier le point de terminaison avec les autres kits SDK AWS.

Utilisez lawithEndpointConfiguration méthode lors de la création duAWSCodeBuild 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 ClassAWSCodeBuildClientBuilder.

Les informations d'identification utilisées dans withCredentials doivent être de type AWSCredentialsProvider. Pour de plus amples informations, veuillez consulter Utilisation des informations d'identification AWS.

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

Si vous souhaitez spécifier un point de terminaison non conforme à la norme FIPS, vous pouvez utiliser la région plutôt que le point de terminaison. Par exemple, pour spécifier le point de terminaison dans la région USA Est (Virginie du Nord), vous pouvez utiliserus-east-1 au lieu du nom complet du point de terminaison,codebuild.us-east-1.amazonaws.com.

Si vous souhaitez spécifier un point de terminaison FIPS, vous pouvez utiliser un alias pour simplifier votre code. Seuls les points de terminaison FIPS 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 les alias pour chacun des quatre points de terminaison FIPS 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 point de terminaison FIPS dans la région USA Ouest (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 point de terminaison non FIPS dans la région USA Est (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 point de terminaison non FIPS 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();