diff --git a/documentation/onboard-dpg-in-sdkautomation/.net/README.md b/documentation/onboard-dpg-in-sdkautomation/.net/README.md deleted file mode 100644 index 3c071bd90db4..000000000000 --- a/documentation/onboard-dpg-in-sdkautomation/.net/README.md +++ /dev/null @@ -1,14 +0,0 @@ -# Add TypeSpec Configuration of .Net SDK - -Please copy the following configuration into `tspconfig.yaml` in your spec folder and replace `package-dir` and `namespace` to your own values. - -``` yaml - "@azure-tools/typespec-csharp": - package-dir: "Azure.AI.Vision.Face" - flavor: azure - namespace: "{package-dir}" -``` - -- `package-dir`: Name of your package directory. It should be several parts concatenated with `.` and all the paerts should be pascal case. -- `flavor`: Always `azure` for Azure SDK. -- `namespace`: Should be the same as `package-dir`. diff --git a/documentation/onboard-dpg-in-sdkautomation/Integrate-dpg-and-apiview-in-sdk-automation-pipeline.md b/documentation/onboard-dpg-in-sdkautomation/Integrate-dpg-and-apiview-in-sdk-automation-pipeline.md deleted file mode 100644 index b2e9c3df6991..000000000000 --- a/documentation/onboard-dpg-in-sdkautomation/Integrate-dpg-and-apiview-in-sdk-automation-pipeline.md +++ /dev/null @@ -1,32 +0,0 @@ -# Integrate DPG and ApiView in SDK Automation Pipeline -This document is targeting for everyone who wants to know all the implementation details of SDK automation pipeline. -It describes the details of integrating DPG and ApiView in SDK Automation Pipeline. - -Before go through this document, please go through [Service Onboard DPG with Swagger CI Pipeline](README.md) to be familiar with the user experience in service team side. Also, you need to be familiar with [SDK Automation Pipeline Framework](../sdkautomation/README.md). - -# WorkFlow -![integrate-dpg-and-apiview](imgs/integrate-dpg-and-apiview.png) - -__Description:__ -1. SDK Automation Pipeline is triggered in spec PR CI. -2. SDK Automation Pipeline Framework checks whether there is a comment containing autorest configuration in spec PR. If found, generate sdk by the autorest configuration in comment. -Otherwise, sdk automation pipeline will try to find if there is autorest configuration file in sdk repo. If found, generate sdk with the founded autorest configuration file. If not found, pipeline stops. - 1. When there is a comment containing autorest configuration, sdk automation pipeline will extract the autorest configuration from the comment, and let automation script use it to generate a new autorest configuration file, and use the new generated autorest configuration file to generate SDK. - 1. We need to make the comment as simple as possible. Currently, the common fields needed by all sdk are `output-folder` and `require` keyword. - 2. When getting the comment, automation script needs to parse it to extract needed information, and then use the extracted information to generate autorest configuration file in sdk repository. - 3. The value of `output-folder` is a relative path from sdk root folder. It is mainly used to extract information, such as service name, package name. In generating autorest configuration file in sdk repository, please replace it to the correct value. - 4. The value of `require` is a relative path to readme.md from spec root folder. In generating autorest configuration file in sdk repository, please concat relative path from package folder to sdk repo and `specFolder` in `generateInput.json`. For example: - ```yaml - require: - - ../../../../../azure-rest-api-specs/specification/deviceupdate/data-plane/readme.md - ``` - *You can also use the absolute path of spec repo, which can be resolved by yourself.* - 5. If there is other metadata in autorest configuration of spec PR comment, please copy them to autorest configuration file directly. (Although we only list little metadata service team can use in spec PR comment, we still need to support to add more metadata because the metadata listed in document maybe not enough.) - 2. When using the autorest configuration file found in sdk repository to generate SDK, SDK automation script need to modify the autorest configuration file in the SDK repo. - 1. If `require` block is used, change the `require` block to include the latest swagger `readme.md` in the PR. - 2. `input-file` will not be used. If the existing autorest configuration file uses `input-file`, we should change it to `require` before triggering the sdk automation pipeline, or add the autorest configuration in spec comment. -3. After generating SDK, SDK automation pipeline generates ApiView and then add comments about results to the Swagger PR. - -# Future Work -Currently, we ask service team must add a comment containing autorest configuration in spec PR when new service onboards DPG. -In the future, we are going to integrate it with PowerAPP Workflow. Then service team can provide the necessary information in PowerAPP Workflow, and the information will be added to spec PR automatically. \ No newline at end of file diff --git a/documentation/onboard-dpg-in-sdkautomation/README.md b/documentation/onboard-dpg-in-sdkautomation/README.md deleted file mode 100644 index 5bd2172b60a2..000000000000 --- a/documentation/onboard-dpg-in-sdkautomation/README.md +++ /dev/null @@ -1,44 +0,0 @@ -# Service Onboard DPG with Swagger CI Pipeline - -Service Onboarding DPG with Swagger CI pipeline can help you get generated SDK and ApiView during the procedure of creating swagger PR. -The benefits are following: -1. API signature could be reviewed at the same time when we submit a Swagger PR. This could help to detect API issues at the early stage. -2. It enables service teams to access their SDKs even before their Swagger PR is merged. - -This Document describes the process of how to onboard DPG with SDK automation pipeline. __This document is targeting for service team, who wants to onboard DPG.__ - -*If you want to go through details of pipeline implementation, please go to [Integrate DPG and ApiView in SDK Automation Pipeline](Integrate-dpg-and-apiview-in-sdk-automation-pipeline.md).* - -## WorkFlow - -![workflow-for-service-team](imgs/workflow-service-team.png) - -__Description:__ -1. Creates a swagger PR with [Guide to design and creation of Data Plane REST API and Client Libraries](https://aka.ms/azsdk/dpcodegen). -2. If you have added a comment, which contains autorest configuration, and run `/azp run` in the spec PR, the autorest configuration in the comment will be used to generate SDK. -Otherwise, pipeline will try to find autorest configuration file in sdk repository. If found, use the autorest configuration file to generate SDK. If not found, pipeline will stop. - - Please refer to [Add autorest configuration in spec comment](./add-autorest-configuration-for-dataplane-sdk.md) on how to add autorest configuration in spec comment. -3. SDK and ApiView will be generated in spec CI pipeline, and you can find them in spec PR comment. Refer to the [Get your PR merged](https://eng.ms/docs/products/azure-developer-experience/design/api-specs-pr/api-specs-pr?tabs=dataplane) for next steps. -4. If any change needed, please update the autorest configuration in spec PR comment and regenerate the SDK by adding a comment `/azp run` to swagger PR. - -## FAQ - -1. Where can I find the generated sdk and corresponding ApiView? - - __Answer__: You can find them in spec PR comment. The generated SDK can be found in comment `Swagger Generation Artifacts`, and the corresponding ApiView Link can be found in comment `Generated ApiView`. Following screenshots comes from [example PR](https://github.com/Azure/azure-rest-api-specs/pull/20017) - - ![](./imgs/example_generated_sdk.png) - ![](./imgs/example_generated_apiview.png) - -3. What should I do when I encounter error in generating SDK in swagger PR CI pipeline? - - __Answer__: Please check the comment [Swagger Generation Artifacts] and the error message of failed pipeline. If you find the error messages ask you to fix autorest configuration comment or swagger, please fix it. If you cannot understand error message, please ask sdk owners for help with mail: azsdk-dpgsupport@microsoft.com. - -4. What should I do when it creates ApiView Failed? - - __Answer__: If the ApiView is created failed, you can find there is an error message: `Create ApiView failed. Please ensure your github account in Azure/Microsoft is public and re-trigger the CI. If issue still exists, please ask PR assignee for help`. If you want to get the ApiView, -please follow the action in error message, and make you github account's organization information public, then re-trigger the CI (You can re-trigger CI by comment `/azp run`, or close and reopen the PR). If it still cannot generate ApiView, please ask PR assignee for help. - -5. Is there ApiView generated when there is no sdk generated in sdk automation pipeline? - - __Answer__: No. Creating ApiView is based on the generated codes in sdk automation pipeline. diff --git a/documentation/onboard-dpg-in-sdkautomation/add-autorest-configuration-for-dataplane-sdk.md b/documentation/onboard-dpg-in-sdkautomation/add-autorest-configuration-for-dataplane-sdk.md deleted file mode 100644 index 8c8c9916064f..000000000000 --- a/documentation/onboard-dpg-in-sdkautomation/add-autorest-configuration-for-dataplane-sdk.md +++ /dev/null @@ -1,16 +0,0 @@ -# Add Autorest Configuration for Dataplane SDK - -## Prerequisites -There should be a basic readme.md together with swagger, and you can refer to the [sample](../samplefiles-dp). - -## Add Autorest Configuration for .Net SDK -Please refer to [Add Autorest Configuration for .Net SDK](.net/README.md). - -## Add Autorest Configuration for Java SDK -Please refer to [Add Autorest Configuration for Java SDK](java/README.md). - -## Add Autorest Configuration for Python SDK -Please refer to [Add Autorest Configuration for Python SDK](python/README.md). - -## Add Autorest Configuration for JS SDK -Please refer to [Add Autorest Configuration for JS SDK](js/README.md). diff --git a/documentation/onboard-dpg-in-sdkautomation/imgs/example_generated_apiview.png b/documentation/onboard-dpg-in-sdkautomation/imgs/example_generated_apiview.png deleted file mode 100644 index cabede2a659c..000000000000 Binary files a/documentation/onboard-dpg-in-sdkautomation/imgs/example_generated_apiview.png and /dev/null differ diff --git a/documentation/onboard-dpg-in-sdkautomation/imgs/example_generated_sdk.png b/documentation/onboard-dpg-in-sdkautomation/imgs/example_generated_sdk.png deleted file mode 100644 index 8ecddba7c9ea..000000000000 Binary files a/documentation/onboard-dpg-in-sdkautomation/imgs/example_generated_sdk.png and /dev/null differ diff --git a/documentation/onboard-dpg-in-sdkautomation/imgs/integrate-dpg-and-apiview.png b/documentation/onboard-dpg-in-sdkautomation/imgs/integrate-dpg-and-apiview.png deleted file mode 100644 index b588779f696a..000000000000 Binary files a/documentation/onboard-dpg-in-sdkautomation/imgs/integrate-dpg-and-apiview.png and /dev/null differ diff --git a/documentation/onboard-dpg-in-sdkautomation/imgs/workflow-service-team.png b/documentation/onboard-dpg-in-sdkautomation/imgs/workflow-service-team.png deleted file mode 100644 index 86ca23c310b6..000000000000 Binary files a/documentation/onboard-dpg-in-sdkautomation/imgs/workflow-service-team.png and /dev/null differ diff --git a/documentation/onboard-dpg-in-sdkautomation/java/README.md b/documentation/onboard-dpg-in-sdkautomation/java/README.md deleted file mode 100644 index fa6661dd09de..000000000000 --- a/documentation/onboard-dpg-in-sdkautomation/java/README.md +++ /dev/null @@ -1,40 +0,0 @@ -# Add TypeSpec Configuration for Java SDK - -See [Use SDK Automation from REST API specifications](https://github.com/Azure/azure-sdk-for-java/wiki/TypeSpec-Java-Quickstart#use-sdk-automation-from-rest-api-specifications) in TypeSpec Java QuickStart. - -`flavor` is always `azure` for Azure SDK. - -## Example for Java data-plane SDK - -`namespace` always starts with `com.azure` for Azure Java data-plane SDK. [Review process](https://azure.github.io/azure-sdk/policies_reviewprocess.html). - -```yaml - "@azure-tools/typespec-java": - emitter-output-dir: "{output-dir}/{service-dir}/azure-ai-openai" - flavor: azure - namespace: "com.azure.ai.openai" -``` - -## Example for Java management-plane SDK - -`namespace` always starts with `com.azure.resourcemanager` for Azure Java management-plane SDK. [Review process](https://eng.ms/docs/products/azure-developer-experience/develop/namespace-review). - -`service-name` is the name of the service. It is used for SDK class name and documentations. - -```yaml - "@azure-tools/typespec-java": - emitter-output-dir: "{output-dir}/{service-dir}/azure-resourcemanager-standbypool" - flavor: "azure" - namespace: "com.azure.resourcemanager.standbypool" - service-name: "Standby Pool" -``` - -# Add AutoRest Configuration for Java SDK - -AutoRest configuration should only be used for management-plane SDK, when there is no TypeSpec on your resource provider. - -One can copy the [sample readme.java.md file](https://github.com/Azure/azure-rest-api-specs/blob/main/documentation/samplefiles/readme.java.md). - -It is recommended to add a `service-name` to the readme.java.md file. - -Service does not need to configure the namespace in readme.java.md. The namespace is configured in [api-specs.yaml in SDK repository](https://github.com/Azure/azure-sdk-for-java/blob/main/eng/mgmt/automation/api-specs.yaml) that would be automatically updated upon SDK pull request. diff --git a/documentation/onboard-dpg-in-sdkautomation/js/README.md b/documentation/onboard-dpg-in-sdkautomation/js/README.md deleted file mode 100644 index e82f8d0f7199..000000000000 --- a/documentation/onboard-dpg-in-sdkautomation/js/README.md +++ /dev/null @@ -1,45 +0,0 @@ -# Add Autorest Configuration of JS SDK - -## Parameter Description - -- ``: The RP name, which is usually same as folder name in swagger. -- ``: Python package folder name, which must ends with `-rest`. For example: `purview-administration-rest`. -- ``: The sub-folder name in the package. It's only used by multi-client scenario. - -## Single Client -If you want to generate sdk with single client, please copy the following configuration into spec PR comment. -~~~ -# azure-sdk-for-js -``` yaml -output-folder: sdk// -require: - - specification//data-plane/readme.md -``` -~~~ -- `output-folder`: The relative path of destination to generate SDK. -- `require`: The item of the value is the relative path of spec readme.md file. - -## Multi Client -If you want to generate sdk with multi client, please copy the following configuration into spec PR comment. -~~~ -# azure-sdk-for-js -``` yaml $(multi-client) -tag: false -require: - - specification//data-plane/readme.md -batch: - - package-A: true - - package-B: true -``` - -``` yaml $(package-A) -output-folder: sdk///src/ -``` - -``` yaml $(package-B) -output-folder: sdk///src/ -``` -~~~ -- `output-folder`: The relative path of destination to generate SDK. -- `require`: The item of the value is the relative path of spec readme.md file. -- `package-A` and `package-B` must be defined in swagger `readme.md` file. For samples, please refer to [dataplane samples for multi client](../../samplefiles-dp/samplefiles-dp-for-multi-client). diff --git a/documentation/onboard-dpg-in-sdkautomation/python/README.md b/documentation/onboard-dpg-in-sdkautomation/python/README.md deleted file mode 100644 index 45ce0fa7a084..000000000000 --- a/documentation/onboard-dpg-in-sdkautomation/python/README.md +++ /dev/null @@ -1,39 +0,0 @@ -# Add Autorest Configuration of Python SDK - -## Parameter Description - -- ``: The RP name, which is usually same as folder name in swagger. -- ``: Python package name. -- ``: SDK Client Name - -## Single Client -If you want to generate sdk with single client, please copy the following configuration into spec PR comment. -~~~ -# azure-sdk-for-python -``` yaml -output-folder: sdk/<ServiceName>/<PackageName> -require: - - specification/<RPName>/data-plane/readme.md -``` -~~~ -- `output-folder`: The relative path of destination to generate SDK. -- `require`: The item of the value is the relative path of spec readme.md file. - -## Multi Client -If you want to generate sdk with multi client, please copy the following configuration into spec PR comment. -~~~ -# azure-sdk-for-python -``` yaml -tag: false -output-folder: sdk/<ServiceName>/<PackageName> -require: - - specification/<ServiceName>/data-plane/readme.md -batch: - - package-A: true - - package-B: true -``` - -~~~ -- `output-folder`: The relative path of destination to generate SDK. -- `require`: The item of the value is the relative path of spec readme.md file. -- `package-A` and `package-B` must be defined in swagger `readme.md` file. For samples, please refer to [dataplane samples for multi client](../../samplefiles-dp/samplefiles-dp-for-multi-client). diff --git a/documentation/samplefiles-dp/samplefiles-dp-for-multi-client/README.md b/documentation/samplefiles-dp/samplefiles-dp-for-multi-client/README.md index b777412aa8bc..1150dfa11ea7 100644 --- a/documentation/samplefiles-dp/samplefiles-dp-for-multi-client/README.md +++ b/documentation/samplefiles-dp/samplefiles-dp-for-multi-client/README.md @@ -1,23 +1,5 @@ # [[ServiceName]] -> see https://aka.ms/autorest - -This is the AutoRest configuration file for [[ServiceName]]. - -## Getting Started - -To build the SDKs for My API, simply install AutoRest via `npm` (`npm install -g autorest`) and then run: - -> `autorest readme.md` - -To see additional help and options, run: - -> `autorest --help` - -For other options on installation see [Installing AutoRest](https://aka.ms/autorest/install) on the AutoRest github page. - ---- - ## Configuration ### Basic Information @@ -68,18 +50,3 @@ These settings apply only when `--package-B-tag=package-B-[[Version]]` is specif input-file: - Microsoft.YourServiceName/stable/YYYY-MM-DD/YourServiceNameB.json ``` - -# Code Generation - -## Swagger to SDK - -This section describes what SDK should be generated by the automatic system. -This is not used by Autorest itself. - -```yaml $(swagger-to-sdk) -swagger-to-sdk: - - repo: azure-sdk-for-js - - repo: azure-sdk-for-python - - repo: azure-sdk-for-java - - repo: azure-sdk-for-net -``` diff --git a/documentation/samplefiles-dp/samplefiles-dp-for-single-client/README.md b/documentation/samplefiles-dp/samplefiles-dp-for-single-client/README.md index d0033dc14b95..65c0b2e01806 100644 --- a/documentation/samplefiles-dp/samplefiles-dp-for-single-client/README.md +++ b/documentation/samplefiles-dp/samplefiles-dp-for-single-client/README.md @@ -1,23 +1,5 @@ # [[ServiceName]] -> see https://aka.ms/autorest - -This is the AutoRest configuration file for [[ServiceName]]. - -## Getting Started - -To build the SDKs for My API, simply install AutoRest via `npm` (`npm install -g autorest`) and then run: - -> `autorest readme.md` - -To see additional help and options, run: - -> `autorest --help` - -For other options on installation see [Installing AutoRest](https://aka.ms/autorest/install) on the AutoRest github page. - ---- - ## Configuration ### Basic Information @@ -40,18 +22,3 @@ These settings apply only when `--tag=package-[[Version]]` is specified on the c input-file: - [[ResourceProviderName]]/[[ReleaseState]]/[[Version]]/[[ServiceName]].json ``` - -# Code Generation - -## Swagger to SDK - -This section describes what SDK should be generated by the automatic system. -This is not used by Autorest itself. - -```yaml $(swagger-to-sdk) -swagger-to-sdk: - - repo: azure-sdk-for-js - - repo: azure-sdk-for-python - - repo: azure-sdk-for-java - - repo: azure-sdk-for-net -``` diff --git a/documentation/samplefiles/ABOUT.md b/documentation/samplefiles/ABOUT.md index 09978fd29bfc..fc9d5e7e0aba 100644 --- a/documentation/samplefiles/ABOUT.md +++ b/documentation/samplefiles/ABOUT.md @@ -9,9 +9,6 @@ specification files referenced by the README files. > which is a legacy, obsolete approach. For current approach refer to > [aka.ms/azsdk/typespec](https://aka.ms/azsdk/typespec). -Finally, the `./Microsoft.YourServiceName/stable/YYYY-MM-DD/scenarios/quickStart.yaml` -is an [`api-scenario`](../api-scenario/README.md) sample. - You can learn more about AutoRest configuration files at [aka.ms/azsdk/autorest](https://aka.ms/azsdk/autorest). diff --git a/documentation/samplefiles/Microsoft.YourServiceName/stable/YYYY-MM-DD/scenarios/quickStart.yaml b/documentation/samplefiles/Microsoft.YourServiceName/stable/YYYY-MM-DD/scenarios/quickStart.yaml deleted file mode 100644 index 14ac75ea7a23..000000000000 --- a/documentation/samplefiles/Microsoft.YourServiceName/stable/YYYY-MM-DD/scenarios/quickStart.yaml +++ /dev/null @@ -1,34 +0,0 @@ -# yaml-language-server: $schema=https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/documentation/api-scenario/references/v1.2/schema.json - -scope: ResourceGroup - -scenarios: - - description: Microsoft.YourService Test Operation Get - steps: - - step: Test Operation Get - exampleFile: ../examples/OperationGroupGet.json - - - description: Microsoft.YourService Test Cat Create and Update - steps: - - step: Create cat Rococo - exampleFile: ../examples/CatsCreateOrUpdate.json - - - step: Get cat Rococo - exampleFile: ../examples/CatsGet.json - - - description: Microsoft.YourService Test Cat mate link - steps: - - step: Create cat Rococo - exampleFile: ../examples/CatsCreateOrUpdate.json - - - step: Create cat Baroque - exampleFile: ../examples/CatsCreateOrUpdate.json - variables: - catName: Baroque - requestUpdate: - - replace: /parameters/properties/fullName - value: Baroque the Cat - outputVariables: - cat1Id: - fromResponse: /id - diff --git a/documentation/samplefiles/README.md b/documentation/samplefiles/README.md index fe937b5a2672..461046b7bb1e 100644 --- a/documentation/samplefiles/README.md +++ b/documentation/samplefiles/README.md @@ -1,21 +1,5 @@ # [[ServiceName]] -> see https://aka.ms/autorest - -This is the AutoRest configuration file for [[ServiceName]]. - -## Getting Started - -To build the SDKs for My API, simply install AutoRest via `npm` (`npm install -g autorest`) and then run: - -> `autorest readme.md` - -To see additional help and options, run: - -> `autorest --help` - -For other options on installation see [Installing AutoRest](https://aka.ms/autorest/install) on the AutoRest github page. - --- ## Configuration @@ -40,27 +24,6 @@ input-file: --- -# Code Generation - -## Swagger to SDK - -This section describes what SDK should be generated by the automatic system. -This is not used by Autorest itself. - -```yaml $(swagger-to-sdk) -swagger-to-sdk: - - repo: azure-sdk-for-python - - repo: azure-sdk-for-java - - repo: azure-sdk-for-go - - repo: azure-sdk-for-js - - repo: azure-resource-manager-schemas - - repo: azure-cli-extensions - - repo: azure-powershell -``` -## Az - -See configuration in [readme.az.md](./readme.az.md) - ## Go See configuration in [readme.go.md](./readme.go.md) diff --git a/documentation/samplefiles/readme.az.md b/documentation/samplefiles/readme.az.md deleted file mode 100644 index ab6eaf1557a1..000000000000 --- a/documentation/samplefiles/readme.az.md +++ /dev/null @@ -1,28 +0,0 @@ -## AZ - -These settings apply only when `--az` is specified on the command line. - -For new Resource Provider. It is highly recommended to onboard Azure CLI extensions. There's no differences in terms of customer usage. - -``` yaml $(az) && $(target-mode) != 'core' -az: - extensions: [[ServiceName]] - namespace: azure.mgmt.[[ServiceName]] - package-name: azure-mgmt-[[ServiceName]] -az-output-folder: $(azure-cli-extension-folder)/src/[[ServiceName]] -python-sdk-output-folder: "$(az-output-folder)/azext_[[ServiceName]]/vendored_sdks/[[ServiceName]]" -# add additional configuration here specific for Azure CLI -# refer to the faq.md for more details -``` - - - -This is for command modules that already in azure cli main repo. -``` yaml $(az) && $(target-mode) == 'core' -az: - extensions: [[ServiceName]] - namespace: azure.mgmt.[[ServiceName]] - package-name: azure-mgmt-[[ServiceName]] -az-output-folder: $(azure-cli-folder)/src/azure-cli/azure/cli/command_modules/[[ServiceName]] -python-sdk-output-folder: "$(az-output-folder)/vendored_sdks/[[ServiceName]]" -``` \ No newline at end of file diff --git a/documentation/samplefiles/readme.cli.md b/documentation/samplefiles/readme.cli.md deleted file mode 100644 index c6cf6ad37ea4..000000000000 --- a/documentation/samplefiles/readme.cli.md +++ /dev/null @@ -1 +0,0 @@ -## CLI Common Settings for all the command line tools \ No newline at end of file diff --git a/documentation/samplefiles/samplereadme.md b/documentation/samplefiles/samplereadme.md deleted file mode 100644 index 750da28419b5..000000000000 --- a/documentation/samplefiles/samplereadme.md +++ /dev/null @@ -1,23 +0,0 @@ -# [[ServiceName]] - ---- - -## Configuration - -### Basic Information - -These are the global settings for the [[ServiceName]]. - -```yaml -openapi-type: [[OpenApiType]] -tag: package-[[Version]] -``` - -### Tag: package-[[Version]] - -These settings apply only when `--tag=package-[[Version]]` is specified on the command line. - -```yaml $(tag) == 'package-[[Version]]' -input-file: - - [[ResourceProviderName]]/[[ReleaseState]]/[[Version]]/[[ServiceName]].json -```