Skip to content

Add galleryScriptReferenceId parameter to runCommand.json #33517

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: feature/cplat-2025-04-01
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{

Check notice on line 1 in specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/runCommand.json

View workflow job for this annotation

GitHub Actions / TypeSpec Requirement

Brownfield services will soon be required to convert from OpenAPI to TypeSpec. See https://aka.ms/azsdk/typespec.

Check notice on line 1 in specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/runCommand.json

View workflow job for this annotation

GitHub Actions / TypeSpec Requirement

Brownfield services will soon be required to convert from OpenAPI to TypeSpec. See https://aka.ms/azsdk/typespec.
"swagger": "2.0",
"info": {
"title": "RunCommandsClient",
Expand Down Expand Up @@ -103,7 +103,7 @@
"in": "path",
"required": true,
"type": "string",
"description": "The command id."
"description": "Specifies a commandId of predefined built-in script. Command IDs available for Linux are listed at https://aka.ms/RunCommandManagedLinux#available-commands, Windows at https://aka.ms/RunCommandManagedWindows#available-commands."
},
{
"$ref": "../../../common-types/v1/common.json#/parameters/ApiVersionParameter"
Expand Down Expand Up @@ -946,7 +946,7 @@
"properties": {
"commandId": {
"type": "string",
"description": "The run command id."
"description": "Specifies a commandId of predefined built-in script. Command IDs available for Linux are listed at https://aka.ms/RunCommandManagedLinux#available-commands, Windows at https://aka.ms/RunCommandManagedWindows#available-commands."
},
"script": {
"type": "array",
Expand Down Expand Up @@ -1189,15 +1189,31 @@
},
"commandId": {
"type": "string",
"description": "Specifies a commandId of predefined built-in script."
"description": "Specifies a commandId of predefined built-in script. Command IDs available for Linux are listed at https://aka.ms/RunCommandManagedLinux#available-commands, Windows at https://aka.ms/RunCommandManagedWindows#available-commands"
},
"scriptUriManagedIdentity": {
"$ref": "#/definitions/RunCommandManagedIdentity",
"description": "User-assigned managed identity that has access to scriptUri in case of Azure storage blob. Use an empty object in case of system-assigned identity. Make sure the Azure storage blob exists, and managed identity has been given access to blob's container with 'Storage Blob Data Reader' role assignment. In case of user-assigned identity, make sure you add it under VM's identity. For more info on managed identity and Run Command, refer https://aka.ms/ManagedIdentity and https://aka.ms/RunCommandManaged."
},
"scriptShell": {
"type": "string",
"description": "Optional. Specify which shell to use for running the script. These values must match those expected by the extension. Currently supported only for Windows VMs, script uses Powershell 7 when specified. Powershell 7 must be already installed on the machine to use Powershell7 parameter value.",
"enum": [
"Default",
"Powershell7"
],
"x-ms-enum": {
"name": "ScriptShellTypes",
"modelAsString": true
}
},
"galleryScriptReferenceId": {
"type": "string",
"description": "The resource ID of a Gallery Script version that needs to be executed. Example ID looks like /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Compute/galleries/{galleryName}/scripts/{scriptName}/versions/{version}."
}
},
"type": "object",
"description": "Describes the script sources for run command. Use only one of script, scriptUri, commandId."
"description": "Describes the script sources for run command. Use only one of these script sources: script, scriptUri, commandId, galleryScriptReferenceId."
},
"VirtualMachineRunCommandProperties": {
"properties": {
Expand Down