Angeben des AWS CodeBuild-Endpunkts

Sie können die AWS Command Line Interface (AWS CLI) oder eines der AWS-SDKs verwenden, um den von AWS CodeBuild verwendeten Endpunkt anzugeben. Es ist ein Endpunkt für jede Region vorhanden, in der CodeBuild verfügbar ist. Zusätzlich zu einem regionalen Endpunkt, verfügen vier Regionen zudem über einen Endpunkt mit Federal Information Processing Standard (FIPS). Weitere Informationen zu FIPS-Endpunkten finden Sie unter FIPS 140-2-Übersicht.

Die Angabe eines Endpunkts ist optional. Wenn Sie nicht explizit angeben,CodeBuild welcher Endpunkt verwendet werden soll, verwendet der Dienst den Endpunkt, der der Region zugeordnet ist, die IhrAWS Konto verwendet. CodeBuildverwendet standardmäßig nie einen FIPS-Endpunkt. Wenn Sie einen FIPS-Endpunkt verwenden möchten, müssen Sie CodeBuild mit einer der folgenden Methoden diesem Endpunkt zuordnen.

Anmerkung

Sie können einen Alias oder einen Regionsnamen verwenden, um einen Endpunkt mit einem AWS-SDK anzugeben. Wenn Sie die AWS CLI nutzen, müssen Sie den vollständige Namen des Endpunkts verwenden.

Informationen zu Endpunkten, die mit CodeBuild verwendet werden können, finden Sie unter CodeBuild-Regionen und Endpunkte.

Angeben des AWS CodeBuild-Endpunkts (AWS CLI)

Mit der AWS CLI können Sie den Endpunkt angeben, über den mit dem --endpoint-url-Argument in einem beliebigen CodeBuild-Befehl auf AWS CodeBuild zugegriffen wird. Führen Sie beispielsweise diesen Befehl aus, um eine Liste der Projekt-Buildnamen (FIPS) in der Region USA Ost (Nord-Virginia) abzurufen:

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

Fügen Sie am Anfang des Endpunkts https:// ein.

Das AWS CLI-Argument --endpoint-url steht allen AWS-Services zur Verfügung. Weitere Informationen zu diesen und anderenAWS CLI Argumenten finden Sie unter AWS CLIBefehlsreferenz.

Angeben des AWS CodeBuild-Endpunkts (AWS SDK)

Sie können den Endpunkt für den Zugriff auf AWS CodeBuild mithilfe eines AWS-SDKs angeben. Obwohl in diesem Beispiel das AWS-SDK für Java verwendet wird, können Sie den Endpunkt mit den anderen AWS-SDKs angeben.

Verwenden Sie diewithEndpointConfiguration Methode, wenn Sie denAWSCodeBuild Client erstellen. Verwenden Sie dieses Format:

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

InformationenAWSCodeBuildClientBuilder dazu finden Sie unter KlasseAWSCodeBuildClientBuilder.

Die in withCredentials verwendeten Anmeldeinformationen müssen vom Typ AWSCredentialsProvider sein. Weitere Informationen finden Sie unter Arbeiten mit AWS-Anmeldeinformationen.

Fügen Sie am Anfang des Endpunkts kein https:// ein.

Wenn Sie einen Endpunkt ohne FIPS angeben möchten, können Sie die Region anstelle des tatsächlichen Endpunkts verwenden. Um beispielsweise den Endpunkt in der Region USA Ost (Nord-Virginia) anzugeben, können Sieus-east-1 anstelle des vollständigen Endpunktes den Namen, verwendencodebuild.us-east-1.amazonaws.com.

Wenn Sie einen FIPS-Endpunkt angeben möchten, können Sie Ihren Code mit einem Alias vereinfachen. Nur FIPS-Endpunkte verfügen über einen Alias. Andere Endpunkte müssen mithilfe ihrer Region oder des vollständigen Namens angegeben werden.

In der folgenden Tabelle werden die Alias für jeden der vier verfügbaren FIPS-Endpunkte aufgeführt:

Name der Region	Region	Endpunkt	Alias
USA Ost (Nord-Virginia)	us-east-1	codebuild-fips.us-east-1.amazonaws.com	us-east-1-fips
USA Ost (Ohio)	us-east-2	codebuild-fips.us-east-2.amazonaws.com	us-east-2-fips
USA West (Nordkalifornien)	us-west-1	codebuild-fips.us-west-1.amazonaws.com	us-west-1-fips
USA West (Oregon)	us-west-2	codebuild-fips.us-west-2.amazonaws.com	us-west-2-fips

Um die Verwendung des FIPS Endpunktes in der Region USA West (Oregon) mit einem Alias zu spezifizieren:

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

Um die Verwendung des Nicht-FIPS Endpunktes in der Region USA Ost (Nord-Virginia) zu spezifizieren, gehen Sie wie folgt vor:

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

Um die Verwendung des Nicht-FIPS Endpunktes in der Region Asien-Pazifik (Mumbai) zu spezifizieren:

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