Points de terminaison d’API REST pour les règles

Get enterprise ruleset history

Get the history of an enterprise ruleset.

fine_grained_access

no_fine_grained_access

Paramètres pour «Get enterprise ruleset history »

En-têtes
Nom, Type, Description
`accept` string Setting to `application/vnd.github+json` is recommended.

Paramètres de chemin d’accès
Nom, Type, Description
`enterprise` string Requis The slug version of the enterprise name.
`ruleset_id` integer Requis The ID of the ruleset.

Paramètres de requête
Nom, Type, Description
`per_page` integer The number of results per page (max 100). For more information, see "Using pagination in the REST API." Par défaut: `30`
`page` integer The page number of the results to fetch. For more information, see "Using pagination in the REST API." Par défaut: `1`

http_status_code

status_code	Description
`200`	OK
`404`	Resource not found
`500`	Internal Error

code_samples

request_example

get/enterprises/{enterprise}/rulesets/{ruleset_id}/history

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/rulesets/RULESET_ID/history

Response

Status: 200

[
  {
    "version_id": 3,
    "actor": {
      "id": 1,
      "type": "User"
    },
    "updated_at": "2024-10-23T16:29:47Z"
  },
  {
    "version_id": 2,
    "actor": {
      "id": 2,
      "type": "User"
    },
    "updated_at": "2024-09-23T16:29:47Z"
  },
  {
    "version_id": 1,
    "actor": {
      "id": 1,
      "type": "User"
    },
    "updated_at": "2024-08-23T16:29:47Z"
  }
]

Get enterprise ruleset version

Get a version of an enterprise ruleset.

fine_grained_access

no_fine_grained_access

Paramètres pour «Get enterprise ruleset version »

En-têtes
Nom, Type, Description
`accept` string Setting to `application/vnd.github+json` is recommended.

Paramètres de chemin d’accès
Nom, Type, Description
`enterprise` string Requis The slug version of the enterprise name.
`ruleset_id` integer Requis The ID of the ruleset.
`version_id` integer Requis The ID of the version

http_status_code

status_code	Description
`200`	OK
`404`	Resource not found
`500`	Internal Error

code_samples

request_example

get/enterprises/{enterprise}/rulesets/{ruleset_id}/history/{version_id}

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/rulesets/RULESET_ID/history/VERSION_ID

Response

Status: 200

{
  "version_id": 3,
  "actor": {
    "id": 1,
    "type": "User"
  },
  "updated_at": "2024-10-23T16:29:47Z",
  "state": {
    "id": 21,
    "name": "super cool ruleset",
    "target": "repository",
    "source_type": "Enterprise",
    "source": "my-enterprise",
    "enforcement": "active",
    "conditions": {
      "organization_name": {
        "include": [
          "important_organization"
        ]
      },
      "repository_name": {
        "include": [
          "~ALL"
        ]
      }
    },
    "rules": [
      {
        "type": "repository_delete"
      }
    ]
  }
}