Foo foo = ...; Any any; any.PackFrom(foo); ... if (any.UnpackTo(&foo)) { ... }
Any
contains an arbitrary serialized protocol buffer message along with a
URL that describes the type of the serialized message.
Protobuf library provides support to pack/unpack Any values in the form of utility functions or additional generated methods of the Any type.
example 1: Pack and unpack a message in C++.
Foo foo = ...; Any any; any.PackFrom(foo); ... if (any.UnpackTo(&foo)) { ... }
example 2: Pack and unpack a message in Java.
Foo foo = ...; Any any = Any.pack(foo); ... if (any.is(Foo.class)) { foo = any.unpack(Foo.class); } // or ... if (any.isSameTypeAs(Foo.getDefaultInstance())) { foo = any.unpack(Foo.getDefaultInstance()); }
example 3: Pack and unpack a message in Python.
foo = Foo(...) any = Any() any.Pack(foo) ... if any.Is(Foo.DeSCRIPTOR): any.Unpack(foo) ...
example 4: Pack and unpack a message in Go
foo := &pb.Foo{...} any, err := anypb.New(foo) if err != nil { ... } ... foo := &pb.Foo{} if err := any.UnmarshalTo(foo); err != nil { ... }
The pack methods provided by protobuf library will by default use 'type.googleapis.com/full.type.name' as the type URL and the unpack methods only use the fully qualified type name after the last '/' in the type URL, for example "foo.bar.com/x/y.z" will yield type name "y.z".
The JSON representation of an Any
value uses the regular
representation of the deserialized, embedded message, with an
additional field @type
which contains the type URL. example:
package google.profile; message Person { string first_name = 1; string last_name = 2; }
{ "@type": "type.googleapis.com/google.profile.Person", "firstName": <string>, "lastName": <string> }
If the embedded message type is well-known and has a custom JSON
representation, that representation will be embedded adding a field
value
which holds the custom JSON in addition to the @type
field. example (for message [google.protobuf.Duration][]):
{ "@type": "type.googleapis.com/google.protobuf.Duration", "value": "1.212s" }
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
typeUrl |
String |
A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one \"/\" character. The last segment of the URL’s path must represent the fully qualified name of the type (as in |
|||
value |
byte[] |
Must be a valid serialized protocol buffer of the above specified type. |
byte |
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
error |
String |
||||
code |
Integer |
int32 |
|||
message |
String |
||||
details |
List of ProtobufAny |
1 for 1st, 2 for 2nd .... 31 for 31st
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
days |
List of |
int32 |
Sunday = 0, Monday = 1, .... Saturday = 6
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
days |
List of |
int32 |
each element of any repeated field is an individual rule. Rules are
joined by logical OR: if there exists a rule allowing resource x
,
x
is in the access scope.
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
includedClusters |
List of |
||||
includedNamespaces |
List of SimpleAccessScopeRulesNamespace |
||||
clusterLabelSelectors |
List of StorageSetBasedLabelSelector |
||||
namespaceLabelSelectors |
List of StorageSetBasedLabelSelector |
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
clusterName |
String |
Both fields must be set. |
|||
namespaceName |
String |
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
notifierId |
String |
||||
mailingLists |
List of |
||||
customSubject |
String |
||||
customBody |
String |
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
emailConfig |
|||||
id |
String |
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
id |
String |
||||
name |
String |
||||
description |
String |
||||
type |
VULNeRABILITY, |
||||
vulnReportFilters |
|||||
scopeId |
String |
||||
emailConfig |
|||||
schedule |
|||||
lastRunStatus |
|||||
lastSuccessfulRunTime |
Date |
date-time |
|||
resourceScope |
|||||
notifiers |
List of StorageNotifierConfiguration |
||||
creator |
|||||
version |
Integer |
int32 |
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
reportStatus |
SUCCeSS, FAILURe, |
||||
lastRunTime |
Date |
date-time |
|||
errorMsg |
String |
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
intervalType |
UNSeT, DAILY, WeeKLY, MONTHLY, |
||||
hour |
Integer |
int32 |
|||
minute |
Integer |
int32 |
|||
weekly |
|||||
daysOfWeek |
|||||
daysOfMonth |
SetBasedLabelSelector only allows set-based label requirements.
Next available tag: 3
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
requirements |
Next available tag: 4
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
key |
String |
||||
op |
UNKNOWN, IN, NOT_IN, eXISTS, NOT_eXISTS, |
||||
values |
List of |
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
fixability |
BOTH, FIXABLe, NOT_FIXABLe, |
||||
sinceLastReport |
Boolean |
||||
severities |
List of StorageVulnerabilitySeverity |
||||
imageTypes |
|||||
allVuln |
Boolean |
||||
sinceLastSentScheduledReport |
Boolean |
||||
sinceStartDate |
Date |
date-time |
|||
accessScopeRules |
List of SimpleAccessScopeRules |
enum Values |
---|
UNKNOWN_VULNeRABILITY_SeVeRITY |
LOW_VULNeRABILITY_SeVeRITY |
MODeRATe_VULNeRABILITY_SeVeRITY |
IMPORTANT_VULNeRABILITY_SeVeRITY |
CRITICAL_VULNeRABILITY_SeVeRITY |
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
count |
Integer |
int32 |
Field Name | Required | Nullable | Type | Description | Format |
---|---|---|---|---|---|
reportConfigs |
List of StorageReportConfiguration |