CodeCommit exemples utilisant AWS CLI - AWS Command Line Interface
Actions

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CodeCommit exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with CodeCommit.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliserassociate-approval-rule-template-with-repository.

AWS CLI

Pour associer un modèle de règle d’approbation à un référentiel

L’exemple associate-approval-rule-template-with-repository suivant associe le modèle de règle d’approbation spécifié à un référentiel nommé MyDemoRepo.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, voir Associer un modèle de règle d'approbation à un référentiel dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserbatch-associate-approval-rule-template-with-repositories.

AWS CLI

Pour associer un modèle de règle d’approbation à plusieurs référentiels en une seule opération

L’exemple batch-associate-approval-rule-template-with-repositories suivant associe le modèle de règle d’approbation spécifié à des référentiels nommés MyDemoRepo et MyOtherDemoRepo.

Remarque : Les modèles de règles d'approbation sont spécifiques à la AWS région dans laquelle ils sont créés. Ils ne peuvent être associés qu'aux référentiels de cette AWS région.

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

Sortie :

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

Pour plus d'informations, voir Associer un modèle de règle d'approbation à un référentiel dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserbatch-describe-merge-conflicts.

AWS CLI

Pour obtenir des informations sur les conflits de fusion dans tous les fichiers ou dans un sous-ensemble de fichiers d’une fusion entre deux spécificateurs de validation

L’exemple batch-describe-merge-conflicts suivant détermine les conflits de fusion liés à la fusion d’une branche source nommée feature-randomizationfeature avec une branche de destination nommée main à l’aide de la stratégie THREE_WAY_MERGE dans un référentiel nommé MyDemoRepo.

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

Sortie :

{
    "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"
}

Pour plus d'informations, consultez la section Résoudre les conflits liés à une pull request dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserbatch-disassociate-approval-rule-template-from-repositories.

AWS CLI

Pour dissocier un modèle de règle d’approbation de plusieurs référentiels en une seule opération

L’exemple batch-disassociate-approval-rule-template-from-repositories suivant dissocie le modèle de règle d’approbation spécifié des référentiels nommés MyDemoRepo et MyOtherDemoRepo.

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

Sortie :

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

Pour plus d'informations, voir Dissocier un modèle de règle d'approbation dans le guide de l'AWS CodeCommit utilisateur.

L'exemple de code suivant montre comment utiliserbatch-get-commits.

AWS CLI

Pour afficher les informations sur plusieurs validations

L’exemple batch-get-commits suivant affiche des informations sur les validations spécifiées.

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

Sortie :

{
    "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"
    }
}

Pour plus d'informations, voir Afficher les détails des validations dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous BatchGetCommitsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserbatch-get-repositories.

AWS CLI

Pour afficher les informations sur plusieurs référentiels

Cet exemple montre des détails sur plusieurs AWS CodeCommit référentiels.

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

Sortie :

{
    "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": []
}

  • Pour plus de détails sur l'API, reportez-vous BatchGetRepositoriesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-approval-rule-template.

AWS CLI

Pour créer un modèle de règle d’approbation

L’exemple create-approval-rule-template suivant crée un modèle de règle d’approbation nommé 2-approver-rule-for-main ``. The template requires two users who assume the role of ``CodeCommitReview pour approuver toute demande d’extraction avant qu’elle ne puisse être fusionnée avec la branche main.

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/*\"]}]}"

Sortie :

{
    "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"
    }
}

Pour plus d'informations, voir Création d'un modèle de règle d'approbation dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utilisercreate-branch.

AWS CLI

Pour créer une branche

Cet exemple crée une branche dans un AWS CodeCommit référentiel. Cette commande génère une sortie uniquement en cas d’erreurs.

Commande :

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

Sortie :

None.

  • Pour plus de détails sur l'API, reportez-vous CreateBranchà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-commit.

AWS CLI

Pour créer un commit

L’exemple create-commit suivant montre comment créer une validation initiale pour un référentiel qui ajoute un fichier readme.md dans un référentiel nommé MyDemoRepo dans la branche main.

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

Sortie :

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

Pour plus d'informations, consultez la section Créer un commit AWS CodeCommit dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous CreateCommità la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-pull-request-approval-rule.

AWS CLI

Pour créer une règle d’approbation pour une demande d’extraction

L’exemple create-pull-request-approval-rule suivant montre comment créer une règle d’approbation nommée Require two approved approvers pour la demande d’extraction spécifiée. La règle spécifie que deux approbations sont requises à partir d’un groupe d’approbation. Le pool inclut tous les utilisateurs qui accèdent CodeCommit en assumant le rôle de CodeCommitReview dans le 123456789012 AWS compte. Il inclut également un utilisateur IAM ou un utilisateur fédéré nommé Nikhil_Jayashankar à partir du même AWS compte.

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/*\"]}]}"

Sortie :

{
    "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"
    }
}

Pour plus d'informations, voir Création d'une règle d'approbation dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utilisercreate-pull-request.

AWS CLI

Pour créer une demande d’extraction

L'create-pull-requestexemple suivant crée une pull request nommée « Analyseur de difficulté de prononciation » avec la description « Veuillez revoir ces modifications d'ici mardi » qui cible la branche source « jane-branch » et doit être fusionnée avec la branche par défaut « main » dans un référentiel nommé « ». AWS CodeCommit MyDemoRepo

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

Sortie :

{
    "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
    }
}

  • Pour plus de détails sur l'API, reportez-vous CreatePullRequestà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-repository.

AWS CLI

Pour créer un référentiel

Cet exemple crée un référentiel et l'associe au AWS compte de l'utilisateur.

Commande :

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

Sortie :

{
    "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"
    }
}

  • Pour plus de détails sur l'API, reportez-vous CreateRepositoryà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-unreferenced-merge-commit.

AWS CLI

Pour créer une validation non référencée qui représente le résultat de la fusion de deux spécificateurs de validation

L’exemple create-unreferenced-merge-commit suivant crée une validation qui représente les résultats d’une fusion entre une branche source nommée bugfix-1234 et une branche de destination nommée main selon la stratégie THREE_WAY_MERGE dans un référentiel nommé MyDemoRepo.

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."

Sortie :

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

Pour plus d'informations, consultez la section Résoudre les conflits liés à une pull request dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utilisercredential-helper.

AWS CLI

Pour configurer l'assistant d'identification inclus dans la CLI AWS avec AWS CodeCommit

L'credential-helperutilitaire n'est pas conçu pour être appelé directement depuis la AWS CLI. Il est plutôt destiné à être utilisé comme paramètre avec la commande git config pour configurer votre ordinateur local. Il permet à Git d'utiliser le protocole HTTPS et une version signée cryptographiquement de vos informations d'identification utilisateur IAM ou de votre rôle d' EC2 instance Amazon chaque fois que Git a besoin de s'authentifier AWS pour interagir avec des référentiels. CodeCommit 

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

Sortie :

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

Pour plus d'informations, consultez la section Configuration pour AWS CodeCommit l'utilisation d'autres méthodes dans le guide de AWS CodeCommit l'utilisateur. Lisez attentivement le contenu, puis suivez les procédures décrites dans l'une des rubriques suivantes : Pour les connexions HTTPS sous Linux, macOS ou Unix ou Pour les connexions HTTPS sous Windows dans le guide de l'AWS CodeCommit utilisateur.

  • Pour plus de détails sur l'API, reportez-vous CredentialHelperà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-approval-rule-template.

AWS CLI

Pour supprimer un modèle de règle d’approbation

L’exemple delete-approval-rule-template suivant supprime le modèle de règle d’approbation spécifié.

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

Sortie :

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

Pour plus d'informations, voir Supprimer un modèle de règle d'approbation dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserdelete-branch.

AWS CLI

Pour supprimer une branche

Cet exemple montre comment supprimer une branche dans un AWS CodeCommit référentiel.

Commande :

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

Sortie :

{
  "branch": {
      "commitId": "317f8570EXAMPLE",
      "branchName": "MyNewBranch"
  }
}

  • Pour plus de détails sur l'API, reportez-vous DeleteBranchà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-comment-content.

AWS CLI

Pour supprimer le contenu d’un commentaire

Vous ne pouvez supprimer le contenu d’un commentaire que si vous l’avez créé. Cet exemple montre comment supprimer le contenu d’un commentaire dont l’ID généré par le système est ff30b348EXAMPLEb9aa670f.

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

Sortie :

{
    "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
        }
    }
}

  • Pour plus de détails sur l'API, reportez-vous DeleteCommentContentà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-file.

AWS CLI

Pour supprimer un fichier

L’exemple delete-file suivant montre comment supprimer un fichier nommé README.md dans une branche main dont l’ID de validation le plus récent est c5709475EXAMPLE dans un référentiel nommé MyDemoRepo.

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

Sortie :

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

Pour plus d'informations, voir Modifier ou supprimer un fichier AWS CodeCommit dans le guide de référence des AWS CodeCommit API.

  • Pour plus de détails sur l'API, reportez-vous DeleteFileà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-pull-request-approval-rule.

AWS CLI

Pour supprimer une règle d’approbation pour une demande d’extraction

L’exemple delete-pull-request-approval-rule suivant supprime une règle d’approbation nommée My Approval Rule pour la demande d’extraction spécifiée.

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

Sortie :

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

Pour plus d'informations, voir Modifier ou supprimer une règle d'approbation dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserdelete-repository.

AWS CLI

Pour supprimer un référentiel

Cet exemple montre comment supprimer un AWS CodeCommit dépôt.

Commande :

aws codecommit delete-repository --repository-name MyDemoRepo

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous DeleteRepositoryà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-merge-conflicts.

AWS CLI

Pour obtenir les informations détaillées sur les conflits de fusion

L’exemple describe-merge-conflicts suivant détermine les conflits de fusion pour un fichier nommé readme.md dans la branche source et la branche de destination spécifiées à l’aide de la stratégie THREE_WAY_MERGE.

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

Sortie :

{
    "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"
}

Pour plus d'informations, consultez la section Résoudre les conflits liés à une pull request dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous DescribeMergeConflictsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-pull-request-events.

AWS CLI

Pour afficher des événements d’une demande d’extraction

L’exemple describe-pull-request-events suivant extrait des événements d’une demande d’extraction avec l’ID « 8 ».

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

Sortie :

{
    "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"
        }
    ]
}

L'exemple de code suivant montre comment utiliserdisassociate-approval-rule-template-from-repository.

AWS CLI

Pour dissocier un modèle de règle d’approbation d’un référentiel

L’exemple disassociate-approval-rule-template-from-repository suivant dissocie le modèle de règle d’approbation spécifié d’un référentiel nommé MyDemoRepo.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, voir Dissocier un modèle de règle d'approbation dans le guide de l'AWS CodeCommit utilisateur.

L'exemple de code suivant montre comment utiliserevaluate-pull-request-approval-rules.

AWS CLI

Pour évaluer si toutes les règles d’approbation d’une demande d’extraction ont été respectées

L’exemple evaluate-pull-request-approval-rules suivant évalue l’état des règles d’approbation de la demande d’extraction spécifiée. Dans cet exemple, une règle d’approbation n’ayant pas été respectée pour la demande d’extraction, la sortie de la commande affiche une valeur approved comme false.

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

Sortie :

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

Pour plus d'informations, voir Fusionner une pull request dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserget-approval-rule-template.

AWS CLI

Pour obtenir le contenu d’un modèle de règle d’approbation

L’exemple get-approval-rule-template suivant obtient le contenu d’un modèle de règle d’approbation nommé 1-approver-rule-for-all-pull-requests.

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

Sortie :

{
    "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."
    }
}

Pour plus d'informations, consultez la section Gérer les modèles de règles d'approbation dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous GetApprovalRuleTemplateà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-blob.

AWS CLI

Pour afficher les informations détaillées sur un objet blob Git

L'get-blobexemple suivant extrait des informations sur un blob Git portant l'ID « 2eb4af3bExample » dans un référentiel nommé « ». AWS CodeCommit MyDemoRepo

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

Sortie :

{
    "content": "QSBCaW5hcnkgTGFyToEXAMPLE="
}

  • Pour plus de détails sur l'API, reportez-vous GetBlobà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-branch.

AWS CLI

Pour obtenir des informations sur une branche

Cet exemple permet d'obtenir des informations sur une branche d'un AWS CodeCommit référentiel.

Commande :

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

Sortie :

{
  "BranchInfo": {
        "commitID": "317f8570EXAMPLE",
                "branchName": "MyNewBranch"
  }
}

  • Pour plus de détails sur l'API, reportez-vous GetBranchà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-comment-reactions.

AWS CLI

Pour afficher des réactions par emoji à un commentaire

L’exemple get-comment-reactions suivant répertorie toutes les réactions par emoji à un commentaire portant l’ID abcd1234EXAMPLEb5678efgh. Si la police de votre shell prend en charge l’affichage de la version Emoji 1.0, alors l’emoji s’affiche dans la sortie emoji.

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

Sortie :

{
    "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"
                ]
            }
        ]
    }
}

Pour plus d'informations, voir Commenter un commit AWS CodeCommit dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous GetCommentReactionsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-comment.

AWS CLI

Pour afficher des informations sur un commentaire

Cet exemple montre comment afficher des informations sur un commentaire dont l’ID de commentaire généré par le système est ff30b348EXAMPLEb9aa670f.

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

Sortie :

{
    "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
        }
    }
}

  • Pour plus de détails sur l'API, reportez-vous GetCommentà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-comments-for-compared-commit.

AWS CLI

Pour consulter les commentaires relatifs à un commit

Cet exemple montre comment afficher les commentaires sur la comparaison entre deux validations dans un référentiel nommé MyDemoRepo.

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

Sortie :

{
    "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"
}

L'exemple de code suivant montre comment utiliserget-comments-for-pull-request.

AWS CLI

Pour afficher les commentaires pour une demande d’extraction

Cet exemple montre comment afficher les commentaires pour une demande d’extraction dans un référentiel nommé MyDemoRepo :

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

Sortie :

{
    "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"
}

L'exemple de code suivant montre comment utiliserget-commit.

AWS CLI

Pour afficher des informations sur une validation dans un référentiel

Cet exemple montre les détails d'un commit dont l'identifiant généré par le système est « 7e9fd3091thisisanexamplethisisanexample1 » dans un référentiel nommé « ». AWS CodeCommit MyDemoRepo

Commande :

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

Sortie :

{
  "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"
  }
}

  • Pour plus de détails sur l'API, reportez-vous GetCommità la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-differences.

AWS CLI

Pour obtenir des informations sur les différences pour un spécificateur de validation dans un référentiel

Cet exemple montre les informations de métadonnées d'affichage concernant les modifications entre deux spécificateurs de validation (branche, tag, HEAD ou autres références complètes, telles que commit IDs) dans un dossier renommé AWS CodeCommit du référentiel nommé MyDemoRepo. L'exemple inclut plusieurs options qui ne sont pas obligatoires, notamment --before-commit-specifier, --before-path et --after-path, afin d'illustrer de manière plus complète comment vous pouvez utiliser ces options pour limiter les résultats. La réponse inclut les autorisations relatives au mode fichier.

Commande :

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

Sortie :

{
  "differences": [
      {
          "afterBlob": {
              "path": "blob.txt",
              "blobId": "2eb4af3b1thisisanexamplethisisanexample1",
              "mode": "100644"
          },
          "changeType": "M",
          "beforeBlob": {
              "path": "blob.txt",
              "blobId": "bf7fcf281thisisanexamplethisisanexample1",
              "mode": "100644"
          }
      }
  ]
}

  • Pour plus de détails sur l'API, reportez-vous GetDifferencesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-file.

AWS CLI

Pour obtenir le contenu codé en base 64 d'un fichier dans un dépôt AWS CodeCommit

L’exemple get-file suivant montre comment obtenir le contenu codé en base 64 d’un fichier nommé README.md dans une branche nommée main dans un référentiel nommé MyDemoRepo.

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

Sortie :

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

Pour plus d'informations, consultez GetFilele guide de référence des AWS CodeCommit API.

  • Pour plus de détails sur l'API, reportez-vous GetFileà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-folder.

AWS CLI

Pour obtenir le contenu d'un dossier dans un AWS CodeCommit référentiel

L’exemple get-folder suivant montre comment obtenir le contenu d’un dossier de premier niveau à partir d’un référentiel nommé MyDemoRepo.

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

Sortie :

{
    "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"
}

Pour plus d'informations, consultez GetFolder le guide de référence des AWS CodeCommit API.

  • Pour plus de détails sur l'API, reportez-vous GetFolderà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-merge-commit.

AWS CLI

Pour obtenir des informations détaillées sur une validation de fusion

L’exemple get-merge-commit suivant affiche des informations sur une validation de fusion pour la branche source nommée bugfix-bug1234 avec une branche de destination nommée main dans un référentiel nommé MyDemoRepo.

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

Sortie :

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

Pour plus d'informations, voir Afficher les détails des validations dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous GetMergeCommità la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-merge-conflicts.

AWS CLI

Pour voir s’il existe des conflits de fusion pour une demande d’extraction

L’exemple get-merge-conflicts suivant affiche s’il existe des conflits de fusion entre la pointe d’une branche source nommée feature-randomizationfeature et une branche de destination nommée « main » dans un référentiel nommé MyDemoRepo.

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

Sortie :

{
    "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"
            }
        }
    ]
}

  • Pour plus de détails sur l'API, reportez-vous GetMergeConflictsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-merge-options.

AWS CLI

Pour obtenir les informations sur les options de fusion disponibles pour fusionner deux branches spécifiées

L’exemple get-merge-options suivant détermine les options de fusion disponibles pour fusionner une branche source nommée bugfix-bug1234 avec une branche de destination nommée main dans un référentiel nommé MyDemoRepo.

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

Sortie :

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

Pour plus d'informations, consultez la section Résoudre les conflits liés à une pull request dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous GetMergeOptionsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-pull-request-approval-states.

AWS CLI

Pour afficher des approbations sur une demande d’extraction

L’exemple get-pull-request-approval-states suivant renvoie les approbations de la demande d’extraction spécifiée.

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

Sortie :

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

Pour plus d'informations, consultez la section Afficher les pull requests dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserget-pull-request-override-state.

AWS CLI

Pour obtenir des informations sur le statut de contournement d’une demande d’extraction

L’exemple get-pull-request-override-state suivant renvoie l’état de remplacement pour la demande d’extraction spécifiée. Dans cet exemple, les règles d’approbation de la demande d’extraction ont été remplacées par une utilisatrice, Mary Major, de sorte que la sortie renvoie une valeur true :

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

Sortie :

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

Pour plus d'informations, consultez la section Remplacer les règles d'approbation relatives à une pull request dans le guide de l'AWS CodeCommit utilisateur.

L'exemple de code suivant montre comment utiliserget-pull-request.

AWS CLI

Pour afficher les informations d’une demande d’extraction

Cet exemple montre comment afficher les informations relatives à une demande d’extraction avec l’ID 27.

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

Sortie :

{
    "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"
    }
}

  • Pour plus de détails sur l'API, reportez-vous GetPullRequestà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-repository-triggers.

AWS CLI

Pour obtenir les informations sur les déclencheurs dans un référentiel

Cet exemple montre des détails sur les déclencheurs configurés pour un AWS CodeCommit référentiel nomméMyDemoRepo.

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

Sortie :

{
    "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"
            ]
        }
    ]
}

  • Pour plus de détails sur l'API, reportez-vous GetRepositoryTriggersà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-repository.

AWS CLI

Pour obtenir des informations sur un référentiel

Cet exemple montre les détails d'un AWS CodeCommit dépôt.

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

Sortie :

{
    "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"
    }
}

  • Pour plus de détails sur l'API, reportez-vous GetRepositoryà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-approval-rule-templates.

AWS CLI

Pour répertorier tous les modèles de règles d'approbation d'une AWS région

L’exemple list-approval-rule-templates suivant répertorie tous les modèles de règles d’approbation dans la région spécifiée. Si aucune AWS région n'est spécifiée en tant que paramètre, la commande renvoie des modèles de règles d'approbation pour la région spécifiée dans le profil AWS CLI utilisé pour exécuter la commande.

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

Sortie :

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

Pour plus d'informations, consultez la section Gérer les modèles de règles d'approbation dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserlist-associated-approval-rule-templates-for-repository.

AWS CLI

Pour répertorier tous les modèles associés à un référentiel

L’exemple list-associated-approval-rule-templates-for-repository suivant répertorie tous les modèles de règles d’approbation associés à un référentiel nommé MyDemoRepo.

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

Sortie :

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

Pour plus d'informations, consultez la section Gérer les modèles de règles d'approbation dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserlist-branches.

AWS CLI

Pour consulter la liste des noms de succursales

Cet exemple répertorie tous les noms de branches d'un AWS CodeCommit référentiel.

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

Sortie :

{
    "branches": [
        "MyNewBranch",
        "main"
    ]
}

  • Pour plus de détails sur l'API, reportez-vous ListBranchesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-pull-requests.

AWS CLI

Pour afficher une liste des demandes d’extraction dans un référentiel

Cet exemple montre comment répertorier les pull requests créées par un utilisateur IAM avec l'ARN « arn:aws:iam : :111111111111:user/LI_JUAN » et le statut « CLOSED » dans un référentiel nommé « » : AWS CodeCommit MyDemoRepo

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous ListPullRequestsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-repositories-for-approval-rule-template.

AWS CLI

Pour répertorier tous les référentiels associés à un modèle

L’exemple list-repositories-for-approval-rule-template suivant répertorie tous les référentiels associés au modèle de règle d’approbation spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Gérer les modèles de règles d'approbation dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserlist-repositories.

AWS CLI

Pour afficher la liste des référentiels

Cet exemple répertorie tous les AWS CodeCommit référentiels associés au AWS compte de l'utilisateur.

Commande :

aws codecommit list-repositories

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous ListRepositoriesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-tags-for-resource.

AWS CLI

Pour afficher les AWS balises d'un référentiel

L’exemple list-tags-for-resource suivant répertorie les clés de balise et les valeurs de balise pour le référentiel spécifié.

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

Sortie :

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

Pour plus d'informations, voir Afficher les balises d'un référentiel dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous ListTagsForResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisermerge-branches-by-fast-forward.

AWS CLI

Pour fusionner deux branches à l’aide de la stratégie de fusion rapide

L’exemple merge-branches-by-fast-forward suivant fusionne la branche source spécifiée avec la branche de destination spécifiée dans un référentiel nommé MyDemoRepo.

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

Sortie :

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

Pour plus d'informations, voir Comparer et fusionner des branches dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utilisermerge-branches-by-squash.

AWS CLI

Pour fusionner deux branches à l’aide de la stratégie de fusion par écrasement

L’exemple merge-branches-by-squash suivant fusionne la branche source spécifiée avec la branche de destination spécifiée dans un référentiel nommé MyDemoRepo.

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

Sortie :

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

Pour plus d'informations, voir Comparer et fusionner des branches dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous MergeBranchesBySquashà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisermerge-branches-by-three-way.

AWS CLI

Pour fusionner deux branches à l’aide de la stratégie de fusion tripartite

L’exemple merge-branches-by-three-way suivant fusionne la branche source spécifiée avec la branche de destination spécifiée dans un référentiel nommé MyDemoRepo.

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

Sortie :

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

Pour plus d'informations, voir Comparer et fusionner des branches dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous MergeBranchesByThreeWayà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisermerge-pull-request-by-fast-forward.

AWS CLI

Pour fusionner et fermer une demande d’extraction

Cet exemple montre comment fusionner et fermer une demande d’extraction avec l’ID « 47 » et l’ID de validation source « 99132ab0EXAMPLE » dans un référentiel nommé MyDemoRepo.

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

Sortie :

{
    "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"
    }
}

Pour plus d'informations, voir Fusionner une pull request dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utilisermerge-pull-request-by-squash.

AWS CLI

Pour fusionner une demande d’extraction à l’aide de la stratégie de fusion par écrasement

L’exemple merge-pull-request-by-squash suivant fusionne et ferme la demande d’extraction spécifiée en utilisant la stratégie de résolution de conflits d’ACCEPT_SOURCE dans un référentiel nommé MyDemoRepo.

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"

Sortie :

{
    "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"
    }
}

Pour plus d'informations, voir Fusionner une pull request dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous MergePullRequestBySquashà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisermerge-pull-request-by-three-way.

AWS CLI

Pour fusionner une demande d’extraction à l’aide de la stratégie de fusion tripartite

L’exemple merge-pull-request-by-three-way suivant fusionne et ferme la demande d’extraction spécifiée à l’aide des options par défaut relatives au détail des conflits et à la stratégie de résolution des conflits dans un référentiel nommé MyDemoRepo.

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"

Sortie :

{
    "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"
    }
}

Pour plus d'informations, voir Fusionner une pull request dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliseroverride-pull-request-approval-rules.

AWS CLI

Pour outrepasser les exigences des règles d’approbation pour une demande d’extraction

L’exemple override-pull-request-approval-rules suivant remplace les règles d’approbation relatives à la demande d’extraction spécifiée. Pour révoquer un remplacement, définissez la valeur du paramètre --override-status sur REVOKE.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Remplacer les règles d'approbation relatives à une pull request dans le guide de l'AWS CodeCommit utilisateur.

L'exemple de code suivant montre comment utiliserpost-comment-for-compared-commit.

AWS CLI

Pour créer un commentaire sur un commit

Cet exemple montre comment ajouter le commentaire "Can you add a test case for this?" sur la modification apportée au fichier cl_sample.js lors de la comparaison entre deux validations dans un référentiel nommé MyDemoRepo.

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

Sortie :

{
    "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"
    }
}

L'exemple de code suivant montre comment utiliserpost-comment-for-pull-request.

AWS CLI

Pour ajouter un commentaire à une demande d’extraction

L’exemple post-comment-for-pull-request suivant ajoute le commentaire « These don’t appear to be used anywhere. Can we remove them? » sur la modification apportée au fichier ahs_count.py dans une demande d’extraction avec l’ID 47 dans un référentiel nommé MyDemoRepo.

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

Sortie :

{
     "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"
}

L'exemple de code suivant montre comment utiliserpost-comment-reply.

AWS CLI

Pour répondre à un commentaire sur une validation ou sur une demande d’extraction

Cet exemple montre comment ajouter la réponse "Good catch. I'll remove them." au commentaire avec l’ID abcd1234EXAMPLEb5678efgh généré par le système.

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

Sortie :

{
    "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": []
    }
}

  • Pour plus de détails sur l'API, reportez-vous PostCommentReplyà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserput-comment-reaction.

AWS CLI

Pour répondre à un commentaire sur une validation avec un emoji

L’exemple put-comment-reaction suivant répond à un commentaire avec l’ID abcd1234EXAMPLEb5678efgh avec une valeur de réaction emoji de :thumbsup:.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, voir Commenter un commit AWS CodeCommit dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous PutCommentReactionà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserput-file.

AWS CLI

Pour ajouter un fichier à un référentiel

L'put-fileexemple suivant ajoute un fichier nommé « ExampleSolution .py » à un référentiel nommé « » dans une branche nommée « MyDemoRepo feature-randomizationfeature » dont le dernier commit porte l'ID « 4C925148Example ».

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."

Sortie :

{
    "blobId": "2eb4af3bEXAMPLE",
    "commitId": "317f8570EXAMPLE",
    "treeId": "347a3408EXAMPLE"
}

  • Pour plus de détails sur l'API, reportez-vous PutFileà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserput-repository-triggers.

AWS CLI

Pour ajouter ou mettre à jour un déclencheur dans un référentiel

Cet exemple montre comment mettre à jour les déclencheurs nommés « MyFirstTrigger » et « MySecondTrigger » à l'aide d'un fichier JSON déjà créé (ici nommé MyTriggers .json) qui contient la structure de tous les déclencheurs d'un référentiel nommé. MyDemoRepo Pour savoir comment obtenir le JSON pour les déclencheurs existants, consultez la get-repository-triggers commande.

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

Contenu de 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"
            ]
        }
    ]
}

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous PutRepositoryTriggersà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertag-resource.

AWS CLI

Pour ajouter des AWS balises à un référentiel existant

L’exemple tag-resource suivant ajoute deux balises au référentiel spécifié.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, voir Ajouter une balise à un référentiel dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous TagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertest-repository-triggers.

AWS CLI

Pour tester les déclencheurs dans un référentiel

Cet exemple montre comment tester un déclencheur nommé « MyFirstTrigger » dans un AWS CodeCommit référentiel nommé MyDemoRepo. Dans cet exemple, les événements du référentiel déclenchent des notifications provenant d’une rubrique Amazon Simple Notification Service (Amazon SNS).

Commande :

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous TestRepositoryTriggersà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseruntag-resource.

AWS CLI

Pour supprimer des AWS balises d'un référentiel

L’exemple untag-resource suivant supprime la balise avec la clé spécifiée du référentiel nommé MyDemoRepo.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, voir Supprimer une étiquette d'un référentiel dans le guide de AWS CodeCommit l'utilisateur.

  • Pour plus de détails sur l'API, reportez-vous UntagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-approval-rule-template-content.

AWS CLI

Pour mettre à jour le contenu d’un modèle de règle d’approbation

L’exemple update-approval-rule-template-content suivant modifie le contenu d’un modèle de règle d’approbation spécifié afin de redéfinir le groupe d’approbation sur les utilisateurs assumant le rôle CodeCommitReview.

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/*\"]}]}"

Sortie :

{
    "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"
    }
}

Pour plus d'informations, consultez la section Gérer les modèles de règles d'approbation dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserupdate-approval-rule-template-description.

AWS CLI

Pour mettre à jour la description d’un modèle de règle d’approbation

L’exemple update-approval-rule-template-description suivant modifie la description du modèle de règle d’approbation spécifié pour Requires 1 approval for all pull requests from the CodeCommitReview pool :

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"

Sortie :

{
  "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"
  }
}

Pour plus d'informations, consultez la section Gérer les modèles de règles d'approbation dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserupdate-approval-rule-template-name.

AWS CLI

Pour mettre à jour le nom d’un modèle de règle d’approbation

L'update-approval-rule-template-nameexemple suivant change le nom d'un modèle de règle d'approbation en 1- approver-rule-for-all -pull-requests`. 1-approver-rule

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

Sortie :

{
  "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"
  }
}

Pour plus d'informations, consultez la section Gérer les modèles de règles d'approbation dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserupdate-comment.

AWS CLI

Pour mettre à jour un commentaire sur un commit

Cet exemple montre comment ajouter du contenu "Fixed as requested. I'll update the pull request." à un commentaire avec l’ID 442b498bEXAMPLE5756813.

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

Sortie :

{
    "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
            }
    }
}

  • Pour plus de détails sur l'API, reportez-vous UpdateCommentà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-default-branch.

AWS CLI

Pour modifier la branche par défaut d’un référentiel

Cet exemple modifie la branche par défaut d'un AWS CodeCommit référentiel. Cette commande génère une sortie uniquement en cas d’erreurs.

Commande :

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

Sortie :

None.

  • Pour plus de détails sur l'API, reportez-vous UpdateDefaultBranchà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-pull-request-approval-rule-content.

AWS CLI

Pour modifier une règle d’approbation pour une demande d’extraction

L'update-pull-request-approval-rule-contentexemple suivant met à jour la règle d'approbation qu'elle a spécifiée pour exiger l'approbation d'un utilisateur à partir d'un pool d'approbation qui inclut n'importe quel utilisateur IAM dans le 123456789012 AWS compte.

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/*\"]}]}}"

Sortie :

{
    "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",
    }
}

Pour plus d'informations, voir Modifier ou supprimer une règle d'approbation dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserupdate-pull-request-approval-state.

AWS CLI

Pour approuver ou révoquer l’approbation d’une demande d’extraction

L’exemple update-pull-request-approval-state suivant approuve une demande d’extraction avec l’ID 27 et un ID de révision 9f29d167EXAMPLE. Si vous souhaitez plutôt révoquer l’approbation, définissez la valeur du paramètre --approval-state sur REVOKE.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Révision d'une pull request dans le guide de AWS CodeCommit l'utilisateur.

L'exemple de code suivant montre comment utiliserupdate-pull-request-description.

AWS CLI

Pour modifier la description d’une demande d’extraction

Cet exemple montre comment modifier la description d’une demande d’extraction avec l’ID 47.

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

Sortie :

{
    "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"
    }
}

L'exemple de code suivant montre comment utiliserupdate-pull-request-status.

AWS CLI

Pour modifier le statut d’une demande d’extraction

Cet exemple montre comment modifier le statut d'une pull request avec l'ID de 42 en un statut de CLOSED dans un AWS CodeCommit référentiel nomméMyDemoRepo.

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

Sortie :

{
    "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"
    }
}

  • Pour plus de détails sur l'API, reportez-vous UpdatePullRequestStatusà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-pull-request-title.

AWS CLI

Pour modifier le titre d’une demande d’extraction

Cet exemple montre comment modifier le titre d’une demande d’extraction avec l’ID 47.

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

Sortie :

{
    "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"
    }
}

  • Pour plus de détails sur l'API, reportez-vous UpdatePullRequestTitleà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-repository-description.

AWS CLI

Pour modifier la description d’un référentiel

Cet exemple modifie la description d'un AWS CodeCommit référentiel. Cette commande génère une sortie uniquement en cas d’erreurs.

Commande :

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

Sortie :

None.

L'exemple de code suivant montre comment utiliserupdate-repository-name.

AWS CLI

Pour modifier le nom d’un référentiel

Cet exemple modifie le nom d'un AWS CodeCommit dépôt. Cette commande génère une sortie uniquement en cas d’erreurs. La modification du nom du AWS CodeCommit référentiel modifiera les protocoles SSH et HTTPS URLs dont les utilisateurs ont besoin pour se connecter au référentiel. Les utilisateurs ne pourront pas se connecter à ce référentiel tant qu’ils n’auront pas mis à jour leurs paramètres de connexion. En outre, comme l’ARN du référentiel changera, la modification du nom du référentiel invalidera les stratégies utilisateur IAM basées sur l’ARN de ce référentiel.

Commande :

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

Sortie :

None.

  • Pour plus de détails sur l'API, reportez-vous UpdateRepositoryNameà la section Référence des AWS CLI commandes.