- NAME
-
- gcloud beta apigee products update - update an existing Apigee API product
- SYNOPSIS
-
-
gcloud beta apigee products update(PRODUCT:--organization=ORGANIZATION) [--display-name=SET_DISPLAYNAME] [--all-apis|--add-api=[API,…]--remove-api=[API,…]] [--all-environments|--add-environment=[ENVIRONMENT,…]--remove-environment=[ENVIRONMENT,…]] [--all-resources|--add-resource=[RESOURCE#…]--remove-resource=[RESOURCE#…]] [--automatic-approval|--manual-approval] [--clear-attributes|--add-attribute=[NAME=VALUE,…]--remove-attribute=[NAME,…]] [--clear-description|--description=SET_DESCRIPTION] [--clear-oauth-scopes|--add-oauth-scope=[OAUTH-SCOPE,…]--remove-oauth-scope=[OAUTH-SCOPE,…]] [--clear-quota|--quota=QUOTA--quota-interval=QUOTA_INTERVAL--quota-unit=QUOTA_UNIT] [--internal-access|--private-access|--public-access] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Update an existing Apigee API product.gcloud beta apigee products updateapplies a set of modifications to an existing API product.To create a new API product, run:
gcloud beta apigee products create - EXAMPLES
-
To update the display name of the API product with the internal name
my-prodgcloud beta apigee products update my-prod --display-name="Example Project"To update the description of the API product, run:
gcloud beta apigee products update my-prod --description="This API is famous for appearing in a YouTube video."To remove the API product's description, run:
gcloud beta apigee products update my-prod --clear-descriptionTo remove manual approval requirements from the API and change its access level to public, run:
gcloud beta apigee products update my-prod --public-access --automatic-approvalTo impose a quota of 45 calls per minute per application on the API product, run:
gcloud beta apigee products update my-prod --quota=45 --quota-interval=1 --quota-unit=minuteTo remove a quota on the API product and switch it to unlisted access with manual approval, run:
gcloud beta apigee products update my-prod --manual-approval --private-access --clear-quotaTo set the API product's custom attribute
foobarbazgcloud beta apigee products update my-prod --add-attribute="foo=bar" --remove-attribute=bazTo update the list of API proxies included in the API product, run:
gcloud beta apigee products update my-prod --add-api=NEW_ONE,NEW_TWO --remove-api=OLD_ONE,OLD_TWOTo switch the API product to including all
testgcloud beta apigee products update my-prod --add-environment=test --all-apis --all-resourcesTo update the list of API resources included in the API product, and output the updated API product as a JSON object, run:
gcloud beta apigee products update my-prod --add-resource="NEW_ONE#NEW_TWO" --remove-resource="OLD_ONE#OLD_TWO" --format=json - POSITIONAL ARGUMENTS
-
-
API product resource - API product to be updated. To get a list of available API
products, run:
gcloud beta apigee products listThe arguments in this group can be used to specify the attributes of this resource.
This must be specified.
PRODUCT-
ID of the API product or fully qualified identifier for the API product.
To set the
productattribute:-
provide the argument
PRODUCTon the command line.
This positional argument must be specified if any of the other arguments in this group are specified.
-
provide the argument
--organization=ORGANIZATION-
Apigee organization containing the API product. If unspecified, the Cloud
Platform project's associated organization will be used.
To set the
organizationattribute:-
provide the argument
PRODUCTon the command line with a fully specified name; -
provide the argument
--organizationon the command line; - set the property [project] or provide the argument [--project] on the command line, using a Cloud Platform project with an associated Apigee organization.
-
provide the argument
-
API product resource - API product to be updated. To get a list of available API
products, run:
- FLAGS
-
--display-name=SET_DISPLAYNAME- Name to be displayed in the UI or developer portal to developers registering for API access.
-
At most one of these can be specified:
--all-apis- Include all deployed API proxies in the product, so long as they match the other parameters.
-
API proxies to which this API product is bound. Only those API proxies will be
accessible through the API product.
The API proxy names must already be deployed to the bound environments, or creation of the API product will fail. To get a list of deployed API proxies, run:
gcloud beta apigee deployments listTo deploy an API proxy, run:
gcloud beta apigee apis deploy.--add-api=[API,…]- Adds a new API to the set of APIs.
--remove-api=[API,…]- Removes an existing API from the set of APIs.
-
At most one of these can be specified:
--all-environments- Make all environments accessible through this API product.
-
Environments to which the API product is bound. Requests to environments that
are not listed are rejected, preventing developers from accessing those
resources even if they can access the same API proxies in another environment.
For example, this can be used to prevent applications with access to production APIs from accessing the alpha or beta versions of those APIs.
To get a list of available environments, run:
gcloud beta apigee environments list--add-environment=[ENVIRONMENT,…]- Adds a new environment to the set of environments.
--remove-environment=[ENVIRONMENT,…]- Removes an existing environment from the set of environments.
-
At most one of these can be specified:
--all-resources- Include all deployed API resources in the product, so long as they match the other parameters.
-
API resources to be bundled in the API product.
By default, the resource paths are mapped from the
proxy.pathsuffixvariable.The proxy path suffix is defined as the URI fragment following the ProxyEndpoint base path. For example, if
/forecastrss/weather, then only requests to/weather/forecastrssare permitted by the API product.Proxy paths can use asterisks as wildcards;
/**indicates that all sub-URIs are included, whereas a single asterisk 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/weatherapikeyand to any sub-URIs, such as/v1/weatherapikey/forecastrss,/v1/weatherapikey/region/CA, and so on.The API proxy resources must already be deployed to the bound environments, or creation of the API product will fail.
--add-resource=[RESOURCE#…]- Adds a new resource to the set of resources.
--remove-resource=[RESOURCE#…]- Removes an existing resource from the set of resources.
-
At most one of these can be specified:
--automatic-approval- Allow developers to generate approved consumer keys without waiting for approval.
--manual-approval- Require manual approval of developer requests to access this API product before their consumer keys can be used.
-
At most one of these can be specified:
--clear-attributes- Removes all attributes.
-
Key-value attribute pairs that may be used to extend the default API product
profile with customer-specific metadata. Up to 17 attributes can be specified.
--add-attribute=[NAME=VALUE,…]- Adds a new attribute to the set of attributes.
--remove-attribute=[NAME,…]- Removes an existing attribute from the set of attributes.
-
At most one of these can be specified:
--clear-description- Remove the API product's description.
--description=SET_DESCRIPTION- Overview of the API product. Include key information about the API product that is not captured by other fields.
-
At most one of these can be specified:
--clear-oauth-scopes- Removes all OAuth scopes.
-
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 assoicated with the API product.
--add-oauth-scope=[OAUTH-SCOPE,…]- Adds a new OAuth scope to the set of OAuth scopes.
--remove-oauth-scope=[OAUTH-SCOPE,…]- Removes an existing OAuth scope from the set of OAuth scopes.
-
At most one of these can be specified:
--clear-quota- Remove any quota currently imposed on the API product.
-
To impose a quota limit on calls to the API product, specify all of the
following:
--quota=QUOTA-
Number of request messages permitted per app by this API product for the
specified
--quota-intervaland--quota-unit.For example,
--quota=50,--quota-interval=12, and--quota-unit=hourmeans 50 requests are allowed every 12 hours. --quota-interval=QUOTA_INTERVAL- Time interval over which the number of request messages is calculated.
--quota-unit=QUOTA_UNIT-
Time unit for
--quota-interval.QUOTA_UNITmust be one of:minute,hour,day,month.
-
At most one of these can be specified:
--internal-access- Prevent external access to this API product.
--private-access- Hide this API product in the developer portal but make it accessible by external developers.
--public-access- Make this API product visible to developers in the Apigee developer portal.
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - NOTES
-
This command is currently in beta and might change without notice. These
variants are also available:
gcloud apigee products updategcloud alpha apigee products update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-02-06 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]