03.08.2023
Важные изменения в EdgeЦентр API
Мы постоянно улучшаем нашу API-документацию, чтобы сделать работу с ней более удобной. Несколько таких улучшений мы провели недавно:
- Обновили часть URL для CDN и стриминговой платформы, чтобы сделать их семантически более понятными и упростить работу с ними.
- В API DNS изменили описания методов в структуре разделов и добавили новые.
- Изменили часть эндпоинтов в API облака, хранилища и веб-защиты.
Как изменились URL в EdgeCDN API
| Старые URL | Новые URL |
| cdn/originGroups | cdn/source_groups |
| cdn/originGroups/{originGroup_id}/origins | cdn/source_groups/{source_group_id}/sources |
| cdn/resources/{id}/rules | cdn/resources/{id}/locations |
| cdn/resources/rule_templates | cdn/resources/location_templates |
| cdn/resources/{resource_id}/shielding_v2 | cdn/resources/{resource_id}/shielding |
| cdn/shieldingpop_v2 | cdn/shielding_pop |
| cdn/sslData | cdn/ssl/certificates |
| cdn/sslCertificates | cdn/ssl/ca_certificates |
| cdn/raw_log_settings | /cdn/raw_logs/settings |
| cdn/aws_regions | cdn/raw_logs/aws_regions |
| cdn/statistics/shield_usage/series | cdn/statistics/origin_shielding_usage/series |
| cdn/statistics/shield_usage/aggregated | cdn/statistics/origin_shielding_usage/aggregated |
| cdn/public-ip-list | cdn/public_ips_list |
| cdn/public-net-list | cdn/public_net_list |
Актуальные URL уже указаны в нашей API-документации.
Как изменились URL в EdgeStreaming API
| Старые URL | Новые URL |
| /streams - /streams/{stream-id} /streams/{stream-id}/start_recording /streams/{stream-id}/stop_recording |
/live/streams /live/streams/{stream-id} /live/streams/{stream-id}/recording/start /live/streams/{stream-id}/recording/stop |
| /broadcasts /broadcasts/{broadcast-id} |
/live/multicameras /live/multicameras/{multicamera-id} |
| /restreams /restreams/{restream-id} |
/live/restreams /live/restreams/{restream-id} |
| /videos /videos/{video-id} /videos/{video-id}/upload |
/vod/videos /vod/videos/{video-id} /vod/videos/{video-id}/upload_data |
| /playlists /playlists/{playlist-id} /playlists/{playlist-id}/videos |
/vod/playlists /vod/playlists/{playlist-id} /vod/playlists/{playlist-id}/items |
| /ads /ads/{advert-id} |
/adverts /adverts/{advert-id} |
| /tasks /tasks/{cv-task-id} |
/cv/tasks /cv/tasks/{cv-task-id} |
Актуальные URL уже указаны в нашей API-документации.
Изменения методов в EdgeDNS API
| Было | Стало |
| Clients | Service |
| ClientInfo | Get DNS service details |
| zones | DNS zones |
| List of DNS zones | Get all DNS zones |
| Zone | Get a DNS zone |
| CreateZone | Create a DNS zone |
| UpdateZone | Update a DNS zone |
| Delete DNS zone | Delete a DNS zone |
| Disable DNS zone | Disable a DNS zone |
| Enable DNS zone | Enable a DNS zone |
| ExportZone | Export a DNS zone |
| Import zone | Import a DNS zone |
| rrsets | DNS RRsets |
| List of rrsets | Get all RRsets |
| Get rrset | Get an RRset |
| Create rrset | Create an RRset |
| Update rrset | Update an RRset |
| Delete rrset | Delete an RRset |
| FailoverHistory | Get DNS Failover logs |
| Zone statistics | Get DNS zone statistics |
Новые методы:
| Запрос, возвращающий информацию об оставшихся лимитах тарифного плана | Get plan limits |
| Управление опцией DNS Failover | DNS Failover |
| Запрос, возвращающий статистику использования DNS-зоны | Get DNS zone statistics |
Все изменения уже отражены в API-документации.
Изменения в EdgeCloud API
Изменятся эндпоинты:
| Было | Стало |
| v1/billing_report | v1/billing_report_nocommit |
| /v1/prebilling_report | /v1/usage_report |
| v1/pricing/{project_id}/{region_id}/instances | v1/price_info/{project_id}/{region_id}/instances |
| /v1/pricing/{project_id}/{region_id}/volumes | /v1/price_info/{project_id}/{region_id}/volumes |
| /v1/pricing/{project_id}/{region_id}/k8s/clusters | /v1/price_info/{project_id}/{region_id}/k8s/clusters |
| /v1/pricing/{project_id}/{region_id}/instances/{instance_id} | /v1/price_info/{project_id}/{region_id}/instances/{instance_id} |
| /v1/pricing/{project_id}/{region_id}/k8s/clusters/{cluster_id} | /v1/price_info/{project_id}/{region_id}/k8s/clusters/{cluster_id} |
| /v1/pricing/{project_id}/{region_id}/images | /v1/price_info/{project_id}/{region_id}/images |
| /v1/pricing/{project_id}/{region_id}/floating_ips | /v1/price_info/{project_id}/{region_id}/floating_ips |
| v2/pricing/{project_id}/{region_id}/instances | v2/price_info/{project_id}/{region_id}/instances |
| /v1/pricing/{project_id}/{region_id}/snapshots | /v1/price_info/{project_id}/{region_id}/snapshots |
| /v1/pricing/{project_id}/{region_id}/loadbalancers | /v1/price_info/{project_id}/{region_id}/loadbalancers |
| /v1/pricing/{project_id}/{region_id}/reserved_fixed_ips | /v1/price_info/{project_id}/{region_id}/reserved_fixed_ips |
| /v1/pricing/{project_id}/{region_id}/lifecycle_policy | /v1/price_info/{project_id}/{region_id}/lifecycle_policy |
| v2/limits_requests | v2/quotas_requests |
| v2/limits_requests{req_id} | v2/quotas_requests{req_id} |
| v2/global_quotas/{client_id} | v2/quotas_global/{client_id} |
| v2/client_quotas | v2/quotas_client |
| v2/regional_quotas/{client_id}/{region_id} | v2/quotas_regional/{client_id}/{region_id} |
| v2/client_quotas/{client_id}/notification_threshold | v2/quotas_client/{client_id}/notification_threshold |
| v1/lifecycle_policy/{project_id}/{region_id} | v1/lifecycle_policies/{project_id}/{region_id} |
| /v1/lifecycle_policy/{project_id}/{region_id}/{lifecycle_policy_id} | /v1/lifecycle_policies/{project_id}/{region_id}/{lifecycle_policy_id} |
| /v1/lifecycle_policy/{project_id}/{region_id}/estimate_max_policy_usage | /v1/lifecycle_policies/{project_id}/{region_id}/estimate_max_policy_usage |
| v1/lifecycle_policy/{project_id}/{region_id}/{lifecycle_policy_id}/add_schedules | v1/lifecycle_policies/{project_id}/{region_id}/{lifecycle_policy_id}/add_schedules |
Полностью прекратят своё действие эти эндпоинты:
- v2/billing_report_commit
- v1/limits_requests
- /v1/pricing/{project_id}/{region_id}/ai/clusters
- /v1/pricing/{project_id}/{region_id}/ai/clusters/{instance_id}
Все изменения уже отражены в API-документации.
Изменения в EdgeStorage API
| Было | Стало |
| provisioning/v1/location | resource/v3/locations |
| provisioning/v1/storage | resource/v3/storage |
| provisioning/v1/storage/{id} | resource/v3/storage/{id} |
| provisioning/v1/storage/{id}/credentials | resource/v3/storage/{id}/credentials |
| provisioning/v1/storage/{id}/key/{key_id}/link | resource/v3/storage/{id}/key/{key_id}/link |
| provisioning/v1/storage/{id}/key/{key_id}/unlink | resource/v3/storage/{id}/key/{key_id}/unlink |
| provisioning/v1/storage/{id}/restore | resource/v3/storage/{id}/restore |
| provisioning/v1/storage/{id}/s3/bucket/{name} | resource/v3/storage/{id}/s3/bucket/{name} |
| provisioning/v1/storage/{id}/s3/bucket/{name}/cors | resource/v3/storage/{id}/s3/bucket/{name}/cors |
| provisioning/v1/storage/{id}/s3/bucket/{name}/lifecycle | resource/v3/storage/{id}/s3/bucket/{name}/lifecycle |
| provisioning/v1/storage/{id}/s3/bucket/{name}/policy | resource/v3/storage/{id}/s3/bucket/{name}/policy |
| provisioning/v1/storage/{id}/s3/buckets | resource/v3/storage/{id}/s3/buckets |
| provisioning/v2/storage | resource/v3/storage |
| stats/v1/storage/usage/series | stats/v1/storage/usage/series |
Полностью прекратят своё действие эти эндпоинты:
- notifications/v1/event
- notifications/v1/events
- notifications/v1/events/configurator
- provisioning/v1/key
- provisioning/v1/key/{id}
- provisioning/v2/key
- provisioning/v1/storage
- provisioning/v1/storage/{id}
Все изменения уже отражены в API-документации.
Изменения в API веб-защиты
Изменятся эндпоинты:
| Было | Стало |
| /security/resources | /protection/resources |
| /security/resources/{resource_id} | /protection/resources/{resource_id} |
Обновления уже доступны в API-документации.
Почему это важно
Изменения коснутся наших клиентов, которые используют перечисленные URL, методы и эндпоинты в API-запросах.
Если вы их используете, вам обязательно нужно заменить их на новые. Изменения вступят в силу в начале сентября 2023 года. Менять можно уже сейчас. В сентябре старые URL методы и эндпоинты перестанут работать.
12.07.2023
Продуктовые новости EdgeЦентр: второй квартал 2023
Делимся важными обновлениями в наших продуктах за апрель, май и июнь.
20.06.2022
Теперь получать доступ к логам на CDN можно бесплатно
Функция Просмотр логов позволяет получать данные о работе системы прямо в пользовательском интерфейсе или при помощи API.