appengine 패키지

import "google.golang.org/appengine"

소개

패키지 appengine은 Google App Engine을 위한 기본적인 기능을 제공합니다.

Google App Engine용 Go 앱을 만드는 방법은 https://cloud.google.com/appengine/docs/standard/go/를 참조하세요.

색인

func AccessToken(c context.Context, scopes ...string) (token string, expiry time.Time, err error)
func AppID(c context.Context) string
func Datacenter(c context.Context) string
func DefaultVersionHostname(c context.Context) string
func InstanceID() string
func IsDevAppServer() bool
func IsOverQuota(err error) bool
func IsTimeoutError(err error) bool
func ModuleHostname(c context.Context, module, version, instance string) (string, error)
func ModuleName(c context.Context) string
func Namespace(c context.Context, namespace string) (context.Context, error)
func NewContext(req *http.Request) context.Context
func PublicCertificates(c context.Context) ([]Certificate, error)
func RequestID(c context.Context) string
func ServerSoftware() string
func ServiceAccount(c context.Context) (string, error)
func SignBytes(c context.Context, bytes []byte) (keyName string, signature []byte, err error)
func VersionID(c context.Context) string
func WithContext(parent context.Context, req *http.Request) context.Context
type BlobKey
type Certificate
type GeoPoint
    func (g GeoPoint) Valid() bool
type MultiError
    func (m MultiError) Error() string

func AccessToken

func AccessToken(c context.Context, scopes ...string) (token string, expiry time.Time, err error)

AccessToken은 OAuth2 이 애플리케이션의 서비스 계정을 대신하여 지정된 범위의 액세스 토큰을 생성합니다. 이 토큰은 반환된 시간 이후 만료됩니다.

func AppID

func AppID(c context.Context) string

AppID는 현재 애플리케이션의 애플리케이션 ID를 반환합니다. 문자열은 일반 애플리케이션 ID(예: 'appid')이며, 맞춤 도메인 배포의 경우 도메인 접두사가 있습니다(예: 'example.com:appid').

func Datacenter

func Datacenter(c context.Context) string

Datacenter는 인스턴스가 실행 중인 데이터 센터의 식별자를 반환합니다.

func DefaultVersionHostname

func DefaultVersionHostname(c context.Context) string

DefaultVersionHostname은 현재 애플리케이션의 기본 버전의 표준 호스트 이름을 반환합니다(예: 'my-app.appspot.com'). URL 작성에 사용하기에 적합합니다.

func InstanceID

func InstanceID() string

InstanceID는 이 인스턴스의 대체로 고유한 식별자를 반환합니다.

func IsDevAppServer

func IsDevAppServer() bool

IsDevAppServer는 App Engine 앱이 개발 앱 서버에서 실행 중인지 여부를 보고합니다.

func IsOverQuota

func IsOverQuota(err error) bool

IsOverQuota는 err이 사용 가능한 할당량 부족으로 인한 API 호출 실패를 나타내는지 여부를 보고합니다.

func IsTimeoutError

func IsTimeoutError(err error) bool

IsTimeoutError는 err이 시간 초과 오류인지 여부를 보고합니다.

func ModuleHostname

func ModuleHostname(c context.Context, module, version, instance string) (string, error)

ModuleHostname은 모듈 인스턴스의 호스트 이름을 참조합니다. 모듈이 빈 문자열인 경우 현재 인스턴스의 모듈을 가리킵니다. 버전이 비어 있으면 현재 인스턴스의 버전(유효한 경우) 또는 현재 인스턴스의 모듈의 기본 버전을 참조합니다. 인스턴스가 비어 있으면 ModuleHostname은 부하 분산 호스트 이름을 반환합니다.

func ModuleName

func ModuleName(c context.Context) string

ModuleName은 현재 인스턴스의 모듈 이름을 반환합니다.

func Namespace

func Namespace(c context.Context, namespace string) (context.Context, error)

Namespace는 지정된 네임스페이스 내에서 작동하는 대체 컨텍스트를 반환합니다.

func NewContext

func NewContext(req *http.Request) context.Context

NewContext는 이동 중인 HTTP 요청의 컨텍스트를 반환합니다. 이 함수는 리소스 사용량이 적습니다.

func PublicCertificates

func PublicCertificates(c context.Context) ([]Certificate, error)

PublicCertificates는 앱의 공개 인증서를 검색합니다. SignBytes에서 반환된 서명을 확인하는 데 사용할 수 있습니다.

func RequestID

func RequestID(c context.Context) string

RequestID는 요청을 고유하게 식별하는 문자열을 반환합니다.

func ServerSoftware

func ServerSoftware() string

ServerSoftware는 App Engine 출시 버전을 반환합니다. 프로덕션에서는 'Google App Engine/X.Y.Z'와 같은 형태입니다. 개발 앱 서버에서는 'Development/X.Y'와 같은 형태입니다.

func ServiceAccount

func ServiceAccount(c context.Context) (string, error)

ServiceAccount는 서비스 계정 이름을 나타내는 문자열을 이메일 주소 형식으로 반환합니다(일반적으로 app_id@appspot.gserviceaccount.com).

func SignBytes

func SignBytes(c context.Context, bytes []byte) (keyName string, signature []byte, err error)

SignBytes는 애플리케이션에 고유한 비공개 키를 사용하여 바이트에 서명합니다.

func VersionID

func VersionID(c context.Context) string

VersionID는 현재 애플리케이션의 버전 ID를 반환합니다. 형식은 'X.Y'입니다. X는 app.yaml에 지정되며, Y는 앱의 각 버전이 업로드될 때 생성되는 번호입니다. 모듈 이름은 포함되지 않습니다.

func WithContext

func WithContext(parent context.Context, req *http.Request) context.Context

WithContext는 상위 컨텍스트의 복사본을 반환하고 이를 이동 중인 HTTP 요청과 연결합니다. 이 함수는 리소스 사용량이 적습니다.

type BlobKey

type BlobKey string

BlobKey는 blobstore blob의 키입니다.

이 유형은 개념적으로는 blobstore 패키지에 속하지만 순환 종속성을 방지하기 위해(blobstore는 datastore에 종속되며 datastore는 BlobKey 유형을 참조해야 함) appengine 패키지에 상주합니다.

type Certificate

type Certificate struct {
    KeyName string
    Data    []byte // PEM-encoded X.509 certificate
}

Certificate는 앱의 공개 인증서를 나타냅니다.

type GeoPoint

type GeoPoint struct {
    Lat, Lng float64
}

GeoPoint는 위치의 위도나 경도를 나타냅니다.

func (GeoPoint) Valid

func (g GeoPoint) Valid() bool

Valid는 GeoPoint가 위도 [-90, 90] 및 경도 [-180, 180] 내에 있는지 여부를 반환합니다.

type MultiError

type MultiError []error

MultiError는 일괄 작업에서 특정 요소에 오류가 있는 경우 반환됩니다. 오류는 입력 요소와 일대일로 대응합니다. 성공적인 요소에는 nil 항목이 있습니다.

func (MultiError) Error

func (m MultiError) Error() string