Политики ветвей развертывания
Используйте REST API для управления настраиваемыми политиками ветви развертывания.
Сведения о политиках ветви развертывания
С помощью REST API можно указать пользовательские шаблоны имен, которые должны соответствовать ветвям для развертывания в среде. Необходимо задать свойство true
для среды, чтобы разрешить deployment_branch_policy.custom_branch_policies
использовать эти конечные точки. Сведения об обновлении deployment_branch_policy
среды см. в разделе "Среды развертывания".
Дополнительные сведения об ограничении развертываний среды в определенных ветвях см. в разделе "Использование сред для развертывания".
List deployment branch policies
Lists the deployment branch policies for an environment.
Anyone with read access to the repository can use this endpoint. If the repository is private, you must use an access token with the repo
scope. GitHub Apps must have the actions:read
permission to use this endpoint.
Параметры для "List deployment branch policies"
Имя, Type, Description |
---|
accept string Setting to |
Имя, Type, Description |
---|
owner string Обязательное полеThe account owner of the repository. The name is not case sensitive. |
repo string Обязательное полеThe name of the repository without the |
environment_name string Обязательное полеThe name of the environment. |
Имя, Type, Description |
---|
per_page integer The number of results per page (max 100). По умолчанию.: |
page integer Page number of the results to fetch. По умолчанию.: |
Коды состояния http-ответа для "List deployment branch policies"
Код состояния | Описание |
---|---|
200 | OK |
Примеры кода для "List deployment branch policies"
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/environments/ENVIRONMENT_NAME/deployment-branch-policies
Response
Status: 200
{
"total_count": 2,
"branch_policies": [
{
"id": 361471,
"node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjE0NzE=",
"name": "release/*"
},
{
"id": 361472,
"node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjE0NzI=",
"name": "main"
}
]
}
Create a deployment branch policy
Creates a deployment branch policy for an environment.
You must authenticate using an access token with the repo
scope to use this endpoint. GitHub Apps must have the administration:write
permission for the repository to use this endpoint.
Параметры для "Create a deployment branch policy"
Имя, Type, Description |
---|
accept string Setting to |
Имя, Type, Description |
---|
owner string Обязательное полеThe account owner of the repository. The name is not case sensitive. |
repo string Обязательное полеThe name of the repository without the |
environment_name string Обязательное полеThe name of the environment. |
Имя, Type, Description |
---|
name string Обязательное полеThe name pattern that branches must match in order to deploy to the environment. Wildcard characters will not match |
Коды состояния http-ответа для "Create a deployment branch policy"
Код состояния | Описание |
---|---|
200 | OK |
303 | Response if the same branch name pattern already exists |
404 | Not Found or |
Примеры кода для "Create a deployment branch policy"
curl -L \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/environments/ENVIRONMENT_NAME/deployment-branch-policies \
-d '{"name":"release/*"}'
Response
Status: 200
{
"id": 364662,
"node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI=",
"name": "release/*"
}
Get a deployment branch policy
Gets a deployment branch policy for an environment.
Anyone with read access to the repository can use this endpoint. If the repository is private, you must use an access token with the repo
scope. GitHub Apps must have the actions:read
permission to use this endpoint.
Параметры для "Get a deployment branch policy"
Имя, Type, Description |
---|
accept string Setting to |
Имя, Type, Description |
---|
owner string Обязательное полеThe account owner of the repository. The name is not case sensitive. |
repo string Обязательное полеThe name of the repository without the |
environment_name string Обязательное полеThe name of the environment. |
branch_policy_id integer Обязательное полеThe unique identifier of the branch policy. |
Коды состояния http-ответа для "Get a deployment branch policy"
Код состояния | Описание |
---|---|
200 | OK |
Примеры кода для "Get a deployment branch policy"
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/environments/ENVIRONMENT_NAME/deployment-branch-policies/BRANCH_POLICY_ID
Response
Status: 200
{
"id": 364662,
"node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI=",
"name": "release/*"
}
Update a deployment branch policy
Updates a deployment branch policy for an environment.
You must authenticate using an access token with the repo
scope to use this endpoint. GitHub Apps must have the administration:write
permission for the repository to use this endpoint.
Параметры для "Update a deployment branch policy"
Имя, Type, Description |
---|
accept string Setting to |
Имя, Type, Description |
---|
owner string Обязательное полеThe account owner of the repository. The name is not case sensitive. |
repo string Обязательное полеThe name of the repository without the |
environment_name string Обязательное полеThe name of the environment. |
branch_policy_id integer Обязательное полеThe unique identifier of the branch policy. |
Имя, Type, Description |
---|
name string Обязательное полеThe name pattern that branches must match in order to deploy to the environment. Wildcard characters will not match |
Коды состояния http-ответа для "Update a deployment branch policy"
Код состояния | Описание |
---|---|
200 | OK |
Примеры кода для "Update a deployment branch policy"
curl -L \
-X PUT \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/environments/ENVIRONMENT_NAME/deployment-branch-policies/BRANCH_POLICY_ID \
-d '{"name":"release/*"}'
Response
Status: 200
{
"id": 364662,
"node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI=",
"name": "release/*"
}
Delete a deployment branch policy
Deletes a deployment branch policy for an environment.
You must authenticate using an access token with the repo
scope to use this endpoint. GitHub Apps must have the administration:write
permission for the repository to use this endpoint.
Параметры для "Delete a deployment branch policy"
Имя, Type, Description |
---|
accept string Setting to |
Имя, Type, Description |
---|
owner string Обязательное полеThe account owner of the repository. The name is not case sensitive. |
repo string Обязательное полеThe name of the repository without the |
environment_name string Обязательное полеThe name of the environment. |
branch_policy_id integer Обязательное полеThe unique identifier of the branch policy. |
Коды состояния http-ответа для "Delete a deployment branch policy"
Код состояния | Описание |
---|---|
204 | No Content |
Примеры кода для "Delete a deployment branch policy"
curl -L \
-X DELETE \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/environments/ENVIRONMENT_NAME/deployment-branch-policies/BRANCH_POLICY_ID
Response
Status: 204