HSrSSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SSKJ r SS K J r SS K J r SS K Jr SS K Jr SS KJr SSKJr \ R("SS\ R*55rg)z(Command to create an Apigee API product.)absolute_import)division)unicode_literals)apigee) arg_parsers)base) exceptions)argument_groups)defaults)prompts) resource_args) properties) console_ioc8\rSrSrSrSSS.r\S5rSrSr g ) Deploy!zCreate an Apigee API product.a Create an Apigee API product. `{command}` publishes a collection of API proxy resources as an API product. API products combine their underlying API proxies with quota settings and metadata, to deliver customized and productized API bundles to the developer community. API products enable the repackaging of APIs on-the-fly, without having to do any additional coding or configuration. Apigee recommends starting with a simple API product including only required elements, and then provisioning credentials to apps to enable them to start testing those APIs. At minimum, a new API product requires an internal name, access policy, and declaration of what environments and API proxies to include in the product. If these aren't provided, interactive calls will prompt for the missing values, and non-interactive calls will fail. a To create a basic API product in the active Cloud Platform project by answering interactive prompts, run: $ {command} To create an API product that publicly exposes all API proxies deployed to the ``prod'' environment, run: $ {command} kitchen-sink --environments=prod --all-proxies --public-access To require manual approval of developers before they can access the new API product, run: $ {command} kitchen-sink --environments=prod --all-proxies --public-access --manual-approval To hide the new API product while still making it accessible to developers, run: $ {command} kitchen-sink --environments=prod --all-proxies --private-access To restrict the new API product to internal users only, run: $ {command} kitchen-sink --environments=prod --all-proxies --internal-access To expose all API proxies that are deployed to a URI fragment beginning with ``/v1'' or ``/v0'', run: $ {command} legacy --all-environments --resources="/v0/**#/v1/**" --public-access To expose a few specific API proxies on all URI paths where they're deployed, run: $ {command} consumer --environments=prod --apis=menu,cart,delivery-tracker --public-access To expose only those API calls that match both a set of API proxies and a set of API resources, run: $ {command} legacy-consumer --environments=prod --apis=menu,cart,delivery-tracker --resources="/v0/**#/v1/**" --public-access To impose a quota of 50 calls per half-hour on a new all-inclusive API product, and output the new API product as a JSON object, run: $ {command} kitchen-sink --environments=prod --all-proxies --public-access --quota=50 --quota-interval=30 --quota-unit=minute --format=json To specify a human-friendly display name and description for the product, run: $ {command} consumer --environments=prod --apis=menu,cart,delivery-tracker --public-access --display-name="Consumer APIs" --description="APIs for the consumer side of the delivery network: ordering food and tracking deliveries." ) DESCRIPTIONEXAMPLESc [R"USSSSSS9 UR5nURSS[R "S S 9S S 9 URS SS/SS9 URSSS9 UR5nURSSSSSS9 URSSSSSS9 URSSSSSS9 URS5nURS S!S"S#9 UR S$5nURS%S&[R "5S'S 9 URS(S)[R"S S 9S*S 9 UR S+5nURS,[S-S.9 URS/[S0S.9 URS1/S2QS3S49 URS5S6S9 URS7S!S8S#9 URS9S:[R "5S;S 9 URSS?9S@S 9 g)ANzorganization.productzlAPI product to be created. Characters in a product's internal name are restricted to: ```A-Za-z0-9._-$ %```.T INTERNAL_NAMEF)validate argument_namerequired--environments ENVIRONMENT) min_lengthaEnvironments to which the API product is bound. Requests to environments that are not listed are rejected, preventing developers from accessing those resources through API Proxies deployed in another environment. For example, this can prevent resources associated with API proxies in a ``prod'' environment from also granting access to matching API proxies deployed in a ``test'' environment. To get a list of available environments, run: $ {grandparent_command} environments list)metavartypehelp--all-environments environments store_constz:Make all environments accessible through this API product.)destactionconstr z--display-namez\Name to be displayed in the UI or developer portal to developers registering for API access.)r --public-accessaccesspubliczKMake this API product visible to developers in the Apigee developer portal.--private-accessprivatez\Hide this API product in the developer portal but make it accessible by external developers.--internal-accessinternalz,Prevent external access to this API product.z?Arguments specifying which API proxies and resources to expose. --all-proxies store_truezExpose all available API proxies and their resources. Must be explicitly specified if neither `--apis` nor `--resources` is provided.)r%r zmArguments that restrict exposed API proxies. One or both of these may be specified if `--all-proxies` is not:--apisAPIaComma-separated names of API proxies to which this API product is bound. Only those API proxies will be accessible through the new API product. If not provided, all deployed API proxies will be included in the product, so long as they match the other parameters. 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 --resourcesRESOURCEaAPI resources to be bundled in the API product, separated by `#` signs. 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. If not provided, all deployed API resources will be included in the product, so long as they match the other parameters. The API proxy resources must already be deployed to the bound environments, or creation of the API product will fail.zRTo impose a quota limit on calls to the API product, specify all of the following:z--quotaaNumber of request messages permitted per app by this API product for the specified `--quota-interval` and `--quota-unit`. For example, to create an API product that allows 50 requests every twelve hours to every deployed API proxy, run: $ {command} PRODUCT --all-environments --all-proxies --public-access --quota=50 --quota-interval=12 --quota-unit=hour If specified, `--quota-interval` and `--quota-unit` must be specified too.)rr z--quota-intervalzTime interval over which the number of request messages is calculated. If specified, `--quota` and `--quota-unit` must be specified too.z --quota-unit)minutehourdaymonthzhTime unit for `--quota-interval`. If specified, `--quota` and `--quota-interval` must be specified too.)choicesr z --descriptionzpOverview of the API product. Include key information about the API product that is not captured by other fields.z--manual-approvalzRequire manual approval of developer requests to access this API product before their consumer keys can be used. If unset, the consumer key is generated in an "approved" state and can be used immediately.z--oauth-scopesSCOPEzComma-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.z --attributesz NAME=VALUE) max_lengthzKey-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.) r AddSingleResourceArgumentadd_mutually_exclusive_group add_argumentrArgListadd_argument_groupr HashDelimitedArgListintArgDict)parserenvironment_group access_groupproxies_mutex_group proxies_group quota_groups %lib/surface/apigee/products/create.pyArgs Deploy.Argsrs++ 4%;;=""  A .> # @""  I #K 79 668L " $ 3 5  ; =!==IK$$%(:: 23M  "+ ,2  1 1Q ?* +@++ K N O 2! BD  %'   "1 3   B /3 5c ^^URc[R"5Ul[R"5(GaURc Sn[ R "SSU5UlURc9[R"S5mU4Sjn[R"USS5UlS UR0mURcGU4S jn[R"S S /S S9nUS:Xa/Ul O[ R"SU5Ul UR(dUR(dUR (d[R"SS/SS9nUS:XaSUlOU4Sjn[ R"SUS5UlSS/n[R"U5S:Xa[ R""SSS5UlO/UlUR(dUR(dSUlUR$c#[R"/SQSS9n/SQUUlURc[&R("S S!/S"5eUR$c[&R("/S#QS$5eUR(d;UR(d*UR (d[&R("/S%QS&5e[+U5V s/sHn S'U ;dM [+U5U bMU PM n n U (a=[-U 5S(:a-[&R."S)U SR1S*S+5-S,5eO(S-UR2-UlS-UR4-UlS.UR$S/./n UR6(a3UR6H#n U R9XR6U S/.5 M% UR:R<R?5RA5n URBc U S0Ul![DRF"U S0URBURH(aS1OS2U URJUR(a UROSUR(a UROSUR(a UROSUR2UR4URLURNS39 n[DRPRSX5$s sn f)4zRun the deploy command.Nc4[RRRR 5(a[R R 5nO[R R5nSU;aUSVs/sHoSPM sn$/$s snf)N organizations organization)rVALUESapi_endpoint_overridesrGetOrganizationsClientListListOrganizationsGlobal)responseitems rJ _ListOrgsDeploy.Run.._ListOrgs<s}    5 5 < < @ @ B B11668H11IIKH  (5=o5NO5NT(5NO OIPsBrQz3the organization in which to create the API productproductc*>TRU5SL$N)search)nameproduct_matchers rJDeploy.Run..Ls_%;%;D%A%MrMz"Empty or invalid API product name.z0Enter an internal name for the new API product: organizationsIdcB>[RRT5$r^)rEnvironmentsClientrV)org_identifiersrJrbrcSsF55::>JrMzInclude all environmentszChoose environments to includez:What environments should be accessible in the API product?) prompt_stringr environmentzInclude all API proxiesz.Choose API proxies and/or basepaths to includez9What API proxies should be accessible in the API product?Tc>[RRT5n[[ [ SU5555$)Nc3*# UH oSv M g7f)apiProxyN).0rYs rJ ;Deploy.Run.._ListDeployedProxies..ls"I #3s)rDeploymentsClientrVsortedlistset)rXrgs rJ_ListDeployedProxies(Deploy.Run.._ListDeployedProxiesjs4//44^DH$s"I"IIJK KrMapiz Include all deployed API proxiesz&Restrict proxy access by resource pathz7Include all resource paths of the product's API proxiesz/Enter a resource path that should be included: zInclude another resource path)z/Public - visible in the Apigee developer portalzXPrivate - callable by external developers but not visible in the Apigee developer portalz.Internal - not callable by external developerszChoose an access policy.)message)r)r+r-rr!z7All API products must include at least one environment.)r'r*r,zDAll API products must specify whether they can be publicly accessed.)r0r2r.zAAll API products must include at least one API proxy or resource.quotaz--_-z/Must specify all quota arguments to use quotas.z%dr()r`value apiproductsIdmanualauto) r` displayName approvalType attributes description apiResourcesr"proxiesry quotaInterval quotaTimeUnitscopes)*rQr OrganizationFromGCPProjectr CanPromptr ResourceFromFreeformPromptrr ValidPatternForEntityPromptWithValidatorr" PromptChoiceResourceListFromPromptapis resources all_proxiesListFromFreeformPromptr(r OneOfArgumentsRequiredExceptionvarslenRequiredArgumentExceptionreplaceryquota_intervalrappendCONCEPTS internal_nameParseAsDict display_namer ProductsInfomanual_approvalr quota_unit oauth_scopesProductsClientCreate)selfargsrZ valid_product list_envschoiceruresource_optionsoptionargquota_args_missingrkey identifiersr\rgras @@rJRun Deploy.Run4sX  "==?d   " $>>  A9N    #'==iHM ';; ? >@*4+<+<=n   "J (( ')I J&( Q; $ %<<Y($ YYt~~d6F6F(()@ & ( Q;!$  L44)+MO$)7G  $ $%5 6! ;$;;A/IKDN  DN #D   ((* 2L M8?    6 6 1 2 C EE {{  6 68 O QQ 99T^^D4D4D  6 6 4 M OO Dz!W^T 3z  1 $22 %a(00c: : =? ? % $**$dj 4#6#66d#dkk:;J #31EFG!----335<<>K  %o6d!!  )%%!%!5!5X6$$'+~~T^^4*.*;*;T&&!YY Djj))oo   "G  ' ' ==Gs S-$ S-5S-rmN) __name__ __module__ __qualname____firstlineno____doc__ detailed_help staticmethodrKr__static_attributes__rmrMrJrr!s5% .1 3K-Z55BI>rMrN)r __future__rrrgooglecloudsdk.api_librgooglecloudsdk.callioperrr !googlecloudsdk.command_lib.apigeer r r r googlecloudsdk.corergooglecloudsdk.core.consolerDefaultUniverseOnlyDescribeCommandrrmrMrJrs[/&')/(.=65;*2[>T ! ![>[>rM