diff --git a/.github/workflows/triage-stale-check.yml b/.github/workflows/triage-stale-check.yml index 9e451324e61b..9fbcd5665f0a 100644 --- a/.github/workflows/triage-stale-check.yml +++ b/.github/workflows/triage-stale-check.yml @@ -7,7 +7,7 @@ name: Public Repo Stale Check on: schedule: - cron: '45 16 * * *' # Run each day at 16:45 UTC / 8:45 PST - + permissions: issues: write pull-requests: write diff --git a/content/github-cli/github-cli/creating-github-cli-extensions.md b/content/github-cli/github-cli/creating-github-cli-extensions.md index 589ce46209e7..e51a8bd6a9bb 100644 --- a/content/github-cli/github-cli/creating-github-cli-extensions.md +++ b/content/github-cli/github-cli/creating-github-cli-extensions.md @@ -14,15 +14,21 @@ topics: {% data reusables.cli.cli-extensions %} For more information about how to use {% data variables.product.prodname_cli %} extensions, see "[Using {% data variables.product.prodname_cli %} extensions](/github-cli/github-cli/using-github-cli-extensions)." -You need a repository for each extension that you create. The repository name must start with `gh-`. The rest of the repository name is the name of the extension. At the root of the repository, there must be an executable file with the same name as the repository. This file will be executed when the extension is invoked. +You need a repository for each extension that you create. The repository name must start with `gh-`. The rest of the repository name is the name of the extension. The repository must have an executable file at its root with the same name as the repository or a set of precompiled binary executables attached to a release. {% note %} -**Note**: We recommend that the executable file is a bash script because bash is a widely available interpreter. You may use non-bash scripts, but the user must have the necessary interpreter installed in order to use the extension. +**Note**: When relying on an executable script, we recommend using a bash script because bash is a widely available interpreter. You may use non-bash scripts, but the user must have the necessary interpreter installed in order to use the extension. If you would prefer to not rely on users having interpreters installed, consider a precompiled extension. {% endnote %} -## Creating an extension with `gh extension create` +## Creating an interpreted extension with `gh extension create` + +{% note %} + +**Note**: Running `gh extension create` with no arguments will start an interactive wizard. + +{% endnote %} You can use the `gh extension create` command to create a project for your extension, including a bash script that contains some starter code. @@ -34,7 +40,35 @@ You can use the `gh extension create` command to create a project for your exten 1. Follow the printed instructions to finalize and optionally publish your extension. -## Creating an extension manually +## Creating a precompiled extension in Go with `gh extension create` + +You can use the `--precompiled=go` argument to create a Go-based project for your extension, including Go scaffolding, workflow scaffolding, and starter code. + +1. Set up a new extension by using the `gh extension create` subcommand. Replace `EXTENSION-NAME` with the name of your extension and specify `--precompiled=go`. + + ```shell + gh extension create --precompiled=go EXTENSION-NAME + ``` + +1. Follow the printed instructions to finalize and optionally publish your extension. + +## Creating a non-Go precompiled extension with `gh extension create` + +You can use the `--precompiled=other` argument to create a project for your non-Go precompiled extension, including workflow scaffolding. + +1. Set up a new extension by using the `gh extension create` subcommand. Replace `EXTENSION-NAME` with the name of your extension and specify `--precompiled=other`. + + ```shell + gh extension create --precompiled=other EXTENSION-NAME + ``` + +1. Add some initial code for your extension in your compiled language of choice. + +1. Fill in `script/build.sh` with code to build your extension to ensure that your extension can be built automatically. + +1. Follow the printed instructions to finalize and optionally publish your extension. + +## Creating an interpreted extension manually 1. Create a local directory called `gh-EXTENSION-NAME` for your extension. Replace `EXTENSION-NAME` with the name of your extension. For example, `gh-whoami`. @@ -56,7 +90,7 @@ You can use the `gh extension create` command to create a project for your exten 1. From your directory, install the extension as a local extension. - ```bash + ```shell gh extension install . ``` @@ -70,13 +104,13 @@ You can use the `gh extension create` command to create a project for your exten ```shell git init -b main - git add . && git commit -m "initial commit" - gh repo create gh-EXTENSION-NAME --source=. --public --push + git add . && git commit -m "initial commit" + gh repo create gh-EXTENSION-NAME --source=. --public --push ``` 1. Optionally, to help other users discover your extension, add the repository topic `gh-extension`. This will make the extension appear on the [`gh-extension` topic page](https://github.com/topics/gh-extension). For more information about how to add a repository topic, see "[Classifying your repository with topics](/github/administering-a-repository/managing-repository-settings/classifying-your-repository-with-topics)." -## Tips for writing {% data variables.product.prodname_cli %} extensions +## Tips for writing interpreted {% data variables.product.prodname_cli %} extensions ### Handling arguments and flags @@ -120,34 +154,128 @@ fi ### Calling core commands in non-interactive mode -Some {% data variables.product.prodname_cli %} core commands will prompt the user for input. When scripting with those commands, a prompt is often undesirable. To avoid prompting, supply the necessary information explicitly via arguments. +Some {% data variables.product.prodname_cli %} core commands will prompt the user for input. When scripting with those commands, a prompt is often undesirable. To avoid prompting, supply the necessary information explicitly via arguments. For example, to create an issue programmatically, specify the title and body: -```bash +```shell gh issue create --title "My Title" --body "Issue description" ``` ### Fetching data programatically Many core commands support the `--json` flag for fetching data programatically. For example, to return a JSON object listing the number, title, and mergeability status of pull requests: -```bash + +```shell gh pr list --json number,title,mergeStateStatus ``` If there is not a core command to fetch specific data from GitHub, you can use the [`gh api`](https://cli.github.com/manual/gh_api) command to access the GitHub API. For example, to fetch information about the current user: -```bash + +```shell gh api user ``` All commands that output JSON data also have options to filter that data into something more immediately usable by scripts. For example, to get the current user's name: -```bash +```shell gh api user --jq '.name' ``` For more information, see [`gh help formatting`](https://cli.github.com/manual/gh_help_formatting). +## Creating a precompiled extension manually + +1. Create a local directory called `gh-EXTENSION-NAME` for your extension. Replace `EXTENSION-NAME` with the name of your extension. For example, `gh-whoami`. + +1. In the directory you created, add some source code. For example: + + ```go + package main + import ( + "github.com/cli/go-gh" + "fmt" + ) + + func main() { + args := []string{"api", "user", "--jq", `"You are @\(.login) (\(.name))"` } + stdOut, _, err := gh.Exec(args...) + if err != nil { + fmt.Println(err) + return + } + fmt.Println(stdOut.String()) + } + ``` + +1. From your directory, install the extension as a local extension. + + ```shell + gh extension install . + ``` + +1. Build your code. For example, with Go, replacing `YOUR-USERNAME` with your GitHub username: + + ```shell + go mod init github.com/YOUR-USERNAME/gh-whoami + go mod tidy + go build + ``` + +1. Verify that your extension works. Replace `EXTENSION-NAME` with the name of your extension. For example, `whoami`. + + ```shell + gh EXTENSION-NAME + ``` + +1. From your directory, create a repository to publish your extension. Replace `EXTENSION-NAME` with the name of your extension. + + {% note %} + + **Note:** Be careful not to commit the binary produced by your compilation step to version control. + + {% endnote %} + + ```shell + git init -b main + echo "gh-EXTENSION-NAME" >> .gitignore + git add main.go go.* .gitignore && git commit -m'Initial commit' + gh repo create "gh-EXTENSION-NAME" + ``` + +1. Create a release to share your precompiled extension with others. Compile for each platform you want to support, attaching each binary to a release as an asset. Binary executables attached to releases must follow a naming convention and have a suffix of OS-ARCHITECTURE\[EXTENSION\]. + + For example, an extension named `whoami` compiled for Windows 64bit would have the name `gh-whoami-windows-amd64.exe` while the same extension compiled for Linux 32bit would have the name `gh-whoami-linux-386`. To see an exhaustive list of OS and architecture combinations recognized by `gh`, see [this source code](https://github.com/cli/cli/blob/14f704fd0da58cc01413ee4ba16f13f27e33d15e/pkg/cmd/extension/manager.go#L696). + + {% note %} + + **Note:** For your extension to run properly on Windows, its asset file must have a `.exe` extension. No extension is needed for other operating systems. + + {% endnote %} + + Releases can be created from the command line. For example: + + ```shell + git tag v1.0.0 + git push origin v1.0.0 + GOOS=windows GOARCH=amd64 go build -o gh-EXTENSION-NAME-windows-amd64.exe + GOOS=linux GOARCH=amd64 go build -o gh-EXTENSION-NAME-linux-amd64 + GOOS=darwin GOARCH=amd64 go build -o gh-EXTENSION-NAME-darwin-amd64 + gh release create v1.0.0 ./*amd64* + +1. Optionally, to help other users discover your extension, add the repository topic `gh-extension`. This will make the extension appear on the [`gh-extension` topic page](https://github.com/topics/gh-extension). For more information about how to add a repository topic, see "[Classifying your repository with topics](/github/administering-a-repository/managing-repository-settings/classifying-your-repository-with-topics)." + + +## Tips for writing precompiled {% data variables.product.prodname_cli %} extensions + +### Automating releases + +Consider adding the [gh-extension-precompile](https://github.com/cli/gh-extension-precompile) action to a workflow in your project. This action will automatically produce cross-compiled Go binaries for your extension and supplies build scaffolding for non-Go precompiled extensions. + +### Using {% data variables.product.prodname_cli %} features from Go-based extensions + +Consider using [go-gh](https://github.com/cli/go-gh), a Go library that exposes pieces of `gh` functionality for use in extensions. + ## Next steps To see more examples of {% data variables.product.prodname_cli %} extensions, look at [repositories with the `gh-extension` topic](https://github.com/topics/gh-extension). diff --git a/translations/es-ES/content/actions/creating-actions/releasing-and-maintaining-actions.md b/translations/es-ES/content/actions/creating-actions/releasing-and-maintaining-actions.md index 991f4a77b780..a75f639e0f68 100644 --- a/translations/es-ES/content/actions/creating-actions/releasing-and-maintaining-actions.md +++ b/translations/es-ES/content/actions/creating-actions/releasing-and-maintaining-actions.md @@ -9,6 +9,7 @@ topics: - Community versions: fpt: '*' + ghec: '*' ghes: '*' ghae: '*' --- @@ -37,7 +38,7 @@ JavaScript actions are Node.js repositories with metadata. However, JavaScript a * Dependent packages are committed alongside the code, typically in a compiled and minified form. This means that automated builds and secure community contributions are important. -{% ifversion fpt %} +{% ifversion fpt or ghec %} * Tagged releases can be published directly to {% data variables.product.prodname_marketplace %} and consumed by workflows across {% data variables.product.prodname_dotcom %}. @@ -54,7 +55,7 @@ To support the developer process in the next section, add two {% data variables. ### Example developer process -Here is an example process that you can follow to automatically run tests, create a release{% ifversion fpt%} and publish to {% data variables.product.prodname_marketplace %}{% endif %}, and publish your action. +Here is an example process that you can follow to automatically run tests, create a release{% ifversion fpt or ghec%} and publish to {% data variables.product.prodname_marketplace %}{% endif %}, and publish your action. 1. Do feature work in branches per GitHub flow. For more information, see "[GitHub flow](/get-started/quickstart/github-flow)." * Whenever a commit is pushed to the feature branch, your testing workflow will automatically run the tests. @@ -65,7 +66,7 @@ Here is an example process that you can follow to automatically run tests, creat * **Note:** for security reasons, workflows triggered by `pull_request` from forks have restricted `GITHUB_TOKEN` permissions and do not have access to secrets. If your tests or other workflows triggered upon pull request require access to secrets, consider using a different event like a [manual trigger](/actions/reference/events-that-trigger-workflows#manual-events) or a [`pull_request_target`](/actions/reference/events-that-trigger-workflows#pull_request_target). Read more [here](/actions/reference/events-that-trigger-workflows#pull-request-events-for-forked-repositories). -3. Create a semantically tagged release. {% ifversion fpt %} You may also publish to {% data variables.product.prodname_marketplace %} with a simple checkbox. {% endif %} For more information, see "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository#creating-a-release)"{% ifversion fpt %} and "[Publishing actions in {% data variables.product.prodname_marketplace %}](/actions/creating-actions/publishing-actions-in-github-marketplace#publishing-an-action)"{% endif %}. +3. Create a semantically tagged release. {% ifversion fpt or ghec %} You may also publish to {% data variables.product.prodname_marketplace %} with a simple checkbox. {% endif %} For more information, see "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository#creating-a-release)"{% ifversion fpt or ghec %} and "[Publishing actions in {% data variables.product.prodname_marketplace %}](/actions/creating-actions/publishing-actions-in-github-marketplace#publishing-an-action)"{% endif %}. * When a release is published or edited, your release workflow will automatically take care of compilation and adjusting tags. @@ -82,7 +83,7 @@ Using semantic releases means that the users of your actions can pin their workf {% data variables.product.product_name %} provides tools and guides to help you work with the open source community. Here are a few tools we recommend setting up for healthy bidirectional communication. By providing the following signals to the community, you encourage others to use, modify, and contribute to your action: * Maintain a `README` with plenty of usage examples and guidance. For more information, see "[About READMEs](/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes)." -* Include a workflow status badge in your `README` file. For more information, see "[Adding a workflow status badge](/actions/managing-workflow-runs/adding-a-workflow-status-badge)." Also visit [shields.io](https://shields.io/) to learn about other badges that you can add.{% ifversion fpt %} +* Include a workflow status badge in your `README` file. For more information, see "[Adding a workflow status badge](/actions/managing-workflow-runs/adding-a-workflow-status-badge)." Also visit [shields.io](https://shields.io/) to learn about other badges that you can add.{% ifversion fpt or ghec %} * Add community health files like `CODE_OF_CONDUCT`, `CONTRIBUTING`, and `SECURITY`. For more information, see "[Creating a default community health file](/github/building-a-strong-community/creating-a-default-community-health-file#supported-file-types)."{% endif %} * Keep issues current by utilizing actions like [actions/stale](https://github.com/actions/stale). diff --git a/translations/es-ES/content/actions/deployment/targeting-different-environments/using-environments-for-deployment.md b/translations/es-ES/content/actions/deployment/targeting-different-environments/using-environments-for-deployment.md index 118c351433df..6713a9da7532 100644 --- a/translations/es-ES/content/actions/deployment/targeting-different-environments/using-environments-for-deployment.md +++ b/translations/es-ES/content/actions/deployment/targeting-different-environments/using-environments-for-deployment.md @@ -26,7 +26,9 @@ You can configure environments with protection rules and secrets. When a workflo {% ifversion fpt %} {% note %} -**Note:** If you don't use {% data variables.product.prodname_ghe_cloud %} and convert a repository from public to private, any configured protection rules or environment secrets will be ignored, and you will not be able to configure any environments. If you convert your repository back to public, you will have access to any previously configured protection rules and environment secrets. {% data reusables.enterprise.link-to-ghec-trial %} +**Note:** You can only configure environments for public repositories. If you convert a repository from public to private, any configured protection rules or environment secrets will be ignored, and you will not be able to configure any environments. If you convert your repository back to public, you will have access to any previously configured protection rules and environment secrets. + +Organizations that use {% data variables.product.prodname_ghe_cloud %} can configure environments for private repositories. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/deployment/targeting-different-environments/using-environments-for-deployment). {% data reusables.enterprise.link-to-ghec-trial %} {% endnote %} {% endif %} diff --git a/translations/es-ES/content/actions/guides.md b/translations/es-ES/content/actions/guides.md index 9d997caff49d..2c15577f1908 100644 --- a/translations/es-ES/content/actions/guides.md +++ b/translations/es-ES/content/actions/guides.md @@ -65,3 +65,4 @@ includeGuides: - /code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/automating-dependabot-with-github-actions - /code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/keeping-your-actions-up-to-date-with-dependabot --- + diff --git a/translations/es-ES/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md b/translations/es-ES/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md index e53e41204ea4..ebfb2eed0850 100644 --- a/translations/es-ES/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md +++ b/translations/es-ES/content/actions/hosting-your-own-runners/adding-self-hosted-runners.md @@ -81,11 +81,13 @@ You can add self-hosted runners at the organization level, where they can be use ## Adding a self-hosted runner to an enterprise -You can add self-hosted runners to an enterprise, where they can be assigned to multiple organizations. The organization admins are then able to control which repositories can use it. +{% ifversion fpt %}If you use {% data variables.product.prodname_ghe_cloud %}, you{% elsif ghec or ghes or ghae %}You{% endif %} can add self-hosted runners to an enterprise, where they can be assigned to multiple organizations. The organization admins are then able to control which repositories can use it. {% ifversion fpt %}For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/hosting-your-own-runners/adding-self-hosted-runners#adding-a-self-hosted-runner-to-an-enterprise).{% endif %} + +{% ifversion ghec or ghes or ghae %} New runners are assigned to the default group. You can modify the runner's group after you've registered the runner. For more information, see "[Managing access to self-hosted runners](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#moving-a-self-hosted-runner-to-a-group)." -{% ifversion fpt or ghec %} +{% ifversion ghec %} To add a self-hosted runner to an enterprise account, you must be an enterprise owner. For information about how to add a self-hosted runner with the REST API, see the [Enterprise Administration GitHub Actions APIs](/rest/reference/enterprise-admin#github-actions). {% data reusables.enterprise-accounts.access-enterprise %} @@ -104,9 +106,11 @@ To add a self-hosted runner at the enterprise level of {% data variables.product 1. Click **Add new**, then click **New runner**. {% data reusables.github-actions.self-hosted-runner-configure %} {% endif %} +{% ifversion ghec or ghae or ghes %} {% data reusables.github-actions.self-hosted-runner-check-installation-success %} {% data reusables.github-actions.self-hosted-runner-public-repo-access %} +{% endif %} ### Making enterprise runners available to repositories @@ -115,3 +119,4 @@ By default, runners in an enterprise's "Default" self-hosted runner group are av To make an enterprise-level self-hosted runner group available to an organization repository, you might need to change the organization's inherited settings for the runner group to make the runner available to repositories in the organization. For more information on changing runner group access settings, see "[Managing access to self-hosted runners using groups](/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." +{% endif %} diff --git a/translations/es-ES/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md b/translations/es-ES/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md index a643409dbd26..4f0148b6c35b 100644 --- a/translations/es-ES/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md +++ b/translations/es-ES/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups.md @@ -19,14 +19,19 @@ shortTitle: Manage runner groups ## About self-hosted runner groups -{% ifversion fpt or ghec %} +{% ifversion fpt %} {% note %} **Note:** All organizations have a single default self-hosted runner group. Only enterprise accounts and organizations owned by enterprise accounts can create and manage additional self-hosted runner groups. {% endnote %} + +Self-hosted runner groups are used to control access to self-hosted runners. Organization admins can configure access policies that control which repositories in an organization have access to the runner group. + +If you use {% data variables.product.prodname_ghe_cloud %}, you can create additional runner groups; enterprise admins can configure access policies that control which organizations in an enterprise have access to the runner group; and organization admins can assign additional granular repository access policies to the enterprise runner group. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners-using-groups). {% endif %} +{% ifversion ghec or ghes or ghae %} Self-hosted runner groups are used to control access to self-hosted runners at the organization and enterprise level. Enterprise admins can configure access policies that control which organizations in an enterprise have access to the runner group. Organization admins can configure access policies that control which repositories in an organization have access to the runner group. When an enterprise admin grants an organization access to a runner group, organization admins can see the runner group listed in the organization's self-hosted runner settings. The organizations admins can then assign additional granular repository access policies to the enterprise runner group. @@ -41,7 +46,7 @@ Self-hosted runners are automatically assigned to the default group when created When creating a group, you must choose a policy that defines which repositories have access to the runner group. -{% ifversion fpt or ghec %} +{% ifversion ghec %} {% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %} {% data reusables.github-actions.settings-sidebar-actions-runner-groups %} @@ -90,7 +95,7 @@ Self-hosted runners are automatically assigned to the default group when created When creating a group, you must choose a policy that defines which organizations have access to the runner group. -{% ifversion fpt or ghec %} +{% ifversion ghec %} {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.actions-tab %} @@ -134,6 +139,7 @@ When creating a group, you must choose a policy that defines which organizations ![Add runner group options](/assets/images/help/settings/actions-enterprise-account-add-runner-group-options.png) 1. Click **Save group** to create the group and apply the policy. {% endif %} +{% endif %} ## Changing the access policy of a self-hosted runner group @@ -156,6 +162,8 @@ You can update the access policy of a runner group, or rename a runner group. {% ifversion ghae or ghes %} {% data reusables.github-actions.self-hosted-runner-configure-runner-group-access %} {% endif %} + +{% ifversion ghec or ghes or ghae %} ## Automatically adding a self-hosted runner to a group You can use the configuration script to automatically add a new self-hosted runner to a group. For example, this command registers a new self-hosted runner and uses the `--runnergroup` parameter to add it to a group named `rg-runnergroup`. @@ -173,29 +181,31 @@ Could not find any self-hosted runner group named "rg-runnergroup". ## Moving a self-hosted runner to a group If you don't specify a runner group during the registration process, your new self-hosted runners are automatically assigned to the default group, and can then be moved to another group. -{% ifversion fpt or ghec or ghes > 3.1 or ghae-next %} +{% ifversion ghec or ghes > 3.1 or ghae-next %} {% data reusables.github-actions.self-hosted-runner-navigate-to-org-enterprise %} 1. In the "Runners" list, click the runner that you want to configure. -1. Select the Runner group dropdown menu. -1. In "Move runner to group", choose a destination group for the runner. -{% else %} +2. Select the Runner group dropdown menu. +3. In "Move runner to group", choose a destination group for the runner. +{% endif %} +{% ifversion ghes < 3.2 or ghae %} 1. In the "Self-hosted runners" section of the settings page, locate the current group of the runner you want to move and expand the list of group members. ![View runner group members](/assets/images/help/settings/actions-org-runner-group-members.png) -1. Select the checkbox next to the self-hosted runner, and then click **Move to group** to see the available destinations. +2. Select the checkbox next to the self-hosted runner, and then click **Move to group** to see the available destinations. ![Runner group member move](/assets/images/help/settings/actions-org-runner-group-member-move.png) -1. To move the runner, click on the destination group. +3. To move the runner, click on the destination group. ![Runner group member move](/assets/images/help/settings/actions-org-runner-group-member-move-destination.png) {% endif %} ## Removing a self-hosted runner group Self-hosted runners are automatically returned to the default group when their group is removed. -{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} +{% ifversion ghes > 3.1 or ghae-next or ghec %} {% data reusables.github-actions.self-hosted-runner-groups-navigate-to-repo-org-enterprise %} 1. In the list of groups, to the right of the group you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}. -1. To remove the group, click **Remove group**. -1. Review the confirmation prompts, and click **Remove this runner group**. -{% else %} +2. To remove the group, click **Remove group**. +3. Review the confirmation prompts, and click **Remove this runner group**. +{% endif %} +{% ifversion ghes < 3.2 or ghae %} 1. In the "Self-hosted runners" section of the settings page, locate the group you want to delete, and click the {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} button. ![View runner group settings](/assets/images/help/settings/actions-org-runner-group-kebab.png) @@ -204,3 +214,4 @@ Self-hosted runners are automatically returned to the default group when their g 1. Review the confirmation prompts, and click **Remove this runner group**. {% endif %} +{% endif %} diff --git a/translations/es-ES/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md b/translations/es-ES/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md index b492e034f7eb..31a9273648a8 100644 --- a/translations/es-ES/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md +++ b/translations/es-ES/content/actions/hosting-your-own-runners/removing-self-hosted-runners.md @@ -1,6 +1,6 @@ --- title: Removing self-hosted runners -intro: 'You can permanently remove a self-hosted runner from a repository, an organization, or an enterprise.' +intro: 'You can permanently remove a self-hosted runner from a repository{% ifversion fpt %} or organization{% elsif ghec or ghes or gahe %}, an organization, or an enterprise{% endif %}.' redirect_from: - /github/automating-your-workflow-with-github-actions/removing-self-hosted-runners - /actions/automating-your-workflow-with-github-actions/removing-self-hosted-runners @@ -73,6 +73,10 @@ To remove a self-hosted runner from an organization, you must be an organization {% endif %} ## Removing a runner from an enterprise +{% ifversion fpt %} +If you use {% data variables.product.prodname_ghe_cloud %}, you can also remove runners from an enterprise. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/hosting-your-own-runners/removing-self-hosted-runners#removing-a-runner-from-an-enterprise). +{% endif %} +{% ifversion ghec or ghes or ghae %} {% note %} **Note:** {% data reusables.github-actions.self-hosted-runner-removal-impact %} @@ -80,9 +84,10 @@ To remove a self-hosted runner from an organization, you must be an organization {% data reusables.github-actions.self-hosted-runner-auto-removal %} {% endnote %} + {% data reusables.github-actions.self-hosted-runner-reusing %} -{% ifversion fpt or ghec %} +{% ifversion ghec %} To remove a self-hosted runner from an enterprise account, you must be an enterprise owner. We recommend that you also have access to the self-hosted runner machine. For information about how to add a self-hosted runner with the REST API, see the [Enterprise Administration GitHub Actions APIs](/rest/reference/enterprise-admin#github-actions). {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} @@ -98,3 +103,4 @@ To remove a self-hosted runner at the enterprise level of {% data variables.prod {% data reusables.enterprise-accounts.actions-runners-tab %} {% data reusables.github-actions.self-hosted-runner-removing-a-runner %} {% endif %} +{% endif %} diff --git a/translations/es-ES/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md b/translations/es-ES/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md index 1e65fc3ac38d..0f7c9d3e5137 100644 --- a/translations/es-ES/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md +++ b/translations/es-ES/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md @@ -465,7 +465,7 @@ In this example, `job3` uses the `always()` conditional expression so that it al ## `jobs..runs-on` -**Required**. The type of machine to run the job on. The machine can be either a {% data variables.product.prodname_dotcom %}-hosted runner or a self-hosted runner. +**Required**. The type of machine to run the job on. The machine can be either a {% data variables.product.prodname_dotcom %}-hosted runner or a self-hosted runner. You can provide `runs-on` as a single string or as an array of strings. {% ifversion ghae %} ### {% data variables.actions.hosted_runner %}s diff --git a/translations/es-ES/content/admin/guides.md b/translations/es-ES/content/admin/guides.md index 88b78e03dc41..f6ce6a071cb1 100644 --- a/translations/es-ES/content/admin/guides.md +++ b/translations/es-ES/content/admin/guides.md @@ -137,3 +137,4 @@ includeGuides: - /admin/user-management/suspending-and-unsuspending-users - /admin/overview/creating-an-enterprise-account --- + diff --git a/translations/es-ES/content/code-security/guides.md b/translations/es-ES/content/code-security/guides.md index 5f2663b9d7f4..d232a22a1f89 100644 --- a/translations/es-ES/content/code-security/guides.md +++ b/translations/es-ES/content/code-security/guides.md @@ -78,3 +78,4 @@ includeGuides: - /code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph - /code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository --- + diff --git a/translations/es-ES/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md b/translations/es-ES/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md index f31b0b032c06..f1d15dceea4b 100644 --- a/translations/es-ES/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md +++ b/translations/es-ES/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md @@ -1,6 +1,6 @@ --- -title: Administrar las alertas del escaneo de secretos -intro: Puedes ver y cerrar las alertas para los secretos que se hayan revisado en tu repositorio. +title: Managing alerts from secret scanning +intro: You can view and close alerts for secrets checked in to your repository. product: '{% data reusables.gated-features.secret-scanning %}' redirect_from: - /github/administering-a-repository/managing-alerts-from-secret-scanning @@ -16,51 +16,55 @@ topics: - Advanced Security - Alerts - Repositories -shortTitle: Administrar las alertas de los secretos +shortTitle: Manage secret alerts --- {% data reusables.secret-scanning.beta %} -## Administrar las alertas del {% data variables.product.prodname_secret_scanning %} +## Managing {% data variables.product.prodname_secret_scanning %} alerts {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} -3. En la barra lateral izquierda, haz clic en **Alertas del escaneo de secretos**. +3. In the left sidebar, click **Secret scanning alerts**. {% ifversion fpt or ghes or ghec %} - ![Pestaña de "Alertas del escaneo de secretos"](/assets/images/help/repository/sidebar-secrets.png) + !["Secret scanning alerts" tab](/assets/images/help/repository/sidebar-secrets.png) {% endif %} {% ifversion ghae %} - ![Pestaña de "Alertas del escaneo de secretos"](/assets/images/enterprise/github-ae/repository/sidebar-secrets-ghae.png) + !["Secret scanning alerts" tab](/assets/images/enterprise/github-ae/repository/sidebar-secrets-ghae.png) {% endif %} -4. Debajo de "Escaneo de secretos" da clic en la alerta que quieras ver. +4. Under "Secret scanning" click the alert you want to view. {% ifversion fpt or ghec %} - ![Lista de alertas del escaneo de secretos](/assets/images/help/repository/secret-scanning-click-alert.png) + ![List of alerts from secret scanning](/assets/images/help/repository/secret-scanning-click-alert.png) {% endif %} {% ifversion ghes %} - ![Lista de alertas del escaneo de secretos](/assets/images/help/repository/secret-scanning-click-alert-ghe.png) + ![List of alerts from secret scanning](/assets/images/help/repository/secret-scanning-click-alert-ghe.png) {% endif %} {% ifversion ghae %} - ![Lista de alertas del escaneo de secretos](/assets/images/enterprise/github-ae/repository/secret-scanning-click-alert-ghae.png) + ![List of alerts from secret scanning](/assets/images/enterprise/github-ae/repository/secret-scanning-click-alert-ghae.png) + {% endif %} +5. {% ifversion fpt or ghec %} + Optionally, use the "Close as" drop-down menu and click a reason for resolving an alert. + {%- elsif ghes or ghae %} + Optionally, use the "Mark as" drop-down menu and click a reason for resolving an alert. {% endif %} -5. Opcionalmente, utiliza el menú desplegable de "Marcar como" y da clic en la razón para resolver una alerta. {% ifversion fpt or ghec %} - ![Menú desplegable para resolver una alerta del escaneo de secretos](/assets/images/help/repository/secret-scanning-resolve-alert.png) + ![Drop-down menu for resolving an alert from secret scanning](/assets/images/help/repository/secret-scanning-resolve-alert.png) {% endif %} {% ifversion ghes or ghae %} - ![Menú desplegable para resolver una alerta del escaneo de secretos](/assets/images/help/repository/secret-scanning-resolve-alert-ghe.png) + ![Drop-down menu for resolving an alert from secret scanning](/assets/images/help/repository/secret-scanning-resolve-alert-ghe.png) {% endif %} -## Asegurar los secretos en riesgo +## Securing compromised secrets -Cuando un secreto se haya confirmado en un repositorio, deberás considerarlo en riesgo. {% data variables.product.prodname_dotcom %} recomienda tomar las siguientes acciones para los secretos puestos en riesgo: +Once a secret has been committed to a repository, you should consider the secret compromised. {% data variables.product.prodname_dotcom %} recommends the following actions for compromised secrets: -- Para un token de acceso personal de {% data variables.product.prodname_dotcom %} comprometido, elimina el token comprometido, crea un nuevo token y actualiza todo servicio que use el token antiguo. Para obtener más información, consulta la sección "[Crear un token de acceso personal para la línea de comandos](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)". -- Para todos los demás secretos, verifica primero que aquellos que se hayan confirmado en {% data variables.product.product_name %} sean válidos. De ser así, crea un secreto nuevo, actualiza cualquier servicio que utilice el secreto anterior, y luego bórralo. +- For a compromised {% data variables.product.prodname_dotcom %} personal access token, delete the compromised token, create a new token, and update any services that use the old token. For more information, see "[Creating a personal access token for the command line](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)." +- For all other secrets, first verify that the secret committed to {% data variables.product.product_name %} is valid. If so, create a new secret, update any services that use the old secret, and then delete the old secret. {% ifversion fpt or ghes > 3.1 or ghae-issue-4910 or ghec %} -## Configurar las notificaciones para las alertas del {% data variables.product.prodname_secret_scanning %} +## Configuring notifications for {% data variables.product.prodname_secret_scanning %} alerts -Cuando se detecta un secreto nuevo, {% data variables.product.product_name %} notifica a todos los usuarios con acceso a las alertas de seguridad del repositorio de acuerdo con sus preferencias de notificación. Recibirás alertas si estás observando el repositorio, si habilitaste las notificaciones para las alertas de seguridad o para toda la actividad del repositorio, si eres el autor de la confirmación que contiene el secreto y si no estás ignorando el repositorio. +When a new secret is detected, {% data variables.product.product_name %} notifies all users with access to security alerts for the repository according to their notification preferences. You will receive alerts if you are watching the repository, have enabled notifications for security alerts or for all the activity on the repository, are the author of the commit that contains the secret and are not ignoring the repository. -Para obtener más información, consulta las secciones "[Administrar la seguridad y configuración de análisis para tu repositorio](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-security-alerts)" y "[Configurar las notificaciones](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository)". +For more information, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-security-alerts)" and "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository)." {% endif %} diff --git a/translations/es-ES/content/codespaces/guides.md b/translations/es-ES/content/codespaces/guides.md index 02defa626042..5607e64f4d54 100644 --- a/translations/es-ES/content/codespaces/guides.md +++ b/translations/es-ES/content/codespaces/guides.md @@ -1,8 +1,8 @@ --- -title: Guías de codespaces -shortTitle: Guías +title: Codespaces guides +shortTitle: Guides product: '{% data reusables.gated-features.codespaces %}' -intro: Aprende cómo sacar el mayor provecho de GitHub +intro: Learn how to make the most of GitHub allowTitleToDifferFromFilename: true layout: product-guides versions: @@ -41,3 +41,4 @@ includeGuides: - /codespaces/codespaces-reference/disaster-recovery-for-codespaces - /codespaces/codespaces-reference/security-in-codespaces --- + diff --git a/translations/es-ES/content/developers/apps/building-github-apps/creating-a-github-app-using-url-parameters.md b/translations/es-ES/content/developers/apps/building-github-apps/creating-a-github-app-using-url-parameters.md index 5d3b70e9d902..9a34f94af7bd 100644 --- a/translations/es-ES/content/developers/apps/building-github-apps/creating-a-github-app-using-url-parameters.md +++ b/translations/es-ES/content/developers/apps/building-github-apps/creating-a-github-app-using-url-parameters.md @@ -60,8 +60,8 @@ The complete list of available query parameters, permissions, and events is list `webhook_active` | `boolean` | Set to `false` to disable webhook. Webhook is enabled by default. `webhook_url` | `string` | The full URL that you would like to send webhook event payloads to. {% ifversion ghes < 3.2 or ghae %}`webhook_secret` | `string` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details. -{% endif %}`events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`. -`domain` | `string` | The URL of a content reference. +{% endif %}`events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`.{% ifversion ghes < 3.4 %} +`domain` | `string` | The URL of a content reference.{% endif %} `single_file_name` | `string` | This is a narrowly-scoped permission that allows the app to access a single file in any repository. When you set the `single_file` permission to `read` or `write`, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage. {% ifversion fpt or ghes or ghec %} If you need to manage multiple files, see `single_file_paths` below. {% endif %}{% ifversion fpt or ghes or ghec %} `single_file_paths` | `array of strings` | This allows the app to access up ten specified files in a repository. When you set the `single_file` permission to `read` or `write`, this array can store the paths for up to ten files that your {% data variables.product.prodname_github_app %} will manage. These files all receive the same permission set by `single_file`, and do not have separate individual permissions. When two or more files are configured, the API returns `multiple_single_files=true`, otherwise it returns `multiple_single_files=false`.{% endif %} @@ -73,8 +73,8 @@ Permission | Description ---------- | ----------- [`administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Grants access to various endpoints for organization and repository administration. Can be one of: `none`, `read`, or `write`.{% ifversion fpt or ghec %} [`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | Grants access to the [Blocking Users API](/rest/reference/users#blocking). Can be one of: `none`, `read`, or `write`.{% endif %} -[`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/rest/reference/checks). Can be one of: `none`, `read`, or `write`. -`content_references` | Grants access to the "[Create a content attachment](/rest/reference/apps#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`. +[`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/rest/reference/checks). Can be one of: `none`, `read`, or `write`.{% ifversion ghes < 3.4 %} +`content_references` | Grants access to the "[Create a content attachment](/rest/reference/apps#create-a-content-attachment)" endpoint. Can be one of: `none`, `read`, or `write`.{% endif %} [`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | Grants access to various endpoints that allow you to modify repository contents. Can be one of: `none`, `read`, or `write`. [`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | Grants access to the [Deployments API](/rest/reference/repos#deployments). Can be one of: `none`, `read`, or `write`.{% ifversion fpt or ghes or ghec %} [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/rest/reference/users#emails). Can be one of: `none`, `read`, or `write`.{% endif %} @@ -109,8 +109,8 @@ Webhook event name | Required permission | Description ------------------ | ------------------- | ----------- [`check_run`](/webhooks/event-payloads/#check_run) |`checks` | {% data reusables.webhooks.check_run_short_desc %} [`check_suite`](/webhooks/event-payloads/#check_suite) |`checks` | {% data reusables.webhooks.check_suite_short_desc %} -[`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %} -[`content_reference`](/webhooks/event-payloads/#content_reference) |`content_references` | {% data reusables.webhooks.content_reference_short_desc %} +[`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %}{% ifversion ghes < 3.4 %} +[`content_reference`](/webhooks/event-payloads/#content_reference) |`content_references` | {% data reusables.webhooks.content_reference_short_desc %}{% endif %} [`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %} [`delete`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %} [`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %} diff --git a/translations/es-ES/content/developers/apps/guides/using-content-attachments.md b/translations/es-ES/content/developers/apps/guides/using-content-attachments.md index fa623003d52f..8b8ddf5c6861 100644 --- a/translations/es-ES/content/developers/apps/guides/using-content-attachments.md +++ b/translations/es-ES/content/developers/apps/guides/using-content-attachments.md @@ -5,10 +5,7 @@ redirect_from: - /apps/using-content-attachments - /developers/apps/using-content-attachments versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' + ghes: '<3.4' topics: - GitHub Apps --- diff --git a/translations/es-ES/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md b/translations/es-ES/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md index 9b1ec421ff06..94ac6cf87b0f 100644 --- a/translations/es-ES/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md +++ b/translations/es-ES/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md @@ -1,6 +1,6 @@ --- -title: Eventos y cargas útiles de un Webhook -intro: 'Para cada evento de webhook, puedes revisar cuándo ocurre el evento, una carga útil de ejemplo, y las descripciones de los parámetros del objeto de dicha carga útil.' +title: Webhook events and payloads +intro: 'For each webhook event, you can review when the event occurs, an example payload, and descriptions about the payload object parameters.' product: '{% data reusables.gated-features.enterprise_account_webhooks %}' redirect_from: - /early-access/integrations/webhooks/ @@ -14,53 +14,52 @@ versions: ghec: '*' topics: - Webhooks -shortTitle: Eventos de webhook & cargas útiles +shortTitle: Webhook events & payloads --- - {% ifversion fpt or ghec %} {% endif %} {% data reusables.webhooks.webhooks_intro %} -Puedes crear webhooks que se suscriban a los eventos listados en esta página. Cada evento de webhook incluye una descripción de las propiedades de dicho webhook y un ejemplo de carga útil. Para obtener más información, consulta "[Crear webhooks](/webhooks/creating/)". +You can create webhooks that subscribe to the events listed on this page. Each webhook event includes a description of the webhook properties and an example payload. For more information, see "[Creating webhooks](/webhooks/creating/)." -## Propuiedades comunes del objeto de la carga útil del webhook +## Webhook payload object common properties -Cada carga útil del evento del webhook contiene propiedades únicas de dicho evento. Puedes encontrar estas propiedades únicas en las secciones individuales de tipo de evento. +Each webhook event payload also contains properties unique to the event. You can find the unique properties in the individual event type sections. -| Clave | Type | Descripción | -| -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -| `Acción` | `secuencia` | La mayoría de las cargas útiles de webhooks contienen una propiedad de `action` que contiene la actividad específica que activa el evento. | -{% data reusables.webhooks.sender_desc %} Esta propiedad se incluye en cada carga útil del webhook. -{% data reusables.webhooks.repo_desc %} Las cargas útiles del webhook contienen la propiedad `repository` cuando el evento ocurre desde una actividad en un repositorio. +Key | Type | Description +----|------|------------- +`action` | `string` | Most webhook payloads contain an `action` property that contains the specific activity that triggered the event. +{% data reusables.webhooks.sender_desc %} This property is included in every webhook payload. +{% data reusables.webhooks.repo_desc %} Webhook payloads contain the `repository` property when the event occurs from activity in a repository. {% data reusables.webhooks.org_desc %} -{% data reusables.webhooks.app_desc %} Para obtener más información, consulta la sección "[Crear una {% data variables.product.prodname_github_app %}](/apps/building-github-apps/)". +{% data reusables.webhooks.app_desc %} For more information, see "[Building {% data variables.product.prodname_github_app %}](/apps/building-github-apps/)." -Las propiedades únicas de un evento de webhook son las mismas que encontrarás en la propiedad `payload` cuando utilices la [API de eventos](/rest/reference/activity#events). Una excepción es el [evento `push`](#push). Las propiedades únicas de la carga útil del evento `push` del webhook y la propiedad `payload` en la API de Eventos difieren entre ellos. La carga útil del webhook contiene información más detallada. +The unique properties for a webhook event are the same properties you'll find in the `payload` property when using the [Events API](/rest/reference/activity#events). One exception is the [`push` event](#push). The unique properties of the `push` event webhook payload and the `payload` property in the Events API differ. The webhook payload contains more detailed information. {% tip %} -**Nota:** Las cargas útiles se limitan a los 25 MB. Si tu evento genera una carga útil mayor, el webhook no se lanzará. Esto puede pasar, por ejemplo, en un evento de `create` si muchas ramas o etiquetas se cargan al mismo tiempo. Te sugerimos monitorear el tamaño de tu carga útil para garantizar la entrega. +**Note:** Payloads are capped at 25 MB. If your event generates a larger payload, a webhook will not be fired. This may happen, for example, on a `create` event if many branches or tags are pushed at once. We suggest monitoring your payload size to ensure delivery. {% endtip %} -### Encabezados de entrega +### Delivery headers -Las cargas útiles de HTTP POST que se entregan a la terminal URL configurada para tu webhook contendrán varios encabezados especiales: +HTTP POST payloads that are delivered to your webhook's configured URL endpoint will contain several special headers: -| Encabezado | Descripción | -| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `X-GitHub-Event` | Nombre del evento que desencadenó la entrega. | -| `X-GitHub-Delivery` | Un [GUID](http://en.wikipedia.org/wiki/Globally_unique_identifier) para identificar la entrega.{% ifversion ghes or ghae %} -| `X-GitHub-Enterprise-Version` | La versión de la instancia de {% data variables.product.prodname_ghe_server %} que envía la carga útil del HTTP POST. | -| `X-GitHub-Enterprise-Host` | El nombre de host de la instancia de {% data variables.product.prodname_ghe_server %} que envió la carga útil de HTTP POST.{% endif %}{% ifversion not ghae %} -| `X-Hub-Signature` | Este encabezado se envía si el webhook se configura con un [`secret`](/rest/reference/repos#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-1 hash function and the `secret` as the HMAC `key`.{% ifversion fpt or ghes or ghec %} `X-Hub-Signature` is provided for compatibility with existing integrations, and we recommend that you use the more secure `X-Hub-Signature-256` instead.{% endif %}{% endif %} -| `X-Hub-Signature-256` | Este encabezado se envía si el webhook se configura con un [`secret`](/rest/reference/repos#create-hook-config-params). Este es el resumen hexadecimal de HMAC para el cuerpo de la solicitud y se genera utilizando la función de hash SHA-256 y el `secret` como la `key` HMAC. | +Header | Description +-------|-------------| +`X-GitHub-Event`| Name of the event that triggered the delivery. +`X-GitHub-Delivery`| A [GUID](http://en.wikipedia.org/wiki/Globally_unique_identifier) to identify the delivery.{% ifversion ghes or ghae %} +`X-GitHub-Enterprise-Version` | The version of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload. +`X-GitHub-Enterprise-Host` | The hostname of the {% data variables.product.prodname_ghe_server %} instance that sent the HTTP POST payload.{% endif %}{% ifversion not ghae %} +`X-Hub-Signature`| This header is sent if the webhook is configured with a [`secret`](/rest/reference/repos#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-1 hash function and the `secret` as the HMAC `key`.{% ifversion fpt or ghes or ghec %} `X-Hub-Signature` is provided for compatibility with existing integrations, and we recommend that you use the more secure `X-Hub-Signature-256` instead.{% endif %}{% endif %} +`X-Hub-Signature-256`| This header is sent if the webhook is configured with a [`secret`](/rest/reference/repos#create-hook-config-params). This is the HMAC hex digest of the request body, and is generated using the SHA-256 hash function and the `secret` as the HMAC `key`. -También, el `User-Agent` para las solicitudes tendrá el prefijo `GitHub-Hookshot/`. +Also, the `User-Agent` for the requests will have the prefix `GitHub-Hookshot/`. -### Ejemplo de entrega +### Example delivery ```shell > POST /payload HTTP/2 @@ -104,26 +103,26 @@ También, el `User-Agent` para las solicitudes tendrá el prefijo `GitHub-Hooksh {% ifversion fpt or ghes > 3.2 or ghae-next or ghec %} ## branch_protection_rule -Actividad relacionada con una regla de protección de rama. Para obtener más información, consulta la sección "[Acerca de las reglas de protección de rama](/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-rules)". +Activity related to a branch protection rule. For more information, see "[About branch protection rules](/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-rules)." -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} que tengan un acceso mínimo de `read-only` en la administración de repositorios +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with at least `read-only` access on repositories administration -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| --------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `Acción` | `secuencia` | La acción realizada. Puede ser `created`, `edited`, o `deleted`. | -| `rule` | `objeto` | La regla de protección de rama. Incluye un `name` y todos los [ajustes de protección de rama](/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) que se aplicaron a las ramas que empatan con el nombre. Los ajustes binarios son booleanos. Las configuraciones de nivel múltiple son una de entre `off`, `non_admins`, o `everyone`. Las listas de actor y compilación son arreglos de secuencias. | -| `changes` | `objeto` | Si la acción fue `edited`, los cambios a la regla. | +Key | Type | Description +----|------|------------- +`action` |`string` | The action performed. Can be `created`, `edited`, or `deleted`. +`rule` | `object` | The branch protection rule. Includes a `name` and all the [branch protection settings](/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) applied to branches that match the name. Binary settings are boolean. Multi-level configurations are one of `off`, `non_admins`, or `everyone`. Actor and build lists are arrays of strings. +`changes` | `object` | If the action was `edited`, the changes to the rule. {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.branch_protection_rule.edited }} {% endif %} @@ -133,13 +132,13 @@ Actividad relacionada con una regla de protección de rama. Para obtener más in {% data reusables.apps.undetected-pushes-to-a-forked-repository-for-check-suites %} -### Disponibilidad +### Availability -- Los webhooks de repositorio solo reciben cargas útiles para los tipos de evento `created` y `completed` en un repositorio -- Los webhooks de organización solo reciben cargas útiles para los tipos de evento `created` y `completed` en los repositorios -- Las {% data variables.product.prodname_github_apps %} con el permiso `checks:read` reciben cargas útiles para los eventos `created` y `completed` que ocurren en un repositorio en donde se haya instalado la app. La app debe tener el permiso `checks:write` para recibir los tipos de evento `rerequested` y `requested_action`. Las cargas útiles para los tipos de evento `rerequested` y `requested_action` solo se enviarán a la {% data variables.product.prodname_github_app %} que se esté solicitando. Las {% data variables.product.prodname_github_apps %} con el `checks:write` se suscriben automáticamente a este evento de webhook. +- Repository webhooks only receive payloads for the `created` and `completed` event types in a repository +- Organization webhooks only receive payloads for the `created` and `completed` event types in repositories +- {% data variables.product.prodname_github_apps %} with the `checks:read` permission receive payloads for the `created` and `completed` events that occur in the repository where the app is installed. The app must have the `checks:write` permission to receive the `rerequested` and `requested_action` event types. The `rerequested` and `requested_action` event type payloads are only sent to the {% data variables.product.prodname_github_app %} being requested. {% data variables.product.prodname_github_apps %} with the `checks:write` are automatically subscribed to this webhook event. -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.check_run_properties %} {% data reusables.webhooks.repo_desc %} @@ -147,7 +146,7 @@ Actividad relacionada con una regla de protección de rama. Para obtener más in {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.check_run.created }} @@ -157,13 +156,13 @@ Actividad relacionada con una regla de protección de rama. Para obtener más in {% data reusables.apps.undetected-pushes-to-a-forked-repository-for-check-suites %} -### Disponibilidad +### Availability -- Los webhooks de los repositorios únicamente recibirán cargas útiles para los tipos de evento `completed` en un repositorio -- Los webhooks de organización recibirán únicamente cargas útiles para los tipos de evento `completed` en los repositorios -- Las {% data variables.product.prodname_github_apps %} con el permiso `checks:read` reciben cargas útiles para los eventos `created` y `completed` que ocurren en un repositorio en donde se haya instalado la app. La app debe tener el permiso `checks:write` para recibir los tipos de evento `requested` y `rerequested`. Las cargas útiles para los tipos de evento `requested` y `rerequested` se envían únicamente a la {% data variables.product.prodname_github_app %} que se está solicitando. Las {% data variables.product.prodname_github_apps %} con el `checks:write` se suscriben automáticamente a este evento de webhook. +- Repository webhooks only receive payloads for the `completed` event types in a repository +- Organization webhooks only receive payloads for the `completed` event types in repositories +- {% data variables.product.prodname_github_apps %} with the `checks:read` permission receive payloads for the `created` and `completed` events that occur in the repository where the app is installed. The app must have the `checks:write` permission to receive the `requested` and `rerequested` event types. The `requested` and `rerequested` event type payloads are only sent to the {% data variables.product.prodname_github_app %} being requested. {% data variables.product.prodname_github_apps %} with the `checks:write` are automatically subscribed to this webhook event. -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.check_suite_properties %} {% data reusables.webhooks.repo_desc %} @@ -171,43 +170,43 @@ Actividad relacionada con una regla de protección de rama. Para obtener más in {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.check_suite.completed }} -## comentario_confirmación de cambios +## code_scanning_alert {% data reusables.webhooks.code_scanning_alert_event_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `security_events :read` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `security_events :read` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.code_scanning_alert_event_properties %} {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} -`sender` | `object` | Si la `action` está como `reopened_by_user` o `closed_by_user`, el objeto que sea el `sender` será el usuario que activó el evento. El objeto `sender` está {% ifversion fpt or ghec %}`github` {% elsif ghes > 3.0 or ghae-next %}`github-enterprise` {% else %}vacío{% endif %} para el resto de las acciones. +`sender` | `object` | If the `action` is `reopened_by_user` or `closed_by_user`, the `sender` object will be the user that triggered the event. The `sender` object is {% ifversion fpt or ghec %}`github`{% elsif ghes > 3.0 or ghae-next %}`github-enterprise`{% else %}empty{% endif %} for all other actions. -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.code_scanning_alert.reopened }} -## comentario_confirmación de cambios +## commit_comment {% data reusables.webhooks.commit_comment_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `contents` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `contents` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.commit_comment_properties %} {% data reusables.webhooks.repo_desc %} @@ -215,41 +214,43 @@ Actividad relacionada con una regla de protección de rama. Para obtener más in {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.commit_comment.created }} +{% ifversion ghes < 3.4 %} ## content_reference {% data reusables.webhooks.content_reference_short_desc %} -Los eventos de webhook se desencadenan basándose en la especificidad del dominio que registres. Por ejemplo, si registras un subdominio (`https://subdomain.example.com`), entonces la única URL para el subdominio activarán este evento. Si registras un dominio (`https://example.com`) entonces las URL para el dominio y todos sus subdominios activarán este evento. Consulta la sección "[Crear un adjunto de contenido](/rest/reference/apps#create-a-content-attachment)" para crear un nuevo adjunto de contenido. +Webhook events are triggered based on the specificity of the domain you register. For example, if you register a subdomain (`https://subdomain.example.com`) then only URLs for the subdomain trigger this event. If you register a domain (`https://example.com`) then URLs for domain and all subdomains trigger this event. See "[Create a content attachment](/rest/reference/apps#create-a-content-attachment)" to create a new content attachment. -### Disponibilidad +### Availability -- {% data variables.product.prodname_github_apps %} con el permiso `content_references:write` +- {% data variables.product.prodname_github_apps %} with the `content_references:write` permission -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.content_reference.created }} -## create (crear) +{% endif %} +## create {% data reusables.webhooks.create_short_desc %} {% note %} -**Nota:** No recibirás un webhook para este evento cuando cargues más de tres etiquetas al mismo tiempo. +**Note:** You will not receive a webhook for this event when you push more than three tags at once. {% endnote %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `contents` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `contents` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.create_properties %} {% data reusables.webhooks.pusher_type_desc %} @@ -258,7 +259,7 @@ Los eventos de webhook se desencadenan basándose en la especificidad del domini {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.create }} @@ -268,17 +269,17 @@ Los eventos de webhook se desencadenan basándose en la especificidad del domini {% note %} -**Nota:** No recibirás un webhook para este evento cuando borres más de tres etiquetas al mismo tiempo. +**Note:** You will not receive a webhook for this event when you delete more than three tags at once. {% endnote %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `contents` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `contents` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.delete_properties %} {% data reusables.webhooks.pusher_type_desc %} @@ -287,7 +288,7 @@ Los eventos de webhook se desencadenan basándose en la especificidad del domini {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.delete }} @@ -295,19 +296,19 @@ Los eventos de webhook se desencadenan basándose en la especificidad del domini {% data reusables.webhooks.deploy_key_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización +- Repository webhooks +- Organization webhooks -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.deploy_key_properties %} {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.deploy_key.created }} @@ -315,24 +316,24 @@ Los eventos de webhook se desencadenan basándose en la especificidad del domini {% data reusables.webhooks.deployment_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `deployments` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `deployments` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| ------------ | ------------------------------------------- | -------------------------------------------------------- |{% ifversion fpt or ghes or ghae or ghec %} -| `Acción` | `secuencia` | La acción realizada. Puede ser `created`.{% endif %} -| `deployment` | `objeto` | El [despliegue](/rest/reference/repos#list-deployments). | +Key | Type | Description +----|------|-------------{% ifversion fpt or ghes or ghae or ghec %} +`action` |`string` | The action performed. Can be `created`.{% endif %} +`deployment` |`object` | The [deployment](/rest/reference/repos#list-deployments). {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.deployment }} @@ -340,54 +341,54 @@ Los eventos de webhook se desencadenan basándose en la especificidad del domini {% data reusables.webhooks.deployment_status_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `deployments` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `deployments` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| ---------------------------------- | ------------------------------------------- | ----------------------------------------------------------------------------------------- |{% ifversion fpt or ghes or ghae or ghec %} -| `Acción` | `secuencia` | La acción realizada. Puede ser `created`.{% endif %} -| `deployment_status` | `objeto` | El [Estado del despliegue](/rest/reference/repos#list-deployment-statuses). | -| `deployment_status["state"]` | `secuencia` | El estado nuevo. Puede ser `pending`, `success`, `failure`, o `error`. | -| `deployment_status["target_url"]` | `secuencia` | El enlace opcional agregado al estado. | -| `deployment_status["description"]` | `secuencia` | La descripción opcional legible para las personas que se agrega al estado. | -| `deployment` | `objeto` | El [despliegue](/rest/reference/repos#list-deployments) con el que se asocia este estado. | +Key | Type | Description +----|------|-------------{% ifversion fpt or ghes or ghae or ghec %} +`action` |`string` | The action performed. Can be `created`.{% endif %} +`deployment_status` |`object` | The [deployment status](/rest/reference/repos#list-deployment-statuses). +`deployment_status["state"]` |`string` | The new state. Can be `pending`, `success`, `failure`, or `error`. +`deployment_status["target_url"]` |`string` | The optional link added to the status. +`deployment_status["description"]`|`string` | The optional human-readable description added to the status. +`deployment` |`object` | The [deployment](/rest/reference/repos#list-deployments) that this status is associated with. {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.deployment_status }} {% ifversion fpt or ghec %} -## debate +## discussion {% data reusables.webhooks.discussions-webhooks-beta %} -Actividad relacionada con un debate. Para obtener más información, consulta la sección "[Utilizar la API de GraphQL para los debates]({% ifversion ghec %}/free-pro-team@latest{% endif %}/graphql/guides/using-the-graphql-api-for-discussions)". -### Disponibilidad +Activity related to a discussion. For more information, see the "[Using the GraphQL API for discussions]({% ifversion ghec %}/free-pro-team@latest{% endif %}/graphql/guides/using-the-graphql-api-for-discussions)." +### Availability -- Webhooks de repositorio -- Webhooks de organización -- Las {% data variables.product.prodname_github_apps %} con el permiso de `discussions` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `discussions` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Acción` | `secuencia` | La acción realizada. Puede ser `created`, `edited`, `deleted`, `pinned`, `unpinned`, `locked`, `unlocked`, `transferred`, `category_changed`, `answered`, o `unanswered`. | +Key | Type | Description +----|------|------------- +`action` |`string` | The action performed. Can be `created`, `edited`, `deleted`, `pinned`, `unpinned`, `locked`, `unlocked`, `transferred`, `category_changed`, `answered`, or `unanswered`. {% data reusables.webhooks.discussion_desc %} {% data reusables.webhooks.repo_desc_graphql %} {% data reusables.webhooks.org_desc_graphql %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.discussion.created }} @@ -395,63 +396,63 @@ Actividad relacionada con un debate. Para obtener más información, consulta la {% data reusables.webhooks.discussions-webhooks-beta %} -La actividad relacionada con un comentario en un debate. Para obtener más información, consulta la sección "[Utilizar la API de GraphQL para los debates]({% ifversion ghec %}/free-pro-team@latest{% endif %}/graphql/guides/using-the-graphql-api-for-discussions)". +Activity related to a comment in a discussion. For more information, see "[Using the GraphQL API for discussions]({% ifversion ghec %}/free-pro-team@latest{% endif %}/graphql/guides/using-the-graphql-api-for-discussions)." -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- Las {% data variables.product.prodname_github_apps %} con el permiso de `discussions` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `discussions` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| ------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `Acción` | `secuencia` | La acción realizada. Puede ser `created`, `edited`, o `deleted`. | -| `comentario` | `objeto` | El recurso de [`discussion comment`]({% ifversion ghec %}/free-pro-team@latest{% endif %}/graphql/guides/using-the-graphql-api-for-discussions#discussioncomment). | +Key | Type | Description +----|------|------------- +`action` |`string` | The action performed. Can be `created`, `edited`, or `deleted`. +`comment` | `object` | The [`discussion comment`]({% ifversion ghec %}/free-pro-team@latest{% endif %}/graphql/guides/using-the-graphql-api-for-discussions#discussioncomment) resource. {% data reusables.webhooks.discussion_desc %} {% data reusables.webhooks.repo_desc_graphql %} {% data reusables.webhooks.org_desc_graphql %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.discussion_comment.created }} {% endif %} {% ifversion ghes or ghae %} -## empresa +## enterprise {% data reusables.webhooks.enterprise_short_desc %} -### Disponibilidad +### Availability -- Webhooks de GitHub Enterprise. Para obtener más información, consulta los "[webhooks globales](/rest/reference/enterprise-admin#global-webhooks/)." +- GitHub Enterprise webhooks. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/)." -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| -------- | ----------- | ---------------------------------------------------------------------------------------- | -| `Acción` | `secuencia` | La acción realizada. Puede ser `anonymous_access_enabled` o `anonymous_access_disabled`. | +Key | Type | Description +----|------|------------- +`action` |`string` | The action performed. Can be `anonymous_access_enabled` or `anonymous_access_disabled`. -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.enterprise.anonymous_access_enabled }} {% endif %} -## bifurcación +## fork {% data reusables.webhooks.fork_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `contents` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `contents` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.fork_properties %} {% data reusables.webhooks.repo_desc %} @@ -459,28 +460,28 @@ La actividad relacionada con un comentario en un debate. Para obtener más infor {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.fork }} ## github_app_authorization -Este evento ocurre cuando alguien revoca su autorización de una {% data variables.product.prodname_github_app %}. Una {% data variables.product.prodname_github_app %} recibe este webhook predeterminadamente y no puede desuscribirse de este evento. +When someone revokes their authorization of a {% data variables.product.prodname_github_app %}, this event occurs. A {% data variables.product.prodname_github_app %} receives this webhook by default and cannot unsubscribe from this event. -{% data reusables.webhooks.authorization_event %} Para obtener detalles sobre las solicitudes de usuario a servidor, las cuales requieren autorización de la {% data variables.product.prodname_github_app %}, consulta la sección "[Identificar y autorizar a los usuarios para las {% data variables.product.prodname_github_apps %}](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)". +{% data reusables.webhooks.authorization_event %} For details about user-to-server requests, which require {% data variables.product.prodname_github_app %} authorization, see "[Identifying and authorizing users for {% data variables.product.prodname_github_apps %}](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)." -### Disponibilidad +### Availability - {% data variables.product.prodname_github_apps %} -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| -------- | ----------- | ----------------------------------------- | -| `Acción` | `secuencia` | La acción realizada. Puede ser `revoked`. | +Key | Type | Description +----|------|------------- +`action` |`string` | The action performed. Can be `revoked`. {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.github_app_authorization.revoked }} @@ -488,13 +489,13 @@ Este evento ocurre cuando alguien revoca su autorización de una {% data variabl {% data reusables.webhooks.gollum_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `contents` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `contents` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.gollum_properties %} {% data reusables.webhooks.repo_desc %} @@ -502,7 +503,7 @@ Este evento ocurre cuando alguien revoca su autorización de una {% data variabl {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.gollum }} @@ -510,17 +511,17 @@ Este evento ocurre cuando alguien revoca su autorización de una {% data variabl {% data reusables.webhooks.installation_short_desc %} -### Disponibilidad +### Availability - {% data variables.product.prodname_github_apps %} -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.installation_properties %} {% data reusables.webhooks.app_always_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.installation.deleted }} @@ -528,31 +529,31 @@ Este evento ocurre cuando alguien revoca su autorización de una {% data variabl {% data reusables.webhooks.installation_repositories_short_desc %} -### Disponibilidad +### Availability - {% data variables.product.prodname_github_apps %} -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.installation_repositories_properties %} {% data reusables.webhooks.app_always_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.installation_repositories.added }} -## comentario_propuesta +## issue_comment {% data reusables.webhooks.issue_comment_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `issues` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `issues` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.issue_comment_webhook_properties %} {% data reusables.webhooks.issue_comment_properties %} @@ -561,21 +562,21 @@ Este evento ocurre cuando alguien revoca su autorización de una {% data variabl {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.issue_comment.created }} -## propuestas +## issues {% data reusables.webhooks.issues_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `issues` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `issues` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.issue_webhook_properties %} {% data reusables.webhooks.issue_properties %} @@ -584,72 +585,72 @@ Este evento ocurre cuando alguien revoca su autorización de una {% data variabl {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook cuando alguien edita un informe de problemas +### Webhook payload example when someone edits an issue {{ webhookPayloadsForCurrentVersion.issues.edited }} -## etiqueta +## label {% data reusables.webhooks.label_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `metadata` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `metadata` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| ---------------------- | ----------- | --------------------------------------------------------------------- | -| `Acción` | `secuencia` | La acción que se realizó. Puede ser `created`, `edited`, o `deleted`. | -| `etiqueta` | `objeto` | La etiqueta que se añadió. | -| `changes` | `objeto` | Los cambios a la etiqueta si la acción se `edited` (editó). | -| `changes[name][from]` | `secuencia` | La versión previa del nombre si la acción está como `edited`. | -| `changes[color][from]` | `secuencia` | La versión previa del color si la acción se `edited` (editó). | +Key | Type | Description +----|------|------------- +`action`|`string` | The action that was performed. Can be `created`, `edited`, or `deleted`. +`label`|`object` | The label that was added. +`changes`|`object`| The changes to the label if the action was `edited`. +`changes[name][from]`|`string` | The previous version of the name if the action was `edited`. +`changes[color][from]`|`string` | The previous version of the color if the action was `edited`. {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.label.deleted }} {% ifversion fpt or ghec %} ## marketplace_purchase -Actividad relacionada con una compra en GitHub Marketplace. {% data reusables.webhooks.action_type_desc %} Para obtener más información, consulta el "[GitHub Marketplace](/marketplace/)". +Activity related to a GitHub Marketplace purchase. {% data reusables.webhooks.action_type_desc %} For more information, see the "[GitHub Marketplace](/marketplace/)." -### Disponibilidad +### Availability - {% data variables.product.prodname_github_apps %} -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| -------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Acción` | `secuencia` | La acción realizada para un plan de [GitHub Marketplace](https://github.com/marketplace). Puede ser una de las siguientes: | +Key | Type | Description +----|------|------------- +`action` | `string` | The action performed for a [GitHub Marketplace](https://github.com/marketplace) plan. Can be one of: -Para obtener una descripción detallada de esta carga útil y de aquella para cada tipo de `action`, consulta los [eventos de webhook de {% data variables.product.prodname_marketplace %}](/marketplace/integrating-with-the-github-marketplace-api/github-marketplace-webhook-events/). +For a detailed description of this payload and the payload for each type of `action`, see [{% data variables.product.prodname_marketplace %} webhook events](/marketplace/integrating-with-the-github-marketplace-api/github-marketplace-webhook-events/). -### Ejemplo de carga útil de webhook cuando alguien compra el plan +### Webhook payload example when someone purchases the plan {{ webhookPayloadsForCurrentVersion.marketplace_purchase.purchased }} {% endif %} -## miembro +## member {% data reusables.webhooks.member_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `members` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `members` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.member_webhook_properties %} {% data reusables.webhooks.member_properties %} @@ -658,7 +659,7 @@ Para obtener una descripción detallada de esta carga útil y de aquella para ca {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.member.added }} @@ -666,57 +667,57 @@ Para obtener una descripción detallada de esta carga útil y de aquella para ca {% data reusables.webhooks.membership_short_desc %} -### Disponibilidad +### Availability -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `members` +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `members` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.membership_properties %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.membership.removed }} ## meta -Se eliminó el evento para el cual se configuró este webhook. Este evento únicamente escuchará los cambios del gancho particular en el cual se instaló. Por lo tanto, debe seleccionarse para cada gancho para el cual quieras recibir metaeventos. +The webhook this event is configured on was deleted. This event will only listen for changes to the particular hook the event is installed on. Therefore, it must be selected for each hook that you'd like to receive meta events for. -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización +- Repository webhooks +- Organization webhooks -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| --------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Acción` | `secuencia` | La acción realizada. Puede ser `deleted`. | -| `hook_id` | `número` | La id del webhook modificado. | -| `gancho` | `objeto` | El webhook modificado. Este contendrá claves diferentes con base en el tipo de webhook que sea: de repositorio, organización, negocio, app, o GitHub Marketplace. | +Key | Type | Description +----|------|------------- +`action` |`string` | The action performed. Can be `deleted`. +`hook_id` |`integer` | The id of the modified webhook. +`hook` |`object` | The modified webhook. This will contain different keys based on the type of webhook it is: repository, organization, business, app, or GitHub Marketplace. {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.meta.deleted }} -## hito +## milestone {% data reusables.webhooks.milestone_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `pull_requests` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `pull_requests` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.milestone_properties %} {% data reusables.webhooks.repo_desc %} @@ -724,7 +725,7 @@ Se eliminó el evento para el cual se configuró este webhook. Este evento únic {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.milestone.created }} @@ -732,25 +733,25 @@ Se eliminó el evento para el cual se configuró este webhook. Este evento únic {% data reusables.webhooks.organization_short_desc %} -### Disponibilidad +### Availability {% ifversion ghes or ghae %} -- Los webhooks de GitHub Enterprise reciben únicamente eventos de `created` y `deleted`. Para obtener más información, consulta los "[webhooks globales](/rest/reference/enterprise-admin#global-webhooks/).{% endif %} -- Los webhooks de organización únicamente reciben los eventos `deleted`, `added`, `removed`, `renamed`, y `invited` events -- {% data variables.product.prodname_github_apps %} con el permiso `members` +- GitHub Enterprise webhooks only receive `created` and `deleted` events. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/).{% endif %} +- Organization webhooks only receive the `deleted`, `added`, `removed`, `renamed`, and `invited` events +- {% data variables.product.prodname_github_apps %} with the `members` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| ------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Acción` | `secuencia` | La acción que se realizó. Puede ser uno de entre:{% ifversion ghes or ghae %} `created`,{% endif %} `deleted`, `renamed`, `member_added`, `member_removed`, o `member_invited`. | -| `invitación` | `objeto` | La invitación para el usuario o correo electrónico si la acción es `member_invited`. | -| `membership` | `objeto` | La membrecía entre el usuario y la organización. No está presente cuando la cción es `member_invited`. | +Key | Type | Description +----|------|------------- +`action` |`string` | The action that was performed. Can be one of:{% ifversion ghes or ghae %} `created`,{% endif %} `deleted`, `renamed`, `member_added`, `member_removed`, or `member_invited`. +`invitation` |`object` | The invitation for the user or email if the action is `member_invited`. +`membership` |`object` | The membership between the user and the organization. Not present when the action is `member_invited`. {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.organization.member_added }} @@ -760,22 +761,22 @@ Se eliminó el evento para el cual se configuró este webhook. Este evento únic {% data reusables.webhooks.org_block_short_desc %} -### Disponibilidad +### Availability -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `organization_administration` +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `organization_administration` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| -------------- | ----------- | ----------------------------------------------------------- | -| `Acción` | `secuencia` | La acción realizada. Puede ser `blocked` o `unblocked`. | -| `blocked_user` | `objeto` | Información acerca del usuario que se bloqueó o desbloqueó. | +Key | Type | Description +----|------|------------ +`action` | `string` | The action performed. Can be `blocked` or `unblocked`. +`blocked_user` | `object` | Information about the user that was blocked or unblocked. {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.org_block.blocked }} @@ -783,23 +784,23 @@ Se eliminó el evento para el cual se configuró este webhook. Este evento únic {% ifversion fpt or ghae or ghec %} -## paquete +## package -Actividad relacionada con el {% data variables.product.prodname_registry %}. {% data reusables.webhooks.action_type_desc %} para obtener más información, consulta la sección "[Administrar paquetes con {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages)" para aprender más sobre el {% data variables.product.prodname_registry %}. +Activity related to {% data variables.product.prodname_registry %}. {% data reusables.webhooks.action_type_desc %} For more information, see "[Managing packages with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages)" to learn more about {% data variables.product.prodname_registry %}. -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización +- Repository webhooks +- Organization webhooks -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.package_properties %} {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.package.published }} {% endif %} @@ -808,24 +809,24 @@ Actividad relacionada con el {% data variables.product.prodname_registry %}. {% {% data reusables.webhooks.page_build_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `pages` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `pages` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| ------- | -------- | ---------------------------------------------------------------------------------------------------------------- | -| `id` | `número` | El idientificador único de la compilación de la página. | -| `build` | `objeto` | La misma terminal de [Listar las compilaciones de GitHub Pages](/rest/reference/repos#list-github-pages-builds). | +Key | Type | Description +----|------|------------ +`id` | `integer` | The unique identifier of the page build. +`build` | `object` | The [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) itself. {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.page_build }} @@ -833,25 +834,25 @@ Actividad relacionada con el {% data variables.product.prodname_registry %}. {% {% data reusables.webhooks.ping_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- Las {% data variables.product.prodname_github_apps %} reciben un evento de ping con un `app_id` que se utiliza para registrar la app +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} receive a ping event with an `app_id` used to register the app -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| -------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `zen` | `secuencia` | Secuencia aleatoria de GitHub zen. | -| `hook_id` | `número` | La ID del webhook que activó el ping. | -| `gancho` | `objeto` | La [configuración del webhook](/rest/reference/repos#get-a-repository-webhook). | -| `hook[app_id]` | `número` | Cuando registras una {% data variables.product.prodname_github_app %} nueva, {% data variables.product.product_name %} envía un evento de ping a la **URL del webhook** que especificaste durante el registro. El evento contiene la `app_id`, la cual se requiere para [autenticar](/apps/building-integrations/setting-up-and-registering-github-apps/about-authentication-options-for-github-apps/) una app. | +Key | Type | Description +----|------|------------ +`zen` | `string` | Random string of GitHub zen. +`hook_id` | `integer` | The ID of the webhook that triggered the ping. +`hook` | `object` | The [webhook configuration](/rest/reference/repos#get-a-repository-webhook). +`hook[app_id]` | `integer` | When you register a new {% data variables.product.prodname_github_app %}, {% data variables.product.product_name %} sends a ping event to the **webhook URL** you specified during registration. The event contains the `app_id`, which is required for [authenticating](/apps/building-integrations/setting-up-and-registering-github-apps/about-authentication-options-for-github-apps/) an app. {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.ping }} @@ -859,13 +860,13 @@ Actividad relacionada con el {% data variables.product.prodname_registry %}. {% {% data reusables.webhooks.project_card_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- Las {% data variables.product.prodname_github_apps %} con el permiso `repository_projects` or `organization_projects` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `repository_projects` or `organization_projects` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.project_card_properties %} {% data reusables.webhooks.repo_desc %} @@ -873,7 +874,7 @@ Actividad relacionada con el {% data variables.product.prodname_registry %}. {% {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.project_card.created }} @@ -881,13 +882,13 @@ Actividad relacionada con el {% data variables.product.prodname_registry %}. {% {% data reusables.webhooks.project_column_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- Las {% data variables.product.prodname_github_apps %} con el permiso `repository_projects` or `organization_projects` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `repository_projects` or `organization_projects` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.project_column_properties %} {% data reusables.webhooks.repo_desc %} @@ -895,7 +896,7 @@ Actividad relacionada con el {% data variables.product.prodname_registry %}. {% {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.project_column.created }} @@ -903,13 +904,13 @@ Actividad relacionada con el {% data variables.product.prodname_registry %}. {% {% data reusables.webhooks.project_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- Las {% data variables.product.prodname_github_apps %} con el permiso `repository_projects` or `organization_projects` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `repository_projects` or `organization_projects` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.project_properties %} {% data reusables.webhooks.repo_desc %} @@ -917,7 +918,7 @@ Actividad relacionada con el {% data variables.product.prodname_registry %}. {% {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.project.created }} @@ -925,37 +926,36 @@ Actividad relacionada con el {% data variables.product.prodname_registry %}. {% ## public {% data reusables.webhooks.public_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `metadata` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `metadata` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| ----- | ---- | ----------- | -| | | | +Key | Type | Description +----|------|------------- {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.public }} {% endif %} -## solicitud_extracción +## pull_request {% data reusables.webhooks.pull_request_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `pull_requests` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `pull_requests` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.pull_request_webhook_properties %} {% data reusables.webhooks.pull_request_properties %} @@ -964,23 +964,23 @@ Actividad relacionada con el {% data variables.product.prodname_registry %}. {% {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example -Las entregas para los eventos `review_requested` y `review_request_removed` tendrán un campo adicional llamado `requested_reviewer`. +Deliveries for `review_requested` and `review_request_removed` events will have an additional field called `requested_reviewer`. {{ webhookPayloadsForCurrentVersion.pull_request.opened }} -## revisión_solicitud de extracción +## pull_request_review {% data reusables.webhooks.pull_request_review_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `pull_requests` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `pull_requests` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.pull_request_review_properties %} {% data reusables.webhooks.repo_desc %} @@ -988,21 +988,21 @@ Las entregas para los eventos `review_requested` y `review_request_removed` tend {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.pull_request_review.submitted }} -## comentarios _revisiones_solicitudes de extracción +## pull_request_review_comment {% data reusables.webhooks.pull_request_review_comment_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `pull_requests` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `pull_requests` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.pull_request_review_comment_webhook_properties %} {% data reusables.webhooks.pull_request_review_comment_properties %} @@ -1011,71 +1011,71 @@ Las entregas para los eventos `review_requested` y `review_request_removed` tend {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.pull_request_review_comment.created }} -## subir +## push {% data reusables.webhooks.push_short_desc %} {% note %} -**Nota:** No recibirás un webhook para este evento cuando cargues más de tres etiquetas al mismo tiempo. +**Note:** You will not receive a webhook for this event when you push more than three tags at once. {% endnote %} -### Disponibilidad - -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `contents` - -### Objeto de carga útil del webhook - -| Clave | Tipo | Descripción | -| -------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ref` | `secuencia` | Toda la [`git ref`](/rest/reference/git#refs) que se cargó. Ejemplo: `refs/heads/main` o `refs/tags/v3.14.1`. | -| `before` | `secuencia` | El SHA de la confirmación más reciente en `ref` antes de la carga. | -| `after` | `secuencia` | El SHA de la confirmación más reciente en `ref` después de la carga. | -| `created` | `boolean` | Si es que esta subida creó la `ref`. | -| `deleted` | `boolean` | Si es que esta subida borró la `ref`. | -| `forced` | `boolean` | Si es que esta subida fue una subida forzada de la `ref`. | -| `head_commit` | `objeto` | Para las subidas en donde `after` es o apunta a un objeto de confirmación, es una representación expandida de dicha confirmación. Para las subidas en donde `after` se refiere a un objeto de etiqueta anotada, es una representación expandida de la confirmación a la que otra etiqueta apuntó. | -| `compare` | `secuencia` | URL que muestra los cambios en esta actualización de `ref`, desde la confirmación `before` hasta la de `after`. Para una `ref` recién creada que se basa directamente en la rama predeterminada, esta es la comparación entre el encabezado de la rama predeterminada y la confirmación de `after`. De lo contrario, esto muestra todas las confirmaciones hasta la confirmación de `after`. | -| `commits` | `arreglo` | Un conjunto de objetos de confirmación que describen las confirmaciones subidas. (Las confirmaciones subidas son todas las que se incluyen en el `compare` entre la confirmación de `before` y la de `after`). El arreglo incluye un máximo de 20 confirmaciones. De ser encesario, puedes utilizar la [API de confirmaciones](/rest/reference/repos#commits) para recuperar confirmaciones adicionales. Este límite se aplica a los eventos cronológicos únicamente y no se aplica a las entregas de webhooks. | -| `commits[][id]` | `secuencia` | El SHA de la confirmación. | -| `commits[][timestamp]` | `secuencia` | La marca de tiempo de tipo ISO 8601 de la confirmación. | -| `commits[][message]` | `secuencia` | El mensaje de la confirmación. | -| `commits[][author]` | `objeto` | El autor de git de la confirmación. | -| `commits[][author][name]` | `secuencia` | El nombre del autor de git. | -| `commits[][author][email]` | `secuencia` | La dirección de correo electrónico del autor de git. | -| `commits[][url]` | `url` | URL que apunta al recurso de la API de la confirmación. | -| `commits[][distinct]` | `boolean` | Si la confirmación es distinta de cualquier otra que se haya subido antes. | -| `commits[][added]` | `arreglo` | Un arreglo de archivos que se agregaron en la confirmación. | -| `commits[][modified]` | `arreglo` | Un areglo de archivos que modificó la confirmación. | -| `commits[][removed]` | `arreglo` | Un arreglo de archivos que se eliminaron en la confirmación. | -| `pusher` | `objeto` | El usuario que subió la confirmación. | +### Availability + +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `contents` permission + +### Webhook payload object + +Key | Type | Description +----|------|------------- +`ref`|`string` | The full [`git ref`](/rest/reference/git#refs) that was pushed. Example: `refs/heads/main` or `refs/tags/v3.14.1`. +`before`|`string` | The SHA of the most recent commit on `ref` before the push. +`after`|`string` | The SHA of the most recent commit on `ref` after the push. +`created`|`boolean` | Whether this push created the `ref`. +`deleted`|`boolean` | Whether this push deleted the `ref`. +`forced`|`boolean` | Whether this push was a force push of the `ref`. +`head_commit`|`object` | For pushes where `after` is or points to a commit object, an expanded representation of that commit. For pushes where `after` refers to an annotated tag object, an expanded representation of the commit pointed to by the annotated tag. +`compare`|`string` | URL that shows the changes in this `ref` update, from the `before` commit to the `after` commit. For a newly created `ref` that is directly based on the default branch, this is the comparison between the head of the default branch and the `after` commit. Otherwise, this shows all commits until the `after` commit. +`commits`|`array` | An array of commit objects describing the pushed commits. (Pushed commits are all commits that are included in the `compare` between the `before` commit and the `after` commit.) The array includes a maximum of 20 commits. If necessary, you can use the [Commits API](/rest/reference/repos#commits) to fetch additional commits. This limit is applied to timeline events only and isn't applied to webhook deliveries. +`commits[][id]`|`string` | The SHA of the commit. +`commits[][timestamp]`|`string` | The ISO 8601 timestamp of the commit. +`commits[][message]`|`string` | The commit message. +`commits[][author]`|`object` | The git author of the commit. +`commits[][author][name]`|`string` | The git author's name. +`commits[][author][email]`|`string` | The git author's email address. +`commits[][url]`|`url` | URL that points to the commit API resource. +`commits[][distinct]`|`boolean` | Whether this commit is distinct from any that have been pushed before. +`commits[][added]`|`array` | An array of files added in the commit. +`commits[][modified]`|`array` | An array of files modified by the commit. +`commits[][removed]`|`array` | An array of files removed in the commit. +`pusher` | `object` | The user who pushed the commits. {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.push }} -## lanzamiento +## release {% data reusables.webhooks.release_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `contents` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `contents` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.release_webhook_properties %} {% data reusables.webhooks.release_properties %} @@ -1084,66 +1084,66 @@ Las entregas para los eventos `review_requested` y `review_request_removed` tend {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.release.published }} {% ifversion fpt or ghes or ghae or ghec %} ## repository_dispatch -Este evento ocurre cuando una {% data variables.product.prodname_github_app %} envía una solicitud de `POST` a la terminal "[Crear un evento de envío de repositorio](/rest/reference/repos#create-a-repository-dispatch-event)". +This event occurs when a {% data variables.product.prodname_github_app %} sends a `POST` request to the "[Create a repository dispatch event](/rest/reference/repos#create-a-repository-dispatch-event)" endpoint. -### Disponibilidad +### Availability -- Las {% data variables.product.prodname_github_apps %} deben tener el permiso `contents` para recibir este webhook. +- {% data variables.product.prodname_github_apps %} must have the `contents` permission to receive this webhook. -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.repository_dispatch }} {% endif %} -## repositorio +## repository {% data reusables.webhooks.repository_short_desc %} -### Disponibilidad +### Availability -- Los webhooks de repositorio reciben todos los eventos excepto los de `deleted` -- Webhooks de organización -- Las {% data variables.product.prodname_github_apps %} con el permiso `metadata` reciben todos los tipos de evento menos los de `deleted` +- Repository webhooks receive all event types except `deleted` +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `metadata` permission receive all event types except `deleted` -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| -------- | ----------- | ---------------------------------------------------------------------------------------- | -| `Acción` | `secuencia` | La acción que se realizó. Esta puede ser una de las siguientes: | +Key | Type | Description +----|------|------------- +`action` |`string` | The action that was performed. This can be one of: {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.repository.publicized }} {% ifversion fpt or ghec %} ## repository_import -{% data reusables.webhooks.repository_import_short_desc %} Para recibir este evento para un repositorio personal, debes crear un repositorio vacío antes de la importación. Este evento puede activarse utilizando ya sea el [Importador de GitHub](/articles/importing-a-repository-with-github-importer/) o la [API de importaciones fuente](/rest/reference/migrations#source-imports). +{% data reusables.webhooks.repository_import_short_desc %} To receive this event for a personal repository, you must create an empty repository prior to the import. This event can be triggered using either the [GitHub Importer](/articles/importing-a-repository-with-github-importer/) or the [Source imports API](/rest/reference/migrations#source-imports). -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización +- Repository webhooks +- Organization webhooks -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.repository_import_properties %} {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.repository_import }} @@ -1151,19 +1151,19 @@ Este evento ocurre cuando una {% data variables.product.prodname_github_app %} e {% data reusables.webhooks.repository_vulnerability_alert_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización +- Repository webhooks +- Organization webhooks -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.repository_vulnerability_alert_properties %} {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.repository_vulnerability_alert.create }} @@ -1175,21 +1175,21 @@ Este evento ocurre cuando una {% data variables.product.prodname_github_app %} e {% data reusables.webhooks.secret_scanning_alert_event_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- Las {% data variables.product.prodname_github_apps %} con el permiso de `secret_scanning_alerts:read` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `secret_scanning_alerts:read` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.secret_scanning_alert_event_properties %} {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} -`sender` | `object` | Si la `action` se muestra como `resolved` o como `reopened`, el objeto `sender` será el usuario que activó el evento. El objeto `sender` estará vacío en el resto de las acciones. +`sender` | `object` | If the `action` is `resolved` or `reopened`, the `sender` object will be the user that triggered the event. The `sender` object is empty for all other actions. -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.secret_scanning_alert.reopened }} {% endif %} @@ -1197,21 +1197,21 @@ Este evento ocurre cuando una {% data variables.product.prodname_github_app %} e {% ifversion fpt or ghes or ghec %} ## security_advisory -Actividad relacionada con una asesoría de seguridad. Una asesoría de seguridad proporciona información acerca de las vulnerabilidades relacionadas con la seguridad en el software dentro de GitHub. El conjunto de datos de la asesoría de seguridad también impulsa las alertas de seguridad de Github, consulta la sección "[Acerca de las alertas para las dependencias vulnerables](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/)". +Activity related to a security advisory. A security advisory provides information about security-related vulnerabilities in software on GitHub. The security advisory dataset also powers the GitHub security alerts, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/)." {% endif %} -### Disponibilidad +### Availability -- {% data variables.product.prodname_github_apps %} con el permiso `security_events` +- {% data variables.product.prodname_github_apps %} with the `security_events` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| ------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -| `Acción` | `secuencia` | La acción que se realizó. La acción puede ser una de entre `published`, `updated`, `performed`, o `withdrawn` para todos los eventos nuevos. | -| `security_advisory` | `objeto` | Los detalles de la asesoría de seguridad, incluyendo el resumen, descripción, y severidad. | +Key | Type | Description +----|------|------------- +`action` |`string` | The action that was performed. The action can be one of `published`, `updated`, `performed`, or `withdrawn` for all new events. +`security_advisory` |`object` | The details of the security advisory, including summary, description, and severity. -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.security_advisory.published }} @@ -1220,104 +1220,104 @@ Actividad relacionada con una asesoría de seguridad. Una asesoría de seguridad {% data reusables.webhooks.sponsorship_short_desc %} -Solo puedes crear un webhook de patrocinio en {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta la sección "[Configurar webhooks para eventos en tu cuenta patrocinada](/sponsors/integrating-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account)". +You can only create a sponsorship webhook on {% data variables.product.prodname_dotcom %}. For more information, see "[Configuring webhooks for events in your sponsored account](/sponsors/integrating-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account)". -### Disponibilidad +### Availability -- Cuentas patrocinadas +- Sponsored accounts -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.sponsorship_webhook_properties %} {% data reusables.webhooks.sponsorship_properties %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil de un webhook cuando alguien crea un patrocinio +### Webhook payload example when someone creates a sponsorship {{ webhookPayloadsForCurrentVersion.sponsorship.created }} -### Ejemplo de carga útil de un webhook cuando alguien degrada un patrocinio +### Webhook payload example when someone downgrades a sponsorship {{ webhookPayloadsForCurrentVersion.sponsorship.downgraded }} {% endif %} -## estrella +## star {% data reusables.webhooks.star_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización +- Repository webhooks +- Organization webhooks -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.star_properties %} {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.star.created }} -## estado +## status {% data reusables.webhooks.status_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `statuses` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `statuses` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| ------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `id` | `número` | El identificador único del estado. | -| `sha` | `secuencia` | El SHA de la confirmación. | -| `state` | `secuencia` | El estado nuevo. Puede ser `pending`, `success`, `failure`, o `error`. | -| `descripción` | `secuencia` | La descripción opcional legible para las personas que se agrega al estado. | -| `url_destino` | `secuencia` | El enlace opcional agregado al estado. | -| `branches` | `arreglo` | Un conjunto de objetos de la rama que contiene el SHA del estado. Cada rama contiene el SHA proporcionado, pero éste puede ser o no el encabezado de la rama. El conjunto incluye un máximo de 10 ramas. | +Key | Type | Description +----|------|------------- +`id` | `integer` | The unique identifier of the status. +`sha`|`string` | The Commit SHA. +`state`|`string` | The new state. Can be `pending`, `success`, `failure`, or `error`. +`description`|`string` | The optional human-readable description added to the status. +`target_url`|`string` | The optional link added to the status. +`branches`|`array` | An array of branch objects containing the status' SHA. Each branch contains the given SHA, but the SHA may or may not be the head of the branch. The array includes a maximum of 10 branches. {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.status }} -## equipo +## team {% data reusables.webhooks.team_short_desc %} -### Disponibilidad - -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `members` - -### Objeto de carga útil del webhook - -| Clave | Type | Descripción | -| ----------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Acción` | `secuencia` | La acción que se realizó. Puede ser uno de entre `created`, `deleted`, `edited`, `added_to_repository`, o `removed_from_repository`. | -| `equipo` | `objeto` | El equipo mismo. | -| `changes` | `objeto` | Los cambios al equipo si la acción está como `edited`. | -| `changes[description][from]` | `secuencia` | La versión previa de la descripción si la acción está como `edited`. | -| `changes[name][from]` | `secuencia` | La versión previa del nombre si la acción está como `edited`. | -| `changes[privacy][from]` | `secuencia` | La versión previa de la privacidad del equipo si ésta se encuentra como `edited`. | -| `changes[repository][permissions][from][admin]` | `boolean` | La versión previa de los permisos de `admin` del miembro del equipo en un repositorio si la acción se encuentra como `edited`. | -| `changes[repository][permissions][from][pull]` | `boolean` | La versión previa de los permisos de `pull` del miembro del equipo en un repositorio si la acción se encuentra como `edited`. | -| `changes[repository][permissions][from][push]` | `boolean` | La versión previa de los permisos de `push` del miembro del equipo en un repositorio si la acción se encuentra como `edited`. | -| `repositorio` | `objeto` | El repositorio que se agregó o eliminó del alcance del equipo si la acción se encuentra como `added_to_repository`, `removed_from_repository`, o `edited`. Para las acciones que estén como `edited`, el `repository` también contendrá los nuevos niveles de permiso del equipo para dicho repositorio. | +### Availability + +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `members` permission + +### Webhook payload object + +Key | Type | Description +----|------|------------- +`action` |`string` | The action that was performed. Can be one of `created`, `deleted`, `edited`, `added_to_repository`, or `removed_from_repository`. +`team` |`object` | The team itself. +`changes`|`object` | The changes to the team if the action was `edited`. +`changes[description][from]` |`string` | The previous version of the description if the action was `edited`. +`changes[name][from]` |`string` | The previous version of the name if the action was `edited`. +`changes[privacy][from]` |`string` | The previous version of the team's privacy if the action was `edited`. +`changes[repository][permissions][from][admin]` | `boolean` | The previous version of the team member's `admin` permission on a repository, if the action was `edited`. +`changes[repository][permissions][from][pull]` | `boolean` | The previous version of the team member's `pull` permission on a repository, if the action was `edited`. +`changes[repository][permissions][from][push]` | `boolean` | The previous version of the team member's `push` permission on a repository, if the action was `edited`. +`repository`|`object` | The repository that was added or removed from to the team's purview if the action was `added_to_repository`, `removed_from_repository`, or `edited`. For `edited` actions, `repository` also contains the team's new permission levels for the repository. {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.team.added_to_repository }} @@ -1325,54 +1325,54 @@ Solo puedes crear un webhook de patrocinio en {% data variables.product.prodname {% data reusables.webhooks.team_add_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `members` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `members` permission -### Objeto de carga útil del webhook +### Webhook payload object -| Clave | Type | Descripción | -| -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- | -| `equipo` | `objeto` | El [equipo](/rest/reference/teams) que se modificó. **Nota:** Los eventos anteriores podrían no incluir esto en la carga útil. | +Key | Type | Description +----|------|------------- +`team`|`object` | The [team](/rest/reference/teams) that was modified. **Note:** Older events may not include this in the payload. {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.team_add }} {% ifversion ghes or ghae %} -## usuario +## user -Cuando se aplica `created` o `deleted` a un usuario. +When a user is `created` or `deleted`. -### Disponibilidad -- Webhooks de GitHub Enterprise. Para obtener más información, consulta los "[webhooks globales](/rest/reference/enterprise-admin#global-webhooks/)." +### Availability +- GitHub Enterprise webhooks. For more information, "[Global webhooks](/rest/reference/enterprise-admin#global-webhooks/)." -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.user.created }} {% endif %} -## observar +## watch {% data reusables.webhooks.watch_short_desc %} -El actor del evento es el [usuario](/rest/reference/users) que marcó el repositorio con una estrella, y el repositorio del evento es el [repositorio](/rest/reference/repos) que se marcó con una estrella. +The event’s actor is the [user](/rest/reference/users) who starred a repository, and the event’s repository is the [repository](/rest/reference/repos) that was starred. -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- {% data variables.product.prodname_github_apps %} con el permiso `metadata` +- Repository webhooks +- Organization webhooks +- {% data variables.product.prodname_github_apps %} with the `metadata` permission -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.watch_properties %} {% data reusables.webhooks.repo_desc %} @@ -1380,20 +1380,20 @@ El actor del evento es el [usuario](/rest/reference/users) que marcó el reposit {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.watch.started }} {% ifversion fpt or ghes or ghec %} ## workflow_dispatch -Este evento ocurre cuando alguien activa una ejecución de flujo de trabajo en GitHub o cuando envía una solicitud de tipo `POST` a la terminal [Crear un evento de envío de flujo de trabajo](/rest/reference/actions/#create-a-workflow-dispatch-event)". Para obtener más información, consulta la sección "[Eventos que activan los flujos de trabajo](/actions/reference/events-that-trigger-workflows#workflow_dispatch)". +This event occurs when someone triggers a workflow run on GitHub or sends a `POST` request to the "[Create a workflow dispatch event](/rest/reference/actions/#create-a-workflow-dispatch-event)" endpoint. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#workflow_dispatch)." -### Disponibilidad +### Availability -- Las {% data variables.product.prodname_github_apps %} deben tener el permiso `contents` para recibir este webhook. +- {% data variables.product.prodname_github_apps %} must have the `contents` permission to receive this webhook. -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.workflow_dispatch }} {% endif %} @@ -1404,20 +1404,20 @@ Este evento ocurre cuando alguien activa una ejecución de flujo de trabajo en G {% data reusables.webhooks.workflow_job_short_desc %} -### Disponibilidad +### Availability -- Webhooks de repositorio -- Webhooks de organización -- Webhooks empresariales +- Repository webhooks +- Organization webhooks +- Enterprise webhooks -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.workflow_job_properties %} {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.workflow_job }} @@ -1425,13 +1425,13 @@ Este evento ocurre cuando alguien activa una ejecución de flujo de trabajo en G {% ifversion fpt or ghes or ghec %} ## workflow_run -Cuando una ejecución de flujo de trabajo de {% data variables.product.prodname_actions %} se solicita o se completa. Para obtener más información, consulta la sección "[Eventos que activan los flujos de trabajo](/actions/reference/events-that-trigger-workflows#workflow_run)". +When a {% data variables.product.prodname_actions %} workflow run is requested or completed. For more information, see "[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#workflow_run)." -### Disponibilidad +### Availability -- En {% data variables.product.prodname_github_apps %} con los permisos de `actions` o de `contents`. +- {% data variables.product.prodname_github_apps %} with the `actions` or `contents` permissions. -### Objeto de carga útil del webhook +### Webhook payload object {% data reusables.webhooks.workflow_run_properties %} {% data reusables.webhooks.workflow_desc %} @@ -1439,7 +1439,7 @@ Cuando una ejecución de flujo de trabajo de {% data variables.product.prodname_ {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.sender_desc %} -### Ejemplo de carga útil del webhook +### Webhook payload example {{ webhookPayloadsForCurrentVersion.workflow_run }} {% endif %} diff --git a/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md b/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md index a11f87792f6f..f1b441fcdcdd 100644 --- a/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md +++ b/translations/es-ES/content/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md @@ -242,6 +242,7 @@ For more information, see "[Autolinked references and URLs](/articles/autolinked {% data reusables.repositories.autolink-references %} +{% ifversion ghes < 3.4 %} ## Content attachments Some {% data variables.product.prodname_github_apps %} provide information in {% data variables.product.product_name %} for URLs that link to their registered domains. {% data variables.product.product_name %} renders the information provided by the app under the URL in the body or comment of an issue or pull request. @@ -252,7 +253,7 @@ To see content attachments, you must have a {% data variables.product.prodname_g Content attachments will not be displayed for URLs that are part of a markdown link. -For more information about building a {% data variables.product.prodname_github_app %} that uses content attachments, see "[Using Content Attachments](/apps/using-content-attachments)." +For more information about building a {% data variables.product.prodname_github_app %} that uses content attachments, see "[Using Content Attachments](/apps/using-content-attachments)."{% endif %} ## Uploading assets diff --git a/translations/es-ES/content/issues/guides.md b/translations/es-ES/content/issues/guides.md index e578406d0547..1653a48f8768 100644 --- a/translations/es-ES/content/issues/guides.md +++ b/translations/es-ES/content/issues/guides.md @@ -1,7 +1,7 @@ --- title: Issues guides -shortTitle: Guías -intro: 'Aprende cómo puedes utilizar las {% data variables.product.prodname_github_issues %} para planear y rastrear tu trabajo.' +shortTitle: Guides +intro: 'Learn how you can use {% data variables.product.prodname_github_issues %} to plan and track your work.' allowTitleToDifferFromFilename: true layout: product-guides versions: diff --git a/translations/es-ES/content/rest/overview/api-previews.md b/translations/es-ES/content/rest/overview/api-previews.md index 54bb11265136..36d03bec2929 100644 --- a/translations/es-ES/content/rest/overview/api-previews.md +++ b/translations/es-ES/content/rest/overview/api-previews.md @@ -183,6 +183,7 @@ You can now configure whether organization members can create repositories and w {% endif %} +{% ifversion ghes < 3.4 %} ## Content attachments You can now provide more information in GitHub for URLs that link to registered domains by using the {% data variables.product.prodname_unfurls %} API. See "[Using content attachments](/apps/using-content-attachments/)" for more details. @@ -190,6 +191,7 @@ You can now provide more information in GitHub for URLs that link to registered **Custom media types:** `corsair-preview` **Announced:** [2018-12-10](https://developer.github.com/changes/2018-12-10-content-attachments-api/) +{% endif %} {% ifversion ghae or ghes < 3.3 %} ## Enable and disable Pages diff --git a/translations/es-ES/content/rest/reference/permissions-required-for-github-apps.md b/translations/es-ES/content/rest/reference/permissions-required-for-github-apps.md index a8142804dc8e..388c85781c34 100644 --- a/translations/es-ES/content/rest/reference/permissions-required-for-github-apps.md +++ b/translations/es-ES/content/rest/reference/permissions-required-for-github-apps.md @@ -878,6 +878,7 @@ _Teams_ - [`GET /repos/:owner/:repo/secret-scanning/alerts`](/rest/reference/secret-scanning#list-secret-scanning-alerts-for-a-repository) (:read) - [`GET /repos/:owner/:repo/secret-scanning/alerts/:alert_number`](/rest/reference/secret-scanning#get-a-secret-scanning-alert) (:read) - [`PATCH /repos/:owner/:repo/secret-scanning/alerts/:alert_number`](/rest/reference/secret-scanning#update-a-secret-scanning-alert) (:write) +- [`GET /repos/:owner/:repo/secret-scanning/alerts/:alert_number/locations`](/rest/reference/secret-scanning#list-locations-for-a-secret-scanning-alert) (:read) {% endif %} ### Permission on "security events" diff --git a/translations/es-ES/content/sponsors/guides.md b/translations/es-ES/content/sponsors/guides.md index 7d74d5663564..3754acf94bb4 100644 --- a/translations/es-ES/content/sponsors/guides.md +++ b/translations/es-ES/content/sponsors/guides.md @@ -1,7 +1,7 @@ --- -title: Guías de GitHub Sponsors -shortTitle: Guías -intro: 'Aprende a sacar el mayor provecho de {% data variables.product.prodname_sponsors %}.' +title: GitHub Sponsors guides +shortTitle: Guides +intro: 'Learn how to make the most of {% data variables.product.prodname_sponsors %}.' allowTitleToDifferFromFilename: true layout: product-guides versions: @@ -16,3 +16,4 @@ includeGuides: - /sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-organization - /sponsors/integrating-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account --- + diff --git a/translations/es-ES/data/learning-tracks/README.md b/translations/es-ES/data/learning-tracks/README.md index f75dab88cb8a..c28e0df34439 100644 --- a/translations/es-ES/data/learning-tracks/README.md +++ b/translations/es-ES/data/learning-tracks/README.md @@ -6,7 +6,7 @@ Los enfoques de aprendizaje son una recolección de artículos que te ayudan a d El aprender a rastrear datos de un producto se define en dos lugares: -1. Un arreglo siempre para aprender a rastrear nombres se define en la página preliminar de índice de sub-llegada. +1. A simple array of learning track names is defined in the product guides index page frontmatter. Por ejemplo, en `content/actions/guides/index.md`: ``` @@ -23,13 +23,13 @@ El aprender a rastrear datos de un producto se define en dos lugares: Por ejemplo, en `data/learning-tracks/actions.yml`, cada uno de los elementos del arreglo `learningTracks` del archivo de contenido se representa con datos adicionales tales como `title`, `description` y un arreglo de enlaces de `guides`. - Una pista de aprendizaje en este YAML **por versión** se debe designar como una pista de aprendizaje "destacada" a través de `featured_track: true`, la cual lo configurará para mostrarse en la parte superior de la página de sub-llegada del producto. Las pruebas fallaràn si falta esta propiedad. + One learning track in this YAML **per version** must be designated as a "featured" learning track via `featured_track: true`, which will set it to appear at the top of the product guides page. Las pruebas fallaràn si falta esta propiedad. La propiedad `featured_track` puede ser un valor booleano simple (por ejemplo, `featured_track: true`) o puede ser una secuencia que incluya declaraciones de versión (por ejemplo, `featured_track: '{% ifversion fpt %}true{% else %}false{% endif %}'`). Si utilizas versionamiento, tendrás `featured_track`s múltiples por archivo YML, pero asegúrate de que solo uno se interprete en cada versión compatible actual. Las pruebas fallarán si hay más o menos de un enlace destacado para cada versión. ## Control de versiones -El versionamiento para aprender pistas se procesa en l ahora interpretada de la página. El código vive en [`lib/learning-tracks.js`](lib/learning-tracks.js), al cual llama `page.render()`. `components/sublanding` interpreta las pistas de aprendizaje procesadas. +El versionamiento para aprender pistas se procesa en l ahora interpretada de la página. El código vive en [`lib/learning-tracks.js`](lib/learning-tracks.js), al cual llama `page.render()`. The processed learning tracks are then rendered by `components/guides`. Las condicionales líquidas **no** deben utilizarse para versionar en el archivo YAML para las guías. Solo las guías de pistas de aprendizaje que aplican a la versión actual se interpretarán automáticamente. Si no hay pistas con guías que pertenezcan a la versión actual, la sección de pistas de aprendizaje no se interpretará en lo absoluto. diff --git a/translations/es-ES/data/reusables/enterprise/ghec-cta-button.md b/translations/es-ES/data/reusables/enterprise/ghec-cta-button.md index 57cfaa59ef45..c290f5990011 100644 --- a/translations/es-ES/data/reusables/enterprise/ghec-cta-button.md +++ b/translations/es-ES/data/reusables/enterprise/ghec-cta-button.md @@ -1 +1 @@ -Pruébalo sin riesgos por 14 días +Try {% data variables.product.prodname_ghe_cloud %} for free diff --git a/translations/es-ES/data/reusables/gated-features/environments.md b/translations/es-ES/data/reusables/gated-features/environments.md index 9b6ff9fdf030..971ac29cd580 100644 --- a/translations/es-ES/data/reusables/gated-features/environments.md +++ b/translations/es-ES/data/reusables/gated-features/environments.md @@ -1 +1 @@ -Los ambientes, las reglas de protección de ambiente y los secretos de ambiente se encuentran disponibles en los repositorios **públicos** para todos los productos. Para tener acceso a los ambientes en los repositorios **privados**, debes utilizar {% data variables.product.prodname_enterprise %}.{% data reusables.gated-features.more-info %}{% ifversion fpt or ghec %}{% endif %} +Los ambientes, las reglas de protección de ambiente y los secretos de ambiente se encuentran disponibles en los repositorios **públicos** para todos los productos. For access to environments in **private** repositories, you must use {% data variables.product.prodname_enterprise %}. {% data reusables.gated-features.more-info %} diff --git a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-groups-navigate-to-repo-org-enterprise.md b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-groups-navigate-to-repo-org-enterprise.md index 1139ee5d0b90..2a714dd9526f 100644 --- a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-groups-navigate-to-repo-org-enterprise.md +++ b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-groups-navigate-to-repo-org-enterprise.md @@ -1,10 +1,17 @@ +{% ifversion fpt %} +1. Navigate to the main page of the repository or organization where your self-hosted runner groups are located. +2. Click {% octicon "gear" aria-label="The Settings gear" %} **Settings**. +3. En la barra lateral izquierda, da clic en **Acciones**. +4. Click **Runner groups**. +{% elsif ghec or ghes or ghae %} 1. Navega a donde se ubiquen tus grupos de ejecutores auto-hospedados: - * **En una organización**: navega a la página principal y da clic en {% octicon "gear" aria-label="The Settings gear" %} **Configuración**. - * {% ifversion fpt or ghec %}**Si se utiliza una cuenta empresarial**: navega a tu cuenta visitando `https://github.com/enterprises/ENTERPRISE-NAME`, remplazando la parte de `ENTERPRISE-NAME` con tu nombre de cuenta empresarial.{% elsif ghes or ghae %}**Si utilizas un ejecutor a nivel empresarial**: - + * **In an organization**: navigate to the main page and click {% octicon "gear" aria-label="The Settings gear" %} **Settings**.{% ifversion ghec %} + * **If using an enterprise account**: navigate to your enterprise account by visiting `https://github.com/enterprises/ENTERPRISE-NAME`, replacing `ENTERPRISE-NAME` with your enterprise account's name.{% elsif ghes or ghae %} + * **Si utilizas un ejecutor a nivel de empresa**: 1. En la esquina superior derecha de cualquier página, da clic en {% octicon "rocket" aria-label="The rocket ship" %}. - 1. En la barra lateral izquierda, da clic en **Resumen empresarial**. - 1. {% endif %} En la barra lateral de empresa, {% octicon "law" aria-label="The law icon" %} **Políticas**. -1. Navega a los ajustes de los "Grupos de ejecutores": - * **En una organización**: Haz clic en **Acciones** en la barra lateral izquierda{% ifversion fpt or ghec %} y luego en **Grupos de ejecutores** debajo{% endif %}. - * {% ifversion fpt or ghec %}**Si estás utilizand una cuenta empresarial**:{% elsif ghes or ghae %}**Si estás utilizando un ejecutor a nivel empresarial**:{% endif %} Haz clic en **Acciones** debajo de "{% octicon "law" aria-label="The law icon" %} Políticas"{% ifversion fpt or ghec %}, y luego en la pestaña de **Grupos de Ejecutores** {% endif %}. + 2. En la barra lateral izquierda, da clic en **Resumen empresarial**. + 3. In the enterprise sidebar, click {% octicon "law" aria-label="The law icon" %} **Policies**.{% endif %} +2. Navega a los ajustes de los "Grupos de ejecutores": + * **In an organization**: Click **Actions** in the left sidebar{% ifversion fpt or ghec %}, then click **Runner groups** below it{% endif %}.{% ifversion ghec or ghes or ghae %} + * {% ifversion ghec %}**If using an enterprise account**:{% elsif ghes or ghae %}**If using an enterprise-level runner**:{% endif %} Click **Actions** under "{% octicon "law" aria-label="The law icon" %} Policies"{% ifversion ghec %}, then click the **Runners groups** tab{% endif %}.{% endif %} +{% endif %} diff --git a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-labels-runs-on.md b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-labels-runs-on.md index 70f1ad435422..d948b07bb52c 100644 --- a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-labels-runs-on.md +++ b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-labels-runs-on.md @@ -1,3 +1,5 @@ Para especificar un ejecutor auto-hospedado para tu trabajo, configura `runs-on` en tu archivo de flujo de trabajo con las etiquetas de dicho ejecutor. -Todos los ejecutores auto-hospedados tienen la etiqueta `self-hosted`. El utilizar únicamente esta etiqueta seleccionará cualquier ejecutor auto-hospedado. Para seleccionar los ejecutores que cumplen con ciertos criterios, tales como el sistema operativo o arquitectura, proporciona un arreglo de etiquetas que comience con `self-hosted` (este se debe listar primero) y que luego incluya etiquetas adicionales conforme lo requieras. +Todos los ejecutores auto-hospedados tienen la etiqueta `self-hosted`. El utilizar únicamente esta etiqueta seleccionará cualquier ejecutor auto-hospedado. To select runners that meet certain criteria, such as operating system or architecture, we recommend providing an array of labels that begins with `self-hosted` (this must be listed first) and then includes additional labels as needed. When you specify an array of labels, jobs will be queued on runners that have all the labels that you specify. + +Although the `self-hosted` label is not required, we strongly recommend specifying it when using self-hosted runners to ensure that your job does not unintentionally specify any current or future {% data variables.product.prodname_dotcom %}-hosted runners. diff --git a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md index 0239ccf899b3..30b5e804f259 100644 --- a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md +++ b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-management-permissions-required.md @@ -2,7 +2,7 @@ Un ejecutor auto-hospedado puede ubicarse ya sea en la configuración de tu repo - **Repositorio de usuario**: debes ser el propietario del repositorio. - **Organización**: Debes ser un propietario de la organización. - **Repositorio de la organización**: Debes ser un propietario de la organización, o tener acceso administrativo al repositorio. -{% ifversion fpt or ghec %} +{% ifversion ghec %} - **Cuenta empresarial**: Debes ser un propietario de la empresa. {% elsif ghes or ghae %} - **Empresa**: debes ser un administrador de sitio de {% data variables.product.prodname_enterprise %}. diff --git a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-navigate-to-org-enterprise.md b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-navigate-to-org-enterprise.md index 12ad7b8a9e5e..d8348476c5f6 100644 --- a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-navigate-to-org-enterprise.md +++ b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-navigate-to-org-enterprise.md @@ -1,10 +1,17 @@ +{% ifversion fpt %} +1. Navigate to the main page of the organization where your self-hosted runner group is registered. +2. Click {% octicon "gear" aria-label="The Settings gear" %} **Settings**. +3. En la barra lateral izquierda, da clic en **Acciones**. +4. Click **Runners**. +{% elsif ghec or ghes or ghae %} 1. Navega a donde está registrado tu ejecutor auto-hospedado: * **En una organización**: navega a la página principal y da clic en {% octicon "gear" aria-label="The Settings gear" %} **Configuración**. - * {% ifversion fpt %}**Si se utiliza una cuenta empresarial**: navega a tu cuenta visitando `https://github.com/enterprises/ENTERPRISE-NAME`, remplazando la parte de `ENTERPRISE-NAME` con tu nombre de cuenta empresarial.{% elsif ghes or ghae %}**Si utilizas un ejecutor a nivel empresarial**: + * {% ifversion ghec %}**Si se utiliza una cuenta empresarial**: navega a tu cuenta visitando `https://github.com/enterprises/ENTERPRISE-NAME`, remplazando la parte de `ENTERPRISE-NAME` con tu nombre de cuenta empresarial.{% elsif ghes or ghae %}**Si utilizas un ejecutor a nivel empresarial**: 1. En la esquina superior derecha de cualquier página, da clic en {% octicon "rocket" aria-label="The rocket ship" %}. 1. En la barra lateral izquierda, da clic en **Resumen empresarial**. - 1. {% endif %} En la barra lateral de empresa, {% octicon "law" aria-label="The law icon" %} **Políticas**. + 1. In the enterprise sidebar, {% octicon "law" aria-label="The law icon" %} **Policies**.{% endif %} 1. Navega a los ajustes de {% data variables.product.prodname_actions %}: - * **En una organización**: Haz clic en **Acciones** en la barra lateral izquierda{% ifversion fpt or ghes > 3.1 or ghae-next %} y luego en **Ejecutores**{% endif %}. - * {% ifversion fpt %}**Si estás utilizand una cuenta empresarial**:{% elsif ghes or ghae %}**Si estás utilizando un ejecutor a nivel empresarial**:{% endif %} Haz clic en **Acciones** debajo de "{% octicon "law" aria-label="The law icon" %} Políticas"{% ifversion fpt or ghes > 3.1 or ghae-next %}, y luego en la pestaña de **Ejecutores** {% endif %}. + * **En una organización**: Haz clic en **Acciones** en la barra lateral izquierda{% ifversion fpt or ghec or ghes > 3.1 or ghae-next %} y luego en **Ejecutores**{% endif %}. + * {% ifversion ghec %}**Si estás utilizand una cuenta empresarial**:{% elsif ghes or ghae %}**Si estás utilizando un ejecutor a nivel empresarial**:{% endif %} Haz clic en **Acciones** debajo de "{% octicon "law" aria-label="The law icon" %} Políticas"{% ifversion fpt or ghec or ghes > 3.1 or ghae-next %}, y luego en la pestaña de **Ejecutores** {% endif %}. +{% endif %} diff --git a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md index b4aa0a5c0051..35412e38f89c 100644 --- a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md +++ b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-navigate-to-repo-org-enterprise.md @@ -1,10 +1,17 @@ +{% ifversion fpt %} +1. Navigate to the main page of the organization or repository where your self-hosted runner group is registered. +2. Click {% octicon "gear" aria-label="The Settings gear" %} **Settings**. +3. En la barra lateral izquierda, da clic en **Acciones**. +4. Click **Runners**. +{% elsif ghec or ghes or ghae %} 1. Navega a donde está registrado tu ejecutor auto-hospedado: - * **En un repositorio organizacional**: navega a la página principal y da clic en {% octicon "gear" aria-label="The Settings gear" %} **Configuración**. - * {% ifversion fpt or ghec %}**Si se utiliza una cuenta empresarial**: navega a tu cuenta visitando `https://github.com/enterprises/ENTERPRISE-NAME`, remplazando la parte de `ENTERPRISE-NAME` con tu nombre de cuenta empresarial.{% elsif ghes or ghae %}**Si utilizas un ejecutor a nivel empresarial**: - + * **En un repositorio organizacional**: navega a la página principal y da clic en {% octicon "gear" aria-label="The Settings gear" %} **Configuración**. {% ifversion ghec %} + * **If using an enterprise account**: navigate to your enterprise account by visiting `https://github.com/enterprises/ENTERPRISE-NAME`, replacing `ENTERPRISE-NAME` with your enterprise account's name.{% elsif ghes or ghae %} + * **Si utilizas un ejecutor a nivel de empresa**: 1. En la esquina superior derecha de cualquier página, da clic en {% octicon "rocket" aria-label="The rocket ship" %}. - 1. En la barra lateral izquierda, da clic en **Resumen empresarial**. - 1. {% endif %} En la barra lateral de empresa, {% octicon "law" aria-label="The law icon" %} **Políticas**. -1. Navega a los ajustes de {% data variables.product.prodname_actions %}: - * **En una organización o repositorio**: Haz clic en **Acciones** en la barra lateral izquierda{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %} y luego en **Ejecutores**{% endif %}. - * {% ifversion fpt or ghec %}**Si estás utilizand una cuenta empresarial**:{% elsif ghes or ghae %}**Si estás utilizando un ejecutor a nivel empresarial**:{% endif %} Haz clic en **Acciones** debajo de "{% octicon "law" aria-label="The law icon" %} Políticas"{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, y luego en la pestaña de **Ejecutores** {% endif %}. + 2. En la barra lateral izquierda, da clic en **Resumen empresarial**. + 3. In the enterprise sidebar, click {% octicon "law" aria-label="The law icon" %} **Policies**.{% endif %} +2. Navega a los ajustes de {% data variables.product.prodname_actions %}: + * **In an organization or repository**: Click **Actions** in the left sidebar{% ifversion fpt or ghes > 3.1 or ghae-next or ghec %}, then click **Runners**{% endif %}.{% ifversion ghec or ghae or ghes %} + * {% ifversion ghec %}**If using an enterprise account**:{% elsif ghes or ghae %}**If using an enterprise-level runner**:{% endif %} Click **Actions** under "{% octicon "law" aria-label="The law icon" %} Policies"{% ifversion ghes > 3.1 or ghae-next or ghec %}, then click the **Runners** tab{% endif %}.{% endif %} +{% endif %} diff --git a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-reusing.md b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-reusing.md index 4287f97980ff..cc3b662ebc6b 100644 --- a/translations/es-ES/data/reusables/github-actions/self-hosted-runner-reusing.md +++ b/translations/es-ES/data/reusables/github-actions/self-hosted-runner-reusing.md @@ -1 +1 @@ -Como alternativa, si no tienes acceso al repositorio, organización o empresa en {% data variables.product.product_name %} para eliminar un ejecutor, pero te gustaría reutilizar la máquina del ejecutor, entonces puedes borrar el archivo `.runner` dentro del directorio de la aplicación del ejecutor auto-hospedado. Esto permite que el ejecutor se registre sin tener que volver a descargar la aplicación del ejecutor auto-hospedado. +Alternatively, if you don't have access to the repository{% ifversion fpt %} or organization{% elsif ghes or ghec or ghae %}, organization, or enterprise{% endif %} on {% data variables.product.product_name %} to remove a runner, but you would like to re-use the runner machine, then you can delete the `.runner` file inside the self-hosted runner application directory. Esto permite que el ejecutor se registre sin tener que volver a descargar la aplicación del ejecutor auto-hospedado. diff --git a/translations/es-ES/data/ui.yml b/translations/es-ES/data/ui.yml index 6b803d1beb7c..e33e7fe7f23d 100644 --- a/translations/es-ES/data/ui.yml +++ b/translations/es-ES/data/ui.yml @@ -150,7 +150,7 @@ product_landing: upgrade_from: Mejorar desde browse_all_docs: Buscar todos los documentos explore_release_notes: Explorar las notas de lanzamiento -product_sublanding: +product_guides: start: Inicio start_path: Ruta de inicio learning_paths: 'Rutas de aprendizaje de {{ productMap[currentProduct].name }}' diff --git a/translations/log/es-resets.csv b/translations/log/es-resets.csv index 35f1b35a755e..2ad792c2fedd 100644 --- a/translations/log/es-resets.csv +++ b/translations/log/es-resets.csv @@ -314,6 +314,7 @@ translations/es-ES/content/code-security/secret-scanning/about-secret-scanning.m translations/es-ES/content/code-security/secret-scanning/about-secret-scanning.md,rendering error translations/es-ES/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md,Listed in localization-support#489 translations/es-ES/content/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning.md,rendering error +translations/es-ES/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md,rendering error translations/es-ES/content/code-security/security-overview/about-the-security-overview.md,rendering error translations/es-ES/content/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates.md,Listed in localization-support#489 translations/es-ES/content/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates.md,rendering error @@ -390,6 +391,7 @@ translations/es-ES/content/codespaces/developing-in-codespaces/using-codespaces- translations/es-ES/content/codespaces/developing-in-codespaces/using-source-control-in-your-codespace.md,rendering error translations/es-ES/content/codespaces/getting-started/deep-dive.md,Listed in localization-support#489 translations/es-ES/content/codespaces/getting-started/deep-dive.md,rendering error +translations/es-ES/content/codespaces/guides.md,rendering error translations/es-ES/content/codespaces/index.md,Listed in localization-support#489 translations/es-ES/content/codespaces/index.md,rendering error translations/es-ES/content/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization.md,rendering error @@ -438,6 +440,7 @@ translations/es-ES/content/developers/github-marketplace/creating-apps-for-githu translations/es-ES/content/developers/overview/managing-deploy-keys.md,rendering error translations/es-ES/content/developers/webhooks-and-events/events/issue-event-types.md,Listed in localization-support#489 translations/es-ES/content/developers/webhooks-and-events/events/issue-event-types.md,rendering error +translations/es-ES/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md,rendering error translations/es-ES/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md,rendering error translations/es-ES/content/discussions/guides/best-practices-for-community-conversations-on-github.md,Listed in localization-support#489 translations/es-ES/content/discussions/guides/best-practices-for-community-conversations-on-github.md,rendering error @@ -533,6 +536,7 @@ translations/es-ES/content/graphql/overview/breaking-changes.md,Listed in locali translations/es-ES/content/graphql/overview/breaking-changes.md,rendering error translations/es-ES/content/index.md,Listed in localization-support#489 translations/es-ES/content/index.md,rendering error +translations/es-ES/content/issues/guides.md,rendering error translations/es-ES/content/issues/tracking-your-work-with-issues/about-task-lists.md,Listed in localization-support#489 translations/es-ES/content/issues/tracking-your-work-with-issues/about-task-lists.md,rendering error translations/es-ES/content/issues/tracking-your-work-with-issues/creating-an-issue.md,Listed in localization-support#489 @@ -891,6 +895,7 @@ translations/es-ES/content/search-github/searching-on-github/searching-in-forks. translations/es-ES/content/search-github/searching-on-github/searching-issues-and-pull-requests.md,Listed in localization-support#489 translations/es-ES/content/search-github/searching-on-github/searching-issues-and-pull-requests.md,rendering error translations/es-ES/content/sponsors/getting-started-with-github-sponsors/about-github-sponsors.md,rendering error +translations/es-ES/content/sponsors/guides.md,rendering error translations/es-ES/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-organization.md,rendering error translations/es-ES/content/sponsors/receiving-sponsorships-through-github-sponsors/setting-up-github-sponsors-for-your-user-account.md,rendering error translations/es-ES/content/sponsors/receiving-sponsorships-through-github-sponsors/viewing-your-sponsors-and-sponsorships.md,rendering error