# Custom Attributes API > 原文：[https://docs.gitlab.com/ee/api/custom_attributes.html](https://docs.gitlab.com/ee/api/custom_attributes.html) * [List custom attributes](#list-custom-attributes) * [Single custom attribute](#single-custom-attribute) * [Set custom attribute](#set-custom-attribute) * [Delete custom attribute](#delete-custom-attribute) # Custom Attributes API[](#custom-attributes-api "Permalink") 每个对自定义属性的 API 调用都必须经过管理员身份验证. 自定义属性当前可用于用户，组和项目，在本文档中将其称为"资源". ## List custom attributes[](#list-custom-attributes "Permalink") 获取资源上的所有自定义属性. ``` GET /users/:id/custom_attributes GET /groups/:id/custom_attributes GET /projects/:id/custom_attributes ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer | yes | 资源的 ID | ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/users/42/custom_attributes" ``` 响应示例： ``` [ { "key": "location", "value": "Antarctica" }, { "key": "role", "value": "Developer" } ] ``` ## Single custom attribute[](#single-custom-attribute "Permalink") 在资源上获取单个自定义属性. ``` GET /users/:id/custom_attributes/:key GET /groups/:id/custom_attributes/:key GET /projects/:id/custom_attributes/:key ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer | yes | 资源的 ID | | `key` | string | yes | 自定义属性的键 | ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/users/42/custom_attributes/location" ``` 响应示例： ``` { "key": "location", "value": "Antarctica" } ``` ## Set custom attribute[](#set-custom-attribute "Permalink") 在资源上设置自定义属性. 如果该属性已经存在，则将对其进行更新；否则，将重新创建该属性. ``` PUT /users/:id/custom_attributes/:key PUT /groups/:id/custom_attributes/:key PUT /projects/:id/custom_attributes/:key ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer | yes | 资源的 ID | | `key` | string | yes | 自定义属性的键 | | `value` | string | yes | 自定义属性的值 | ``` curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" --data "value=Greenland" "https://gitlab.example.com/api/v4/users/42/custom_attributes/location" ``` 响应示例： ``` { "key": "location", "value": "Greenland" } ``` ## Delete custom attribute[](#delete-custom-attribute "Permalink") 删除资源上的自定义属性. ``` DELETE /users/:id/custom_attributes/:key DELETE /groups/:id/custom_attributes/:key DELETE /projects/:id/custom_attributes/:key ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer | yes | 资源的 ID | | `key` | string | yes | 自定义属性的键 | ``` curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/users/42/custom_attributes/location" ```