Application settings API

原文：https://docs.gitlab.com/ee/api/settings.html

• Get current application settings
• Change application settings
• List of settings that can be accessed via API calls

Application settings API

这些 API 调用使您可以阅读和修改/admin/application_settings/general显示的 GitLab 实例应用程序设置 . 您必须是管理员才能执行此操作.

Get current application settings

列出 GitLab 实例的当前应用程序设置 .

GET /application/settings

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/application/settings"

响应示例：

{  "default_projects_limit"  :  100000,  "signup_enabled"  :  true,  "id"  :  1,  "default_branch_protection"  :  2,  "restricted_visibility_levels"  :  [],  "password_authentication_enabled_for_web"  :  true,  "after_sign_out_path"  :  null,  "max_attachment_size"  :  10,  "max_import_size":  50,  "user_oauth_applications"  :  true,  "updated_at"  :  "2016-01-04T15:44:55.176Z",  "session_expire_delay"  :  10080,  "home_page_url"  :  null,  "default_snippet_visibility"  :  "private",  "outbound_local_requests_whitelist":  [],  "domain_whitelist"  :  [],  "domain_blacklist_enabled"  :  false,  "domain_blacklist"  :  [],  "created_at"  :  "2016-01-04T15:44:55.176Z",  "default_ci_config_path"  :  null,  "default_project_visibility"  :  "private",  "default_group_visibility"  :  "private",  "gravatar_enabled"  :  true,  "sign_in_text"  :  null,  "container_expiration_policies_enable_historic_entries":  true,  "container_registry_token_expire_delay":  5,  "repository_storages_weighted":  {"default":  100},  "plantuml_enabled":  false,  "plantuml_url":  null,  "terminal_max_session_time":  0,  "polling_interval_multiplier":  1.0,  "rsa_key_restriction":  0,  "dsa_key_restriction":  0,  "ecdsa_key_restriction":  0,  "ed25519_key_restriction":  0,  "first_day_of_week":  0,  "enforce_terms":  true,  "terms":  "Hello world!",  "performance_bar_allowed_group_id":  42,  "instance_statistics_visibility_private":  false,  "user_show_add_ssh_key_message":  true,  "local_markdown_version":  0,  "allow_local_requests_from_hooks_and_services":  true,  "allow_local_requests_from_web_hooks_and_services":  true,  "allow_local_requests_from_system_hooks":  false,  "asset_proxy_enabled":  true,  "asset_proxy_url":  "https://assets.example.com",  "asset_proxy_whitelist":  ["example.com",  "*.example.com",  "your-instance.com"],  "npm_package_requests_forwarding":  true,  "snippet_size_limit":  52428800,  "issues_create_limit":  300,  "raw_blob_request_limit":  300,  "wiki_page_max_content_bytes":  52428800  }

在 GitLab 用户高级版或旗舰也可以看到file_template_project_id ， deletion_adjourned_period ，或geo_node_allowed_ips参数：

{  "id"  :  1,  "signup_enabled"  :  true,  "file_template_project_id":  1,  "geo_node_allowed_ips":  "0.0.0.0/0, ::/0",  "deletion_adjourned_period":  7,  ...  }

Change application settings

使用 API​​调用来修改 GitLab 实例应用程序设置 .

PUT /application/settings

curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/application/settings?signup_enabled=false&default_project_visibility=internal"

响应示例：

{  "id":  1,  "default_projects_limit":  100000,  "signup_enabled":  false,  "password_authentication_enabled_for_web":  true,  "gravatar_enabled":  true,  "sign_in_text":  "",  "created_at":  "2015-06-12T15:51:55.432Z",  "updated_at":  "2015-06-30T13:22:42.210Z",  "home_page_url":  "",  "default_branch_protection":  2,  "restricted_visibility_levels":  [],  "max_attachment_size":  10,  "max_import_size":  50,  "session_expire_delay":  10080,  "default_ci_config_path"  :  null,  "default_project_visibility":  "internal",  "default_snippet_visibility":  "private",  "default_group_visibility":  "private",  "outbound_local_requests_whitelist":  [],  "domain_whitelist":  [],  "domain_blacklist_enabled"  :  false,  "domain_blacklist"  :  [],  "external_authorization_service_enabled":  true,  "external_authorization_service_url":  "https://authorize.me",  "external_authorization_service_default_label":  "default",  "external_authorization_service_timeout":  0.5,  "user_oauth_applications":  true,  "after_sign_out_path":  "",  "container_registry_token_expire_delay":  5,  "repository_storages":  ["default"],  "plantuml_enabled":  false,  "plantuml_url":  null,  "terminal_max_session_time":  0,  "polling_interval_multiplier":  1.0,  "rsa_key_restriction":  0,  "dsa_key_restriction":  0,  "ecdsa_key_restriction":  0,  "ed25519_key_restriction":  0,  "first_day_of_week":  0,  "enforce_terms":  true,  "terms":  "Hello world!",  "performance_bar_allowed_group_id":  42,  "instance_statistics_visibility_private":  false,  "user_show_add_ssh_key_message":  true,  "file_template_project_id":  1,  "local_markdown_version":  0,  "asset_proxy_enabled":  true,  "asset_proxy_url":  "https://assets.example.com",  "asset_proxy_whitelist":  ["example.com",  "*.example.com",  "your-instance.com"],  "geo_node_allowed_ips":  "0.0.0.0/0, ::/0",  "allow_local_requests_from_hooks_and_services":  true,  "allow_local_requests_from_web_hooks_and_services":  true,  "allow_local_requests_from_system_hooks":  false,  "npm_package_requests_forwarding":  true,  "snippet_size_limit":  52428800,  "issues_create_limit":  300,  "raw_blob_request_limit":  300,  "wiki_page_max_content_bytes":  52428800  }

使用 GitLab Premium 或 Ultimate 的用户可能还会看到以下参数：

• file_template_project_id
• geo_node_allowed_ips
• geo_status_timeout
• deletion_adjourned_period

响应示例：

 "file_template_project_id":  1,  "geo_node_allowed_ips":  "0.0.0.0/0, ::/0"

List of settings that can be accessed via API calls

通常，所有设置都是可选的. 但是，如果启用了某些设置，则需要设置其他设置才能正常运行. 这些要求在相关设置的说明中列出.