feat(api): update via SDK Studio (#1201)

stainless-app[bot] · stainless-bot · commit c780c91cfcd2 · 2024-07-18T00:33:35.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,2 +1,2 @@
-configured_endpoints: 1258
+configured_endpoints: 1260
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-953162af8002c4c5c32732b1849af4ed6ca3e6944830d1cbe289a60171f2adbe.yml
diff --git a/api.md b/api.md
@@ -5584,6 +5584,8 @@ from cloudflare.types.zero_trust.gateway import (
     CertificateCreateResponse,
     CertificateListResponse,
     CertificateDeleteResponse,
+    CertificateActivateResponse,
+    CertificateDeactivateResponse,
     CertificateGetResponse,
 )
 ```
@@ -5593,6 +5595,8 @@ Methods:
 - <code title="post /accounts/{account_id}/gateway/certificates">client.zero_trust.gateway.certificates.<a href="./src/cloudflare/resources/zero_trust/gateway/certificates.py">create</a>(\*, account_id, \*\*<a href="src/cloudflare/types/zero_trust/gateway/certificate_create_params.py">params</a>) -> <a href="./src/cloudflare/types/zero_trust/gateway/certificate_create_response.py">Optional</a></code>
 - <code title="get /accounts/{account_id}/gateway/certificates">client.zero_trust.gateway.certificates.<a href="./src/cloudflare/resources/zero_trust/gateway/certificates.py">list</a>(\*, account_id) -> <a href="./src/cloudflare/types/zero_trust/gateway/certificate_list_response.py">SyncSinglePage[CertificateListResponse]</a></code>
 - <code title="delete /accounts/{account_id}/gateway/certificates/{certificate_id}">client.zero_trust.gateway.certificates.<a href="./src/cloudflare/resources/zero_trust/gateway/certificates.py">delete</a>(certificate_id, \*, account_id) -> <a href="./src/cloudflare/types/zero_trust/gateway/certificate_delete_response.py">Optional</a></code>
+- <code title="post /accounts/{account_id}/gateway/certificates/{certificate_id}/activate">client.zero_trust.gateway.certificates.<a href="./src/cloudflare/resources/zero_trust/gateway/certificates.py">activate</a>(certificate_id, \*, account_id, \*\*<a href="src/cloudflare/types/zero_trust/gateway/certificate_activate_params.py">params</a>) -> <a href="./src/cloudflare/types/zero_trust/gateway/certificate_activate_response.py">Optional</a></code>
+- <code title="post /accounts/{account_id}/gateway/certificates/{certificate_id}/deactivate">client.zero_trust.gateway.certificates.<a href="./src/cloudflare/resources/zero_trust/gateway/certificates.py">deactivate</a>(certificate_id, \*, account_id, \*\*<a href="src/cloudflare/types/zero_trust/gateway/certificate_deactivate_params.py">params</a>) -> <a href="./src/cloudflare/types/zero_trust/gateway/certificate_deactivate_response.py">Optional</a></code>
 - <code title="get /accounts/{account_id}/gateway/certificates/{certificate_id}">client.zero_trust.gateway.certificates.<a href="./src/cloudflare/resources/zero_trust/gateway/certificates.py">get</a>(certificate_id, \*, account_id) -> <a href="./src/cloudflare/types/zero_trust/gateway/certificate_get_response.py">Optional</a></code>
 
 ## Networks
diff --git a/src/cloudflare/resources/zero_trust/gateway/certificates.py b/src/cloudflare/resources/zero_trust/gateway/certificates.py
@@ -22,11 +22,17 @@
 from ...._wrappers import ResultWrapper
 from ....pagination import SyncSinglePage, AsyncSinglePage
 from ...._base_client import AsyncPaginator, make_request_options
-from ....types.zero_trust.gateway import certificate_create_params
+from ....types.zero_trust.gateway import (
+    certificate_create_params,
+    certificate_activate_params,
+    certificate_deactivate_params,
+)
 from ....types.zero_trust.gateway.certificate_get_response import CertificateGetResponse
 from ....types.zero_trust.gateway.certificate_list_response import CertificateListResponse
 from ....types.zero_trust.gateway.certificate_create_response import CertificateCreateResponse
 from ....types.zero_trust.gateway.certificate_delete_response import CertificateDeleteResponse
+from ....types.zero_trust.gateway.certificate_activate_response import CertificateActivateResponse
+from ....types.zero_trust.gateway.certificate_deactivate_response import CertificateDeactivateResponse
 
 __all__ = ["CertificatesResource", "AsyncCertificatesResource"]
 
@@ -162,6 +168,94 @@ def delete(
             cast_to=cast(Type[Optional[CertificateDeleteResponse]], ResultWrapper[CertificateDeleteResponse]),
         )
 
+    def activate(
+        self,
+        certificate_id: str,
+        *,
+        account_id: str,
+        body: object,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Optional[CertificateActivateResponse]:
+        """
+        Binds a single Zero Trust certificate to the edge.
+
+        Args:
+          certificate_id: Certificate UUID tag.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        if not certificate_id:
+            raise ValueError(f"Expected a non-empty value for `certificate_id` but received {certificate_id!r}")
+        return self._post(
+            f"/accounts/{account_id}/gateway/certificates/{certificate_id}/activate",
+            body=maybe_transform(body, certificate_activate_params.CertificateActivateParams),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                post_parser=ResultWrapper[Optional[CertificateActivateResponse]]._unwrapper,
+            ),
+            cast_to=cast(Type[Optional[CertificateActivateResponse]], ResultWrapper[CertificateActivateResponse]),
+        )
+
+    def deactivate(
+        self,
+        certificate_id: str,
+        *,
+        account_id: str,
+        body: object,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Optional[CertificateDeactivateResponse]:
+        """
+        Unbinds a single Zero Trust certificate from the edge
+
+        Args:
+          certificate_id: Certificate UUID tag.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        if not certificate_id:
+            raise ValueError(f"Expected a non-empty value for `certificate_id` but received {certificate_id!r}")
+        return self._post(
+            f"/accounts/{account_id}/gateway/certificates/{certificate_id}/deactivate",
+            body=maybe_transform(body, certificate_deactivate_params.CertificateDeactivateParams),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                post_parser=ResultWrapper[Optional[CertificateDeactivateResponse]]._unwrapper,
+            ),
+            cast_to=cast(Type[Optional[CertificateDeactivateResponse]], ResultWrapper[CertificateDeactivateResponse]),
+        )
+
     def get(
         self,
         certificate_id: str,
@@ -336,6 +430,94 @@ async def delete(
             cast_to=cast(Type[Optional[CertificateDeleteResponse]], ResultWrapper[CertificateDeleteResponse]),
         )
 
+    async def activate(
+        self,
+        certificate_id: str,
+        *,
+        account_id: str,
+        body: object,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Optional[CertificateActivateResponse]:
+        """
+        Binds a single Zero Trust certificate to the edge.
+
+        Args:
+          certificate_id: Certificate UUID tag.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        if not certificate_id:
+            raise ValueError(f"Expected a non-empty value for `certificate_id` but received {certificate_id!r}")
+        return await self._post(
+            f"/accounts/{account_id}/gateway/certificates/{certificate_id}/activate",
+            body=await async_maybe_transform(body, certificate_activate_params.CertificateActivateParams),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                post_parser=ResultWrapper[Optional[CertificateActivateResponse]]._unwrapper,
+            ),
+            cast_to=cast(Type[Optional[CertificateActivateResponse]], ResultWrapper[CertificateActivateResponse]),
+        )
+
+    async def deactivate(
+        self,
+        certificate_id: str,
+        *,
+        account_id: str,
+        body: object,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Optional[CertificateDeactivateResponse]:
+        """
+        Unbinds a single Zero Trust certificate from the edge
+
+        Args:
+          certificate_id: Certificate UUID tag.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        if not certificate_id:
+            raise ValueError(f"Expected a non-empty value for `certificate_id` but received {certificate_id!r}")
+        return await self._post(
+            f"/accounts/{account_id}/gateway/certificates/{certificate_id}/deactivate",
+            body=await async_maybe_transform(body, certificate_deactivate_params.CertificateDeactivateParams),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                post_parser=ResultWrapper[Optional[CertificateDeactivateResponse]]._unwrapper,
+            ),
+            cast_to=cast(Type[Optional[CertificateDeactivateResponse]], ResultWrapper[CertificateDeactivateResponse]),
+        )
+
     async def get(
         self,
         certificate_id: str,
@@ -392,6 +574,12 @@ def __init__(self, certificates: CertificatesResource) -> None:
         self.delete = to_raw_response_wrapper(
             certificates.delete,
         )
+        self.activate = to_raw_response_wrapper(
+            certificates.activate,
+        )
+        self.deactivate = to_raw_response_wrapper(
+            certificates.deactivate,
+        )
         self.get = to_raw_response_wrapper(
             certificates.get,
         )
@@ -410,6 +598,12 @@ def __init__(self, certificates: AsyncCertificatesResource) -> None:
         self.delete = async_to_raw_response_wrapper(
             certificates.delete,
         )
+        self.activate = async_to_raw_response_wrapper(
+            certificates.activate,
+        )
+        self.deactivate = async_to_raw_response_wrapper(
+            certificates.deactivate,
+        )
         self.get = async_to_raw_response_wrapper(
             certificates.get,
         )
@@ -428,6 +622,12 @@ def __init__(self, certificates: CertificatesResource) -> None:
         self.delete = to_streamed_response_wrapper(
             certificates.delete,
         )
+        self.activate = to_streamed_response_wrapper(
+            certificates.activate,
+        )
+        self.deactivate = to_streamed_response_wrapper(
+            certificates.deactivate,
+        )
         self.get = to_streamed_response_wrapper(
             certificates.get,
         )
@@ -446,6 +646,12 @@ def __init__(self, certificates: AsyncCertificatesResource) -> None:
         self.delete = async_to_streamed_response_wrapper(
             certificates.delete,
         )
+        self.activate = async_to_streamed_response_wrapper(
+            certificates.activate,
+        )
+        self.deactivate = async_to_streamed_response_wrapper(
+            certificates.deactivate,
+        )
         self.get = async_to_streamed_response_wrapper(
             certificates.get,
         )
diff --git a/src/cloudflare/types/zero_trust/gateway/__init__.py b/src/cloudflare/types/zero_trust/gateway/__init__.py
@@ -55,6 +55,7 @@
 from .configuration_get_response import ConfigurationGetResponse as ConfigurationGetResponse
 from .proxy_endpoint_edit_params import ProxyEndpointEditParams as ProxyEndpointEditParams
 from .activity_log_settings_param import ActivityLogSettingsParam as ActivityLogSettingsParam
+from .certificate_activate_params import CertificateActivateParams as CertificateActivateParams
 from .certificate_create_response import CertificateCreateResponse as CertificateCreateResponse
 from .certificate_delete_response import CertificateDeleteResponse as CertificateDeleteResponse
 from .configuration_edit_response import ConfigurationEditResponse as ConfigurationEditResponse
@@ -64,13 +65,16 @@
 from .proxy_endpoint_get_response import ProxyEndpointGetResponse as ProxyEndpointGetResponse
 from .body_scanning_settings_param import BodyScanningSettingsParam as BodyScanningSettingsParam
 from .proxy_endpoint_create_params import ProxyEndpointCreateParams as ProxyEndpointCreateParams
+from .certificate_activate_response import CertificateActivateResponse as CertificateActivateResponse
+from .certificate_deactivate_params import CertificateDeactivateParams as CertificateDeactivateParams
 from .configuration_update_response import ConfigurationUpdateResponse as ConfigurationUpdateResponse
 from .extended_email_matching_param import ExtendedEmailMatchingParam as ExtendedEmailMatchingParam
 from .dns_resolver_settings_v4_param import DNSResolverSettingsV4Param as DNSResolverSettingsV4Param
 from .dns_resolver_settings_v6_param import DNSResolverSettingsV6Param as DNSResolverSettingsV6Param
 from .gateway_configuration_settings import GatewayConfigurationSettings as GatewayConfigurationSettings
 from .proxy_endpoint_delete_response import ProxyEndpointDeleteResponse as ProxyEndpointDeleteResponse
 from .audit_ssh_setting_update_params import AuditSSHSettingUpdateParams as AuditSSHSettingUpdateParams
+from .certificate_deactivate_response import CertificateDeactivateResponse as CertificateDeactivateResponse
 from .browser_isolation_settings_param import BrowserIsolationSettingsParam as BrowserIsolationSettingsParam
 from .custom_certificate_settings_param import CustomCertificateSettingsParam as CustomCertificateSettingsParam
 from .gateway_configuration_settings_param import GatewayConfigurationSettingsParam as GatewayConfigurationSettingsParam
diff --git a/src/cloudflare/types/zero_trust/gateway/certificate_activate_params.py b/src/cloudflare/types/zero_trust/gateway/certificate_activate_params.py
@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["CertificateActivateParams"]
+
+
+class CertificateActivateParams(TypedDict, total=False):
+    account_id: Required[str]
+
+    body: Required[object]
diff --git a/src/cloudflare/types/zero_trust/gateway/certificate_activate_response.py b/src/cloudflare/types/zero_trust/gateway/certificate_activate_response.py
@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from ...._models import BaseModel
+
+__all__ = ["CertificateActivateResponse"]
+
+
+class CertificateActivateResponse(BaseModel):
+    id: Optional[str] = None
+    """Certificate UUID tag."""
+
+    binding_status: Optional[Literal["pending_deployment", "active", "pending_deletion", "inactive"]] = None
+    """The deployment status of the certificate on Cloudflare's edge.
+
+    Certificates in the 'active' state may be used for Gateway TLS interception.
+    """
+
+    created_at: Optional[datetime] = None
+
+    enabled: Optional[bool] = None
+    """Use this certificate for Gateway TLS interception"""
+
+    expires_on: Optional[datetime] = None
+
+    type: Optional[Literal["custom", "gateway_managed"]] = None
+    """The type of certificate, either BYO-PKI (custom) or Gateway-managed."""
+
+    updated_at: Optional[datetime] = None
+
+    uploaded_on: Optional[datetime] = None
diff --git a/src/cloudflare/types/zero_trust/gateway/certificate_deactivate_params.py b/src/cloudflare/types/zero_trust/gateway/certificate_deactivate_params.py
@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["CertificateDeactivateParams"]
+
+
+class CertificateDeactivateParams(TypedDict, total=False):
+    account_id: Required[str]
+
+    body: Required[object]
diff --git a/src/cloudflare/types/zero_trust/gateway/certificate_deactivate_response.py b/src/cloudflare/types/zero_trust/gateway/certificate_deactivate_response.py
diff --git a/tests/api_resources/zero_trust/gateway/test_certificates.py b/tests/api_resources/zero_trust/gateway/test_certificates.py

Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`		`-configured_endpoints: 1258`
	`1`	`+configured_endpoints: 1260`
`2`	`2`	`openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-953162af8002c4c5c32732b1849af4ed6ca3e6944830d1cbe289a60171f2adbe.yml`