Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .stats.yml
Original file line number Diff line number Diff line change
@@ -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
16 changes: 16 additions & 0 deletions api.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,14 @@
IncludesResourceWithStreamingResponse,
AsyncIncludesResourceWithStreamingResponse,
)
from .certificates import (
CertificatesResource,
AsyncCertificatesResource,
CertificatesResourceWithRawResponse,
AsyncCertificatesResourceWithRawResponse,
CertificatesResourceWithStreamingResponse,
AsyncCertificatesResourceWithStreamingResponse,
)
from .fallback_domains import (
FallbackDomainsResource,
AsyncFallbackDomainsResource,
Expand Down Expand Up @@ -52,6 +60,12 @@
"AsyncFallbackDomainsResourceWithRawResponse",
"FallbackDomainsResourceWithStreamingResponse",
"AsyncFallbackDomainsResourceWithStreamingResponse",
"CertificatesResource",
"AsyncCertificatesResource",
"CertificatesResourceWithRawResponse",
"AsyncCertificatesResourceWithRawResponse",
"CertificatesResourceWithStreamingResponse",
"AsyncCertificatesResourceWithStreamingResponse",
"DefaultResource",
"AsyncDefaultResource",
"DefaultResourceWithRawResponse",
Expand Down
Original file line number Diff line number Diff line change
@@ -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,
)
Loading