SrSSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SSK J r SS K J r SS K J r "S S \R5rg )zJA command that generates YAML export schemas for a message in a given API.)absolute_import)division)unicode_literals)base) exceptions)flags) arg_utils)export)registryc.\rSrSrSr\S5rSrSrg)GenerateExportSchemasaGenerate YAML export schemas for a message in a given API. *gcloud* commands that have "too many" *create*/*update* command flags may also provide *export*/*import* commands. *export* lists the current state of a resource in a YAML *export* format. *import* reads export format data and either creates a new resource or updates an existing resource. An export format is an abstract YAML representation of the mutable fields of a populated protobuf message. Abstraction allows the export format to hide implementation details of some protobuf constructs like enums and `additionalProperties`. One way of describing an export format is with JSON schemas. A schema documents export format properties for a message in an API, and can also be used to validate data on import. Validation is important because users can modify export data before importing it again. This command generates [JSON schemas](json-schema.org) (in YAML format, go figure) for a protobuf message in an API. A separate schema files is generated for each nested message in the resource message. ## CAVEATS The generated schemas depend on the quality of the protobuf discovery docs, including proto file comment conventions that are not error checked. Always manually inspect schemas before using them in a release. ## EXAMPLES To generate the WorkflowTemplate schemas in the current directory from the dataproc v1 API: $ {command} WorkflowTemplate --api=dataproc --api-version=v1 c[RRU5 [RRU5 UR SSS9 UR SSS9 g)Nmessagez@The name of the message to generate the YAML export schemas for.)helpz --directoryzThe path name of the directory to create the YAML export schema files in. If not specified then the files are created in the current directory.)rAPI_REQUIRED_FLAG AddToParserAPI_VERSION_FLAG add_argument)parsers 9lib/surface/meta/apis/messages/generate_export_schemas.pyArgsGenerateExportSchemas.ArgsBsa ''/ &&v.  OQ ')c [R"URURS9n[ UR 5UR 5n[R"U5n[R"X!R XAR 5 g![aG [R"SSRUR URUR55ef=f)N) api_versionrz+Message [{}] does not exist for API [{} {}])r GetAPIapirgetattrGetMessagesModulerAttributeErrorrInvalidArgumentExceptionformatversionr GetRecursiveMessageSpecr r directory)selfargsrr message_specs rRunGenerateExportSchemas.RunOs //$((0@0@ AC4--/>g 44W=L    \\<9 4  / / BIIllDHHckk3 444s $BAC"N) __name__ __module__ __qualname____firstlineno____doc__ staticmethodrr*__static_attributes__r,rrr r s!!F ) ) 9rr N)r1 __future__rrrgooglecloudsdk.callioperr$googlecloudsdk.command_lib.meta.apisr$googlecloudsdk.command_lib.util.apisr r r SilentCommandr r,rrr9s8 Q&'(.6:79;9D..;9r