Documentation
¶
Index ¶
- Constants
- type APIKey
- type APIKeyList
- type APIKeyNewParams
- type APIKeyService
- func (r *APIKeyService) Delete(ctx context.Context, apiKeyID string, opts ...option.RequestOption) (err error)
- func (r *APIKeyService) Get(ctx context.Context, apiKeyID string, opts ...option.RequestOption) (res *APIKey, err error)
- func (r *APIKeyService) List(ctx context.Context, opts ...option.RequestOption) (res *APIKeyList, err error)
- func (r *APIKeyService) New(ctx context.Context, body APIKeyNewParams, opts ...option.RequestOption) (res *APIKey, err error)
- func (r *APIKeyService) Update(ctx context.Context, apiKeyID string, body APIKeyUpdateParams, ...) (res *APIKey, err error)
- type APIKeyStatus
- type APIKeyUpdateParams
- type Error
- type RegionName
- type ResourceStatus
Constants ¶
const RegionNameApSeo1 = shared.RegionNameApSeo1
Equals "ap-seo-1"
const RegionNameApSin1 = shared.RegionNameApSin1
Equals "ap-sin-1"
const RegionNameApTyo1 = shared.RegionNameApTyo1
Equals "ap-tyo-1"
const RegionNameEuFrk1 = shared.RegionNameEuFrk1
Equals "eu-frk-1"
const RegionNameUsChi1 = shared.RegionNameUsChi1
Equals "us-chi-1"
const RegionNameUsSea1 = shared.RegionNameUsSea1
Equals "us-sea-1"
const RegionNameUsSva1 = shared.RegionNameUsSva1
Equals "us-sva-1"
const RegionNameUsWdc1 = shared.RegionNameUsWdc1
Equals "us-wdc-1"
const ResourceStatusCreating = shared.ResourceStatusCreating
Equals "creating"
const ResourceStatusDeleted = shared.ResourceStatusDeleted
Equals "deleted"
const ResourceStatusDeleting = shared.ResourceStatusDeleting
Equals "deleting"
const ResourceStatusError = shared.ResourceStatusError
Equals "error"
const ResourceStatusPending = shared.ResourceStatusPending
Equals "pending"
const ResourceStatusReady = shared.ResourceStatusReady
Equals "ready"
const ResourceStatusUpdating = shared.ResourceStatusUpdating
Equals "updating"
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type APIKey ¶
type APIKey struct {
// API key ID.
ID string `json:"id,required"`
// When the API key was created.
CreatedAt time.Time `json:"created_at,required" format:"date-time"`
// When the API key expires and is no longer valid.
ExpiresAt time.Time `json:"expires_at,required" format:"date-time"`
// API key name.
Name string `json:"name,required"`
// Status of the API key.
//
// Any of "active", "inactive", "expired".
Status APIKeyStatus `json:"status,required"`
// When the API key was updated.
UpdatedAt time.Time `json:"updated_at,required" format:"date-time"`
// User ID that owns the API key.
UserID string `json:"user_id,required"`
// API key. Only returned on creation.
Key string `json:"key"`
// When the API key starts to be valid.
StartsAt time.Time `json:"starts_at" format:"date-time"`
// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
JSON struct {
ID respjson.Field
CreatedAt respjson.Field
ExpiresAt respjson.Field
Name respjson.Field
Status respjson.Field
UpdatedAt respjson.Field
UserID respjson.Field
Key respjson.Field
StartsAt respjson.Field
ExtraFields map[string]respjson.Field
// contains filtered or unexported fields
} `json:"-"`
}
API key response.
func (*APIKey) UnmarshalJSON ¶
type APIKeyList ¶
type APIKeyList struct {
Items []APIKey `json:"items,required"`
// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
JSON struct {
Items respjson.Field
ExtraFields map[string]respjson.Field
// contains filtered or unexported fields
} `json:"-"`
}
func (APIKeyList) RawJSON ¶ added in v1.1.0
func (r APIKeyList) RawJSON() string
Returns the unmodified JSON received from the API
func (*APIKeyList) UnmarshalJSON ¶
func (r *APIKeyList) UnmarshalJSON(data []byte) error
type APIKeyNewParams ¶
type APIKeyNewParams struct {
// When the API key expires and is no longer valid.
ExpiresAt time.Time `json:"expires_at,required" format:"date-time"`
// API key name.
Name string `json:"name,required"`
// When the API key starts to be valid.
StartsAt param.Opt[time.Time] `json:"starts_at,omitzero" format:"date-time"`
// contains filtered or unexported fields
}
func (APIKeyNewParams) MarshalJSON ¶
func (r APIKeyNewParams) MarshalJSON() (data []byte, err error)
func (*APIKeyNewParams) UnmarshalJSON ¶ added in v1.1.0
func (r *APIKeyNewParams) UnmarshalJSON(data []byte) error
type APIKeyService ¶
type APIKeyService struct {
Options []option.RequestOption
}
APIKeyService contains methods and other services that help with interacting with the Nirvana Labs API.
Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewAPIKeyService method instead.
func NewAPIKeyService ¶
func NewAPIKeyService(opts ...option.RequestOption) (r APIKeyService)
NewAPIKeyService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.
func (*APIKeyService) Delete ¶
func (r *APIKeyService) Delete(ctx context.Context, apiKeyID string, opts ...option.RequestOption) (err error)
Delete an API key
func (*APIKeyService) Get ¶
func (r *APIKeyService) Get(ctx context.Context, apiKeyID string, opts ...option.RequestOption) (res *APIKey, err error)
Get details about an API key
func (*APIKeyService) List ¶
func (r *APIKeyService) List(ctx context.Context, opts ...option.RequestOption) (res *APIKeyList, err error)
List all API keys for the authenticated user
func (*APIKeyService) New ¶
func (r *APIKeyService) New(ctx context.Context, body APIKeyNewParams, opts ...option.RequestOption) (res *APIKey, err error)
Create a new API key
func (*APIKeyService) Update ¶ added in v0.4.0
func (r *APIKeyService) Update(ctx context.Context, apiKeyID string, body APIKeyUpdateParams, opts ...option.RequestOption) (res *APIKey, err error)
Update an existing API key
type APIKeyStatus ¶
type APIKeyStatus string
Status of the API key.
const ( APIKeyStatusActive APIKeyStatus = "active" APIKeyStatusInactive APIKeyStatus = "inactive" APIKeyStatusExpired APIKeyStatus = "expired" )
type APIKeyUpdateParams ¶ added in v0.4.0
type APIKeyUpdateParams struct {
// API key name.
Name param.Opt[string] `json:"name,omitzero"`
// contains filtered or unexported fields
}
func (APIKeyUpdateParams) MarshalJSON ¶ added in v0.4.0
func (r APIKeyUpdateParams) MarshalJSON() (data []byte, err error)
func (*APIKeyUpdateParams) UnmarshalJSON ¶ added in v1.1.0
func (r *APIKeyUpdateParams) UnmarshalJSON(data []byte) error
type RegionName ¶
type RegionName = shared.RegionName
Region the resource is in.
This is an alias to an internal type.
type ResourceStatus ¶
type ResourceStatus = shared.ResourceStatus
Status of the resource.
This is an alias to an internal type.