|
| 1 | +# v5.0.0-beta.2 |
| 2 | + |
| 3 | +> This is a beta release. The API surface may change before the stable release. |
| 4 | +
|
| 5 | +Full diff: [`v5.0.0-beta.1...next`](https://github.com/cloudflare/cloudflare-python/compare/v5.0.0-beta.1...next) |
| 6 | + |
| 7 | +This release includes 278 commits spanning API surface additions, resource restructuring, and |
| 8 | +several new top-level resources. The api.md surface file has been split into per-resource files |
| 9 | +under `src/cloudflare/resources/*/api.md`. |
| 10 | + |
| 11 | +## Breaking Changes |
| 12 | + |
| 13 | +### Removed Resources |
| 14 | + |
| 15 | +The following resources have been removed from the documented API surface as part of the |
| 16 | +treeshaking and resource restructuring work: |
| 17 | + |
| 18 | +- `workers.account_settings` -- `get`, `update` |
| 19 | +- `workers.assets.upload` -- `create` |
| 20 | +- `workers.beta.workers` -- `create`, `delete`, `edit`, `get`, `list`, `update` |
| 21 | +- `workers.beta.workers.versions` -- `create`, `delete`, `get`, `list` |
| 22 | +- `workers.domains` -- `delete`, `get`, `list`, `update` |
| 23 | +- `workers.observability.telemetry` -- `keys`, `query`, `values` |
| 24 | +- `workers.routes` -- `create`, `delete`, `get`, `list`, `update` |
| 25 | +- `workers.scripts` -- `delete`, `get`, `list`, `search`, `update` |
| 26 | +- `workers.scripts.content` -- `get`, `update` |
| 27 | +- `workers.scripts.deployments` -- `create`, `delete`, `get`, `list` |
| 28 | +- `workers.scripts.schedules` -- `get`, `update` |
| 29 | +- `workers.scripts.script_and_version_settings` -- `edit`, `get` |
| 30 | +- `workers.scripts.secrets` -- `delete`, `get`, `list`, `update` |
| 31 | +- `workers.scripts.settings` -- `edit`, `get` |
| 32 | +- `workers.scripts.subdomain` -- `create`, `delete`, `get` |
| 33 | +- `workers.scripts.tail` -- `create`, `delete`, `get` |
| 34 | +- `workers.scripts.versions` -- `create`, `get`, `list` |
| 35 | +- `workers.scripts.assets.upload` -- `create` |
| 36 | +- `workers.subdomains` -- `delete`, `get`, `update` |
| 37 | +- `registrar.domains` -- `get`, `list`, `update` |
| 38 | +- `custom_pages` -- `get`, `list`, `update` |
| 39 | + |
| 40 | +### Removed Methods |
| 41 | + |
| 42 | +- `cloudforce_one.threat_events.delete` |
| 43 | + |
| 44 | +### Replaced Resources |
| 45 | + |
| 46 | +- `aisearch.instances.items` -- `get`, `list` (replaced by `aisearch.namespaces.instances.items`) |
| 47 | + |
| 48 | +## New API Resources |
| 49 | + |
| 50 | +### Top-Level Resources |
| 51 | + |
| 52 | +- **VulnerabilityScanner** -- Full CRUD for vulnerability scanning |
| 53 | + - `credential_sets` -- `create`, `delete`, `edit`, `get`, `list`, `update` |
| 54 | + - `credential_sets.credentials` -- `create`, `delete`, `edit`, `get`, `list`, `update` |
| 55 | + - `scans` -- `create`, `get`, `list` |
| 56 | + - `target_environments` -- `create`, `delete`, `edit`, `get`, `list`, `update` |
| 57 | + |
| 58 | +- **GoogleTagGateway** -- Google Tag Gateway configuration |
| 59 | + - `config` -- `get`, `update` |
| 60 | + |
| 61 | +- **EmailSending** -- Email sending with subdomain management |
| 62 | + - `send`, `send_raw` |
| 63 | + - `subdomains` -- `create`, `delete`, `get`, `list` |
| 64 | + - `subdomains.dns` -- `get` |
| 65 | + |
| 66 | +- **ResourceTagging** -- Resource tagging and key/value management |
| 67 | + - `list` |
| 68 | + - `account_tags` -- `delete`, `get`, `update` |
| 69 | + - `zone_tags` -- `delete`, `get`, `update` |
| 70 | + - `keys` -- `list` |
| 71 | + - `values` -- `list` |
| 72 | + |
| 73 | +### New Sub-Resources on Existing Resources |
| 74 | + |
| 75 | +- **AISearch** (restructured) -- Expanded namespace-based architecture |
| 76 | + - `aisearch.namespaces` -- `create`, `delete`, `list`, `read`, `search`, `update`, |
| 77 | + `chat_completions` |
| 78 | + - `aisearch.namespaces.instances` -- `create`, `list`, `read`, `search`, `stats`, `update`, |
| 79 | + `chat_completions` |
| 80 | + - `aisearch.namespaces.instances.items` -- `chunks`, `create_or_update`, `delete`, `download`, |
| 81 | + `get`, `list`, `logs`, `sync`, `upload` |
| 82 | + - `aisearch.namespaces.instances.jobs` -- `create`, `get`, `list`, `logs`, `update` |
| 83 | + |
| 84 | +- **APIGateway Labels** -- Label management for API Gateway operations |
| 85 | + - `api_gateway.labels` -- `list` |
| 86 | + - `api_gateway.labels.managed` -- `get` |
| 87 | + - `api_gateway.labels.managed.resources.operation` -- `update` |
| 88 | + - `api_gateway.labels.user` -- `bulk_create`, `bulk_delete`, `delete`, `edit`, `get`, `update` |
| 89 | + - `api_gateway.labels.user.resources.operation` -- `update` |
| 90 | + - `api_gateway.operations.labels` -- `bulk_create`, `bulk_delete`, `bulk_update`, `create`, |
| 91 | + `delete`, `update` |
| 92 | + |
| 93 | +- **BrowserRendering** -- DevTools and crawl APIs |
| 94 | + - `browser_rendering.crawl` -- `create`, `delete`, `get` |
| 95 | + - `browser_rendering.devtools.browser` -- `connect`, `create`, `delete`, `launch`, `protocol`, |
| 96 | + `version` |
| 97 | + - `browser_rendering.devtools.browser.page` -- `get` |
| 98 | + - `browser_rendering.devtools.browser.targets` -- `activate`, `create`, `get`, `list` |
| 99 | + - `browser_rendering.devtools.session` -- `get`, `list` |
| 100 | + |
| 101 | +- **CustomPages Assets** -- Custom page asset management |
| 102 | + - `custom_pages.assets` -- `create`, `delete`, `get`, `list`, `update` |
| 103 | + |
| 104 | +- **ACM Custom Trust Store** -- Custom origin trust store |
| 105 | + - `acm.custom_trust_store` -- `create`, `delete`, `get`, `list` |
| 106 | + |
| 107 | +- **Zero Trust** additions |
| 108 | + - `zero_trust.access.users` -- `create`, `delete`, `get`, `update` |
| 109 | + - `zero_trust.devices.ip_profiles` -- `create`, `delete`, `get`, `list`, `update` |
| 110 | + - `zero_trust.dex.rules` -- `create`, `delete`, `get`, `list`, `update` |
| 111 | + - `zero_trust.dlp.settings` -- `delete`, `edit`, `get`, `update` |
| 112 | + - `zero_trust.gateway.pacfiles` -- `create`, `delete`, `get`, `list`, `update` |
| 113 | + - `zero_trust.networks.subnets.warp` -- `create`, `delete`, `edit`, `get` |
| 114 | + - `zero_trust.tunnels.warp_connector.connections` -- `get` |
| 115 | + - `zero_trust.tunnels.warp_connector.connectors` -- `get` |
| 116 | + - `zero_trust.tunnels.warp_connector.failover` -- `update` |
| 117 | + |
| 118 | +- **Zones Environments** -- Zone environment management |
| 119 | + - `zones.environments` -- `create`, `delete`, `edit`, `list`, `rollback`, `update` |
| 120 | + |
| 121 | +- **Registrar Registrations** -- Domain registration management (replaces `registrar.domains`) |
| 122 | + - `registrar.registrations` -- `create`, `edit`, `get`, `list` |
| 123 | + - `registrar.registration_status` -- `get` |
| 124 | + - `registrar.update_status` -- `get` |
| 125 | + |
| 126 | +- **Radar** additions |
| 127 | + - `radar.agent_readiness` -- `summary` |
| 128 | + - `radar.ai.markdown_for_agents` -- `summary`, `timeseries` |
| 129 | + - `radar.entities.asns` -- `botnet_threat_feed` |
| 130 | + - `radar.post_quantum.origin` -- `summary`, `timeseries_groups` |
| 131 | + - `radar.post_quantum.tls` -- `support` |
| 132 | + |
| 133 | +- **Billing Usage** -- PayGo billing usage |
| 134 | + - `billing.usage` -- `paygo` |
| 135 | + |
| 136 | +- **Email Security** -- PhishGuard reporting |
| 137 | + - `email_security.phishguard.reports` -- `list` |
| 138 | + |
| 139 | +- **Brand Protection** -- v2 endpoints |
| 140 | + - `brand_protection.v2` additions |
| 141 | + |
| 142 | +## Bug Fixes |
| 143 | + |
| 144 | +- **fix(dlp)**: Add missing `model_rebuild()`/`update_forward_refs()` calls for |
| 145 | + `CustomProfileSharedEntryCustomEntry` and `IntegrationProfileSharedEntryCustomEntry`, fixing |
| 146 | + pydantic v1 validation errors on DLP profile types. |
| 147 | +- **fix(workers)**: Make `RunQueryParametersNeedleValue` a `BaseModel` with |
| 148 | + `arbitrary_types_allowed` to prevent pydantic config errors. |
0 commit comments