code.gitea.io/gitea@v1.22.3/docs/content/usage/packages/generic.zh-cn.md (about)

     1  ---
     2  date: "2021-07-20T00:00:00+00:00"
     3  title: "通用软件包注册表"
     4  slug: "generic"
     5  sidebar_position: 40
     6  draft: false
     7  toc: false
     8  menu:
     9    sidebar:
    10      parent: "packages"
    11      name: "通用"
    12      sidebar_position: 40
    13      identifier: "generic"
    14  ---
    15  
    16  # 通用软件包注册表
    17  
    18  发布通用文件，如发布二进制文件或其他输出，供您的用户或组织使用。
    19  
    20  ## 身份验证软件包注册表
    21  
    22  要身份验证软件包注册表，您需要提供[自定义 HTTP 头或使用 HTTP 基本身份验证](development/api-usage.md#通过-api-认证)。
    23  
    24  ## 发布软件包
    25  
    26  要发布通用软件包，请执行 HTTP `PUT` 操作，并将软件包内容放入请求主体中。
    27  您无法向软件包中多次发布具有相同名称的文件。您必须首先删除现有的软件包版本。
    28  
    29  ```
    30  PUT https://gitea.example.com/api/packages/{owner}/generic/{package_name}/{package_version}/{file_name}
    31  ```
    32  
    33  | 参数              | 描述                                                                                                                        |
    34  | ----------------- | --------------------------------------------------------------------------------------------------------------------------- |
    35  | `owner`           | 软件包的所有者。                                                                                                            |
    36  | `package_name`    | 软件包名称。它只能包含小写字母 (`a-z`)、大写字母 (`A-Z`)、数字 (`0-9`)、点号 (`.`)、连字符 (`-`)、加号 (`+`) 或下划线 (`_`) |
    37  | `package_version` | 软件包版本，一个非空字符串，不包含前导或尾随空格                                                                            |
    38  | `file_name`       | 文件名。它只能包含小写字母 (`a-z`)、大写字母 (`A-Z`)、数字 (`0-9`)、点号 (`.`)、连字符 (`-`)、加号 (`+`) 或下划线 (`_`)     |
    39  
    40  使用 HTTP 基本身份验证的示例请求：
    41  
    42  ```shell
    43  curl --user your_username:your_password_or_token \
    44       --upload-file path/to/file.bin \
    45       https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0/file.bin
    46  ```
    47  
    48  如果您使用 2FA 或 OAuth，请使用[个人访问令牌](development/api-usage.md#通过-api-认证)替代密码。
    49  
    50  服务器将使用以下 HTTP 状态代码进行响应。
    51  
    52  | HTTP 状态码       | 意义                               |
    53  | ----------------- | ---------------------------------- |
    54  | `201 Created`     | 软件包已发布                       |
    55  | `400 Bad Request` | 软件包名称和/或版本和/或文件名无效 |
    56  | `409 Conflict`    | 具有相同名称的文件已存在于软件包中 |
    57  
    58  ## 下载软件包
    59  
    60  要下载通用软件包，请执行 HTTP `GET` 操作。
    61  
    62  ```
    63  GET https://gitea.example.com/api/packages/{owner}/generic/{package_name}/{package_version}/{file_name}
    64  ```
    65  
    66  | 参数              | 描述           |
    67  | ----------------- | -------------- |
    68  | `owner`           | 软件包的所有者 |
    69  | `package_name`    | 软件包名称     |
    70  | `package_version` | 软件包版本     |
    71  | `file_name`       | 文件名         |
    72  
    73  文件内容将在响应主体中返回。响应的内容类型为 `application/octet-stream`。
    74  
    75  服务器将使用以下 HTTP 状态代码进行响应。
    76  
    77  ```shell
    78  curl --user your_username:your_token_or_password \
    79       https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0/file.bin
    80  ```
    81  
    82  服务器会以以下 HTTP 状态码进行响应：
    83  
    84  | HTTP 状态码     | 含义                 |
    85  | --------------- | -------------------- |
    86  | `200 OK`        | 成功                 |
    87  | `404 Not Found` | 找不到软件包或者文件 |
    88  
    89  ## 删除软件包
    90  
    91  要删除通用软件包，请执行 HTTP DELETE 操作。这将同时删除该版本的所有文件。
    92  
    93  ```
    94  DELETE https://gitea.example.com/api/packages/{owner}/generic/{package_name}/{package_version}
    95  ```
    96  
    97  | 参数              | 描述           |
    98  | ----------------- | -------------- |
    99  | `owner`           | 软件包的所有者 |
   100  | `package_name`    | 软件包名称     |
   101  | `package_version` | 软件包版本     |
   102  
   103  服务器将使用以下 HTTP 状态代码进行响应。
   104  
   105  ```shell
   106  curl --user your_username:your_token_or_password -X DELETE \
   107       https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0
   108  ```
   109  
   110  The server responds with the following HTTP Status codes.
   111  
   112  | HTTP 状态码      | 意义         |
   113  | ---------------- | ------------ |
   114  | `204 No Content` | 成功         |
   115  | `404 Not Found`  | 找不到软件包 |
   116  
   117  ## 删除软件包文件
   118  
   119  要删除通用软件包的文件，请执行 HTTP `DELETE` 操作。如果没有文件留下，这将同时删除软件包版本。
   120  
   121  ```
   122  DELETE https://gitea.example.com/api/packages/{owner}/generic/{package_name}/{package_version}/{filename}
   123  ```
   124  
   125  | 参数              | 描述           |
   126  | ----------------- | -------------- |
   127  | `owner`           | 软件包的所有者 |
   128  | `package_name`    | 软件包名称     |
   129  | `package_version` | 软件包版本     |
   130  | `filename`        | 文件名         |
   131  
   132  使用 HTTP 基本身份验证的示例请求：
   133  
   134  ```shell
   135  curl --user your_username:your_token_or_password -X DELETE \
   136       https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0/file.bin
   137  ```
   138  
   139  服务器将使用以下 HTTP 状态代码进行响应：
   140  
   141  | HTTP 状态码      | 含义               |
   142  | ---------------- | ------------------ |
   143  | `204 No Content` | 成功               |
   144  | `404 Not Found`  | 找不到软件包或文件 |