fastly-go

fastly-go

A Go client library for interacting with most facets of the Fastly API.

NOTE: This API client is auto-generated from Fastly's OpenAPI specification and may not function correctly when used on the Compute platform. Support for Compute is on the roadmap but has not yet been prioritised.

Requirements

Go version 1.18

Installation

Add the following to your project's go.mod:

require (
	github.com/fastly/fastly-go v1.0.0-beta.28
)

Usage

NOTE: The Fastly API requires an API token for most operations.

package main

import (
	"context"
	"fmt"
	"os"

	"github.com/fastly/fastly-go/fastly"
)

func main() {
  cfg := fastly.NewConfiguration()
  apiClient := fastly.NewAPIClient(cfg)
  ctx := fastly.NewAPIKeyContextFromEnv("FASTLY_API_TOKEN")

  req := apiClient.ServiceAPI.CreateService(ctx)

  res, httpResp, err := req.Comment("comment_example").Name("name_example").CustomerID(os.Getenv("FASTLY_CUSTOMER_ID")).ResourceType("vcl").Execute()
  if err != nil {
    fmt.Fprintf(os.Stderr, "Error when calling `ServiceAPI.CreateService`: %+v\n", err)
    fmt.Fprintf(os.Stderr, "Full HTTP response: %+v\n", httpResp)
    return
  }

  fmt.Fprintf(os.Stdout, "Response from `ServiceAPI.CreateService`:\n\n%+v\n\n", res)

  serviceID = *res.ID
  fmt.Printf("Service Name: %s\nService ID: %s\n\n", *res.Name, serviceID)
}

Documentation for API Endpoints

All URIs are relative to https://api.fastly.com

Documentation for Utility Methods

Due to the fact that model structure members are all pointers, this package contains a number of utility functions to easily obtain pointers to values of basic types. Each of these functions takes a value of the given basic type and returns a pointer to it:

• PtrBool
• PtrInt
• PtrInt32
• PtrInt64
• PtrFloat
• PtrFloat32
• PtrFloat64
• PtrString
• PtrTime

Issues

The fastly-go API client currently does not support the following endpoints:

• /alerts/definitions/{definition_id} (DELETE, GET, PUT)
• /alerts/definitions (GET, POST)
• /alerts/history (GET)
• /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)
• /tls/activations/{tls_activation_id} (GET, PATCH)
• /tls/activations (GET)
• /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)

If you encounter any non-security-related bug or unexpected behavior, please file an issue using the bug report template.

Security issues

Please see our SECURITY.md for guidance on reporting security-related issues.

License

MIT.