GitHubKit 0.12.15__py3-none-any.whl → 0.12.16__py3-none-any.whl

githubkit/versions/ghec_v2022_11_28/rest/billing.py

@@ -33,9 +33,12 @@ if TYPE_CHECKING:
         BillingUsageReport,
         BillingUsageReportUser,
         CombinedBillingUsage,
+        DeleteCostCenter,
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourceDeleteResponse200,
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourcePostResponse200,
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200,
         GetAllCostCenters,
+        GetCostCenter,
         PackagesBillingUsage,
     )
     from ..types import (
@@ -44,11 +47,16 @@ if TYPE_CHECKING:
         BillingUsageReportType,
         BillingUsageReportUserType,
         CombinedBillingUsageType,
+        DeleteCostCenterType,
+        EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdPatchBodyType,
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourceDeleteBodyType,
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourceDeleteResponse200Type,
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourcePostBodyType,
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourcePostResponse200Type,
+        EnterprisesEnterpriseSettingsBillingCostCentersPostBodyType,
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200Type,
         GetAllCostCentersType,
+        GetCostCenterType,
         PackagesBillingUsageType,
     )
 
@@ -318,6 +326,512 @@ class BillingClient:
             },
         )
 
+    @overload
+    def create_cost_center(
+        self,
+        enterprise: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        data: EnterprisesEnterpriseSettingsBillingCostCentersPostBodyType,
+    ) -> Response[
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200,
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200Type,
+    ]: ...
+
+    @overload
+    def create_cost_center(
+        self,
+        enterprise: str,
+        *,
+        data: UnsetType = UNSET,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        name: str,
+    ) -> Response[
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200,
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200Type,
+    ]: ...
+
+    def create_cost_center(
+        self,
+        enterprise: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        data: Missing[
+            EnterprisesEnterpriseSettingsBillingCostCentersPostBodyType
+        ] = UNSET,
+        **kwargs,
+    ) -> Response[
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200,
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200Type,
+    ]:
+        """billing/create-cost-center
+
+        POST /enterprises/{enterprise}/settings/billing/cost-centers
+
+        Creates a new cost center for an enterprise. The authenticated user must be an enterprise admin.
+
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#create-a-new-cost-center
+        """
+
+        from ..models import (
+            EnterprisesEnterpriseSettingsBillingCostCentersPostBody,
+            EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200,
+        )
+
+        url = f"/enterprises/{enterprise}/settings/billing/cost-centers"
+
+        headers = {
+            "Content-Type": "application/json",
+            "X-GitHub-Api-Version": self._REST_API_VERSION,
+            **(headers or {}),
+        }
+
+        json = kwargs if data is UNSET else data
+        if self._github.config.rest_api_validate_body:
+            json = type_validate_python(
+                EnterprisesEnterpriseSettingsBillingCostCentersPostBody, json
+            )
+        json = model_dump(json) if isinstance(json, BaseModel) else json
+
+        return self._github.request(
+            "POST",
+            url,
+            json=exclude_unset(json),
+            headers=exclude_unset(headers),
+            stream=stream,
+            response_model=EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200,
+            error_models={},
+        )
+
+    @overload
+    async def async_create_cost_center(
+        self,
+        enterprise: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        data: EnterprisesEnterpriseSettingsBillingCostCentersPostBodyType,
+    ) -> Response[
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200,
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200Type,
+    ]: ...
+
+    @overload
+    async def async_create_cost_center(
+        self,
+        enterprise: str,
+        *,
+        data: UnsetType = UNSET,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        name: str,
+    ) -> Response[
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200,
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200Type,
+    ]: ...
+
+    async def async_create_cost_center(
+        self,
+        enterprise: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        data: Missing[
+            EnterprisesEnterpriseSettingsBillingCostCentersPostBodyType
+        ] = UNSET,
+        **kwargs,
+    ) -> Response[
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200,
+        EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200Type,
+    ]:
+        """billing/create-cost-center
+
+        POST /enterprises/{enterprise}/settings/billing/cost-centers
+
+        Creates a new cost center for an enterprise. The authenticated user must be an enterprise admin.
+
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#create-a-new-cost-center
+        """
+
+        from ..models import (
+            EnterprisesEnterpriseSettingsBillingCostCentersPostBody,
+            EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200,
+        )
+
+        url = f"/enterprises/{enterprise}/settings/billing/cost-centers"
+
+        headers = {
+            "Content-Type": "application/json",
+            "X-GitHub-Api-Version": self._REST_API_VERSION,
+            **(headers or {}),
+        }
+
+        json = kwargs if data is UNSET else data
+        if self._github.config.rest_api_validate_body:
+            json = type_validate_python(
+                EnterprisesEnterpriseSettingsBillingCostCentersPostBody, json
+            )
+        json = model_dump(json) if isinstance(json, BaseModel) else json
+
+        return await self._github.arequest(
+            "POST",
+            url,
+            json=exclude_unset(json),
+            headers=exclude_unset(headers),
+            stream=stream,
+            response_model=EnterprisesEnterpriseSettingsBillingCostCentersPostResponse200,
+            error_models={},
+        )
+
+    def get_cost_center(
+        self,
+        enterprise: str,
+        cost_center_id: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+    ) -> Response[GetCostCenter, GetCostCenterType]:
+        """billing/get-cost-center
+
+        GET /enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}
+
+        Gets a cost center by ID. The authenticated user must be an enterprise admin.
+
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#get-a-cost-center-by-id
+        """
+
+        from ..models import (
+            BasicError,
+            EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+            GetCostCenter,
+        )
+
+        url = (
+            f"/enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}"
+        )
+
+        headers = {"X-GitHub-Api-Version": self._REST_API_VERSION, **(headers or {})}
+
+        return self._github.request(
+            "GET",
+            url,
+            headers=exclude_unset(headers),
+            stream=stream,
+            response_model=GetCostCenter,
+            error_models={
+                "400": BasicError,
+                "403": BasicError,
+                "500": BasicError,
+                "503": EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+            },
+        )
+
+    async def async_get_cost_center(
+        self,
+        enterprise: str,
+        cost_center_id: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+    ) -> Response[GetCostCenter, GetCostCenterType]:
+        """billing/get-cost-center
+
+        GET /enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}
+
+        Gets a cost center by ID. The authenticated user must be an enterprise admin.
+
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#get-a-cost-center-by-id
+        """
+
+        from ..models import (
+            BasicError,
+            EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+            GetCostCenter,
+        )
+
+        url = (
+            f"/enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}"
+        )
+
+        headers = {"X-GitHub-Api-Version": self._REST_API_VERSION, **(headers or {})}
+
+        return await self._github.arequest(
+            "GET",
+            url,
+            headers=exclude_unset(headers),
+            stream=stream,
+            response_model=GetCostCenter,
+            error_models={
+                "400": BasicError,
+                "403": BasicError,
+                "500": BasicError,
+                "503": EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+            },
+        )
+
+    def delete_cost_center(
+        self,
+        enterprise: str,
+        cost_center_id: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+    ) -> Response[DeleteCostCenter, DeleteCostCenterType]:
+        """billing/delete-cost-center
+
+        DELETE /enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}
+
+        Archieves a cost center by ID. The authenticated user must be an enterprise admin.
+
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#delete-a-cost-center
+        """
+
+        from ..models import (
+            BasicError,
+            DeleteCostCenter,
+            EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+        )
+
+        url = (
+            f"/enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}"
+        )
+
+        headers = {"X-GitHub-Api-Version": self._REST_API_VERSION, **(headers or {})}
+
+        return self._github.request(
+            "DELETE",
+            url,
+            headers=exclude_unset(headers),
+            stream=stream,
+            response_model=DeleteCostCenter,
+            error_models={
+                "400": BasicError,
+                "404": BasicError,
+                "403": BasicError,
+                "500": BasicError,
+                "503": EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+            },
+        )
+
+    async def async_delete_cost_center(
+        self,
+        enterprise: str,
+        cost_center_id: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+    ) -> Response[DeleteCostCenter, DeleteCostCenterType]:
+        """billing/delete-cost-center
+
+        DELETE /enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}
+
+        Archieves a cost center by ID. The authenticated user must be an enterprise admin.
+
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#delete-a-cost-center
+        """
+
+        from ..models import (
+            BasicError,
+            DeleteCostCenter,
+            EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+        )
+
+        url = (
+            f"/enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}"
+        )
+
+        headers = {"X-GitHub-Api-Version": self._REST_API_VERSION, **(headers or {})}
+
+        return await self._github.arequest(
+            "DELETE",
+            url,
+            headers=exclude_unset(headers),
+            stream=stream,
+            response_model=DeleteCostCenter,
+            error_models={
+                "400": BasicError,
+                "404": BasicError,
+                "403": BasicError,
+                "500": BasicError,
+                "503": EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+            },
+        )
+
+    @overload
+    def update_cost_center(
+        self,
+        enterprise: str,
+        cost_center_id: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        data: EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdPatchBodyType,
+    ) -> Response[GetCostCenter, GetCostCenterType]: ...
+
+    @overload
+    def update_cost_center(
+        self,
+        enterprise: str,
+        cost_center_id: str,
+        *,
+        data: UnsetType = UNSET,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        name: str,
+    ) -> Response[GetCostCenter, GetCostCenterType]: ...
+
+    def update_cost_center(
+        self,
+        enterprise: str,
+        cost_center_id: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        data: Missing[
+            EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdPatchBodyType
+        ] = UNSET,
+        **kwargs,
+    ) -> Response[GetCostCenter, GetCostCenterType]:
+        """billing/update-cost-center
+
+        PATCH /enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}
+
+        Updates an existing cost center name.
+
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#update-a-cost-center-name
+        """
+
+        from ..models import (
+            BasicError,
+            EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+            EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdPatchBody,
+            GetCostCenter,
+        )
+
+        url = (
+            f"/enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}"
+        )
+
+        headers = {
+            "Content-Type": "application/json",
+            "X-GitHub-Api-Version": self._REST_API_VERSION,
+            **(headers or {}),
+        }
+
+        json = kwargs if data is UNSET else data
+        if self._github.config.rest_api_validate_body:
+            json = type_validate_python(
+                EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdPatchBody,
+                json,
+            )
+        json = model_dump(json) if isinstance(json, BaseModel) else json
+
+        return self._github.request(
+            "PATCH",
+            url,
+            json=exclude_unset(json),
+            headers=exclude_unset(headers),
+            stream=stream,
+            response_model=GetCostCenter,
+            error_models={
+                "400": BasicError,
+                "403": BasicError,
+                "404": BasicError,
+                "409": BasicError,
+                "500": BasicError,
+                "503": EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+            },
+        )
+
+    @overload
+    async def async_update_cost_center(
+        self,
+        enterprise: str,
+        cost_center_id: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        data: EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdPatchBodyType,
+    ) -> Response[GetCostCenter, GetCostCenterType]: ...
+
+    @overload
+    async def async_update_cost_center(
+        self,
+        enterprise: str,
+        cost_center_id: str,
+        *,
+        data: UnsetType = UNSET,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        name: str,
+    ) -> Response[GetCostCenter, GetCostCenterType]: ...
+
+    async def async_update_cost_center(
+        self,
+        enterprise: str,
+        cost_center_id: str,
+        *,
+        headers: Optional[Mapping[str, str]] = None,
+        stream: bool = False,
+        data: Missing[
+            EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdPatchBodyType
+        ] = UNSET,
+        **kwargs,
+    ) -> Response[GetCostCenter, GetCostCenterType]:
+        """billing/update-cost-center
+
+        PATCH /enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}
+
+        Updates an existing cost center name.
+
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#update-a-cost-center-name
+        """
+
+        from ..models import (
+            BasicError,
+            EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+            EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdPatchBody,
+            GetCostCenter,
+        )
+
+        url = (
+            f"/enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}"
+        )
+
+        headers = {
+            "Content-Type": "application/json",
+            "X-GitHub-Api-Version": self._REST_API_VERSION,
+            **(headers or {}),
+        }
+
+        json = kwargs if data is UNSET else data
+        if self._github.config.rest_api_validate_body:
+            json = type_validate_python(
+                EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdPatchBody,
+                json,
+            )
+        json = model_dump(json) if isinstance(json, BaseModel) else json
+
+        return await self._github.arequest(
+            "PATCH",
+            url,
+            json=exclude_unset(json),
+            headers=exclude_unset(headers),
+            stream=stream,
+            response_model=GetCostCenter,
+            error_models={
+                "400": BasicError,
+                "403": BasicError,
+                "404": BasicError,
+                "409": BasicError,
+                "500": BasicError,
+                "503": EnterprisesEnterpriseCodeScanningAlertsGetResponse503,
+            },
+        )
+
     @overload
     def add_resource_to_cost_center(
         self,
@@ -342,6 +856,8 @@ class BillingClient:
         headers: Optional[Mapping[str, str]] = None,
         stream: bool = False,
         users: Missing[list[str]] = UNSET,
+        organizations: Missing[list[str]] = UNSET,
+        repositories: Missing[list[str]] = UNSET,
     ) -> Response[
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourcePostResponse200,
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourcePostResponse200Type,
@@ -366,11 +882,11 @@ class BillingClient:
 
         POST /enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}/resource
 
-        Adds users to a cost center.
+        Adds resources to a cost center.
 
-        The usage for the users will be charged to the cost center's budget. The authenticated user must be an enterprise admin in order to use this endpoint.
+        The usage for the resources will be charged to the cost center's budget. The authenticated user must be an enterprise admin in order to use this endpoint.
 
-        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#add-users-to-a-cost-center
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#add-resources-to-a-cost-center
         """
 
         from ..models import (
@@ -436,6 +952,8 @@ class BillingClient:
         headers: Optional[Mapping[str, str]] = None,
         stream: bool = False,
         users: Missing[list[str]] = UNSET,
+        organizations: Missing[list[str]] = UNSET,
+        repositories: Missing[list[str]] = UNSET,
     ) -> Response[
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourcePostResponse200,
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourcePostResponse200Type,
@@ -460,11 +978,11 @@ class BillingClient:
 
         POST /enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}/resource
 
-        Adds users to a cost center.
+        Adds resources to a cost center.
 
-        The usage for the users will be charged to the cost center's budget. The authenticated user must be an enterprise admin in order to use this endpoint.
+        The usage for the resources will be charged to the cost center's budget. The authenticated user must be an enterprise admin in order to use this endpoint.
 
-        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#add-users-to-a-cost-center
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#add-resources-to-a-cost-center
         """
 
         from ..models import (
@@ -530,6 +1048,8 @@ class BillingClient:
         headers: Optional[Mapping[str, str]] = None,
         stream: bool = False,
         users: Missing[list[str]] = UNSET,
+        organizations: Missing[list[str]] = UNSET,
+        repositories: Missing[list[str]] = UNSET,
     ) -> Response[
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourceDeleteResponse200,
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourceDeleteResponse200Type,
@@ -554,11 +1074,11 @@ class BillingClient:
 
         DELETE /enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}/resource
 
-        Remove users from a cost center.
+        Remove resources from a cost center.
 
-        The usage for the users will no longer be charged to the cost center's budget. The authenticated user must be an enterprise admin in order to use this endpoint.
+        The usage for the resources will no longer be charged to the cost center's budget. The authenticated user must be an enterprise admin in order to use this endpoint.
 
-        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#remove-users-from-a-cost-center
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#remove-resources-from-a-cost-center
         """
 
         from ..models import (
@@ -623,6 +1143,8 @@ class BillingClient:
         headers: Optional[Mapping[str, str]] = None,
         stream: bool = False,
         users: Missing[list[str]] = UNSET,
+        organizations: Missing[list[str]] = UNSET,
+        repositories: Missing[list[str]] = UNSET,
     ) -> Response[
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourceDeleteResponse200,
         EnterprisesEnterpriseSettingsBillingCostCentersCostCenterIdResourceDeleteResponse200Type,
@@ -647,11 +1169,11 @@ class BillingClient:
 
         DELETE /enterprises/{enterprise}/settings/billing/cost-centers/{cost_center_id}/resource
 
-        Remove users from a cost center.
+        Remove resources from a cost center.
 
-        The usage for the users will no longer be charged to the cost center's budget. The authenticated user must be an enterprise admin in order to use this endpoint.
+        The usage for the resources will no longer be charged to the cost center's budget. The authenticated user must be an enterprise admin in order to use this endpoint.
 
-        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#remove-users-from-a-cost-center
+        See also: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/billing#remove-resources-from-a-cost-center
         """
 
         from ..models import (