Generated v1.0.0-beta.16

fastly · Jul 6, 2023 · 770784f · 770784f
1 parent b345ff7
commit 770784f
Show file tree

Hide file tree

Showing 184 changed files with 79,219 additions and 372 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,54 @@
 # Changelog
 
+## [v1.0.0-beta.16](https://github.com/fastly/fastly-go/releases/tag/v1.0.0-beta.16) (2023-07-06)
+
+Substantial changes were made to the underlying OpenAPI specification that produces this API client. These changes have resulted in multiple new endpoints being supported as well as multiple breaking type changes and so we're publishing these changes as a new major release.
+
+**Enhancements:**
+
+- feat(apex_redirect): support all endpoints.
+- feat(contact): support 'create' endpoint.
+- feat(director): support 'update' endpoint.
+- feat(domain_inspector): support all endpoints.
+- feat(iam_roles): support 'add permissions' endpoint.
+- feat(iam_roles): support 'create role' endpoint.
+- feat(iam_roles): support 'delete permissions' endpoint.
+- feat(iam_roles): support 'update role' endpoint.
+- feat(iam_services): support 'add services' endpoint.
+- feat(iam_services): support 'create service group' endpoint.
+- feat(iam_services): support 'remove services' endpoint.
+- feat(iam_services): support 'update service group' endpoint.
+- feat(iam_users): support 'add members' endpoint.
+- feat(iam_users): support 'add roles' endpoint.
+- feat(iam_users): support 'add service groups' endpoint.
+- feat(iam_users): support 'create user group' endpoint.
+- feat(iam_users): support 'remove members' endpoint.
+- feat(iam_users): support 'remove roles' endpoint.
+- feat(iam_users): support 'remove service groups' endpoint.
+- feat(iam_users): support 'update user group' endpoint.
+- feat(legacy_waf): support all endpoints.
+- feat(logging_kafka): support 'update' endpoint.
+- feat(logging_kinesis): support 'update' endpoint.
+- feat(origin_inspector): support all endpoints.
+- feat(request_settings): support 'create' endpoint.
+- feat(response_object): support 'create' endpoint.
+- feat(response_object): support 'update' endpoint.
+- feat(secret_store): support all endpoints.
+- feat(service_authorizations): support 'delete' endpoint.
+- feat(service_authorizations): support 'update' endpoint.
+- feat(snippet): support 'update versioned snippet' endpoint.
+- feat(sudo): support 'request sudo access' endpoint.
+- feat(tokens): support 'revoke multiple tokens' endpoint.
+- feat(tokens): support 'create token' endpoint.
+- feat(waf_active_rules): support 'delete' endpoint.
+
+**Bug fixes:**
+
+- fix(content): update request/response types.
+- fix(events): update metadata type.
+- fix(realtime_entry): update recorded/aggregated type.
+- fix(realtime_measurements): update miss_histogram type.
+
 ## [v1.0.0-beta.15](https://github.com/fastly/fastly-go/releases/tag/v1.0.0-beta.15) (2023-07-05)
 
 **Enhancements:**

diff --git a/README.md b/README.md
diff --git a/docs/ApexRedirectAPI.md b/docs/ApexRedirectAPI.md
@@ -4,13 +4,92 @@ All URIs are relative to *https://api.fastly.com*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------
+[**CreateApexRedirect**](ApexRedirectAPI.md#CreateApexRedirect) | **POST** `/service/{service_id}/version/{version_id}/apex-redirects` | Create an apex redirect
 [**DeleteApexRedirect**](ApexRedirectAPI.md#DeleteApexRedirect) | **DELETE** `/apex-redirects/{apex_redirect_id}` | Delete an apex redirect
 [**GetApexRedirect**](ApexRedirectAPI.md#GetApexRedirect) | **GET** `/apex-redirects/{apex_redirect_id}` | Get an apex redirect
 [**ListApexRedirects**](ApexRedirectAPI.md#ListApexRedirects) | **GET** `/service/{service_id}/version/{version_id}/apex-redirects` | List apex redirects
 [**UpdateApexRedirect**](ApexRedirectAPI.md#UpdateApexRedirect) | **PUT** `/apex-redirects/{apex_redirect_id}` | Update an apex redirect
 
 
 
+## CreateApexRedirect
+
+Create an apex redirect
+
+
+
+### Example
+
+```go
+package main
+
+import (
+    "context"
+    "fmt"
+    "os"
+    "time"
+    "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.
+    serviceID2 := "serviceId_example" // string |  (optional)
+    version := int32(56) // int32 |  (optional)
+    createdAt := time.Now() // time.Time | Date and time in ISO 8601 format. (optional)
+    deletedAt := time.Now() // time.Time | Date and time in ISO 8601 format. (optional)
+    updatedAt := time.Now() // time.Time | Date and time in ISO 8601 format. (optional)
+    statusCode := int32(56) // int32 | HTTP status code used to redirect the client. (optional)
+    domains := []string{"Inner_example"} // []string | Array of apex domains that should redirect to their WWW subdomain. (optional)
+    featureRevision := int32(56) // int32 | Revision number of the apex redirect feature implementation. Defaults to the most recent revision. (optional)
+
+    cfg := fastly.NewConfiguration()
+    apiClient := fastly.NewAPIClient(cfg)
+    ctx := fastly.NewAPIKeyContextFromEnv("FASTLY_API_TOKEN")
+    resp, r, err := apiClient.ApexRedirectAPI.CreateApexRedirect(ctx, serviceID, versionID).ServiceID2(serviceID2).Version(version).CreatedAt(createdAt).DeletedAt(deletedAt).UpdatedAt(updatedAt).StatusCode(statusCode).Domains(domains).FeatureRevision(featureRevision).Execute()
+    if err != nil {
+        fmt.Fprintf(os.Stderr, "Error when calling `ApexRedirectAPI.CreateApexRedirect`: %v\n", err)
+        fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
+    }
+    // response from `CreateApexRedirect`: ApexRedirect
+    fmt.Fprintf(os.Stdout, "Response from `ApexRedirectAPI.CreateApexRedirect`: %v\n", resp)
+}
+```
+
+### Path Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+**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 apiCreateApexRedirectRequest struct via the builder pattern
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **serviceID2** | **string** |  |  **version** | **int32** |  |  **createdAt** | **time.Time** | Date and time in ISO 8601 format. |  **deletedAt** | **time.Time** | Date and time in ISO 8601 format. |  **updatedAt** | **time.Time** | Date and time in ISO 8601 format. |  **statusCode** | **int32** | HTTP status code used to redirect the client. |  **domains** | **[]string** | Array of apex domains that should redirect to their WWW subdomain. |  **featureRevision** | **int32** | Revision number of the apex redirect feature implementation. Defaults to the most recent revision. | 
+
+### Return type
+
+[**ApexRedirect**](ApexRedirect.md)
+
+### Authorization
+
+[API Token](https://developer.fastly.com/reference/api/#authentication)
+
+### HTTP request headers
+
+- **Content-Type**: application/x-www-form-urlencoded
+- **Accept**: application/json
+
+[Back to top](#) | [Back to API list](../README.md#documentation-for-api-endpoints) | [Back to README](../README.md)
+
+
 ## DeleteApexRedirect
 
 Delete an apex redirect

diff --git a/docs/ClientKey.md b/docs/ClientKey.md
@@ -0,0 +1,116 @@
+# ClientKey
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**ClientKey** | Pointer to **string** | A Base64-encoded X25519 public key that can be used with a [libsodium-compatible sealed box](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) to encrypt secrets before upload. | [optional] 
+**Signature** | Pointer to **string** | A Base64-encoded signature of the client key. The signature is generated using the signing key and must be verified before using the client key. | [optional] 
+**ExpiresAt** | Pointer to **NullableTime** | Date and time in ISO 8601 format. | [optional] [readonly] 
+
+## Methods
+
+### NewClientKey
+
+`func NewClientKey() *ClientKey`
+
+NewClientKey instantiates a new ClientKey object
+This constructor will assign default values to properties that have it defined,
+and makes sure properties required by API are set, but the set of arguments
+will change when the set of required properties is changed
+
+### NewClientKeyWithDefaults
+
+`func NewClientKeyWithDefaults() *ClientKey`
+
+NewClientKeyWithDefaults instantiates a new ClientKey object
+This constructor will only assign default values to properties that have it defined,
+but it doesn't guarantee that properties required by API are set
+
+### GetClientKey
+
+`func (o *ClientKey) GetClientKey() string`
+
+GetClientKey returns the ClientKey field if non-nil, zero value otherwise.
+
+### GetClientKeyOk
+
+`func (o *ClientKey) GetClientKeyOk() (*string, bool)`
+
+GetClientKeyOk returns a tuple with the ClientKey field if it's non-nil, zero value otherwise
+and a boolean to check if the value has been set.
+
+### SetClientKey
+
+`func (o *ClientKey) SetClientKey(v string)`
+
+SetClientKey sets ClientKey field to given value.
+
+### HasClientKey
+
+`func (o *ClientKey) HasClientKey() bool`
+
+HasClientKey returns a boolean if a field has been set.
+
+### GetSignature
+
+`func (o *ClientKey) GetSignature() string`
+
+GetSignature returns the Signature field if non-nil, zero value otherwise.
+
+### GetSignatureOk
+
+`func (o *ClientKey) GetSignatureOk() (*string, bool)`
+
+GetSignatureOk returns a tuple with the Signature field if it's non-nil, zero value otherwise
+and a boolean to check if the value has been set.
+
+### SetSignature
+
+`func (o *ClientKey) SetSignature(v string)`
+
+SetSignature sets Signature field to given value.
+
+### HasSignature
+
+`func (o *ClientKey) HasSignature() bool`
+
+HasSignature returns a boolean if a field has been set.
+
+### GetExpiresAt
+
+`func (o *ClientKey) GetExpiresAt() time.Time`
+
+GetExpiresAt returns the ExpiresAt field if non-nil, zero value otherwise.
+
+### GetExpiresAtOk
+
+`func (o *ClientKey) GetExpiresAtOk() (*time.Time, bool)`
+
+GetExpiresAtOk returns a tuple with the ExpiresAt field if it's non-nil, zero value otherwise
+and a boolean to check if the value has been set.
+
+### SetExpiresAt
+
+`func (o *ClientKey) SetExpiresAt(v time.Time)`
+
+SetExpiresAt sets ExpiresAt field to given value.
+
+### HasExpiresAt
+
+`func (o *ClientKey) HasExpiresAt() bool`
+
+HasExpiresAt returns a boolean if a field has been set.
+
+### SetExpiresAtNil
+
+`func (o *ClientKey) SetExpiresAtNil(b bool)`
+
+ SetExpiresAtNil sets the value for ExpiresAt to be an explicit nil
+
+### UnsetExpiresAt
+`func (o *ClientKey) UnsetExpiresAt()`
+
+UnsetExpiresAt ensures that no value is present for ExpiresAt, not even an explicit nil
+
+[Back to API list](../README.md#documentation-for-api-endpoints) | [Back to README](../README.md)
diff --git a/docs/ContactAPI.md b/docs/ContactAPI.md
@@ -4,11 +4,85 @@ All URIs are relative to *https://api.fastly.com*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------
+[**CreateContacts**](ContactAPI.md#CreateContacts) | **POST** `/customer/{customer_id}/contacts` | Add a new customer contact
 [**DeleteContact**](ContactAPI.md#DeleteContact) | **DELETE** `/customer/{customer_id}/contact/{contact_id}` | Delete a contact
 [**ListContacts**](ContactAPI.md#ListContacts) | **GET** `/customer/{customer_id}/contacts` | List contacts
 
 
 
+## CreateContacts
+
+Add a new customer contact
+
+
+
+### Example
+
+```go
+package main
+
+import (
+    "context"
+    "fmt"
+    "os"
+    "github.com/fastly/fastly-go/fastly"
+)
+
+func main() {
+    customerID := "customerId_example" // string | Alphanumeric string identifying the customer.
+    userID := "userId_example" // string | The alphanumeric string representing the user for this customer contact. (optional)
+    contactType := "contactType_example" // string | The type of contact. (optional)
+    name := "name_example" // string | The name of this contact, when user_id is not provided. (optional)
+    email := "email_example" // string | The email of this contact, when a user_id is not provided. (optional)
+    phone := "phone_example" // string | The phone number for this contact. Required for primary, technical, and security contact types. (optional)
+    customerID2 := "customerId_example" // string | The alphanumeric string representing the customer for this customer contact. (optional)
+
+    cfg := fastly.NewConfiguration()
+    apiClient := fastly.NewAPIClient(cfg)
+    ctx := fastly.NewAPIKeyContextFromEnv("FASTLY_API_TOKEN")
+    resp, r, err := apiClient.ContactAPI.CreateContacts(ctx, customerID).UserID(userID).ContactType(contactType).Name(name).Email(email).Phone(phone).CustomerID2(customerID2).Execute()
+    if err != nil {
+        fmt.Fprintf(os.Stderr, "Error when calling `ContactAPI.CreateContacts`: %v\n", err)
+        fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
+    }
+    // response from `CreateContacts`: ContactResponse
+    fmt.Fprintf(os.Stdout, "Response from `ContactAPI.CreateContacts`: %v\n", resp)
+}
+```
+
+### Path Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+**ctx** | **context.Context** | context for authentication, logging, cancellation, deadlines, tracing, etc.
+**customerID** | **string** | Alphanumeric string identifying the customer. | 
+
+### Other Parameters
+
+Other parameters are passed through a pointer to a apiCreateContactsRequest struct via the builder pattern
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **userID** | **string** | The alphanumeric string representing the user for this customer contact. |  **contactType** | **string** | The type of contact. |  **name** | **string** | The name of this contact, when user_id is not provided. |  **email** | **string** | The email of this contact, when a user_id is not provided. |  **phone** | **string** | The phone number for this contact. Required for primary, technical, and security contact types. |  **customerID2** | **string** | The alphanumeric string representing the customer for this customer contact. | 
+
+### Return type
+
+[**ContactResponse**](ContactResponse.md)
+
+### Authorization
+
+[API Token](https://developer.fastly.com/reference/api/#authentication)
+
+### HTTP request headers
+
+- **Content-Type**: application/x-www-form-urlencoded
+- **Accept**: application/json
+
+[Back to top](#) | [Back to API list](../README.md#documentation-for-api-endpoints) | [Back to README](../README.md)
+
+
 ## DeleteContact
 
 Delete a contact