Class: Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiProduct
- Inherits:
-
Object
- Object
- Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiProduct
- Includes:
- Core::Hashable, Core::JsonObjectSupport
- Defined in:
- generated/google/apis/apigee_v1/classes.rb,
generated/google/apis/apigee_v1/representations.rb,
generated/google/apis/apigee_v1/representations.rb
Instance Attribute Summary collapse
-
#api_resources ⇒ Array<String>
Corresponds to the JSON property
apiResources
. -
#approval_type ⇒ String
Flag that specifies how API keys are approved to access the APIs defined by the API product.
-
#attributes ⇒ Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1Attribute>
Array of attributes that may be used to extend the default API product profile with customer-specific metadata.
-
#created_at ⇒ Fixnum
Response only.
-
#description ⇒ String
Description of the API product.
-
#display_name ⇒ String
Name displayed in the UI or developer portal to developers registering for API access.
-
#environments ⇒ Array<String>
Comma-separated list of environment names to which the API product is bound.
-
#last_modified_at ⇒ Fixnum
Response only.
-
#name ⇒ String
Internal name of the API product.
-
#operation_group ⇒ Google::Apis::ApigeeV1::GoogleCloudApigeeV1OperationGroup
List of operation configuration details associated with Apigee API proxies or remote services.
-
#proxies ⇒ Array<String>
Comma-separated list of API proxy names to which this API product is bound.
-
#quota ⇒ String
Number of request messages permitted per app by this API product for the specified
quotaInterval
andquotaTimeUnit
. -
#quota_interval ⇒ String
Time interval over which the number of request messages is calculated.
-
#quota_time_unit ⇒ String
Time unit defined for the
quotaInterval
. -
#scopes ⇒ Array<String>
Comma-separated list of OAuth scopes that are validated at runtime.
Instance Method Summary collapse
-
#initialize(**args) ⇒ GoogleCloudApigeeV1ApiProduct
constructor
A new instance of GoogleCloudApigeeV1ApiProduct.
-
#update!(**args) ⇒ Object
Update properties of this object.
Constructor Details
#initialize(**args) ⇒ GoogleCloudApigeeV1ApiProduct
Returns a new instance of GoogleCloudApigeeV1ApiProduct.
480 481 482 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 480 def initialize(**args) update!(**args) end |
Instance Attribute Details
#api_resources ⇒ Array<String>
Corresponds to the JSON property apiResources
358 359 360 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 358 def api_resources @api_resources end |
#approval_type ⇒ String
Flag that specifies how API keys are approved to access the APIs defined by
the API product. If set to manual
, the consumer key is generated and
returned in "pending" state. In this case, the API keys won't work until they
have been explicitly approved. If set to auto
, the consumer key is generated
and returned in "approved" state and can be used immediately. Note:
Typically, auto
is used to provide access to free or trial API products that
provide limited quota or capabilities.
Corresponds to the JSON property approvalType
369 370 371 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 369 def approval_type @approval_type end |
#attributes ⇒ Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1Attribute>
Array of attributes that may be used to extend the default API product profile
with customer-specific metadata. You can specify a maximum of 18 attributes.
Use this property to specify the access level of the API product as either
public
, private
, or internal
. Only products marked public
are available
to developers in the Apigee developer portal. For example, you can set a
product to internal
while it is in development and then change access to
public
when it is ready to release on the portal. API products marked as
private
do not appear on the portal, but can be accessed by external
developers.
Corresponds to the JSON property attributes
382 383 384 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 382 def attributes @attributes end |
#created_at ⇒ Fixnum
Response only. Creation time of this environment as milliseconds since epoch.
Corresponds to the JSON property createdAt
387 388 389 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 387 def created_at @created_at end |
#description ⇒ String
Description of the API product. Include key information about the API product
that is not captured by other fields. Comma-separated list of API resources to
be bundled in the API product. By default, the resource paths are mapped from
the proxy.pathsuffix
variable. The proxy path suffix is defined as the URI
fragment following the ProxyEndpoint base path. For example, if the
apiResources
element is defined to be /forecastrss
and the base path
defined for the API proxy is /weather
, then only requests to /weather/
forecastrss
are permitted by the API product. You can select a specific path,
or you can select all subpaths with the following wildcard: - /**
: Indicates
that all sub-URIs are included. - /*
: Indicates that only URIs one level
down are included. By default, / supports the same resources as /** as well as
the base path defined by the API proxy. For example, if the base path of the
API proxy is /v1/weatherapikey
, then the API product supports requests to /
v1/weatherapikey
and to any sub-URIs, such as /v1/weatherapikey/forecastrss
,
/v1/weatherapikey/region/CA
, and so on. For more information, see Managing
API products.
Corresponds to the JSON property description
407 408 409 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 407 def description @description end |
#display_name ⇒ String
Name displayed in the UI or developer portal to developers registering for API
access.
Corresponds to the JSON property displayName
413 414 415 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 413 def display_name @display_name end |
#environments ⇒ Array<String>
Comma-separated list of environment names to which the API product is bound.
Requests to environments that are not listed are rejected. By specifying one
or more environments, you can bind the resources listed in the API product to
a specific environment, preventing developers from accessing those resources
through API proxies deployed in another environment. This setting is used, for
example, to prevent resources associated with API proxies in prod
from being
accessed by API proxies deployed in test
.
Corresponds to the JSON property environments
424 425 426 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 424 def environments @environments end |
#last_modified_at ⇒ Fixnum
Response only. Modified time of this environment as milliseconds since epoch.
Corresponds to the JSON property lastModifiedAt
429 430 431 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 429 def last_modified_at @last_modified_at end |
#name ⇒ String
Internal name of the API product. Characters you can use in the name are
restricted to: A-Z0-9._\-$ %
. Note: The internal name cannot be edited
when updating the API product.
Corresponds to the JSON property name
436 437 438 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 436 def name @name end |
#operation_group ⇒ Google::Apis::ApigeeV1::GoogleCloudApigeeV1OperationGroup
List of operation configuration details associated with Apigee API proxies or
remote services. Remote services are non-Apigee proxies, such as Istio-Envoy.
Corresponds to the JSON property operationGroup
442 443 444 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 442 def operation_group @operation_group end |
#proxies ⇒ Array<String>
Comma-separated list of API proxy names to which this API product is bound. By
specifying API proxies, you can associate resources in the API product with
specific API proxies, preventing developers from accessing those resources
through other API proxies. Apigee rejects requests to API proxies that are not
listed. Note: The API proxy names must already exist in the specified
environment as they will be validated upon creation.
Corresponds to the JSON property proxies
452 453 454 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 452 def proxies @proxies end |
#quota ⇒ String
Number of request messages permitted per app by this API product for the
specified quotaInterval
and quotaTimeUnit
. For example, a quota
of 50,
for a quotaInterval
of 12 and a quotaTimeUnit
of hours means 50 requests
are allowed every 12 hours.
Corresponds to the JSON property quota
460 461 462 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 460 def quota @quota end |
#quota_interval ⇒ String
Time interval over which the number of request messages is calculated.
Corresponds to the JSON property quotaInterval
465 466 467 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 465 def quota_interval @quota_interval end |
#quota_time_unit ⇒ String
Time unit defined for the quotaInterval
. Valid values include minute
,
hour
, day
, or month
.
Corresponds to the JSON property quotaTimeUnit
471 472 473 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 471 def quota_time_unit @quota_time_unit end |
#scopes ⇒ Array<String>
Comma-separated list of OAuth scopes that are validated at runtime. Apigee
validates that the scopes in any access token presented match the scopes
defined in the OAuth policy associated with the API product.
Corresponds to the JSON property scopes
478 479 480 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 478 def scopes @scopes end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 |
# File 'generated/google/apis/apigee_v1/classes.rb', line 485 def update!(**args) @api_resources = args[:api_resources] if args.key?(:api_resources) @approval_type = args[:approval_type] if args.key?(:approval_type) @attributes = args[:attributes] if args.key?(:attributes) @created_at = args[:created_at] if args.key?(:created_at) @description = args[:description] if args.key?(:description) @display_name = args[:display_name] if args.key?(:display_name) @environments = args[:environments] if args.key?(:environments) @last_modified_at = args[:last_modified_at] if args.key?(:last_modified_at) @name = args[:name] if args.key?(:name) @operation_group = args[:operation_group] if args.key?(:operation_group) @proxies = args[:proxies] if args.key?(:proxies) @quota = args[:quota] if args.key?(:quota) @quota_interval = args[:quota_interval] if args.key?(:quota_interval) @quota_time_unit = args[:quota_time_unit] if args.key?(:quota_time_unit) @scopes = args[:scopes] if args.key?(:scopes) end |