Exemples d’utilisation de l’AWS CLI avec CodeCommit

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, consultez Association d’un modèle de règle d’approbation à un référentiel dans le Guide de l’utilisateur AWS CodeCommit.

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 région AWS dans laquelle ils sont créés. Ils ne peuvent être associés qu’aux référentiels de cette région AWS.

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, consultez Association d’un modèle de règle d’approbation à un référentiel dans le Guide de l’utilisateur AWS CodeCommit.

Pour obtenir les 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 Résolution des conflits dans une demande d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

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, consultez Dissocier un modèle de règle d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

Pour afficher les informations sur plusieurs validations

L’exemple batch-get-commits suivant affiche les 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, consultez Affichage des détails d’une validation dans le Guide de l’utilisateur AWS CodeCommit.

Pour afficher des informations sur plusieurs référentiels

Cet exemple affiche les informations sur plusieurs référentiels AWS CodeCommit.

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 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, consultez Créer un modèle de règle d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

Pour créer une branche

Cet exemple crée une branche dans un référentiel AWS CodeCommit. 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 créer une validation

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 Création d’une validation dans AWS CodeCommit dans le Guide de l’utilisateur AWS CodeCommit.

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 d’un groupe d’approbation sont requises. Le groupe inclut tous les utilisateurs qui accèdent à CodeCommit et assument le rôle CodeCommitReview dans le compte AWS 123456789012. Il inclut également un utilisateur IAM ou un utilisateur fédéré nommé Nikhil_Jayashankar dans le même compte AWS.

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, consultez Créer une règle d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

Pour créer une demande d’extraction

L’exemple create-pull-request suivant crée une demande d’extraction 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 AWS CodeCommit nommé « 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 créer un référentiel

Cet exemple crée un référentiel et l’associe au compte AWS 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 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 Résolution des conflits dans une demande d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

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

L’utilitaire credential-helper n’est pas conçu pour être appelé directement depuis l’AWS CLI. Il est plutôt destiné à être utilisé comme paramètre avec la commande git config pour configurer votre ordinateur local. Cela permet à Git d’utiliser HTTPS et une version signée de manière chiffrée des informations d’identification de votre utilisateur IAM ou du rôle d’instance Amazon EC2 chaque fois que Git doit s’authentifier auprès d’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 Configuration d’AWS CodeCommit à l’aide d’autres méthodes dans le Guide de l’utilisateur AWS CodeCommit. Lisez attentivement le contenu, puis suivez les procédures décrites dans l’une des rubriques suivantes : Pour les connexions HTTPS sur Linux, macOS ou Unix ou Pour les connexions HTTPS sur Windows dans le Guide de l’utilisateur AWS CodeCommit.

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, consultez Supprimer un modèle de règle d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

Pour supprimer une branche

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

Commande :

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

Sortie :

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

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 supprimer un fichier

L’exemple delete-file suivant montre comment supprimer un fichier nommé README.md d’une branche nommée 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, consultez Modification ou suppression d’un fichier AWS CodeCommit dans la Référence des API AWS CodeCommit.

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, consultez Modifier ou supprimer une règle d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

Pour supprimer un référentiel

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

Commande :

aws codecommit delete-repository --repository-name MyDemoRepo

Sortie :

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

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 les branches source et 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 Résolution des conflits dans une demande d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

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

L’exemple describe-pull-request-events suivant récupère les événements d’une demande d’extraction dont l’ID correspond à « 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"
        }
    ]
}

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, consultez Dissocier un modèle de règle d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

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, consultez Fusion d’une demande d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

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 Gérer les modèles de règles d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

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

L’exemple get-blob suivant récupère les informations sur un objet blob Git portant l’ID « 2eb4af3bEXAMPLE » dans un référentiel AWS CodeCommit nommé « MyDemoRepo ».

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

Sortie :

{
    "content": "QSBCaW5hcnkgTGFyToEXAMPLE="
}

Pour obtenir les informations sur une branche

Cet exemple obtient les informations sur une branche dans un référentiel AWS CodeCommit.

Commande :

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

Sortie :

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

Pour afficher les 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, consultez Comment on a commit in AWS CodeCommit dans le Guide de l’utilisateur AWS CodeCommit.

Pour afficher des informations sur un commentaire

Cet exemple montre comment afficher les informations sur un commentaire dont l’ID 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 afficher les commentaires relatifs à une validation

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

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

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

Cet exemple affiche les informations sur une validation avec l’ID généré par le système « 7e9fd3091thisisanexamplethisisanexample1 » dans un référentiel AWS CodeCommit nommé « 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 obtenir les informations sur les différences pour un spécificateur de validation dans un référentiel

Cet exemple affiche les informations de métadonnées relatives aux modifications entre deux spécificateurs de validation (branche, balise, HEAD ou autres références complètes, telles que les ID de validation) dans un dossier renommé MyDemoRepo dans AWS CodeCommit. 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 obtenir le contenu encodé en base 64 d’un fichier dans un référentiel AWS CodeCommit

L’exemple get-file suivant montre comment obtenir le contenu encodé 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 GetFile dans la Référence des API AWS CodeCommit.

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

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 dans la Référence des API AWS CodeCommit.

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

L’exemple get-merge-commit suivant affiche les 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, consultez Affichage des détails d’une validation dans le Guide de l’utilisateur AWS CodeCommit.

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 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 Résolution des conflits dans une demande d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

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 Affichage des demandes d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

Pour obtenir les 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 Remplacer les règles d’approbation pour une demande d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

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 obtenir les informations sur les déclencheurs dans un référentiel

Cet exemple affiche les informations sur les déclencheurs configurés pour un référentiel AWS CodeCommit 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 obtenir les informations sur un référentiel

Cet exemple affiche les informations sur un référentiel AWS CodeCommit.

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 répertorier tous les modèles de règles d’approbation d’une région AWS

L’exemple list-approval-rule-templates suivant répertorie tous les modèles de règles d’approbation de la région spécifiée. Si aucune région AWS 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 Gérer les modèles de règles d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

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 Gérer les modèles de règles d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

Pour afficher la liste des noms de branche

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

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

Sortie :

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

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

Cet exemple montre comment répertorier les demandes d’extraction 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 AWS CodeCommit nommé « 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 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 Gérer les modèles de règles d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

Pour afficher la liste des référentiels

Cet exemple répertorie tous les référentiels AWS CodeCommit associés au compte AWS 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 afficher les balises AWS d’un référentiel

L’exemple list-tags-for-resource suivant répertorie les clés de balise et les valeurs de balise du 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, consultez Affichage des balises pour un référentiel dans le Guide de l’utilisateur AWS CodeCommit.

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, consultez Comparer et fusionner des branches dans le Guide de l’utilisateur AWS CodeCommit.

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, consultez Comparer et fusionner des branches dans le Guide de l’utilisateur AWS CodeCommit.

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, consultez Comparer et fusionner des branches dans le Guide de l’utilisateur AWS CodeCommit.

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, consultez Fusion d’une demande d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

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 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, consultez Fusion d’une demande d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

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, consultez Fusion d’une demande d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

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 Remplacer les règles d’approbation pour une demande d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

Pour créer un commentaire sur une validation

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

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

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 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 la valeur de réaction emoji :thumbsup:.

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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Comment on a commit in AWS CodeCommit dans le Guide de l’utilisateur AWS CodeCommit.

Pour ajouter un fichier dans un référentiel

L’exemple put-file suivant ajoute un fichier nommé « ExampleSolution.py » à un référentiel nommé « MyDemoRepo », dans une branche nommée « feature-randomizationfeature », dont la validation la plus récente a 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 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 fichier JSON pour les déclencheurs existants, consultez la commande get-repository-triggers.

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 ajouter des balises AWS à 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, consultez Ajout d’une balise à un référentiel dans le Guide de l’utilisateur AWS CodeCommit.

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

Cet exemple montre comment tester un déclencheur nommé « MyFirstTrigger » dans un référentiel AWS CodeCommit 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 supprimer des balises AWS 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, consultez Suppression d’une balise d’un référentiel dans le Guide de l’utilisateur AWS CodeCommit.

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 Gérer les modèles de règles d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

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

L’exemple update-approval-rule-template-description suivant remplace la description du modèle de règle d’approbation spécifié par 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 Gérer les modèles de règles d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

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

L’exemple update-approval-rule-template-name suivant remplace le nom d’un modèle de règle d’approbation 1-approver-rule par 1-approver-rule-for-all-pull-requests`.

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 Gérer les modèles de règles d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

Pour mettre à jour un commentaire sur une validation

Cet exemple montre comment ajouter le 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 modifier la branche par défaut d’un référentiel

Cet exemple modifie la branche par défaut d’un référentiel AWS CodeCommit. 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 modifier une règle d’approbation pour une demande d’extraction

L’exemple update-pull-request-approval-rule-content suivant met à jour la règle d’approbation spécifiée pour exiger l’approbation d’un utilisateur à partir d’un groupe d’approbation qui inclut n’importe quel utilisateur IAM du compte AWS 123456789012.

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, consultez Modifier ou supprimer une règle d’approbation dans le Guide de l’utilisateur AWS CodeCommit.

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 l’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 Révision d’une demande d’extraction dans le Guide de l’utilisateur AWS CodeCommit.

Pour modifier la description d’une demande d’extraction

Cet exemple montre comment modifier la description d’une demande d’extraction ayant 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"
    }
}

Pour modifier le statut d’une demande d’extraction

Cet exemple montre comment remplacer le statut d’une demande d’extraction ayant l’ID 42 par le statut CLOSED dans un référentiel AWS CodeCommit 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 modifier le titre d’une demande d’extraction

Cet exemple montre comment modifier le titre d’une demande d’extraction ayant 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 modifier la description d’un référentiel

Cet exemple modifie la description d’un référentiel AWS CodeCommit. 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.

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

Cet exemple modifie le nom d’un référentiel AWS CodeCommit. Cette commande génère une sortie uniquement en cas d’erreurs. La modification du nom du référentiel AWS CodeCommit modifie les URL SSH et HTTPS 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 politiques 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.