fastly-api

fastly API的Rust客户端库，用于与Fastly API的大部分功能进行交互。

[!WARNING] 此API客户端是从Fastly的OpenAPI规范自动生成的，可能在Compute平台上使用时无法正常工作。Compute的支持计划中，但尚未优先考虑。

需求

Rust 2021版

安装

将以下内容添加到 Cargo.toml 中的 [dependencies]

fastly-api = "4.11.0"

使用

use anyhow::Result;
use fastly_api::apis::configuration::{ApiKey, Configuration};
use fastly_api::apis::service_api::{create_service, CreateServiceParams};
use std::env;

#[tokio::main]
async fn main() -> Result<()> {
    let cfg = &Configuration {
        api_key: Some(ApiKey {
            prefix: None,
            key: "YOUR_API_KEY",
        }),
        ..Default::default()
    };
    let service_name = "fastly-rust-service";

    let customer_id = env::var("FASTLY_CUSTOMER_ID")?;
    let params = CreateServiceParams {
        name: Some(service_name.to_string()),
        customer_id: Some(customer_id),
        ..Default::default()
    };

    create_service(cfg, params).await?
}

授权

[!NOTE] Fastly API需要API令牌来进行大多数操作。

通过将 api_key 赋值给配置来设置API令牌，如下所示

let cfg = &Configuration {
    api_key: Some(ApiKey {
        prefix: None,
        key: "YOUR_API_KEY",
    }),
    ..Default::default()
};

或者，设置 FASTLY_API_TOKEN 环境变量并使用默认构造函数

let cfg = &Configuration::default();

API端点

Fastly API的主要文档可以在我们的开发者中心找到。

问题

fastly-rust API客户端目前不支持以下端点

• /alerts/definitions/{definition_id} (DELETE, GET, PUT)
• /alerts/definitions (GET, POST)
• /alerts/history (GET)
• /dns/configurations/{dns_configuration_id} (DELETE, GET, PATCH)
• /dns/configurations (GET, POST)
• /notifications/integration-types (GET)
• /notifications/integrations/{integration_id}/rotateSigningKey (POST)
• /notifications/integrations/{integration_id}/signingKey (GET)
• /notifications/integrations/{integration_id} (DELETE, GET, PATCH)
• /notifications/integrations (GET, POST)
• /notifications/mailinglist-confirmations (POST)
• /resources/stores/kv/{store_id}/batch (PUT)
• /service/{service_id}/version/{version_id}/director (POST)
• /stats/aggregate (GET)
• /stats/field/{field} (GET)
• /stats/regions (GET)
• /stats/service/{service_id}/field/{field} (GET)
• /stats/service/{service_id} (GET)
• /stats/usage_by_month (GET)
• /stats/usage_by_service (GET)
• /stats/usage (GET)
• /stats (GET)
• /tls/activations/{tls_activation_id} (GET, PATCH)
• /tls/activations (GET)
• /tls/configurations/{tls_configuration_id} (DELETE, GET, PATCH)
• /tls/configurations (GET, POST)
• /tls/preview/domains/{domain_id} (GET, PATCH)
• /tls/preview/domains (GET, POST)
• /v1/channel/{service_id}/ts/h/limit/{max_entries} (GET)
• /v1/channel/{service_id}/ts/h (GET)
• /v1/channel/{service_id}/ts/{start_timestamp} (GET)

如果您遇到任何与安全无关的错误或意外行为，请使用错误报告模板提交问题。

安全问题

请参阅我们的SECURITY.md以获取有关报告与安全相关问题的指导。

许可证

MIT.