# 修改仓库文件内容 - ModifyRepositoryFileContents #### 功能介绍 修改仓库文件内容。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ServiceStage&api=UpdateFile)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-servicestage/servicestage_06_0183.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI PUT /v1/{project_id}/git/files/{namespace}/{project}/{path} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 租户项目ID。获取方法，请参考[获取项目ID](https://support.huaweicloud.com/api-servicestage/servicestage_06_0164.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | namespace | 是 | String | **参数解释：** 命名空间ID或者URL编码名称。获取方法，请参考[获取仓库namespaces - ObtainRepositoryNamespaces](https://support.huaweicloud.com/api-servicestage/servicestage_06_0098.html)。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | project | 是 | String | **参数解释：** 仓库项目ID，如果含有"/"，需要将"/"替换为":"。获取方法，请参考[获取命名空间下所有项目 - ObtainAllProjectsInNamespace](https://support.huaweicloud.com/api-servicestage/servicestage_06_0100.html)。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | path | 是 | String | **参数解释：** 文件路径，需要将"/"替换为":"。获取方法，请参考[获取仓库文件目录 - ObtainRepositoryFileDirectory](https://support.huaweicloud.com/api-servicestage/servicestage_06_0110.html)。 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表2查询参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | ref | 是 | String | **参数解释：** 分支名称或者tag名称或者commit哈希。 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求消息 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Content-Type | 是 | String | **参数解释：** 消息体的类型（格式）。 **约束限制：** 不涉及 **取值范围：** application/json;charset=utf8 **默认取值：** 不涉及 | | X-Auth-Token | 是 | String | **参数解释：** 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考[认证鉴权](https://support.huaweicloud.com/api-servicestage/servicestage_06_0010.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | X-Repo-Auth | 是 | String | **参数解释：** 授权名称。通过[获取仓库授权列表 - ObtainGitRepositoryAuthorizationList](https://support.huaweicloud.com/api-servicestage/servicestage_06_0092.html)获取对应的授权名称。 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表4请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | message | 是 | String | **参数解释：** 描述。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | content | 是 | String | **参数解释：** Base64编码后的文件内容。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | sha | 是 | String | **参数解释：** 文件的Blob SHA，可通过[获取仓库文件内容 - ObtainRepositoryFileContents](https://support.huaweicloud.com/api-servicestage/servicestage_06_0111.html)API获取。 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应消息 表5响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | path | String | **参数解释：** 文件路径。 **取值范围：** 不涉及 | #### 请求示例 修改仓库文件内容。 ``` { "message": "update file", "content": "IyA9PSBTY2hlbWEgSW5mb3...", "sha": "4c294617b60715c1d218e61164a3abd4808a4284cbc30e6728a01ad9aada4481" } ``` #### 响应示例 ``` { "path": "app/project.rb" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 操作成功。 | | 400 | 错误的请求。 | #### 错误码 请参考[ServiceStage错误码](https://support.huaweicloud.com/api-servicestage/servicestage_06_0162.html)。