gRPCのstatusとerrdetails Go言語版コピペ用

func New(c codes.Code, msg string) *Status
func Newf(c codes.Code, format string, a ...interface{}) *Status

import (
  "google.golang.org/grpc/codes"
  "google.golang.org/grpc/status"
)

//...
st := status.New(codes.InvalidArgument, "bad request")

func (s *Status) WithDetails(details ...proto.Message) (*Status, error)

import "google.golang.org/genproto/googleapis/rpc/errdetails"

//...
dt, err := st.WithDetails(
  &errdetails.LocalizedMessage{
    Locale: "ja-JP",
    Message: "日本語で詳しい説明をします。...",
  },
  //...
)

&errdetails.LocalizedMessage{
  Locale: "ja-JP",
  Message: "日本語で詳しい説明をします。...",
},

&errdetails.Help{
  Links: []*errdetails.Help_Link{
    {
      Description: "使い方",
      Url: "http://www.example.com/help1",
    },
    {
      Description: "使い方その2",
      Url: "http://www.example.com/help2",
    },
  },
},

&errdetails.DebugInfo{
  StackEntries: []string{
    "/src/foo/baa.go: 110", //たぶん、こんな感じのデータを詰めるんでしょう
    "/src/baaa/booo.go: 200",
  },
  Detail: "additional info"
},

type ResourceInfo struct {
    // A name for the type of resource being accessed, e.g. "sql table",
    // "cloud storage bucket", "file", "Google calendar"; or the type URL
    // of the resource: e.g. "type.googleapis.com/google.pubsub.v1.Topic".
    ResourceType string 
    // The name of the resource being accessed.  For example, a shared calendar
    // name: "[email protected]", if the current
    // error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
    ResourceName string
    // The owner of the resource (optional).
    // For example, "user:<owner email>" or "project:<Google developer project
    // id>".
    Owner string
    // Describes what error is encountered when accessing this resource.
    // For example, updating a cloud project may require the `writer` permission
    // on the developer console project.
    Description          string 
//...
}

type RequestInfo struct {
    // An opaque string that should only be interpreted by the service generating
    // it. For example, it can be used to identify requests in the service's logs.
    RequestId string
    // Any data that was used to serve this request. For example, an encrypted
    // stack trace that can be sent back to the service provider for debugging.
    ServingData          string
//...
}

import "github.com/golang/protobuf/ptypes/duration"

// ...
&errdetails.RetryInfo{
  RetryDelay: &duration.Duration{
    Seconds: 60 * 5,
    Nanos: 0,
  },
},

&errdetails.QuotaFailure{
  Violations: []*errdetails.QuotaFailure_Violation{
    {
      Subject: "clientip:<ip address of client>",
      Description: "Daily Limit for read operations exceeded",
    },
  },
},

&errdetails.PreconditionFailure{
  Violations: []*errdetails.PreconditionFailure_Violation{
    {
      Type: "TOS",
      Subject: "google.com/cloud",
      Description: "Terms of service not accepted",
    },
    //...
  },
},

&errdetails.BadRequest{
  FieldViolations: []*errdetails.BadRequest_FieldViolation{
    {
      Field: "birthday",
      Description: "Born in 2050, did you come from the future?", 
    },
  },
},