{"meta":{"title":"Points de terminaison d’API REST pour les clés de déploiement","intro":"Utilisez l’API REST pour créer et gérer des clés de déploiement.","product":"API REST","breadcrumbs":[{"href":"/fr/enterprise-server@3.20/rest","title":"API REST"},{"href":"/fr/enterprise-server@3.20/rest/deploy-keys","title":"Clés de déploiement"},{"href":"/fr/enterprise-server@3.20/rest/deploy-keys/deploy-keys","title":"Clés de déploiement"}],"documentType":"article"},"body":"# Points de terminaison d’API REST pour les clés de déploiement\n\nUtilisez l’API REST pour créer et gérer des clés de déploiement.\n\n## À propos des clés de déploiement\n\nVous pouvez lancer des projets à partir d’un référentiel sur votre instance GitHub Enterprise Server sur votre serveur à l’aide d’une clé de déploiement, qui est une clé SSH accordant l’accès à un seul référentiel. GitHub attache la partie publique de la clé directement à votre dépôt au lieu d'un compte personnel, et la partie privée de la clé reste sur votre serveur. Pour plus d’informations, consultez « [Livraison de déploiements](/fr/enterprise-server@3.20/rest/guides/delivering-deployments) ».\n\nLes clés de déploiement peuvent être configurées à l’aide des points de terminaison d’API suivants ou à l’aide de l’interface GitHub web. Pour savoir comment configurer des clés de déploiement dans l’interface web, consultez [Gestion des clés de déploiement](/fr/enterprise-server@3.20/authentication/connecting-to-github-with-ssh/managing-deploy-keys).\n\nVous ne pourrez peut-être pas créer de clés de déploiement si votre organisation ou propriétaire d’entreprise a défini une stratégie pour restreindre leur utilisation. De plus, si cette stratégie est activée au niveau de l’organisation ou de l’entreprise, les clés de déploiement existantes peuvent être désactivées. Pour plus d’informations, consultez « [Application de stratégies de gestion des dépôts dans votre entreprise](/fr/enterprise-server@3.20/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-deploy-keys) » et « [Restriction des clés de déploiement dans votre organisation](/fr/enterprise-server@3.20/organizations/managing-organization-settings/restricting-deploy-keys-in-your-organization) ».\n\nIl existe quelques cas où une clé de déploiement sera supprimée par d’autres activités :\n\n* Si la clé de déploiement est créée avec un personal access token, la suppression de personal access token entraînera également la suppression de la clé de déploiement. Régénérer le personal access token ne supprimera pas la clé de déploiement.\n* Si la clé de déploiement est créée avec un OAuth app jeton, la révocation du jeton supprime également la clé de déploiement.\n\nÀ l’inverse, ces activités ne supprimeront pas une clé de déploiement :\n\n* Si la clé de déploiement est créée avec un jeton d’accès GitHub App utilisateur, la révocation du jeton ne supprime pas la clé de déploiement.\n* Si la clé de déploiement est créée avec un jeton d’accès GitHub App d’installation, la désinstallation ou la suppression de l’application ne supprime pas la clé de déploiement.\n* Si la clé de déploiement est créée avec un personal access token, régénérer la personal access token clé ne supprime pas la clé de déploiement.\n\n> \\[!NOTE]\n> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2022-11-28`. Curl examples below omit these standard headers for brevity.\n\n## List deploy keys\n\n```\nGET /repos/{owner}/{repo}/keys\n```\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n* **`per_page`** (integer)\n  The number of results per page (max 100). For more information, see \"Using pagination in the REST API.\"\n  Default: `30`\n\n* **`page`** (integer)\n  The page number of the results to fetch. For more information, see \"Using pagination in the REST API.\"\n  Default: `1`\n\n### HTTP response status codes\n\n* **200** - OK\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/keys\n```\n\n**Response schema (Status: 200):**\n\nArray of `Deploy Key`:\n\n* `id`: required, integer\n* `key`: required, string\n* `url`: required, string\n* `title`: required, string\n* `verified`: required, boolean\n* `created_at`: required, string\n* `read_only`: required, boolean\n* `added_by`: string or null\n* `last_used`: string or null, format: date-time\n* `enabled`: boolean\n\n## Create a deploy key\n\n```\nPOST /repos/{owner}/{repo}/keys\n```\n\nYou can create a read-only deploy key.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n#### Body parameters\n\n* **`title`** (string)\n  A name for the key.\n\n* **`key`** (string) (required)\n  The contents of the key.\n\n* **`read_only`** (boolean)\n  If true, the key will only be able to read repository contents. Otherwise, the key will be able to read and write.\n  Deploy keys with write access can perform the same actions as an organization member with admin access, or a collaborator on a personal repository. For more information, see \"Repository permission levels for an organization\" and \"Permission levels for a user account repository.\"\n\n### HTTP response status codes\n\n* **201** - Created\n\n* **422** - Validation failed, or the endpoint has been spammed.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X POST \\\n  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/keys \\\n  -d '{\n  \"title\": \"octocat@octomac\",\n  \"key\": \"ssh-rsa AAA...\",\n  \"read_only\": true\n}'\n```\n\n**Response schema (Status: 201):**\n\n* `id`: required, integer\n* `key`: required, string\n* `url`: required, string\n* `title`: required, string\n* `verified`: required, boolean\n* `created_at`: required, string\n* `read_only`: required, boolean\n* `added_by`: string or null\n* `last_used`: string or null, format: date-time\n* `enabled`: boolean\n\n## Get a deploy key\n\n```\nGET /repos/{owner}/{repo}/keys/{key_id}\n```\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n* **`key_id`** (integer) (required)\n  The unique identifier of the key.\n\n### HTTP response status codes\n\n* **200** - OK\n\n* **404** - Resource not found\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/keys/KEY_ID\n```\n\n**Response schema (Status: 200):**\n\nSame response schema as [Create a deploy key](#create-a-deploy-key).\n\n## Delete a deploy key\n\n```\nDELETE /repos/{owner}/{repo}/keys/{key_id}\n```\n\nDeploy keys are immutable. If you need to update a key, remove the key and create a new one instead.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n* **`key_id`** (integer) (required)\n  The unique identifier of the key.\n\n### HTTP response status codes\n\n* **204** - No Content\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X DELETE \\\n  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/keys/KEY_ID\n```\n\n**Response schema (Status: 204):**"}