feat(zero_trust_device_certificates): update path placeholders (#2204)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
-configured_endpoints: 1449
+configured_endpoints: 1451
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-1c6fe7515b7879a7cd51bbe9433aeee5d3d30feaf519f42d0d81c64b19f45875.yml

api.md

@@ -4960,6 +4960,22 @@ Methods:
 - <code title="put /accounts/{account_id}/devices/policy/fallback_domains">client.zero_trust.devices.policies.default.fallback_domains.<a href="./src/cloudflare/resources/zero_trust/devices/policies/default/fallback_domains.py">update</a>(\*, account_id, \*\*<a href="src/cloudflare/types/zero_trust/devices/policies/default/fallback_domain_update_params.py">params</a>) -> <a href="./src/cloudflare/types/zero_trust/devices/policies/default/fallback_domain_update_response.py">Optional</a></code>
 - <code title="get /accounts/{account_id}/devices/policy/fallback_domains">client.zero_trust.devices.policies.default.fallback_domains.<a href="./src/cloudflare/resources/zero_trust/devices/policies/default/fallback_domains.py">get</a>(\*, account_id) -> <a href="./src/cloudflare/types/zero_trust/devices/policies/default/fallback_domain_get_response.py">Optional</a></code>
 
+##### Certificates
+
+Types:
+
+```python
+from cloudflare.types.zero_trust.devices.policies.default import (
+    CertificateEditResponse,
+    CertificateGetResponse,
+)
+```
+
+Methods:
+
+- <code title="patch /zones/{zone_id}/devices/policy/certificates">client.zero_trust.devices.policies.default.certificates.<a href="./src/cloudflare/resources/zero_trust/devices/policies/default/certificates.py">edit</a>(\*, zone_id, \*\*<a href="src/cloudflare/types/zero_trust/devices/policies/default/certificate_edit_params.py">params</a>) -> <a href="./src/cloudflare/types/zero_trust/devices/policies/default/certificate_edit_response.py">CertificateEditResponse</a></code>
+- <code title="get /zones/{zone_id}/devices/policy/certificates">client.zero_trust.devices.policies.default.certificates.<a href="./src/cloudflare/resources/zero_trust/devices/policies/default/certificates.py">get</a>(\*, zone_id) -> <a href="./src/cloudflare/types/zero_trust/devices/policies/default/certificate_get_response.py">CertificateGetResponse</a></code>
+
 #### Custom
 
 Types:

src/cloudflare/resources/zero_trust/devices/policies/default/__init__.py

@@ -24,6 +24,14 @@
     IncludesResourceWithStreamingResponse,
     AsyncIncludesResourceWithStreamingResponse,
 )
+from .certificates import (
+    CertificatesResource,
+    AsyncCertificatesResource,
+    CertificatesResourceWithRawResponse,
+    AsyncCertificatesResourceWithRawResponse,
+    CertificatesResourceWithStreamingResponse,
+    AsyncCertificatesResourceWithStreamingResponse,
+)
 from .fallback_domains import (
     FallbackDomainsResource,
     AsyncFallbackDomainsResource,
@@ -52,6 +60,12 @@
     "AsyncFallbackDomainsResourceWithRawResponse",
     "FallbackDomainsResourceWithStreamingResponse",
     "AsyncFallbackDomainsResourceWithStreamingResponse",
+    "CertificatesResource",
+    "AsyncCertificatesResource",
+    "CertificatesResourceWithRawResponse",
+    "AsyncCertificatesResourceWithRawResponse",
+    "CertificatesResourceWithStreamingResponse",
+    "AsyncCertificatesResourceWithStreamingResponse",
     "DefaultResource",
     "AsyncDefaultResource",
     "DefaultResourceWithRawResponse",

src/cloudflare/resources/zero_trust/devices/policies/default/certificates.py

@@ -0,0 +1,300 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Any, cast
+
+import httpx
+
+from ......_types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ......_utils import (
+    maybe_transform,
+    async_maybe_transform,
+)
+from ......_compat import cached_property
+from ......_resource import SyncAPIResource, AsyncAPIResource
+from ......_response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ......_wrappers import ResultWrapper
+from ......_base_client import make_request_options
+from ......types.zero_trust.devices.policies.default import certificate_edit_params
+from ......types.zero_trust.devices.policies.default.certificate_get_response import CertificateGetResponse
+from ......types.zero_trust.devices.policies.default.certificate_edit_response import CertificateEditResponse
+
+__all__ = ["CertificatesResource", "AsyncCertificatesResource"]
+
+
+class CertificatesResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> CertificatesResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/cloudflare/cloudflare-python#accessing-raw-response-data-eg-headers
+        """
+        return CertificatesResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> CertificatesResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/cloudflare/cloudflare-python#with_streaming_response
+        """
+        return CertificatesResourceWithStreamingResponse(self)
+
+    def edit(
+        self,
+        *,
+        zone_id: str,
+        enabled: bool,
+        # 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,
+    ) -> CertificateEditResponse:
+        """
+        Enable Zero Trust Clients to provision a certificate, containing a x509 subject,
+        and referenced by Access device posture policies when the client visits MTLS
+        protected domains. This facilitates device posture without a WARP session.
+
+        Args:
+          enabled: The current status of the device policy certificate provisioning feature for
+              WARP clients.
+
+          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 zone_id:
+            raise ValueError(f"Expected a non-empty value for `zone_id` but received {zone_id!r}")
+        return cast(
+            CertificateEditResponse,
+            self._patch(
+                f"/zones/{zone_id}/devices/policy/certificates",
+                body=maybe_transform({"enabled": enabled}, certificate_edit_params.CertificateEditParams),
+                options=make_request_options(
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    post_parser=ResultWrapper[CertificateEditResponse]._unwrapper,
+                ),
+                cast_to=cast(
+                    Any, ResultWrapper[CertificateEditResponse]
+                ),  # Union types cannot be passed in as arguments in the type system
+            ),
+        )
+
+    def get(
+        self,
+        *,
+        zone_id: str,
+        # 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,
+    ) -> CertificateGetResponse:
+        """
+        Fetches device certificate provisioning
+
+        Args:
+          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 zone_id:
+            raise ValueError(f"Expected a non-empty value for `zone_id` but received {zone_id!r}")
+        return cast(
+            CertificateGetResponse,
+            self._get(
+                f"/zones/{zone_id}/devices/policy/certificates",
+                options=make_request_options(
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    post_parser=ResultWrapper[CertificateGetResponse]._unwrapper,
+                ),
+                cast_to=cast(
+                    Any, ResultWrapper[CertificateGetResponse]
+                ),  # Union types cannot be passed in as arguments in the type system
+            ),
+        )
+
+
+class AsyncCertificatesResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncCertificatesResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/cloudflare/cloudflare-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncCertificatesResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncCertificatesResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/cloudflare/cloudflare-python#with_streaming_response
+        """
+        return AsyncCertificatesResourceWithStreamingResponse(self)
+
+    async def edit(
+        self,
+        *,
+        zone_id: str,
+        enabled: bool,
+        # 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,
+    ) -> CertificateEditResponse:
+        """
+        Enable Zero Trust Clients to provision a certificate, containing a x509 subject,
+        and referenced by Access device posture policies when the client visits MTLS
+        protected domains. This facilitates device posture without a WARP session.
+
+        Args:
+          enabled: The current status of the device policy certificate provisioning feature for
+              WARP clients.
+
+          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 zone_id:
+            raise ValueError(f"Expected a non-empty value for `zone_id` but received {zone_id!r}")
+        return cast(
+            CertificateEditResponse,
+            await self._patch(
+                f"/zones/{zone_id}/devices/policy/certificates",
+                body=await async_maybe_transform({"enabled": enabled}, certificate_edit_params.CertificateEditParams),
+                options=make_request_options(
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    post_parser=ResultWrapper[CertificateEditResponse]._unwrapper,
+                ),
+                cast_to=cast(
+                    Any, ResultWrapper[CertificateEditResponse]
+                ),  # Union types cannot be passed in as arguments in the type system
+            ),
+        )
+
+    async def get(
+        self,
+        *,
+        zone_id: str,
+        # 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,
+    ) -> CertificateGetResponse:
+        """
+        Fetches device certificate provisioning
+
+        Args:
+          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 zone_id:
+            raise ValueError(f"Expected a non-empty value for `zone_id` but received {zone_id!r}")
+        return cast(
+            CertificateGetResponse,
+            await self._get(
+                f"/zones/{zone_id}/devices/policy/certificates",
+                options=make_request_options(
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    post_parser=ResultWrapper[CertificateGetResponse]._unwrapper,
+                ),
+                cast_to=cast(
+                    Any, ResultWrapper[CertificateGetResponse]
+                ),  # Union types cannot be passed in as arguments in the type system
+            ),
+        )
+
+
+class CertificatesResourceWithRawResponse:
+    def __init__(self, certificates: CertificatesResource) -> None:
+        self._certificates = certificates
+
+        self.edit = to_raw_response_wrapper(
+            certificates.edit,
+        )
+        self.get = to_raw_response_wrapper(
+            certificates.get,
+        )
+
+
+class AsyncCertificatesResourceWithRawResponse:
+    def __init__(self, certificates: AsyncCertificatesResource) -> None:
+        self._certificates = certificates
+
+        self.edit = async_to_raw_response_wrapper(
+            certificates.edit,
+        )
+        self.get = async_to_raw_response_wrapper(
+            certificates.get,
+        )
+
+
+class CertificatesResourceWithStreamingResponse:
+    def __init__(self, certificates: CertificatesResource) -> None:
+        self._certificates = certificates
+
+        self.edit = to_streamed_response_wrapper(
+            certificates.edit,
+        )
+        self.get = to_streamed_response_wrapper(
+            certificates.get,
+        )
+
+
+class AsyncCertificatesResourceWithStreamingResponse:
+    def __init__(self, certificates: AsyncCertificatesResource) -> None:
+        self._certificates = certificates
+
+        self.edit = async_to_streamed_response_wrapper(
+            certificates.edit,
+        )
+        self.get = async_to_streamed_response_wrapper(
+            certificates.get,
+        )