BASrSSKJr SSKJr SSKJr SSKrSSKJr SSKJ r SSKJ r SS K J r SS K J r SS K Jr "S S \ R5rg)z(Command to modify an Apigee API product.)absolute_import)division)unicode_literalsN)apigee)base) exceptions)argument_groups)defaults) resource_argsc8\rSrSrSrSSS.r\S5rSrSr g ) Updatez&Update an existing Apigee API product.z {description} `{command}` applies a set of modifications to an existing API product. To create a new API product, run: $ {parent_command} create a To update the display name of the API product with the internal name ``my-prod'', run: $ {command} my-prod --display-name="Example Project" To update the description of the API product, run: $ {command} my-prod --description="This API is famous for appearing in a YouTube video." To remove the API product's description, run: $ {command} my-prod --clear-description To remove manual approval requirements from the API and change its access level to public, run: $ {command} my-prod --public-access --automatic-approval To impose a quota of 45 calls per minute per application on the API product, run: $ {command} my-prod --quota=45 --quota-interval=1 --quota-unit=minute To remove a quota on the API product and switch it to unlisted access with manual approval, run: $ {command} my-prod --manual-approval --private-access --clear-quota To set the API product's custom attribute ``foo'' to the value ``bar'', updating that attribute if it exists and creating it if it doesn't, and remove the attribute ``baz'' if it exists, run: $ {command} my-prod --add-attribute="foo=bar" --remove-attribute=baz To update the list of API proxies included in the API product, run: $ {command} my-prod --add-api=NEW_ONE,NEW_TWO --remove-api=OLD_ONE,OLD_TWO To switch the API product to including all ``test'' environment APIs no matter what API proxy or resource they expose, run: $ {command} my-prod --add-environment=test --all-apis --all-resources To update the list of API resources included in the API product, and output the updated API product as a JSON object, run: $ {command} my-prod --add-resource="NEW_ONE#NEW_TWO" --remove-resource="OLD_ONE#OLD_TWO" --format=json ) DESCRIPTIONEXAMPLESc [R"USS[R"5/S9 [R "USSSSSSS 9 UR S S S S 9 UR5nUR SSSSSS9 UR SSSSSS9 UR SSSSSS9 [R "USSSSSSS 9 [R "US!S"S#S$[R"5S%S&S'9 UR5nURS(5nUR S)[S*S+9 UR S,[S-S+9 UR S./S/QS0S19 UR S2S3S4S59 [R"US6S7S85 UR5nUR S9SS:S;SSS?S;S@S=9 [R "USASBSCSDSE9 [R "USFSGSHSISJSKSL9 g)MNzorganization.productzhAPI product to be updated. To get a list of available API products, run: $ {parent_command} list ) fallthroughs environment environmentsaEnvironments 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: $ {grandparent_command} environments listz--all-environmentsz:Make all environments accessible through this API product.) clear_arg clear_helpdest--display-nameset_displayNamez\Name to be displayed in the UI or developer portal to developers registering for API access.)rhelpz--public-accessaccess store_constpubliczKMake this API product visible to developers in the Apigee developer portal.)ractionconstrz--private-accessprivatez\Hide this API product in the developer portal but make it accessible by external developers.z--internal-accessinternalz,Prevent external access to this API product.APIAPIsaAPI 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: $ {grandparent_command} deployments list To deploy an API proxy, run: $ {grandparent_command} apis deploy.proxiesz --all-apisz\Include all deployed API proxies in the product, so long as they match the other parameters.)rrrresource resourcesa(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 ``/forecastrss'' is given as an element of this list, and the base path defined for the API proxy is `/weather`, then only requests to `/weather/forecastrss` are 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/weatherapikey` and 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. apiResourcesz--all-resourcesz^Include all deployed API resources in the product, so long as they match the other parameters.)rcollector_typerrzRTo impose a quota limit on calls to the API product, specify all of the following:--quotazNumber of request messages permitted per app by this API product for the specified `--quota-interval` and `--quota-unit`. For example, `--quota=50`, `--quota-interval=12`, and `--quota-unit=hour` means 50 requests are allowed every 12 hours.)typer--quota-intervalzFTime interval over which the number of request messages is calculated. --quota-unit)minutehourdaymonthz!Time unit for `--quota-interval`.)choicesrz --clear-quota store_truez6Remove any quota currently imposed on the API product.)rr descriptionzpOverview of the API product. Include key information about the API product that is not captured by other fields.z%Remove the API product's description.z--manual-approvalmanualset_approvalTypezpRequire manual approval of developer requests to access this API product before their consumer keys can be used.)rrrrz--automatic-approvalautozQAllow developers to generate approved consumer keys without waiting for approval.z OAuth scopez OAuth scopeszComma-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.scopes)r attribute attributeszKey-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.Tz NAME=VALUENAME) dict_like add_metavarremove_metavar) r AddSingleResourceArgumentr !GCPProductOrganizationFallthroughr AddEditableListArgument add_argumentadd_mutually_exclusive_groupHashDelimitedArgListadd_argument_groupintAddClearableArgument)parser access_group quota_mutex quota_groupapproval_groups %lib/surface/apigee/products/update.pyArgs Update.ArgsZs++ *@@BC E++ 8'O "  79 668L " $ 3 5  ; =++  ,.%/(++ *.&;;=#.=/B557K00 K +, 02 214  EG ((  8/ 1 88:N D  F &  (++ ++   c URRR5R5n[R R U5nURbSUR-US'URbSUR-US'UR(aURUS'/SQnUVs/sHoUU;PM nn[U5(aQ[U5(dAUR(dSnOUR(dSnOS n[R"US 5eUR(aUS US US SUlS U;aUS O/nUV s/sH oS U S 4PM nn [R "U5n UR"bJUR"n SU ;a U SS;a[R$"SS5eU R'U 5 SUlUR(bZUR(HCn SU ;a(UR*(d[R$"SS5eU H n X;dM X M ME SUlUR,(a!SU ;aU SOSn U (aSU 0O0n SUlUR*(aUR*U S'SnU R/5V s/sH o"U 5PM nn XS 'UR0(d$UR0b[R$"SS5e[35n[5U5nUR/5HunnUbSU;aMUR7SS5unnUS:Xa XS;a/X5'UHn X5==U - ss'M MLUS:XaVXS;aQUHIn U H@n XU;dM X5R9U 5 X5(aM+SX5'UR;U5 MB MK MUS:XaUX5'MUS:XdMU(dMXS;dMX5 M SU;a[R$"SS5eS U;a[R$"S!S"5eS#U;a[R$"S$S%5e[R<R>Vs0sHnUUU;aUUOS_M nnUS&US '[R<"S'0UD6n[R RAUU5$s snfs sn fs sn fs snf)(zRun the update command.Nz%dquota quotaInterval quotaTimeUnit)rQrRrSr+r,r)z;Products with quotas must specify all three quota settings.r9namevaluer)rr r!z--add-attributezPThe `access` attribute must be set to one of "public", "private", or "internal".z--remove-attributez#The `access` attribute is required.cUSUSS.$)Nr)rTrU)items rLUpdate.Run..Rs47T!W"ErOrz.An API product's display name cannot be blank._rWaddremovesetclearr$z --remove-apizAn API product must include at least one API proxy, or else all API proxies will implicitly be included. If this was intended, use [--all-apis] instead of removing APIs individually.r'z--remove-resourcezAn API product must include at least one API resource, or else all resources will implicitly be included. If this was intended, use [--all-resources] instead of removing resources individually.rz--remove-environmentzAn API product must include at least one environment, or else all environments will implicitly be included. If this was intended, use [--all-environments] instead of removing environments individually. apiproductsIdrX)!CONCEPTSproductParseAsDictrProductsClientDescriberQquota_interval quota_unitanyallrRequiredArgumentException clear_quota collections OrderedDict add_attributeBadArgumentExceptionupdateremove_attributerclear_attributesitemsrr_varssplitr^r] ProductsInfo_fieldsr )selfargs identifiersrcquota_field_namesfieldquota_fields_exist missing_argattribute_listrYr9add_attributessublistrattribute_dictattributes_dicts emptied_listsarg_dictkeyrUlabelupdated_products rLRun Update.Run s--''--/668K##,,[9G zz *gg &!%(;(;!;go !%goC8IJ8Iu7*8IJ s+='>'>  ( $   0 0  G II  '  / " / "d/;g.EW\*2N@NOF|T']3NO((8J %))n n $  "*K K--  ,- -'d (**' w t{{//"$IK KD    +#d (0:'=z(#4f)/Hf%Rj"d {{![[jEN9C9I9I9KL9Kt,9KL,L   D$8$8$D  + + L NNEMDzHnn& U #S.YYsA&leU %  '.G .G #. H !1Gdu~%n##D)^^"&!!%( E> G %*: N-'8M!  + +  @ AA &  + +  J KK &  + +  P QQ&&...C cWngcl$6.  "/2GFO))4G4O  ' ' _ EECK&PHMDs8R9R>+S!SrXN) __name__ __module__ __qualname____firstlineno____doc__ detailed_help staticmethodrMr__static_attributes__rXrOrLr r s5. ) 6-pppdPFrOr )r __future__rrrrngooglecloudsdk.api_librgooglecloudsdk.callioperr!googlecloudsdk.command_lib.apigeer r r DescribeCommandr rXrOrLrs>/&')(.=6;~FT ! !~FrO