New translation batch for es (#33133)
This commit is contained in:
docubot
@@ -16,6 +16,26 @@ type: tutorial
|
||||
|
||||
{% data reusables.actions.about-runner-groups %} {% ifversion fpt %}For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/using-github-hosted-runners/controlling-access-to-larger-runners).{% endif %}
|
||||
|
||||
### Default group for {% data variables.actions.hosted_runner %}s
|
||||
|
||||
Organizations and enterprises with access to {% data variables.actions.hosted_runner %}s will automatically receive a default runner group called "Default Larger Runners" that includes 4 runners of varying sizes. The runners in this group are pre-configured and ready for immediate use. In order to use the runners in this group, you will need to add the label corresponding to the runner of your choice to your workflow file. See the table below for labels. For more information on how to use labels, see "[Running jobs on your runner](/actions/using-github-hosted-runners/using-larger-runners#running-jobs-on-your-runner)."
|
||||
|
||||
|
||||
#### Default Runners
|
||||
|
||||
|Description | Label | Image |
|
||||
| ------- | ------- | ------ |
|
||||
| 4-cores Ubuntu Runner | `ubuntu-latest-4-cores` | Ubuntu - Latest |
|
||||
| 8-cores Ubuntu Runner | `ubuntu-latest-8-cores` | Ubuntu - Latest |
|
||||
| 16-cores Ubuntu Runner | `ubuntu-latest-16-cores` | Ubuntu - Latest |
|
||||
| 8-cores Windows Runner | `windows-latest-8-cores` | Windows Server - Latest |
|
||||
|
||||
The default {% data variables.actions.hosted_runner %} group is created at the billing entity level. If your organization is part of an enterprise account, the group will be managed on the enterprise level. If your organization does not fall under an enterprise, the group is managed on the organization level.
|
||||
|
||||
You will not be billed for these runners until you use them in your workflows. Once these runners are used, billing works as it normally does. For more information on billing, see "[Using {% data variables.actions.hosted_runner %}s](/actions/using-github-hosted-runners/using-larger-runners#understanding-billing)."
|
||||
|
||||
The default access for a {% data variables.actions.hosted_runner %} group at the enterprise level is set to automatically share with all organizations in the enterprise, but not all repositories. Organization admins will need to share the default {% data variables.actions.hosted_runner %} group with each repository separately. For {% data variables.actions.hosted_runner %} groups at the organization level, the default access is set to automatically share the group with all repositories. For more information on how to change access policies, and where to view the default {% data variables.actions.hosted_runner %} group, see "[Changing the access policy of a runner group](#changing-the-access-policy-of-a-runner-group)."
|
||||
|
||||
{% ifversion ghec or ghes or ghae %}
|
||||
|
||||
## Creating a runner group for an organization
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: Configuring SAML single sign-on for your enterprise
|
||||
title: Configurar el inicio de sesión único de SAML para tu empresa
|
||||
shortTitle: Configure SAML SSO
|
||||
intro: 'You can control and secure access to {% ifversion ghec %}resources like repositories, issues, and pull requests within your enterprise''s organizations{% elsif ghes %}{% data variables.location.product_location %}{% elsif ghae %}your enterprise on {% data variables.product.prodname_ghe_managed %}{% endif %} by {% ifversion ghec %}enforcing{% elsif ghes or ghae %}configuring{% endif %} SAML single sign-on (SSO) through your identity provider (IdP).'
|
||||
intro: 'Puedes controlar y proteger el acceso a recursos {% ifversion ghec %}como repositorios, problemas y solicitudes de incorporación de cambios dentro de las organizaciones de tu empresa{% elsif ghes %}{% data variables.location.product_location %}{% elsif ghae %}tu empresa en {% data variables.product.prodname_ghe_managed %}{% endif %} por {% ifversion ghec %}que exige{% elsif ghes or ghae %}la configuración de{% endif %} inicio de sesión único de SAML mediante el proveedor de identidades (IdP).'
|
||||
permissions: '{% ifversion ghes %}Site administrators{% elsif ghec or ghae %}Enterprise owners{% endif %} can configure SAML SSO for {% ifversion ghec or ghae %}an enterprise on {% data variables.product.product_name %}{% elsif ghes %}a {% data variables.product.product_name %} instance{% endif %}.'
|
||||
versions:
|
||||
ghec: '*'
|
||||
@@ -21,11 +21,16 @@ redirect_from:
|
||||
- /github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/enforcing-saml-single-sign-on-for-organizations-in-your-enterprise-account
|
||||
- /admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise
|
||||
- /admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise
|
||||
ms.openlocfilehash: 804ba3b262aae15b862e1a14694b82339c8d34a4
|
||||
ms.sourcegitcommit: 7a74d5796695bb21c30e4031679253cbc16ceaea
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/28/2022
|
||||
ms.locfileid: '148183960'
|
||||
---
|
||||
|
||||
{% data reusables.enterprise-accounts.emu-saml-note %}
|
||||
|
||||
## About SAML SSO
|
||||
## Acerca de SAML SSO
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
@@ -33,11 +38,11 @@ redirect_from:
|
||||
|
||||
{% data reusables.saml.saml-accounts %}
|
||||
|
||||
For more information, see "[About identity and access management with SAML single sign-on](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)."
|
||||
Para más información, vea "[Acerca de la administración de identidades y acceso con el inicio de sesión único de SAML](/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)".
|
||||
|
||||
{% data reusables.saml.about-saml-enterprise-accounts %}
|
||||
|
||||
{% data reusables.saml.about-saml-access-enterprise-account %} For more information, see "[Viewing and managing a user's SAML access to your enterprise account](/admin/user-management/managing-users-in-your-enterprise/viewing-and-managing-a-users-saml-access-to-your-enterprise)."
|
||||
{% data reusables.saml.about-saml-access-enterprise-account %} Para obtener más información, consulte "[Visualizar y administrar el acceso de SAML de un usuario a su cuenta empresarial](/admin/user-management/managing-users-in-your-enterprise/viewing-and-managing-a-users-saml-access-to-your-enterprise)".
|
||||
|
||||
{% data reusables.saml.saml-disabled-linked-identities-removed %}
|
||||
|
||||
@@ -45,9 +50,9 @@ For more information, see "[About identity and access management with SAML singl
|
||||
|
||||
{% elsif ghes or ghae %}
|
||||
|
||||
SAML SSO allows you to centrally control and secure access to {% data variables.location.product_location %} from your SAML IdP. When an unauthenticated user visits {% data variables.location.product_location %} in a browser, {% data variables.product.product_name %} will redirect the user to your SAML IdP to authenticate. After the user successfully authenticates with an account on the IdP, the IdP redirects the user back to {% data variables.location.product_location %}. {% data variables.product.product_name %} validates the response from your IdP, then grants access to the user.
|
||||
El SSO de SAML te permite controlar centralmente {% data variables.location.product_location %} y proteger el acceso desde tu IdP de SAML. Cuando un usuario no autenticado visita {% data variables.location.product_location %} en un explorador, {% data variables.product.product_name %} lo redirigirá a tu IdP de SAML para autenticarse. Después de que el usuario se autentica correctamente con una cuenta en el IdP, este lo redirige de regreso a {% data variables.location.product_location %}. {% data variables.product.product_name %} valida la respuesta de tu IdP y luego le otorga acceso al usuario.
|
||||
|
||||
After a user successfully authenticates on your IdP, the user's SAML session for {% data variables.location.product_location %} is active in the browser for 24 hours. After 24 hours, the user must authenticate again with your IdP.
|
||||
Después de autenticarse correctamente en tu IdP, la sesión de SAML del usuario para {% data variables.location.product_location %} se encuentra activa en el explorador durante 24 horas. Después de 24 horas, el usuario debe autenticarse nuevamente con tu IdP.
|
||||
|
||||
{% data reusables.saml.saml-ghes-account-revocation %}
|
||||
|
||||
@@ -55,171 +60,161 @@ After a user successfully authenticates on your IdP, the user's SAML session for
|
||||
|
||||
{% data reusables.saml.assert-the-administrator-attribute %}
|
||||
|
||||
{% data reusables.scim.after-you-configure-saml %} For more information, see "[Configuring user provisioning for your enterprise](/admin/authentication/configuring-user-provisioning-for-your-enterprise)."
|
||||
{% data reusables.scim.after-you-configure-saml %} Para obtener más información, consulte "[Configuración del aprovisionamiento de usuarios para la empresa](/admin/authentication/configuring-user-provisioning-for-your-enterprise)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Supported identity providers
|
||||
## Proveedores de identidad compatibles
|
||||
|
||||
{% data reusables.saml.saml-supported-idps %}
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
## Username considerations with SAML
|
||||
## Consideraciones sobre el nombre de usuario con SAML
|
||||
|
||||
{% ifversion ghec %}If you use {% data variables.product.prodname_emus %}, {% endif %}{% data reusables.enterprise_user_management.consider-usernames-for-external-authentication %} For more information, see "[Username considerations for external authentication](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)."
|
||||
{% ifversion ghec %}Si usas {% data variables.product.prodname_emus %}, {% endif %}{% data reusables.enterprise_user_management.consider-usernames-for-external-authentication %} Para obtener más información, consulta "[Consideraciones sobre el nombre de usuario para la autenticación externa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)".
|
||||
|
||||
## Enforcing SAML single-sign on for organizations in your enterprise account
|
||||
## Requerir el inicio de sesión único de SAML para las organizaciones en tu cuenta empresarial
|
||||
|
||||
When you enforce SAML SSO for your enterprise, the enterprise configuration will override any existing organization-level SAML configurations. {% data reusables.saml.switching-from-org-to-enterprise %} For more information, see "[Switching your SAML configuration from an organization to an enterprise account](/github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account)."
|
||||
Cuando requieres el SSO de SAML para tu empresa, la configuración empresarial se superpondrá a cualquier configuración de SAML que exista a nivel organizacional. {% data reusables.saml.switching-from-org-to-enterprise %} Para obtener más información, consulte "[Cambio de la configuración de SAML de una organización a una cuenta de empresa](/github/setting-up-and-managing-your-enterprise/configuring-identity-and-access-management-for-your-enterprise-account/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account)".
|
||||
|
||||
When you enforce SAML SSO for an organization, {% data variables.product.company_short %} removes any members of the organization that have not authenticated successfully with your SAML IdP. When you require SAML SSO for your enterprise, {% data variables.product.company_short %} does not remove members of the enterprise that have not authenticated successfully with your SAML IdP. The next time a member accesses the enterprise's resources, the member must authenticate with your SAML IdP.
|
||||
Cuando requieres el SSO de SAML para una organización, {% data variables.product.company_short %} elimina cualquier miembro de la organización que no se haya autenticado con éxito en tu IdP de SAML. Cuando requieres el SSO de SAML para tu empresa, {% data variables.product.company_short %} no elimina a los miembros de dicha empresa que no se hayan autenticado exitosamente con tu IdP de SAML. La siguiente vez que un miembro acceda a los recursos empresariales, este deberá autenticarse con tu IdP de SAML.
|
||||
|
||||
For more detailed information about how to enable SAML using Okta, see "[Configuring SAML single sign-on for your enterprise account using Okta](/admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise-using-okta)."
|
||||
Para obtener información más detallada sobre cómo habilitar SAML mediante Okta, consulte "[Configurar el inicio de sesión rápido de SAML para tu cuenta empresarial utilizando Okta](/admin/authentication/managing-identity-and-access-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise-using-okta)".
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
{% data reusables.enterprise-accounts.security-tab %}
|
||||
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %}
|
||||
4. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %}
|
||||
5. Under "SAML single sign-on", select **Require SAML authentication**.
|
||||
|
||||
6. In the **Sign on URL** field, type the HTTPS endpoint of your IdP for single sign-on requests. This value is available in your IdP configuration.
|
||||
|
||||
7. Optionally, in the **Issuer** field, type your SAML issuer URL to verify the authenticity of sent messages.
|
||||
|
||||
8. Under **Public Certificate**, paste a certificate to verify SAML responses.
|
||||
|
||||
9. To verify the integrity of the requests from your SAML issuer, click {% octicon "pencil" aria-label="The edit icon" %}. Then in the "Signature Method" and "Digest Method" drop-downs, choose the hashing algorithm used by your SAML issuer.
|
||||
|
||||
10. Before enabling SAML SSO for your enterprise, click **Test SAML configuration** to ensure that the information you've entered is correct. 
|
||||
11. Click **Save**.
|
||||
5. En "SAML single sign-on", seleccione **Require SAML authentication**.
|
||||
|
||||
6. En el campo **Sign on URL**, escriba el punto de conexión HTTPS de su proveedor de identidades para las solicitudes de inicio de sesión único. Este valor se encuentra en la configuración de tu IdP.
|
||||
|
||||
7. Opcionalmente, en el campo **Issuer**, escriba la dirección URL del emisor de SAML para comprobar la autenticidad de los mensajes enviados.
|
||||
|
||||
8. En **Public Certificate**, copie un certificado para verificar las respuestas SAML.
|
||||
|
||||
9. Para comprobar la integridad de las solicitudes del emisor de SAML, haga clic en {% octicon "pencil" aria-label="The edit icon" %}. Posteriormente, en los menús desplegables de "Método de firma" y "Método de resumen", elige el algoritmo de hash que utiliza tu emisor de SAML.
|
||||
|
||||
10. Antes de habilitar el SSO de SAML para la empresa, haga clic en **Test SAML configuration** para asegurarse de que la información que ha escrito sea correcta. 
|
||||
11. Haga clic en **Save**(Guardar).
|
||||
{% data reusables.enterprise-accounts.download-recovery-codes %}
|
||||
|
||||
{% elsif ghes %}
|
||||
|
||||
## Configuring SAML SSO
|
||||
## Configurar el SSO de SAML
|
||||
|
||||
You can enable or disable SAML authentication for {% data variables.location.product_location %}, or you can edit an existing configuration. You can view and edit authentication settings for {% data variables.product.product_name %} in the management console. For more information, see "[Accessing the management console](/admin/configuration/configuring-your-enterprise/accessing-the-management-console)."
|
||||
Puedes habilitar o inhabilitar la autenticación de SAML para {% data variables.location.product_location %} o puedes editar una configuración existente. Puedes ver y editar la configuración de autenticación para {% data variables.product.product_name %} en la consola de administración. Para más información, vea "[Acceso a la consola de administración](/admin/configuration/configuring-your-enterprise/accessing-the-management-console)".
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note**: {% data reusables.enterprise.test-in-staging %}
|
||||
**Nota**: {% data reusables.enterprise.test-in-staging %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %}
|
||||
{% data reusables.enterprise_site_admin_settings.management-console %}
|
||||
{% data reusables.enterprise_management_console.authentication %}
|
||||
1. Select **SAML**.
|
||||
{% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.authentication %}
|
||||
1. Seleccione **SAML**.
|
||||
|
||||
|
||||
|
||||
1. {% data reusables.enterprise_user_management.built-in-authentication-option %}
|
||||
|
||||
|
||||
1. Optionally, to enable unsolicited response SSO, select **IdP initiated SSO**. By default, {% data variables.product.prodname_ghe_server %} will reply to an unsolicited Identity Provider (IdP) initiated request with an `AuthnRequest` back to the IdP.
|
||||
|
||||
1. Opcionalmente, para habilitar el inicio de sesión único de respuesta no solicitado, seleccione **IdP initiated SSO** (SSO iniciado de IdP). De manera predeterminada, {% data variables.product.prodname_ghe_server %} responderá a una solicitud iniciada por un proveedor de identidad (IdP) no solicitada con un elemento `AuthnRequest` de vuelta al IdP.
|
||||
|
||||
|
||||
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Note**: We recommend keeping this value **unselected**. You should enable this feature **only** in the rare instance that your SAML implementation does not support service provider initiated SSO, and when advised by {% data variables.contact.enterprise_support %}.
|
||||
**Nota**: Se recomienda mantener este valor **sin seleccionar**. Debe activar esta característica **solo** en el caso inusual que su implementación SAML no admita el SSO iniciado del proveedor de servicios y que {% data variables.contact.enterprise_support %} lo aconseje.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
1. Select **Disable administrator demotion/promotion** if you **do not** want your SAML provider to determine administrator rights for users on {% data variables.location.product_location %}.
|
||||
1. Selecciona **Deshabilitar degradación o promoción de administrador** si **no** quieres que el proveedor de SAML determine los derechos de administrador para los usuarios en {% data variables.location.product_location %}.
|
||||
|
||||
|
||||
{%- ifversion ghes > 3.3 %}
|
||||
1. Optionally, to allow {% data variables.location.product_location %} to receive encrypted assertions from your SAML IdP, select **Require encrypted assertions**. You must ensure that your IdP supports encrypted assertions and that the encryption and key transport methods in the management console match the values configured on your IdP. You must also provide {% data variables.location.product_location %}'s public certificate to your IdP. For more information, see "[Enabling encrypted assertions](/admin/identity-and-access-management/using-saml-for-enterprise-iam/enabling-encrypted-assertions)."
|
||||
 {%- ifversion ghes > 3.3 %}
|
||||
1. Opcionalmente, para permitir que {% data variables.location.product_location %} reciba aserciones cifradas desde el IdP de SAML, selecciona **Requerir aserciones cifradas**. Debes asegurarte de que tu IdP sea compatible con las aserciones cifradas y que los métodos de transporte de llaves y de cifrado en la consola de administración empaten con los valores configurados en tu IdP. También debes proporcionar un certificado público de {% data variables.location.product_location %} a tu IdP. Para obtener más información, vea "[Habilitar aserciones cifradas](/admin/identity-and-access-management/using-saml-for-enterprise-iam/enabling-encrypted-assertions)".
|
||||
|
||||
|
||||
{%- endif %}
|
||||
1. In the **Single sign-on URL** field, type the HTTP or HTTPS endpoint on your IdP for single sign-on requests. This value is provided by your IdP configuration. If the host is only available from your internal network, you may need to [configure {% data variables.location.product_location %} to use internal nameservers](/enterprise/admin/guides/installation/configuring-dns-nameservers/).
|
||||
 {%- endif %}
|
||||
1. En el campo **Single sign-on URL** (URL de inicio de sesión único), escribe el punto de conexión HTTP o HTTPS del IdP para las solicitudes de inicio de sesión único. Este valor lo provee la configuración de tu IdP. Si el host solo está disponible desde la red interna, es posible que tengas que [configurar {% data variables.location.product_location %} para usar servidores de nombres internos](/enterprise/admin/guides/installation/configuring-dns-nameservers/).
|
||||
|
||||
|
||||
1. Optionally, in the **Issuer** field, type your SAML issuer's name. This verifies the authenticity of messages sent to {% data variables.location.product_location %}.
|
||||
|
||||
1. También puede escribir su nombre de emisor SAML en el campo **Issuer** (Emisor). Esto verifica la autenticidad de los mensajes que se envían a {% data variables.location.product_location %}.
|
||||
|
||||
|
||||
1. In the **Signature Method** and **Digest Method** drop-down menus, choose the hashing algorithm used by your SAML issuer to verify the integrity of the requests from {% data variables.location.product_location %}. Specify the format with the **Name Identifier Format** drop-down menu.
|
||||
|
||||
1. En los menús desplegables **Método de firma** y **Método de resumen**, elige el algoritmo hash que usa el emisor de SAML para comprobar la integridad de las solicitudes de {% data variables.location.product_location %}. Especifique el formato con el menú desplegable **Name Identifier Format** (Formato de identificador de nombre).
|
||||
|
||||
|
||||
1. Under **Verification certificate**, click **Choose File** and choose a certificate to validate SAML responses from the IdP.
|
||||
|
||||
1. En **Verification certificate** (Certificado de verificación), haga clic en **Choose file** (Elegir archivo) y elija un certificado para validar las respuestas SAML desde el IdP.
|
||||
|
||||
|
||||
1. Modify the SAML attribute names to match your IdP if needed, or accept the default names.
|
||||
|
||||
1. Modifica los nombres de atributo de SAML para hacerlos coincidir con tu IdP, si es necesario, o acepta los nombres predeterminados.
|
||||
|
||||
|
||||
|
||||
|
||||
{% elsif ghae %}
|
||||
|
||||
## Enabling SAML SSO
|
||||
## Habilitar el SSO de SAML
|
||||
|
||||
{% data reusables.saml.ae-enable-saml-sso-during-bootstrapping %}
|
||||
|
||||
The following IdPs provide documentation about configuring SAML SSO for {% data variables.product.product_name %}. If your IdP isn't listed, please contact your IdP to request support for {% data variables.product.product_name %}.
|
||||
Los siguientes IdP proporcionan documentación sobre cómo configurar el SSO de SAML para {% data variables.product.product_name %}. Si no se lista tu IdP, por favor, contáctalo para solicitar soporte para {% data variables.product.product_name %}.
|
||||
|
||||
| IdP | More information |
|
||||
| IdP | Más información |
|
||||
| :- | :- |
|
||||
| Azure AD | "[Configuring authentication and provisioning for your enterprise using Azure AD](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad)" |
|
||||
| Okta | "[Configuring authentication and provisioning for your enterprise using Okta](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-okta)" |
|
||||
| Azure AD | "[Configuración de la autenticación y el aprovisionamiento de la empresa mediante Azure AD](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-azure-ad)" |
|
||||
| Okta | "[Configuración de la autenticación y el aprovisionamiento de la empresa mediante Okta](/admin/authentication/configuring-authentication-and-provisioning-with-your-identity-provider/configuring-authentication-and-provisioning-for-your-enterprise-using-okta)" |
|
||||
|
||||
During initialization for {% data variables.product.product_name %}, you must configure {% data variables.product.product_name %} as a SAML service provider (SP) on your IdP. You must enter several unique values on your IdP to configure {% data variables.product.product_name %} as a valid SP. For more information, see "[SAML configuration reference](/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference#saml-metadata)."
|
||||
Durante la inicialización de {% data variables.product.product_name %}, debes configurar {% data variables.product.product_name %} como un proveedor de servicios (SP) de SAML en tu IdP. Debes ingresar varios valores únicos en tu IdP para configurar {% data variables.product.product_name %} como un SP válido. Para obtener más información, consulta "[Referencia de configuración de SAML](/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference#saml-metadata)".
|
||||
|
||||
## Editing the SAML SSO configuration
|
||||
## Editar la configuración del SSO de SAML
|
||||
|
||||
If the details for your IdP change, you'll need to edit the SAML SSO configuration for {% data variables.location.product_location %}. For example, if the certificate for your IdP expires, you can edit the value for the public certificate.
|
||||
Si los detalles de tu IdP cambian, tendrás que editar la configuración de SSO de SAML para {% data variables.location.product_location %}. Por ejemplo, si el certificado de tu IdP expira, puedes editar el valor del certificado público.
|
||||
|
||||
{% ifversion ghae %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note**: {% data reusables.saml.contact-support-if-your-idp-is-unavailable %}
|
||||
**Nota**: {% data reusables.saml.contact-support-if-your-idp-is-unavailable %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
{% data reusables.enterprise-accounts.security-tab %}
|
||||
1. Under "SAML single sign-on", type the new details for your IdP.
|
||||
|
||||
1. Optionally, click {% octicon "pencil" aria-label="The edit icon" %} to configure a new signature or digest method.
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %}
|
||||
1. Debajo de "Inicio de sesión único de SAML", teclea los detalles nuevos de tu IdP.
|
||||
|
||||
1. Opcionalmente, da clic en {% octicon "pencil" aria-label="The edit icon" %} para configurar una firma nueva o método de resumen.
|
||||
|
||||
|
||||
- Use the drop-down menus and choose the new signature or digest method.
|
||||
|
||||
1. To ensure that the information you've entered is correct, click **Test SAML configuration**.
|
||||
|
||||
1. Click **Save**.
|
||||
|
||||
1. Optionally, to automatically provision and deprovision user accounts for {% data variables.location.product_location %}, reconfigure user provisioning with SCIM. For more information, see "[Configuring user provisioning for your enterprise](/admin/authentication/configuring-user-provisioning-for-your-enterprise)."
|
||||
- Utiliza los menús desplegables y elige la nueva firma o método de resumen.
|
||||
|
||||
1. Para asegurarse de que la información especificada es correcta, haga clic en **Test SAML configuration**.
|
||||
|
||||
1. Haga clic en **Save**(Guardar).
|
||||
|
||||
1. Opcionalmente, para aprovisionar y desaprovisionar automáticamente las cuentas de usuario para {% data variables.location.product_location %}, vuelve a configurar el aprovisionamiento de usuarios con SCIM. Para obtener más información, consulte "[Configuración del aprovisionamiento de usuarios para la empresa](/admin/authentication/configuring-user-provisioning-for-your-enterprise)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% ifversion ghae %}
|
||||
|
||||
## Disabling SAML SSO
|
||||
## Inhabilitar el SSO de SAML
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Warning**: If you disable SAML SSO for {% data variables.location.product_location %}, users without existing SAML SSO sessions cannot sign into {% data variables.location.product_location %}. SAML SSO sessions on {% data variables.location.product_location %} end after 24 hours.
|
||||
**Advertencia**: Si deshabilitas el SSO de SAML para {% data variables.location.product_location %}, los usuarios sin sesiones existentes de inicio de sesión único de SAML no podrán iniciar sesión en {% data variables.location.product_location %}. Las sesiones del SSO de SAML en {% data variables.location.product_location %} finalizan después de 24 horas.
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note**: {% data reusables.saml.contact-support-if-your-idp-is-unavailable %}
|
||||
**Nota**: {% data reusables.saml.contact-support-if-your-idp-is-unavailable %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %}
|
||||
{% data reusables.enterprise-accounts.settings-tab %}
|
||||
{% data reusables.enterprise-accounts.security-tab %}
|
||||
1. Under "SAML single sign-on", unselect **Enable SAML authentication**.
|
||||
|
||||
1. To disable SAML SSO and require signing in with the built-in user account you created during initialization, click **Save**.
|
||||
|
||||
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.security-tab %}
|
||||
1. En "SAML single sign-on", seleccione **Enable SAML authentication**.
|
||||
|
||||
1. Para deshabilitar el SSO de SAML y requerir el inicio de sesión con la cuenta de usuario integrada que creó durante la inicialización, haga clic en **Save**.
|
||||
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -227,13 +222,10 @@ If the details for your IdP change, you'll need to edit the SAML SSO configurati
|
||||
|
||||
{% ifversion ghec or ghes %}
|
||||
|
||||
## Further reading
|
||||
## Información adicional
|
||||
|
||||
{%- ifversion ghec %}
|
||||
- "[Managing SAML single sign-on for your organization](/organizations/managing-saml-single-sign-on-for-your-organization)"
|
||||
{%- endif %}
|
||||
{%- ifversion ghes %}
|
||||
- "[Promoting or demoting a site administrator](/admin/user-management/managing-users-in-your-enterprise/promoting-or-demoting-a-site-administrator)"
|
||||
{%- endif %}
|
||||
- "[Administración del inicio de sesión único de SAML para la organización](/organizations/managing-saml-single-sign-on-for-your-organization)" {%- endif %} {%- ifversion ghes %}
|
||||
- "[Promoción o degradación de un administrador de sitio](/admin/user-management/managing-users-in-your-enterprise/promoting-or-demoting-a-site-administrator)" {%- endif %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Authorizing OAuth Apps
|
||||
intro: 'You can connect your {% data variables.product.product_name %} identity to third-party applications using OAuth. When authorizing an {% data variables.product.prodname_oauth_app %}, you should ensure you trust the application, review who it''s developed by, and review the kinds of information the application wants to access.'
|
||||
title: Autorización de aplicaciones de OAuth
|
||||
intro: 'Puedes conectar tu identidad {% data variables.product.product_name %} con aplicaciones de terceros mediante OAuth. Al autorizar un {% data variables.product.prodname_oauth_app %}, deberías asegurarte de que confías en la aplicación, revisar quién la desarrolló y revisar los tipos de información a la que desea acceder la aplicación.'
|
||||
redirect_from:
|
||||
- /articles/authorizing-oauth-apps
|
||||
- /github/authenticating-to-github/authorizing-oauth-apps
|
||||
@@ -13,89 +13,95 @@ versions:
|
||||
topics:
|
||||
- Identity
|
||||
- Access management
|
||||
ms.openlocfilehash: 7d116f8fc5117cdcbdbd5582e007351c47b2d55d
|
||||
ms.sourcegitcommit: 7a74d5796695bb21c30e4031679253cbc16ceaea
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/28/2022
|
||||
ms.locfileid: '148184024'
|
||||
---
|
||||
When an {% data variables.product.prodname_oauth_app %} wants to identify you by your account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, you'll see a page with the app's developer contact information and a list of the specific data that's being requested.
|
||||
Cuando un {% data variables.product.prodname_oauth_app %} quiere identificarte mediante tu cuenta de {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.location.product_location %}{% endif %}, verás una página con la información de contacto del desarrollador de la aplicación y una lista de los datos específicos que se están solicitando.
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tip:** You must [verify your email address](/articles/verifying-your-email-address) before you can authorize an {% data variables.product.prodname_oauth_app %}.
|
||||
**Sugerencia:** Debe [comprobar su dirección de correo electrónico](/articles/verifying-your-email-address) para poder autorizar una {% data variables.product.prodname_oauth_app %}.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
## {% data variables.product.prodname_oauth_app %} access
|
||||
## Acceso a {% data variables.product.prodname_oauth_app %}
|
||||
|
||||
{% data variables.product.prodname_oauth_apps %} can have *read* or *write* access to your {% data variables.product.product_name %} data.
|
||||
{% data variables.product.prodname_oauth_apps %} pueden tener acceso de *lectura* o *escritura* a sus datos de {% data variables.product.product_name %}.
|
||||
|
||||
- **Read access** only allows an app to *look at* your data.
|
||||
- **Write access** allows an app to *change* your data.
|
||||
- **El acceso de lectura** solo permite que una aplicación *examine los* datos.
|
||||
- **El acceso de escritura** permite a una aplicación *cambiar* los datos.
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Tip:** {% data reusables.user-settings.review_oauth_tokens_tip %}
|
||||
**Sugerencia:** {% data reusables.user-settings.review_oauth_tokens_tip %}
|
||||
|
||||
{% endtip %}
|
||||
|
||||
### About OAuth scopes
|
||||
### Acerca de los alcances de OAuth
|
||||
|
||||
*Scopes* are named groups of permissions that an {% data variables.product.prodname_oauth_app %} can request to access both public and non-public data.
|
||||
Los *alcances* son grupos de permisos específicos que puede solicitar una {% data variables.product.prodname_oauth_app %} para acceder a datos públicos y no públicos.
|
||||
|
||||
When you want to use an {% data variables.product.prodname_oauth_app %} that integrates with {% data variables.product.product_name %}, that app lets you know what type of access to your data will be required. If you grant access to the app, then the app will be able to perform actions on your behalf, such as reading or modifying data. For example, if you want to use an app that requests `user:email` scope, the app will have read-only access to your private email addresses. For more information, see "[About scopes for {% data variables.product.prodname_oauth_apps %}](/apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)."
|
||||
Cuando quieres usar una {% data variables.product.prodname_oauth_app %} que se integra con {% data variables.product.product_name %}, la app te permite conocer qué tipo de acceso a tus datos serán necesarios. Si otorgas acceso a la app, la app podrá realizar acciones en tu nombre, como leer o modificar datos. Por ejemplo, si quiere usar una aplicación que solicita el ámbito `user:email`, la aplicación tendrá acceso de solo lectura a las direcciones de correo electrónico privadas. Para obtener más información, consulte "[Acerca de los alcances de {% data variables.product.prodname_oauth_apps %}](/apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)".
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Note:** Currently, you can't scope source code access to read-only.
|
||||
**Nota:** Actualmente, no se puede definir el alcance del acceso al código fuente como de solo lectura.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
{% data reusables.apps.oauth-token-limit %}
|
||||
|
||||
### Types of requested data
|
||||
### Tipos de datos solicitados
|
||||
|
||||
{% data variables.product.prodname_oauth_apps %} can request several types of data.
|
||||
Las {% data variables.product.prodname_oauth_apps %} pueden solicitar diferentes tipos de datos.
|
||||
|
||||
| Type of data | Description |
|
||||
| Tipo de datos | Descripción |
|
||||
| --- | --- |
|
||||
| Commit status | You can grant access for an app to report your commit status. Commit status access allows apps to determine if a build is a successful against a specific commit. Apps won't have access to your code, but they can read and write status information against a specific commit. |
|
||||
| Deployments | Deployment status access allows apps to determine if a deployment is successful against a specific commit for public and private repositories. Apps won't have access to your code. |
|
||||
| Gists | [Gist](https://gist.github.com) access allows apps to read or write to both your public and secret Gists. |
|
||||
| Hooks | [Webhooks](/webhooks) access allows apps to read or write hook configurations on repositories you manage. |
|
||||
| Notifications | Notification access allows apps to read your {% data variables.product.product_name %} notifications, such as comments on issues and pull requests. However, apps remain unable to access anything in your repositories. |
|
||||
| Organizations and teams | Organization and teams access allows apps to access and manage organization and team membership. |
|
||||
| Personal user data | User data includes information found in your user profile, like your name, e-mail address, and location. |
|
||||
| Repositories | Repository information includes the names of contributors, the branches you've created, and the actual files within your repository. Apps can request access for either public or private repositories on a user-wide level. |
|
||||
| Repository delete | Apps can request to delete repositories that you administer, but they won't have access to your code. |{% ifversion projects-oauth-scope %}
|
||||
| Projects | Access to user and organization {% data variables.projects.projects_v2 %}. Apps can request either read/write or read only access. |{% endif %}
|
||||
| Estado de confirmación | Puedes otorgar acceso para una app para que informe tu estado de confirmación. El acceso al estado de confirmación permite que las apps determinen si una construcción es exitosa frente a una confirmación específica. Las apps no tendrán acceso a tu código, pero podrán leer y escribir el estado de la información frente a una confirmación específica. |
|
||||
| Implementaciones | El estado de implementación permite que las apps determinen si una implementación es exitosa frente a una confirmación específica para repositorios públicos y privados. Las apps no tendrán acceso a tu código. |
|
||||
| Gists | El acceso a [gist](https://gist.github.com) permite que las aplicaciones lean o escriban en los gists públicos y secretos. |
|
||||
| Enlaces | El acceso a [webhooks](/webhooks) permite a las aplicaciones leer o escribir configuraciones de enlace en repositorios que usted administra. |
|
||||
| Notificaciones | El acceso a las notificaciones permite que las apps lean tus notificaciones de {% data variables.product.product_name %}, como comentarios sobre propuestas y solicitudes de extracción. Sin embargo, las apps permanecen inhabilitadas para acceder a tus repositorios. |
|
||||
| Las organizaciones y los equipos | El acceso a organizaciones y equipos permite que las apps accedan y administren la membresía de la organización y del equipo. |
|
||||
| Datos de usuario personales | Entre los datos del usuario se incluye información que se encuentra en tu perfil de usuario, como tu nombre, dirección de correo electrónico y ubicación. |
|
||||
| Repositorios | La información del repositorio incluye los nombres de los colaboradores, las ramas que creaste y los archivos actuales dentro de tu repositorio. Las apps pueden solicitar acceso a repositorios públicos o privados a nivel del usuario. |
|
||||
| Eliminación de repositorio | Las apps pueden solicitar la eliminación de los repositorios que administras,, pero no tendrán acceso a tu código. |{% ifversion projects-oauth-scope %}
|
||||
| Proyectos | Acceso a instancias de {% data variables.projects.projects_v2 %} del usuario y la organización. Las aplicaciones pueden solicitar acceso de lectura y escritura o de solo lectura. |{% endif %}
|
||||
|
||||
## Requesting updated permissions
|
||||
## Solicitar permisos actualizados
|
||||
|
||||
When {% data variables.product.prodname_oauth_apps %} request new access permissions, they will notify you of the differences between their current permissions and the new permissions.
|
||||
Cuando las {% data variables.product.prodname_oauth_apps %} solicitan permisos de acceso nuevos, te notificarán sobre las diferencias entre los permisos actuales y los permisos nuevos.
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
## {% data variables.product.prodname_oauth_apps %} and organizations
|
||||
## {% data variables.product.prodname_oauth_apps %} y organizaciones
|
||||
|
||||
When you authorize an {% data variables.product.prodname_oauth_app %} for your personal account, you'll also see how the authorization will affect each organization you're a member of.
|
||||
Al autorizar una {% data variables.product.prodname_oauth_app %} para tu cuenta personal, también verás cómo afectará la autorización a cada organización de la que seas miembro.
|
||||
|
||||
- **For organizations *with* {% data variables.product.prodname_oauth_app %} access restrictions, you can request that organization admins approve the application for use in that organization.** If the organization does not approve the application, then the application will only be able to access the organization's public resources. If you're an organization admin, you can [approve the application](/articles/approving-oauth-apps-for-your-organization) yourself.
|
||||
- **Para las organizaciones *con* restricciones de acceso a {% data variables.product.prodname_oauth_app %}, puede solicitar que los administradores de la organización aprueben la aplicación para usarla dentro de la organización.** Si la organización no aprueba la aplicación, esta solo podrá acceder a los recursos públicos de la organización. Si es administrador de la organización, puede [aprobar la aplicación](/articles/approving-oauth-apps-for-your-organization) usted mismo.
|
||||
|
||||
- **For organizations *without* {% data variables.product.prodname_oauth_app %} access restrictions, the application will automatically be authorized for access to that organization's resources.** For this reason, you should be careful about which {% data variables.product.prodname_oauth_apps %} you approve for access to your personal account resources as well as any organization resources.
|
||||
- **Para las organizaciones *sin* restricciones de acceso a {% data variables.product.prodname_oauth_app %}, la aplicación se autorizará automáticamente para el acceso a los recursos de la organización.** Por este motivo, debe tener cuidado con qué {% data variables.product.prodname_oauth_apps %} aprueba para que accedan a los recursos de su cuenta personal, así como a los recursos de la organización.
|
||||
|
||||
If you belong to any organizations with SAML single sign-on (SSO) enabled, and you have created a linked identity for that organization by authenticating via SAML in the past, you must have an active SAML session for each organization each time you authorize an {% data variables.product.prodname_oauth_app %}.
|
||||
Si perteneces a cualquier organización con el inicio de sesión único (SSO) de SAML habilitado y has creado una identidad vinculada para esa organización con la autenticación a través de SAML en el pasado, debes tener una sesión de SAML activa para cada organización cada vez que autorices un {% data variables.product.prodname_oauth_app %}.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** If you're encountering issues with an authorized {% data variables.product.prodname_oauth_app %} or {% data variables.product.prodname_github_app %} accessing an organization that is protected by SAML, you may need to revoke the app from your [Authorized {% data variables.product.prodname_github_apps %}](https://github.com/settings/applications) or [Authorized {% data variables.product.prodname_oauth_apps %}](https://github.com/settings/apps/authorizations) page, visit the organization to authenticate and establish an active SAML session, and then attempt to reauthorize the app by accessing it.
|
||||
**Nota:** Si tienes problemas con un {% data variables.product.prodname_oauth_app %} o {% data variables.product.prodname_github_app %} autorizados que acceden a una organización protegida por SAML, es posible que tengas que revocar la aplicación de la página [{% data variables.product.prodname_github_apps %} autorizado](https://github.com/settings/applications) o [{% data variables.product.prodname_oauth_apps %} autorizado](https://github.com/settings/apps/authorizations), visitar la organización para autenticarte y establecer una sesión SAML activa y, a continuación, intentar volver a autorizar la aplicación accediendo a ella.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## Further reading
|
||||
## Información adicional
|
||||
|
||||
- "[About {% data variables.product.prodname_oauth_app %} access restrictions](/articles/about-oauth-app-access-restrictions)"
|
||||
- "[Authorizing GitHub Apps](/github/authenticating-to-github/keeping-your-account-and-data-secure/authorizing-github-apps)"
|
||||
- "[{% data variables.product.prodname_marketplace %} support](/articles/github-marketplace-support)"
|
||||
- "[Acerca de las restricciones de acceso a {% data variables.product.prodname_oauth_app %}](/articles/about-oauth-app-access-restrictions)"
|
||||
- "[Autorización de aplicaciones de GitHub](/github/authenticating-to-github/keeping-your-account-and-data-secure/authorizing-github-apps)"
|
||||
- "[Compatibilidad con {% data variables.product.prodname_marketplace %}](/articles/github-marketplace-support)"
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Creación de un aviso de seguridad de repositorio
|
||||
intro: Puedes crear un borrador de asesoría de seguridad para debatir en privado y arreglar una vulnerabilidad de seguridad en tu proyecto de código abierto.
|
||||
title: Creating a repository security advisory
|
||||
intro: You can create a draft security advisory to privately discuss and fix a security vulnerability in your open source project.
|
||||
redirect_from:
|
||||
- /articles/creating-a-maintainer-security-advisory
|
||||
- /github/managing-security-vulnerabilities/creating-a-maintainer-security-advisory
|
||||
@@ -15,31 +15,31 @@ topics:
|
||||
- Security advisories
|
||||
- Vulnerabilities
|
||||
shortTitle: Create repository advisories
|
||||
ms.openlocfilehash: de22432173f6bf909d001a3f780b0f9943769ec0
|
||||
ms.sourcegitcommit: 27882d9b3f19979c817c25952a2fb4dc4c6f0a65
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 10/27/2022
|
||||
ms.locfileid: '148114110'
|
||||
---
|
||||
Cualquier usuario con permisos de administrador puede crear un aviso de seguridad.
|
||||
|
||||
Anyone with admin permissions to a repository can create a security advisory.
|
||||
|
||||
{% data reusables.security-advisory.security-researcher-cannot-create-advisory %}
|
||||
|
||||
## Creación de un aviso de seguridad
|
||||
## Creating a security advisory
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-security %} {% data reusables.repositories.sidebar-advisories %}
|
||||
4. Haz clic en **Nuevo borrador de asesoría de seguridad** para abrir el borrador del formulario de asesoría.
|
||||
|
||||
5. Escribe un título para tu aviso de seguridad.
|
||||
{% data reusables.repositories.security-advisory-edit-details %} {% data reusables.repositories.security-advisory-edit-severity %} {% data reusables.repositories.security-advisory-edit-cwe-cve %} {% data reusables.repositories.security-advisory-edit-description %}
|
||||
11. Haga clic en **Create draft security advisory**.
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-security %}
|
||||
{% data reusables.repositories.sidebar-advisories %}
|
||||
1. Click **New draft security advisory** to open the draft advisory form. The fields marked with an asterisk are required.
|
||||
|
||||
1. Type a title for your security advisory.
|
||||
{% data reusables.repositories.security-advisory-edit-details %}
|
||||
{% data reusables.repositories.security-advisory-edit-severity %}
|
||||
{% data reusables.repositories.security-advisory-edit-cwe-cve %}
|
||||
{% data reusables.repositories.security-advisory-edit-description %}
|
||||
1. Click **Create draft security advisory**.
|
||||
|
||||
|
||||
## Pasos siguientes
|
||||
## Next steps
|
||||
|
||||
- Comentar en el borrador de asesoría de seguridad para debatir sobre la vulnerabilidad con tu equipo.
|
||||
- Añadir colaboradores a la asesoría de seguridad. Para obtener más información, consulte "[Adición de un colaborador a un aviso de seguridad de repositorio](/code-security/repository-security-advisories/adding-a-collaborator-to-a-repository-security-advisory)".
|
||||
- Colaborar en privado para solucionar la vulnerabilidad en una bifurcación privada temporaria. Para más información, vea "[Colaboración en una bifurcación privada temporal para resolver una vulnerabilidad de seguridad del repositorio](/code-security/repository-security-advisories/collaborating-in-a-temporary-private-fork-to-resolve-a-repository-security-vulnerability)".
|
||||
- Agregar individuos que deberían recibir crédito por contribuir con la asesoría de seguridad. Para más información, vea "[Edición de un aviso de seguridad de repositorio](/code-security/repository-security-advisories/editing-a-repository-security-advisory#about-credits-for-security-advisories)".
|
||||
- Publicar la asesoría de seguridad para notificar a tu comunidad sobre la vulnerabilidad de seguridad en cuestión. Para más información, vea "[Publicación de un aviso de seguridad de repositorio](/code-security/repository-security-advisories/publishing-a-repository-security-advisory)".
|
||||
- Comment on the draft security advisory to discuss the vulnerability with your team.
|
||||
- Add collaborators to the security advisory. For more information, see "[Adding a collaborator to a repository security advisory](/code-security/repository-security-advisories/adding-a-collaborator-to-a-repository-security-advisory)."
|
||||
- Privately collaborate to fix the vulnerability in a temporary private fork. For more information, see "[Collaborating in a temporary private fork to resolve a repository security vulnerability](/code-security/repository-security-advisories/collaborating-in-a-temporary-private-fork-to-resolve-a-repository-security-vulnerability)."
|
||||
- Add individuals who should receive credit for contributing to the security advisory. For more information, see "[Editing a repository security advisory](/code-security/repository-security-advisories/editing-a-repository-security-advisory#about-credits-for-security-advisories)."
|
||||
- Publish the security advisory to notify your community of the security vulnerability. For more information, see "[Publishing a repository security advisory](/code-security/repository-security-advisories/publishing-a-repository-security-advisory)."
|
||||
|
||||
@@ -49,7 +49,7 @@ When you create a codespace, a number of steps happen to create and connect you
|
||||
|
||||
For more information on what happens when you create a codespace, see "[Deep Dive](/codespaces/getting-started/deep-dive)."
|
||||
|
||||
For more information on the lifecycle of a codespace, see "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)."
|
||||
For more information on the lifecycle of a codespace, see "[The codespace lifecycle](/codespaces/getting-started/the-codespace-lifecycle)."
|
||||
|
||||
If you want to use Git hooks for your codespace, then you should set up hooks using the [`devcontainer.json` lifecycle scripts](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_lifecycle-scripts), such as `postCreateCommand`, during step 4. Since your codespace container is created after the repository is cloned, any [git template directory](https://git-scm.com/docs/git-init#_template_directory) configured in the container image will not apply to your codespace. Hooks must instead be installed after the codespace is created. For more information on using `postCreateCommand`, see the [`devcontainer.json` reference](https://code.visualstudio.com/docs/remote/devcontainerjson-reference#_devcontainerjson-properties) in the {% data variables.product.prodname_vscode_shortname %} documentation.
|
||||
|
||||
|
||||
@@ -98,5 +98,5 @@ You can publish an unpublished codespace from the "Your codespaces" page on {% d
|
||||
## Further reading
|
||||
|
||||
- "[Creating a codespace for a repository](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)"
|
||||
- "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)"
|
||||
- "[The codespace lifecycle](/codespaces/getting-started/the-codespace-lifecycle)"
|
||||
- "[Using source control in your codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)"
|
||||
@@ -7,7 +7,6 @@ versions:
|
||||
topics:
|
||||
- Codespaces
|
||||
children:
|
||||
- /the-codespace-lifecycle
|
||||
- /developing-in-a-codespace
|
||||
- /creating-a-codespace-for-a-repository
|
||||
- /creating-a-codespace-from-a-template
|
||||
|
||||
@@ -105,4 +105,4 @@ When you restart a codespace you can choose to open it in {% data variables.prod
|
||||
|
||||
## Further reading
|
||||
|
||||
- "[The codespace lifecycle](/codespaces/developing-in-codespaces/the-codespace-lifecycle)"
|
||||
- "[The codespace lifecycle](/codespaces/getting-started/the-codespace-lifecycle)"
|
||||
|
||||
@@ -1,72 +0,0 @@
|
||||
---
|
||||
title: Ciclo de vida de un codespace
|
||||
intro: 'Puedes desarrollar en un entorno de {% data variables.product.prodname_github_codespaces %} y mantener tus datos a lo largo de todo el ciclo de vida del codespace.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
type: overview
|
||||
topics:
|
||||
- Codespaces
|
||||
- Developer
|
||||
redirect_from:
|
||||
- /codespaces/developing-in-codespaces/codespaces-lifecycle
|
||||
ms.openlocfilehash: 660ced63e34c6de8025c65946542baca43534cfe
|
||||
ms.sourcegitcommit: 3ff64a8c8cf70e868c10105aa6bbf6cd4f78e4d3
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/22/2022
|
||||
ms.locfileid: '148180799'
|
||||
---
|
||||
## Acerca del ciclo de vida de un codespace
|
||||
|
||||
El ciclo de vida de un codespace comienza cuando lo creas y termina cuando lo borras. Puedes desconectarte y reconectarte a un codespace activo sin afectar sus procesos de ejecución. También puedes detener y reiniciar un codespace sin perder los cambios que hayas hecho a tu proyecto.
|
||||
|
||||
## Crear un codespace
|
||||
|
||||
Cuando quieras trabajar en un proyecto, puedes elegir crear un codespace nuevo o abrir uno existente. Deberás crear un codespace nuevo desde una rama de tu repositorio cada vez que desarrolles en {% data variables.product.prodname_github_codespaces %} o mantengas un codespace de ejecución extendida para una característica. {% data reusables.codespaces.starting-new-project-template %} Para obtener más información, consulta "[Creación de un codespace para un repositorio](/codespaces/developing-in-codespaces/creating-a-codespace-for-a-repository)" y "[Creación de un codespace a partir de una plantilla](/codespaces/developing-in-codespaces/creating-a-codespace-from-a-template)".
|
||||
|
||||
{% data reusables.codespaces.max-number-codespaces %} Del mismo modo, si alcanza el número máximo de espacios de codespaces e intenta iniciar otro, se le pedirá que detenga uno de los codespaces activos.
|
||||
|
||||
Si eliges crear un codespace nuevo cada que trabajas en un proyecto, debes subir tus cambios frecuentemente para que todas las confirmaciones nuevas se enecuentren en {% data variables.product.prodname_dotcom %}. Si eliges utilizar un codespace de ejecución extendida para tu proyecto, deberías hacer extracciones desde tu rama predeterminada de repositorio cada que comiences a trabajar en tu codespace para que tu ambiente tenga las confirmaciones más recientes. Este flujo de trabajo es muy similar a que si estuvieras trabajando en un proyecto en tu máquina local.
|
||||
|
||||
{% data reusables.codespaces.prebuilds-crossreference %}
|
||||
|
||||
## Guardar los cambios en un codespace
|
||||
|
||||
Cuando te conectas a un codespace a través de la web, el guardado automático se habilita automáticamente para el editor web y se configura para guardar los cambios después de un retraso. Cuando te conectes a un codespace a través de la instancia de {% data variables.product.prodname_vscode %} que se está ejecutando en tu máquina de escritorio, debes habilitar el guardado automático. Para más información, vea [Guardado o guardado automático](https://code.visualstudio.com/docs/editor/codebasics#_save-auto-save) en la documentación de {% data variables.product.prodname_vscode %}.
|
||||
|
||||
El trabajo se guardará en una máquina virtual en la nube. Puedes cerrar y detener un codespace y volver al trabajo guardado más adelante. Si tienes cambios sin guardar, tu editor te pedirá guardarlos antes de salir. Sin embargo, si se elimina el codespace, también se eliminará tu trabajo. Para conservar el trabajo, deberás confirmar los cambios e insertarlos en el repositorio remoto, o publicar tu trabajo en un nuevo repositorio remoto si creaste el codespace a partir de una plantilla. Para más información, vea "[Uso del control de código fuente en el codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)".
|
||||
|
||||
## Tiempos de expiración para {% data variables.product.prodname_github_codespaces %}
|
||||
|
||||
Si dejas que tu codespace se ejecute sin interacción o si sales de este sin detenerlo explícitamente, el codespace se detendrá después de un periodo de espera y dejará de ejecutarse. Predeterminadamente, un codespace se detendrá después de 30 minutos de inactividad, pero puedes personalizar la duración del periodo de espera en cada codesapce nuevo que crees. Para obtener más información sobre cómo establecer el periodo de tiempo de espera predeterminado para los codespaces, vea "[Establecimiento del periodo de tiempo de espera para {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)". Para obtener más información sobre cómo detener un codespace, vea "[Detención de un codespace](#stopping-a-codespace)".
|
||||
|
||||
Cuando un codespace agota su tiempo de espera, tus datos se preservan desde la última vez en la que hayas guardado tus cambios. Para obtener más información, vea "[Guardado de cambios en un codespace](#saving-changes-in-a-codespace)".
|
||||
|
||||
## Reconstruir un codespace
|
||||
|
||||
Puedes recompilar el codespace para implementar cambios en la configuración de tu contenedor de desarrollo. Para la mayoría de los usos, puedes crear un codespace como alternativa a reconstruir uno de ellos. De forma predeterminada, al recompilar el codespace, {% data variables.product.prodname_github_codespaces %} reutilizará imágenes de la memoria caché para acelerar el proceso de recompilación. Como alternativa, puedes realizar una recompilación completa, que borra la memoria caché y recompila el contenedor con imágenes nuevas.
|
||||
|
||||
Para más información, consulta "[Introducción a los contenedores de desarrollo](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace)" y "[Realización de una recompilación completa de un contenedor](/codespaces/codespaces-reference/performing-a-full-rebuild-of-a-container)".
|
||||
|
||||
## Detener un codespace
|
||||
|
||||
{% data reusables.codespaces.stopping-a-codespace %} Para obtener más información, consulta "[Detención e inicio de un codespace](/codespaces/developing-in-codespaces/stopping-and-starting-a-codespace)".
|
||||
|
||||
## Borrar un codespace
|
||||
|
||||
Puedes crear un codespace para una tarea en particular y luego borrarlo de forma segura después de que subas tus cambios a una rama remota.
|
||||
|
||||
Si intentas borrar un codespace con confirmaciones de git sin subir, tu editor te notificará sobre los cambios que tengas sin subir a una rama remota. Puedes subir todos los cambios que desees y luego borrar tu codespace o continuar borrando tu codespace y cualquier cambio sin confirmar. También puedes exportar tu código a una rama nueva sin crear un codespace nuevo. Para obtener más información, vea "[Exportación de cambios a una rama](/codespaces/troubleshooting/exporting-changes-to-a-branch)".
|
||||
|
||||
Los codespaces que se han detenido y permanecen inactivos durante un período de tiempo determinado se eliminarán automáticamente. De manera predeterminada, los codespaces inactivos se eliminan después de 30 días, pero puedes personalizar el período de retención del codespace. Para más información, consulta "[Configuración de la eliminación automática de los codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)".
|
||||
|
||||
Si creas un codespace, seguirá acumulando cargos de almacenamiento hasta que se elimine, independientemente de si está activo o detenido. Para más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces#billing-for-storage-usage)". La eliminación de un codespace no reduce la cantidad facturable actual de {% data variables.product.prodname_github_codespaces %}, que se acumula durante cada ciclo de facturación mensual. Para más información, consulta "[Visualización del uso de {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)".
|
||||
|
||||
Para obtener más información sobre cómo eliminar un codespace, vea "[Eliminación de un codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)".
|
||||
|
||||
## Pérdida de la conexión al usar {% data variables.product.prodname_github_codespaces %}
|
||||
|
||||
{% data variables.product.prodname_github_codespaces %} es un entorno de desarrollo basado en la nube y requiere de una conexión a internet. Si pierdes la conexióna internet mientras trabajas en un codespace, no podrás acceder a él. Sin embargo, cualquier cambio sin confirmar, se guardará. Cuando tengas acceso a una conexión de internet nuevamente, puedes conectarte a tu codespace exactamente en el mismo estado en el que lo dejaste. Si tienes una conexión de internet inestable, deberías confirmar y subir tus cambios frecuentemente.
|
||||
|
||||
Si sabes que a menudo estarás trabajando sin conexión, puedes usar el archivo `devcontainer.json` con la [extensión "Dev Containers"](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) para {% data variables.product.prodname_vscode_shortname %} a fin de compilarlo y adjuntarlo a un contenedor de desarrollo local para el repositorio. Para obtener más información, vea [Desarrollo dentro de un contenedor](https://code.visualstudio.com/docs/remote/containers) en la documentación de {% data variables.product.prodname_vscode %}.
|
||||
@@ -7,6 +7,7 @@ versions:
|
||||
ghec: '*'
|
||||
children:
|
||||
- /quickstart
|
||||
- /the-codespace-lifecycle
|
||||
- /deep-dive
|
||||
ms.openlocfilehash: e0a845403562bbe046b81e52893a9ff59a1fbf1c
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
|
||||
@@ -8,7 +8,7 @@ introLinks:
|
||||
featuredLinks:
|
||||
guides:
|
||||
- /codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization
|
||||
- /codespaces/developing-in-codespaces/the-codespace-lifecycle
|
||||
- /codespaces/getting-started/the-codespace-lifecycle
|
||||
- /codespaces/setting-up-your-codespace/configuring-codespaces-for-your-project
|
||||
- /codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces
|
||||
- /billing/managing-billing-for-github-codespaces/about-billing-for-codespaces
|
||||
|
||||
@@ -11,12 +11,12 @@ topics:
|
||||
- Codespaces
|
||||
redirect_from:
|
||||
- /codespaces/troubleshooting/troubleshooting-codespaces-clients
|
||||
ms.openlocfilehash: 682160b3b92960487c0709fc411fc2143d18f415
|
||||
ms.sourcegitcommit: e8c012864f13f9146e53fcb0699e2928c949ffa8
|
||||
ms.openlocfilehash: 35bd9dd859612307c1f9e49ea8ed9771e4f5efcd
|
||||
ms.sourcegitcommit: bf4e3590ab71b0a1bfa8d74b00183f63193acbbf
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/09/2022
|
||||
ms.locfileid: '148159900'
|
||||
ms.lasthandoff: 11/30/2022
|
||||
ms.locfileid: '148186175'
|
||||
---
|
||||
{% jetbrains %}
|
||||
|
||||
@@ -54,7 +54,7 @@ Si la incidencia no se ha corregido en {% data variables.product.prodname_vscode
|
||||
|
||||
## Solución de problemas de {% data variables.product.prodname_vscode_shortname %}
|
||||
|
||||
Al abrir un codespace en la aplicación de escritorio de {% data variables.product.prodname_vscode_shortname %}, es posible que observes algunas diferencias en comparación con trabajar en un área de trabajo local, pero la experiencia debe ser similar.
|
||||
Al abrir un codespace en la aplicación de escritorio de {% data variables.product.prodname_vscode_shortname %}, es posible que observes algunas diferencias en comparación con trabajar en un área de trabajo local, pero la experiencia debe ser similar.
|
||||
|
||||
Si encuentras incidencias, puedes comprobar si hay incidencias conocidas y registrar nuevas incidencias con la experiencia de {% data variables.product.prodname_vscode_shortname %} en el repositorio [`microsoft/vscode`](https://github.com/microsoft/vscode/issues?q=is%3Aissue+is%3Aopen+codespaces).
|
||||
|
||||
@@ -104,6 +104,31 @@ A continuación se proporcionan algunas instrucciones como punto de partida inic
|
||||
|
||||
1. Haz clic en **Guardar y reiniciar**.
|
||||
|
||||
### El cliente no se puede abrir en MacOS Ventura
|
||||
|
||||
En MacOS Ventura, la primera vez que intentas conectarte a un espacio de código desde la puerta de enlace de JetBrains, se puede mostrar un mensaje indicando que la aplicación cliente de JetBrains "está dañada y no se puede abrir".
|
||||
|
||||
<img src="/assets/images/help/codespaces/jetbrains-ventura-error1.png" alt="Screenshot of the 'cannot be opened' error message" style="width:230px;"/>
|
||||
|
||||
Si esto ocurre:
|
||||
|
||||
1. Haz clic en **Cancelar** para descartar este mensaje.
|
||||
1. Haz clic en el icono de Apple, en la parte superior izquierda de la pantalla y en **Configuración del sistema**.
|
||||
1. Haz clic en **Privacidad y seguridad** y desplázate hacia abajo hasta la sección "Seguridad".
|
||||
|
||||
|
||||
|
||||
Verás un mensaje que indica que se ha bloqueado el uso del cliente jetBrains.
|
||||
|
||||
1. Haz clic en **Abrir de todas formas** para agregar el cliente jetBrains a las aplicaciones reconocidas.
|
||||
El mensaje se muestra de nuevo, pero esta vez con un botón **Abrir**.
|
||||
|
||||
<img src="/assets/images/help/codespaces/jetbrains-ventura-error2.png" alt="Screenshot of the error message with an 'Open' button" style="width:230px;"/>
|
||||
|
||||
1. Vuelve a hacer clic en **Cancelar**.
|
||||
1. Vuelve a la aplicación de puerta de enlace de JetBrains y conéctate al codespace necesario.
|
||||
El cliente jetBrains se abrirá correctamente. Después de autorizar la ejecución de la aplicación cliente en tu equipo Mac, no verás el mensaje al conectarte a codespaces en el futuro.
|
||||
|
||||
### Problemas de conexión SSH
|
||||
|
||||
Para conectarse a través del servidor SSH que se ejecuta en el codespace, debes tener una clave SSH en el directorio `~/.ssh` (MacOS y Linux) o en el directorio `%HOMEPATH%\.ssh` (Windows) que ya se haya agregado a la cuenta de {% data variables.product.prodname_dotcom %}. Si no tienes ninguna clave en este directorio, {% data variables.product.prodname_cli %} generará claves automáticamente. Para obtener más información, consulta "[Adición de una clave SSHa tu cuenta de {% data variables.product.prodname_dotcom %}](/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account?platform=windows&tool=webui)".
|
||||
@@ -115,4 +140,3 @@ Si tienes problemas con la validación de claves, prueba a actualizar la versió
|
||||
Para obtener ayuda con problemas específicos del IDE de JetBrains que usas o la aplicación de puerta de enlace de JetBrains, consulta "[Soporte técnico del producto](https://www.jetbrains.com/support/)" en el sitio web de JetBrains.
|
||||
|
||||
{% endjetbrains %}
|
||||
|
||||
|
||||
@@ -1,32 +0,0 @@
|
||||
---
|
||||
title: Cambiar una URL remota desde el GitHub Desktop
|
||||
intro: 'Puedes cambiar la URL remota para un repositorio en el que estés trabajando {% data variables.product.prodname_desktop %}. Es posible que puedas hacerlo si se ha cambiado el nombre, o si el nombre de usuario o la organización que posee el repositorio ha cambiado.'
|
||||
redirect_from:
|
||||
- /desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop
|
||||
- /desktop/contributing-to-projects/changing-a-remote-s-url-from-github-desktop
|
||||
- /desktop/contributing-and-collaborating-using-github-desktop/changing-a-remotes-url-from-github-desktop
|
||||
versions:
|
||||
fpt: '*'
|
||||
shortTitle: Change a remote's URL
|
||||
ms.openlocfilehash: e06ea68ead9ab79c44d7aaf96f48d6645232b496
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '146058480'
|
||||
---
|
||||
{% mac %}
|
||||
|
||||
{% data reusables.desktop.mac-repository-settings-menu %}
|
||||
2. Haz clic en **Remoto** y, en **Repositorio remoto principal**, escribe la dirección URL deseada.
|
||||
 {% data reusables.desktop.repository-settings-save %}
|
||||
|
||||
{% endmac %}
|
||||
|
||||
{% windows %}
|
||||
|
||||
{% data reusables.desktop.windows-repository-settings-menu %}
|
||||
2. Haz clic en **Remoto** y, en **Repositorio remoto principal**, escribe la dirección URL deseada.
|
||||
 {% data reusables.desktop.repository-settings-save %}
|
||||
|
||||
{% endwindows %}
|
||||
@@ -10,7 +10,7 @@ children:
|
||||
- /viewing-a-pull-request-in-github-desktop
|
||||
- /viewing-and-re-running-checks-in-github-desktop
|
||||
- /configuring-notifications-in-github-desktop
|
||||
- /changing-a-remotes-url-from-github-desktop
|
||||
- /changing-the-remote-url-for-a-repository-from-github-desktop
|
||||
shortTitle: Work with your remote repo
|
||||
ms.openlocfilehash: 60c2f41546ff085ea8f8d56142da6a3c7a81ebae
|
||||
ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a
|
||||
|
||||
@@ -7,12 +7,12 @@ redirect_from:
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
ms.openlocfilehash: bba9137fc39c1bc101a75650dcea03e651d37fff
|
||||
ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a
|
||||
ms.openlocfilehash: 27f11aa4ae2693bcc336ecdf4cbfb68d8679d743
|
||||
ms.sourcegitcommit: 74c60a4564bcc17e47b5a67941ac6d9fe13b6a5c
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '145092145'
|
||||
ms.lasthandoff: 11/30/2022
|
||||
ms.locfileid: '148186167'
|
||||
---
|
||||
## Para las GitHub Apps
|
||||
|
||||
@@ -39,7 +39,7 @@ Para obtener información sobre cómo buscar aplicaciones para usar, vea "[Búsq
|
||||
|
||||
## Para las GitHub Actions
|
||||
|
||||
Las acciones con la {% octicon "verified" aria-label="The verified badge" %} o la insignia de creador verificado indican que {% data variables.product.prodname_dotcom %} ha verificado al creador de esta acción como socio de la organización.
|
||||
Las acciones con la {% octicon "verified" aria-label="The verified badge" %} o la insignia de creador verificado indican que {% data variables.product.prodname_dotcom %} ha verificado al creador de esta acción como socio de la organización. Los partners pueden enviar un correo electrónico a <a href="mailto:partnerships@github.com">partnerships@github.com</a> para solicitar la insignia de creador verificado.
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -1,42 +0,0 @@
|
||||
---
|
||||
title: Configurar un remoto para una bifurcación
|
||||
intro: 'Debes configurar un remoto que apunte al repositorio ascendente en Git para [sincronizar los cambios que realizas en una bifurcación](/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork) con el repositorio original. Esto también te permite sincronizar los cambios en el repositorio original con la bifurcación.'
|
||||
redirect_from:
|
||||
- /github/collaborating-with-issues-and-pull-requests/working-with-forks/configuring-a-remote-for-a-fork
|
||||
- /articles/configuring-a-remote-for-a-fork
|
||||
- /github/collaborating-with-issues-and-pull-requests/configuring-a-remote-for-a-fork
|
||||
- /github/collaborating-with-pull-requests/working-with-forks/configuring-a-remote-for-a-fork
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Pull requests
|
||||
shortTitle: Configure a remote
|
||||
ms.openlocfilehash: d474b56a9b1881d9511ccf9e239bb54e26967784
|
||||
ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 09/10/2022
|
||||
ms.locfileid: '145139493'
|
||||
---
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
2. Enumera el repositorio remoto configurado actualmente para tu bifurcación.
|
||||
```shell
|
||||
$ git remote -v
|
||||
> origin https://{% data variables.command_line.codeblock %}/<em>YOUR_USERNAME</em>/<em>YOUR_FORK</em>.git (fetch)
|
||||
> origin https://{% data variables.command_line.codeblock %}/<em>YOUR_USERNAME</em>/<em>YOUR_FORK</em>.git (push)
|
||||
```
|
||||
3. Especifica un nuevo repositorio *ascendente* remoto que se sincronizará con la bifurcación.
|
||||
```shell
|
||||
$ git remote add upstream https://{% data variables.command_line.codeblock %}/<em>ORIGINAL_OWNER</em>/<em>ORIGINAL_REPOSITORY</em>.git
|
||||
```
|
||||
4. Verifica el nuevo repositorio ascendente que especificaste para tu bifurcación.
|
||||
```shell
|
||||
$ git remote -v
|
||||
> origin https://{% data variables.command_line.codeblock %}/<em>YOUR_USERNAME</em>/<em>YOUR_FORK</em>.git (fetch)
|
||||
> origin https://{% data variables.command_line.codeblock %}/<em>YOUR_USERNAME</em>/<em>YOUR_FORK</em>.git (push)
|
||||
> upstream https://{% data variables.command_line.codeblock %}/<em>ORIGINAL_OWNER</em>/<em>ORIGINAL_REPOSITORY</em>.git (fetch)
|
||||
> upstream https://{% data variables.command_line.codeblock %}/<em>ORIGINAL_OWNER</em>/<em>ORIGINAL_REPOSITORY</em>.git (push)
|
||||
```
|
||||
@@ -14,7 +14,7 @@ topics:
|
||||
- Pull requests
|
||||
children:
|
||||
- /about-forks
|
||||
- /configuring-a-remote-for-a-fork
|
||||
- /configuring-a-remote-repository-for-a-fork
|
||||
- /syncing-a-fork
|
||||
- /allowing-changes-to-a-pull-request-branch-created-from-a-fork
|
||||
- /what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility
|
||||
|
||||
@@ -52,7 +52,7 @@ If the changes from the upstream repository cause conflict then the {% data vari
|
||||
|
||||
## Syncing a fork branch from the command line
|
||||
|
||||
Before you can sync your fork with an upstream repository, you must [configure a remote that points to the upstream repository](/pull-requests/collaborating-with-pull-requests/working-with-forks/configuring-a-remote-for-a-fork) in Git.
|
||||
Before you can sync your fork with an upstream repository, you must configure a remote that points to the upstream repository in Git. For more information, see "[Configuring a remote repository for a fork](/pull-requests/collaborating-with-pull-requests/working-with-forks/configuring-a-remote-repository-for-a-fork)."
|
||||
|
||||
{% data reusables.command_line.open_the_multi_os_terminal %}
|
||||
2. Change the current working directory to your local project.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Cambiar la rama predeterminada
|
||||
intro: 'Si tienes màs de una rama en tu repositorio, puedes configurar cualquiera de ellas como la predeterminada.'
|
||||
title: Changing the default branch
|
||||
intro: 'If you have more than one branch in your repository, you can configure any branch as the default branch.'
|
||||
permissions: People with admin access for a repository can change the default branch for the repository.
|
||||
versions:
|
||||
fpt: '*'
|
||||
@@ -15,40 +15,38 @@ redirect_from:
|
||||
topics:
|
||||
- Repositories
|
||||
shortTitle: Change the default branch
|
||||
ms.openlocfilehash: e8f88499ab258e5855804288a4f811b38237df97
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '145136969'
|
||||
---
|
||||
## Acerca de cambiar la rama predeterminada
|
||||
## About changing the default branch
|
||||
|
||||
Puedes elegir la rama predeterminada para un repositorio. Èsta es la rama base para las solicitudes de cambios y confirmaciones de còdigo. Para obtener más información sobre la rama predeterminada, consulte "[Acerca de las ramas](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)".
|
||||
You can choose the default branch for a repository. The default branch is the base branch for pull requests and code commits. For more information about the default branch, see "[About branches](/github/collaborating-with-issues-and-pull-requests/about-branches#about-the-default-branch)."
|
||||
|
||||
{% ifversion not ghae %} {% note %}
|
||||
{% ifversion not ghae %}
|
||||
{% note %}
|
||||
|
||||
**Nota**: Si usa el puente Git-Subversion, el cambio de la rama predeterminada afectará al contenido de la rama de su `trunk` y al `HEAD` que verá al enumerar referencias del repositorio remoto. Para obtener más información, consulte "[Compatibilidad con clientes de Subversion](/github/importing-your-projects-to-github/support-for-subversion-clients)" y [git-ls-remote](https://git-scm.com/docs/git-ls-remote.html) en la documentación de Git.
|
||||
**Note**: If you use the Git-Subversion bridge, changing the default branch will affect your `trunk` branch contents and the `HEAD` you see when you list references for the remote repository. For more information, see "[Support for Subversion clients](/github/importing-your-projects-to-github/support-for-subversion-clients)" and [git-ls-remote](https://git-scm.com/docs/git-ls-remote.html) in the Git documentation.
|
||||
|
||||
{% endnote %} {% endif %}
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
|
||||
También puedes renombrar la rama predeterminada. Para obtener más información, consulte "[Renombrar una rama](/github/administering-a-repository/renaming-a-branch)."
|
||||
You can also rename the default branch. For more information, see "[Renaming a branch](/github/administering-a-repository/renaming-a-branch)."
|
||||
|
||||
{% data reusables.branches.set-default-branch %}
|
||||
|
||||
## Requisitos previos
|
||||
## Prerequisites
|
||||
|
||||
Para cambiar la rama predeterminada, tu repositorio debe tener màs de una rama. Para obtener más información, consulte "[Creación y eliminación de ramas en el repositorio](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository#creating-a-branch)".
|
||||
To change the default branch, your repository must have more than one branch. For more information, see "[Creating and deleting branches within your repository](/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository#creating-a-branch)."
|
||||
|
||||
## Cambiar la rama predeterminada
|
||||
## Changing the default branch
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.repository-branches %}
|
||||
1. Debajo de "Rama predeterminada", a la derecha del nombre de rama predeterminado, da clic en el {% octicon "arrow-switch" aria-label="The switch icon with two arrows" %}.
|
||||
|
||||
1. Utiliza el menù desplegable y luego da clic en el nombre de una rama.
|
||||
|
||||
1. Haga clic en **Update**(Actualizar).
|
||||
|
||||
1. Lea la advertencia y, a continuación, haga clic en **I understand, update the default branch.**
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.sidebar-settings %}
|
||||
{% data reusables.repositories.repository-branches %}
|
||||
1. Under "Default branch", to the right of the default branch name, click {% octicon "arrow-switch" aria-label="The switch icon with two arrows" %}.
|
||||
|
||||
1. Use the drop-down, then click a branch name.
|
||||
|
||||
1. Click **Update**.
|
||||
|
||||
1. Read the warning, then click **I understand, update the default branch.**
|
||||
|
||||
|
||||
|
||||
@@ -14,12 +14,12 @@ versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Repositories
|
||||
ms.openlocfilehash: 3b6822be6551d43b3af55220ac8f39deec8be1df
|
||||
ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110
|
||||
ms.openlocfilehash: 12265f0627ca6d0feb34244aab1c021b5ae6cc10
|
||||
ms.sourcegitcommit: 9315c7dae9a673a2f8958df7632bf1af206a0bed
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 10/25/2022
|
||||
ms.locfileid: '148106841'
|
||||
ms.lasthandoff: 12/01/2022
|
||||
ms.locfileid: '148188242'
|
||||
---
|
||||
Las personas con permisos administrativos o de propietario pueden configurar un archivo CODEOWNERS en un repositorio.
|
||||
|
||||
@@ -85,7 +85,7 @@ Las rutas de CODEOWNERS distinguen entre mayúsculas y minúsculas, ya que {% da
|
||||
# precedence. When someone opens a pull request that only
|
||||
# modifies JS files, only @js-owner and not the global
|
||||
# owner(s) will be requested for a review.
|
||||
*.js @js-owner
|
||||
*.js @js-owner #This is an inline comment.
|
||||
|
||||
# You can also use email addresses if you prefer. They'll be
|
||||
# used to look up users just like we do for commit author
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Getting started with the REST API
|
||||
intro: 'Learn how to use the {% data variables.product.prodname_dotcom %} REST API.'
|
||||
title: Introducción a la API REST
|
||||
intro: 'Obtén información sobre el uso de la API de REST de {% data variables.product.prodname_dotcom %}.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
@@ -10,33 +10,38 @@ topics:
|
||||
- API
|
||||
shortTitle: Using the API
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 66620b01bb488f8c74111b56255ff06702e402e8
|
||||
ms.sourcegitcommit: d2f0b59ed096b9e68ef8f6fa019cd925165762ec
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148184265'
|
||||
---
|
||||
## Acerca de la API de REST de {% data variables.product.prodname_dotcom %}
|
||||
|
||||
## About the {% data variables.product.prodname_dotcom %} REST API
|
||||
En este artículo se describe cómo usar la API de REST de {% data variables.product.prodname_dotcom %} mediante {% data variables.product.prodname_cli %}, JavaScript o cURL. Para obtener una guía de inicio rápido, consulta "[Inicio rápido para la API de REST de GitHub](/rest/quickstart)".
|
||||
|
||||
This article describes how to use the {% data variables.product.prodname_dotcom %} REST API using {% data variables.product.prodname_cli %}, JavaScript, or cURL. For a quickstart guide, see "[Quickstart for GitHub REST API](/rest/quickstart)."
|
||||
Al realizar una solicitud a la API de REST, especificarás un método HTTP y una ruta de acceso. Además, también puedes especificar encabezados de solicitud y parámetros de ruta de acceso, consulta o cuerpo. La API devolverá el código de estado de respuesta, los encabezados de respuesta y, posiblemente, un cuerpo de respuesta.
|
||||
|
||||
When you make a request to the REST API, you will specify an HTTP method and a path. Additionally, you might also specify request headers and path, query, or body parameters. The API will return the response status code, response headers, and potentially a response body.
|
||||
La documentación de referencia de la API de REST describe el método HTTP, la ruta de acceso y los parámetros de cada operación. También muestra solicitudes y respuestas de ejemplo para cada operación. Para más información, consulta la [Documentación de referencia de REST](/rest).
|
||||
|
||||
The REST API reference documentation describes the HTTP method, path, and parameters for every operation. It also displays example requests and responses for each operation. For more information, see the [REST reference documentation](/rest).
|
||||
Para más información sobre {% data variables.product.company_short %}'s APIs, consulta "[Sobre las API de {% data variables.product.company_short %}](/developers/overview/about-githubs-apis)."
|
||||
|
||||
For more information about {% data variables.product.company_short %}'s APIs, see "[About {% data variables.product.company_short %}'s APIs](/developers/overview/about-githubs-apis)."
|
||||
## Realización de una solicitud
|
||||
|
||||
## Making a request
|
||||
|
||||
To make a request, first find the HTTP method and the path for the operation that you want to use. For example, the "Get Octocat" operation uses the `GET` method and the `/octocat` path. For the full reference documentation for this operation, see "[Get Octocat](/rest/meta#get-octocat)."
|
||||
Para realizar una solicitud, busca primero el método HTTP y la ruta de acceso de la operación que deseas usar. Por ejemplo, la operación "Obtener Octocat" usa el `GET` método y la ruta de `/octocat` acceso. Para obtener la documentación de referencia completa de esta operación, consulta "[Obtener Octocat](/rest/meta#get-octocat)".
|
||||
|
||||
{% cli %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note**: You must install {% data variables.product.prodname_cli %} in order to use the commands in the {% data variables.product.prodname_cli %} examples. For installation instructions, see the [{% data variables.product.prodname_cli %} repository](https://github.com/cli/cli#installation).
|
||||
**Nota**: Debes instalar {% data variables.product.prodname_cli %} para poder usar los comandos en los ejemplos de {% data variables.product.prodname_cli %}. A fin de obtener instrucciones de instalación, consulta el repositorio de [{% data variables.product.prodname_cli %}](https://github.com/cli/cli#installation).
|
||||
|
||||
{% endnote %}
|
||||
|
||||
If you are not already authenticated to {% data variables.product.prodname_cli %}, you must use the `gh auth login` subcommand to authenticate before making any requests. For more information, see "[Authenticating](#authenticating)."
|
||||
Si aún no estás autenticado en {% data variables.product.prodname_cli %}, debes usar el `gh auth login` subcomando para autenticarte antes de realizar solicitudes. Para más información, consulta "[Autenticación](#authenticating)".
|
||||
|
||||
To make a request using {% data variables.product.prodname_cli %}, use the `api` subcommand along with the path. Use the `--method` or `-X` flag to specify the method.
|
||||
Para realizar una solicitud con {% data variables.product.prodname_cli %}, usa el `api` subcomando junto con la ruta de acceso. Usa la marca `--method` o `-X` para especificar el método.
|
||||
|
||||
```shell
|
||||
gh api /octocat --method GET
|
||||
@@ -48,13 +53,13 @@ gh api /octocat --method GET
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note**: You must install and import `octokit` in order to use the Octokit.js library used in the JavaScript examples. For more information, see [the Octokit.js README](https://github.com/octokit/octokit.js/#readme).
|
||||
**Nota**: Debes instalar e importar `octokit` para usar la biblioteca de Octokit.js usada en los ejemplos de JavaScript. Para más información, consulta el [archivo README de Octokit.js](https://github.com/octokit/octokit.js/#readme).
|
||||
|
||||
{% endnote %}
|
||||
|
||||
To make a request using JavaScript, you can use Octokit.js. For more information, see [the Octokit.js README](https://github.com/octokit/octokit.js/#readme).
|
||||
Para realizar una solicitud mediante JavaScript, puedes usar Octokit.js. Para más información, consulta el [archivo README de Octokit.js](https://github.com/octokit/octokit.js/#readme).
|
||||
|
||||
First, create an instance of `Octokit`.{% ifversion ghes or ghae %} Set the base URL to `{% data variables.product.api_url_code %}`. Replace `[hostname]` with the name of {% data variables.location.product_location %}.{% endif %}
|
||||
En primer lugar, crea una instancia de `Octokit`.{% ifversion ghes or ghae %} y establece la dirección URL base en `{% data variables.product.api_url_code %}`. Reemplaza `[hostname]` por el nombre de host de {% data variables.location.product_location %}.{% endif %}
|
||||
|
||||
```javascript
|
||||
const octokit = new Octokit({ {% ifversion ghes or ghae %}
|
||||
@@ -62,7 +67,7 @@ const octokit = new Octokit({ {% ifversion ghes or ghae %}
|
||||
{% endif %}});
|
||||
```
|
||||
|
||||
Then, use the `request` method to make requests. Pass the HTTP method and path as the first argument.
|
||||
A continuación, usa el método `request` para realizar solicitudes. Pasa el método HTTP y la ruta de acceso como primer argumento.
|
||||
|
||||
```javascript
|
||||
await octokit.request("GET /octocat", {});
|
||||
@@ -72,9 +77,9 @@ await octokit.request("GET /octocat", {});
|
||||
|
||||
{% curl %}
|
||||
|
||||
Prepend the base URL for the {% data variables.product.prodname_dotcom %} REST API, `{% data variables.product.api_url_code %}`, to the path to get the full URL: `{% data variables.product.api_url_code %}/octocat`.{% ifversion ghes or ghae %} Replace `[hostname]` with the name of {% data variables.location.product_location %}.{% endif %}
|
||||
Antepón la dirección URL base para la API de REST de {% data variables.product.prodname_dotcom %}, `{% data variables.product.api_url_code %}`, a la ruta de acceso para obtener la dirección URL completa: `{% data variables.product.api_url_code %}/octocat`.{% ifversion ghes or ghae %} Reemplaza `[hostname]` por el nombre de {% data variables.location.product_location %}.{% endif %}
|
||||
|
||||
Use the `curl` command in your command line. Use the `--request` or `-X` flag followed by the HTTP method. Use the `--url` flag followed by the full URL.
|
||||
Usa el comando `curl` en la línea de comandos. Usa la marca `--request` o `-X` seguida del método HTTP. Use la marca `--url` seguida de la dirección URL completa.
|
||||
|
||||
```shell
|
||||
curl --request GET \
|
||||
@@ -83,39 +88,39 @@ curl --request GET \
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note**: If you get a message similar to "command not found: curl", you may need to download and install cURL. For more information, see [the cURL project download page](https://curl.se/download.html).
|
||||
**Nota**: Si recibes un mensaje similar al "comando no encontrado: curl", es posible que tengas que descargar e instalar cURL. Para obtener más información, consulta [la página de descarga del proyecto cURL](https://curl.se/download.html).
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% endcurl %}
|
||||
|
||||
Continue reading to learn how to authenticate, send parameters, and use the response.
|
||||
Sigue leyendo para aprender a autenticar, enviar parámetros y usar la respuesta.
|
||||
|
||||
## Authenticating
|
||||
## Autenticación
|
||||
|
||||
Many operations require authentication or return additional information if you are authenticated. Additionally, you can make more requests per hour when you are authenticated.{% cli %} Although some REST API operations are accessible without authentication, you must authenticate to {% data variables.product.prodname_cli %} in order to use the `api` subcommand.{% endcli %}
|
||||
Muchas operaciones requieren autenticación o devuelven información adicional si te autenticas. Además, puedes realizar más solicitudes por hora cuando te autentiques. {% cli %} Aunque se puede acceder a algunas operaciones de la API de REST sin autenticación, debes autenticarte en {% data variables.product.prodname_cli %} para poder usar el subcomando `api`.{% endcli %}
|
||||
|
||||
### About tokens
|
||||
### Acerca de los tokens
|
||||
|
||||
You can authenticate your request by adding a token.
|
||||
Puedes autenticar la solicitud agregando un token.
|
||||
|
||||
If you want to use the {% data variables.product.company_short %} REST API for personal use, you can create a {% data variables.product.pat_generic %}. The REST API operations used in this article require `repo` scope for {% data variables.product.pat_v1_plural %}{% ifversion pat-v2 %} or, unless otherwise noted, read-only access to public repositories for {% data variables.product.pat_v2 %}s{% endif %}. Other operations may require different scopes{% ifversion pat-v2%} or permissions{% endif %}. For more information about creating a {% data variables.product.pat_generic %}, see "[Creating a {% data variables.product.pat_generic %}](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)."
|
||||
Si deseas usar la API de REST de {% data variables.product.company_short %} para uso personal, puedes crear un {% data variables.product.pat_generic %}. Las operaciones de la API de REST usadas en este artículo requieren el ámbito `repo` para {% data variables.product.pat_v1_plural %}{% ifversion pat-v2 %} o, a menos que se indique lo contrario, acceso de solo lectura a repositorios públicos para los {% data variables.product.pat_v2 %}{% endif %}. Otras operaciones pueden requerir ámbitos diferentes{% ifversion pat-v2%} o permisos{% endif %}. Para obtener más información sobre la creación de un {% data variables.product.pat_generic %}, consulta "[Creación de un {% data variables.product.pat_generic %}](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)".
|
||||
|
||||
If you want to use the API on behalf of an organization or another user, {% data variables.product.company_short %} recommends that you use a {% data variables.product.prodname_github_app %}. If an operation is available to {% data variables.product.prodname_github_apps %}, the REST reference documentation for that operation will say "Works with GitHub Apps." The REST API operations used in this article require `issues` read and write permissions for {% data variables.product.prodname_github_apps %}. Other operations may require different permissions. For more information, see "[Creating a GitHub App](/developers/apps/building-github-apps/creating-a-github-app)", "[Authenticating with GitHub Apps](/developers/apps/building-github-apps/authenticating-with-github-apps), and "[Identifying and authorizing users for GitHub Apps](/developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps)."
|
||||
Si deseas usar la API en nombre de una organización u otro usuario, {% data variables.product.company_short %} recomienda usar un {% data variables.product.prodname_github_app %}. Si una operación está disponible para {% data variables.product.prodname_github_apps %}, la documentación de referencia de REST para esa operación dirá "Funciona con aplicaciones de GitHub". Las operaciones de la API de REST que se usan en este artículo requieren `issues` permisos de lectura y escritura para {% data variables.product.prodname_github_apps %}. Otras operaciones pueden requerir permisos diferentes. Para obtener más información, consulta "[Creación de una aplicación de GitHub](/developers/apps/building-github-apps/creating-a-github-app)", "[Autenticación con aplicaciones de GitHub](/developers/apps/building-github-apps/authenticating-with-github-apps)" e "[Identificación y autorización de usuarios para aplicaciones de GitHub](/developers/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps)".
|
||||
|
||||
If you want to use the API in a {% data variables.product.prodname_actions %} workflow, {% data variables.product.company_short %} recommends that you authenticate with the built-in `GITHUB_TOKEN` instead of creating a token. You can grant permissions to the `GITHUB_TOKEN` with the `permissions` key. For more information, see "[Automatic token authentication](/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)."
|
||||
Si deseas usar la API en un flujo de trabajo de {% data variables.product.prodname_actions %}, {% data variables.product.company_short %} recomienda autenticarse con el `GITHUB_TOKEN` integrado en lugar de crear un token. Puedes conceder permisos a `GITHUB_TOKEN` con la clave `permissions`. Para más información, vea "[Autenticación de token automática](/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)".
|
||||
|
||||
### Authentication example
|
||||
### Ejemplo de autenticación
|
||||
|
||||
{% cli %}
|
||||
|
||||
With {% data variables.product.prodname_cli %}, you don't need to create an access token in advance. Use the `auth login` subcommand to authenticate to {% data variables.product.prodname_cli %}:
|
||||
Con {% data variables.product.prodname_cli %}, no es necesario crear un token de acceso de antemano. Usa el subcomando `auth login` para autenticarte en {% data variables.product.prodname_cli %}:
|
||||
|
||||
```shell
|
||||
gh auth login
|
||||
```
|
||||
|
||||
You can use the `--scopes` flag to specify what scopes you want. If you want to authenticate with a token that you created, you can use the `--with-token` flag. For more information, see the [{% data variables.product.prodname_cli %} `auth login` documentation](https://cli.github.com/manual/gh_auth_login).
|
||||
Puedes usar la marca `--scopes` para especificar qué ámbitos deseas. Si deseas autenticarte con un token que hayas creado, puedes usar la marca `--with-token`. Para obtener más información, consulta la [documentación de `auth login`{% data variables.product.prodname_cli %}](https://cli.github.com/manual/gh_auth_login).
|
||||
|
||||
{% endcli %}
|
||||
|
||||
@@ -123,17 +128,17 @@ You can use the `--scopes` flag to specify what scopes you want. If you want to
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Warning**: Treat your access token like a password.
|
||||
**Advertencia**: trata el token de acceso igual que una contraseña.
|
||||
|
||||
To keep your token secure, you can store your token as a secret and run your script through {% data variables.product.prodname_actions %}. For more information, see "[Encrypted secrets](/actions/security-guides/encrypted-secrets)."
|
||||
Para proteger el token, puedes almacenar el token como secreto y ejecutar el script a través de {% data variables.product.prodname_actions %}. Para más información, vea "[Secretos cifrados](/actions/security-guides/encrypted-secrets)".
|
||||
|
||||
{% ifversion ghec or fpt %}You can also store your token as a {% data variables.product.prodname_codespaces %} secret and run your script in {% data variables.product.prodname_codespaces %}. For more information, see "[Managing encrypted secrets for your codespaces](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)."{% endif %}
|
||||
{% ifversion ghec or fpt %} También puedes almacenar el token como un secreto de {% data variables.product.prodname_codespaces %} y ejecutar el script en {% data variables.product.prodname_codespaces %}. Para más información, consulta "[Administración de secretos cifrados para los codespaces](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)"{% endif %}
|
||||
|
||||
If these options are not possible, consider using another service such as [the 1Password CLI](https://developer.1password.com/docs/cli/secret-references/) to store your token securely.
|
||||
Si estas opciones no son posibles, considera la posibilidad de usar otro servicio como [la CLI de 1Password](https://developer.1password.com/docs/cli/secret-references/) para almacenar el token de forma segura.
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
To authenticate with the Octokit.js library, you can pass your token when you create an instance of `Octokit`. Replace `YOUR-TOKEN` with your token.{% ifversion ghes or ghae %} Replace `[hostname]` with the name of {% data variables.location.product_location %}.{% endif %}
|
||||
Para autenticarte con la biblioteca de Octokit.js, puedes pasar el token al crear una instancia de `Octokit`. Reemplaza `YOUR-TOKEN` por el token.{% ifversion ghes or ghae %} Reemplaza `[hostname]` por el nombre de {% data variables.location.product_location %}.{% endif %}
|
||||
|
||||
```javascript
|
||||
const octokit = new Octokit({ {% ifversion ghes or ghae %}
|
||||
@@ -148,17 +153,17 @@ const octokit = new Octokit({ {% ifversion ghes or ghae %}
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Warning**: Treat your access token like a password.
|
||||
**Advertencia**: trata el token de acceso igual que una contraseña.
|
||||
|
||||
To help keep your account secure, you can use {% data variables.product.prodname_cli %} instead of cURL. {% data variables.product.prodname_cli %} will take care of authentication for you. For more information, see the {% data variables.product.prodname_cli %} version of this page.
|
||||
Para ayudar a proteger su cuenta, puedes usar {% data variables.product.prodname_cli %} en lugar de cURL. {% data variables.product.prodname_cli %} se encargará de la autenticación. Para obtener más información, consulta la versión de {% data variables.product.prodname_cli %} de esta página.
|
||||
|
||||
{% ifversion ghec or fpt %}You can also store your token as a {% data variables.product.prodname_codespaces %} secret and use the command line through {% data variables.product.prodname_codespaces %}. For more information, see "[Managing encrypted secrets for your codespaces](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)."{% endif %}
|
||||
{% ifversion ghec or fpt %} También puedes almacenar el token como un secreto de {% data variables.product.prodname_codespaces %} y usar la línea de comandos mediante {% data variables.product.prodname_codespaces %}. Para más información, consulta "[Administración de secretos cifrados para los codespaces](/codespaces/managing-your-codespaces/managing-encrypted-secrets-for-your-codespaces)"{% endif %}
|
||||
|
||||
If these options are not possible, consider using another service such as [the 1Password CLI](https://developer.1password.com/docs/cli/secret-references/) to store your token securely.
|
||||
Si estas opciones no son posibles, considera la posibilidad de usar otro servicio como [la CLI de 1Password](https://developer.1password.com/docs/cli/secret-references/) para almacenar el token de forma segura.
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
With cURL, you will send an `Authorization` header with your token. Replace `YOUR-TOKEN` with your token:
|
||||
Con cURL, enviarás un encabezado `Authorization` con el token. Reemplaza `YOUR-TOKEN` por tu token:
|
||||
|
||||
```shell
|
||||
curl --request GET \
|
||||
@@ -168,19 +173,19 @@ curl --request GET \
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** {% data reusables.getting-started.bearer-vs-token %}
|
||||
**Nota:** {% data reusables.getting-started.bearer-vs-token %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% endcurl %}
|
||||
|
||||
### Authentication example for {% data variables.product.prodname_actions %}
|
||||
### Ejemplo de autenticación para {% data variables.product.prodname_actions %}
|
||||
|
||||
{% cli %}
|
||||
|
||||
You can also use the `run` keyword to execute {% data variables.product.prodname_cli %} commands in your {% data variables.product.prodname_actions %} workflows. For more information, see "[Workflow syntax for GitHub Actions](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun)."
|
||||
También puedes usar la `run` palabra clave para ejecutar comandos {% data variables.product.prodname_cli %} en los flujos de trabajo de {% data variables.product.prodname_actions %}. Para más información, vea "[Sintaxis de flujo de trabajo para Acciones de GitHub](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun)".
|
||||
|
||||
Instead of using the `gh auth login` command, pass your token as an environment variable called `GH_TOKEN`. {% data variables.product.prodname_dotcom %} recommends that you authenticate with the built-in `GITHUB_TOKEN` instead of creating a token. If this is not possible, store your token as a secret and replace `GITHUB_TOKEN` in the example below with the name of your secret. For more information about `GITHUB_TOKEN`, see "[Automatic token authentication](/actions/security-guides/automatic-token-authentication)." For more information about secrets, see "[Encrypted secrets](/actions/security-guides/encrypted-secrets)."
|
||||
En lugar de usar el comando `gh auth login`, pasa el token como una variable de entorno denominada `GH_TOKEN`. {% data variables.product.prodname_dotcom %} recomienda autenticarse con el `GITHUB_TOKEN` integrado en lugar de crear un token. Si esto no es posible, almacena el token como secreto y reemplaza `GITHUB_TOKEN` en el ejemplo siguiente por el nombre del secreto. Para obtener más información sobre el `GITHUB_TOKEN`, consulta "[Autenticación de token automática](/actions/security-guides/automatic-token-authentication)". Para más información sobre los secretos, vea "[Secretos cifrados](/actions/security-guides/encrypted-secrets)".
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
@@ -198,18 +203,18 @@ jobs:
|
||||
|
||||
{% javascript %}
|
||||
|
||||
You can also use the `run` keyword to execute your JavaScript scripts in your {% data variables.product.prodname_actions %} workflows. For more information, see "[Workflow syntax for GitHub Actions](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun)."
|
||||
También puedes usar la palabra clave `run` para ejecutar los scripts de JavaScript en los flujos de trabajo de {% data variables.product.prodname_actions %}. Para más información, vea "[Sintaxis de flujo de trabajo para Acciones de GitHub](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun)".
|
||||
|
||||
{% data variables.product.prodname_dotcom %} recommends that you authenticate with the built-in `GITHUB_TOKEN` instead of creating a token. If this is not possible, store your token as a secret and replace `GITHUB_TOKEN` in the example below with the name of your secret. For more information about `GITHUB_TOKEN`, see "[Automatic token authentication](/actions/security-guides/automatic-token-authentication)." For more information about secrets, see "[Encrypted secrets](/actions/security-guides/encrypted-secrets)."
|
||||
{% data variables.product.prodname_dotcom %} recomienda autenticarse con el `GITHUB_TOKEN` integrado en lugar de crear un token. Si esto no es posible, almacena el token como secreto y reemplaza `GITHUB_TOKEN` en el ejemplo siguiente por el nombre del secreto. Para obtener más información sobre el `GITHUB_TOKEN`, consulta "[Autenticación de token automática](/actions/security-guides/automatic-token-authentication)". Para más información sobre los secretos, vea "[Secretos cifrados](/actions/security-guides/encrypted-secrets)".
|
||||
|
||||
The following example workflow:
|
||||
Observa el siguiente flujo de trabajo de ejemplo:
|
||||
|
||||
1. Checks out the repository content
|
||||
1. Sets up Node.js
|
||||
1. Installs `octokit`
|
||||
1. Stores the value of `GITHUB_TOKEN` as an environment variable called `TOKEN` and runs `.github/actions-scripts/use-the-api.mjs`, which can access that environment variable as `process.env.TOKEN`
|
||||
1. Comprueba el contenido del repositorio
|
||||
1. Configura Node.js
|
||||
1. Instala `octokit`
|
||||
1. Almacena el valor de `GITHUB_TOKEN` como una variable de entorno denominada `TOKEN` y ejecuta `.github/actions-scripts/use-the-api.mjs`, que puede tener acceso a esa variable de entorno como `process.env.TOKEN`
|
||||
|
||||
Example workflow:
|
||||
Ejemplo de flujo de trabajo:
|
||||
|
||||
```yaml
|
||||
on:
|
||||
@@ -238,7 +243,7 @@ jobs:
|
||||
node .github/actions-scripts/use-the-api.mjs
|
||||
```
|
||||
|
||||
Example JavaScript script, with the file path `.github/actions-scripts/use-the-api.mjs`:
|
||||
Script de JavaScript de ejemplo, con la ruta de acceso del archivo `.github/actions-scripts/use-the-api.mjs`:
|
||||
|
||||
```javascript
|
||||
import { Octokit } from "octokit";
|
||||
@@ -251,7 +256,7 @@ const octokit = new Octokit({ {% ifversion ghes or ghae %}
|
||||
await octokit.request("GET /octocat", {});
|
||||
```
|
||||
|
||||
Instead of storing your script in a separate file and executing the script from your workflow, you can use the `actions/github-script` action to run a script. For more information, see the [actions/github-script README](https://github.com/actions/github-script).
|
||||
En lugar de almacenar el script en un archivo independiente y ejecutar el script desde el flujo de trabajo, puedes usar la acción `actions/github-script` para ejecutar un script. Para más información, consulta [el archivo README actions/github-script](https://github.com/actions/github-script).
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
@@ -270,9 +275,9 @@ jobs:
|
||||
|
||||
{% curl %}
|
||||
|
||||
You can also use the `run` keyword to execute cURL commands in your {% data variables.product.prodname_actions %} workflows. For more information, see "[Workflow syntax for GitHub Actions](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun)."
|
||||
También puedes usar la palabra clave `run` para ejecutar comandos cURL en los flujos de trabajo de {% data variables.product.prodname_actions %}. Para más información, vea "[Sintaxis de flujo de trabajo para Acciones de GitHub](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun)".
|
||||
|
||||
{% data variables.product.prodname_dotcom %} recommends that you authenticate with the built-in `GITHUB_TOKEN` instead of creating a token. If this is not possible, store your token as a secret and replace `GITHUB_TOKEN` in the example below with the name of your secret. For more information about `GITHUB_TOKEN`, see "[Automatic token authentication](/actions/security-guides/automatic-token-authentication)." For more information about secrets, see "[Encrypted secrets](/actions/security-guides/encrypted-secrets)."
|
||||
{% data variables.product.prodname_dotcom %} recomienda autenticarse con el `GITHUB_TOKEN` integrado en lugar de crear un token. Si esto no es posible, almacena el token como secreto y reemplaza `GITHUB_TOKEN` en el ejemplo siguiente por el nombre del secreto. Para obtener más información sobre el `GITHUB_TOKEN`, consulta "[Autenticación de token automática](/actions/security-guides/automatic-token-authentication)". Para más información sobre los secretos, vea "[Secretos cifrados](/actions/security-guides/encrypted-secrets)".
|
||||
|
||||
```yaml
|
||||
jobs:
|
||||
@@ -290,13 +295,13 @@ jobs:
|
||||
|
||||
{% endcurl %}
|
||||
|
||||
## Using headers
|
||||
## Uso de encabezados
|
||||
|
||||
Most operations specify that you should pass an `Accept` header with a value of `application/vnd.github+json`. Other operations may specify that you should send a different `Accept` header or additional headers.
|
||||
La mayoría de las operaciones especifican que debes pasar un encabezado `Accept` con un valor de `application/vnd.github+json`. Otras operaciones pueden especificar que debes enviar un encabezado `Accept` diferente o encabezados adicionales.
|
||||
|
||||
{% cli %}
|
||||
|
||||
To send a header with {% data variables.product.prodname_cli %}, use the `--header` or `-H` flag followed by the header in `key: value` format.
|
||||
Para enviar un encabezado con datos {% data variables.product.prodname_cli %}, usa la marca `--header` o `-H` seguida del encabezado en formato `key: value`.
|
||||
|
||||
```shell
|
||||
gh api --header 'Accept: application/vnd.github+json'{% ifversion api-date-versioning %} --header 'X-GitHub-Api-Version:{{ allVersions[currentVersion].latestApiVersion }}'{% endif %} --method GET /octocat
|
||||
@@ -306,7 +311,7 @@ gh api --header 'Accept: application/vnd.github+json'{% ifversion api-date-versi
|
||||
|
||||
{% javascript %}
|
||||
|
||||
The Octokit.js library automatically passes the `Accept: application/vnd.github+json` header. To pass additional headers or a different `Accept` header, add a `headers` property to the object that is passed as a second argument to the `request` method. The value of the `headers` property is an object with the header names as keys and header values as values. For example, to send a `content-type` header with a value of `text/plain`:
|
||||
La biblioteca de Octokit.js pasa automáticamente el encabezado `Accept: application/vnd.github+json`. Para pasar encabezados `Accept` adicionales o un encabezado diferente, agrega una propiedad `headers` al objeto que se pasa como segundo argumento al método `request`. El valor de la propiedad `headers` es un objeto con los nombres de encabezado como claves y valores de encabezado como valores. Por ejemplo, para enviar un encabezado `content-type` con un valor de `text/plain`:
|
||||
|
||||
```javascript
|
||||
await octokit.request("GET /octocat", {
|
||||
@@ -321,7 +326,7 @@ await octokit.request("GET /octocat", {
|
||||
|
||||
{% curl %}
|
||||
|
||||
To send a header with cURL, use the `--header` or `-H` flag followed by the header in `key: value` format.
|
||||
Para enviar un encabezado con cURL, usa la marca `--header` o `-H` seguida del encabezado en formato `key: value`.
|
||||
|
||||
```shell
|
||||
curl --request GET \
|
||||
@@ -333,21 +338,19 @@ curl --request GET \
|
||||
|
||||
{% endcurl %}
|
||||
|
||||
## Using path parameters
|
||||
## Uso de parámetros de la ruta de acceso
|
||||
|
||||
Path parameters modify the operation path. For example, the "List repository issues" path is `/repos/{owner}/{repo}/issues`. The curly brackets `{}` denote path parameters that you need to specify. In this case, you must specify the repository owner and name. For the reference documentation for this operation, see "[List repository issues](/rest/issues/issues#list-repository-issues)."
|
||||
Los parámetros de ruta de acceso modifican la ruta de acceso de la operación. Por ejemplo, la ruta de acceso "Enumerar propuestas del repositorio" es `/repos/{owner}/{repo}/issues`. Los corchetes de curly indican parámetros de ruta de acceso `{}` que debes especificar. En este caso, debes especificar el propietario y el nombre del repositorio. Para obtener la documentación de referencia de esta operación, consulta "[Enumerar propuestas del repositorio](/rest/issues/issues#list-repository-issues)".
|
||||
|
||||
{% cli %}
|
||||
|
||||
{% ifversion ghes or ghae %}
|
||||
{% note %}
|
||||
{% ifversion ghes or ghae %} {% note %}
|
||||
|
||||
**Note:** In order for this command to work for {% data variables.location.product_location %}, replace `octocat/Spoon-Knife` with a repository owned by {% data variables.location.product_location %}. Otherwise, rerun the `gh auth login` command to authenticate to {% data variables.product.prodname_dotcom_the_website %} instead of {% data variables.location.product_location %}.
|
||||
**Nota:** Para que este comando funcione con {% data variables.location.product_location %}, reemplaza `octocat/Spoon-Knife` por un repositorio propiedad de {% data variables.location.product_location %}. De lo contrario, vuelve a ejecutar el comando `gh auth login` para autenticarte en {% data variables.product.prodname_dotcom_the_website %} en lugar de {% data variables.location.product_location %}.
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
{% endnote %} {% endif %}
|
||||
|
||||
To get issues from the `octocat/Spoon-Knife` repository, replace `{owner}` with `octocat` and `{repo}` with `Spoon-Knife`.
|
||||
Para obtener propuestas del repositorio `octocat/Spoon-Knife`, reemplaza `{owner}` por `octocat` y `{repo}` por `Spoon-Knife`.
|
||||
|
||||
```shell
|
||||
gh api --header 'Accept: application/vnd.github+json' --method GET /repos/octocat/Spoon-Knife/issues
|
||||
@@ -357,15 +360,13 @@ gh api --header 'Accept: application/vnd.github+json' --method GET /repos/octoca
|
||||
|
||||
{% javascript %}
|
||||
|
||||
{% ifversion ghes or ghae %}
|
||||
{% note %}
|
||||
{% ifversion ghes or ghae %} {% note %}
|
||||
|
||||
**Note:** In order for this example to work for {% data variables.location.product_location %}, replace `octocat/Spoon-Knife` with a repository owned by {% data variables.location.product_location %}. Otherwise, create a new `Octokit` instance and do not specify `baseURL`.
|
||||
**Nota:** Para que este ejemplo funcione con {% data variables.location.product_location %}, reemplaza `octocat/Spoon-Knife` por un repositorio propiedad de {% data variables.location.product_location %}. De lo contrario, crea una nueva instancia `Octokit` y no especifiques `baseURL`.
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
{% endnote %} {% endif %}
|
||||
|
||||
When you make a request with Octokit.js, all parameters, including path parameters, are passed in an object as the second argument to the `request` method. To get issues from the `octocat/Spoon-Knife` repository, specify `owner` as `octocat` and `repo` as `Spoon-Knife`.
|
||||
Al realizar una solicitud con Octokit.js, todos los parámetros, incluidos los parámetros de ruta de acceso, se pasan en un objeto como segundo argumento al método `request`. Para obtener propuestas del repositorio `octocat/Spoon-Knife`, especifica `owner` como `octocat` y `repo` como `Spoon-Knife`.
|
||||
|
||||
```javascript
|
||||
await octokit.request("GET /repos/{owner}/{repo}/issues", {
|
||||
@@ -378,15 +379,13 @@ await octokit.request("GET /repos/{owner}/{repo}/issues", {
|
||||
|
||||
{% curl %}
|
||||
|
||||
To get issues from the `octocat/Spoon-Knife` repository, replace `{owner}` with `octocat` and `{repo}` with `Spoon-Knife`. To build the full path, prepend the base URL for the {% data variables.product.prodname_dotcom %} REST API, `https://api.github.com`: `https://api.github.com/repos/octocat/Spoon-Knife/issues`.
|
||||
Para obtener propuestas del repositorio `octocat/Spoon-Knife`, reemplaza `{owner}` por `octocat` y `{repo}` por `Spoon-Knife`. Para compilar la ruta de acceso completa, antepon la dirección URL base para la API de REST {% data variables.product.prodname_dotcom %} REST API, `https://api.github.com`: `https://api.github.com/repos/octocat/Spoon-Knife/issues`.
|
||||
|
||||
{% ifversion ghes or ghae %}
|
||||
{% note %}
|
||||
{% ifversion ghes or ghae %} {% note %}
|
||||
|
||||
**Note:** If you want to use {% data variables.location.product_location %} instead of {% data variables.product.prodname_dotcom_the_website %}, use `{% data variables.product.api_url_code %}` instead of `https://api.github.com` and replace `[hostname]` with the name of {% data variables.location.product_location %}. Replace `octocat/Spoon-Knife` with a repository owned by {% data variables.location.product_location %}.
|
||||
**Nota:** Si deseas usar {% data variables.location.product_location %} en lugar de {% data variables.product.prodname_dotcom_the_website %}, usa `{% data variables.product.api_url_code %}` en vez de `https://api.github.com` y reemplaza `[hostname]` por el nombre de {% data variables.location.product_location %}. Reemplaza `octocat/Spoon-Knife` por un repositorio propiedad de {% data variables.location.product_location %}.
|
||||
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
{% endnote %} {% endif %}
|
||||
|
||||
```shell
|
||||
curl --request GET \
|
||||
@@ -397,21 +396,21 @@ curl --request GET \
|
||||
|
||||
{% endcurl %}
|
||||
|
||||
The operation returns a list of issues and data about each issue. For more information about using the response, see the "[Using the response](#using-the-response)" section.
|
||||
La operación devuelve una lista de propuestas y datos sobre cada una de ellas. Para obtener más información sobre el uso de la respuesta, consulta la sección "[Uso de la respuesta](#using-the-response)".
|
||||
|
||||
## Using query parameters
|
||||
## Uso de los parámetros de consulta
|
||||
|
||||
Query parameters allow you to control what data is returned for a request. For example, a query parameter may let you specify how many items are returned when the response is paginated.
|
||||
Los parámetros de consulta permiten controlar qué datos se devuelven para una solicitud. Por ejemplo, un parámetro de consulta puede permitirte especificar cuántos elementos se devuelven cuando se pagina la respuesta.
|
||||
|
||||
By default, the "List repository issues" operation returns thirty issues, sorted in descending order by the date they were created. You can use the `per_page` parameter to return two issues instead of 30. You can use the `sort` parameter to sort the issues by the date they were last updated instead of by the date they were created. You can use the `direction` parameter to sort the results in ascending order instead of descending order.
|
||||
De forma predeterminada, la operación "Enumerar propuestas del repositorio" devuelve treinta propuestas, ordenados en orden descendente por la fecha en que se crearon. Puedes usar el parámetro `per_page` para devolver dos propuestas en lugar de 30. Puedes usar el parámetro `sort` para ordenar las propuestas por la fecha en que se actualizaron por última vez en lugar de por la fecha en que se crearon. Puedes usar el parámetro `direction` para ordenar los resultados en orden ascendente en lugar de en orden descendente.
|
||||
|
||||
{% cli %}
|
||||
|
||||
For {% data variables.product.prodname_cli %}, use the `-F` flag to pass a parameter that is a number, Boolean, or null. Use `-f` to pass string parameters.
|
||||
Para {% data variables.product.prodname_cli %}, usa la marca `-F` para pasar un parámetro que sea un número, booleano o null. Usa `-f` para pasar parámetros de cadena.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note**: {% data variables.product.prodname_cli %} does not currently accept parameters that are arrays. For more information, see [this issue](https://github.com/cli/cli/issues/1484).
|
||||
**Nota**: {% data variables.product.prodname_cli %} no acepta actualmente parámetros que son matrices. Para más información, consulta [esta propuesta](https://github.com/cli/cli/issues/1484).
|
||||
|
||||
{% endnote %}
|
||||
|
||||
@@ -423,7 +422,7 @@ gh api --header 'Accept: application/vnd.github+json' --method GET /repos/octoca
|
||||
|
||||
{% javascript %}
|
||||
|
||||
When you make a request with Octokit.js, all parameters, including query parameters, are passed in an object as the second argument to the `request` method.
|
||||
Al realizar una solicitud con Octokit.js, todos los parámetros, incluidos los parámetros de ruta de acceso, se pasan en un objeto como segundo argumento al método `request`.
|
||||
|
||||
```javascript
|
||||
await octokit.request("GET /repos/{owner}/{repo}/issues", {
|
||||
@@ -439,7 +438,7 @@ await octokit.request("GET /repos/{owner}/{repo}/issues", {
|
||||
|
||||
{% curl %}
|
||||
|
||||
For cURL, add a `?` to the end of the path, then append your query parameter name and value in the form `parameter_name=value`. Separate multiple query parameters with `&`.
|
||||
Para cURL, agrega un `?` al final de la ruta de acceso y, a continuación, anexa el nombre y el valor del parámetro del parámetro con el formato `parameter_name=value`. Separa varios parámetros de consulta con `&`.
|
||||
|
||||
```shell
|
||||
curl --request GET \
|
||||
@@ -450,21 +449,21 @@ curl --request GET \
|
||||
|
||||
{% endcurl %}
|
||||
|
||||
The operation returns a list of issues and data about each issue. For more information about using the response, see the "[Using the response](#using-the-response)" section.
|
||||
La operación devuelve una lista de propuestas y datos sobre cada una de ellas. Para obtener más información sobre el uso de la respuesta, consulta la sección "[Uso de la respuesta](#using-the-response)".
|
||||
|
||||
## Using body parameters
|
||||
## Uso de parámetros del cuerpo
|
||||
|
||||
Body parameters allow you to pass additional data to the API. For example, the "Create an issue" operation requires you to specify a title for the new issue. It also lets you specify other information, such as text to put in the issue body. For the full reference documentation for this operation, see "[Create an issue](/rest/issues/issues#create-an-issue)."
|
||||
Los parámetros de cuerpo permiten pasar datos adicionales a la API. Por ejemplo, la operación "Crear una propuesta" requiere que especifiques un título para la nueva propuesta. También te permite especificar otra información, como el texto que se va a colocar en el cuerpo de la propuesta. Para obtener la documentación de referencia completa de esta operación, consulta "[Crear una propuesta](/rest/issues/issues#create-an-issue)".
|
||||
|
||||
The "Create an issue" operation uses the same path as the "List repository issues" operation in the examples above, but it uses a `POST` method instead of a `GET` method.
|
||||
La operación "Crear una propuesta" usa la misma ruta de acceso que la operación "Enumerar propuestas del repositorio" en los ejemplos anteriores, pero usa un método `POST` en lugar de un método `GET`.
|
||||
|
||||
{% cli %}
|
||||
|
||||
For {% data variables.product.prodname_cli %}, use the `-F` flag to pass a parameter that is a number, Boolean, or null. Use `-f` to pass string parameters.
|
||||
Para {% data variables.product.prodname_cli %}, usa la marca `-F` para pasar un parámetro que sea un número, booleano o null. Usa `-f` para pasar parámetros de cadena.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note**: {% data variables.product.prodname_cli %} does not currently accept parameters that are arrays. For more information, see [this issue](https://github.com/cli/cli/issues/1484).
|
||||
**Nota**: {% data variables.product.prodname_cli %} no acepta actualmente parámetros que son matrices. Para más información, consulta [esta propuesta](https://github.com/cli/cli/issues/1484).
|
||||
|
||||
{% endnote %}
|
||||
|
||||
@@ -480,13 +479,13 @@ gh api --header 'Accept: application/vnd.github+json' --method POST /repos/octoc
|
||||
|
||||
{% note %}
|
||||
|
||||
If you are using a {% data variables.product.pat_v2 %}, you must replace `octocat/Spoon-Knife` with a repository that you own or that is owned by an organization that you are a member of. Your token must have access to that repository and have read and write permissions for repository issues. For more information about creating a repository, see "[Create a repo](/get-started/quickstart/create-a-repo)." For more information about granting access and permissions to a {% data variables.product.pat_v2 %}, see "[Creating a {% data variables.product.pat_generic %}](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)."
|
||||
Si usas un {% data variables.product.pat_v2 %}, debes reemplazar un repositorio que poseas o que pertenezca a una organización de la que es miembro por `octocat/Spoon-Knife`. El token debe tener acceso a ese repositorio y tener permisos de lectura y escritura para problemas de repositorio. Para más información sobre cómo crear un repositorio, consulta "[Creación de un repositorio](/get-started/quickstart/create-a-repo)". Para más información sobre cómo conceder acceso y permisos a un {% data variables.product.pat_v2 %}, consulta "[Creación de un {% data variables.product.pat_generic %}](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
When you make a request with Octokit.js, all parameters, including body parameters, are passed in an object as the second argument to the `request` method.
|
||||
Al realizar una solicitud con Octokit.js, todos los parámetros, incluidos los parámetros de cuerpo, se pasan en un objeto como segundo argumento al método `request`.
|
||||
|
||||
```javascript
|
||||
await octokit.request("POST /repos/{owner}/{repo}/issues", {
|
||||
@@ -505,13 +504,13 @@ await octokit.request("POST /repos/{owner}/{repo}/issues", {
|
||||
|
||||
{% note %}
|
||||
|
||||
If you are using a {% data variables.product.pat_v2 %}, you must replace `octocat/Spoon-Knife` with a repository that you own or that is owned by an organization that you are a member of. Your token must have access to that repository and have read and write permissions for repository issues. For more information about creating a repository, see "[Create a repo](/get-started/quickstart/create-a-repo)." For more information about granting access and permissions to a {% data variables.product.pat_v2 %}, see "[Creating a {% data variables.product.pat_generic %}](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)."
|
||||
Si usas un {% data variables.product.pat_v2 %}, debes reemplazar un repositorio que poseas o que pertenezca a una organización de la que es miembro por `octocat/Spoon-Knife`. El token debe tener acceso a ese repositorio y tener permisos de lectura y escritura para problemas de repositorio. Para más información sobre cómo crear un repositorio, consulta "[Creación de un repositorio](/get-started/quickstart/create-a-repo)". Para más información sobre cómo conceder acceso y permisos a un {% data variables.product.pat_v2 %}, consulta "[Creación de un {% data variables.product.pat_generic %}](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
For cURL, use the `--data` flag to pass the body parameters in a JSON object.
|
||||
Para cURL, usa la marca `--data` para pasar los parámetros del cuerpo a un objeto JSON.
|
||||
|
||||
```shell
|
||||
curl --request POST \
|
||||
@@ -526,27 +525,27 @@ curl --request POST \
|
||||
|
||||
{% endcurl %}
|
||||
|
||||
The operation creates an issue and returns data about the new issue. In the response, find the `html_url` of your issue and navigate to your issue in the browser. For more information about using the response, see the "[Using the response](#using-the-response)" section.
|
||||
La operación crea una propuesta y devuelve datos sobre la nueva propuesta. En la respuesta, busca el valor `html_url` de tu propuesta y consúltala en el explorador. Para obtener más información sobre el uso de la respuesta, consulta la sección "[Uso de la respuesta](#using-the-response)".
|
||||
|
||||
## Using the response
|
||||
## Análisis de la respuesta
|
||||
|
||||
### About the response code and headers
|
||||
### Acerca del código de respuesta y los encabezados
|
||||
|
||||
Every request will return an HTTP status code that indicates the success of the response. For more information about response codes, see [the MDN HTTP response status code documentation](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status).
|
||||
Cada solicitud devolverá un código de estado HTTP que indica el éxito de la respuesta. Para obtener más información sobre los códigos de respuesta, consulta [la documentación del código de estado de respuesta HTTP de MDN](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status).
|
||||
|
||||
Additionally, the response will include headers that give more details about the response. Headers that start with `X-` or `x-` are custom to {% data variables.product.company_short %}. For example, the `x-ratelimit-remaining` and `x-ratelimit-reset` headers tell you how many requests you can make in a time period.
|
||||
Además, la respuesta incluirá encabezados que proporcionan más detalles sobre la respuesta. Los encabezados que comienzan por `X-` o `x-` son personalizados para {% data variables.product.company_short %}. Por ejemplo, los encabezados `x-ratelimit-remaining` y `x-ratelimit-reset` indican cuántas solicitudes puede realizar en un período de tiempo.
|
||||
|
||||
{% cli %}
|
||||
|
||||
To view the status code and headers, use the `--include` or `--i` flag when you send your request.
|
||||
Para ver el código de estado y los encabezados, usa la marca `--include` o `--i` al enviar la solicitud.
|
||||
|
||||
For example, this request:
|
||||
Por ejemplo, en esta solicitud:
|
||||
|
||||
```shell
|
||||
gh api --header 'Accept: application/vnd.github+json' --method GET /repos/octocat/Spoon-Knife/issues -F per_page=2 --include
|
||||
```
|
||||
|
||||
returns the response code and headers like:
|
||||
devuelve el código de respuesta y los encabezados como:
|
||||
|
||||
```shell
|
||||
HTTP/2.0 200 OK
|
||||
@@ -578,15 +577,15 @@ X-Ratelimit-Used: 4
|
||||
X-Xss-Protection: 0
|
||||
```
|
||||
|
||||
In this example, the response code is `200`, which indicates a successful request.
|
||||
En este ejemplo, el código de respuesta es `200`, que indica una solicitud correcta.
|
||||
|
||||
{% endcli %}
|
||||
|
||||
{% javascript %}
|
||||
|
||||
When you make a request with Octokit.js, the `request` method returns a promise. If the request was successful, the promise resolves to an object that includes the HTTP status code of the response (`status`) and the response headers (`headers`). If an error occurs, the promise resolves to an object that includes the HTTP status code of the response (`status`) and the response headers (`response.headers`).
|
||||
Al realizar una solicitud con Octokit.js, el método `request` devuelve una promesa. Si la solicitud se realizó correctamente, la promesa se resuelve en un objeto que incluye el código de estado HTTP de la respuesta (`status`) y los encabezados de respuesta (`headers`). En caso de error, la promesa se resuelve en un objeto que incluye el código de estado HTTP de la respuesta (`status`) y los encabezados de respuesta (`response.headers`).
|
||||
|
||||
You can use a `try/catch` block to catch an error if it occurs. For example, if the request in the following script is successful, the script will log the status code and the value of the `x-ratelimit-remaining` header. If the request was not successful, the script will log the status code, the value of the `x-ratelimit-remaining` header, and the error message.
|
||||
Puedes usar un bloque `try/catch` para detectar un error si se produce. Por ejemplo, si la solicitud del script siguiente se realiza correctamente, el script registrará el código de estado y el valor del encabezado `x-ratelimit-remaining`. Si la solicitud no se realizó correctamente, el script registrará el código de estado, el valor del encabezado `x-ratelimit-remaining` y el mensaje de error.
|
||||
|
||||
```javascript
|
||||
try {
|
||||
@@ -607,9 +606,9 @@ try {
|
||||
|
||||
{% curl %}
|
||||
|
||||
To view the status code and headers, use the `--include` or `--i` flag when you send your request.
|
||||
Para ver el código de estado y los encabezados, usa la marca `--include` o `--i` al enviar la solicitud.
|
||||
|
||||
For example, this request:
|
||||
Por ejemplo, en esta solicitud:
|
||||
|
||||
```shell
|
||||
curl --request GET \
|
||||
@@ -619,7 +618,7 @@ curl --request GET \
|
||||
--include
|
||||
```
|
||||
|
||||
returns the response code and headers like:
|
||||
devuelve el código de respuesta y los encabezados como:
|
||||
|
||||
```shell
|
||||
HTTP/2 200
|
||||
@@ -649,13 +648,13 @@ content-length: 4936
|
||||
x-github-request-id: 14E0:4BC6:F1B8BA:208E317:62EC2715
|
||||
```
|
||||
|
||||
In this example, the response code is `200`, which indicates a successful request.
|
||||
En este ejemplo, el código de respuesta es `200`, que indica una solicitud correcta.
|
||||
|
||||
{% endcurl %}
|
||||
|
||||
### About the response body
|
||||
### Acerca del cuerpo de la respuesta
|
||||
|
||||
Many operations will return a response body. Unless otherwise specified, the response body is in JSON format. For example, this request returns a list of issues with data about each issue:
|
||||
Muchas operaciones devolverán un cuerpo de respuesta. A menos que se especifique lo contrario, el cuerpo de la respuesta está en formato JSON. Por ejemplo, esta solicitud devuelve una lista de propuestas con datos sobre cada propuesta:
|
||||
|
||||
{% cli %}
|
||||
|
||||
@@ -688,23 +687,23 @@ curl --request GET \
|
||||
|
||||
{% endcurl %}
|
||||
|
||||
Unlike the GraphQL API where you specify what information you want, the REST API typically returns more information than you need. If desired, you can parse the response to pull out specific pieces of information.
|
||||
A diferencia de GraphQL API donde se especifica la información que deseas, la API de REST normalmente devuelve más información de la que necesitas. Si lo deseas, puedes analizar la respuesta para extraer fragmentos de información específicos.
|
||||
|
||||
{% cli %}
|
||||
|
||||
For example, you can use `>` to redirect the response to a file:
|
||||
Por ejemplo, puedes usar `>` para redirigir la respuesta a un archivo:
|
||||
|
||||
```shell
|
||||
gh api --header 'Accept: application/vnd.github+json' --method GET /repos/octocat/Spoon-Knife/issues -F per_page=2 > data.json
|
||||
```
|
||||
|
||||
Then you can use jq to get the title and author ID of each issue:
|
||||
A continuación, puedes usar jq para obtener el título y el identificador de autor de cada propuesta:
|
||||
|
||||
```shell
|
||||
jq '.[] | {title: .title, authorID: .user.id}' data.json
|
||||
```
|
||||
|
||||
The previous two commands return something like:
|
||||
Los dos comandos anteriores devuelven algo parecido a:
|
||||
|
||||
```
|
||||
{
|
||||
@@ -717,13 +716,13 @@ The previous two commands return something like:
|
||||
}
|
||||
```
|
||||
|
||||
For more information about jq, see [the jq documentation](https://stedolan.github.io/jq/) and [jq play](https://jqplay.org/).
|
||||
Para obtener más información sobre jq, consulta [la documentación de jq](https://stedolan.github.io/jq/) y [jq play](https://jqplay.org/).
|
||||
|
||||
{% endcli %}
|
||||
|
||||
{% javascript %}
|
||||
|
||||
For example, you can get the title and author ID of each issue:
|
||||
Por ejemplo, puedes obtener el título y el identificador de autor de cada propuesta:
|
||||
|
||||
```javascript
|
||||
try {
|
||||
@@ -746,7 +745,7 @@ try {
|
||||
|
||||
{% curl %}
|
||||
|
||||
For example, you can use `>` to redirect the response to a file:
|
||||
Por ejemplo, puedes usar `>` para redirigir la respuesta a un archivo:
|
||||
|
||||
```shell
|
||||
curl --request GET \
|
||||
@@ -755,13 +754,13 @@ curl --request GET \
|
||||
--header "Authorization: Bearer YOUR-TOKEN" > data.json
|
||||
```
|
||||
|
||||
Then you can use jq to get the title and author ID of each issue:
|
||||
A continuación, puedes usar jq para obtener el título y el identificador de autor de cada propuesta:
|
||||
|
||||
```shell
|
||||
jq '.[] | {title: .title, authorID: .user.id}' data.json
|
||||
```
|
||||
|
||||
The previous two commands return something like:
|
||||
Los dos comandos anteriores devuelven algo parecido a:
|
||||
|
||||
```
|
||||
{
|
||||
@@ -774,12 +773,12 @@ The previous two commands return something like:
|
||||
}
|
||||
```
|
||||
|
||||
For more information about jq, see [the jq documentation](https://stedolan.github.io/jq/) and [jq play](https://jqplay.org/).
|
||||
Para obtener más información sobre jq, consulta [la documentación de jq](https://stedolan.github.io/jq/) y [jq play](https://jqplay.org/).
|
||||
|
||||
{% endcurl %}
|
||||
|
||||
## Next steps
|
||||
## Pasos siguientes
|
||||
|
||||
This article demonstrated how to list and create issues in a repository. For more practice, try to comment on an issue, edit the title of an issue, or close an issue. For more information about these operations, see "[Create an issue comment](/rest/issues#create-an-issue-comment)" and "[Update an issue](/rest/issues/issues#update-an-issue)."
|
||||
En este artículo se ha mostrado cómo enumerar y crear propuestas en un repositorio. Para más práctica, intenta comentar una propuesta, edita el título de una propuesta o cierra una propuesta. Para obtener más información sobre estas operaciones, consulta "[Crear un comentario de propuesta](/rest/issues#create-an-issue-comment)" y "[Actualizar una propuesta](/rest/issues/issues#update-an-issue)".
|
||||
|
||||
For more information about the operations that you can use, see the [REST reference documentation](/rest).
|
||||
Para obtener más información sobre las operaciones que puedes usar, consulta la [documentación de referencia de REST](/rest).
|
||||
|
||||
@@ -5,12 +5,12 @@ versions:
|
||||
feature: pat-v2
|
||||
miniTocMaxHeadingLevel: 3
|
||||
shortTitle: '{% data variables.product.pat_v2_caps %} permissions'
|
||||
ms.openlocfilehash: 97154c54229f66f3a6b3bf852f7aabab89a0d2ee
|
||||
ms.sourcegitcommit: f638d569cd4f0dd6d0fb967818267992c0499110
|
||||
ms.openlocfilehash: 46a82b0212d4cda2b6883c0b33ba2acb2e50b9d0
|
||||
ms.sourcegitcommit: d2f0b59ed096b9e68ef8f6fa019cd925165762ec
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 10/25/2022
|
||||
ms.locfileid: '148107689'
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148184216'
|
||||
---
|
||||
## Acerca de los permisos necesarios para los {% data variables.product.pat_v2 %}
|
||||
|
||||
@@ -65,11 +65,10 @@ Cuando se crea un {% data variables.product.pat_v2 %}, se le concede un conjunto
|
||||
- [`PUT /orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}`](/rest/reference/teams/#add-or-update-team-repository-permissions) (escritura)
|
||||
- [`DELETE /orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}`](/rest/reference/teams/#remove-a-repository-from-a-team) (escritura)
|
||||
- [`POST /orgs/{org}/repos`](/rest/reference/repos#create-an-organization-repository) (escritura)
|
||||
- [`PATCH /repos/{owner}/{repo}`](/rest/reference/repos/#update-a-repository) (escritura)
|
||||
- [`PATCH /repos/{owner}/{repo}`](/rest/repos/repos#update-a-repository) (escritura)
|
||||
- [`DELETE /repos/{owner}/{repo}`](/rest/reference/repos#delete-a-repository) (escritura)
|
||||
- [`POST /repos/{owner}/{repo}/forks`](/rest/reference/repos#create-a-fork) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/teams`](/rest/reference/repos#list-repository-teams) (lectura)
|
||||
- [`POST /repos/{owner}/{repo}/transfer`](/rest/reference/repos#transfer-a-repository) (escritura)
|
||||
- [`POST /user/repos`](/rest/reference/repos#create-a-repository-for-the-authenticated-user) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/actions/permissions`](/rest/reference/actions#get-github-actions-permissions-for-a-repository) (lectura)
|
||||
- [`PUT /repos/{owner}/{repo}/actions/permissions`](/rest/reference/actions#set-github-actions-permissions-for-a-repository) (escritura)
|
||||
@@ -130,16 +129,6 @@ Cuando se crea un {% data variables.product.pat_v2 %}, se le concede un conjunto
|
||||
|
||||
## Comprobaciones
|
||||
|
||||
- [`POST /repos/{owner}/{repo}/check-runs`](/rest/reference/checks#create-a-check-run) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/check-runs/{check_run_id}`](/rest/reference/checks#get-a-check-run) (lectura)
|
||||
- [`PATCH /repos/{owner}/{repo}/check-runs/{check_run_id}`](/rest/reference/checks#update-a-check-run) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/check-runs/{check_run_id}/annotations`](/rest/reference/checks#list-check-run-annotations) (lectura)
|
||||
- [`POST /repos/{owner}/{repo}/check-runs/{check_run_id}/rerequest`](/rest/reference/checks#rerequest-a-check-run) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/check-suites/{check_suite_id}/check-runs`](/rest/reference/checks#list-check-runs-in-a-check-suite) (lectura)
|
||||
- [`POST /repos/{owner}/{repo}/check-suites`](/rest/reference/checks#create-a-check-suite) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/check-suites/{check_suite_id}`](/rest/reference/checks#get-a-check-suite) (lectura)
|
||||
- [`POST /repos/{owner}/{repo}/check-suites/{check_suite_id}/rerequest`](/rest/reference/checks#rerequest-a-check-suite) (escritura)
|
||||
- [`PATCH /repos/{owner}/{repo}/check-suites/preferences`](/rest/reference/checks#update-repository-preferences-for-check-suites) (escritura)
|
||||
- [`POST /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments`](/rest/reference/actions#review-pending-deployments-for-a-workflow-run) (lectura)
|
||||
|
||||
## Codespaces
|
||||
@@ -196,20 +185,12 @@ Cuando se crea un {% data variables.product.pat_v2 %}, se le concede un conjunto
|
||||
- [`POST /repos/{owner}/{repo}/git/refs`](/rest/reference/git#create-a-reference) (escritura)
|
||||
- [`POST /repos/{owner}/{repo}/git/tags`](/rest/reference/git#create-a-tag-object) (escritura)
|
||||
- [`POST /repos/{owner}/{repo}/git/trees`](/rest/reference/git#create-a-tree) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/import`](/rest/reference/migrations#get-an-import-status) (lectura)
|
||||
- [`PUT /repos/{owner}/{repo}/import`](/rest/reference/migrations#start-an-import) (escritura)
|
||||
- [`PATCH /repos/{owner}/{repo}/import`](/rest/reference/migrations#update-an-import) (escritura)
|
||||
- [`DELETE /repos/{owner}/{repo}/import`](/rest/reference/migrations#cancel-an-import) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/import/authors`](/rest/reference/migrations#get-commit-authors) (lectura)
|
||||
- [`PATCH /repos/{owner}/{repo}/import/authors/{author_id}`](/rest/reference/migrations#map-a-commit-author) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/import/large_files`](/rest/reference/migrations#get-large-files) (lectura)
|
||||
- [`PATCH /repos/{owner}/{repo}/import/lfs`](/rest/reference/migrations#update-git-lfs-preference) (escritura)
|
||||
- [`PUT /repos/{owner}/{repo}/pulls/{pull_number}/merge`](/rest/reference/pulls#merge-a-pull-request) (escritura)
|
||||
- [`POST /repos/{owner}/{repo}/comments/{comment_id}/reactions`](/rest/reference/reactions#create-reaction-for-a-commit-comment) (escritura)
|
||||
- [`DELETE /repos/{owner}/{repo}/comments/{comment_id}/reactions/{reaction_id}`](/rest/reference/reactions#delete-a-commit-comment-reaction) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/branches`](/rest/reference/repos#list-branches) (lectura)
|
||||
- [`POST /repos/{owner}/{repo}/merge-upstream`](/rest/reference/repos#sync-a-fork-branch-with-the-upstream-repository) (escritura)
|
||||
- [`POST /repos/{owner}/{repo}/merges`](/rest/reference/repos#merge-a-branch) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/branches`](/rest/branches/branches#list-branches) (lectura)
|
||||
- [`POST /repos/{owner}/{repo}/merge-upstream`](/rest/branches/branches#sync-a-fork-branch-with-the-upstream-repository) (escritura)
|
||||
- [`POST /repos/{owner}/{repo}/merges`](/rest/branches/branches#merge-a-branch) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/code-scanning/codeql/databases`](/rest/reference/code-scanning#list-codeql-databases) (lectura)
|
||||
- [`GET /repos/{owner}/{repo}/code-scanning/codeql/databases/{language}`](/rest/reference/code-scanning#get-codeql-database) (lectura)
|
||||
- [`PATCH /repos/{owner}/{repo}/comments/{comment_id}`](/rest/commits/comments#update-a-commit-comment) (escritura)
|
||||
@@ -320,7 +301,7 @@ Cuando se crea un {% data variables.product.pat_v2 %}, se le concede un conjunto
|
||||
- [`GET /repos/{owner}/{repo}/issues`](/rest/reference/issues#list-repository-issues) (lectura)
|
||||
- [`POST /repos/{owner}/{repo}/issues`](/rest/reference/issues#create-an-issue) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/issues/{issue_number}`](/rest/reference/issues#get-an-issue) (lectura)
|
||||
- [`PATCH /repos/{owner}/{repo}/issues/{issue_number}`](/rest/reference/issues/#update-an-issue) (escritura)
|
||||
- [`PATCH /repos/{owner}/{repo}/issues/{issue_number}`](/rest/reference/issues#update-an-issue) (escritura)
|
||||
- [`PUT /repos/{owner}/{repo}/issues/{issue_number}/lock`](/rest/reference/issues#lock-an-issue) (escritura)
|
||||
- [`DELETE /repos/{owner}/{repo}/issues/{issue_number}/lock`](/rest/reference/issues#unlock-an-issue) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/issues/{issue_number}/labels`](/rest/reference/issues#list-labels-for-an-issue) (lectura)
|
||||
@@ -409,7 +390,6 @@ Cuando se crea un {% data variables.product.pat_v2 %}, se le concede un conjunto
|
||||
- [`POST /gists/{gist_id}/forks`](/rest/reference/gists#fork-a-gist) (lectura)
|
||||
- [`PUT /gists/{gist_id}/star`](/rest/reference/gists#star-a-gist) (lectura)
|
||||
- [`DELETE /gists/{gist_id}/star`](/rest/reference/gists#unstar-a-gist) (lectura)
|
||||
- [`GET /notifications`](/rest/reference/activity#list-notifications-for-the-authenticated-user) (lectura)
|
||||
- [`GET /orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}`](/rest/reference/teams/#check-team-permissions-for-a-repository) (lectura)
|
||||
- [`PUT /orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}`](/rest/reference/teams/#add-or-update-team-repository-permissions) (lectura)
|
||||
- [`DELETE /orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}`](/rest/reference/teams/#remove-a-repository-from-a-team) (lectura)
|
||||
@@ -439,10 +419,6 @@ Cuando se crea un {% data variables.product.pat_v2 %}, se le concede un conjunto
|
||||
- [`GET /search/labels`](/rest/reference/search#search-labels) (lectura)
|
||||
- [`GET /repos/{owner}/{repo}/topics`](/rest/reference/repos#get-all-repository-topics) (lectura)
|
||||
|
||||
## Notificaciones
|
||||
|
||||
- [`GET /notifications`](/rest/reference/activity#list-notifications-for-the-authenticated-user) (lectura)
|
||||
|
||||
## Administración de la organización
|
||||
|
||||
{% ifversion ghec %}- [`GET /orgs/{org}/audit-log`](/rest/reference/orgs#get-audit-log) (lectura){% endif %}
|
||||
@@ -467,7 +443,7 @@ Cuando se crea un {% data variables.product.pat_v2 %}, se le concede un conjunto
|
||||
- [`GET /orgs/{org}/security-managers`](/rest/reference/orgs#list-security-manager-teams) (lectura)
|
||||
- [`PUT /orgs/{org}/security-managers/teams/{team_slug}`](/rest/reference/orgs#add-a-security-manager-team) (escritura)
|
||||
- [`DELETE /orgs/{org}/security-managers/teams/{team_slug}`](/rest/reference/orgs#remove-a-security-manager-team) (escritura)
|
||||
- [`PATCH /orgs/{org}`](/rest/reference/orgs/#update-an-organization) (escritura)
|
||||
- [`PATCH /orgs/{org}`](/rest/reference/orgs#update-an-organization) (escritura)
|
||||
- [`GET /orgs/{org}/installations`](/rest/reference/orgs#list-app-installations-for-an-organization) (lectura)
|
||||
|
||||
## Codespaces de la organización
|
||||
@@ -491,6 +467,7 @@ Cuando se crea un {% data variables.product.pat_v2 %}, se le concede un conjunto
|
||||
## Roles personalizados de la organización
|
||||
|
||||
- [`GET /organizations/{organization_id}/custom_roles`](/rest/reference/orgs#list-custom-repository-roles-in-an-organization) (lectura)
|
||||
- [`GET /orgs/{org}/custom_roles/{role_id}`](/rest/reference/orgs/#get-a-custom-role) (lectura)
|
||||
- [`PATCH /orgs/{org}/custom_roles/{role_id}`](/rest/reference/orgs#update-a-custom-role) (escritura)
|
||||
- [`DELETE /orgs/{org}/custom_roles/{role_id}`](/rest/reference/orgs#delete-a-custom-role) (escritura)
|
||||
- [`GET /orgs/{org}/fine_grained_permissions`](/rest/reference/orgs#list-fine-grained-permissions-for-an-organization) (lectura)
|
||||
@@ -523,13 +500,6 @@ Cuando se crea un {% data variables.product.pat_v2 %}, se le concede un conjunto
|
||||
- [`POST /orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}/attempts`](/rest/reference/orgs#redeliver-a-delivery-for-an-organization-webhook) (escritura)
|
||||
- [`POST /orgs/{org}/hooks/{hook_id}/pings`](/rest/reference/orgs#ping-an-organization-webhook) (escritura)
|
||||
|
||||
## Proyectos de la organización
|
||||
|
||||
- [`PUT /orgs/{org}/teams/{team_slug}/projects/{project_id}`](/rest/reference/teams#add-or-update-team-project-permissions) (administrador)
|
||||
- [`DELETE /orgs/{org}/teams/{team_slug}/projects/{project_id}`](/rest/reference/teams#remove-a-project-from-a-team) (administrador)
|
||||
- [`GET /orgs/{org}/projects`](/rest/reference/projects#list-organization-projects) (lectura)
|
||||
- [`POST /orgs/{org}/projects`](/rest/reference/projects#create-an-organization-project) (escritura)
|
||||
|
||||
## Secretos de la organización
|
||||
|
||||
- [`GET /orgs/{org}/actions/secrets`](/rest/reference/actions#list-organization-secrets) (lectura)
|
||||
@@ -640,30 +610,6 @@ Cuando se crea un {% data variables.product.pat_v2 %}, se le concede un conjunto
|
||||
- [`POST /repos/{owner}/{repo}/hooks/{hook_id}/pings`](/rest/webhooks/repos#ping-a-repository-webhook) (lectura)
|
||||
- [`POST /repos/{owner}/{repo}/hooks/{hook_id}/tests`](/rest/webhooks/repos#test-the-push-repository-webhook) (lectura)
|
||||
|
||||
## Proyectos del repositorio
|
||||
|
||||
- [`GET /projects/{project_id}/collaborators`](/rest/reference/projects#list-project-collaborators) (escritura)
|
||||
- [`PUT /projects/{project_id}/collaborators/{username}`](/rest/reference/projects#add-project-collaborator) (escritura)
|
||||
- [`DELETE /projects/{project_id}/collaborators/{username}`](/rest/reference/projects#remove-project-collaborator) (escritura)
|
||||
- [`GET /projects/{project_id}/collaborators/{username}/permission`](/rest/reference/projects#get-project-permission-for-a-user) (escritura)
|
||||
- [`GET /projects/{project_id}`](/rest/reference/projects#get-a-project) (lectura)
|
||||
- [`PATCH /projects/{project_id}`](/rest/reference/projects#update-a-project) (escritura)
|
||||
- [`DELETE /projects/{project_id}`](/rest/reference/projects#delete-a-project) (escritura)
|
||||
- [`GET /projects/{project_id}/columns`](/rest/reference/projects#list-project-columns) (lectura)
|
||||
- [`POST /projects/{project_id}/columns`](/rest/reference/projects#create-a-project-column) (escritura)
|
||||
- [`GET /projects/columns/{column_id}`](/rest/reference/projects#get-a-project-column) (lectura)
|
||||
- [`PATCH /projects/columns/{column_id}`](/rest/reference/projects#update-a-project-column) (escritura)
|
||||
- [`DELETE /projects/columns/{column_id}`](/rest/reference/projects#delete-a-project-column) (escritura)
|
||||
- [`GET /projects/columns/{column_id}/cards`](/rest/reference/projects#list-project-cards) (lectura)
|
||||
- [`POST /projects/columns/{column_id}/cards`](/rest/reference/projects#create-a-project-card) (escritura)
|
||||
- [`POST /projects/columns/{column_id}/moves`](/rest/reference/projects#move-a-project-column) (escritura)
|
||||
- [`GET /projects/columns/cards/{card_id}`](/rest/reference/projects#get-a-project-card) (lectura)
|
||||
- [`PATCH /projects/columns/cards/{card_id}`](/rest/reference/projects#update-a-project-card) (escritura)
|
||||
- [`DELETE /projects/columns/cards/{card_id}`](/rest/reference/projects#delete-a-project-card) (escritura)
|
||||
- [`POST /projects/columns/cards/{card_id}/moves`](/rest/reference/projects#move-a-project-card) (escritura)
|
||||
- [`GET /repos/{owner}/{repo}/projects`](/rest/reference/projects#list-repository-projects) (lectura)
|
||||
- [`POST /repos/{owner}/{repo}/projects`](/rest/reference/projects#create-a-repository-project) (escritura)
|
||||
|
||||
## Alertas de examen de secretos
|
||||
|
||||
- [`GET /orgs/{org}/secret-scanning/alerts`](/rest/reference/secret-scanning#list-secret-scanning-alerts-for-an-organization) (lectura)
|
||||
@@ -727,6 +673,10 @@ Cuando se crea un {% data variables.product.pat_v2 %}, se le concede un conjunto
|
||||
- [`PATCH /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number}`](/rest/reference/teams#update-a-discussion-comment) (escritura)
|
||||
- [`DELETE /orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number}`](/rest/reference/teams#delete-a-discussion-comment) (escritura)
|
||||
|
||||
## Alertas de vulnerabilidades
|
||||
|
||||
- [`GET /orgs/{org}/dependabot/alerts`](/rest/dependabot/alerts#list-dependabot-alerts-for-an-organization) (lectura)
|
||||
|
||||
## Observando
|
||||
|
||||
- [`GET /users/{username}/subscriptions`](/rest/reference/activity#list-repositories-watched-by-a-user) (lectura)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Resources in the REST API
|
||||
intro: 'Learn how to navigate the resources provided by the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API.'
|
||||
title: Recursos en la API de REST
|
||||
intro: 'Aprende cómo navegar en los recursos que proporciona la API de {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %}.'
|
||||
redirect_from:
|
||||
- /rest/initialize-the-repo
|
||||
versions:
|
||||
@@ -11,19 +11,23 @@ versions:
|
||||
miniTocMaxHeadingLevel: 3
|
||||
topics:
|
||||
- API
|
||||
ms.openlocfilehash: dc16916ada20275d41f23a8bc006cc79ddf51120
|
||||
ms.sourcegitcommit: d2f0b59ed096b9e68ef8f6fa019cd925165762ec
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148184273'
|
||||
---
|
||||
|
||||
{% ifversion api-date-versioning %}
|
||||
## API version
|
||||
## Versión de API
|
||||
|
||||
Available resources may vary between REST API versions. You should use the `X-GitHub-Api-Version` header to specify an API version. For more information, see "[API Versions](/rest/overview/api-versions)."
|
||||
Los recursos disponibles pueden variar entre las versiones de la API de REST. Debes usar el encabezado `X-GitHub-Api-Version` para especificar una versión de API. Para más información, consulta "[Versiones de API](/rest/overview/api-versions)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Schema
|
||||
|
||||
{% ifversion fpt or ghec %}All API access is over HTTPS, and{% else %}The API is{% endif %} accessed from `{% data variables.product.api_url_code %}`. All data is
|
||||
sent and received as JSON.
|
||||
{% ifversion fpt or ghec %}Todo el acceso a la API se realiza mediante HTTPS y{% else %}A la API{% endif %} se accede desde `{% data variables.product.api_url_code %}`. Todos los datos se envían y reciben como JSON.
|
||||
|
||||
```shell
|
||||
$ curl -I {% data variables.product.api_url_pre %}/users/octocat/orgs
|
||||
@@ -44,55 +48,45 @@ $ curl -I {% data variables.product.api_url_pre %}/users/octocat/orgs
|
||||
> X-Content-Type-Options: nosniff
|
||||
```
|
||||
|
||||
Blank fields are included as `null` instead of being omitted.
|
||||
Los campos en blanco se incluyen como `null` en lugar de omitirse.
|
||||
|
||||
All timestamps return in UTC time, ISO 8601 format:
|
||||
Todas las marcas de tiempo se devuelven en formato UTC, ISO 8601:
|
||||
|
||||
YYYY-MM-DDTHH:MM:SSZ
|
||||
|
||||
For more information about timezones in timestamps, see [this section](#timezones).
|
||||
Para más información sobre las zonas horarias en marcas de tiempo, vea [esta sección](#timezones).
|
||||
|
||||
### Summary representations
|
||||
### Representaciones de resumen
|
||||
|
||||
When you fetch a list of resources, the response includes a _subset_ of the
|
||||
attributes for that resource. This is the "summary" representation of the
|
||||
resource. (Some attributes are computationally expensive for the API to provide.
|
||||
For performance reasons, the summary representation excludes those attributes.
|
||||
To obtain those attributes, fetch the "detailed" representation.)
|
||||
Al capturar una lista de recursos, la respuesta incluye un _subconjunto_ de los atributos para ese recurso. Es la representación de "resumen" del recurso. (Algunos atributos son caros en términos de cómputo para que la API los proporcione.
|
||||
Por razones de rendimiento, la representación de resumen excluye esos atributos.
|
||||
Para obtener estos atributos, recupera la representación "detallada").
|
||||
|
||||
**Example**: When you get a list of repositories, you get the summary
|
||||
representation of each repository. Here, we fetch the list of repositories owned
|
||||
by the [octokit](https://github.com/octokit) organization:
|
||||
**Ejemplo**: al obtener una lista de repositorios, obtendrá la representación de resumen de cada repositorio. Aquí, se captura la lista de repositorios propiedad de la organización [octokit](https://github.com/octokit):
|
||||
|
||||
GET /orgs/octokit/repos
|
||||
|
||||
### Detailed representations
|
||||
### Representaciones detalladas
|
||||
|
||||
When you fetch an individual resource, the response typically includes _all_
|
||||
attributes for that resource. This is the "detailed" representation of the
|
||||
resource. (Note that authorization sometimes influences the amount of detail
|
||||
included in the representation.)
|
||||
Al capturar un recurso individual, la respuesta incluye habitualmente _todos_ los atributos para ese recurso. Es la representación "detallada" del recurso. (Tenga en cuenta que, en ocasiones, la autorización influye en la cantidad de detalles que se incluyen en la representación).
|
||||
|
||||
**Example**: When you get an individual repository, you get the detailed
|
||||
representation of the repository. Here, we fetch the
|
||||
[octokit/octokit.rb](https://github.com/octokit/octokit.rb) repository:
|
||||
**Ejemplo**: al obtener un repositorio individual, obtendrá la representación detallada del repositorio. Aquí, se captura el repositorio [octokit/octokit.rb](https://github.com/octokit/octokit.rb):
|
||||
|
||||
GET /repos/octokit/octokit.rb
|
||||
|
||||
The documentation provides an example response for each API method. The example
|
||||
response illustrates all attributes that are returned by that method.
|
||||
La documentación proporciona un ejemplo de respuesta para cada método de la API. La respuesta de ejemplo ilustra todos los atributos que se devuelven con ese método.
|
||||
|
||||
## Authentication
|
||||
|
||||
{% ifversion ghae %} We recommend authenticating to the {% data variables.product.product_name %} REST API by creating an OAuth2 token through the [web application flow](/developers/apps/authorizing-oauth-apps#web-application-flow). {% else %} There are two ways to authenticate through {% data variables.product.product_name %} REST API.{% endif %} Requests that require authentication will return `404 Not Found`, instead of `403 Forbidden`, in some places. This is to prevent the accidental leakage of private repositories to unauthorized users.
|
||||
{% ifversion ghae %} Se recomienda autenticarse en la API REST de {% data variables.product.product_name %} mediante la creación de un token de OAuth2 con el [flujo de aplicación web](/developers/apps/authorizing-oauth-apps#web-application-flow). {% else %} Hay dos maneras de autenticarse mediante la API REST de {% data variables.product.product_name %}.{% endif %} Las solicitudes que necesitan autenticación devolverán `404 Not Found`, en vez de `403 Forbidden`, en algunos lugares. Esto es para prevenir la fuga accidental de los repositorios privados a los usuarios no autorizados.
|
||||
|
||||
### Basic authentication
|
||||
### Autenticación básica
|
||||
|
||||
```shell
|
||||
$ curl -u "username" {% data variables.product.api_url_pre %}
|
||||
```
|
||||
|
||||
### OAuth2 token (sent in a header)
|
||||
### Token de OAuth (enviado en un encabezado)
|
||||
|
||||
```shell
|
||||
$ curl -H "Authorization: Bearer OAUTH-TOKEN" {% data variables.product.api_url_pre %}
|
||||
@@ -100,20 +94,20 @@ $ curl -H "Authorization: Bearer OAUTH-TOKEN" {% data variables.product.api_url_
|
||||
|
||||
{% note %}
|
||||
|
||||
Note: GitHub recommends sending OAuth tokens using the Authorization header.
|
||||
Nota: GitHub recomienda enviar los tokens de OAuth utilizando el encabezado de autorización.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** {% data reusables.getting-started.bearer-vs-token %}
|
||||
**Nota:** {% data reusables.getting-started.bearer-vs-token %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
Read [more about OAuth2](/apps/building-oauth-apps/). Note that OAuth2 tokens can be acquired using the [web application flow](/developers/apps/authorizing-oauth-apps#web-application-flow) for production applications.
|
||||
Obtenga [más información sobre OAuth2](/apps/building-oauth-apps/). Tenga en cuenta que los tokens de OAuth2 se pueden adquirir mediante el [flujo de aplicación web](/developers/apps/authorizing-oauth-apps#web-application-flow) para las aplicaciones de producción.
|
||||
|
||||
{% ifversion fpt or ghes or ghec %}
|
||||
### OAuth2 key/secret
|
||||
### Llave/secreto de OAuth2
|
||||
|
||||
{% data reusables.apps.deprecating_auth_with_query_parameters %}
|
||||
|
||||
@@ -121,22 +115,20 @@ Read [more about OAuth2](/apps/building-oauth-apps/). Note that OAuth2 tokens c
|
||||
curl -u my_client_id:my_client_secret '{% data variables.product.api_url_pre %}/user/repos'
|
||||
```
|
||||
|
||||
Using your `client_id` and `client_secret` does _not_ authenticate as a user, it will only identify your OAuth App to increase your rate limit. Permissions are only granted to users, not applications, and you will only get back data that an unauthenticated user would see. For this reason, you should only use the OAuth2 key/secret in server-to-server scenarios. Don't leak your OAuth App's client secret to your users.
|
||||
El uso de `client_id` y `client_secret` _no_ se autentica como usuario, solo identificará la aplicación de OAuth para aumentar el límite de frecuencia. Los permisos se otorgan únicamente a usuarios, no a aplicaciones, y úicamente obtendrás datos que un usuario no autenticado vería. Es por esto que deberías utilizar únicamente la llave/secreto de OAuth2 en escenarios de servidor a servidor. No filtres tu secreto de cliente de la App de OAuth a tus usuarios.
|
||||
|
||||
{% ifversion ghes %}
|
||||
You will be unable to authenticate using your OAuth2 key and secret while in private mode, and trying to authenticate will return `401 Unauthorized`. For more information, see "[Enabling private mode](/admin/configuration/configuring-your-enterprise/enabling-private-mode)".
|
||||
{% endif %}
|
||||
{% endif %}
|
||||
{% ifversion ghes %} No podrá autenticarse mediante la clave y el secreto de OAuth2 si está en modo privado, y al intentarlo se devolverá el mensaje `401 Unauthorized`. Para más información, vea "[Habilitación del modo privado](/admin/configuration/configuring-your-enterprise/enabling-private-mode)".
|
||||
{% endif %} {% endif %}
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
Read [more about unauthenticated rate limiting](#increasing-the-unauthenticated-rate-limit-for-oauth-apps).
|
||||
[Más información sobre la limitación de frecuencia no autenticada](#increasing-the-unauthenticated-rate-limit-for-oauth-apps).
|
||||
|
||||
{% endif %}
|
||||
|
||||
### Failed login limit
|
||||
### Límite de ingresos fallidos
|
||||
|
||||
Authenticating with invalid credentials will return `401 Unauthorized`:
|
||||
La autenticación con credenciales no válidas devolverá `401 Unauthorized`:
|
||||
|
||||
```shell
|
||||
$ curl -I {% data variables.product.api_url_pre %} -u foo:bar
|
||||
@@ -148,9 +140,7 @@ $ curl -I {% data variables.product.api_url_pre %} -u foo:bar
|
||||
> }
|
||||
```
|
||||
|
||||
After detecting several requests with invalid credentials within a short period,
|
||||
the API will temporarily reject all authentication attempts for that user
|
||||
(including ones with valid credentials) with `403 Forbidden`:
|
||||
Después de detectar varias solicitudes con credenciales no válidas en un breve periodo de tiempo, la API rechazará temporalmente todos los intentos de autenticación para el usuario en cuestión (incluidos aquellos con credenciales válidas) con `403 Forbidden`:
|
||||
|
||||
```shell
|
||||
$ curl -i {% data variables.product.api_url_pre %} -u {% ifversion fpt or ghae or ghec %}
|
||||
@@ -162,62 +152,55 @@ $ curl -i {% data variables.product.api_url_pre %} -u {% ifversion fpt or ghae o
|
||||
> }
|
||||
```
|
||||
|
||||
## Parameters
|
||||
## Parámetros
|
||||
|
||||
Many API methods take optional parameters. For `GET` requests, any parameters not
|
||||
specified as a segment in the path can be passed as an HTTP query string
|
||||
parameter:
|
||||
Muchos métodos de la API toman parámetros opcionales. Para las solicitudes `GET`, cualquier parámetro que no se haya especificado como un segmento en la ruta se puede pasar como un parámetro de cadena de consulta HTTP:
|
||||
|
||||
```shell
|
||||
$ curl -i "{% data variables.product.api_url_pre %}/repos/vmg/redcarpet/issues?state=closed"
|
||||
```
|
||||
|
||||
In this example, the 'vmg' and 'redcarpet' values are provided for the `:owner`
|
||||
and `:repo` parameters in the path while `:state` is passed in the query
|
||||
string.
|
||||
En este ejemplo, se proporcionan los valores "vmg" y "redcarpet" para los parámetros `:owner` y `:repo` de la ruta, mientras se pasa `:state` en la cadena de consulta.
|
||||
|
||||
For `POST`, `PATCH`, `PUT`, and `DELETE` requests, parameters not included in the URL should be encoded as JSON
|
||||
with a Content-Type of 'application/json':
|
||||
En el caso de las solicitudes `POST`, `PATCH`, `PUT`y `DELETE`, los parámetros no incluidos en la dirección URL se deben codificar como JSON con un tipo de contenido de "application/json":
|
||||
|
||||
```shell
|
||||
$ curl -i -u username -d '{"scopes":["repo_deployment"]}' {% data variables.product.api_url_pre %}/authorizations
|
||||
```
|
||||
|
||||
## Root endpoint
|
||||
## Punto de conexión raíz
|
||||
|
||||
You can issue a `GET` request to the root endpoint to get all the endpoint categories that the REST API supports:
|
||||
Puede emitir una solicitud `GET` al punto de conexión raíz para obtener todas las categorías de punto de conexión compatibles con la API REST:
|
||||
|
||||
```shell
|
||||
$ curl {% ifversion fpt or ghae or ghec %}
|
||||
-u USERNAME:TOKEN {% endif %}{% ifversion ghes %}-u USERNAME:PASSWORD {% endif %}{% data variables.product.api_url_pre %}
|
||||
```
|
||||
|
||||
## GraphQL global node IDs
|
||||
## IDs de nodo globales de GraphQL
|
||||
|
||||
See the guide on "[Using Global Node IDs](/graphql/guides/using-global-node-ids)" for detailed information about how to find `node_id`s via the REST API and use them in GraphQL operations.
|
||||
Vea la guía sobre "[Uso de identificadores de nodo global](/graphql/guides/using-global-node-ids)" para obtener información detallada sobre cómo buscar `node_id` mediante la API REST y su uso en operaciones de GraphQL.
|
||||
|
||||
## Client errors
|
||||
## Errores de cliente
|
||||
|
||||
There are three possible types of client errors on API calls that
|
||||
receive request bodies:
|
||||
Existen tres posibles tipos de errores de cliente en las llamadas API que reciben cuerpos de solicitud:
|
||||
|
||||
1. Sending invalid JSON will result in a `400 Bad Request` response.
|
||||
1. El envío de código JSON no válido dará como resultado una respuesta `400 Bad Request`.
|
||||
|
||||
HTTP/2 400
|
||||
Content-Length: 35
|
||||
|
||||
{"message":"Problems parsing JSON"}
|
||||
|
||||
2. Sending the wrong type of JSON values will result in a `400 Bad
|
||||
Request` response.
|
||||
2. El envío del tipo incorrecto de valores JSON dará como resultado una respuesta `400 Bad
|
||||
Request`.
|
||||
|
||||
HTTP/2 400
|
||||
Content-Length: 40
|
||||
|
||||
{"message":"Body should be a JSON object"}
|
||||
|
||||
3. Sending invalid fields will result in a `422 Unprocessable Entity`
|
||||
response.
|
||||
3. El envío de campos no válidos dará como resultado una respuesta `422 Unprocessable Entity`.
|
||||
|
||||
HTTP/2 422
|
||||
Content-Length: 149
|
||||
@@ -233,60 +216,47 @@ receive request bodies:
|
||||
]
|
||||
}
|
||||
|
||||
All error objects have resource and field properties so that your client
|
||||
can tell what the problem is. There's also an error code to let you
|
||||
know what is wrong with the field. These are the possible validation error
|
||||
codes:
|
||||
Todos los objetos de error tienen propiedades de campo y de recurso para que el cliente pueda identificar el problema. También hay un código de error para que sepa cuál es el error en el campo. Estos son los códigos de error de validación posibles:
|
||||
|
||||
Error code name | Description
|
||||
Nombre del código de error | Descripción
|
||||
-----------|-----------|
|
||||
`missing` | A resource does not exist.
|
||||
`missing_field` | A required field on a resource has not been set.
|
||||
`invalid` | The formatting of a field is invalid. Review the documentation for more specific information.
|
||||
`already_exists` | Another resource has the same value as this field. This can happen in resources that must have some unique key (such as label names).
|
||||
`unprocessable` | The inputs provided were invalid.
|
||||
`missing` | Un recurso no existe.
|
||||
`missing_field` | No se ha configurado un campo requerido en un recurso.
|
||||
`invalid` | El formato de un campo es inválido. Revisa la documentación para encontrar información más específica.
|
||||
`already_exists` | Otro recurso tiene el mismo valor que este campo. Esto puede suceder en recursos que deben tener claves únicas (tales como nombres de etiqueta).
|
||||
`unprocessable` | Las entradas proporcionadas son inválidas.
|
||||
|
||||
Resources may also send custom validation errors (where `code` is `custom`). Custom errors will always have a `message` field describing the error, and most errors will also include a `documentation_url` field pointing to some content that might help you resolve the error.
|
||||
Los recursos también pueden enviar errores de validación personalizados (donde `code` es `custom`). Los errores personalizados siempre tendrán un campo `message` que describe el error y la mayoría también incluirán un campo `documentation_url` que apunta a algún contenido que pueda ayudarle a resolver el error.
|
||||
|
||||
## HTTP redirects
|
||||
## Redireccionamientos HTTP
|
||||
|
||||
The {% data variables.product.product_name %} REST API uses HTTP redirection where appropriate. Clients should assume that any
|
||||
request may result in a redirection. Receiving an HTTP redirection is *not* an
|
||||
error and clients should follow that redirect. Redirect responses will have a
|
||||
`Location` header field which contains the URI of the resource to which the
|
||||
client should repeat the requests.
|
||||
La API REST de {% data variables.product.product_name %} usa el redireccionamiento HTTP cuando corresponda. Los clientes deben asumir que cualquier solicitud podría resultar en un redireccionamiento. La recepción de un redireccionamiento HTTP *no* es un error y los clientes deben seguir esa redirección. Las respuestas de redireccionamiento tienen un campo de encabezado `Location` que contiene el URI del recurso al que el cliente debe repetir las solicitudes.
|
||||
|
||||
Status Code | Description
|
||||
Código de estado | Descripción
|
||||
-----------|-----------|
|
||||
`301` | Permanent redirection. The URI you used to make the request has been superseded by the one specified in the `Location` header field. This and all future requests to this resource should be directed to the new URI.
|
||||
`302`, `307` | Temporary redirection. The request should be repeated verbatim to the URI specified in the `Location` header field but clients should continue to use the original URI for future requests.
|
||||
`301` | Redirección permanente. El URI que ha usado para realizar la solicitud se ha reemplazado por el especificado en el campo de encabezado `Location`. Ésta y todas las solicitudes futuras a este recurso se deberán dirigir al nuevo URI.
|
||||
`302`, `307` | Redireccion temporal. La solicitud debe repetirse literalmente en el URI especificado en el campo de encabezado `Location`, pero los clientes deben seguir utilizando el URI original para solicitudes futuras.
|
||||
|
||||
Other redirection status codes may be used in accordance with the HTTP 1.1 spec.
|
||||
Podrían utilizarse otros códigos de estado de redirección de acuerdo con la especificación HTTP 1.1.
|
||||
|
||||
## HTTP verbs
|
||||
## Verbos HTTP
|
||||
|
||||
Where possible, the {% data variables.product.product_name %} REST API strives to use appropriate HTTP verbs for each
|
||||
action. Note that HTTP verbs are case-sensitive.
|
||||
Siempre que sea posible, la API REST de {% data variables.product.product_name %} se esfuerza por usar los verbos HTTP adecuados para cada acción. Ten en cuenta que los verbos HTTP distinguen mayúsculas de minúsculas.
|
||||
|
||||
Verb | Description
|
||||
Verbo | Descripción
|
||||
-----|-----------
|
||||
`HEAD` | Can be issued against any resource to get just the HTTP header info.
|
||||
`GET` | Used for retrieving resources.
|
||||
`POST` | Used for creating resources.
|
||||
`PATCH` | Used for updating resources with partial JSON data. For instance, an Issue resource has `title` and `body` attributes. A `PATCH` request may accept one or more of the attributes to update the resource.
|
||||
`PUT` | Used for replacing resources or collections. For `PUT` requests with no `body` attribute, be sure to set the `Content-Length` header to zero.
|
||||
`DELETE` |Used for deleting resources.
|
||||
`HEAD` | Puede emitirse contra cualquier recurso para obtener solo la información del encabezado HTTP.
|
||||
`GET` | Se utiliza para recuperar recursos.
|
||||
`POST` | Se utiliza para crear recursos.
|
||||
`PATCH` | Se utiliza para actualizar los recursos con datos parciales de JSON. Por ejemplo, un recurso Incidencia tiene atributos `title` y `body`. Una solicitud `PATCH` podría aceptar uno o más de los atributos para actualizar el recurso.
|
||||
`PUT` | Se utiliza para reemplazar recursos o colecciones. Para las solicitudes `PUT` sin un atributo `body`, asegúrese de establecer el encabezado `Content-Length` en cero.
|
||||
`DELETE` |Se utiliza para borrar recursos.
|
||||
|
||||
## Hypermedia
|
||||
|
||||
All resources may have one or more `*_url` properties linking to other
|
||||
resources. These are meant to provide explicit URLs so that proper API clients
|
||||
don't need to construct URLs on their own. It is highly recommended that API
|
||||
clients use these. Doing so will make future upgrades of the API easier for
|
||||
developers. All URLs are expected to be proper [RFC 6570][rfc] URI templates.
|
||||
Todos los recursos pueden tener una o varias propiedades `*_url` vinculadas a otros recursos. Su función es proporcionar las URL explícitas para que los clientes de API adecuados no tengan que construirlas ellos mismos. Se recomienda encarecidamente que los clientes de API las usen. De esta forma, para los desarrolladores será más sencillo realizar actualizaciones futuras de la API. Se espera que todas las direcciones URL sean plantillas de URI [RFC 6570][rfc] correctas.
|
||||
|
||||
You can then expand these templates using something like the [uri_template][uri]
|
||||
gem:
|
||||
Después, puede expandir estas plantillas con algo parecido a la gema [uri_template][uri]:
|
||||
|
||||
>> tmpl = URITemplate.new('/notifications{?since,all,participating}')
|
||||
>> tmpl.expand
|
||||
@@ -301,60 +271,56 @@ gem:
|
||||
[rfc]: https://datatracker.ietf.org/doc/html/rfc6570
|
||||
[uri]: https://github.com/hannesg/uri_template
|
||||
|
||||
## Pagination
|
||||
## Paginación
|
||||
|
||||
Requests that return multiple items will be paginated to 30 items by
|
||||
default. You can specify further pages with the `page` parameter. For some
|
||||
resources, you can also set a custom page size up to 100 with the `per_page` parameter.
|
||||
Note that for technical reasons not all endpoints respect the `per_page` parameter,
|
||||
see [events](/rest/reference/activity#events) for example.
|
||||
Las solicitudes que devuelven varios elementos se paginarán a 30 elementos de manera predeterminada. Puede especificar más páginas con el parámetro `page`. Para algunos recursos, también puede establecer un tamaño de página personalizado de hasta 100 con el parámetro `per_page`.
|
||||
Tenga en cuenta que, por motivos técnicos, no todos los puntos de conexión respetan el parámetro `per_page`, vea los [eventos](/rest/reference/activity#events) por ejemplo.
|
||||
|
||||
```shell
|
||||
$ curl '{% data variables.product.api_url_pre %}/user/repos?page=2&per_page=100'
|
||||
```
|
||||
|
||||
Note that page numbering is 1-based and that omitting the `page`
|
||||
parameter will return the first page.
|
||||
Tenga en cuenta que la numeración comienza en 1 y que si se omite el parámetro `page` se devolverá la primera página.
|
||||
|
||||
Some endpoints use cursor-based pagination. A cursor is a string that points to a location in the result set.
|
||||
With cursor-based pagination, there is no fixed concept of "pages" in the result set, so you can't navigate to a specific page.
|
||||
Instead, you can traverse the results by using the `before` or `after` parameters.
|
||||
Algunas terminales utilizan una paginación basada en el cursor. Un cursor es una cadena que apunta a una ubicación en el conjunto de resultados.
|
||||
Con la paginación basada en un cursor, no existe un concepto fijo de "páginas" en el conjunto de resultados, así que no puedes navegar a alguna página específica.
|
||||
En su lugar, puede recorrer los resultados mediante los parámetros `before` o `after`.
|
||||
|
||||
For more information on pagination, check out our guide on [Traversing with Pagination][pagination-guide].
|
||||
Para más información sobre la paginación, vea nuestra guía sobre [recorrido con paginación][pagination-guide].
|
||||
|
||||
### Link header
|
||||
### Encabezado de enlace
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** It's important to form calls with Link header values instead of constructing your own URLs.
|
||||
**Nota:** Es importante formar llamadas con valores de encabezado Link en lugar de construir direcciones URL propias.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
The [Link header](https://datatracker.ietf.org/doc/html/rfc5988) includes pagination information. For example:
|
||||
El [encabezado Link](https://datatracker.ietf.org/doc/html/rfc5988) incluye información de paginación. Por ejemplo:
|
||||
|
||||
Link: <{% data variables.product.api_url_code %}/user/repos?page=3&per_page=100>; rel="next",
|
||||
<{% data variables.product.api_url_code %}/user/repos?page=50&per_page=100>; rel="last"
|
||||
|
||||
_The example includes a line break for readability._
|
||||
_Este ejemplo incluye un salto de línea para legibilidad._
|
||||
|
||||
Or, if the endpoint uses cursor-based pagination:
|
||||
O, si la terminal utiliza una paginación basada en un cursor:
|
||||
|
||||
Link: <{% data variables.product.api_url_code %}/orgs/ORG/audit-log?after=MTYwMTkxOTU5NjQxM3xZbGI4VE5EZ1dvZTlla09uWjhoZFpR&before=>; rel="next",
|
||||
|
||||
This `Link` response header contains one or more [Hypermedia](/rest#hypermedia) link relations, some of which may require expansion as [URI templates](https://datatracker.ietf.org/doc/html/rfc6570).
|
||||
Este encabezado de respuesta `Link` contiene una o varias relaciones de vínculo [Hypermedia](/rest#hypermedia) y en algunas puede ser necesario expandirlas como [plantillas de URI](https://datatracker.ietf.org/doc/html/rfc6570).
|
||||
|
||||
The possible `rel` values are:
|
||||
Los valores `rel` posibles son los siguientes:
|
||||
|
||||
Name | Description
|
||||
Nombre | Descripción
|
||||
-----------|-----------|
|
||||
`next` |The link relation for the immediate next page of results.
|
||||
`last` |The link relation for the last page of results.
|
||||
`first` |The link relation for the first page of results.
|
||||
`prev` |The link relation for the immediate previous page of results.
|
||||
`next` |La relación del enlace para la página subsecuente inmediata de resultados.
|
||||
`last` |La relación del enlace para la última página de resultados.
|
||||
`first` |La relación del enlace para la primera parte de los resultados.
|
||||
`prev` |La relación del enlace para la página previa inmediata de resultados.
|
||||
|
||||
## Timeouts
|
||||
## Tiempos de espera
|
||||
|
||||
If {% data variables.product.prodname_dotcom %} takes more than 10 seconds to process an API request, {% data variables.product.prodname_dotcom %} will terminate the request and you will receive a timeout response like this:
|
||||
Si {% data variables.product.prodname_dotcom %} tarda más de 10 segundos en procesar una solicitud de la API, {% data variables.product.prodname_dotcom %} finalizará la solicitud y recibirás una respuesta de tiempo de espera excedido como la siguiente:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -362,23 +328,23 @@ If {% data variables.product.prodname_dotcom %} takes more than 10 seconds to pr
|
||||
}
|
||||
```
|
||||
|
||||
{% data variables.product.product_name %} reserves the right to change the timeout window to protect the speed and reliability of the API.
|
||||
{% data variables.product.product_name %} se reserva el derecho de cambiar la ventana de tiempo de espera para proteger la velocidad y confiabilidad de la API.
|
||||
|
||||
## Rate limiting
|
||||
## Limitación de frecuencia
|
||||
|
||||
Different types of API requests to {% data variables.location.product_location %} are subject to different rate limits.
|
||||
Los distintos tipos de solicitudes de la API a {% data variables.location.product_location %} están sujetas a límites de tasa diferentes.
|
||||
|
||||
Additionally, the Search API has dedicated limits. For more information, see "[Search](/rest/reference/search#rate-limit)" in the REST API documentation.
|
||||
Adicionalmente, la API de búsqueda tiene límites dedicados. Para más información, vea "[Búsqueda](/rest/reference/search#rate-limit)" en la documentación de la API REST.
|
||||
|
||||
{% data reusables.enterprise.rate_limit %}
|
||||
|
||||
{% data reusables.rest-api.always-check-your-limit %}
|
||||
|
||||
### Requests from personal accounts
|
||||
### Solicitudes de cuentas personales
|
||||
|
||||
Direct API requests that you authenticate with a {% data variables.product.pat_generic %} are user-to-server requests. An OAuth App or GitHub App can also make a user-to-server request on your behalf after you authorize the app. For more information, see "[Creating a {% data variables.product.pat_generic %}](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)," "[Authorizing OAuth Apps](/authentication/keeping-your-account-and-data-secure/authorizing-oauth-apps)," and "[Authorizing GitHub Apps](/authentication/keeping-your-account-and-data-secure/authorizing-github-apps)."
|
||||
Las solicitudes directas de la API que autentiques con un {% data variables.product.pat_generic %} son de tipo usuario a servidor. Una App de OAuth o GitHub App también puede hacer una solicitud de usuario a servidor en tu nombre después de que la autorices para ello. Para más información, consulta "[Creación de un {% data variables.product.pat_generic %}](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)", "[Autorización de aplicaciones de OAuth](/authentication/keeping-your-account-and-data-secure/authorizing-oauth-apps)" y "[Autorización de aplicaciones de GitHub](/authentication/keeping-your-account-and-data-secure/authorizing-github-apps)".
|
||||
|
||||
{% data variables.product.product_name %} associates all user-to-server requests with the authenticated user. For OAuth Apps and GitHub Apps, this is the user who authorized the app. All user-to-server requests count toward the authenticated user's rate limit.
|
||||
{% data variables.product.product_name %} asocia todas las solicitudes de usuario a servidor con el usuario autenticado. En el caso de las Apps de OAuth y GitHub Apps, este es el usuario que autorizó la app. Todas las solicitudes de usuario a servidor cuentan en el límite de tasa del usuario autenticado.
|
||||
|
||||
{% data reusables.apps.user-to-server-rate-limits %}
|
||||
|
||||
@@ -388,33 +354,33 @@ Direct API requests that you authenticate with a {% data variables.product.pat_g
|
||||
|
||||
{% ifversion fpt or ghec or ghes %}
|
||||
|
||||
For unauthenticated requests, the rate limit allows for up to 60 requests per hour. Unauthenticated requests are associated with the originating IP address, and not the person making requests.
|
||||
Para las solicitudes no autenticadas, el límite de tasa permite hasta 60 solicitudes por hora. Las solicitudes sin autenticar se asocian con la dirección IP original y no con la persona que las realiza.
|
||||
|
||||
{% endif %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
### Requests from GitHub Apps
|
||||
### Solicitudes desde GitHub Apps
|
||||
|
||||
Requests from a GitHub App may be either user-to-server or server-to-server requests. For more information about rate limits for GitHub Apps, see "[Rate limits for GitHub Apps](/developers/apps/building-github-apps/rate-limits-for-github-apps)."
|
||||
Las solicitudes desde las GitHub Apps podrían ser de usuario a servidor o de servidor a servidor. Para más información sobre los límites de frecuencia de las aplicaciones de GitHub, vea "[Límites de frecuencia para aplicaciones de GitHub](/developers/apps/building-github-apps/rate-limits-for-github-apps)".
|
||||
|
||||
### Requests from GitHub Actions
|
||||
### Solicitudes desde las GitHub Actions
|
||||
|
||||
You can use the built-in `GITHUB_TOKEN` to authenticate requests in GitHub Actions workflows. For more information, see "[Automatic token authentication](/actions/security-guides/automatic-token-authentication)."
|
||||
Puede usar el valor `GITHUB_TOKEN` integrado para autenticar solicitudes en flujos de trabajo de Acciones de GitHub. Para más información, vea "[Autenticación de token automática](/actions/security-guides/automatic-token-authentication)".
|
||||
|
||||
When using `GITHUB_TOKEN`, the rate limit is 1,000 requests per hour per repository.{% ifversion fpt or ghec %} For requests to resources that belong to an enterprise account on {% data variables.location.product_location %}, {% data variables.product.prodname_ghe_cloud %}'s rate limit applies, and the limit is 15,000 requests per hour per repository.{% endif %}
|
||||
Al usar `GITHUB_TOKEN`, el límite de frecuencia es de 1000 solicitudes por hora y repositorio.{% ifversion fpt or ghec %} Para las solicitudes a recursos que pertenecen a una cuenta de empresa de {% data variables.location.product_location %}, se aplica el límite de frecuencia de {% data variables.product.prodname_ghe_cloud %} y es de 15 000 solicitudes por hora y repositorio.{% endif %}
|
||||
|
||||
### Checking your rate limit status
|
||||
### Verificar el estado de tu límite de tasa
|
||||
|
||||
The Rate Limit API and a response's HTTP headers are authoritative sources for the current number of API calls available to you or your app at any given time.
|
||||
La API de límite de tasa y los encabezados HTTP de una respuesta son fuentes autoritativas para la cantidad actual de llamadas a la API disponibles para ti o para tu app en un momento dado.
|
||||
|
||||
#### Rate Limit API
|
||||
#### API de Límite de Tasa
|
||||
|
||||
You can use the Rate Limit API to check your rate limit status without incurring a hit to the current limit. For more information, see "[Rate limit](/rest/reference/rate-limit)."
|
||||
Puedes utilizar la API de Límite de Tasa para verificar tu estado de límite de tasa sin incurrir en el uso de dicho límite. Para más información, vea "[Límite de frecuencia](/rest/reference/rate-limit)".
|
||||
|
||||
#### Rate limit HTTP headers
|
||||
#### Encabezados HTTP de límite de tasa
|
||||
|
||||
The returned HTTP headers of any API request show your current rate limit status:
|
||||
Los encabezados HTTP recuperados para cualquier solicitud de la API muestran tu estado actual de límite de tasa:
|
||||
|
||||
```shell
|
||||
$ curl -I {% data variables.product.api_url_pre %}/users/octocat
|
||||
@@ -426,21 +392,21 @@ $ curl -I {% data variables.product.api_url_pre %}/users/octocat
|
||||
> x-ratelimit-reset: 1372700873
|
||||
```
|
||||
|
||||
Header Name | Description
|
||||
Nombre de encabezado | Descripción
|
||||
-----------|-----------|
|
||||
`x-ratelimit-limit` | The maximum number of requests you're permitted to make per hour.
|
||||
`x-ratelimit-remaining` | The number of requests remaining in the current rate limit window.
|
||||
`x-ratelimit-used` | The number of requests you've made in the current rate limit window.
|
||||
`x-ratelimit-reset` | The time at which the current rate limit window resets in [UTC epoch seconds](http://en.wikipedia.org/wiki/Unix_time).
|
||||
`x-ratelimit-limit` | La cantidad máxima de solicitudes que puedes hacer por hora.
|
||||
`x-ratelimit-remaining` | La cantidad de solicitudes que quedan en la ventana de límite de tasa actual.
|
||||
`x-ratelimit-used` | La cantidad de solicitudes que has realizado en la ventana de límite de tasa actual.
|
||||
`x-ratelimit-reset` | Hora a la que se restablece la ventana de límite de frecuencia actual en [segundos desde la época UTC](http://en.wikipedia.org/wiki/Unix_time).
|
||||
|
||||
If you need the time in a different format, any modern programming language can get the job done. For example, if you open up the console on your web browser, you can easily get the reset time as a JavaScript Date object.
|
||||
Si necesitas ver la hora en un formato diferente, cualquier lenguaje de programación moderno puede ayudarte con esta tarea. Por ejemplo, si abres la consola en tu buscador web, puedes obtener fácilmente el tiempo de restablecimiento como un objeto de Tiempo de JavaScript.
|
||||
|
||||
``` javascript
|
||||
new Date(1372700873 * 1000)
|
||||
// => Mon Jul 01 2013 13:47:53 GMT-0400 (EDT)
|
||||
```
|
||||
|
||||
If you exceed the rate limit, an error response returns:
|
||||
Si excedes el límite de tasa, se regresará una respuesta de error:
|
||||
|
||||
```shell
|
||||
> HTTP/2 403
|
||||
@@ -456,9 +422,9 @@ If you exceed the rate limit, an error response returns:
|
||||
> }
|
||||
```
|
||||
|
||||
### Increasing the unauthenticated rate limit for OAuth Apps
|
||||
### Incrementar el límite de tasa no autenticado para las Apps de OAuth
|
||||
|
||||
If your OAuth App needs to make unauthenticated calls with a higher rate limit, you can pass your app's client ID and secret before the endpoint route.
|
||||
Si tu App de OAuth necesita hacer llamadas sin autenticar con un límite de tasa más alto, puedes pasar la ID de cliente y secreto de tu app antes de la ruta de la terminal.
|
||||
|
||||
```shell
|
||||
$ curl -u my_client_id:my_client_secret -I {% data variables.product.api_url_pre %}/user/repos
|
||||
@@ -472,21 +438,21 @@ $ curl -u my_client_id:my_client_secret -I {% data variables.product.api_url_pre
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** Never share your client secret with anyone or include it in client-side browser code. Use the method shown here only for server-to-server calls.
|
||||
**Nota:** Nunca comparta el secreto de cliente con nadie ni lo incluya en el código del explorador del lado cliente. Utiliza únicamente el método que se muestra aquí para las llamadas de servidor a servidor.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
### Staying within the rate limit
|
||||
### Quedarse dentro del límite de tasa
|
||||
|
||||
If you exceed your rate limit using Basic Authentication or OAuth, you can likely fix the issue by caching API responses and using [conditional requests](#conditional-requests).
|
||||
Si supera el límite de frecuencia mediante la autenticación básica u OAuth, es probable que pueda corregir el problema almacenando en caché las respuestas de la API y usando [solicitudes condicionales](#conditional-requests).
|
||||
|
||||
### Secondary rate limits
|
||||
### Límites de tasa secundarios
|
||||
|
||||
In order to provide quality service on {% data variables.product.product_name %}, additional rate limits may apply to some actions when using the API. For example, using the API to rapidly create content, poll aggressively instead of using webhooks, make multiple concurrent requests, or repeatedly request data that is computationally expensive may result in secondary rate limiting.
|
||||
Para prorpocionar un servicio de calidad en {% data variables.product.product_name %}, los límites de tasa adicionales podrían aplicar a algunas acciones cuando se utiliza la API. Por ejemplo, utilizar la API para crear contenido rápidamente, encuestar agresivamente en vez de utilizar webhooks, hacer solicitudes múltiples concurrentes, o solicitar repetidamente datos que son caros a nivel computacional, podría dar como resultado un límite de tasa secundaria.
|
||||
|
||||
Secondary rate limits are not intended to interfere with legitimate use of the API. Your normal rate limits should be the only limit you target. To ensure you're acting as a good API citizen, check out our [Best Practices guidelines](/guides/best-practices-for-integrators/).
|
||||
No se pretende que los límites de tasa secundaria interfieran con el uso legítimo de la API. Tus límites de tasa habituales deben ser el único límite en el cual te enfoques. Para asegurarse de que actúa como un buen ciudadano de API, consulte nuestras [Instrucciones de procedimientos recomendados](/guides/best-practices-for-integrators/).
|
||||
|
||||
If your application triggers this rate limit, you'll receive an informative response:
|
||||
Si tu aplicación activa este límite de tasa, recibirás una respuesta informativa:
|
||||
|
||||
```shell
|
||||
> HTTP/2 403
|
||||
@@ -501,19 +467,17 @@ If your application triggers this rate limit, you'll receive an informative resp
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
## User agent required
|
||||
## Se requiere un agente de usuario
|
||||
|
||||
All API requests MUST include a valid `User-Agent` header. Requests with no `User-Agent`
|
||||
header will be rejected. We request that you use your {% data variables.product.product_name %} username, or the name of your
|
||||
application, for the `User-Agent` header value. This allows us to contact you if there are problems.
|
||||
Todas las solicitudes de API DEBEN incluir un encabezado `User-Agent` válido. Las solicitudes sin un encabezado `User-Agent` se rechazarán. Le pedimos que use el nombre de usuario de {% data variables.product.product_name %}, o el nombre de la aplicación, para el valor del encabezado `User-Agent`. Esto nos permite contactarte en caso de que haya algún problema.
|
||||
|
||||
Here's an example:
|
||||
Este es un ejemplo:
|
||||
|
||||
```shell
|
||||
User-Agent: Awesome-Octocat-App
|
||||
```
|
||||
|
||||
cURL sends a valid `User-Agent` header by default. If you provide an invalid `User-Agent` header via cURL (or via an alternative client), you will receive a `403 Forbidden` response:
|
||||
cURL envía un encabezado `User-Agent` válido de forma predeterminada. Si proporciona un encabezado `User-Agent` no válido mediante (o un cliente alternativo), recibirá una respuesta `403 Forbidden`:
|
||||
|
||||
```shell
|
||||
$ curl -IH 'User-Agent: ' {% data variables.product.api_url_pre %}/meta
|
||||
@@ -528,20 +492,15 @@ $ curl -IH 'User-Agent: ' {% data variables.product.api_url_pre %}/meta
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Conditional requests
|
||||
## Solicitudes condicionales
|
||||
|
||||
Most responses return an `ETag` header. Many responses also return a `Last-Modified` header. You can use the values
|
||||
of these headers to make subsequent requests to those resources using the
|
||||
`If-None-Match` and `If-Modified-Since` headers, respectively. If the resource
|
||||
has not changed, the server will return a `304 Not Modified`.
|
||||
La mayoría de las respuestas devuelven un encabezado `ETag`. Muchas respuestas también devuelven un encabezado `Last-Modified`. Puede usar los valores de estos encabezados para realizar solicitudes posteriores a esos recursos con los encabezados `If-None-Match` y `If-Modified-Since`, respectivamente. Si el recurso no ha cambiado, el servidor devolverá `304 Not Modified`.
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
{% tip %}
|
||||
|
||||
**Note**: Making a conditional request and receiving a 304 response does not
|
||||
count against your [Rate Limit](#rate-limiting), so we encourage you to use it
|
||||
whenever possible.
|
||||
**Nota**: Realizar una solicitud condicional y recibir una respuesta 304 no cuenta para el [límite de frecuencia](#rate-limiting), por lo que le recomendamos que lo use siempre que sea posible.
|
||||
|
||||
{% endtip %}
|
||||
|
||||
@@ -578,16 +537,12 @@ $ curl -I {% data variables.product.api_url_pre %}/user -H "If-Modified-Since: T
|
||||
> x-ratelimit-reset: 1372700873
|
||||
```
|
||||
|
||||
## Cross origin resource sharing
|
||||
## Uso compartido de recursos entre orígenes
|
||||
|
||||
The API supports Cross Origin Resource Sharing (CORS) for AJAX requests from
|
||||
any origin.
|
||||
You can read the [CORS W3C Recommendation](http://www.w3.org/TR/cors/), or
|
||||
[this intro](https://code.google.com/archive/p/html5security/wikis/CrossOriginRequestSecurity.wiki) from the
|
||||
HTML 5 Security Guide.
|
||||
La API es compatible con el Intercambio de recursos de origen Cruzado (CORS, por sus siglas en inglés) para las solicitudes de AJAX desde cualquier origen.
|
||||
Puede leer la [recomendación de CORS del W3C](http://www.w3.org/TR/cors/) o [esta introducción](https://code.google.com/archive/p/html5security/wikis/CrossOriginRequestSecurity.wiki) de la Guía de seguridad de HTML 5.
|
||||
|
||||
Here's a sample request sent from a browser hitting
|
||||
`http://example.com`:
|
||||
Esta es una solicitud de ejemplo enviada desde un explorador destinada a `http://example.com`:
|
||||
|
||||
```shell
|
||||
$ curl -I {% data variables.product.api_url_pre %} -H "Origin: http://example.com"
|
||||
@@ -596,7 +551,7 @@ Access-Control-Allow-Origin: *
|
||||
Access-Control-Expose-Headers: ETag, Link, X-GitHub-OTP, x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset, X-OAuth-Scopes, X-Accepted-OAuth-Scopes, X-Poll-Interval
|
||||
```
|
||||
|
||||
This is what the CORS preflight request looks like:
|
||||
Así se ve una solicitud de prevuelo de CORS:
|
||||
|
||||
```shell
|
||||
$ curl -I {% data variables.product.api_url_pre %} -H "Origin: http://example.com" -X OPTIONS
|
||||
@@ -608,13 +563,9 @@ Access-Control-Expose-Headers: ETag, Link, X-GitHub-OTP, x-ratelimit-limit, x-ra
|
||||
Access-Control-Max-Age: 86400
|
||||
```
|
||||
|
||||
## JSON-P callbacks
|
||||
## Rellamados de JSON-P
|
||||
|
||||
You can send a `?callback` parameter to any GET call to have the results
|
||||
wrapped in a JSON function. This is typically used when browsers want
|
||||
to embed {% data variables.product.product_name %} content in web pages by getting around cross domain
|
||||
issues. The response includes the same data output as the regular API,
|
||||
plus the relevant HTTP Header information.
|
||||
Puede enviar un parámetro `?callback` a cualquier llamada GET para que los resultados se encapsulen en una función JSON. Esto se suele usar cuando los exploradores quieren insertar contenido de {% data variables.product.product_name %} en páginas web evitando los problemas de dominios cruzados. La respuesta incluye la misma salida de datos que la API común, además de la información pertinente del encabezado HTTP.
|
||||
|
||||
```shell
|
||||
$ curl {% data variables.product.api_url_pre %}?callback=foo
|
||||
@@ -635,7 +586,7 @@ $ curl {% data variables.product.api_url_pre %}?callback=foo
|
||||
> })
|
||||
```
|
||||
|
||||
You can write a JavaScript handler to process the callback. Here's a minimal example you can try out:
|
||||
Puedes escribir un agente de JavaScript para procesar la rellamada. Aquí hay un ejemplo minimalista que puedes probar:
|
||||
|
||||
<html>
|
||||
<head>
|
||||
@@ -659,15 +610,13 @@ You can write a JavaScript handler to process the callback. Here's a minimal exa
|
||||
</body>
|
||||
</html>
|
||||
|
||||
All of the headers are the same String value as the HTTP Headers with one
|
||||
notable exception: Link. Link headers are pre-parsed for you and come
|
||||
through as an array of `[url, options]` tuples.
|
||||
Todos los encabezados son el mismo valor de cadena que los encabezados HTTP con una excepción concreta: Link. Los encabezados Link se analizan previamente de forma automática y se pasan como una matriz de tuplas `[url, options]`.
|
||||
|
||||
A link that looks like this:
|
||||
Un enlace que se ve así:
|
||||
|
||||
Link: <url1>; rel="next", <url2>; rel="foo"; bar="baz"
|
||||
|
||||
... will look like this in the Callback output:
|
||||
... se verá así en la salida de la rellamada:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -689,39 +638,39 @@ A link that looks like this:
|
||||
}
|
||||
```
|
||||
|
||||
## Timezones
|
||||
## Zonas horarias
|
||||
|
||||
Some requests that create new data, such as creating a new commit, allow you to provide time zone information when specifying or generating timestamps. We apply the following rules, in order of priority, to determine timezone information for such API calls.
|
||||
Algunas solicitudes que crean datos nuevos, tales como aquellas para crear una confirmación nueva, te permiten proporcionar información sobre la zona horaria cuando especificas o generas marcas de tiempo. Aplicamos las siguientes reglas, en orden de prioridad, para determinar la información de la zona horaria para los llamados a la API.
|
||||
|
||||
* [Explicitly providing an ISO 8601 timestamp with timezone information](#explicitly-providing-an-iso-8601-timestamp-with-timezone-information)
|
||||
* [Using the `Time-Zone` header](#using-the-time-zone-header)
|
||||
* [Using the last known timezone for the user](#using-the-last-known-timezone-for-the-user)
|
||||
* [Defaulting to UTC without other timezone information](#defaulting-to-utc-without-other-timezone-information)
|
||||
* [Proporcionar explícitamente una marca de tiempo ISO 8601 con la información de zona horaria](#explicitly-providing-an-iso-8601-timestamp-with-timezone-information)
|
||||
* [Uso del encabezado `Time-Zone`](#using-the-time-zone-header)
|
||||
* [Uso de la última zona horaria conocida para el usuario](#using-the-last-known-timezone-for-the-user)
|
||||
* [Uso predeterminado de UTC cuando no existe información sobre otra zona horaria](#defaulting-to-utc-without-other-timezone-information)
|
||||
|
||||
Note that these rules apply only to data passed to the API, not to data returned by the API. As mentioned in "[Schema](#schema)," timestamps returned by the API are in UTC time, ISO 8601 format.
|
||||
Toma en cuenta que estas reglas se aplican únicamente a los datos que se pasan a la API y no a los que esta devuelve. Como se ha mencionado en "[Esquema](#schema)", las marcas de tiempo devueltas por la API están en hora UTC, en formato ISO 8601.
|
||||
|
||||
### Explicitly providing an ISO 8601 timestamp with timezone information
|
||||
### Proporcionar explícitamente una marca de tiempo de tipo ISO 8601 con la información de la zona horaria
|
||||
|
||||
For API calls that allow for a timestamp to be specified, we use that exact timestamp. An example of this is the [Commits API](/rest/reference/git#commits).
|
||||
Para las llamadas a la API que permitan que se especifique una marca de tiempo, utilizamos esa marca de tiempo exacta. Un ejemplo de esto es [Commits API](/rest/reference/git#commits).
|
||||
|
||||
These timestamps look something like `2014-02-27T15:05:06+01:00`. Also see [this example](/rest/reference/git#example-input) for how these timestamps can be specified.
|
||||
Estas marcas de tiempo son similares a `2014-02-27T15:05:06+01:00`. Vea también [este ejemplo](/rest/reference/git#example-input) para saber cómo se pueden especificar estas marcas de tiempo.
|
||||
|
||||
### Using the `Time-Zone` header
|
||||
### Uso del encabezado `Time-Zone`
|
||||
|
||||
It is possible to supply a `Time-Zone` header which defines a timezone according to the [list of names from the Olson database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
|
||||
Es posible proporcionar un encabezado `Time-Zone` que defina una zona horaria según la [lista de nombres de la base de datos Olson](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
|
||||
|
||||
```shell
|
||||
$ curl -H "Time-Zone: Europe/Amsterdam" -X POST {% data variables.product.api_url_pre %}/repos/github/linguist/contents/new_file.md
|
||||
```
|
||||
|
||||
This means that we generate a timestamp for the moment your API call is made in the timezone this header defines. For example, the [Contents API](/rest/reference/repos#contents) generates a git commit for each addition or change and uses the current time as the timestamp. This header will determine the timezone used for generating that current timestamp.
|
||||
Esto significa que generamos una marca de tiempo para el momento en el se haga el llamado a tu API en la zona horaria que defina este encabezado. Por ejemplo, la [API Contents](/rest/reference/repos#contents) genera una confirmación de Git para cada adición o cambio, y usa la hora actual como marca de tiempo. Este encabezado determinará la zona horaria que se utiliza para generar la marca de tiempo actual.
|
||||
|
||||
### Using the last known timezone for the user
|
||||
### Utilizar la última zona horaria conocida para el usuario
|
||||
|
||||
If no `Time-Zone` header is specified and you make an authenticated call to the API, we use the last known timezone for the authenticated user. The last known timezone is updated whenever you browse the {% data variables.product.product_name %} website.
|
||||
Si no se especifica ningún encabezado `Time-Zone` y realiza una llamada autenticada a la API, se usa la última zona horaria conocida para el usuario autenticado. La última zona horaria conocida se actualiza cuando sea que busques el sitio web de {% data variables.product.product_name %}.
|
||||
|
||||
### Defaulting to UTC without other timezone information
|
||||
### Predeterminarse en UTC cuando no existe otra información sobre la zona horaria
|
||||
|
||||
If the steps above don't result in any information, we use UTC as the timezone to create the git commit.
|
||||
Si los pasos anteriores no dan como resultado ninguna información, utilizaremos UTC como la zona horaria para crear la confirmación de git.
|
||||
|
||||
[pagination-guide]: /guides/traversing-with-pagination
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Troubleshooting
|
||||
intro: Learn how to resolve the most common problems people encounter in the REST API.
|
||||
title: Solución de problemas
|
||||
intro: Aprende cómo resolver los problemas más comunes que las personas pueden encontrar en la API de REST.
|
||||
redirect_from:
|
||||
- /v3/troubleshooting
|
||||
versions:
|
||||
@@ -10,78 +10,73 @@ versions:
|
||||
ghec: '*'
|
||||
topics:
|
||||
- API
|
||||
ms.openlocfilehash: ecfa3a360ef9b042d96a1f80a2f0cde49390727f
|
||||
ms.sourcegitcommit: d2f0b59ed096b9e68ef8f6fa019cd925165762ec
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/29/2022
|
||||
ms.locfileid: '148184239'
|
||||
---
|
||||
|
||||
|
||||
|
||||
If you're encountering some oddities in the API, here's a list of resolutions to
|
||||
some of the problems you may be experiencing.
|
||||
Si detecta elementos extraños en la API, a continuación se muestra una lista de posibles soluciones a algunos de estos problemas que podrías experimentar.
|
||||
|
||||
{% ifversion api-date-versioning %}
|
||||
|
||||
## `400` error for an unsupported API version
|
||||
## Error `400` de una versión de API no admitida
|
||||
|
||||
You should use the `X-GitHub-Api-Version` header to specify an API version. For example:
|
||||
Debes usar el encabezado `X-GitHub-Api-Version` para especificar una versión de API. Por ejemplo:
|
||||
|
||||
```shell
|
||||
$ curl {% data reusables.rest-api.version-header %} https://api.github.com/zen
|
||||
```
|
||||
|
||||
If you specify a version that does not exist, you will receive a `400` error.
|
||||
Si especificas una versión que no existe, recibirás un error `400`.
|
||||
|
||||
For more information, see "[API Versions](/rest/overview/api-versions)."
|
||||
Para más información, consulta "[Versiones de API](/rest/overview/api-versions)".
|
||||
|
||||
{% endif %}
|
||||
|
||||
## `404` error for an existing repository
|
||||
## Error `404` para un repositorio existente
|
||||
|
||||
Typically, we send a `404` error when your client isn't properly authenticated.
|
||||
You might expect to see a `403 Forbidden` in these cases. However, since we don't
|
||||
want to provide _any_ information about private repositories, the API returns a
|
||||
`404` error instead.
|
||||
Habitualmente, enviamos un error `404` cuando el cliente no está correctamente autenticado.
|
||||
En estos caso, debería ver `403 Forbidden`. Pero como no queremos proporcionar _ningún_ tipo de información sobre los repositorios privados, en su lugar la API devuelve un error `404`.
|
||||
|
||||
To troubleshoot, ensure [you're authenticating correctly](/guides/getting-started/), [your OAuth access token has the required scopes](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), [third-party application restrictions][oap-guide] are not blocking access, and that [the token has not expired or been revoked](/github/authenticating-to-github/keeping-your-account-and-data-secure/token-expiration-and-revocation).
|
||||
Para solucionarlo, asegúrese de que [está autenticando correctamente](/guides/getting-started/), el [token de acceso de OAuth tiene los ámbitos necesarios](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/), las [restricciones de aplicaciones de terceros][oap-guide] no bloquean el acceso y que el [token no haya expirado ni se haya revocado](/github/authenticating-to-github/keeping-your-account-and-data-secure/token-expiration-and-revocation).
|
||||
|
||||
## Not all results returned
|
||||
## No se devolvieron todos los resultados
|
||||
|
||||
Most API calls accessing a list of resources (_e.g._, users, issues, _etc._) support
|
||||
pagination. If you're making requests and receiving an incomplete set of results, you're
|
||||
probably only seeing the first page. You'll need to request the remaining pages
|
||||
in order to get more results.
|
||||
La mayoría de las llamadas API que acceden a una lista de recursos (_por ejemplo_, usuarios, incidencias, _etc._ ) admiten la paginación. Si realiza solicitudes y recibe un conjunto de resultados incompleto, es probable que solo esté viendo la primera página. Tendrá que solicitar las páginas restantes para obtener más resultados.
|
||||
|
||||
It's important to *not* try and guess the format of the pagination URL. Not every
|
||||
API call uses the same structure. Instead, extract the pagination information from
|
||||
[the Link Header](/rest#pagination), which is sent with every request.
|
||||
Es importante que *no* intente adivinar el formato de la URL de paginación. No todas las llamadas API usan la misma estructura. En su lugar, puede extraer la información de paginación del [encabezado de vínculo](/rest#pagination), que se envía en todas las solicitudes.
|
||||
|
||||
[oap-guide]: https://developer.github.com/changes/2015-01-19-an-integrators-guide-to-organization-application-policies/
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
## Basic authentication errors
|
||||
## Errores de autenticación básicos
|
||||
|
||||
On November 13, 2020 username and password authentication to the REST API and the OAuth Authorizations API were deprecated and no longer work.
|
||||
Desde el 13 de noviembre de 2020, la autenticación con nombre de usuario y contraseña a la API de REST y a la API de Autorizaciones de OAuth se obsoletizaron y ya no funcionan.
|
||||
|
||||
### Using `username`/`password` for basic authentication
|
||||
### Uso de `username`/`password` para la autenticación básica
|
||||
|
||||
If you're using `username` and `password` for API calls, then they are no longer able to authenticate. For example:
|
||||
Si usa `username` y `password` para las llamadas API, ya no podrán autenticarse. Por ejemplo:
|
||||
|
||||
```bash
|
||||
curl -u my_user:my_password https://api.github.com/user/repos
|
||||
```
|
||||
|
||||
Instead, use a [{% data variables.product.pat_generic %}](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line) when testing endpoints or doing local development:
|
||||
En su lugar, usa un [{% data variables.product.pat_generic %}](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line) al probar puntos de conexión o realizar el desarrollo local:
|
||||
|
||||
```bash
|
||||
curl -H 'Authorization: Bearer my_access_token' https://api.github.com/user/repos
|
||||
```
|
||||
|
||||
For OAuth Apps, you should use the [web application flow](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow) to generate an OAuth token to use in the API call's header:
|
||||
Para las aplicaciones de OAuth, debe usar el [flujo de aplicación web](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow) para generar un token de OAuth que se usará en el encabezado de la llamada API:
|
||||
|
||||
```bash
|
||||
curl -H 'Authorization: Bearer my-oauth-token' https://api.github.com/user/repos
|
||||
```
|
||||
|
||||
## Timeouts
|
||||
## Tiempos de espera
|
||||
|
||||
If {% data variables.product.product_name %} takes more than 10 seconds to process an API request, {% data variables.product.product_name %} will terminate the request and you will receive a timeout response.
|
||||
Si a {% data variables.product.product_name %} le toma más de 10 segundos procesar una solicitud de la API, {% data variables.product.product_name %} terminará la solicitud y recibirás una respuesta de tiempo de espera excedido.
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -258,6 +258,8 @@ sections:
|
||||
- Reconfigure the IdP by uploading a static copy of the SAML metadata without the `WantAssertionsEncrypted` attribute.
|
||||
- Copy the SAML metadata, remove `WantAssertionsEncrypted` attribute, host it on a web server, and reconfigure the IdP to point to that URL.
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- |
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
deprecations:
|
||||
- heading: Deprecation of GitHub Enterprise Server 3.0
|
||||
notes:
|
||||
|
||||
@@ -55,6 +55,8 @@ sections:
|
||||
- Reconfigure the IdP by uploading a static copy of the SAML metadata without the `WantAssertionsEncrypted` attribute.
|
||||
- Copy the SAML metadata, remove `WantAssertionsEncrypted` attribute, host it on a web server, and reconfigure the IdP to point to that URL.
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- |
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
deprecations:
|
||||
- heading: Deprecation of GitHub Enterprise Server 3.0
|
||||
notes:
|
||||
|
||||
@@ -31,6 +31,8 @@ sections:
|
||||
After registering a self-hosted runner with the `--ephemeral` parameter on more than one level (for example, both enterprise and organization), the runner may get stuck in an idle state and require re-registration. [Updated: 2022-06-17]
|
||||
- After upgrading to {% data variables.product.prodname_ghe_server %} 3.4, releases may appear to be missing from repositories. This can occur when the required Elasticsearch index migrations have not successfully completed.
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- |
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
deprecations:
|
||||
- heading: Deprecation of GitHub Enterprise Server 3.0
|
||||
notes:
|
||||
|
||||
@@ -37,4 +37,6 @@ sections:
|
||||
- |
|
||||
After registering a self-hosted runner with the `--ephemeral` parameter on more than one level (for example, both enterprise and organization), the runner may get stuck in an idle state and require re-registration. [Updated: 2022-06-17]
|
||||
- After upgrading to {% data variables.product.prodname_ghe_server %} 3.4 releases may appear to be missing from repositories. This can occur when the required Elasticsearch index migrations have not successfully completed.
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- |
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
@@ -28,4 +28,6 @@ sections:
|
||||
- |
|
||||
After registering a self-hosted runner with the `--ephemeral` parameter on more than one level (for example, both enterprise and organization), the runner may get stuck in an idle state and require re-registration. [Updated: 2022-06-17]
|
||||
- After upgrading to {% data variables.product.prodname_ghe_server %} 3.4, releases may appear to be missing from repositories. This can occur when the required Elasticsearch index migrations have not successfully completed.
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- |
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
@@ -27,4 +27,6 @@ sections:
|
||||
- |
|
||||
After registering a self-hosted runner with the `--ephemeral` parameter on more than one level (for example, both enterprise and organization), the runner may get stuck in an idle state and require re-registration.
|
||||
- After upgrading to {% data variables.product.prodname_ghe_server %} 3.4, releases may appear to be missing from repositories. This can occur when the required Elasticsearch index migrations have not successfully completed.
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- |
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
@@ -32,3 +32,5 @@ sections:
|
||||
After registering a self-hosted runner with the `--ephemeral` parameter on more than one level (for example, both enterprise and organization), the runner may get stuck in an idle state and require re-registration. [Updated: 2022-06-17]
|
||||
- After upgrading to {% data variables.product.prodname_ghe_server %} 3.4, releases may appear to be missing from repositories. This can occur when the required Elasticsearch index migrations have not successfully completed.
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- |
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
@@ -24,3 +24,5 @@ sections:
|
||||
After registering a self-hosted runner with the `--ephemeral` parameter on more than one level (for example, both enterprise and organization), the runner may get stuck in an idle state and require re-registration. [Updated: 2022-06-17]
|
||||
- After upgrading to {% data variables.product.prodname_ghe_server %} 3.4, releases may appear to be missing from repositories. This can occur when the required Elasticsearch index migrations have not successfully completed.
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- |
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
@@ -24,3 +24,5 @@ sections:
|
||||
After registering a self-hosted runner with the `--ephemeral` parameter on more than one level (for example, both enterprise and organization), the runner may get stuck in an idle state and require re-registration. [Updated: 2022-06-17]
|
||||
- After upgrading to {% data variables.product.prodname_ghe_server %} 3.4, releases may appear to be missing from repositories. This can occur when the required Elasticsearch index migrations have not successfully completed.
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- |
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
@@ -27,4 +27,6 @@ sections:
|
||||
- The {% data variables.product.prodname_registry %} npm registry no longer returns a time value in metadata responses. This was done to allow for substantial performance improvements. We continue to have all the data necessary to return a time value as part of the metadata response and will resume returning this value in the future once we have solved the existing performance issues.
|
||||
- Resource limits that are specific to processing pre-receive hooks may cause some pre-receive hooks to fail.
|
||||
- Actions services need to be restarted after restoring an appliance from a backup taken on a different host.
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}'
|
||||
- |
|
||||
GitHub Pages builds may time out on instances in AWS that are configured for high availability. [Updated: 2022-11-28]
|
||||
@@ -0,0 +1,9 @@
|
||||
---
|
||||
ms.openlocfilehash: a95067136ba91760fb48dae77a42cf9b9377dbeb
|
||||
ms.sourcegitcommit: 7a74d5796695bb21c30e4031679253cbc16ceaea
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/28/2022
|
||||
ms.locfileid: "148184067"
|
||||
---
|
||||
Después de habilitar el inicio de sesión único de SAML, es posible que sea necesario revocar y volver a aplicar las autorizaciones de {% data variables.product.prodname_oauth_app %} y {% data variables.product.prodname_github_app %} para que tengan acceso a la organización. Para obtener más información, consulta "[Autorización de {% data variables.product.prodname_oauth_apps %}](/authentication/keeping-your-account-and-data-secure/authorizing-oauth-apps#oauth-apps-and-organizations)."
|
||||
@@ -1,192 +1,116 @@
|
||||
| Category name | Description
|
||||
---
|
||||
ms.openlocfilehash: 1dd9305ca2b7cb3e8d25d697de8ae3a83e0c46bb
|
||||
ms.sourcegitcommit: 7a74d5796695bb21c30e4031679253cbc16ceaea
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/28/2022
|
||||
ms.locfileid: "148183984"
|
||||
---
|
||||
| Nombre de la categoría | Descripción
|
||||
|------------------|-------------------
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `account` | Contains activities related to an organization account.
|
||||
| `advisory_credit` | Contains activities related to crediting a contributor for a security advisory in the {% data variables.product.prodname_advisory_database %}. For more information, see "[About {% data variables.product.prodname_dotcom %} Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)."
|
||||
{%- endif %}
|
||||
| `artifact` | Contains activities related to {% data variables.product.prodname_actions %} workflow run artifacts.
|
||||
{%- ifversion audit-log-streaming %}
|
||||
| `audit_log_streaming` | Contains activities related to streaming audit logs for organizations in an enterprise account.
|
||||
{%- endif %}
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `billing` | Contains activities related to an organization's billing.
|
||||
{%- endif %}
|
||||
{%- ifversion ghec or ghes or ghae %}
|
||||
| `business` | Contains activities related to business settings for an enterprise.
|
||||
{%- endif %}
|
||||
{%- ifversion code-security-audit-log-events %}
|
||||
| `business_advanced_security` | Contains activities related to {% data variables.product.prodname_GH_advanced_security %} in an enterprise. For more information, see "[Managing {% data variables.product.prodname_GH_advanced_security %} features for your enterprise](/admin/code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise)."
|
||||
| `business_secret_scanning` | Contains activities related to {% data variables.product.prodname_secret_scanning %} in an enterprise. For more information, see "[Managing {% data variables.product.prodname_GH_advanced_security %} features for your enterprise](/admin/code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise)."
|
||||
{%- endif %}
|
||||
{%- ifversion secret-scanning-audit-log-custom-patterns %}
|
||||
| `business_secret_scanning_custom_pattern` | Contains activities related to custom patterns for {% data variables.product.prodname_secret_scanning %} in an enterprise.
|
||||
{%- endif %}
|
||||
{%- ifversion code-security-audit-log-events %}
|
||||
| `business_secret_scanning_push_protection` | Contains activities related to the push protection feature of {% data variables.product.prodname_secret_scanning %} in an enterprise. For more information, see "[Managing {% data variables.product.prodname_GH_advanced_security %} features for your enterprise](/admin/code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise)."
|
||||
| `business_secret_scanning_push_protection_custom_message` | Contains activities related to the custom message displayed when push protection is triggered in an enterprise. For more information, see "[Managing {% data variables.product.prodname_GH_advanced_security %} features for your enterprise](/admin/code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise)."
|
||||
{%- endif %}
|
||||
| `checks` | Contains activities related to check suites and runs.
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `codespaces` | Contains activities related to an organization's codespaces.
|
||||
{%- endif %}
|
||||
| `commit_comment` | Contains activities related to updating or deleting commit comments.
|
||||
{%- ifversion ghes %}
|
||||
| `config_entry` | Contains activities related to configuration settings. These events are only visible in the site admin audit log.
|
||||
{%- endif %}
|
||||
| `dependabot_alerts` | Contains organization-level configuration activities for {% data variables.product.prodname_dependabot_alerts %} in existing repositories. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/dependabot/dependabot-alerts/about-dependabot-alerts)."
|
||||
| `dependabot_alerts_new_repos` | Contains organization-level configuration activities for {% data variables.product.prodname_dependabot_alerts %} in new repositories created in the organization.
|
||||
| `dependabot_repository_access` | Contains activities related to which private repositories in an organization {% data variables.product.prodname_dependabot %} is allowed to access.
|
||||
{%- ifversion fpt or ghec or ghes %}
|
||||
| `dependabot_security_updates` | Contains organization-level configuration activities for {% data variables.product.prodname_dependabot_security_updates %} in existing repositories. For more information, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-dependabot-security-updates)."
|
||||
| `dependabot_security_updates_new_repos` | Contains organization-level configuration activities for {% data variables.product.prodname_dependabot_security_updates %} for new repositories created in the organization.
|
||||
{%- endif %}
|
||||
| `dependency_graph` | Contains organization-level configuration activities for dependency graphs for repositories. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)."
|
||||
| `dependency_graph_new_repos` | Contains organization-level configuration activities for new repositories created in the organization.
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `discussion` | Contains activities related to team discussions.
|
||||
| `discussion_comment` | Contains activities related to comments posted in discussions on a team page.
|
||||
| `discussion_post` | Contains activities related to discussions posted to a team page.
|
||||
| `discussion_post_reply` | Contains activities related to replies to discussions posted to a team page.
|
||||
{%- endif %}
|
||||
{%- ifversion ghec or ghes %}
|
||||
| `dotcom_connection` | Contains activities related to {% data variables.product.prodname_github_connect %}.
|
||||
| `enterprise` | Contains activities related to enterprise settings.
|
||||
{%- endif %}
|
||||
{%- ifversion ghec %}
|
||||
| `enterprise_domain` | Contains activities related to verified enterprise domains.
|
||||
| `enterprise_installation` | Contains activities related to {% data variables.product.prodname_github_app %}s associated with an {% data variables.product.prodname_github_connect %} enterprise connection.
|
||||
{%- endif %}
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `environment` | Contains activities related to {% data variables.product.prodname_actions %} environments.
|
||||
{%- endif %}
|
||||
{%- ifversion ghae %}
|
||||
| `external_group` | Contains activities related to Okta groups.
|
||||
| `external_identity` | Contains activities related to a user in an Okta group.
|
||||
{%- endif %}
|
||||
| `gist` | Contains activities related to Gists.
|
||||
| `hook` | Contains activities related to webhooks.
|
||||
| `integration` | Contains activities related to integrations in an account.
|
||||
| `integration_installation` | Contains activities related to integrations installed in an account.
|
||||
| `integration_installation_request` | Contains activities related to organization member requests for owners to approve integrations for use in the organization.
|
||||
{%- ifversion ghec or ghae %}
|
||||
| `ip_allow_list` | Contains activities related to enabling or disabling the IP allow list for an organization.
|
||||
| `ip_allow_list_entry` | Contains activities related to the creation, deletion, and editing of an IP allow list entry for an organization.
|
||||
{%- endif %}
|
||||
| `issue` | Contains activities related to pinning, transferring, or deleting an issue in a repository.
|
||||
| `issue_comment` | Contains activities related to pinning, transferring, or deleting issue comments.
|
||||
| `issues` | Contains activities related to enabling or disabling issue creation for an organization.
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `marketplace_agreement_signature` | Contains activities related to signing the {% data variables.product.prodname_marketplace %} Developer Agreement.
|
||||
| `marketplace_listing` | Contains activities related to listing apps in {% data variables.product.prodname_marketplace %}.
|
||||
{%- endif %}
|
||||
| `members_can_create_pages` | Contains activities related to managing the publication of {% data variables.product.prodname_pages %} sites for repositories in the organization. For more information, see "[Managing the publication of {% data variables.product.prodname_pages %} sites for your organization](/organizations/managing-organization-settings/managing-the-publication-of-github-pages-sites-for-your-organization)."
|
||||
| `members_can_create_private_pages` | Contains activities related to managing the publication of private {% data variables.product.prodname_pages %} sites for repositories in the organization.
|
||||
| `members_can_create_public_pages` | Contains activities related to managing the publication of public {% data variables.product.prodname_pages %} sites for repositories in the organization.
|
||||
{%- ifversion ghec or ghes or ghae %}
|
||||
| `members_can_delete_repos` | Contains activities related to enabling or disabling repository creation for an organization.
|
||||
{%- endif %}
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `members_can_view_dependency_insights` | Contains organization-level configuration activities allowing organization members to view dependency insights.
|
||||
| `migration` | Contains activities related to transferring data from a *source* location (such as a {% data variables.product.prodname_dotcom_the_website %} organization or a {% data variables.product.prodname_ghe_server %} instance) to a *target* {% data variables.product.prodname_ghe_server %} instance.
|
||||
{%- endif %}
|
||||
| `oauth_access` | Contains activities related to OAuth access tokens.
|
||||
| `oauth_application` | Contains activities related to OAuth Apps.
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `oauth_authorization` | Contains activities related to authorizing OAuth Apps.
|
||||
{%- endif %}
|
||||
| `org` | Contains activities related to organization membership.
|
||||
{%- ifversion ghec or ghes or ghae %}
|
||||
| `org_credential_authorization` | Contains activities related to authorizing credentials for use with SAML single sign-on.
|
||||
{%- endif %}
|
||||
{%- ifversion secret-scanning-audit-log-custom-patterns %}
|
||||
| `org_secret_scanning_custom_pattern` | Contains activities related to custom patterns for secret scanning in an organization. For more information, see "[Defining custom patterns for secret scanning](/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning)."
|
||||
| `org.secret_scanning_push_protection` | Contains activities related to secret scanning custom patterns in an organization. For more information, see "[Protecting pushes with secret scanning](/code-security/secret-scanning/protecting-pushes-with-secret-scanning)."
|
||||
{%- endif %}
|
||||
| `organization_default_label` | Contains activities related to default labels for repositories in an organization.
|
||||
{%- ifversion fpt or ghec or ghes %}
|
||||
| `organization_domain` | Contains activities related to verified organization domains.
|
||||
| `organization_projects_change` | Contains activities related to organization-wide project boards in an enterprise.
|
||||
{%- endif %}
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `pages_protected_domain` | Contains activities related to verified custom domains for {% data variables.product.prodname_pages %}.
|
||||
| `payment_method` | Contains activities related to how an organization pays for {% data variables.product.prodname_dotcom %}.
|
||||
| `prebuild_configuration` | Contains activities related to prebuild configurations for {% data variables.product.prodname_github_codespaces %}.
|
||||
{%- endif %}
|
||||
{%- ifversion ghes %}
|
||||
| `pre_receive_environment` | Contains activities related to pre-receive hook environments.
|
||||
| `pre_receive_hook` | Contains activities related to pre-receive hooks.
|
||||
{%- endif %}
|
||||
{%- ifversion ghes %}
|
||||
| `private_instance_encryption` | Contains activities related to enabling private mode for an enterprise.
|
||||
{%- endif %}
|
||||
| `private_repository_forking` | Contains activities related to allowing forks of private and internal repositories, for a repository, organization or enterprise.
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `profile_picture` | Contains activities related to an organization's profile picture.
|
||||
{%- endif %}
|
||||
| `project` | Contains activities related to project boards.
|
||||
| `project_field` | Contains activities related to field creation and deletion in a project board.
|
||||
| `project_view` | Contains activities related to view creation and deletion in a project board.
|
||||
| `protected_branch` | Contains activities related to protected branches.
|
||||
| `public_key` | Contains activities related to SSH keys and deploy keys.
|
||||
| `pull_request` | Contains activities related to pull requests.
|
||||
| `pull_request_review` | Contains activities related to pull request reviews.
|
||||
| `pull_request_review_comment` | Contains activities related to pull request review comments.
|
||||
| `repo` | Contains activities related to the repositories owned by an organization.
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `repository_advisory` | Contains repository-level activities related to security advisories in the {% data variables.product.prodname_advisory_database %}. For more information, see "[About {% data variables.product.prodname_dotcom %} Security Advisories](/github/managing-security-vulnerabilities/about-github-security-advisories)."
|
||||
| `repository_content_analysis` | Contains activities related to [enabling or disabling data use for a private repository](/articles/about-github-s-use-of-your-data).
|
||||
| `repository_dependency_graph` | Contains repository-level activities related to enabling or disabling the dependency graph for a {% ifversion fpt or ghec %}private {% endif %}repository. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)."
|
||||
{%- endif %}
|
||||
| `repository_image` | Contains activities related to images for a repository.
|
||||
| `repository_invitation` | Contains activities related to invitations to join a repository.
|
||||
| `repository_projects_change` | Contains activities related to enabling projects for a repository or for all repositories in an organization.
|
||||
{%- ifversion ghec or ghes or ghae %}
|
||||
| `repository_secret_scanning` | Contains repository-level activities related to secret scanning. For more information, see "[About secret scanning](/github/administering-a-repository/about-secret-scanning)."
|
||||
{%- endif %}
|
||||
{%- ifversion secret-scanning-audit-log-custom-patterns %}
|
||||
| `repository_secret_scanning_custom_pattern` | Contains activities related to secret scanning custom patterns in a repository. For more information, see "[Defining custom patterns for secret scanning](/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning)." {% endif %}{% ifversion secret-scanning-audit-log-custom-patterns %}
|
||||
| `repository_secret_scanning_push_protection` | Contains activities related to secret scanning custom patterns in a repository. For more information, see "[Protecting pushes with secret scanning](/code-security/secret-scanning/protecting-pushes-with-secret-scanning)."
|
||||
{%- endif %}
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `repository_visibility_change` | Contains activities related to allowing organization members to change repository visibilities for the organization.
|
||||
{%- endif %}
|
||||
| `repository_vulnerability_alert` | Contains activities related to [{% data variables.product.prodname_dependabot_alerts %}](/code-security/dependabot/dependabot-alerts/about-dependabot-alerts).
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `repository_vulnerability_alerts` | Contains repository-level configuration activities for {% data variables.product.prodname_dependabot_alerts %}.
|
||||
| `required_status_check` | Contains activities related to required status checks for protected branches.
|
||||
{%- endif %}
|
||||
{%- ifversion ghec or ghes %}
|
||||
| `restrict_notification_delivery` | Contains activities related to the restriction of email notifications to approved or verified domains for an enterprise.
|
||||
{%- endif %}
|
||||
{%- ifversion custom-repository-roles %}
|
||||
| `role` | Contains activities related to [custom repository roles](/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).
|
||||
{%- endif %}
|
||||
{%- ifversion ghec or ghes or ghae %}
|
||||
| `secret_scanning` | Contains organization-level configuration activities for secret scanning in existing repositories. For more information, see "[About secret scanning](/github/administering-a-repository/about-secret-scanning)."
|
||||
| `secret_scanning_new_repos` | Contains organization-level configuration activities for secret scanning for new repositories created in the organization.
|
||||
{%- endif %}
|
||||
{%- ifversion ghec or ghes or ghae %}
|
||||
| `security_key` | Contains activities related to security keys registration and removal.
|
||||
{%- endif %}
|
||||
{%- ifversion fpt or ghec %}
|
||||
| `sponsors` | Contains events related to sponsor buttons (see "[Displaying a sponsor button in your repository](/articles/displaying-a-sponsor-button-in-your-repository)").
|
||||
{%- endif %}
|
||||
{%- ifversion ghec or ghes or ghae %}
|
||||
| `ssh_certificate_authority` | Contains activities related to a SSH certificate authority in an organization or enterprise.
|
||||
| `ssh_certificate_requirement` | Contains activities related to requiring members use SSH certificates to access organization resources.
|
||||
{%- endif %}{% ifversion sso-redirect %}
|
||||
| `sso_redirect` | Contains activities related to automatically redirecting users to sign in (see "[Enforcing policies for security settings in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-sso-for-unauthenticated-users)").{% endif %}
|
||||
| `staff` | Contains activities related to a site admin performing an action.
|
||||
| `team` | Contains activities related to teams in an organization.
|
||||
| `team_discussions` | Contains activities related to managing team discussions for an organization.
|
||||
{%- ifversion ghec %}
|
||||
| `team_sync_tenant` | Contains activities related to team synchronization with an IdP for an enterprise or organization.
|
||||
{%- endif %}
|
||||
{%- ifversion fpt or ghes %}
|
||||
| `two_factor_authentication` | Contains activities related to two-factor authentication.
|
||||
{%- endif %}
|
||||
| `user` | Contains activities related to users in an enterprise or organization.
|
||||
{%- ifversion ghec or ghes %}
|
||||
| `user_license` | Contains activities related to a user occupying a licensed seat in, and being a member of, an enterprise.
|
||||
{%- endif %}
|
||||
| `workflows` | Contains activities related to {% data variables.product.prodname_actions %} workflows.
|
||||
{%- ifversion fpt or ghec %} | `account` | Contiene las actividades relacionadas con una cuenta de la organización.
|
||||
| `advisory_credit` | Contiene las actividades relacionadas con darle crédito a un contribuyente por una asesoría de seguridad en la {% data variables.product.prodname_advisory_database %}. Para obtener más información, consulta "[Acerca de los avisos de seguridad de {% data variables.product.prodname_dotcom %}](/github/managing-security-vulnerabilities/about-github-security-advisories)".
|
||||
{%- endif %} | `artifact` | Contiene las actividades relacionadas con los artefactos de ejecución de flujo de trabajo de {% data variables.product.prodname_actions %}.
|
||||
{%- ifversion audit-log-streaming %} | `audit_log_streaming` | Contiene las actividades relacionadas con la transmisión de registros de auditoría para las organizaciones de una cuenta empresarial.
|
||||
{%- endif %} {%- ifversion fpt or ghec %} | `billing` | Contiene las actividades relacionadas con la facturación de una organización.
|
||||
{%- endif %} {%- ifversion ghec or ghes or ghae %} | `business` | Contiene las actividades relacionadas con la configuración de negocio de una empresa.
|
||||
{%- endif %} {%- ifversion code-security-audit-log-events %} | `business_advanced_security` | Contiene actividades relacionadas con {% data variables.product.prodname_GH_advanced_security %} en una empresa. Para obtener más información, consulta "[Administración de características de {% data variables.product.prodname_GH_advanced_security %} para la empresa](/admin/code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise)".
|
||||
| `business_secret_scanning` | Contiene actividades relacionadas con {% data variables.product.prodname_secret_scanning %} en una empresa. Para obtener más información, consulta "[Administración de características de {% data variables.product.prodname_GH_advanced_security %} para la empresa](/admin/code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise)".
|
||||
{%- endif %} {%- ifversion secret-scanning-audit-log-custom-patterns %} | `business_secret_scanning_custom_pattern` | Contiene actividades relacionadas con patrones personalizados para {% data variables.product.prodname_secret_scanning %} en una empresa.
|
||||
{%- endif %} {%- ifversion code-security-audit-log-events %} | `business_secret_scanning_push_protection` | Contiene actividades relacionadas con la característica de protección de inserción de {% data variables.product.prodname_secret_scanning %} en una empresa. Para obtener más información, consulta "[Administración de características de {% data variables.product.prodname_GH_advanced_security %} para la empresa](/admin/code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise)".
|
||||
| `business_secret_scanning_push_protection_custom_message` | Contiene actividades relacionadas con el mensaje personalizado que se muestra cuando se desencadena la protección de inserción en una empresa. Para obtener más información, consulta "[Administración de características de {% data variables.product.prodname_GH_advanced_security %} para la empresa](/admin/code-security/managing-github-advanced-security-for-your-enterprise/managing-github-advanced-security-features-for-your-enterprise)".
|
||||
{%- endif %} | `checks` | Contiene las actividades relacionadas con la comprobación de conjuntos de pruebas y ejecuciones.
|
||||
{%- ifversion fpt or ghec %} | `codespaces` | Contiene las actividades relacionadas con los codespaces de una organización.
|
||||
{%- endif %} | `commit_comment` | Contiene las actividades relacionadas con la actualización o eliminación de comentarios de confirmación.
|
||||
{%- ifversion ghes %} | `config_entry` | Contiene actividades relacionadas con las opciones de configuración. Estos eventos solo son visibles en el registro de auditoría del administrador del sitio.
|
||||
{%- endif %} | `dependabot_alerts` | Contiene actividades de configuración a nivel de organización para {% data variables.product.prodname_dependabot_alerts %} en los repositorios existentes. Para más información, vea "[Acerca de {% data variables.product.prodname_dependabot_alerts %}](/code-security/dependabot/dependabot-alerts/about-dependabot-alerts)".
|
||||
| `dependabot_alerts_new_repos` | Contiene las actividades de configuración a nivel de organización para las {% data variables.product.prodname_dependabot_alerts %} en los repositorios nuevos que se crearon en la organización.
|
||||
| `dependabot_repository_access` | Contiene las actividades relacionadas con los repositorios privados de una organización para los que {% data variables.product.prodname_dependabot %} tiene permiso de acceso.
|
||||
{%- ifversion fpt or ghec or ghes %} | `dependabot_security_updates` | Contiene actividades de configuración a nivel de organización para {% data variables.product.prodname_dependabot_security_updates %} en los repositorios existentes. Para obtener más información, consulta "[Configuración de {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-dependabot-security-updates)".
|
||||
| `dependabot_security_updates_new_repos` | Contiene las actividades de configuración a nivel de organización para {% data variables.product.prodname_dependabot_security_updates %} para los repositorios nuevos que se crean en ella.
|
||||
{%- endif %} | `dependency_graph` | Contiene las actividades de configuración a nivel de organización para los gráficos de dependencias de los repositorios. Para obtener más información, consulta "[Acerca del gráfico de dependencias](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)".
|
||||
| `dependency_graph_new_repos` | Contiene las actividades de configuración a nivel de organización para los repositorios nuevos que se crean en ella.
|
||||
{%- ifversion fpt or ghec %} | `discussion` | Contiene las actividades relacionadas con los debates de equipo.
|
||||
| `discussion_comment` | Contiene las actividades relacionadas con los comentarios publicados en los debates de una página de equipo.
|
||||
| `discussion_post` | Contiene las actividades relacionadas con los debates publicados en una página de equipo.
|
||||
| `discussion_post_reply` | Contiene las actividades relacionadas con las respuestas a los debates publicados en una página de equipo.
|
||||
{%- endif %} {%- ifversion ghec or ghes %} | `dotcom_connection` | Contiene las actividades relacionadas con {% data variables.product.prodname_github_connect %}.
|
||||
| `enterprise` | Contiene las actividades relacionadas con la configuración de la empresa.
|
||||
{%- endif %} {%- ifversion ghec %} | `enterprise_domain` | Contiene las actividades relacionadas con los dominios verificados de la empresa.
|
||||
| `enterprise_installation` | Contiene las actividades relacionadas con las {% data variables.product.prodname_github_app %} asociadas con una conexión empresarial de {% data variables.product.prodname_github_connect %}.
|
||||
{%- endif %} {%- ifversion fpt or ghec %} | `environment` | Contiene las actividades relacionadas con los entornos de {% data variables.product.prodname_actions %}.
|
||||
{%- endif %} {%- ifversion ghae %} | `external_group` | Contiene las actividades relacionadas con los grupos de Okta.
|
||||
| `external_identity` | Contiene las actividades relacionadas con un usuario de un grupo de Okta.
|
||||
{%- endif %} | `gist` | Contiene actividades relacionadas con Gists.
|
||||
| `hook` | Contiene las actividades relacionadas con los webhooks.
|
||||
| `integration` | Contiene las actividades relacionadas con las integraciones de una cuenta.
|
||||
| `integration_installation` | Contiene las actividades relacionadas con las integraciones instaladas en una cuenta.
|
||||
| `integration_installation_request` | Contiene las actividades relacionadas con las solicitudes de los miembros de una organización para que los propietarios aprueben integraciones para su uso en la organización.
|
||||
{%- ifversion ghec or ghae %} | `ip_allow_list` | Contiene las actividades relacionadas con la habilitación o deshabilitación de la lista de direcciones IP permitidas de una organización.
|
||||
| `ip_allow_list_entry` | Contiene las actividades relacionadas con la creación, eliminación y edición de una entrada en una lista de direcciones IP permitidas de una organización.
|
||||
{%- endif %} | `issue` | Contiene las actividades relacionadas con el anclaje, transferencia o eliminación de una propuesta en un repositorio.
|
||||
| `issue_comment` | Contiene las actividades relacionadas con el anclaje, transferencia o eliminación de comentarios de propuestas.
|
||||
| `issues` | Contiene las actividades relacionadas con la habilitación o deshabilitación de la creación de propuestas para una organización.
|
||||
{%- ifversion fpt or ghec %} | `marketplace_agreement_signature` | Contiene las actividades relacionadas con la firma del Acuerdo para desarrolladores de {% data variables.product.prodname_marketplace %}.
|
||||
| `marketplace_listing` | Contiene las actividades relacionadas con la publicación de aplicaciones en {% data variables.product.prodname_marketplace %}.
|
||||
{%- endif %} | `members_can_create_pages` | Contiene las actividades relacionadas con la administración de la publicación de sitios de {% data variables.product.prodname_pages %} para repositorios de la organización. Para obtener más información, consulta "[Administración de la publicación de sitios de {% data variables.product.prodname_pages %} para la organización](/organizations/managing-organization-settings/managing-the-publication-of-github-pages-sites-for-your-organization)".
|
||||
| `members_can_create_private_pages` | Contiene las actividades relacionadas con la administración de la publicación de sitios de {% data variables.product.prodname_pages %} privados para repositorios de la organización.
|
||||
| `members_can_create_public_pages` | Contiene las actividades relacionadas con la administración de la publicación de sitios de {% data variables.product.prodname_pages %} públicos para repositorios de la organización.
|
||||
{%- ifversion ghec or ghes or ghae %} | `members_can_delete_repos` | Contiene las actividades relacionadas con la habilitación o deshabilitación de la creación de repositorios para una organización.
|
||||
{%- endif %} {%- ifversion fpt or ghec %} | `members_can_view_dependency_insights` | Contiene las actividades de configuración a nivel de organización que permiten a los miembros de la organización ver la información sobre dependencias.
|
||||
| `migration` | Contiene las actividades relacionadas con la transferencia de datos desde una ubicación de *origen* (como, por ejemplo, una organización de {% data variables.product.prodname_dotcom_the_website %} o una instancia de {% data variables.product.prodname_ghe_server %}) a una instancia de {% data variables.product.prodname_ghe_server %} de *destino*.
|
||||
{%- endif %} | `oauth_access` | Contiene las actividades relacionadas con los tokens de acceso de OAuth.
|
||||
| `oauth_application` | Contiene las actividades relacionadas con las aplicaciones de OAuth.
|
||||
{%- ifversion fpt or ghec %} | `oauth_authorization` | Contiene las actividades relacionadas con la autorización de aplicaciones de OAuth.
|
||||
{%- endif %} | `org` | Contiene las actividades relacionadas con la pertenencia a la organización.
|
||||
{%- ifversion ghec or ghes or ghae %} | `org_credential_authorization` | Contiene las actividades relacionadas con la autorización de credenciales para su uso con el inicio de sesión único de SAML.
|
||||
{%- endif %} {%- ifversion secret-scanning-audit-log-custom-patterns %} | `org_secret_scanning_custom_pattern` | Contiene las actividades relacionadas con los patrones personalizados para el análisis de secretos de una organización. Para obtener más información, consulta "[Definición de patrones personalizados para el análisis de secretos](/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning)".
|
||||
| `org.secret_scanning_push_protection` | Contiene las actividades relacionadas con los patrones personalizados de análisis de secretos de una organización. Para obtener más información, consulta "[Protección de inserciones para el análisis de secretos](/code-security/secret-scanning/protecting-pushes-with-secret-scanning)".
|
||||
{%- endif %} | `organization_default_label` | Contiene las actividades relacionadas con las etiquetas predeterminadas para los repositorios de una organización.
|
||||
{%- ifversion fpt or ghec or ghes %} | `organization_domain` | Contiene las actividades relacionadas con los dominios verificados de una organización.
|
||||
| `organization_projects_change` | Contiene las actividades relacionadas con los paneles de proyecto de toda la organización de una empresa.
|
||||
{%- endif %} {%- ifversion fpt or ghec %} | `pages_protected_domain` | Contiene las actividades relacionadas con los dominios personalizados verificados para {% data variables.product.prodname_pages %}.
|
||||
| `payment_method` | Contiene las actividades relacionadas con cómo una organización paga {% data variables.product.prodname_dotcom %}.
|
||||
| `prebuild_configuration` | Contiene las actividades relacionadas con las configuraciones precompiladas para {% data variables.product.prodname_github_codespaces %}.
|
||||
{%- endif %} {%- ifversion ghes %} | `pre_receive_environment` | Contiene las actividades relacionadas con los entornos de enlace previo a la recepción.
|
||||
| `pre_receive_hook` | Contiene las actividades relacionadas con los enlaces previos a la recepción.
|
||||
{%- endif %} {%- ifversion ghes %} | `private_instance_encryption` | Contiene las actividades relacionadas con la habilitación del modo privado para una empresa.
|
||||
{%- endif %} | `private_repository_forking` | Contiene las actividades relacionadas con la habilitación de bifurcaciones de repositorios privados e internos para un repositorio, organización o empresa.
|
||||
{%- ifversion fpt or ghec %} | `profile_picture` | Contiene las actividades relacionadas con la imagen de perfil de una organización.
|
||||
{%- endif %} | `project` | Contiene las actividades relacionadas con los paneles de proyecto.
|
||||
| `project_field` | Contiene las actividades relacionadas con la creación y eliminación de campos en un panel de proyecto.
|
||||
| `project_view` | Contiene las actividades relacionadas con la creación y eliminación de vistas en un panel de proyecto.
|
||||
| `protected_branch` | Contiene las actividades relacionadas con las ramas protegidas.
|
||||
| `public_key` | Contiene las actividades relacionadas con las claves SSH y las claves de implementación.
|
||||
| `pull_request` | Contiene las actividades relacionadas con las solicitudes de incorporación de cambios.
|
||||
| `pull_request_review` | Contiene las actividades relacionadas con las revisiones de solicitudes de incorporación de cambios.
|
||||
| `pull_request_review_comment` | Contiene las actividades relacionadas con los comentarios de revisión de las solicitudes de incorporación de cambios.
|
||||
| `repo` | Contiene las actividades relacionadas con los repositorios que pertenecen a una organización.
|
||||
{%- ifversion fpt or ghec %} | `repository_advisory` | Contiene las actividades a nivel de repositorio relacionadas con las asesorías de seguridad en la {% data variables.product.prodname_advisory_database %}. Para obtener más información, consulta "[Acerca de los avisos de seguridad de {% data variables.product.prodname_dotcom %}](/github/managing-security-vulnerabilities/about-github-security-advisories)".
|
||||
| `repository_content_analysis` | Contiene las actividades relacionadas con la [habilitación o deshabilitación del uso de datos para un repositorio privado](/articles/about-github-s-use-of-your-data).
|
||||
| `repository_dependency_graph` | Contiene las actividades a nivel de repositorio relacionadas con la habilitación o deshabilitación del gráfico de dependencias para un repositorio {% ifversion fpt or ghec %}privado{% endif %}. Para obtener más información, consulta "[Acerca del gráfico de dependencias](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)".
|
||||
{%- endif %} | `repository_image` | Contiene actividades relacionadas con imágenes de un repositorio.
|
||||
| `repository_invitation` | Contiene actividades relacionadas con invitaciones para unirse a un repositorio.
|
||||
| `repository_projects_change` | Contiene las actividades relacionadas con la habilitación de proyectos para un repositorio o para todos los repositorios de una organización.
|
||||
{%- ifversion ghec or ghes or ghae %} | `repository_secret_scanning` | Contiene las actividades a nivel de repositorio relacionadas con el análisis de secretos. Para obtener más información, consulta "[Acerca del análisis de secretos](/github/administering-a-repository/about-secret-scanning)".
|
||||
{%- endif %} {%- ifversion secret-scanning-audit-log-custom-patterns %} | `repository_secret_scanning_custom_pattern` | Contiene las actividades relacionadas con los patrones personalizados de análisis de secretos de un repositorio. Para más información, vea "[Definición de patrones personalizados para el análisis de secretos](/code-security/secret-scanning/defining-custom-patterns-for-secret-scanning)". {% endif %}{% ifversion secret-scanning-audit-log-custom-patterns %} | `repository_secret_scanning_push_protection` | Contiene las actividades relacionadas con los patrones personalizados de análisis de secretos de un repositorio. Para obtener más información, consulta "[Protección de inserciones para el análisis de secretos](/code-security/secret-scanning/protecting-pushes-with-secret-scanning)".
|
||||
{%- endif %} {%- ifversion fpt or ghec %} | `repository_visibility_change` | Contiene las actividades relacionadas con la habilitación de los miembros de la organización para cambiar las visibilidades de los repositorios de la organización.
|
||||
{%- endif %} | `repository_vulnerability_alert` | Contiene las actividades relacionadas con [{% data variables.product.prodname_dependabot_alerts %}](/code-security/dependabot/dependabot-alerts/about-dependabot-alerts).
|
||||
{%- ifversion fpt or ghec %} | `repository_vulnerability_alerts` | Contiene las actividades de configuración en el nivel de repositorio para {% data variables.product.prodname_dependabot_alerts %}.
|
||||
| `required_status_check` | Contiene las actividades relacionadas con las comprobaciones de estado necesarias para las ramas protegidas.
|
||||
{%- endif %} {%- ifversion ghec or ghes %} | `restrict_notification_delivery` | Contiene las actividades relacionadas con la restricción de las notificaciones de correo electrónico en los dominios aprobados o comprobados de una empresa.
|
||||
{%- endif %} {%- ifversion custom-repository-roles %} | `role` | Contiene las actividades relacionadas con los [roles de repositorio personalizados](/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).
|
||||
{%- endif %} {%- ifversion ghec or ghes or ghae %} | `secret_scanning` | Contiene las actividades de configuración a nivel de organización para el análisis de secretos en los repositorios existentes. Para obtener más información, consulta "[Acerca del análisis de secretos](/github/administering-a-repository/about-secret-scanning)".
|
||||
| `secret_scanning_new_repos` | Contiene las actividades de configuración a nivel de organización para el análisis de secretos para los repositorios nuevos que se crean en ella.
|
||||
{%- endif %} {%- ifversion ghec or ghes or ghae %} | `security_key` | Contiene las actividades relacionadas con el registro y eliminación de claves de seguridad.
|
||||
{%- endif %} {%- ifversion fpt or ghec %} | `sponsors` | Contiene los eventos relacionados con los botones de patrocinio (consulta "[Mostrar un botón de patrocinio en el repositorio](/articles/displaying-a-sponsor-button-in-your-repository)").
|
||||
{%- endif %} {%- ifversion ghec or ghes or ghae %} | `ssh_certificate_authority` | Contiene las actividades relacionadas con una autoridad de certificación SSH en una organización o empresa.
|
||||
| `ssh_certificate_requirement` | Contiene las actividades relacionadas con la necesidad de que los miembros usen certificados SSH para acceder a los recursos de la organización.
|
||||
{%- endif %}{% ifversion sso-redirect %} | `sso_redirect` | Contiene actividades relacionadas con el redireccionamiento automático de los usuarios para iniciar sesión (consulta "[Aplicación de directivas para la configuración de seguridad de tu empresa](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-security-settings-in-your-enterprise#managing-sso-for-unauthenticated-users)"). {% endif %} | `staff` | Contiene actividades relacionadas con un administrador de sitio que realiza una acción.
|
||||
| `team` | Contiene las actividades relacionadas con los equipos de una organización.
|
||||
| `team_discussions` | Contiene las actividades relacionadas con la administración de debates de equipo para una organización.
|
||||
{%- ifversion ghec %} | `team_sync_tenant` | Contiene las actividades relacionadas con la sincronización de equipos con un IdP para una empresa u organización.
|
||||
{%- endif %} {%- ifversion fpt or ghes %} | `two_factor_authentication` | Contiene las actividades relacionadas con la autenticación en dos fases.
|
||||
{%- endif %} | `user` | Contiene las actividades relacionadas con los usuarios de una empresa u organización.
|
||||
{%- ifversion ghec or ghes %} | `user_license` | Contiene las actividades relacionadas con el hecho de que un usuario ocupe un puesto con licencia en una empresa y sea miembro de ella.
|
||||
{%- endif %} | `workflows` | Contiene las actividades relacionadas con los flujos de trabajo de {% data variables.product.prodname_actions %}.
|
||||
|
||||
@@ -0,0 +1,13 @@
|
||||
---
|
||||
ms.openlocfilehash: f246dbf76575a4338b8fa28ffbd5439c4121505f
|
||||
ms.sourcegitcommit: 7a74d5796695bb21c30e4031679253cbc16ceaea
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/28/2022
|
||||
ms.locfileid: "148184075"
|
||||
---
|
||||
{% note %}
|
||||
|
||||
**Nota:** La redirección automática de los usuarios para iniciar sesión está actualmente en versión beta para {% data variables.product.prodname_emus %} y está sujeta a cambios.
|
||||
|
||||
{% endnote %}
|
||||
@@ -1,5 +1,13 @@
|
||||
When you enable the allow list, the IP addresses you have configured are immediately added to the allow lists of organizations in your enterprise. If you disable the allow list, the addresses are removed from the organization allow lists.
|
||||
---
|
||||
ms.openlocfilehash: f88150299e77eff08e5db75a7ef5bf5bd460328b
|
||||
ms.sourcegitcommit: 7a74d5796695bb21c30e4031679253cbc16ceaea
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/28/2022
|
||||
ms.locfileid: "148184096"
|
||||
---
|
||||
Cuando habilitas la lista de direcciones permitidas, las direcciones IP que configuraste se agregan inmediatamente a las listas de direcciones permitidas de las organizaciones en tu empresa. Si inhabilitas la lista de direcciones permitidas, las direcciones se eliminan de las listas de direcciones permitidas de la organización.
|
||||
|
||||
{% data reusables.identity-and-permissions.org-enterprise-allow-list-interaction %} For more information, see "[Managing allowed IP addresses for your organization](/organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization)."
|
||||
{% data reusables.identity-and-permissions.org-enterprise-allow-list-interaction %} Para más información, consulta "[Administración de las direcciones IP permitidas en tu organización](/organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization)".
|
||||
|
||||
You can choose to automatically add to your allow list any IP addresses configured for {% data variables.product.prodname_github_apps %} installed in your enterprise. The creator of a {% data variables.product.prodname_github_app %} can configure an allow list for their application, specifying the IP addresses at which the application runs. By inheriting their allow list into yours, you avoid connection requests from the application being refused. For more information, see "[Allowing access by GitHub Apps](#allowing-access-by-github-apps)."
|
||||
Puedes elegir agregar automáticamente cualquier dirección IP a tu lista de direcciones permitidas para las {% data variables.product.prodname_github_apps %} que están instaladas en tu empresa. El creador de una {% data variables.product.prodname_github_app %} puede configurar una lista de direcciones permitidas para su aplicación, las cuales especifiquen las direcciones IP en las cuales se ejecuta esta. Al heredar la lista de direcciones permitidas en la tuya, estás evitando las solicitudes de conexión de la aplicación que se está rehusando. Para obtener más información, consulte "[Permitir el acceso mediante GitHub Apps](#allowing-access-by-github-apps)".
|
||||
|
||||
@@ -0,0 +1,9 @@
|
||||
---
|
||||
ms.openlocfilehash: 5ce9d5cc32dc07a1fe4ead5b16b75a7b10509467
|
||||
ms.sourcegitcommit: 7a74d5796695bb21c30e4031679253cbc16ceaea
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/28/2022
|
||||
ms.locfileid: "148184074"
|
||||
---
|
||||
Los propietarios de la organización pueden agregar entradas adicionales a la lista de permitidos para sus organizaciones, pero no pueden administrar las entradas heredadas de la lista de permitidos de la cuenta de empresa, y los propietarios de la empresa no pueden administrar las entradas agregadas a la lista de permitidos de la organización.
|
||||
@@ -1,8 +1,16 @@
|
||||
1. Optionally, to require members to use SSH certificates, select **Require SSH Certificates**, then click **Save**.
|
||||
|
||||
---
|
||||
ms.openlocfilehash: abb4b47406958c1933c5c2bdf7d7e2e2c1091907
|
||||
ms.sourcegitcommit: 7a74d5796695bb21c30e4031679253cbc16ceaea
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 11/28/2022
|
||||
ms.locfileid: "148184066"
|
||||
---
|
||||
1. Opcionalmente, para exigir que los miembros usen certificados SSH, seleccione **Exigir certificados SSH** y, después, haga clic en **Guardar**.
|
||||
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** When you require SSH certificates, the requirement does not apply to authorized third-party integrations or to {% data variables.product.prodname_dotcom %} features such as {% data variables.product.prodname_actions %}{% ifversion fpt or ghec %} and {% data variables.product.prodname_codespaces %}{% endif %}, which are trusted environments within the {% data variables.product.prodname_dotcom %} ecosystem.
|
||||
**Nota:** Cuando se requieren certificados SSH, el requisito no se aplica a integraciones de terceros autorizadas o a características de {% data variables.product.prodname_dotcom %} como {% data variables.product.prodname_actions %}{% ifversion fpt or ghec %} y {% data variables.product.prodname_codespaces %}{% endif %}, que son entornos de confianza dentro del ecosistema {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
@@ -107,6 +107,7 @@ translations/es-ES/content/codespaces/customizing-your-codespace/setting-your-ti
|
||||
translations/es-ES/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/codespaces/developing-in-codespaces/creating-a-codespace.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/codespaces/developing-in-codespaces/renaming-a-codespace.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/codespaces/developing-in-codespaces/the-codespace-lifecycle.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/codespaces/developing-in-codespaces/using-codespaces-for-pull-requests.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/codespaces/developing-in-codespaces/using-codespaces-in-visual-studio-code.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/codespaces/developing-in-codespaces/using-codespaces-with-github-cli.md,file deleted because it no longer exists in main
|
||||
@@ -124,6 +125,7 @@ translations/es-ES/content/codespaces/troubleshooting/troubleshooting-port-forwa
|
||||
translations/es-ES/content/codespaces/troubleshooting/troubleshooting-your-connection-to-codespaces.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/codespaces/troubleshooting/working-with-support-for-codespaces.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/communities/moderating-comments-and-conversations/limiting-interactions-for-your-user-account.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/desktop/contributing-and-collaborating-using-github-desktop/working-with-your-remote-repository-on-github-or-github-enterprise/changing-a-remotes-url-from-github-desktop.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution/about-campus-advisors.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/about-github-community-exchange.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-for-your-schoolwork/about-github-education-for-students.md,file deleted because it no longer exists in main
|
||||
@@ -187,6 +189,7 @@ translations/es-ES/content/organizations/restricting-access-to-your-organization
|
||||
translations/es-ES/content/organizations/restricting-access-to-your-organizations-data/enabling-oauth-app-access-restrictions-for-your-organization.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/organizations/restricting-access-to-your-organizations-data/index.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/pages/getting-started-with-github-pages/adding-a-theme-to-your-github-pages-site-with-the-theme-chooser.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/pull-requests/collaborating-with-pull-requests/working-with-forks/configuring-a-remote-for-a-fork.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/pull-requests/collaborating-with-pull-requests/working-with-forks/merging-an-upstream-repository-into-your-fork.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/rest/reference/actions.md,file deleted because it no longer exists in main
|
||||
translations/es-ES/content/rest/reference/activity.md,file deleted because it no longer exists in main
|
||||
@@ -606,7 +609,6 @@ translations/es-ES/content/admin/identity-and-access-management/using-enterprise
|
||||
translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-scim-provisioning-for-enterprise-managed-users.md,rendering error
|
||||
translations/es-ES/content/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc.md,rendering error
|
||||
translations/es-ES/content/admin/identity-and-access-management/using-ldap-for-enterprise-iam/index.md,rendering error
|
||||
translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise.md,broken liquid tags
|
||||
translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/enabling-encrypted-assertions.md,rendering error
|
||||
translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/saml-configuration-reference.md,broken liquid tags
|
||||
translations/es-ES/content/admin/identity-and-access-management/using-saml-for-enterprise-iam/switching-your-saml-configuration-from-an-organization-to-an-enterprise-account.md,broken liquid tags
|
||||
@@ -660,7 +662,6 @@ translations/es-ES/content/authentication/connecting-to-github-with-ssh/checking
|
||||
translations/es-ES/content/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md,rendering error
|
||||
translations/es-ES/content/authentication/connecting-to-github-with-ssh/testing-your-ssh-connection.md,rendering error
|
||||
translations/es-ES/content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md,rendering error
|
||||
translations/es-ES/content/authentication/keeping-your-account-and-data-secure/authorizing-oauth-apps.md,rendering error
|
||||
translations/es-ES/content/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token.md,rendering error
|
||||
translations/es-ES/content/authentication/keeping-your-account-and-data-secure/creating-a-strong-password.md,rendering error
|
||||
translations/es-ES/content/authentication/keeping-your-account-and-data-secure/preventing-unauthorized-access.md,rendering error
|
||||
@@ -747,6 +748,7 @@ translations/es-ES/content/code-security/security-advisories/guidance-on-reporti
|
||||
translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/managing-privately-reported-security-vulnerabilities.md,rendering error
|
||||
translations/es-ES/content/code-security/security-advisories/guidance-on-reporting-and-writing/privately-reporting-a-security-vulnerability.md,rendering error
|
||||
translations/es-ES/content/code-security/security-advisories/repository-security-advisories/configuring-private-vulnerability-reporting-for-a-repository.md,rendering error
|
||||
translations/es-ES/content/code-security/security-advisories/repository-security-advisories/creating-a-repository-security-advisory.md,rendering error
|
||||
translations/es-ES/content/code-security/security-overview/about-the-security-overview.md,rendering error
|
||||
translations/es-ES/content/code-security/security-overview/filtering-alerts-in-the-security-overview.md,rendering error
|
||||
translations/es-ES/content/code-security/security-overview/viewing-the-security-overview.md,rendering error
|
||||
@@ -937,6 +939,7 @@ translations/es-ES/content/repositories/configuring-branches-and-merges-in-your-
|
||||
translations/es-ES/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches.md,rendering error
|
||||
translations/es-ES/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule.md,rendering error
|
||||
translations/es-ES/content/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/troubleshooting-required-status-checks.md,rendering error
|
||||
translations/es-ES/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch.md,rendering error
|
||||
translations/es-ES/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md,rendering error
|
||||
translations/es-ES/content/repositories/creating-and-managing-repositories/cloning-a-repository.md,rendering error
|
||||
translations/es-ES/content/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template.md,rendering error
|
||||
@@ -950,7 +953,7 @@ translations/es-ES/content/repositories/managing-your-repositorys-settings-and-f
|
||||
translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository.md,rendering error
|
||||
translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility.md,rendering error
|
||||
translations/es-ES/content/repositories/releasing-projects-on-github/about-releases.md,rendering error
|
||||
translations/es-ES/content/repositories/releasing-projects-on-github/automatically-generated-release-notes.md,broken liquid tags
|
||||
translations/es-ES/content/repositories/releasing-projects-on-github/automatically-generated-release-notes.md,rendering error
|
||||
translations/es-ES/content/repositories/releasing-projects-on-github/comparing-releases.md,rendering error
|
||||
translations/es-ES/content/repositories/releasing-projects-on-github/linking-to-releases.md,rendering error
|
||||
translations/es-ES/content/repositories/releasing-projects-on-github/managing-releases-in-a-repository.md,rendering error
|
||||
@@ -977,15 +980,12 @@ translations/es-ES/content/rest/enterprise-admin/pre-receive-hooks.md,broken liq
|
||||
translations/es-ES/content/rest/enterprise-admin/repo-pre-receive-hooks.md,broken liquid tags
|
||||
translations/es-ES/content/rest/enterprise-admin/scim.md,rendering error
|
||||
translations/es-ES/content/rest/enterprise-admin/users.md,broken liquid tags
|
||||
translations/es-ES/content/rest/guides/getting-started-with-the-rest-api.md,broken liquid tags
|
||||
translations/es-ES/content/rest/guides/traversing-with-pagination.md,rendering error
|
||||
translations/es-ES/content/rest/guides/working-with-comments.md,broken liquid tags
|
||||
translations/es-ES/content/rest/migrations/source-imports.md,broken liquid tags
|
||||
translations/es-ES/content/rest/overview/api-previews.md,rendering error
|
||||
translations/es-ES/content/rest/overview/other-authentication-methods.md,rendering error
|
||||
translations/es-ES/content/rest/overview/permissions-required-for-github-apps.md,rendering error
|
||||
translations/es-ES/content/rest/overview/resources-in-the-rest-api.md,rendering error
|
||||
translations/es-ES/content/rest/overview/troubleshooting.md,broken liquid tags
|
||||
translations/es-ES/content/rest/packages.md,broken liquid tags
|
||||
translations/es-ES/content/rest/projects/projects.md,broken liquid tags
|
||||
translations/es-ES/content/rest/quickstart.md,broken liquid tags
|
||||
@@ -1059,7 +1059,6 @@ translations/es-ES/data/reusables/advanced-security/secret-scanning-add-custom-p
|
||||
translations/es-ES/data/reusables/advanced-security/secret-scanning-create-custom-pattern.md,rendering error
|
||||
translations/es-ES/data/reusables/advanced-security/secret-scanning-push-protection-org.md,broken liquid tags
|
||||
translations/es-ES/data/reusables/apps/user-to-server-rate-limits.md,broken liquid tags
|
||||
translations/es-ES/data/reusables/audit_log/audit-log-action-categories.md,broken liquid tags
|
||||
translations/es-ES/data/reusables/audit_log/audit_log_sidebar_for_org_admins.md,rendering error
|
||||
translations/es-ES/data/reusables/audit_log/audit_log_sidebar_for_site_admins.md,rendering error
|
||||
translations/es-ES/data/reusables/branches/new-repo-default-branch.md,rendering error
|
||||
@@ -1134,7 +1133,6 @@ translations/es-ES/data/reusables/getting-started/enterprise-advanced-security.m
|
||||
translations/es-ES/data/reusables/getting-started/managing-enterprise-members.md,rendering error
|
||||
translations/es-ES/data/reusables/git/git-push.md,rendering error
|
||||
translations/es-ES/data/reusables/git/provide-credentials.md,rendering error
|
||||
translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-enterprise.md,broken liquid tags
|
||||
translations/es-ES/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md,rendering error
|
||||
translations/es-ES/data/reusables/identity-and-permissions/vigilant-mode-beta-note.md,rendering error
|
||||
translations/es-ES/data/reusables/large_files/storage_assets_location.md,broken liquid tags
|
||||
@@ -1147,7 +1145,6 @@ translations/es-ES/data/reusables/organizations/github-apps-settings-sidebar.md,
|
||||
translations/es-ES/data/reusables/organizations/member-privileges.md,rendering error
|
||||
translations/es-ES/data/reusables/organizations/navigate-to-org.md,rendering error
|
||||
translations/es-ES/data/reusables/organizations/repository-defaults.md,rendering error
|
||||
translations/es-ES/data/reusables/organizations/require-ssh-cert.md,broken liquid tags
|
||||
translations/es-ES/data/reusables/organizations/security-and-analysis.md,rendering error
|
||||
translations/es-ES/data/reusables/organizations/security.md,rendering error
|
||||
translations/es-ES/data/reusables/organizations/teams_sidebar.md,rendering error
|
||||
|
||||
|
Reference in New Issue
Block a user