public final class Secret extends GeneratedMessageV3 implements SecretOrBuilder
A Secret is a logical secret whose
value and versions can be accessed.
A Secret is made up of zero or more
SecretVersions that represent
the secret data.
Protobuf type google.cloud.secretmanager.v1.Secret
Static Fields
ANNOTATIONS_FIELD_NUMBER
public static final int ANNOTATIONS_FIELD_NUMBER
Field Value
CREATE_TIME_FIELD_NUMBER
public static final int CREATE_TIME_FIELD_NUMBER
Field Value
ETAG_FIELD_NUMBER
public static final int ETAG_FIELD_NUMBER
Field Value
EXPIRE_TIME_FIELD_NUMBER
public static final int EXPIRE_TIME_FIELD_NUMBER
Field Value
LABELS_FIELD_NUMBER
public static final int LABELS_FIELD_NUMBER
Field Value
NAME_FIELD_NUMBER
public static final int NAME_FIELD_NUMBER
Field Value
REPLICATION_FIELD_NUMBER
public static final int REPLICATION_FIELD_NUMBER
Field Value
ROTATION_FIELD_NUMBER
public static final int ROTATION_FIELD_NUMBER
Field Value
TOPICS_FIELD_NUMBER
public static final int TOPICS_FIELD_NUMBER
Field Value
TTL_FIELD_NUMBER
public static final int TTL_FIELD_NUMBER
Field Value
VERSION_ALIASES_FIELD_NUMBER
public static final int VERSION_ALIASES_FIELD_NUMBER
Field Value
Static Methods
getDefaultInstance()
public static Secret getDefaultInstance()
Returns
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
Returns
newBuilder()
public static Secret.Builder newBuilder()
Returns
newBuilder(Secret prototype)
public static Secret.Builder newBuilder(Secret prototype)
Parameter
| Name |
Description |
prototype |
Secret
|
Returns
public static Secret parseDelimitedFrom(InputStream input)
Parameter
Returns
Exceptions
public static Secret parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(byte[] data)
public static Secret parseFrom(byte[] data)
Parameter
| Name |
Description |
data |
byte[]
|
Returns
Exceptions
parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
public static Secret parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(ByteString data)
public static Secret parseFrom(ByteString data)
Parameter
Returns
Exceptions
parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
public static Secret parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static Secret parseFrom(CodedInputStream input)
Parameter
Returns
Exceptions
public static Secret parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
public static Secret parseFrom(InputStream input)
Parameter
Returns
Exceptions
public static Secret parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parseFrom(ByteBuffer data)
public static Secret parseFrom(ByteBuffer data)
Parameter
Returns
Exceptions
parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
public static Secret parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Exceptions
parser()
public static Parser<Secret> parser()
Returns
Methods
containsAnnotations(String key)
public boolean containsAnnotations(String key)
Optional. Custom metadata about the secret.
Annotations are distinct from various forms of labels.
Annotations exist to allow client tools to store their own state
information without requiring a database.
Annotation keys must be between 1 and 63 characters long, have a UTF-8
encoding of maximum 128 bytes, begin and end with an alphanumeric character
([a-z0-9A-Z]), and may have dashes (-), underscores (_), dots (.), and
alphanumerics in between these symbols.
The total size of annotation keys and values must be less than 16KiB.
map<string, string> annotations = 13 [(.google.api.field_behavior) = OPTIONAL];
containsLabels(String key)
public boolean containsLabels(String key)
The labels assigned to this Secret.
Label keys must be between 1 and 63 characters long, have a UTF-8 encoding
of maximum 128 bytes, and must conform to the following PCRE regular
expression: \p{Ll}\p{Lo}{0,62}
Label values must be between 0 and 63 characters long, have a UTF-8
encoding of maximum 128 bytes, and must conform to the following PCRE
regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
No more than 64 labels can be assigned to a given resource.
map<string, string> labels = 4;
containsVersionAliases(String key)
public boolean containsVersionAliases(String key)
Optional. Mapping from version alias to version name.
A version alias is a string with a maximum length of 63 characters and can
contain uppercase and lowercase letters, numerals, and the hyphen (-)
and underscore ('_') characters. An alias string must start with a
letter and cannot be the string 'latest' or 'NEW'.
No more than 50 aliases can be assigned to a given secret.
Version-Alias pairs will be viewable via GetSecret and modifiable via
UpdateSecret. At launch access by alias will only be supported on
GetSecretVersion and AccessSecretVersion.
map<string, int64> version_aliases = 11 [(.google.api.field_behavior) = OPTIONAL];
equals(Object obj)
public boolean equals(Object obj)
Parameter
Returns
Overrides
getAnnotations()
public Map<String,String> getAnnotations()
Returns
getAnnotationsCount()
public int getAnnotationsCount()
Optional. Custom metadata about the secret.
Annotations are distinct from various forms of labels.
Annotations exist to allow client tools to store their own state
information without requiring a database.
Annotation keys must be between 1 and 63 characters long, have a UTF-8
encoding of maximum 128 bytes, begin and end with an alphanumeric character
([a-z0-9A-Z]), and may have dashes (-), underscores (_), dots (.), and
alphanumerics in between these symbols.
The total size of annotation keys and values must be less than 16KiB.
map<string, string> annotations = 13 [(.google.api.field_behavior) = OPTIONAL];
getAnnotationsMap()
public Map<String,String> getAnnotationsMap()
Optional. Custom metadata about the secret.
Annotations are distinct from various forms of labels.
Annotations exist to allow client tools to store their own state
information without requiring a database.
Annotation keys must be between 1 and 63 characters long, have a UTF-8
encoding of maximum 128 bytes, begin and end with an alphanumeric character
([a-z0-9A-Z]), and may have dashes (-), underscores (_), dots (.), and
alphanumerics in between these symbols.
The total size of annotation keys and values must be less than 16KiB.
map<string, string> annotations = 13 [(.google.api.field_behavior) = OPTIONAL];
getAnnotationsOrDefault(String key, String defaultValue)
public String getAnnotationsOrDefault(String key, String defaultValue)
Optional. Custom metadata about the secret.
Annotations are distinct from various forms of labels.
Annotations exist to allow client tools to store their own state
information without requiring a database.
Annotation keys must be between 1 and 63 characters long, have a UTF-8
encoding of maximum 128 bytes, begin and end with an alphanumeric character
([a-z0-9A-Z]), and may have dashes (-), underscores (_), dots (.), and
alphanumerics in between these symbols.
The total size of annotation keys and values must be less than 16KiB.
map<string, string> annotations = 13 [(.google.api.field_behavior) = OPTIONAL];
getAnnotationsOrThrow(String key)
public String getAnnotationsOrThrow(String key)
Optional. Custom metadata about the secret.
Annotations are distinct from various forms of labels.
Annotations exist to allow client tools to store their own state
information without requiring a database.
Annotation keys must be between 1 and 63 characters long, have a UTF-8
encoding of maximum 128 bytes, begin and end with an alphanumeric character
([a-z0-9A-Z]), and may have dashes (-), underscores (_), dots (.), and
alphanumerics in between these symbols.
The total size of annotation keys and values must be less than 16KiB.
map<string, string> annotations = 13 [(.google.api.field_behavior) = OPTIONAL];
getCreateTime()
public Timestamp getCreateTime()
Output only. The time at which the
Secret was created.
.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
getCreateTimeOrBuilder()
public TimestampOrBuilder getCreateTimeOrBuilder()
Output only. The time at which the
Secret was created.
.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
getDefaultInstanceForType()
public Secret getDefaultInstanceForType()
Returns
getEtag()
Optional. Etag of the currently stored
Secret.
string etag = 8 [(.google.api.field_behavior) = OPTIONAL];
| Type |
Description |
String |
The etag.
|
getEtagBytes()
public ByteString getEtagBytes()
Optional. Etag of the currently stored
Secret.
string etag = 8 [(.google.api.field_behavior) = OPTIONAL];
getExpirationCase()
public Secret.ExpirationCase getExpirationCase()
Returns
getExpireTime()
public Timestamp getExpireTime()
Optional. Timestamp in UTC when the
Secret is scheduled to expire.
This is always provided on output, regardless of what was sent on input.
.google.protobuf.Timestamp expire_time = 6 [(.google.api.field_behavior) = OPTIONAL];
getExpireTimeOrBuilder()
public TimestampOrBuilder getExpireTimeOrBuilder()
Optional. Timestamp in UTC when the
Secret is scheduled to expire.
This is always provided on output, regardless of what was sent on input.
.google.protobuf.Timestamp expire_time = 6 [(.google.api.field_behavior) = OPTIONAL];
getLabels()
public Map<String,String> getLabels()
Returns
getLabelsCount()
public int getLabelsCount()
The labels assigned to this Secret.
Label keys must be between 1 and 63 characters long, have a UTF-8 encoding
of maximum 128 bytes, and must conform to the following PCRE regular
expression: \p{Ll}\p{Lo}{0,62}
Label values must be between 0 and 63 characters long, have a UTF-8
encoding of maximum 128 bytes, and must conform to the following PCRE
regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
No more than 64 labels can be assigned to a given resource.
map<string, string> labels = 4;
getLabelsMap()
public Map<String,String> getLabelsMap()
The labels assigned to this Secret.
Label keys must be between 1 and 63 characters long, have a UTF-8 encoding
of maximum 128 bytes, and must conform to the following PCRE regular
expression: \p{Ll}\p{Lo}{0,62}
Label values must be between 0 and 63 characters long, have a UTF-8
encoding of maximum 128 bytes, and must conform to the following PCRE
regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
No more than 64 labels can be assigned to a given resource.
map<string, string> labels = 4;
getLabelsOrDefault(String key, String defaultValue)
public String getLabelsOrDefault(String key, String defaultValue)
The labels assigned to this Secret.
Label keys must be between 1 and 63 characters long, have a UTF-8 encoding
of maximum 128 bytes, and must conform to the following PCRE regular
expression: \p{Ll}\p{Lo}{0,62}
Label values must be between 0 and 63 characters long, have a UTF-8
encoding of maximum 128 bytes, and must conform to the following PCRE
regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
No more than 64 labels can be assigned to a given resource.
map<string, string> labels = 4;
getLabelsOrThrow(String key)
public String getLabelsOrThrow(String key)
The labels assigned to this Secret.
Label keys must be between 1 and 63 characters long, have a UTF-8 encoding
of maximum 128 bytes, and must conform to the following PCRE regular
expression: \p{Ll}\p{Lo}{0,62}
Label values must be between 0 and 63 characters long, have a UTF-8
encoding of maximum 128 bytes, and must conform to the following PCRE
regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
No more than 64 labels can be assigned to a given resource.
map<string, string> labels = 4;
getName()
Output only. The resource name of the
Secret in the format
projects/*/secrets/*.
string name = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type |
Description |
String |
The name.
|
getNameBytes()
public ByteString getNameBytes()
Output only. The resource name of the
Secret in the format
projects/*/secrets/*.
string name = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];
getParserForType()
public Parser<Secret> getParserForType()
Returns
Overrides
getReplication()
public Replication getReplication()
Required. Immutable. The replication policy of the secret data attached to
the Secret.
The replication policy cannot be changed after the Secret has been created.
.google.cloud.secretmanager.v1.Replication replication = 2 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = REQUIRED];
getReplicationOrBuilder()
public ReplicationOrBuilder getReplicationOrBuilder()
Required. Immutable. The replication policy of the secret data attached to
the Secret.
The replication policy cannot be changed after the Secret has been created.
.google.cloud.secretmanager.v1.Replication replication = 2 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = REQUIRED];
getRotation()
public Rotation getRotation()
Optional. Rotation policy attached to the
Secret. May be excluded if there is
no rotation policy.
.google.cloud.secretmanager.v1.Rotation rotation = 9 [(.google.api.field_behavior) = OPTIONAL];
getRotationOrBuilder()
public RotationOrBuilder getRotationOrBuilder()
Optional. Rotation policy attached to the
Secret. May be excluded if there is
no rotation policy.
.google.cloud.secretmanager.v1.Rotation rotation = 9 [(.google.api.field_behavior) = OPTIONAL];
getSerializedSize()
public int getSerializedSize()
Returns
Overrides
getTopics(int index)
public Topic getTopics(int index)
Optional. A list of up to 10 Pub/Sub topics to which messages are published
when control plane operations are called on the secret or its versions.
repeated .google.cloud.secretmanager.v1.Topic topics = 5 [(.google.api.field_behavior) = OPTIONAL];
| Name |
Description |
index |
int
|
Returns
getTopicsCount()
public int getTopicsCount()
Optional. A list of up to 10 Pub/Sub topics to which messages are published
when control plane operations are called on the secret or its versions.
repeated .google.cloud.secretmanager.v1.Topic topics = 5 [(.google.api.field_behavior) = OPTIONAL];
getTopicsList()
public List<Topic> getTopicsList()
Optional. A list of up to 10 Pub/Sub topics to which messages are published
when control plane operations are called on the secret or its versions.
repeated .google.cloud.secretmanager.v1.Topic topics = 5 [(.google.api.field_behavior) = OPTIONAL];
getTopicsOrBuilder(int index)
public TopicOrBuilder getTopicsOrBuilder(int index)
Optional. A list of up to 10 Pub/Sub topics to which messages are published
when control plane operations are called on the secret or its versions.
repeated .google.cloud.secretmanager.v1.Topic topics = 5 [(.google.api.field_behavior) = OPTIONAL];
| Name |
Description |
index |
int
|
Returns
getTopicsOrBuilderList()
public List<? extends TopicOrBuilder> getTopicsOrBuilderList()
Optional. A list of up to 10 Pub/Sub topics to which messages are published
when control plane operations are called on the secret or its versions.
repeated .google.cloud.secretmanager.v1.Topic topics = 5 [(.google.api.field_behavior) = OPTIONAL];
| Type |
Description |
List<? extends com.google.cloud.secretmanager.v1.TopicOrBuilder> |
|
getTtl()
Input only. The TTL for the
Secret.
.google.protobuf.Duration ttl = 7 [(.google.api.field_behavior) = INPUT_ONLY];
getTtlOrBuilder()
public DurationOrBuilder getTtlOrBuilder()
Input only. The TTL for the
Secret.
.google.protobuf.Duration ttl = 7 [(.google.api.field_behavior) = INPUT_ONLY];
getUnknownFields()
public final UnknownFieldSet getUnknownFields()
Returns
Overrides
getVersionAliases()
public Map<String,Long> getVersionAliases()
Returns
getVersionAliasesCount()
public int getVersionAliasesCount()
Optional. Mapping from version alias to version name.
A version alias is a string with a maximum length of 63 characters and can
contain uppercase and lowercase letters, numerals, and the hyphen (-)
and underscore ('_') characters. An alias string must start with a
letter and cannot be the string 'latest' or 'NEW'.
No more than 50 aliases can be assigned to a given secret.
Version-Alias pairs will be viewable via GetSecret and modifiable via
UpdateSecret. At launch access by alias will only be supported on
GetSecretVersion and AccessSecretVersion.
map<string, int64> version_aliases = 11 [(.google.api.field_behavior) = OPTIONAL];
getVersionAliasesMap()
public Map<String,Long> getVersionAliasesMap()
Optional. Mapping from version alias to version name.
A version alias is a string with a maximum length of 63 characters and can
contain uppercase and lowercase letters, numerals, and the hyphen (-)
and underscore ('_') characters. An alias string must start with a
letter and cannot be the string 'latest' or 'NEW'.
No more than 50 aliases can be assigned to a given secret.
Version-Alias pairs will be viewable via GetSecret and modifiable via
UpdateSecret. At launch access by alias will only be supported on
GetSecretVersion and AccessSecretVersion.
map<string, int64> version_aliases = 11 [(.google.api.field_behavior) = OPTIONAL];
getVersionAliasesOrDefault(String key, long defaultValue)
public long getVersionAliasesOrDefault(String key, long defaultValue)
Optional. Mapping from version alias to version name.
A version alias is a string with a maximum length of 63 characters and can
contain uppercase and lowercase letters, numerals, and the hyphen (-)
and underscore ('_') characters. An alias string must start with a
letter and cannot be the string 'latest' or 'NEW'.
No more than 50 aliases can be assigned to a given secret.
Version-Alias pairs will be viewable via GetSecret and modifiable via
UpdateSecret. At launch access by alias will only be supported on
GetSecretVersion and AccessSecretVersion.
map<string, int64> version_aliases = 11 [(.google.api.field_behavior) = OPTIONAL];
getVersionAliasesOrThrow(String key)
public long getVersionAliasesOrThrow(String key)
Optional. Mapping from version alias to version name.
A version alias is a string with a maximum length of 63 characters and can
contain uppercase and lowercase letters, numerals, and the hyphen (-)
and underscore ('_') characters. An alias string must start with a
letter and cannot be the string 'latest' or 'NEW'.
No more than 50 aliases can be assigned to a given secret.
Version-Alias pairs will be viewable via GetSecret and modifiable via
UpdateSecret. At launch access by alias will only be supported on
GetSecretVersion and AccessSecretVersion.
map<string, int64> version_aliases = 11 [(.google.api.field_behavior) = OPTIONAL];
hasCreateTime()
public boolean hasCreateTime()
Output only. The time at which the
Secret was created.
.google.protobuf.Timestamp create_time = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Type |
Description |
boolean |
Whether the createTime field is set.
|
hasExpireTime()
public boolean hasExpireTime()
Optional. Timestamp in UTC when the
Secret is scheduled to expire.
This is always provided on output, regardless of what was sent on input.
.google.protobuf.Timestamp expire_time = 6 [(.google.api.field_behavior) = OPTIONAL];
| Type |
Description |
boolean |
Whether the expireTime field is set.
|
hasReplication()
public boolean hasReplication()
Required. Immutable. The replication policy of the secret data attached to
the Secret.
The replication policy cannot be changed after the Secret has been created.
.google.cloud.secretmanager.v1.Replication replication = 2 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = REQUIRED];
| Type |
Description |
boolean |
Whether the replication field is set.
|
hasRotation()
public boolean hasRotation()
Optional. Rotation policy attached to the
Secret. May be excluded if there is
no rotation policy.
.google.cloud.secretmanager.v1.Rotation rotation = 9 [(.google.api.field_behavior) = OPTIONAL];
| Type |
Description |
boolean |
Whether the rotation field is set.
|
hasTtl()
Input only. The TTL for the
Secret.
.google.protobuf.Duration ttl = 7 [(.google.api.field_behavior) = INPUT_ONLY];
| Type |
Description |
boolean |
Whether the ttl field is set.
|
hashCode()
Returns
Overrides
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Overrides
internalGetMapField(int number)
protected MapField internalGetMapField(int number)
Parameter
| Name |
Description |
number |
int
|
Returns
Overrides
isInitialized()
public final boolean isInitialized()
Returns
Overrides
newBuilderForType()
public Secret.Builder newBuilderForType()
Returns
newBuilderForType(GeneratedMessageV3.BuilderParent parent)
protected Secret.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Returns
Overrides
newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Returns
Overrides
toBuilder()
public Secret.Builder toBuilder()
Returns
writeTo(CodedOutputStream output)
public void writeTo(CodedOutputStream output)
Parameter
Overrides
Exceptions
