- 0.60.0 (latest)
- 0.59.0
- 0.58.0
- 0.57.0
- 0.56.0
- 0.55.0
- 0.54.0
- 0.53.0
- 0.52.0
- 0.51.0
- 0.50.0
- 0.49.0
- 0.48.0
- 0.47.0
- 0.46.0
- 0.45.0
- 0.44.0
- 0.43.0
- 0.42.0
- 0.41.0
- 0.40.0
- 0.39.0
- 0.38.0
- 0.37.0
- 0.36.0
- 0.35.0
- 0.34.0
- 0.33.0
- 0.32.0
- 0.31.0
- 0.30.0
- 0.29.0
- 0.28.0
- 0.27.0
- 0.26.0
- 0.25.0
- 0.24.0
- 0.23.0
- 0.22.0
- 0.21.0
- 0.20.0
- 0.19.0
- 0.18.0
- 0.17.0
- 0.16.0
- 0.15.0
- 0.14.0
- 0.13.0
- 0.12.0
- 0.11.0
- 0.10.0
- 0.9.1
- 0.8.0
- 0.7.0
- 0.6.0
- 0.5.0
- 0.4.0
- 0.3.0
- 0.2.0
- 0.1.0
Reference documentation and code samples for the Vertex AI V1 API class Google::Api::ResourceDescriptor.
A simple descriptor of a resource type.
ResourceDescriptor annotates a resource message (either by means of a protobuf annotation or use in the service config), and associates the resource's schema, the resource type, and the pattern of the resource name.
Example:
message Topic {
// Indicates this message defines a resource schema.
// Declares the resource type in the format of {service}/{kind}.
// For Kubernetes resources, the format is {api group}/{kind}.
option (google.api.resource) = {
type: "pubsub.googleapis.com/Topic"
pattern: "projects/{project}/topics/{topic}"
};
}
The ResourceDescriptor Yaml config will look like:
resources:
- type: "pubsub.googleapis.com/Topic"
pattern: "projects/{project}/topics/{topic}"
Sometimes, resources have multiple patterns, typically because they can live under multiple parents.
Example:
message LogEntry {
option (google.api.resource) = {
type: "logging.googleapis.com/LogEntry"
pattern: "projects/{project}/logs/{log}"
pattern: "folders/{folder}/logs/{log}"
pattern: "organizations/{organization}/logs/{log}"
pattern: "billingAccounts/{billing_account}/logs/{log}"
};
}
The ResourceDescriptor Yaml config will look like:
resources:
- type: 'logging.googleapis.com/LogEntry'
pattern: "projects/{project}/logs/{log}"
pattern: "folders/{folder}/logs/{log}"
pattern: "organizations/{organization}/logs/{log}"
pattern: "billingAccounts/{billing_account}/logs/{log}"
Inherits
- Object
Extended By
- Google::Protobuf::MessageExts::ClassMethods
Includes
- Google::Protobuf::MessageExts
Methods
#history
def history() -> ::Google::Api::ResourceDescriptor::History
-
(::Google::Api::ResourceDescriptor::History) —
Optional. The historical or future-looking state of the resource pattern.
Example:
// The InspectTemplate message originally only supported resource // names with organization, and project was added later. message InspectTemplate { option (google.api.resource) = { type: "dlp.googleapis.com/InspectTemplate" pattern: "organizations/{organization}/inspectTemplates/{inspect_template}" pattern: "projects/{project}/inspectTemplates/{inspect_template}" history: ORIGINALLY_SINGLE_PATTERN }; }
#history=
def history=(value) -> ::Google::Api::ResourceDescriptor::History
-
value (::Google::Api::ResourceDescriptor::History) —
Optional. The historical or future-looking state of the resource pattern.
Example:
// The InspectTemplate message originally only supported resource // names with organization, and project was added later. message InspectTemplate { option (google.api.resource) = { type: "dlp.googleapis.com/InspectTemplate" pattern: "organizations/{organization}/inspectTemplates/{inspect_template}" pattern: "projects/{project}/inspectTemplates/{inspect_template}" history: ORIGINALLY_SINGLE_PATTERN }; }
-
(::Google::Api::ResourceDescriptor::History) —
Optional. The historical or future-looking state of the resource pattern.
Example:
// The InspectTemplate message originally only supported resource // names with organization, and project was added later. message InspectTemplate { option (google.api.resource) = { type: "dlp.googleapis.com/InspectTemplate" pattern: "organizations/{organization}/inspectTemplates/{inspect_template}" pattern: "projects/{project}/inspectTemplates/{inspect_template}" history: ORIGINALLY_SINGLE_PATTERN }; }
#name_field
def name_field() -> ::String
- (::String) — Optional. The field on the resource that designates the resource name field. If omitted, this is assumed to be "name".
#name_field=
def name_field=(value) -> ::String
- value (::String) — Optional. The field on the resource that designates the resource name field. If omitted, this is assumed to be "name".
- (::String) — Optional. The field on the resource that designates the resource name field. If omitted, this is assumed to be "name".
#pattern
def pattern() -> ::Array<::String>
-
(::Array<::String>) — Optional. The relative resource name pattern associated with this resource
type. The DNS prefix of the full resource name shouldn't be specified here.
The path pattern must follow the syntax, which aligns with HTTP binding syntax:
Template = Segment { "/" Segment } ; Segment = LITERAL | Variable ; Variable = "{" LITERAL "}" ;
Examples:
- "projects/\\{project}/topics/\\{topic}" - "projects/\\{project}/knowledgeBases/\\{knowledge_base}"
The components in braces correspond to the IDs for each resource in the hierarchy. It is expected that, if multiple patterns are provided, the same component name (e.g. "project") refers to IDs of the same type of resource.
#pattern=
def pattern=(value) -> ::Array<::String>
-
value (::Array<::String>) — Optional. The relative resource name pattern associated with this resource
type. The DNS prefix of the full resource name shouldn't be specified here.
The path pattern must follow the syntax, which aligns with HTTP binding syntax:
Template = Segment { "/" Segment } ; Segment = LITERAL | Variable ; Variable = "{" LITERAL "}" ;
Examples:
- "projects/\\{project}/topics/\\{topic}" - "projects/\\{project}/knowledgeBases/\\{knowledge_base}"
The components in braces correspond to the IDs for each resource in the hierarchy. It is expected that, if multiple patterns are provided, the same component name (e.g. "project") refers to IDs of the same type of resource.
-
(::Array<::String>) — Optional. The relative resource name pattern associated with this resource
type. The DNS prefix of the full resource name shouldn't be specified here.
The path pattern must follow the syntax, which aligns with HTTP binding syntax:
Template = Segment { "/" Segment } ; Segment = LITERAL | Variable ; Variable = "{" LITERAL "}" ;
Examples:
- "projects/\\{project}/topics/\\{topic}" - "projects/\\{project}/knowledgeBases/\\{knowledge_base}"
The components in braces correspond to the IDs for each resource in the hierarchy. It is expected that, if multiple patterns are provided, the same component name (e.g. "project") refers to IDs of the same type of resource.
#plural
def plural() -> ::String
-
(::String) — The plural name used in the resource name and permission names, such as
'projects' for the resource name of 'projects/{project}' and the permission
name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
concept of the
plural
field in k8s CRD spec https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/Note: The plural form is required even for singleton resources. See https://aip.dev/156
#plural=
def plural=(value) -> ::String
-
value (::String) — The plural name used in the resource name and permission names, such as
'projects' for the resource name of 'projects/{project}' and the permission
name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
concept of the
plural
field in k8s CRD spec https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/Note: The plural form is required even for singleton resources. See https://aip.dev/156
-
(::String) — The plural name used in the resource name and permission names, such as
'projects' for the resource name of 'projects/{project}' and the permission
name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
concept of the
plural
field in k8s CRD spec https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/Note: The plural form is required even for singleton resources. See https://aip.dev/156
#singular
def singular() -> ::String
-
(::String) — The same concept of the
singular
field in k8s CRD spec https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/ Such as "project" for theresourcemanager.googleapis.com/Project
type.
#singular=
def singular=(value) -> ::String
-
value (::String) — The same concept of the
singular
field in k8s CRD spec https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/ Such as "project" for theresourcemanager.googleapis.com/Project
type.
-
(::String) — The same concept of the
singular
field in k8s CRD spec https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/ Such as "project" for theresourcemanager.googleapis.com/Project
type.
#style
def style() -> ::Array<::Google::Api::ResourceDescriptor::Style>
- (::Array<::Google::Api::ResourceDescriptor::Style>) — Style flag(s) for this resource. These indicate that a resource is expected to conform to a given style. See the specific style flags for additional information.
#style=
def style=(value) -> ::Array<::Google::Api::ResourceDescriptor::Style>
- value (::Array<::Google::Api::ResourceDescriptor::Style>) — Style flag(s) for this resource. These indicate that a resource is expected to conform to a given style. See the specific style flags for additional information.
- (::Array<::Google::Api::ResourceDescriptor::Style>) — Style flag(s) for this resource. These indicate that a resource is expected to conform to a given style. See the specific style flags for additional information.
#type
def type() -> ::String
-
(::String) — The resource type. It must be in the format of
{service_name}/{resource_type_kind}. The
resource_type_kind
must be singular and must not include version numbers.Example:
storage.googleapis.com/Bucket
The value of the resource_type_kind must follow the regular expression /[A-Za-z][a-zA-Z0-9]+/. It should start with an upper case character and should use PascalCase (UpperCamelCase). The maximum number of characters allowed for the
resource_type_kind
is 100.
#type=
def type=(value) -> ::String
-
value (::String) — The resource type. It must be in the format of
{service_name}/{resource_type_kind}. The
resource_type_kind
must be singular and must not include version numbers.Example:
storage.googleapis.com/Bucket
The value of the resource_type_kind must follow the regular expression /[A-Za-z][a-zA-Z0-9]+/. It should start with an upper case character and should use PascalCase (UpperCamelCase). The maximum number of characters allowed for the
resource_type_kind
is 100.
-
(::String) — The resource type. It must be in the format of
{service_name}/{resource_type_kind}. The
resource_type_kind
must be singular and must not include version numbers.Example:
storage.googleapis.com/Bucket
The value of the resource_type_kind must follow the regular expression /[A-Za-z][a-zA-Z0-9]+/. It should start with an upper case character and should use PascalCase (UpperCamelCase). The maximum number of characters allowed for the
resource_type_kind
is 100.