Skip to content

Commit

Permalink
feat(zero_trust_device_certificates): update path placeholders (#2204)
Browse files Browse the repository at this point in the history
  • Loading branch information
stainless-app[bot] authored and stainless-bot committed Nov 22, 2024
1 parent 1c97b11 commit f43f392
Show file tree
Hide file tree
Showing 10 changed files with 584 additions and 1 deletion.
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

0 comments on commit f43f392

Please sign in to comment.