Beispiele für die Verwendung der AWS CLI mit CodeCommit - AWS Command Line Interface

Beispiele für die Verwendung der AWS CLI mit CodeCommit

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit CodeCommit nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie associate-approval-rule-template-with-repository verwendet wird.

AWS CLI

So ordnen Sie eine Genehmigungsregelvorlage einem Repository zu

Im folgenden associate-approval-rule-template-with-repository-Beispiel wird die angegebene Genehmigungsregelvorlage einem Repository mit dem Namen MyDemoRepo zugeordnet.

aws codecommit associate-approval-rule-template-with-repository \ --repository-name MyDemoRepo \ --approval-rule-template-name 2-approver-rule-for-main

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Zuordnen einer Genehmigungsregelvorlage zu einem Repository im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie batch-associate-approval-rule-template-with-repositories verwendet wird.

AWS CLI

So ordnen Sie eine Genehmigungsregelvorlage mehreren Repositorys in einem einzigen Vorgang zu

Im folgenden batch-associate-approval-rule-template-with-repositories-Beispiel wird die angegebene Genehmigungsregelvorlage Repositorys mit den Namen MyDemoRepo und MyOtherDemoRepo zugeordnet.

Hinweis: Genehmigungsregelvorlagen sind für die AWS-Region spezifisch, in der sie erstellt werden. Sie können nur Repositorys in dieser AWS-Region zugeordnet werden.

aws codecommit batch-associate-approval-rule-template-with-repositories \ --repository-names MyDemoRepo, MyOtherDemoRepo \ --approval-rule-template-name 2-approver-rule-for-main

Ausgabe:

{ "associatedRepositoryNames": [ "MyDemoRepo", "MyOtherDemoRepo" ], "errors": [] }

Weitere Informationen finden Sie unter Zuordnen einer Genehmigungsregelvorlage zu einem Repository im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie batch-describe-merge-conflicts verwendet wird.

AWS CLI

So rufen Sie Informationen zu Zusammenführungskonflikten in allen Dateien und einem Teilsatz von Dateien in einer Zusammenführung zwischen zwei Commit-Spezifizierern ab

Im folgenden batch-describe-merge-conflicts-Beispiel werden die Zusammenführungskonflikte beim Zusammenführen des Quell-Branches feature-randomizationfeature mit dem Ziel-Branch main mithilfe der THREE_WAY_MERGE-Strategie in einem Repository mit dem Namen MyDemoRepo ermittelt.

aws codecommit batch-describe-merge-conflicts \ --source-commit-specifier feature-randomizationfeature \ --destination-commit-specifier main \ --merge-option THREE_WAY_MERGE \ --repository-name MyDemoRepo

Ausgabe:

{ "conflicts": [ { "conflictMetadata": { "filePath": "readme.md", "fileSizes": { "source": 139, "destination": 230, "base": 85 }, "fileModes": { "source": "NORMAL", "destination": "NORMAL", "base": "NORMAL" }, "objectTypes": { "source": "FILE", "destination": "FILE", "base": "FILE" }, "numberOfConflicts": 1, "isBinaryFile": { "source": false, "destination": false, "base": false }, "contentConflict": true, "fileModeConflict": false, "objectTypeConflict": false, "mergeOperations": { "source": "M", "destination": "M" } }, "mergeHunks": [ { "isConflict": true, "source": { "startLine": 0, "endLine": 3, "hunkContent": "VGhpcyBpEXAMPLE==" }, "destination": { "startLine": 0, "endLine": 1, "hunkContent": "VXNlIHRoEXAMPLE=" } } ] } ], "errors": [], "destinationCommitId": "86958e0aEXAMPLE", "sourceCommitId": "6ccd57fdEXAMPLE", "baseCommitId": "767b6958EXAMPLE" }

Weitere Informationen finden Sie unter Lösen von Konflikten in einer Pull-Anforderung im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie batch-disassociate-approval-rule-template-from-repositories verwendet wird.

AWS CLI

So heben Sie die Zuordnung einer Genehmigungsregelvorlage für Repositorys in einem einzigen Vorgang auf

Im folgenden batch-disassociate-approval-rule-template-from-repositories-Beispiel wird die Zuordnung der angegebenen Genehmigungsregelvorlage für die Repositorys mit den Namen MyDemoRepo und MyOtherDemoRepo aufgehoben.

aws codecommit batch-disassociate-approval-rule-template-from-repositories \ --repository-names MyDemoRepo, MyOtherDemoRepo \ --approval-rule-template-name 1-approval-rule-for-all pull requests

Ausgabe:

{ "disassociatedRepositoryNames": [ "MyDemoRepo", "MyOtherDemoRepo" ], "errors": [] }

Weitere Informationen finden Sie unter Aufheben der Zuordnung einer Genehmigungsregelvorlage im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie batch-get-commits verwendet wird.

AWS CLI

So zeigen Sie Informationen zu mehreren Commits an

Im folgenden batch-get-commits-Beispiel werden die Details zu den angegebenen Commits angezeigt.

aws codecommit batch-get-commits \ --repository-name MyDemoRepo \ --commit-ids 317f8570EXAMPLE 4c925148EXAMPLE

Ausgabe:

{ "commits": [ { "additionalData": "", "committer": { "date": "1508280564 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "author": { "date": "1508280564 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "commitId": "317f8570EXAMPLE", "treeId": "1f330709EXAMPLE", "parents": [ "6e147360EXAMPLE" ], "message": "Change variable name and add new response element" }, { "additionalData": "", "committer": { "date": "1508280542 -0800", "name": "Li Juan", "email": "li_juan@example.com" }, "author": { "date": "1508280542 -0800", "name": "Li Juan", "email": "li_juan@example.com" }, "commitId": "4c925148EXAMPLE", "treeId": "1f330709EXAMPLE", "parents": [ "317f8570EXAMPLE" ], "message": "Added new class" } }

Weitere Informationen finden Sie unter Anzeigen von Commit-Details im AWS-CodeCommit-Benutzerhandbuch.

  • API-Details finden Sie unter BatchGetCommits in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie batch-get-repositories verwendet wird.

AWS CLI

So zeigen Sie Details zu mehreren -Repositorys; an

Dieses Beispiel zeigt Details zu mehreren AWS-CodeCommit-Repositorys.

aws codecommit batch-get-repositories \ --repository-names MyDemoRepo MyOtherDemoRepo

Ausgabe:

{ "repositoriesNotFound": [], "repositories": [ { "creationDate": 1429203623.625, "defaultBranch": "main", "repositoryName": "MyDemoRepo", "cloneUrlSsh": "ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo", "lastModifiedDate": 1430783812.0869999, "repositoryDescription": "My demonstration repository", "cloneUrlHttp": "https://codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo", "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", "Arn": "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo" "accountId": "111111111111" }, { "creationDate": 1429203623.627, "defaultBranch": "main", "repositoryName": "MyOtherDemoRepo", "cloneUrlSsh": "ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyOtherDemoRepo", "lastModifiedDate": 1430783812.0889999, "repositoryDescription": "My other demonstration repository", "cloneUrlHttp": "https://codecommit.us-east-2.amazonaws.com/v1/repos/MyOtherDemoRepo", "repositoryId": "cfc29ac4-b0cb-44dc-9990-f6f51EXAMPLE", "Arn": "arn:aws:codecommit:us-east-2:111111111111:MyOtherDemoRepo" "accountId": "111111111111" } ], "repositoriesNotFound": [] }

Das folgende Codebeispiel zeigt, wie create-approval-rule-template verwendet wird.

AWS CLI

So erstellen Sie eine Genehmigungsregelvorlage

Im folgenden create-approval-rule-template-Beispiel wird eine Genehmigungsregelvorlage mit dem Namen 2-approver-rule-for-main ``. The template requires two users who assume the role of ``CodeCommitReview erstellt, um alle Pull-Anforderungen vor der Zusammenführung mit dem main-Branch zu genehmigen.

aws codecommit create-approval-rule-template \ --approval-rule-template-name 2-approver-rule-for-main \ --approval-rule-template-description "Requires two developers from the team to approve the pull request if the destination branch is main" \ --approval-rule-template-content "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}"

Ausgabe:

{ "approvalRuleTemplate": { "approvalRuleTemplateName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "approvalRuleTemplateId": "dd8b17fe-EXAMPLE", "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "approvalRuleTemplateDescription": "Requires two developers from the team to approve the pull request if the destination branch is main", "lastModifiedDate": 1571356106.936, "ruleContentSha256": "4711b576EXAMPLE" } }

Weitere Informationen finden Sie unter Erstellen einer Genehmigungsregelvorlage im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie create-branch verwendet wird.

AWS CLI

So erstellen Sie einen Branch

In diesem Beispiel wird ein Branch in einem AWS-CodeCommit-Repository erstellt. Dieser Befehl liefert nur eine Ausgabe, wenn Fehler aufgetreten sind.

Befehl:

aws codecommit create-branch --repository-name MyDemoRepo --branch-name MyNewBranch --commit-id 317f8570EXAMPLE

Ausgabe:

None.
  • API-Details finden Sie unter CreateBranch in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-commit verwendet wird.

AWS CLI

So erstellen Sie einen Commit

Im folgenden create-commit-Beispiel wird gezeigt, wie Sie einen anfänglichen Commit für ein Repository erstellen, durch den eine readme.md-Datei zu einem Repository mit dem Namen MyDemoRepo im Branch main hinzugefügt wird.

aws codecommit create-commit \ --repository-name MyDemoRepo \ --branch-name main \ --put-files "filePath=readme.md,fileContent='Welcome to our team repository.'"

Ausgabe:

{ "filesAdded": [ { "blobId": "5e1c309d-EXAMPLE", "absolutePath": "readme.md", "fileMode": "NORMAL" } ], "commitId": "4df8b524-EXAMPLE", "treeId": "55b57003-EXAMPLE", "filesDeleted": [], "filesUpdated": [] }

Weitere Informationen finden Sie unter Erstellen eines Commits in AWS CodeCommit im AWS-CodeCommit-Benutzerhandbuch.

  • API-Details finden Sie unter CreateCommit in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-pull-request-approval-rule verwendet wird.

AWS CLI

So erstellen Sie eine Genehmigungsregel für eine Pull-Anforderung

Im folgenden create-pull-request-approval-rule-Beispiel wird eine Genehmigungsregel namens Require two approved approvers für die angegebene Pull-Anforderung erstellt. Die Regel gibt an, dass zwei Genehmigungen aus einem Genehmigungs-Pool erforderlich sind. Der Pool enthält alle Benutzer, die auf CodeCommit zugreifen, indem sie die Rolle CodeCommitReview im AWS-Konto 123456789012 annehmen. Er enthält außerdem entweder einen IAM-Benutzer oder einen Verbundbenutzer namens Nikhil_Jayashankar aus demselben AWS-Konto.

aws codecommit create-pull-request-approval-rule \ --approval-rule-name "Require two approved approvers" \ --approval-rule-content "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"CodeCommitApprovers:123456789012:Nikhil_Jayashankar\", \"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}"

Ausgabe:

{ "approvalRule": { "approvalRuleName": "Require two approved approvers", "lastModifiedDate": 1570752871.932, "ruleContentSha256": "7c44e6ebEXAMPLE", "creationDate": 1570752871.932, "approvalRuleId": "aac33506-EXAMPLE", "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"CodeCommitApprovers:123456789012:Nikhil_Jayashankar\", \"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major" } }

Weitere Informationen finden Sie unter Erstellen einer Genehmigungsregel im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie create-pull-request verwendet wird.

AWS CLI

So erstellen Sie eine Pull-Anforderung

Im folgenden create-pull-request-Beispiel wird eine Pull-Anforderung mit dem Namen „Pronunciation Difficulty Analyzer“ mit der Beschreibung „Please review these changes by Tuesday“ erstellt. Diese zielt auf den Quell-Branch „jane-branch“ ab und soll mit dem Standard-Branch „main“ in einem AWS-CodeCommit-Repository namens „MyDemoRepo“ zusammengeführt werden.

aws codecommit create-pull-request \ --title "My Pull Request" \ --description "Please review these changes by Tuesday" \ --client-request-token 123Example \ --targets repositoryName=MyDemoRepo,sourceReference=MyNewBranch

Ausgabe:

{ "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "originApprovalRuleTemplate": { "approvalRuleTemplateId": "dd3d22fe-EXAMPLE", "approvalRuleTemplateName": "2-approver-rule-for-main" }, "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::111111111111:user/Jane_Doe", "description": "Please review these changes by Tuesday", "title": "Pronunciation difficulty analyzer", "pullRequestTargets": [ { "destinationCommit": "5d036259EXAMPLE", "destinationReference": "refs/heads/main", "repositoryName": "MyDemoRepo", "sourceCommit": "317f8570EXAMPLE", "sourceReference": "refs/heads/jane-branch", "mergeMetadata": { "isMerged": false } } ], "lastActivityDate": 1508962823.285, "pullRequestId": "42", "clientRequestToken": "123Example", "pullRequestStatus": "OPEN", "creationDate": 1508962823.285 } }

Das folgende Codebeispiel zeigt, wie create-repository verwendet wird.

AWS CLI

So erstellen Sie ein Repository

In diesem Beispiel wird ein Repository erstellt und dem AWS-Konto des Benutzers zugeordnet.

Befehl:

aws codecommit create-repository --repository-name MyDemoRepo --repository-description "My demonstration repository"

Ausgabe:

{ "repositoryMetadata": { "repositoryName": "MyDemoRepo", "cloneUrlSsh": "ssh://git-codecommit.us-east-1.amazonaws.com/v1/repos/MyDemoRepo", "lastModifiedDate": 1444766838.027, "repositoryDescription": "My demonstration repository", "cloneUrlHttp": "https://git-codecommit.us-east-1.amazonaws.com/v1/repos/MyDemoRepo", "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", "Arn": "arn:aws:codecommit:us-east-1:111111111111EXAMPLE:MyDemoRepo", "accountId": "111111111111" } }

Das folgende Codebeispiel zeigt, wie create-unreferenced-merge-commit verwendet wird.

AWS CLI

So erstellen Sie einen unreferenzierten Commit, der das Ergebnis des Zusammenführens von zwei Commit-Spezifizierern repräsentiert

Im folgenden create-unreferenced-merge-commit-Beispiel wird ein Commit erstellt, der die Ergebnisse einer Zusammenführung zwischen dem Quell-Branch bugfix-1234 und dem Ziel-Branch main mithilfe der THREE_WAY_MERGE-Strategie im Repository MyDemoRepo darstellt.

aws codecommit create-unreferenced-merge-commit \ --source-commit-specifier bugfix-1234 \ --destination-commit-specifier main \ --merge-option THREE_WAY_MERGE \ --repository-name MyDemoRepo \ --name "Maria Garcia" \ --email "maria_garcia@example.com" \ --commit-message "Testing the results of this merge."

Ausgabe:

{ "commitId": "4f178133EXAMPLE", "treeId": "389765daEXAMPLE" }

Weitere Informationen finden Sie unter Lösen von Konflikten in einer Pull-Anforderung im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie credential-helper verwendet wird.

AWS CLI

So richten Sie den in der AWS-CLI enthaltenen Credential Helper mit AWS CodeCommit ein

Das credential-helper-Dienstprogramm ist nicht dafür konzipiert, direkt über die AWS-CLI aufgerufen zu werden. Stattdessen soll es als Parameter mit dem git config-Befehl zum Einrichten Ihres lokalen Computers verwendet werden. Dies ermöglicht Git, HTTPS und eine kryptografisch signierte Version Ihrer IAM-Benutzeranmeldeinformationen oder Amazon EC2-Instance-Rolle zu verwenden, wenn Git sich in AWS authentifizieren muss, um mit CodeCommit-Repositorys zu interagieren.

git config --global credential.helper '!aws codecommit credential-helper $@' git config --global credential.UseHttpPath true

Ausgabe:

[credential] helper = !aws codecommit credential-helper $@ UseHttpPath = true

Weitere Informationen finden Sie unter „Einrichten der Verwendung anderer Methoden“ für AWS CodeCommit im AWS-CodeCommit-Benutzerhandbuch. Lesen Sie den Inhalt sorgfältig durch und folgen Sie dann der Anleitung in einem der folgenden Themen: für HTTPS-Verbindungen auf Linux, macOS oder Unix oder für HTTPS-Verbindungen unter Windows im AWS-CodeCommit-Benutzerhandbuch.

  • API-Details finden Sie unter CredentialHelper in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-approval-rule-template verwendet wird.

AWS CLI

So löschen Sie eine Genehmigungsregelvorlage

Im folgenden Beispiel für delete-approval-rule-template wird die angegebene Genehmigungsregelvorlage gelöscht.

aws codecommit delete-approval-rule-template \ --approval-rule-template-name 1-approver-for-all-pull-requests

Ausgabe:

{ "approvalRuleTemplateId": "41de97b7-EXAMPLE" }

Weitere Informationen finden Sie unter Löschen einer Genehmigungsregelvorlage im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie delete-branch verwendet wird.

AWS CLI

So löschen Sie einen Branch

Dieses Beispiel veranschaulicht, wie Sie einen Branch in einem AWS-CodeCommit-Repository löschen.

Befehl:

aws codecommit delete-branch --repository-name MyDemoRepo --branch-name MyNewBranch

Ausgabe:

{ "branch": { "commitId": "317f8570EXAMPLE", "branchName": "MyNewBranch" } }
  • API-Details finden Sie unter DeleteBranch in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-comment-content verwendet wird.

AWS CLI

So löschen Sie den Inhalt eines Kommentars

Sie können den Inhalt eines Kommentars nur löschen, wenn Sie den Kommentar selbst erstellt haben. Dieses Beispiel zeigt, wie der Inhalt eines Kommentars mit der vom System generierten ID ff30b348EXAMPLEb9aa670f gelöscht wird.

aws codecommit delete-comment-content \ --comment-id ff30b348EXAMPLEb9aa670f

Ausgabe:

{ "comment": { "creationDate": 1508369768.142, "deleted": true, "lastModifiedDate": 1508369842.278, "clientRequestToken": "123Example", "commentId": "ff30b348EXAMPLEb9aa670f", "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "callerReactions": [], "reactionCounts": { "CLAP" : 1 } } }

Das folgende Codebeispiel zeigt, wie delete-file verwendet wird.

AWS CLI

Löschen Sie eine Datei wie folgt

Das folgende delete-file-Beispiel zeigt, wie eine Datei mit dem Namen README.md aus dem Branch main mit der neuesten Commit-ID c5709475EXAMPLE in einem Repository mit dem Namen MyDemoRepo gelöscht wird.

aws codecommit delete-file \ --repository-name MyDemoRepo \ --branch-name main \ --file-path README.md \ --parent-commit-id c5709475EXAMPLE

Ausgabe:

{ "blobId":"559b44fEXAMPLE", "commitId":"353cf655EXAMPLE", "filePath":"README.md", "treeId":"6bc824cEXAMPLE" }

Weitere Informationen finden Sie unter Bearbeiten oder Löschen einer Datei in AWS CodeCommit im API-Referenzhandbuch zu AWS CodeCommit.

  • API-Details finden Sie unter DeleteFile in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-pull-request-approval-rule verwendet wird.

AWS CLI

So löschen Sie eine Genehmigungsregel für eine Pull-Anforderung

Im folgenden delete-pull-request-approval-rule-Beispiel wird eine Genehmigungsregel namens My Approval Rule für die angegebene Pull-Anforderung gelöscht.

aws codecommit delete-pull-request-approval-rule \ --approval-rule-name "My Approval Rule" \ --pull-request-id 15

Ausgabe:

{ "approvalRuleId": "077d8e8a8-EXAMPLE" }

Weitere Informationen finden Sie unter Bearbeiten oder Löschen einer Genehmigungsregel im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie delete-repository verwendet wird.

AWS CLI

So löschen Sie ein Repository

Dieses Beispiel veranschaulicht, wie Sie ein AWS-CodeCommit-Repository löschen.

Befehl:

aws codecommit delete-repository --repository-name MyDemoRepo

Ausgabe:

{ "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE" }

Das folgende Codebeispiel zeigt, wie describe-merge-conflicts verwendet wird.

AWS CLI

So rufen Sie detaillierte Informationen zu Konflikten beim Zusammenführen ab

Im folgenden describe-merge-conflicts-Beispiel werden die Zusammenführungskonflikte für eine Datei namens readme.md im angegebenen Quell- und Ziel-Branch mithilfe der THREE_WAY_MERGE-Strategie ermittelt.

aws codecommit describe-merge-conflicts \ --source-commit-specifier feature-randomizationfeature \ --destination-commit-specifier main \ --merge-option THREE_WAY_MERGE \ --file-path readme.md \ --repository-name MyDemoRepo

Ausgabe:

{ "conflictMetadata": { "filePath": "readme.md", "fileSizes": { "source": 139, "destination": 230, "base": 85 }, "fileModes": { "source": "NORMAL", "destination": "NORMAL", "base": "NORMAL" }, "objectTypes": { "source": "FILE", "destination": "FILE", "base": "FILE" }, "numberOfConflicts": 1, "isBinaryFile": { "source": false, "destination": false, "base": false }, "contentConflict": true, "fileModeConflict": false, "objectTypeConflict": false, "mergeOperations": { "source": "M", "destination": "M" } }, "mergeHunks": [ { "isConflict": true, "source": { "startLine": 0, "endLine": 3, "hunkContent": "VGhpcyBpEXAMPLE=" }, "destination": { "startLine": 0, "endLine": 1, "hunkContent": "VXNlIHRoEXAMPLE=" } } ], "destinationCommitId": "86958e0aEXAMPLE", "sourceCommitId": "6ccd57fdEXAMPLE", "baseCommitId": "767b69580EXAMPLE" }

Weitere Informationen finden Sie unter Lösen von Konflikten in einer Pull-Anforderung im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie describe-pull-request-events verwendet wird.

AWS CLI

So zeigen Sie Ereignisse in einer Pull-Anforderung an

Im folgenden describe-pull-request-events-Beispiel werden die Ereignisse für eine Pull-Anforderung mit der ID „8“ abgerufen.

aws codecommit describe-pull-request-events --pull-request-id 8

Ausgabe:

{ "pullRequestEvents": [ { "pullRequestId": "8", "pullRequestEventType": "PULL_REQUEST_CREATED", "eventDate": 1510341779.53, "actor": "arn:aws:iam::111111111111:user/Zhang_Wei" }, { "pullRequestStatusChangedEventMetadata": { "pullRequestStatus": "CLOSED" }, "pullRequestId": "8", "pullRequestEventType": "PULL_REQUEST_STATUS_CHANGED", "eventDate": 1510341930.72, "actor": "arn:aws:iam::111111111111:user/Jane_Doe" } ] }

Das folgende Codebeispiel zeigt, wie disassociate-approval-rule-template-from-repository verwendet wird.

AWS CLI

So heben Sie die Zuordnung einer Genehmigungsregelvorlage zu einem Repository auf

Im folgenden disassociate-approval-rule-template-from-repository-Beispiel wird die Zuordnung zwischen der angegebenen Genehmigungsregelvorlage und dem Repository MyDemoRepo aufgehoben.

aws codecommit disassociate-approval-rule-template-from-repository \ --repository-name MyDemoRepo \ --approval-rule-template-name 1-approver-rule-for-all-pull-requests

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Aufheben der Zuordnung einer Genehmigungsregelvorlage im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie evaluate-pull-request-approval-rules verwendet wird.

AWS CLI

So bewerten Sie, ob für eine Pull-Anforderung alle Genehmigungsregeln erfüllt sind

Im folgenden evaluate-pull-request-approval-rules-Beispiel wird der Status der Genehmigungsregeln für die angegebene Pull-Anforderung ausgewertet. In diesem Beispiel wurde eine Genehmigungsregel für die Pull-Anforderung nicht erfüllt, sodass die Ausgabe des Befehls den approved-Wert false anzeigt.

aws codecommit evaluate-pull-request-approval-rules \ --pull-request-id 27 \ --revision-id 9f29d167EXAMPLE

Ausgabe:

{ "evaluation": { "approved": false, "approvalRulesNotSatisfied": [ "Require two approved approvers" ], "overridden": false, "approvalRulesSatisfied": [] } }

Weitere Informationen finden Sie unter Zusammenführen einer Pull-Anforderung im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie get-approval-rule-template verwendet wird.

AWS CLI

So rufen Sie den Inhalt einer Genehmigungsregelvorlage ab

Im folgenden get-approval-rule-template-Beispiel wird der Inhalt einer Genehmigungsregelvorlage mit dem Namen 1-approver-rule-for-all-pull-requests abgerufen.

aws codecommit get-approval-rule-template \ --approval-rule-template-name 1-approver-rule-for-all-pull-requests

Ausgabe:

{ "approvalRuleTemplate": { "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "ruleContentSha256": "621181bbEXAMPLE", "lastModifiedDate": 1571356106.936, "creationDate": 1571356106.936, "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests", "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan", "approvalRuleTemplateId": "a29abb15-EXAMPLE", "approvalRuleTemplateDescription": "All pull requests must be approved by one developer on the team." } }

Weitere Informationen finden Sie unter Verwalten von Genehmigungsregelvorlagen im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie get-blob verwendet wird.

AWS CLI

So zeigen Sie Informationen zu einem Git-Blob an

Im folgenden get-blob-Beispiel werden Informationen über einen Git-Blob mit der ID „2eb4af3bEXAMPLE“ in einem AWS-CodeCommit-Repository namens „MyDemoRepo“ abgerufen.

aws codecommit get-blob --repository-name MyDemoRepo --blob-id 2eb4af3bEXAMPLE

Ausgabe:

{ "content": "QSBCaW5hcnkgTGFyToEXAMPLE=" }
  • API-Details finden Sie unter GetBlob in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-branch verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem Branch ab

In diesem Beispiel werden Informationen zu einem Branch in einem AWS-CodeCommit-Repository abgerufen.

Befehl:

aws codecommit get-branch --repository-name MyDemoRepo --branch-name MyNewBranch

Ausgabe:

{ "BranchInfo": { "commitID": "317f8570EXAMPLE", "branchName": "MyNewBranch" } }
  • API-Details finden Sie unter GetBranch in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-comment-reactions verwendet wird.

AWS CLI

So zeigen Sie Emoji-Reaktionen auf einen Kommentar an

Das folgende get-comment-reactions-Beispiel listet alle Emoji-Reaktionen auf einen Kommentar mit der ID abcd1234EXAMPLEb5678efgh auf. Wenn die Schriftart für Ihre Shell die Anzeige von Emoji-Version 1.0 unterstützt, wird das Emoji in der Ausgabe für emoji angezeigt.

aws codecommit get-comment-reactions \ --comment-id abcd1234EXAMPLEb5678efgh

Ausgabe:

{ "reactionsForComment": { [ { "reaction": { "emoji:"??", "shortCode": "thumbsup", "unicode": "U+1F44D" }, "users": [ "arn:aws:iam::123456789012:user/Li_Juan", "arn:aws:iam::123456789012:user/Mary_Major", "arn:aws:iam::123456789012:user/Jorge_Souza" ] }, { "reaction": { "emoji": "??", "shortCode": "thumbsdown", "unicode": "U+1F44E" }, "users": [ "arn:aws:iam::123456789012:user/Nikhil_Jayashankar" ] }, { "reaction": { "emoji": "??", "shortCode": "confused", "unicode": "U+1F615" }, "users": [ "arn:aws:iam::123456789012:user/Saanvi_Sarkar" ] } ] } }

Weitere Informationen finden Sie unter Kommentar zu einem Commit in AWS CodeCommit im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie get-comment verwendet wird.

AWS CLI

So zeigen Sie Details zu einem Kommentar an

Dieses Beispiel zeigt, wie Details eines Kommentars mit der vom System generierten ID ff30b348EXAMPLEb9aa670f angezeigt werden.

aws codecommit get-comment \ --comment-id ff30b348EXAMPLEb9aa670f

Ausgabe:

{ "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "ff30b348EXAMPLEb9aa670f", "content": "Whoops - I meant to add this comment to the line, but I don't see how to delete it.", "creationDate": 1508369768.142, "deleted": false, "commentId": "", "lastModifiedDate": 1508369842.278, "callerReactions": [], "reactionCounts": { "SMILE" : 6, "THUMBSUP" : 1 } } }
  • API-Details finden Sie unter GetComment in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-comments-for-compared-commit verwendet wird.

AWS CLI

So zeigen Sie Kommentare zu einem Commit an

Dieses Beispiel zeigt, wie Sie Kommentare zu dem Vergleich zwischen zwei Commits in einem Repository mit dem Namen MyDemoRepo anzeigen.

aws codecommit get-comments-for-compared-commit \ --repository-name MyDemoRepo \ --before-commit-ID 6e147360EXAMPLE \ --after-commit-id 317f8570EXAMPLE

Ausgabe:

{ "commentsForComparedCommitData": [ { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "317f8570EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "6e147360EXAMPLE", "comments": [ { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "ff30b348EXAMPLEb9aa670f", "content": "Whoops - I meant to add this comment to the line, not the file, but I don't see how to delete it.", "creationDate": 1508369768.142, "deleted": false, "CommentId": "123abc-EXAMPLE", "lastModifiedDate": 1508369842.278, "callerReactions": [], "reactionCounts": { "SMILE" : 6, "THUMBSUP" : 1 } }, { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "553b509bEXAMPLE56198325", "content": "Can you add a test case for this?", "creationDate": 1508369612.240, "deleted": false, "commentId": "456def-EXAMPLE", "lastModifiedDate": 1508369612.240, "callerReactions": [], "reactionCounts": { "THUMBSUP" : 2 } } ], "location": { "filePath": "cl_sample.js", "filePosition": 1232, "relativeFileVersion": "after" }, "repositoryName": "MyDemoRepo" } ], "nextToken": "exampleToken" }

Das folgende Codebeispiel zeigt, wie get-comments-for-pull-request verwendet wird.

AWS CLI

So zeigen Sie Kommentare zu einer Pull-Anforderung an

Dieses Beispiel zeigt, wie Sie Kommentare für eine Pull-Anforderung in einem Repository mit dem Namen MyDemoRepo anzeigen.

aws codecommit get-comments-for-pull-request \ --repository-name MyDemoRepo \ --before-commit-ID 317f8570EXAMPLE \ --after-commit-id 5d036259EXAMPLE

Ausgabe:

{ "commentsForPullRequestData": [ { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "5d036259EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "317f8570EXAMPLE", "comments": [ { "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", "clientRequestToken": "", "commentId": "abcd1234EXAMPLEb5678efgh", "content": "These don't appear to be used anywhere. Can we remove them?", "creationDate": 1508369622.123, "deleted": false, "lastModifiedDate": 1508369622.123, "callerReactions": [], "reactionCounts": { "THUMBSUP" : 6, "CONFUSED" : 1 } }, { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "commentId": "442b498bEXAMPLE5756813", "content": "Good catch. I'll remove them.", "creationDate": 1508369829.104, "deleted": false, "lastModifiedDate": 150836912.273, "callerReactions": ["THUMBSUP"] "reactionCounts": { "THUMBSUP" : 14 } } ], "location": { "filePath": "ahs_count.py", "filePosition": 367, "relativeFileVersion": "AFTER" }, "repositoryName": "MyDemoRepo", "pullRequestId": "42" } ], "nextToken": "exampleToken" }

Das folgende Codebeispiel zeigt, wie get-commit verwendet wird.

AWS CLI

So zeigen Sie Informationen zu einem Commit in einem Repository an

Dieses Beispiel zeigt Details zu einem Commit mit der vom System generierten ID „7e9fd3091thisisanexamplethisisanexample1“ in einem AWS-CodeCommit-Repository namens „MyDemoRepo“.

Befehl:

aws codecommit get-commit --repository-name MyDemoRepo --commit-id 7e9fd3091thisisanexamplethisisanexample1

Ausgabe:

{ "commit": { "additionalData": "", "committer": { "date": "1484167798 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "author": { "date": "1484167798 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "treeId": "347a3408thisisanexampletreeidexample", "parents": [ "7aa87a031thisisanexamplethisisanexample1" ], "message": "Fix incorrect variable name" } }
  • API-Details finden Sie unter GetCommit in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-differences verwendet wird.

AWS CLI

So rufen Sie Informationen zu Unterschieden für einen Commit-Spezifizierer in einem Repository ab

Dieses Beispiel zeigt, wie Sie Metadateninformationen zu Änderungen zwischen zwei Commit-Spezifizierern (Branch, Tag, HEAD oder andere vollqualifizierte Referenzen wie Commit-IDs) in einem umbenannten Ordner im AWS-CodeCommit-Repository „MyDemoRepo“ anzeigen. Das Beispiel enthält mehrere Optionen, die nicht erforderlich sind, darunter „--before-commit-specifier“, „--before-path“ und „--after-path“, um besser zu veranschaulichen, wie Sie diese Optionen verwenden können, um die Ergebnisse einzuschränken. Die Antwort beinhaltet Dateimodus-Berechtigungen.

Befehl:

aws codecommit get-differences --repository-name MyDemoRepo --before-commit-specifier 955bba12thisisanexamplethisisanexample --after-commit-specifier 14a95463thisisanexamplethisisanexample --before-path tmp/example-folder --after-path tmp/renamed-folder

Ausgabe:

{ "differences": [ { "afterBlob": { "path": "blob.txt", "blobId": "2eb4af3b1thisisanexamplethisisanexample1", "mode": "100644" }, "changeType": "M", "beforeBlob": { "path": "blob.txt", "blobId": "bf7fcf281thisisanexamplethisisanexample1", "mode": "100644" } } ] }
  • API-Details finden Sie unter GetDifferences in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-file verwendet wird.

AWS CLI

So rufen Sie den Base-64-kodierten Inhalt einer Datei in einem AWS-CodeCommit-Repository ab

Das folgende get-file-Beispiel zeigt, wie der Base-64-verschlüsselte Inhalt der Datei README.md aus dem Branch main in einem Repository mit dem Namen MyDemoRepo abgerufen wird.

aws codecommit get-file \ --repository-name MyDemoRepo \ --commit-specifier main \ --file-path README.md

Ausgabe:

{ "blobId":"559b44fEXAMPLE", "commitId":"c5709475EXAMPLE", "fileContent":"IyBQaHVzEXAMPLE", "filePath":"README.md", "fileMode":"NORMAL", "fileSize":1563 }

Weitere Informationen finden Sie unter GetFile im API-Referenzhandbuch zu AWS CodeCommit.

  • API-Details finden Sie unter GetFile in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-folder verwendet wird.

AWS CLI

So rufen Sie den Inhalt eines Ordners in einem AWS-CodeCommit-Repository ab

Das folgende get-folder-Beispiel zeigt, wie Sie den Inhalt eines Ordners der obersten Ebene aus einem Repository mit dem Namen MyDemoRepo abrufen.

aws codecommit get-folder --repository-name MyDemoRepo --folder-path ""

Ausgabe:

{ "commitId":"c5709475EXAMPLE", "files":[ { "absolutePath":".gitignore", "blobId":"74094e8bEXAMPLE", "fileMode":"NORMAL", "relativePath":".gitignore" }, { "absolutePath":"Gemfile", "blobId":"9ceb72f6EXAMPLE", "fileMode":"NORMAL", "relativePath":"Gemfile" }, { "absolutePath":"Gemfile.lock", "blobId":"795c4a2aEXAMPLE", "fileMode":"NORMAL", "relativePath":"Gemfile.lock" }, { "absolutePath":"LICENSE.txt", "blobId":"0c7932c8EXAMPLE", "fileMode":"NORMAL", "relativePath":"LICENSE.txt" }, { "absolutePath":"README.md", "blobId":"559b44feEXAMPLE", "fileMode":"NORMAL", "relativePath":"README.md" } ], "folderPath":"", "subFolders":[ { "absolutePath":"public", "relativePath":"public", "treeId":"d5e92ae3aEXAMPLE" }, { "absolutePath":"tmp", "relativePath":"tmp", "treeId":"d564d0bcEXAMPLE" } ], "subModules":[], "symbolicLinks":[], "treeId":"7b3c4dadEXAMPLE" }

Weitere Informationen finden Sie unter „GetFolder“ im API-Referenzhandbuch zu AWS CodeCommit.

  • API-Details finden Sie unter GetFolder in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-merge-commit verwendet wird.

AWS CLI

So rufen Sie detaillierte Informationen zu einem Commit für die Zusammenführung ab

Im folgenden get-merge-commit-Beispiel werden Details zu einem Commit für die Zusammenführung für den Quell-Branch bugfix-bug1234 mit dem Ziel-Branch main in einem Repository mit dem Namen MyDemoRepo angezeigt.

aws codecommit get-merge-commit \ --source-commit-specifier bugfix-bug1234 \ --destination-commit-specifier main \ --repository-name MyDemoRepo

Ausgabe:

{ "sourceCommitId": "c5709475EXAMPLE", "destinationCommitId": "317f8570EXAMPLE", "baseCommitId": "fb12a539EXAMPLE", "mergeCommitId": "ffc4d608eEXAMPLE" }

Weitere Informationen finden Sie unter Anzeigen von Commit-Details im AWS-CodeCommit-Benutzerhandbuch.

  • API-Details finden Sie unter GetMergeCommit in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-merge-conflicts verwendet wird.

AWS CLI

So zeigen Sie an, ob für eine Pull-Anforderung Konflikte für die Zusammenführung vorliegen

Das folgende get-merge-conflicts-Beispiel zeigt an, ob es Zusammenführungskonflikte zwischen der Spitze eines Quell-Branches mit dem Namen feature-randomizationfeature und einem Ziel-Branch namens „main“ in einem Repository mit dem Namen MyDemoRepo gibt.

aws codecommit get-merge-conflicts \ --repository-name MyDemoRepo \ --source-commit-specifier feature-randomizationfeature \ --destination-commit-specifier main \ --merge-option THREE_WAY_MERGE

Ausgabe:

{ "mergeable": false, "destinationCommitId": "86958e0aEXAMPLE", "sourceCommitId": "6ccd57fdEXAMPLE", "baseCommitId": "767b6958EXAMPLE", "conflictMetadataList": [ { "filePath": "readme.md", "fileSizes": { "source": 139, "destination": 230, "base": 85 }, "fileModes": { "source": "NORMAL", "destination": "NORMAL", "base": "NORMAL" }, "objectTypes": { "source": "FILE", "destination": "FILE", "base": "FILE" }, "numberOfConflicts": 1, "isBinaryFile": { "source": false, "destination": false, "base": false }, "contentConflict": true, "fileModeConflict": false, "objectTypeConflict": false, "mergeOperations": { "source": "M", "destination": "M" } } ] }

Das folgende Codebeispiel zeigt, wie get-merge-options verwendet wird.

AWS CLI

So rufen Sie Informationen zu den Zusammenführungsoptionen ab, die für das Zusammenführen zweier angegebener Branches verfügbar sind

Im folgenden get-merge-options-Beispiel werden die verfügbaren Zusammenführungsoptionen beim Zusammenführen des Quell-Branches bugfix-bug1234 mit dem Ziel-Branch main in einem Repository mit dem Namen MyDemoRepo bestimmt.

aws codecommit get-merge-options \ --source-commit-specifier bugfix-bug1234 \ --destination-commit-specifier main \ --repository-name MyDemoRepo

Ausgabe:

{ "mergeOptions": [ "FAST_FORWARD_MERGE", "SQUASH_MERGE", "THREE_WAY_MERGE" ], "sourceCommitId": "18059494EXAMPLE", "destinationCommitId": "ffd3311dEXAMPLE", "baseCommitId": "ffd3311dEXAMPLE" }

Weitere Informationen finden Sie unter Lösen von Konflikten in einer Pull-Anforderung im AWS-CodeCommit-Benutzerhandbuch.

  • API-Details finden Sie unter GetMergeOptions in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-pull-request-approval-states verwendet wird.

AWS CLI

So zeigen Sie Genehmigungen für eine Pull-Anforderung an

Im folgenden get-pull-request-approval-states-Beispiel werden Genehmigungen für die angegebene Pull-Anforderung zurückgegeben.

aws codecommit get-pull-request-approval-states \ --pull-request-id 8 \ --revision-id 9f29d167EXAMPLE

Ausgabe:

{ "approvals": [ { "userArn": "arn:aws:iam::123456789012:user/Mary_Major", "approvalState": "APPROVE" } ] }

Weitere Informationen finden Sie unter Anzeigen von Pull-Anforderungen im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie get-pull-request-override-state verwendet wird.

AWS CLI

So erhalten Sie Informationen zum Außerkraftsetzungsstatus einer Pull-Anforderung

Das folgende get-pull-request-override-state-Beispiel gibt den Überschreibungsstatus für die angegebene Pull-Anforderung zurück. In diesem Beispiel wurden die Genehmigungsregeln für die Pull-Anforderung von einem Benutzer namens „Mary Major“ außer Kraft gesetzt, sodass die Ausgabe den Wert true zurückgibt:

aws codecommit get-pull-request-override-state \ --pull-request-id 34 \ --revision-id 9f29d167EXAMPLE

Ausgabe:

{ "overridden": true, "overrider": "arn:aws:iam::123456789012:user/Mary_Major" }

Weitere Informationen finden Sie unter Außerkraftsetzen der Genehmigungsregeln für eine Pull-Anforderung im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie get-pull-request verwendet wird.

AWS CLI

So zeigen Sie Details zu einer bestimmten Pull-Anforderung an

Dieses Beispiel zeigt, wie Informationen zu einer Pull-Anforderung mit der ID 27 angezeigt werden.

aws codecommit get-pull-request \ --pull-request-id 27

Ausgabe:

{ "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "ruleContentSha256": "4711b576EXAMPLE" } ], "lastActivityDate": 1562619583.565, "pullRequestTargets": [ { "sourceCommit": "ca45e279EXAMPLE", "sourceReference": "refs/heads/bugfix-1234", "mergeBase": "a99f5ddbEXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": false }, "destinationCommit": "2abfc6beEXAMPLE", "repositoryName": "MyDemoRepo" } ], "revisionId": "e47def21EXAMPLE", "title": "Quick fix for bug 1234", "authorArn": "arn:aws:iam::123456789012:user/Nikhil_Jayashankar", "clientRequestToken": "d8d7612e-EXAMPLE", "creationDate": 1562619583.565, "pullRequestId": "27", "pullRequestStatus": "OPEN" } }
  • API-Details finden Sie unter GetPullRequest in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-repository-triggers verwendet wird.

AWS CLI

So rufen Sie Informationen zu Triggern in einem Repository ab

Dieses Beispiel zeigt Details zu Triggern, die für ein AWS-CodeCommit-Repository mit dem Namen MyDemoRepo konfiguriert wurden.

aws codecommit get-repository-triggers \ --repository-name MyDemoRepo

Ausgabe:

{ "configurationId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", "triggers": [ { "destinationArn": "arn:aws:sns:us-east-1:111111111111:MyCodeCommitTopic", "branches": [ "main", "preprod" ], "name": "MyFirstTrigger", "customData": "", "events": [ "all" ] }, { "destinationArn": "arn:aws:lambda:us-east-1:111111111111:function:MyCodeCommitPythonFunction", "branches": [], "name": "MySecondTrigger", "customData": "EXAMPLE", "events": [ "all" ] } ] }

Das folgende Codebeispiel zeigt, wie get-repository verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem Repository ab

Dieses Beispiel zeigt Details zu einem AWS-CodeCommit-Repository.

aws codecommit get-repository \ --repository-name MyDemoRepo

Ausgabe:

{ "repositoryMetadata": { "creationDate": 1429203623.625, "defaultBranch": "main", "repositoryName": "MyDemoRepo", "cloneUrlSsh": "ssh://git-codecommit.us-east-1.amazonaws.com/v1/repos/v1/repos/MyDemoRepo", "lastModifiedDate": 1430783812.0869999, "repositoryDescription": "My demonstration repository", "cloneUrlHttp": "https://codecommit.us-east-1.amazonaws.com/v1/repos/MyDemoRepo", "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", "Arn": "arn:aws:codecommit:us-east-1:80398EXAMPLE:MyDemoRepo "accountId": "111111111111" } }
  • API-Details finden Sie unter GetRepository in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-approval-rule-templates verwendet wird.

AWS CLI

So listen Sie alle Genehmigungsregelvorlagen in einer AWS-Region auf

Im folgenden list-approval-rule-templates-Beispiel werden alle Genehmigungsregelvorlagen in der angegebenen Region aufgelistet. Wenn keine AWS-Region als Parameter angegeben ist, gibt der Befehl Genehmigungsregelvorlagen für die Region zurück, die im AWS-CLI-Profil angegeben ist, das zur Ausführung des Befehls verwendet wurde.

aws codecommit list-approval-rule-templates \ --region us-east-2

Ausgabe:

{ "approvalRuleTemplateNames": [ "2-approver-rule-for-main", "1-approver-rule-for-all-pull-requests" ] }

Weitere Informationen finden Sie unter Verwalten von Genehmigungsregelvorlagen im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie list-associated-approval-rule-templates-for-repository verwendet wird.

AWS CLI

So listen Sie alle Vorlagen auf, die einem Repository zugeordnet sind

Im folgenden list-associated-approval-rule-templates-for-repository-Beispiel werden alle Genehmigungsregelvorlagen aufgeführt, die einem Repository mit dem Namen MyDemoRepo zugeordnet sind.

aws codecommit list-associated-approval-rule-templates-for-repository \ --repository-name MyDemoRepo

Ausgabe:

{ "approvalRuleTemplateNames": [ "2-approver-rule-for-main", "1-approver-rule-for-all-pull-requests" ] }

Weitere Informationen finden Sie unter Verwalten von Genehmigungsregelvorlagen im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie list-branches verwendet wird.

AWS CLI

So zeigen Sie eine Liste mit Branch-Namen an

Dieses Beispiel listet alle Branch-Namen in einem AWS-CodeCommit-Repository auf.

aws codecommit list-branches \ --repository-name MyDemoRepo

Ausgabe:

{ "branches": [ "MyNewBranch", "main" ] }
  • API-Details finden Sie unter ListBranches in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-pull-requests verwendet wird.

AWS CLI

So zeigen Sie eine Liste von Pull-Anforderungen in einem Repository an

Dieses Beispiel zeigt, wie Pull-Anforderungen, die von einem IAM-Benutzer mit dem ARN „arn:aws:iam: :111111111111:user/li_Juan“ und dem Status „CLOSED“ erstellt wurden, in einem AWS-CodeCommit-Repository namens „MyDemoRepo“ aufgelistet werden:

aws codecommit list-pull-requests --author-arn arn:aws:iam::111111111111:user/Li_Juan --pull-request-status CLOSED --repository-name MyDemoRepo

Ausgabe:

{ "nextToken": "", "pullRequestIds": ["2","12","16","22","23","35","30","39","47"] }

Das folgende Codebeispiel zeigt, wie list-repositories-for-approval-rule-template verwendet wird.

AWS CLI

So listen Sie alle Repositorys auf, die einer Vorlage zugeordnet sind

Das folgende list-repositories-for-approval-rule-template-Beispiel listet alle Repositorys auf, die der angegebenen Genehmigungsregelvorlage zugeordnet sind.

aws codecommit list-repositories-for-approval-rule-template \ --approval-rule-template-name 2-approver-rule-for-main

Ausgabe:

{ "repositoryNames": [ "MyDemoRepo", "MyClonedRepo" ] }

Weitere Informationen finden Sie unter Verwalten von Genehmigungsregelvorlagen im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie list-repositories verwendet wird.

AWS CLI

So zeigen Sie eine Liste der -Repositorys an

Dieses Beispiel listet alle AWS-CodeCommit-Repositorys auf, die dem AWS-Konto des Benutzers zugeordnet sind.

Befehl:

aws codecommit list-repositories

Ausgabe:

{ "repositories": [ { "repositoryName": "MyDemoRepo" "repositoryId": "f7579e13-b83e-4027-aaef-650c0EXAMPLE", }, { "repositoryName": "MyOtherDemoRepo" "repositoryId": "cfc29ac4-b0cb-44dc-9990-f6f51EXAMPLE" } ] }

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So zeigen Sie die AWS-Tags für ein Repository an

Das folgende list-tags-for-resource-Beispiel listet Tag-Schlüssel und Tag-Werte für das angegebene Repository auf.

aws codecommit list-tags-for-resource \ --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo

Ausgabe:

{ "tags": { "Status": "Secret", "Team": "Saanvi" } }

Weitere Informationen finden Sie unter Anzeigen von Tags für ein Repository im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie merge-branches-by-fast-forward verwendet wird.

AWS CLI

So führen Sie zwei Branches mithilfe der Fast-Forward-Mergestrategie zusammen

Im folgenden merge-branches-by-fast-forward-Beispiel wird der angegebene Quell-Branch mit dem angegebenen Ziel-Branch in einem Repository mit dem Namen MyDemoRepo zusammengeführt.

aws codecommit merge-branches-by-fast-forward \ --source-commit-specifier bugfix-bug1234 \ --destination-commit-specifier bugfix-bug1233 \ --repository-name MyDemoRepo

Ausgabe:

{ "commitId": "4f178133EXAMPLE", "treeId": "389765daEXAMPLE" }

Weitere Informationen finden Sie unter Vergleichen und Zusammenführen von Branches im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie merge-branches-by-squash verwendet wird.

AWS CLI

So führen Sie zwei Branches mithilfe der Squash-Zusammenführungsstrategie zusammen

Im folgenden merge-branches-by-squash-Beispiel wird der angegebene Quell-Branch mit dem angegebenen Ziel-Branch in einem Repository mit dem Namen MyDemoRepo zusammengeführt.

aws codecommit merge-branches-by-squash \ --source-commit-specifier bugfix-bug1234 \ --destination-commit-specifier bugfix-bug1233 \ --author-name "Maria Garcia" \ --email "maria_garcia@example.com" \ --commit-message "Merging two fix branches to prepare for a general patch." \ --repository-name MyDemoRepo

Ausgabe:

{ "commitId": "4f178133EXAMPLE", "treeId": "389765daEXAMPLE" }

Weitere Informationen finden Sie unter Vergleichen und Zusammenführen von Branches im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie merge-branches-by-three-way verwendet wird.

AWS CLI

So führen Sie zwei Branches mithilfe der Dreiwegemerge-Strategie zusammen

Im folgenden merge-branches-by-three-way-Beispiel wird der angegebene Quell-Branch mit dem angegebenen Ziel-Branch in einem Repository mit dem Namen MyDemoRepo zusammengeführt.

aws codecommit merge-branches-by-three-way \ --source-commit-specifier main \ --destination-commit-specifier bugfix-bug1234 \ --author-name "Jorge Souza" --email "jorge_souza@example.com" \ --commit-message "Merging changes from main to bugfix branch before additional testing." \ --repository-name MyDemoRepo

Ausgabe:

{ "commitId": "4f178133EXAMPLE", "treeId": "389765daEXAMPLE" }

Weitere Informationen finden Sie unter Vergleichen und Zusammenführen von Branches im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie merge-pull-request-by-fast-forward verwendet wird.

AWS CLI

So führen Sie eine Pull-Anforderung zusammen und schließen sie

In diesem Beispiel wird gezeigt, wie Sie eine Pull-Anforderung mit der ID „47“ und der Quell-Commit-ID „99132ab0EXAMPLE“ in einem Repository mit dem Namen MyDemoRepo zusammenführen und schließen.

aws codecommit merge-pull-request-by-fast-forward \ --pull-request-id 47 \ --source-commit-id 99132ab0EXAMPLE \ --repository-name MyDemoRepo

Ausgabe:

{ "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "I want one approver for this pull request", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::123456789012:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.142, "description": "Review the latest changes and updates to the global variables", "lastActivityDate": 1508887223.155, "pullRequestId": "47", "pullRequestStatus": "CLOSED", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": true, "mergedBy": "arn:aws:iam::123456789012:user/Mary_Major" }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables" } }

Weitere Informationen finden Sie unter Zusammenführen einer Pull-Anforderung im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie merge-pull-request-by-squash verwendet wird.

AWS CLI

So führen Sie eine Pull-Anforderung mithilfe der Squash-Zusammenführungsstrategie zusammen

Im folgenden merge-pull-request-by-squash-Beispiel wird die angegebene Pull-Anforderung mithilfe der Konfliktlösungsstrategie ACCEPT_SOURCE in einem Repository mit dem Namen MyDemoRepo zusammengeführt und geschlossen.

aws codecommit merge-pull-request-by-squash \ --pull-request-id 47 \ --source-commit-id 99132ab0EXAMPLE \ --repository-name MyDemoRepo \ --conflict-detail-level LINE_LEVEL \ --conflict-resolution-strategy ACCEPT_SOURCE \ --name "Jorge Souza" --email "jorge_souza@example.com" \ --commit-message "Merging pull request 47 by squash and accepting source in merge conflicts"

Ausgabe:

{ "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "originApprovalRuleTemplate": { "approvalRuleTemplateId": "dd8b17fe-EXAMPLE", "approvalRuleTemplateName": "2-approver-rule-for-main" }, "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::123456789012:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.142, "description": "Review the latest changes and updates to the global variables", "lastActivityDate": 1508887223.155, "pullRequestId": "47", "pullRequestStatus": "CLOSED", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": true, "mergedBy": "arn:aws:iam::123456789012:user/Mary_Major" }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables" } }

Weitere Informationen finden Sie unter Zusammenführen einer Pull-Anforderung im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie merge-pull-request-by-three-way verwendet wird.

AWS CLI

So führen Sie eine Pull-Anforderung mithilfe der Dreiwegemerge-Strategie zusammen

Im folgenden merge-pull-request-by-three-way-Beispiel wird die angegebene Pull-Anforderung mit den Standardoptionen für Konfliktdetails und Konfliktlösungsstrategie in einem Repository mit dem Namen MyDemoRepo zusammengeführt und geschlossen.

aws codecommit merge-pull-request-by-three-way \ --pull-request-id 47 \ --source-commit-id 99132ab0EXAMPLE \ --repository-name MyDemoRepo \ --name "Maria Garcia" \ --email "maria_garcia@example.com" \ --commit-message "Merging pull request 47 by three-way with default options"

Ausgabe:

{ "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "originApprovalRuleTemplate": { "approvalRuleTemplateId": "dd8b17fe-EXAMPLE", "approvalRuleTemplateName": "2-approver-rule-for-main" }, "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::123456789012:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.142, "description": "Review the latest changes and updates to the global variables", "lastActivityDate": 1508887223.155, "pullRequestId": "47", "pullRequestStatus": "CLOSED", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": true, "mergedBy": "arn:aws:iam::123456789012:user/Mary_Major" }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables" } }

Weitere Informationen finden Sie unter Zusammenführen einer Pull-Anforderung im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie override-pull-request-approval-rules verwendet wird.

AWS CLI

So setzen Sie Genehmigungsregelanforderungen für eine Pull-Anforderung außer Kraft

Im folgenden override-pull-request-approval-rules-Beispiel werden die Genehmigungsregeln für die angegebene Pull-Anforderung überschrieben. Wenn Sie stattdessen eine Überschreibung widerrufen möchten, setzen Sie den --override-status-Parameterwert auf REVOKE.

aws codecommit override-pull-request-approval-rules \ --pull-request-id 34 \ --revision-id 927df8d8EXAMPLE \ --override-status OVERRIDE

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Außerkraftsetzen der Genehmigungsregeln für eine Pull-Anforderung im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie post-comment-for-compared-commit verwendet wird.

AWS CLI

So erstellen Sie einen Kommentar zu einem Commit

Dieses Beispiel zeigt, wie der Kommentar "Can you add a test case for this?" zur Änderung der cl_sample.js-Datei im Vergleich zwischen zwei Commits in einem Repository mit dem Namen MyDemoRepo hinzugefügt wird.

aws codecommit post-comment-for-compared-commit \ --repository-name MyDemoRepo \ --before-commit-id 317f8570EXAMPLE \ --after-commit-id 5d036259EXAMPLE \ --client-request-token 123Example \ --content "Can you add a test case for this?" \ --location filePath=cl_sample.js,filePosition=1232,relativeFileVersion=AFTER

Ausgabe:

{ "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "317f8570EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "6e147360EXAMPLE", "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "commentId": "553b509bEXAMPLE56198325", "content": "Can you add a test case for this?", "creationDate": 1508369612.203, "deleted": false, "commentId": "abc123-EXAMPLE", "lastModifiedDate": 1508369612.203, "callerReactions": [], "reactionCounts": [] }, "location": { "filePath": "cl_sample.js", "filePosition": 1232, "relativeFileVersion": "AFTER" , "repositoryName": "MyDemoRepo" } }

Das folgende Codebeispiel zeigt, wie post-comment-for-pull-request verwendet wird.

AWS CLI

So fügen Sie einen Kommentar zu einer Pull-Anforderung hinzu

Im folgenden post-comment-for-pull-request-Beispiel wird der Kommentar „These don't appear to be used anywhere. Können wir sie entfernen?“ für die Änderung der Datei ahs_count.py in einer Pull-Anforderung mit der ID 47 im Repository MyDemoRepo hinzugefügt.

aws codecommit post-comment-for-pull-request \ --pull-request-id "47" \ --repository-name MyDemoRepo \ --before-commit-id 317f8570EXAMPLE \ --after-commit-id 5d036259EXAMPLE \ --client-request-token 123Example \ --content "These don't appear to be used anywhere. Can we remove them?" \ --location filePath=ahs_count.py,filePosition=367,relativeFileVersion=AFTER

Ausgabe:

{ "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "5d036259EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "317f8570EXAMPLE", "comment": { "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", "clientRequestToken": "123Example", "commentId": "abcd1234EXAMPLEb5678efgh", "content": "These don't appear to be used anywhere. Can we remove them?", "creationDate": 1508369622.123, "deleted": false, "CommentId": "", "lastModifiedDate": 1508369622.123, "callerReactions": [], "reactionCounts": [] }, "location": { "filePath": "ahs_count.py", "filePosition": 367, "relativeFileVersion": "AFTER" }, "repositoryName": "MyDemoRepo", "pullRequestId": "47" }

Das folgende Codebeispiel zeigt, wie post-comment-reply verwendet wird.

AWS CLI

So antworten Sie auf einen Kommentar zu einem Commit oder in einer Pull-Anforderung

Dieses Beispiel zeigt, wie dem Kommentar mit der vom System generierten ID abcd1234EXAMPLEb5678efgh die Antwort "Good catch. I'll remove them." hinzugefügt wird.

aws codecommit post-comment-reply \ --in-reply-to abcd1234EXAMPLEb5678efgh \ --content "Good catch. I'll remove them." \ --client-request-token 123Example

Ausgabe:

{ "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "442b498bEXAMPLE5756813", "content": "Good catch. I'll remove them.", "creationDate": 1508369829.136, "deleted": false, "CommentId": "abcd1234EXAMPLEb5678efgh", "lastModifiedDate": 150836912.221, "callerReactions": [], "reactionCounts": [] } }

Das folgende Codebeispiel zeigt, wie put-comment-reaction verwendet wird.

AWS CLI

So antworten Sie mit einem Emoji auf einen Kommentar zu einem Commit

Im folgenden put-comment-reaction-Beispiel wird auf einen Kommentar mit der ID abcd1234EXAMPLEb5678efgh mit dem Emoji-Reaktionswert :thumbsup: geantwortet.

aws codecommit put-comment-reaction \ --comment-id abcd1234EXAMPLEb5678efgh \ --reaction-value :thumbsup:

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Kommentar zu einem Commit in AWS CodeCommit im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie put-file verwendet wird.

AWS CLI

So fügen Sie eine Datei zu einem Repository hinzu

Im folgenden put-file-Beispiel wird eine Datei namens „ExampleSolution.py“ dem Repository „MyDemoRepo“ in einem Branch mit der Bezeichnung „feature-randomizationfeature“ hinzugefügt, dessen letzter Commit die ID „4c925148EXAMPLE“ hat.

aws codecommit put-file \ --repository-name MyDemoRepo \ --branch-name feature-randomizationfeature \ --file-content file://MyDirectory/ExampleSolution.py \ --file-path /solutions/ExampleSolution.py \ --parent-commit-id 4c925148EXAMPLE \ --name "Maria Garcia" \ --email "maria_garcia@example.com" \ --commit-message "I added a third randomization routine."

Ausgabe:

{ "blobId": "2eb4af3bEXAMPLE", "commitId": "317f8570EXAMPLE", "treeId": "347a3408EXAMPLE" }
  • API-Details finden Sie unter PutFile in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie put-repository-triggers verwendet wird.

AWS CLI

So fügen Sie einen Trigger in einem Repository hinzu oder aktualisieren ihn

Dieses Beispiel zeigt, wie Trigger mit den Namen „MyFirstTrigger“ und „MySecondTrigger“ mithilfe einer bereits erstellten JSON-Datei (hier „MyTriggers.json“) aktualisiert werden, die die Struktur aller Trigger für ein Repository namens „MyDemoRepo“ enthält. Informationen zum Abrufen des JSON-Codes für vorhandene Trigger finden Sie unter dem Befehl „get-repository-triggers“.

aws codecommit put-repository-triggers \ --repository-name MyDemoRepo file://MyTriggers.json

Inhalt von MyTriggers.json:

{ "repositoryName": "MyDemoRepo", "triggers": [ { "destinationArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MyCodeCommitTopic", "branches": [ "main", "preprod" ], "name": "MyFirstTrigger", "customData": "", "events": [ "all" ] }, { "destinationArn": "arn:aws:lambda:us-east-1:111111111111:function:MyCodeCommitPythonFunction", "branches": [], "name": "MySecondTrigger", "customData": "EXAMPLE", "events": [ "all" ] } ] }

Ausgabe:

{ "configurationId": "6fa51cd8-35c1-EXAMPLE" }

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

So fügen Sie AWS-Tags zu einem vorhandenen Repository hinzu

Im folgenden tag-resource-Beispiel wird das angegebene Repository mit zwei Tags versehen.

aws codecommit tag-resource \ --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo \ --tags Status=Secret,Team=Saanvi

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Hinzufügen eines Tags zu einem Repository im AWS-CodeCommit-Benutzerhandbuch.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie test-repository-triggers verwendet wird.

AWS CLI

So testen Sie Trigger in einem Repository

Dieses Beispiel zeigt, wie ein Trigger mit dem Namen „MyFirstTrigger“ in einem AWS-CodeCommit-Repository namens „MyDemoRepo“ getestet wird. In diesem Beispiel lösen Ereignisse im Repository Benachrichtigungen zu einem Amazon Simple Notification Service (Amazon SNS)-Thema aus.

Befehl:

aws codecommit test-repository-triggers --repository-name MyDemoRepo --triggers name=MyFirstTrigger,destinationArn=arn:aws:sns:us-east-1:111111111111:MyCodeCommitTopic,branches=mainline,preprod,events=all

Ausgabe:

{ "successfulExecutions": [ "MyFirstTrigger" ], "failedExecutions": [] }

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie AWS-Tags aus einem Repository

Im folgenden untag-resource-Beispiel wird das Tag mit dem angegebenen Schlüssel aus dem Repository MyDemoRepo entfernt.

aws codecommit untag-resource \ --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo \ --tag-keys Status

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Entfernen eines Tags aus einem Repository im AWS-CodeCommit-Benutzerhandbuch.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-approval-rule-template-content verwendet wird.

AWS CLI

So aktualisieren Sie den Inhalt einer Genehmigungsregelvorlage

Im folgenden update-approval-rule-template-content-Beispiel wird der Inhalt der angegebenen Genehmigungsregelvorlage so geändert, dass der Genehmigungs-Pool mit Benutzern, die die Rolle CodeCommitReview annehmen, neu definiert wird.

aws codecommit update-approval-rule-template-content \ --approval-rule-template-name 1-approver-rule \ --new-rule-content "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}"

Ausgabe:

{ "approvalRuleTemplate": { "creationDate": 1571352720.773, "approvalRuleTemplateDescription": "Requires 1 approval for all pull requests from the CodeCommitReview pool", "lastModifiedDate": 1571358728.41, "approvalRuleTemplateId": "41de97b7-EXAMPLE", "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests", "ruleContentSha256": "2f6c21a5EXAMPLE", "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan" } }

Weitere Informationen finden Sie unter Verwalten von Genehmigungsregelvorlagen im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie update-approval-rule-template-description verwendet wird.

AWS CLI

So aktualisieren Sie die Beschreibung einer Genehmigungsregelvorlage

Im folgenden update-approval-rule-template-description-Beispiel wird die Beschreibung der angegebenen Genehmigungsregelvorlage in Requires 1 approval for all pull requests from the CodeCommitReview pool geändert:

aws codecommit update-approval-rule-template-description \ --approval-rule-template-name 1-approver-rule-for-all-pull-requests \ --approval-rule-template-description "Requires 1 approval for all pull requests from the CodeCommitReview pool"

Ausgabe:

{ "approvalRuleTemplate": { "creationDate": 1571352720.773, "approvalRuleTemplateDescription": "Requires 1 approval for all pull requests from the CodeCommitReview pool", "lastModifiedDate": 1571358728.41, "approvalRuleTemplateId": "41de97b7-EXAMPLE", "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests", "ruleContentSha256": "2f6c21a5EXAMPLE", "lastModifiedUser": "arn:aws:iam::123456789012:user/Li_Juan" } }

Weitere Informationen finden Sie unter Verwalten von Genehmigungsregelvorlagen im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie update-approval-rule-template-name verwendet wird.

AWS CLI

So aktualisieren Sie den Namen einer Genehmigungsregelvorlage

Im folgenden update-approval-rule-template-name-Beispiel wird der Name einer Genehmigungsregelvorlage von 1-approver-rule in „1-approver-rule-for-all-pull-requests“ geändert.

aws codecommit update-approval-rule-template-name \ --old-approval-rule-template-name 1-approver-rule \ --new-approval-rule-template-name 1-approver-rule-for-all-pull-requests

Ausgabe:

{ "approvalRuleTemplate": { "approvalRuleTemplateName": "1-approver-rule-for-all-pull-requests", "lastModifiedDate": 1571358241.619, "approvalRuleTemplateId": "41de97b7-EXAMPLE", "approvalRuleTemplateContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 1,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "creationDate": 1571352720.773, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "approvalRuleTemplateDescription": "All pull requests must be approved by one developer on the team.", "ruleContentSha256": "2f6c21a5cEXAMPLE" } }

Weitere Informationen finden Sie unter Verwalten von Genehmigungsregelvorlagen im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie update-comment verwendet wird.

AWS CLI

So aktualisieren Sie einen Kommentar zu einem Commit

Dieses Beispiel zeigt, wie der Inhalt "Fixed as requested. I'll update the pull request." zu einem Kommentar mit der ID 442b498bEXAMPLE5756813 hinzugefügt wird.

aws codecommit update-comment \ --comment-id 442b498bEXAMPLE5756813 \ --content "Fixed as requested. I'll update the pull request."

Ausgabe:

{ "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "commentId": "442b498bEXAMPLE5756813", "content": "Fixed as requested. I'll update the pull request.", "creationDate": 1508369929.783, "deleted": false, "lastModifiedDate": 1508369929.287, "callerReactions": [], "reactionCounts": { "THUMBSUP" : 2 } } }
  • API-Details finden Sie unter UpdateComment in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-default-branch verwendet wird.

AWS CLI

So ändern Sie den Standard-Branch für ein Repository

In diesem Beispiel wird der Standard-Branch für ein AWS-CodeCommit-Repository geändert. Dieser Befehl liefert nur eine Ausgabe, wenn Fehler aufgetreten sind.

Befehl:

aws codecommit update-default-branch --repository-name MyDemoRepo --default-branch-name MyNewBranch

Ausgabe:

None.

Das folgende Codebeispiel zeigt, wie update-pull-request-approval-rule-content verwendet wird.

AWS CLI

So bearbeiten Sie eine Genehmigungsregel für eine Pull-Anforderung

Im folgenden update-pull-request-approval-rule-content-Beispiel wird die angegebene Genehmigungsregel dahingehend aktualisiert, dass eine Benutzergenehmigung aus einem Genehmigungs-Pool erforderlich ist, der alle IAM-Benutzer im AWS-Konto 123456789012 umfasst.

aws codecommit update-pull-request-approval-rule-content \ --pull-request-id 27 \ --approval-rule-name "Require two approved approvers" \ --approval-rule-content "{Version: 2018-11-08, Statements: [{Type: \"Approvers\", NumberOfApprovalsNeeded: 1, ApprovalPoolMembers:[\"CodeCommitApprovers:123456789012:user/*\"]}]}}"

Ausgabe:

{ "approvalRule": { "approvalRuleContent": "{Version: 2018-11-08, Statements: [{Type: \"Approvers\", NumberOfApprovalsNeeded: 1, ApprovalPoolMembers:[\"CodeCommitApprovers:123456789012:user/*\"]}]}}", "approvalRuleId": "aac33506-EXAMPLE", "originApprovalRuleTemplate": {}, "creationDate": 1570752871.932, "lastModifiedDate": 1570754058.333, "approvalRuleName": Require two approved approvers", "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "ruleContentSha256": "cd93921cEXAMPLE", } }

Weitere Informationen finden Sie unter Bearbeiten oder Löschen einer Genehmigungsregel im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie update-pull-request-approval-state verwendet wird.

AWS CLI

So gewähren oder widerrufen Sie die Genehmigung für eine Pull-Anforderung

Im folgenden update-pull-request-approval-state-Beispiel wird die Pull-Anforderung mit der ID 27 und der Revisions-ID 9f29d167EXAMPLE genehmigt. Wenn Sie stattdessen die Genehmigung widerrufen möchten, setzen Sie den --approval-state-Parameterwert auf REVOKE.

aws codecommit update-pull-request-approval-state \ --pull-request-id 27 \ --revision-id 9f29d167EXAMPLE \ --approval-state "APPROVE"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Überprüfen einer Pull-Anforderung im AWS-CodeCommit-Benutzerhandbuch.

Das folgende Codebeispiel zeigt, wie update-pull-request-description verwendet wird.

AWS CLI

So ändern Sie die Beschreibung einer Pull-Anforderung

Dieses Beispiel zeigt, wie die Beschreibung einer Pull-Anforderung mit der ID 47 geändert wird.

aws codecommit update-pull-request-description \ --pull-request-id 47 \ --description "Updated the pull request to remove unused global variable."

Ausgabe:

{ "pullRequest": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.155, "description": "Updated the pull request to remove unused global variable.", "lastActivityDate": 1508372423.204, "pullRequestId": "47", "pullRequestStatus": "OPEN", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": false, }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables" } }

Das folgende Codebeispiel zeigt, wie update-pull-request-status verwendet wird.

AWS CLI

So ändern Sie den Status einer Pull-Anforderung

Dieses Beispiel zeigt, wie der Status einer Pull-Anforderung mit der ID 42 in einem AWS-CodeCommit-Repository mit dem Namen MyDemoRepo in den Status CLOSED geändert werden kann.

aws codecommit update-pull-request-status \ --pull-request-id 42 \ --pull-request-status CLOSED

Ausgabe:

{ "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approvers-needed-for-this-change", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::123456789012:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.165, "description": "Updated the pull request to remove unused global variable.", "lastActivityDate": 1508372423.12, "pullRequestId": "47", "pullRequestStatus": "CLOSED", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": false, }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables" } }

Das folgende Codebeispiel zeigt, wie update-pull-request-title verwendet wird.

AWS CLI

So ändern Sie den Titel einer Pull-Anforderung

Dieses Beispiel zeigt, wie der Titel einer Pull-Anforderung mit der ID 47 geändert wird.

aws codecommit update-pull-request-title \ --pull-request-id 47 \ --title "Consolidation of global variables - updated review"

Ausgabe:

{ "pullRequest": { "approvalRules": [ { "approvalRuleContent": "{\"Version\": \"2018-11-08\",\"DestinationReferences\": [\"refs/heads/main\"],\"Statements\": [{\"Type\": \"Approvers\",\"NumberOfApprovalsNeeded\": 2,\"ApprovalPoolMembers\": [\"arn:aws:sts::123456789012:assumed-role/CodeCommitReview/*\"]}]}", "approvalRuleId": "dd8b17fe-EXAMPLE", "approvalRuleName": "2-approver-rule-for-main", "creationDate": 1571356106.936, "lastModifiedDate": 571356106.936, "lastModifiedUser": "arn:aws:iam::123456789012:user/Mary_Major", "originApprovalRuleTemplate": { "approvalRuleTemplateId": "dd8b26gr-EXAMPLE", "approvalRuleTemplateName": "2-approver-rule-for-main" }, "ruleContentSha256": "4711b576EXAMPLE" } ], "authorArn": "arn:aws:iam::123456789012:user/Li_Juan", "clientRequestToken": "", "creationDate": 1508530823.12, "description": "Review the latest changes and updates to the global variables. I have updated this request with some changes, including removing some unused variables.", "lastActivityDate": 1508372657.188, "pullRequestId": "47", "pullRequestStatus": "OPEN", "pullRequestTargets": [ { "destinationCommit": "9f31c968EXAMPLE", "destinationReference": "refs/heads/main", "mergeMetadata": { "isMerged": false, }, "repositoryName": "MyDemoRepo", "sourceCommit": "99132ab0EXAMPLE", "sourceReference": "refs/heads/variables-branch" } ], "title": "Consolidation of global variables - updated review" } }

Das folgende Codebeispiel zeigt, wie update-repository-description verwendet wird.

AWS CLI

So ändern Sie die Beschreibung eines Repositorys

In diesem Beispiel wird die Beschreibung für ein AWS-CodeCommit-Repository geändert. Dieser Befehl liefert nur eine Ausgabe, wenn Fehler aufgetreten sind.

Befehl:

aws codecommit update-repository-description --repository-name MyDemoRepo --repository-description "This description was changed"

Ausgabe:

None.

Das folgende Codebeispiel zeigt, wie update-repository-name verwendet wird.

AWS CLI

So ändern Sie den Namen eines Repositorys

In diesem Beispiel wird der Name für ein AWS-CodeCommit-Repository geändert. Dieser Befehl liefert nur eine Ausgabe, wenn Fehler aufgetreten sind. Wenn der Name des AWS-CodeCommit-Repositorys geändert wird, ändern sich die SSH- und die HTTPS-URL, die Benutzer zum Herstellen einer Verbindung mit dem Repository benötigen. Benutzer können erst eine Verbindung mit diesem Repository herstellen, wenn sie ihre Verbindungseinstellungen aktualisiert haben. Da sich auch der ARN des Repositorys ändert, wird durch die Änderung des Repository-Namens jede IAM-Benutzerrichtlinie ungültig, die den ARN dieses Repositorys verwendet.

Befehl:

aws codecommit update-repository-name --old-name MyDemoRepo --new-name MyRenamedDemoRepo

Ausgabe:

None.