重大变更

关于重大变更

重大变更是指可能需要集成商采取行动的任何变更。 我们将这些变更分为两类：

• 重大：会改变 GraphQL API 的现有查询的变更。 例如，删除字段就是重大变更。
• 危险：不会改变现有查询，但会影响客户端运行时的行为的变更。 添加枚举值就是一个危险变更示例。

我们努力为集成商提供稳定的 API。 当某项新功能还处于演进阶段时，我们将在架构预览模式下发布此功能。

我们将在更改 GraphQL 架构前至少三个月宣布即将发生的重大变更，以便给集成商预留进行必要调整的时间。 变更在季度第一天（1 月 1 日、4 月 1 日、7 月 1 日或 10 月 1 日）生效。 例如，如果我们在 1 月 15 日宣布变更，将在 7 月 1 日执行。

安排在 2022-10-01 进行变更

• Breaking 将对 UnlockAndResetMergeGroupInput.branch 进行变更。.

  描述：

  branch will be removed.

  原因：

  The current merge group for the repository's default branch, the branch argument is now a no-op

• Breaking 将对 RepositoryVulnerabilityAlert.fixReason 进行变更。.

  描述：

  fixReason will be removed.

  原因：

  The fixReason field is being removed. You can still use fixedAt and dismissReason.

• Breaking 将对 RemovePullRequestFromMergeQueueInput.branch 进行变更。.

  描述：

  branch will be removed.

  原因：

  PRs are removed from the merge queue for the base branch, the branch argument is now a no-op

• Breaking 将对 ProjectNextFieldType.TRACKS 进行变更。.

  描述：

  TRACKS will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.TITLE 进行变更。.

  描述：

  TITLE will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.TEXT 进行变更。.

  描述：

  TEXT will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.SINGLE_SELECT 进行变更。.

  描述：

  SINGLE_SELECT will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.REVIEWERS 进行变更。.

  描述：

  REVIEWERS will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.REPOSITORY 进行变更。.

  描述：

  REPOSITORY will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.NUMBER 进行变更。.

  描述：

  NUMBER will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.MILESTONE 进行变更。.

  描述：

  MILESTONE will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.LINKED_PULL_REQUESTS 进行变更。.

  描述：

  LINKED_PULL_REQUESTS will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.LABELS 进行变更。.

  描述：

  LABELS will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.ITERATION 进行变更。.

  描述：

  ITERATION will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.DATE 进行变更。.

  描述：

  DATE will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 ProjectNextFieldType.ASSIGNEES 进行变更。.

  描述：

  ASSIGNEES will be removed. Follow the ProjectV2 guide at https://github.blog/changelog/2022-06-23-the-new-github-issues-june-23rd-update/, to find a suitable replacement.

  原因：

  The ProjectNext API is deprecated in favour of the more capable ProjectV2 API.

• Breaking 将对 MergeLockedMergeGroupInput.branch 进行变更。.

  描述：

  branch will be removed.

  原因：

  Changes are merged into the repository's default branch, the branch argument is now a no-op

• Breaking 将对 LockMergeQueueInput.branch 进行变更。.

  描述：

  branch will be removed.

  原因：

  The merge queue is locked for the repository's default branch, the branch argument is now a no-op

安排在 2022-07-01 进行变更

• Breaking 将对 Enterprise.userAccounts 进行变更。.

  描述：

  userAccounts will be removed. Use the Enterprise.members field instead.

  原因：

  The Enterprise.userAccounts field is being removed.

• Breaking 将对 AddPullRequestToMergeQueueInput.branch 进行变更。.

  描述：

  branch will be removed.

  原因：

  PRs are added to the merge queue for the base branch, the branch argument is now a no-op

安排在 2022-04-01 进行变更

• Breaking 将对 Repository.defaultMergeQueue 进行变更。.

  描述：

  defaultMergeQueue will be removed. Use Repository.mergeQueue instead.

  原因：

  defaultMergeQueue will be removed.

安排在 2021-10-01 进行变更

• Breaking 将对 ReactionGroup.users 进行变更。.

  描述：

  users will be removed. Use the reactors field instead.

  原因：

  Reactors can now be mannequins, bots, and organizations.

安排在 2021-06-21 进行变更

• Breaking 将对 PackageType.DOCKER 进行变更。.

  描述：

  DOCKER will be removed.

  原因：

  DOCKER will be removed from this enum as this type will be migrated to only be used by the Packages REST API.

安排在 2021-01-01 进行变更

• Breaking 将对 MergeStateStatus.DRAFT 进行变更。.

  描述：

  DRAFT will be removed. Use PullRequest.isDraft instead.

  原因：

  DRAFT state will be removed from this enum and isDraft should be used instead

安排在 2020-10-01 进行变更

• Breaking 将对 PullRequest.timeline 进行变更。.

  描述：

  timeline will be removed. Use PullRequest.timelineItems instead.

  原因：

  timeline will be removed

• Breaking 将对 Issue.timeline 进行变更。.

  描述：

  timeline will be removed. Use Issue.timelineItems instead.

  原因：

  timeline will be removed

安排在 2020-01-01 进行变更

• Breaking 将对 UnassignedEvent.user 进行变更。.

  描述：

  user will be removed. Use the assignee field instead.

  原因：

  Assignees can now be mannequins.

• Breaking 将对 AssignedEvent.user 进行变更。.

  描述：

  user will be removed. Use the assignee field instead.

  原因：

  Assignees can now be mannequins.

安排在 2019-04-01 进行变更

• Breaking 将对 LegacyMigration.uploadUrlTemplate 进行变更。.

  描述：

  uploadUrlTemplate will be removed. Use uploadUrl instead.

  原因：

  uploadUrlTemplate is being removed because it is not a standard URL and adds an extra user step.