Ejemplos de CodeCommit que utilizan la AWS CLI

Asociación de una plantilla de regla de aprobación con un repositorio

En el siguiente ejemplo de associate-approval-rule-template-with-repository, se asocia la plantilla de regla de aprobación especificada con un repositorio denominado MyDemoRepo.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Asociar una plantilla de regla de aprobación con un repositorio en la Guía del usuario de AWS CodeCommit.

Asociación de una plantilla de regla de aprobación con varios repositorios en una sola operación

En el siguiente ejemplo de batch-associate-approval-rule-template-with-repositories, se asocia la plantilla de regla de aprobación especificada con los repositorios denominados MyDemoRepo y MyOtherDemoRepo.

Nota: Las plantillas de reglas de aprobación son específicas de la región de AWS en la que se crean. Solo se pueden asociar a los repositorios de dicha región de AWS.

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

Salida:

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

Para obtener más información, consulte Asociar una plantilla de regla de aprobación con un repositorio en la Guía del usuario de AWS CodeCommit.

Obtención de información sobre los conflictos de combinación en todos los archivos o un subconjunto de archivos de una combinación de dos especificadores de confirmación

En el siguiente ejemplo de batch-describe-merge-conflicts, se determinan los conflictos de combinación al combinar una ramificación de origen denominada feature-randomizationfeature con una ramificación de destino denominada main utilizando la estrategia THREE_WAY_MERGE de un repositorio denominado MyDemoRepo.

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

Salida:

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

Para obtener más información, consulte Resolver conflictos en una solicitud de extracción en la Guía del usuario de AWS CodeCommit.

Desasociación de una plantilla de regla de aprobación de varios repositorios en una única operación

En el siguiente ejemplo de batch-disassociate-approval-rule-template-from-repositories, se desasocia la plantilla de regla de aprobación especificada de los repositorios denominados MyDemoRepo y 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

Salida:

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

Para obtener más información, consulte Desasociar una plantilla de regla de aprobación en la Guía del usuario de AWS CodeCommit.

Visualización de información acerca de varias confirmaciones

En el siguiente ejemplo de batch-get-commits, se muestran los detalles de las confirmaciones especificadas.

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

Salida:

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

Para obtener más información, consulte Consulta los detalles de la confirmación en la Guía del usuario de AWS CodeCommit.

Visualización de información de varios repositorios

En este ejemplo, se muestra información sobre varios repositorios de AWS CodeCommit.

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

Salida:

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

Creación de una plantilla de regla de aprobación

En el siguiente ejemplo de create-approval-rule-template, se crea una plantilla de regla de aprobación denominada 2-approver-rule-for-main ``. The template requires two users who assume the role of ``CodeCommitReview para aprobar cualquier solicitud de extracción antes de que se pueda combinar con la ramificación 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/*\"]}]}"

Salida:

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

Para obtener más información, consulte Crear una plantilla de regla de aprobación en la Guía del usuario de AWS CodeCommit.

Creación de una ramificación

En este ejemplo, se crea una ramificación en un repositorio de AWS CodeCommit. Este comando devuelve resultados solo si hay errores.

Comando:

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

Salida:

None.

Creación de una confirmación

En el siguiente ejemplo de create-commit, se muestra cómo crear una confirmación inicial para un repositorio que añada un archivo readme.md a un repositorio denominado MyDemoRepo en la ramificación main.

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

Salida:

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

Para obtener más información, consulte Creación de una confirmación en AWS CodeCommit en la Guía del usuario de AWS CodeCommit.

Creación de una regla de aprobación para una solicitud de extracción

En el ejemplo siguiente de create-pull-request-approval-rule, se crea una regla de aprobación denominada Require two approved approvers para una solicitud de extracción especificada. La regla especifica que se requieren dos aprobaciones de un grupo de aprobación. El grupo incluye a todos los usuarios que acceden a CodeCommit y asumen el rol de CodeCommitReview en la cuenta de AWS 123456789012. También incluye un usuario de IAM o un usuario federado denominado Nikhil_Jayashankar en la misma cuenta de 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/*\"]}]}"

Salida:

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

Para obtener más información, consulte Crear una regla de aprobación en la Guía del usuario de AWS CodeCommit.

Creación de una solicitud de extracción

En el siguiente ejemplo de create-pull-request, se crea una solicitud de extracción denominada Pronunciation difficulty analyzer (Analizador de dificultades de pronunciación) con la descripción Please review these changes by Tuesday (Revisar estos cambios antes del martes) que se dirige a la ramificación de origen jane-branch y se combina con la ramificación predeterminada main de un repositorio de AWS CodeCommit denominado 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

Salida:

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

Creación de un repositorio

En este ejemplo, se crea un repositorio y se asocia a la cuenta de AWS del usuario.

Comando:

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

Salida:

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

Creación de una confirmación sin referencia que representa el resultado de combinar dos especificadores

En el siguiente ejemplo de create-unreferenced-merge-commit, se crea una confirmación que representa los resultados de una combinación entre una ramificación de origen denominada bugfix-1234 con una ramificación de destino denominada main con la estrategia THREE_WAY_MERGE en un repositorio llamado 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."

Salida:

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

Para obtener más información, consulte Resolver conflictos en una solicitud de extracción en la Guía del usuario de AWS CodeCommit.

Configuración del ayudante de credenciales incluido en la AWS CLI con AWS CodeCommit

La utilidad credential-helper no está diseñada para llamarla directamente desde la AWS CLI. Por el contrario, está pensada para usarse como parámetro con el comando git config al configurar el equipo local. Permite que Git use HTTPS y una versión con firma criptográfica de sus credenciales de usuario de IAM o del rol de la instancia de Amazon EC2 cada vez que Git requiera autenticarse con AWS para interactuar con los repositorios de CodeCommit.

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

Salida:

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

Para obtener más información, consulte Configuración de AWS CodeCommit con otros métodos en la Guía del usuario de AWS CodeCommit. Revise el contenido detenidamente y, a continuación, siga los procedimientos descritos en uno de los siguientes temas: Para configurar conexiones HTTPS en Linux, macOS o Unix o Para configurar conexiones HTTPS en Windows en la Guía del usuario de AWS CodeCommit.

Eliminación de una plantilla de regla de aprobación

En el siguiente ejemplo de delete-approval-rule-template, se elimina la plantilla de regla de aprobación especificada.

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

Salida:

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

Para obtener más información, consulte Eliminar una plantilla de regla de aprobación en la Guía del usuario de AWS CodeCommit.

Eliminación de una ramificación

En este ejemplo se muestra cómo eliminar una ramificación en un repositorio de AWS CodeCommit.

Comando:

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

Salida:

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

Eliminación del contenido de un comentario

Solo puede eliminar el contenido de un comentario que ha creado usted mismo. En este ejemplo, se muestra cómo eliminar el contenido de un comentario con el ID generado por el sistema ff30b348EXAMPLEb9aa670f.

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

Salida:

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

Eliminación de un archivo

En el siguiente ejemplo de delete-file, se muestra cómo eliminar un archivo denominado README.md de una ramificación denominada main con el ID de confirmación más reciente c5709475EXAMPLE en un repositorio denominado MyDemoRepo.

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

Salida:

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

Para obtener más información, consulte Editar o eliminar un archivo en AWS CodeCommit en la guía Referencia de la API de AWS CodeCommit.

Eliminación de una regla de aprobación de una solicitud de extracción

En el siguiente ejemplo de delete-pull-request-approval-rule, se elimina una regla de aprobación denominada My Approval Rule de una solicitud de extracción especificada.

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

Salida:

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

Para obtener más información, consulte Editar o eliminar una regla de aprobación en la Guía del usuario de AWS CodeCommit.

Eliminación de un repositorio

En este ejemplo, se muestra cómo eliminar un repositorio de AWS CodeCommit.

Comando:

aws codecommit delete-repository --repository-name MyDemoRepo

Salida:

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

Obtención de información detallada sobre los conflictos de combinación

En el siguiente ejemplo de describe-merge-conflicts, se determinan los conflictos de combinación de un archivo denominado readme.md en las ramificaciones de origen y destino especificadas con la estrategia 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

Salida:

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

Para obtener más información, consulte Resolver conflictos en una solicitud de extracción en la Guía del usuario de AWS CodeCommit.

Visualización de los eventos de una solicitud de extracción

En el siguiente ejemplo de describe-pull-request-events, se recuperan los eventos de una solicitud de extracción con el ID 8.

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

Salida:

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

Desasociación de una plantilla de regla de aprobación de un repositorio

En el siguiente ejemplo de disassociate-approval-rule-template-from-repository, se desasocia la plantilla de regla de aprobación especificada de un repositorio denominado MyDemoRepo.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Desasociar una plantilla de regla de aprobación en la Guía del usuario de AWS CodeCommit.

Evaluación de si una solicitud de extracción cumple con todas las reglas de aprobación

En el siguiente ejemplo de evaluate-pull-request-approval-rules, se evalúa el estado de las reglas de aprobación de la solicitud de extracción especificada. En este ejemplo, no se cumple una regla de aprobación en la solicitud de extracción, por lo que el resultado del comando muestra false en el valor approved.

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

Salida:

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

Para obtener más información, consulte Combinación de una solicitud de extracción en la Guía del usuario de AWS CodeCommit.

Obtención del contenido de una plantilla de regla de aprobación

En el siguiente ejemplo de get-approval-rule-template, se obtiene el contenido de una plantilla de regla de aprobación denominada 1-approver-rule-for-all-pull-requests.

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

Salida:

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

Para obtener más información, consulte Administrar plantillas de reglas de aprobación en la Guía del usuario de AWS CodeCommit.

Visualización de información sobre un objeto blob de Git

En el siguiente ejemplo de get-blob, se recupera información acerca de un blob de Git con el ID 2eb4af3bEXAMPLE de un repositorio de AWS CodeCommit denominado MyDemoRepo.

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

Salida:

{
    "content": "QSBCaW5hcnkgTGFyToEXAMPLE="
}

Obtención de información sobre una ramificación

En este ejemplo, se obtiene información sobre una ramificación de un repositorio de AWS CodeCommit.

Comando:

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

Salida:

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

Visualización de las reacciones con emojis a un comentario

En el siguiente ejemplo de get-comment-reactions, se genera una lista de todas las reacciones con emojis a un comentario con el ID abcd1234EXAMPLEb5678efgh. Si la fuente del intérprete de comandos admite la visualización de Emoji versión 1.0, en la salida de emoji, se mostrará el emoji.

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

Salida:

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

Para obtener más información, consulte Comenta una confirmación en AWS CodeCommit en la Guía del usuario de AWS CodeCommit.

Visualización de los detalles de un comentario

En este ejemplo, se muestra cómo ver los detalles de un comentario con el ID generado por el sistema ff30b348EXAMPLEb9aa670f.

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

Salida:

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

Visualización de los comentarios sobre una confirmación

En este ejemplo se muestra cómo ver los comentarios realizados en la comparación de dos confirmaciones en un repositorio denominado MyDemoRepo.

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

Salida:

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

Visualización de los comentarios de una solicitud de extracción

En este ejemplo, se muestra cómo ver los comentarios de una solicitud de extracción en un repositorio denominado MyDemoRepo.

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

Salida:

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

Visualización de la información sobre una confirmación en un repositorio

En este ejemplo, se muestran detalles sobre una confirmación con el ID generado por el sistema 7e9fd3091thisisanexamplethisisanexample1 en un repositorio de AWS CodeCommit denominado MyDemoRepo.

Comando:

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

Salida:

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

Obtención de información sobre las diferencias de un especificador de confirmación en un repositorio

En este ejemplo, se muestra información de metadatos de visualización acerca de los cambios entre dos especificadores de confirmación (ramificación, etiqueta, HEAD u otras referencias completas, como los ID de confirmación) en una carpeta con nombre cambiado del repositorio de AWS CodeCommit denominado MyDemoRepo. En el ejemplo, se incluyen varias opciones que no son obligatorias, como --before-commit-specifier, --before-path y --afterpath, para ilustrar con más detalle cómo se pueden utilizar estas opciones para limitar los resultados. La respuesta incluye los permisos del modo de archivo.

Comando:

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

Salida:

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

Obtención del contenido codificado en base-64 de un archivo en un repositorio de AWS CodeCommit

En el siguiente ejemplo de get-file, se muestra cómo obtener el contenido codificado en base-64 de un archivo denominado README.md a partir de una ramificación denominada main en un repositorio llamado MyDemoRepo.

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

Salida:

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

Para obtener más información, consulte GetFile en la guía Referencia de la API de AWS CodeCommit.

Obtención del contenido de una carpeta en un repositorio de AWS CodeCommit

En el siguiente ejemplo de get-folder, se muestra cómo obtener el contenido de una carpeta de nivel superior de un repositorio denominado MyDemoRepo.

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

Salida:

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

Para obtener más información, consulte GetFolder en la guía Referencia de la API de AWS CodeCommit.

Visualización de información sobre una confirmación de combinación

En el siguiente ejemplo de get-merge-commit, se muestra información sobre una confirmación de combinación de la ramificación de origen denominada bugfix-bug1234 con una ramificación de destino denominada main utilizando la estrategia THREE_WAY_MERGE en un repositorio llamado MyDemoRepo.

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

Salida:

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

Para obtener más información, consulte Consulta los detalles de la confirmación en la Guía del usuario de AWS CodeCommit.

Visualización de si existen conflictos de combinación en una solicitud de extracción

En el siguiente ejemplo de get-merge-conflicts, se muestra si existen conflictos de combinación entre el extremo de una ramificación de origen denominada feature-randomizationfeature y una ramificación de destino denominada main en un repositorio llamado MyDemoRepo.

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

Salida:

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

Obtención de información sobre las opciones de combinación disponibles para combinar dos ramificaciones específicas

En el siguiente ejemplo de get-merge-options, se determinan las opciones de combinación disponibles para combinar una ramificación de origen denominada bugfix-bug1234 con una ramificación de destino denominada main en un repositorio llamado MyDemoRepo.

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

Salida:

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

Para obtener más información, consulte Resolver conflictos en una solicitud de extracción en la Guía del usuario de AWS CodeCommit.

Visualización de aprobaciones en una solicitud de extracción

En el siguiente ejemplo de get-pull-request-approval-states, se obtienen las aprobaciones de una solicitud de extracción especificada.

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

Salida:

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

Para obtener más información, consulte Visualizar las solicitudes de extracción en la Guía del usuario de AWS CodeCommit.

Obtención de información sobre el estado de anulación de una solicitud de extracción

En el siguiente ejemplo de get-pull-request-override-state, se obtiene el estado de anulación de una solicitud de extracción especificada. En este ejemplo, una usuaria llamada Mary Major ha anulado las reglas de aprobación de la solicitud de extracción, por lo que la salida es un valor de true.

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

Salida:

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

Para obtener más información, consulte Anular reglas de aprobación en una solicitud de extracción en la Guía del usuario de AWS CodeCommit.

Visualización de detalles de una solicitud de extracción

En este ejemplo, se muestra cómo ver la información sobre una solicitud de extracción con el ID 27.

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

Salida:

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

Obtención de información sobre los activadores de un repositorio

En este ejemplo, se muestran detalles sobre los activadores configurados para un repositorio de AWS CodeCommit denominado MyDemoRepo.

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

Salida:

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

Obtención de información sobre un repositorio

En este ejemplo, se muestra información sobre un repositorio de AWS CodeCommit.

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

Salida:

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

Generación de una lista de todas las plantillas de reglas de aprobación de una región de AWS

En el siguiente ejemplo de list-approval-rule-templates, se genera una lista de todas las plantillas de regla de aprobación de la región especificada. Si no se especifica ninguna región de AWS como parámetro, el comando muestra las plantillas de reglas de aprobación de la región especificada en el perfil de la AWS CLI utilizado para ejecutar el comando.

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

Salida:

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

Para obtener más información, consulte Administrar plantillas de reglas de aprobación en la Guía del usuario de AWS CodeCommit.

Para enumerar todas las plantillas asociadas con un repositorio

En el siguiente ejemplo de list-associated-approval-rule-templates-for-repository, se genera una lista de todas las plantillas de regla de aprobación asociadas a un repositorio denominado MyDemoRepo.

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

Salida:

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

Para obtener más información, consulte Administrar plantillas de reglas de aprobación en la Guía del usuario de AWS CodeCommit.

Visualización de una lista de los nombres de ramificaciones

En este ejemplo, se genera una lista de todos los nombres de ramificaciones en un repositorio de AWS CodeCommit.

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

Salida:

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

Visualización de una lista de las solicitudes de extracción de un repositorio

En este ejemplo, se muestra cómo generar una lista de las solicitudes de extracción que ha creado un usuario de IAM cuyo ARN es arn:aws:iam::111111111111:user/Li_Juan y cuyo estado es CLOSED en un repositorio de AWS CodeCommit denominado MyDemoRepo:

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

Salida:

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

Para enumerar todos los repositorios asociados con una plantilla

En el siguiente ejemplo de list-repositories-for-approval-rule-template, se genera una lista de todos los repositorios asociados a una plantilla de regla de aprobación especificada.

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

Salida:

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

Para obtener más información, consulte Administrar plantillas de reglas de aprobación en la Guía del usuario de AWS CodeCommit.

Visualización de una lista de repositorios

En este ejemplo, se genera una lista de todos los repositorios de AWS CodeCommit asociados a la cuenta de AWS del usuario.

Comando:

aws codecommit list-repositories

Salida:

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

Visualización de las etiquetas de AWS de un repositorio

En el siguiente ejemplo de list-tags-for-resource, se muestran las claves y los valores de las etiquetas del repositorio especificado.

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

Salida:

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

Para obtener más información, consulte Visualización de etiquetas para un repositorio en la Guía del usuario de AWS CodeCommit.

Combinación de dos ramificaciones mediante la estrategia de combinación de avance rápido

En el siguiente ejemplo de merge-branches-by-fast-forward, se combina la ramificación de origen especificada con la ramificación de destino especificada en un repositorio denominado MyDemoRepo.

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

Salida:

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

Para obtener más información, consulte Comparación y combinación de ramificaciones en la Guía del usuario de AWS CodeCommit.

Combinación de dos ramificaciones mediante la estrategia de combinación de squash

En el siguiente ejemplo de merge-branches-by-squash, se combina la ramificación de origen especificada con la ramificación de destino especificada en un repositorio denominado 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

Salida:

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

Para obtener más información, consulte Comparación y combinación de ramificaciones en la Guía del usuario de AWS CodeCommit.

Combinación de dos ramificaciones mediante la estrategia de combinación de tres modos

En el siguiente ejemplo de merge-branches-by-three-way, se combina la ramificación de origen especificada con la ramificación de destino especificada en un repositorio denominado 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

Salida:

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

Para obtener más información, consulte Comparación y combinación de ramificaciones en la Guía del usuario de AWS CodeCommit.

Combinación y cierre de una solicitud de extracción

En este ejemplo se muestra cómo combinar y cerrar una solicitud de extracción con el ID 47 y el ID de confirmación de origen 99132ab0EXAMPLE en un repositorio llamado MyDemoRepo.

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

Salida:

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

Para obtener más información, consulte Combinación de una solicitud de extracción en la Guía del usuario de AWS CodeCommit.

Combinación una solicitud de extracción mediante la estrategia de combinación de squash

En el siguiente ejemplo de merge-pull-request-by-squash, se combina y cierra la solicitud de extracción especificada mediante la estrategia de resolución de conflictos de ACCEPT_SOURCE en un repositorio denominado 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"

Salida:

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

Para obtener más información, consulte Combinación de una solicitud de extracción en la Guía del usuario de AWS CodeCommit.

Combinación de una solicitud de extracción mediante la estrategia de combinación de tres modos

En el siguiente ejemplo de merge-pull-request-by-three-way, se combina y cierra la solicitud de extracción especificada con las opciones predeterminadas de detalles de conflicto y con la estrategia de resolución de conflictos en un repositorio denominado 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"

Salida:

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

Para obtener más información, consulte Combinación de una solicitud de extracción en la Guía del usuario de AWS CodeCommit.

Para sustituir los requisitos de reglas de aprobación en una solicitud de extracción

En el siguiente ejemplo de override-pull-request-approval-rules, se anulan las reglas de aprobación de una solicitud de extracción especificada. Para, en lugar de ello, revocar una anulación, se define el valor de parámetro --override-status en REVOKE.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Anular reglas de aprobación en una solicitud de extracción en la Guía del usuario de AWS CodeCommit.

Creación de un comentario sobre una confirmación

En este ejemplo, se muestra cómo añadir el comentario "Can you add a test case for this?" al cambio del archivo cl_sample.js en la comparación de dos confirmaciones en un repositorio denominado 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

Salida:

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

Adición de un comentario a una solicitud de extracción

En el siguiente ejemplo de post-comment-for-pull-request, se añade el comentario These don't appear to be used anywhere. Can we remove them?" en el cambio realizado en el archivo ahs_count.py en una solicitud de extracción con el ID 47 en un repositorio denominado 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

Salida:

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

Respuesta a un comentario en una confirmación o en una solicitud de extracción

En este ejemplo, se muestra cómo añadir la respuesta "Good catch. I'll remove them." a un comentario con el ID generado por el sistema abcd1234EXAMPLEb5678efgh.

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

Salida:

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

Respuesta a un comentario sobre una confirmación con un emoji

En el siguiente ejemplo de put-comment-reaction, se responde a un comentario con el ID abcd1234EXAMPLEb5678efgh con un valor de reacción de emoji de :thumbsup:.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Comenta una confirmación en AWS CodeCommit en la Guía del usuario de AWS CodeCommit.

Adición de un archivo a un repositorio

En el siguiente ejemplo de put-file, se añade un archivo denominado ExampleSolution.py a un repositorio llamado MyDemoRepo en una ramificación denominada feature-randomizationfeature cuya confirmación más reciente tiene un ID de 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."

Salida:

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

Adición o actualización de un activador en un repositorio

En este ejemplo, se muestra cómo actualizar los activadores denominados MyFirstTrigger y MySecondTrigger mediante un archivo JSON ya creado (aquí denominado MyTriggers.json) que contiene la estructura de todos los activadores de un repositorio denominado MyDemoRepo. Para obtener información sobre cómo obtener el JSON de los activadores existentes, consulte el comando get-repository-triggers.

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

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

Salida:

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

Adición de etiquetas de AWS a un repositorio ya existente

En el siguiente ejemplo de tag-resource, se añaden dos etiquetas al repositorio especificado.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Añadir una etiqueta a un repositorio en la Guía del usuario de AWS CodeCommit.

Prueba de los activadores en un repositorio

En este ejemplo, se muestra cómo probar un activador denominado MyFirstTrigger en un repositorio de AWS CodeCommit denominado MyDemoRepo. En este ejemplo, los eventos del repositorio activan notificaciones de un tema de Amazon Simple Notification Service (Amazon SNS).

Comando:

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

Salida:

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

Eliminación de etiquetas de AWS de un repositorio

En el siguiente ejemplo de untag-resource, se elimina la etiqueta con la clave especificada del repositorio denominado MyDemoRepo.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Eliminar una etiqueta de un repositorio en la Guía del usuario de AWS CodeCommit.

Actualización del contenido de una plantilla de regla de aprobación

En este ejemplo de update-approval-rule-template-content se cambia el contenido de la plantilla de regla de aprobación especificada para redefinir el grupo de aprobación de manera que incluya a los usuarios que asuman el rol 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/*\"]}]}"

Salida:

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

Para obtener más información, consulte Administrar plantillas de reglas de aprobación en la Guía del usuario de AWS CodeCommit.

Actualización de la descripción de una plantilla de regla de aprobación

En el siguiente ejemplo de update-approval-rule-template-description, se cambia a Requires 1 approval for all pull requests from the CodeCommitReview pool la descripción de la plantilla de regla de aprobación especificada.

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"

Salida:

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

Para obtener más información, consulte Administrar plantillas de reglas de aprobación en la Guía del usuario de AWS CodeCommit.

Actualización del nombre de una plantilla de regla de aprobación

En el siguiente ejemplo de update-approval-rule-template-name, se cambia el nombre de una plantilla de regla de aprobación de 1-approver-rule a 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

Salida:

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

Para obtener más información, consulte Administrar plantillas de reglas de aprobación en la Guía del usuario de AWS CodeCommit.

Actualización de un comentario sobre una confirmación

En este ejemplo, se muestra cómo añadir el contenido "Fixed as requested. I'll update the pull request." a un comentario con un ID 442b498bEXAMPLE5756813.

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

Salida:

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

Cambio de la ramificación predeterminada de un repositorio

En este ejemplo, se cambia la ramificación predeterminada de un repositorio de AWS CodeCommit. Este comando devuelve resultados solo si hay errores.

Comando:

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

Salida:

None.

Edición de una regla de aprobación de una solicitud de extracción

En el siguiente ejemplo de update-pull-request-approval-rule-content, se actualiza la regla de aprobación especificada de manera que se requiera la aprobación de un usuario de un grupo de aprobación que incluya a cualquier usuario de IAM de la cuenta de 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/*\"]}]}}"

Salida:

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

Para obtener más información, consulte Editar o eliminar una regla de aprobación en la Guía del usuario de AWS CodeCommit.

Aprobación o revocación de la aprobación de una solicitud de extracción

En el siguiente ejemplo de update-pull-request-approval-state, se aprueba una solicitud de extracción con el ID 27 y el ID de revisión 9f29d167EXAMPLE. Si, en su lugar, desea revocar la aprobación, defina el valor del parámetro --approval-state en REVOKE.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Revisión de una solicitud de extracción en la Guía del usuario de AWS CodeCommit.

Cambio de la descripción de una solicitud de extracción

En este ejemplo se muestra cómo cambiar la descripción de una solicitud de extracción con el ID 47.

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

Salida:

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

Cambio del estado de una solicitud de extracción

En este ejemplo, se muestra cómo cambiar el estado de una solicitud de extracción con el ID 42 a un estado de CLOSED en un repositorio de AWS CodeCommit denominado MyDemoRepo.

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

Salida:

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

Cambio del título de una solicitud de extracción

En este ejemplo, se muestra cómo cambiar el título de una solicitud de extracción con el ID 47.

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

Salida:

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

Cambio de la descripción de un repositorio

En este ejemplo, se cambia la descripción de un repositorio de AWS CodeCommit. Este comando devuelve resultados solo si hay errores.

Comando:

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

Salida:

None.

Cambio del nombre de un repositorio

En este ejemplo, se cambia el nombre de un repositorio de AWS CodeCommit. Este comando devuelve resultados solo si hay errores. Si cambia el nombre del repositorio de AWS CodeCommit, se cambiarán las URL SSH y HTTPS que los usuarios necesitan para conectarse al repositorio. Para que los usuarios puedan conectarse a este repositorio, tendrán que actualizar la configuración de la conexión. Además, puesto que el repositorio cambiará el ARN, al cambiar el nombre del repositorio, se invalidarán las políticas del usuario de IAM que confían en este ARN del repositorio.

Comando:

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

Salida:

None.