1515 "apic api create" ,
1616)
1717class Create (AAZCommand ):
18- """Create new or updates existing API.
18+ """Register a new API or update an existing API.
1919
2020 :example: Create API
21- az apic api create -g contoso-resources -s contoso --name echo-api --title "Echo API"
21+ az apic api create -g contoso-resources -s contoso --api-id echo-api --title "Echo API" --type REST
22+
23+ :example: Create API with custom properties
24+ az apic api create -g contoso-resources -s contoso --api-id echo-api --title "Echo API" --type REST --custom-properties '{\" public-facing\" :true}'
2225 """
2326
2427 _aaz_info = {
@@ -44,11 +47,12 @@ def _build_arguments_schema(cls, *args, **kwargs):
4447 # define Arg Group ""
4548
4649 _args_schema = cls ._args_schema
47- _args_schema .api_name = AAZStrArg (
48- options = ["--api" , "--name" , "--api-name "
49- help = "The name of the API." ,
50+ _args_schema .api_id = AAZStrArg (
51+ options = ["--api-id " ],
52+ help = "The id of the API." ,
5053 required = True ,
5154 fmt = AAZStrArgFormat (
55+ pattern = "^[a-zA-Z0-9-]{3,90}$" ,
5256 max_length = 90 ,
5357 min_length = 1 ,
5458 ),
@@ -61,6 +65,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
6165 help = "The name of the API Center service." ,
6266 required = True ,
6367 fmt = AAZStrArgFormat (
68+ pattern = "^[a-zA-Z0-9-]{3,90}$" ,
6469 max_length = 90 ,
6570 min_length = 1 ,
6671 ),
@@ -71,6 +76,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
7176 required = True ,
7277 default = "default" ,
7378 fmt = AAZStrArgFormat (
79+ pattern = "^[a-zA-Z0-9-]{3,90}$" ,
7480 max_length = 90 ,
7581 min_length = 1 ,
7682 ),
@@ -84,7 +90,7 @@ def _build_arguments_schema(cls, *args, **kwargs):
8490 arg_group = "Properties" ,
8591 help = "The contact information for the API." ,
8692 )
87- _args_schema .custom_properties = AAZObjectArg (
93+ _args_schema .custom_properties = AAZFreeFormDictArg (
8894 options = ["--custom-properties" ],
8995 arg_group = "Properties" ,
9096 help = "The custom metadata defined for API catalog entities." ,
@@ -103,10 +109,11 @@ def _build_arguments_schema(cls, *args, **kwargs):
103109 arg_group = "Properties" ,
104110 help = "Additional, external documentation for the API." ,
105111 )
106- _args_schema .kind = AAZStrArg (
107- options = ["--kind " ],
112+ _args_schema .type = AAZStrArg (
113+ options = ["--type " ],
108114 arg_group = "Properties" ,
109- help = "Kind of API. For example, REST or GraphQL." ,
115+ help = "Type of API." ,
116+ required = True ,
110117 enum = {"graphql" : "graphql" , "grpc" : "grpc" , "rest" : "rest" , "soap" : "soap" , "webhook" : "webhook" , "websocket" : "websocket" },
111118 )
112119 _args_schema .license = AAZObjectArg (
@@ -122,15 +129,11 @@ def _build_arguments_schema(cls, *args, **kwargs):
122129 max_length = 200 ,
123130 ),
124131 )
125- _args_schema .terms_of_service = AAZObjectArg (
126- options = ["--terms-of-service" ],
127- arg_group = "Properties" ,
128- help = "Terms of service for the API." ,
129- )
130132 _args_schema .title = AAZStrArg (
131133 options = ["--title" ],
132134 arg_group = "Properties" ,
133135 help = "API title." ,
136+ required = True ,
134137 fmt = AAZStrArgFormat (
135138 max_length = 50 ,
136139 min_length = 1 ,
@@ -212,16 +215,6 @@ def _build_arguments_schema(cls, *args, **kwargs):
212215 max_length = 200 ,
213216 ),
214217 )
215-
216- terms_of_service = cls ._args_schema .terms_of_service
217- terms_of_service .url = AAZStrArg (
218- options = ["url" ],
219- help = "URL pointing to the terms of service." ,
220- required = True ,
221- fmt = AAZStrArgFormat (
222- max_length = 200 ,
223- ),
224- )
225218 return cls ._args_schema
226219
227220 def _execute_operations (self ):
@@ -271,7 +264,7 @@ def error_format(self):
271264 def url_parameters (self ):
272265 parameters = {
273266 ** self .serialize_url_param (
274- "apiName" , self .ctx .args .api_name ,
267+ "apiName" , self .ctx .args .api_id ,
275268 required = True ,
276269 ),
277270 ** self .serialize_url_param (
@@ -322,18 +315,17 @@ def content(self):
322315 typ = AAZObjectType ,
323316 typ_kwargs = {"flags" : {"required" : True , "client_flatten" : True }}
324317 )
325- _builder .set_prop ("properties" , AAZObjectType , typ_kwargs = {"flags" : {"client_flatten" : True }})
318+ _builder .set_prop ("properties" , AAZObjectType , "." , typ_kwargs = {"flags" : {"required" : True , "client_flatten" : True }})
326319
327320 properties = _builder .get (".properties" )
328321 if properties is not None :
329322 properties .set_prop ("contacts" , AAZListType , ".contacts" )
330- properties .set_prop ("customProperties" , AAZObjectType , ".custom_properties" )
323+ properties .set_prop ("customProperties" , AAZFreeFormDictType , ".custom_properties" )
331324 properties .set_prop ("description" , AAZStrType , ".description" )
332325 properties .set_prop ("externalDocumentation" , AAZListType , ".external_documentation" )
333- properties .set_prop ("kind" , AAZStrType , ".kind " , typ_kwargs = {"flags" : {"required" : True }})
326+ properties .set_prop ("kind" , AAZStrType , ".type " , typ_kwargs = {"flags" : {"required" : True }})
334327 properties .set_prop ("license" , AAZObjectType , ".license" )
335328 properties .set_prop ("summary" , AAZStrType , ".summary" )
336- properties .set_prop ("termsOfService" , AAZObjectType , ".terms_of_service" )
337329 properties .set_prop ("title" , AAZStrType , ".title" , typ_kwargs = {"flags" : {"required" : True }})
338330
339331 contacts = _builder .get (".properties.contacts" )
@@ -346,6 +338,10 @@ def content(self):
346338 _elements .set_prop ("name" , AAZStrType , ".name" )
347339 _elements .set_prop ("url" , AAZStrType , ".url" )
348340
341+ custom_properties = _builder .get (".properties.customProperties" )
342+ if custom_properties is not None :
343+ custom_properties .set_anytype_elements ("." )
344+
349345 external_documentation = _builder .get (".properties.externalDocumentation" )
350346 if external_documentation is not None :
351347 external_documentation .set_elements (AAZObjectType , "." )
@@ -362,10 +358,6 @@ def content(self):
362358 license .set_prop ("name" , AAZStrType , ".name" )
363359 license .set_prop ("url" , AAZStrType , ".url" )
364360
365- terms_of_service = _builder .get (".properties.termsOfService" )
366- if terms_of_service is not None :
367- terms_of_service .set_prop ("url" , AAZStrType , ".url" , typ_kwargs = {"flags" : {"required" : True }})
368-
369361 return self .serialize_content (_content_value )
370362
371363 def on_200_201 (self , session ):
@@ -393,7 +385,7 @@ def _build_schema_on_200_201(cls):
393385 flags = {"read_only" : True },
394386 )
395387 _schema_on_200_201 .properties = AAZObjectType (
396- flags = {"client_flatten" : True },
388+ flags = {"required" : True , " client_flatten"True },
397389 )
398390 _schema_on_200_201 .system_data = AAZObjectType (
399391 serialized_name = "systemData" ,
@@ -405,7 +397,7 @@ def _build_schema_on_200_201(cls):
405397
406398 properties = cls ._schema_on_200_201 .properties
407399 properties .contacts = AAZListType ()
408- properties .custom_properties = AAZObjectType (
400+ properties .custom_properties = AAZFreeFormDictType (
409401 serialized_name = "customProperties" ,
410402 )
411403 properties .description = AAZStrType ()
@@ -418,6 +410,7 @@ def _build_schema_on_200_201(cls):
418410 properties .license = AAZObjectType ()
419411 properties .lifecycle_stage = AAZStrType (
420412 serialized_name = "lifecycleStage" ,
413+ flags = {"read_only" : True },
421414 )
422415 properties .summary = AAZStrType ()
423416 properties .terms_of_service = AAZObjectType (
0 commit comments