ACLAPI

Note

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

Method	HTTP request	Description
CreateACL	POST `/service/{service_id}/version/{version_id}/acl`	Create a new ACL
DeleteACL	DELETE `/service/{service_id}/version/{version_id}/acl/{acl_name}`	Delete an ACL
GetACL	GET `/service/{service_id}/version/{version_id}/acl/{acl_name}`	Describe an ACL
ListACLs	GET `/service/{service_id}/version/{version_id}/acl`	List ACLs
UpdateACL	PUT `/service/{service_id}/version/{version_id}/acl/{acl_name}`	Update an ACL

CreateACL

Create a new ACL

Example

package main

import (
    "context"
    "fmt"
    "os"
    "github.com/fastly/fastly-go/fastly"
)

func main() {
    serviceID := "serviceId_example" // string | Alphanumeric string identifying the service.
    versionID := int32(56) // int32 | Integer identifying a service version.
    name := "name_example" // string | Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace. (optional)

    cfg := fastly.NewConfiguration()
    apiClient := fastly.NewAPIClient(cfg)
    ctx := fastly.NewAPIKeyContextFromEnv("FASTLY_API_TOKEN")
    resp, r, err := apiClient.ACLAPI.CreateACL(ctx, serviceID, versionID).Name(name).Execute()
    if err != nil {
        fmt.Fprintf(os.Stderr, "Error when calling `ACLAPI.CreateACL`: %v\n", err)
        fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
    }
    // response from `CreateACL`: ACLResponse
    fmt.Fprintf(os.Stdout, "Response from `ACLAPI.CreateACL`: %v\n", resp)
}

Path Parameters

Name	Type	Description
ctx	context.Context	context for authentication, logging, cancellation, deadlines, tracing, etc.
serviceID	string	Alphanumeric string identifying the service.
versionID	int32	Integer identifying a service version.

Other Parameters

Other parameters are passed through a pointer to a apiCreateACLRequest struct via the builder pattern

Name	Type	Description	Notes
name	string	Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace.

Return type

ACLResponse

Authorization

API Token

HTTP request headers

Content-Type: application/x-www-form-urlencoded
Accept: application/json

Back to top | Back to API list | Back to README

DeleteACL

Delete an ACL

Example

package main

import (
    "context"
    "fmt"
    "os"
    "github.com/fastly/fastly-go/fastly"
)

func main() {
    serviceID := "serviceId_example" // string | Alphanumeric string identifying the service.
    versionID := int32(56) // int32 | Integer identifying a service version.
    aclName := "aclName_example" // string | Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace.

    cfg := fastly.NewConfiguration()
    apiClient := fastly.NewAPIClient(cfg)
    ctx := fastly.NewAPIKeyContextFromEnv("FASTLY_API_TOKEN")
    resp, r, err := apiClient.ACLAPI.DeleteACL(ctx, serviceID, versionID, aclName).Execute()
    if err != nil {
        fmt.Fprintf(os.Stderr, "Error when calling `ACLAPI.DeleteACL`: %v\n", err)
        fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
    }
    // response from `DeleteACL`: InlineResponse200
    fmt.Fprintf(os.Stdout, "Response from `ACLAPI.DeleteACL`: %v\n", resp)
}

Path Parameters

Name	Type	Description
ctx	context.Context	context for authentication, logging, cancellation, deadlines, tracing, etc.
serviceID	string	Alphanumeric string identifying the service.
versionID	int32	Integer identifying a service version.
aclName	string	Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace.

Other Parameters

Other parameters are passed through a pointer to a apiDeleteACLRequest struct via the builder pattern

Name	Type	Description	Notes

Return type

InlineResponse200

Authorization

API Token

HTTP request headers

Content-Type: Not defined
Accept: application/json

Back to top | Back to API list | Back to README

GetACL

Describe an ACL

Example

package main

import (
    "context"
    "fmt"
    "os"
    "github.com/fastly/fastly-go/fastly"
)

func main() {
    serviceID := "serviceId_example" // string | Alphanumeric string identifying the service.
    versionID := int32(56) // int32 | Integer identifying a service version.
    aclName := "aclName_example" // string | Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace.

    cfg := fastly.NewConfiguration()
    apiClient := fastly.NewAPIClient(cfg)
    ctx := fastly.NewAPIKeyContextFromEnv("FASTLY_API_TOKEN")
    resp, r, err := apiClient.ACLAPI.GetACL(ctx, serviceID, versionID, aclName).Execute()
    if err != nil {
        fmt.Fprintf(os.Stderr, "Error when calling `ACLAPI.GetACL`: %v\n", err)
        fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
    }
    // response from `GetACL`: ACLResponse
    fmt.Fprintf(os.Stdout, "Response from `ACLAPI.GetACL`: %v\n", resp)
}

Path Parameters

Name	Type	Description
ctx	context.Context	context for authentication, logging, cancellation, deadlines, tracing, etc.
serviceID	string	Alphanumeric string identifying the service.
versionID	int32	Integer identifying a service version.
aclName	string	Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace.

Other Parameters

Other parameters are passed through a pointer to a apiGetACLRequest struct via the builder pattern

Name	Type	Description	Notes

Return type

ACLResponse

Authorization

API Token

HTTP request headers

Content-Type: Not defined
Accept: application/json

Back to top | Back to API list | Back to README

ListACLs

List ACLs

Example

package main

import (
    "context"
    "fmt"
    "os"
    "github.com/fastly/fastly-go/fastly"
)

func main() {
    serviceID := "serviceId_example" // string | Alphanumeric string identifying the service.
    versionID := int32(56) // int32 | Integer identifying a service version.

    cfg := fastly.NewConfiguration()
    apiClient := fastly.NewAPIClient(cfg)
    ctx := fastly.NewAPIKeyContextFromEnv("FASTLY_API_TOKEN")
    resp, r, err := apiClient.ACLAPI.ListACLs(ctx, serviceID, versionID).Execute()
    if err != nil {
        fmt.Fprintf(os.Stderr, "Error when calling `ACLAPI.ListACLs`: %v\n", err)
        fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
    }
    // response from `ListACLs`: []ACLResponse
    fmt.Fprintf(os.Stdout, "Response from `ACLAPI.ListACLs`: %v\n", resp)
}

Path Parameters

Name	Type	Description
ctx	context.Context	context for authentication, logging, cancellation, deadlines, tracing, etc.
serviceID	string	Alphanumeric string identifying the service.
versionID	int32	Integer identifying a service version.

Other Parameters

Other parameters are passed through a pointer to a apiListACLsRequest struct via the builder pattern

Name	Type	Description	Notes

Return type

[]ACLResponse

Authorization

API Token

HTTP request headers

Content-Type: Not defined
Accept: application/json

Back to top | Back to API list | Back to README

UpdateACL

Update an ACL

Example

package main

import (
    "context"
    "fmt"
    "os"
    "github.com/fastly/fastly-go/fastly"
)

func main() {
    serviceID := "serviceId_example" // string | Alphanumeric string identifying the service.
    versionID := int32(56) // int32 | Integer identifying a service version.
    aclName := "aclName_example" // string | Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace.
    name := "name_example" // string | Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace. (optional)

    cfg := fastly.NewConfiguration()
    apiClient := fastly.NewAPIClient(cfg)
    ctx := fastly.NewAPIKeyContextFromEnv("FASTLY_API_TOKEN")
    resp, r, err := apiClient.ACLAPI.UpdateACL(ctx, serviceID, versionID, aclName).Name(name).Execute()
    if err != nil {
        fmt.Fprintf(os.Stderr, "Error when calling `ACLAPI.UpdateACL`: %v\n", err)
        fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
    }
    // response from `UpdateACL`: ACLResponse
    fmt.Fprintf(os.Stdout, "Response from `ACLAPI.UpdateACL`: %v\n", resp)
}

Path Parameters

Name	Type	Description
ctx	context.Context	context for authentication, logging, cancellation, deadlines, tracing, etc.
serviceID	string	Alphanumeric string identifying the service.
versionID	int32	Integer identifying a service version.
aclName	string	Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace.

Other Parameters

Other parameters are passed through a pointer to a apiUpdateACLRequest struct via the builder pattern

Name	Type	Description	Notes
name	string	Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace.

Return type

ACLResponse

Authorization

API Token

HTTP request headers

Content-Type: application/x-www-form-urlencoded
Accept: application/json

Back to top | Back to API list | Back to README

Files

AclAPI.md

Latest commit

History

AclAPI.md

File metadata and controls

ACLAPI

CreateACL

Example

Path Parameters

Other Parameters

Return type

Authorization

HTTP request headers

DeleteACL

Example

Path Parameters

Other Parameters

Return type

Authorization

HTTP request headers

GetACL

Example

Path Parameters

Other Parameters

Return type

Authorization

HTTP request headers

ListACLs

Example

Path Parameters

Other Parameters

Return type

Authorization

HTTP request headers

UpdateACL

Example

Path Parameters

Other Parameters

Return type

Authorization

HTTP request headers