{ "swagger": "2.0", "info": { "title": "Azure Compute resource management API.", "version": "2026-03-03", "description": "Compute Client", "x-typespec-generated": [ { "emitter": "@azure-tools/typespec-autorest" } ] }, "schemes": [ "https" ], "host": "management.azure.com", "produces": [ "application/json" ], "consumes": [ "application/json" ], "security": [ { "azure_auth": [ "user_impersonation" ] } ], "securityDefinitions": { "azure_auth": { "type": "oauth2", "description": "Azure Active Directory OAuth2 Flow.", "flow": "implicit", "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", "scopes": { "user_impersonation": "impersonate your user account" } } }, "tags": [ { "name": "Galleries" }, { "name": "SoftDelete" }, { "name": "GallerySharingUpdate" }, { "name": "GalleryImages" }, { "name": "GalleryImageVersions" }, { "name": "GalleryApplications" }, { "name": "GalleryApplicationVersions" }, { "name": "GalleryScripts" }, { "name": "GalleryScriptVersions" }, { "name": "GalleryInVMAccessControlProfiles" }, { "name": "GalleryInVMAccessControlProfileVersions" }, { "name": "SharedGalleries" }, { "name": "SharedGalleryImages" }, { "name": "SharedGalleryImageVersions" }, { "name": "CommunityGalleries" }, { "name": "CommunityGalleryImages" }, { "name": "CommunityGalleryImageVersions" }, { "name": "SharedGalleryInvites" }, { "name": "TenantLevelSharedGalleryInvites" } ], "paths": { "/providers/Microsoft.Compute/locations/{location}/tenantLevelSharedGallerySubscriptions/{sharedGallerySubscriptionId}/sharedGalleries/{sharedGalleryName}/accept": { "post": { "operationId": "TenantLevelGallerySharing_Accept", "tags": [ "TenantLevelSharedGalleryInvites" ], "description": "Accept sharing of a tenant-level shared gallery.", "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/LocationParameter" }, { "name": "sharedGallerySubscriptionId", "in": "path", "description": "The name of the SharedGallerySubscription", "required": true, "type": "string", "pattern": "^[^_\\W][\\w-._]{0,79}(?..", "required": true, "type": "string" } ], "responses": { "200": { "description": "Azure operation completed successfully.", "schema": { "$ref": "#/definitions/CommunityGalleryImageVersion" } }, "default": { "description": "An unexpected error response.", "schema": { "$ref": "../../common-types/v1/common.json#/definitions/CloudError" } } }, "x-ms-examples": { "Get a community gallery image version.": { "$ref": "./examples/communityGalleryExamples/CommunityGalleryImageVersion_Get.json" } } } }, "/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries": { "get": { "operationId": "SharedGalleries_List", "tags": [ "SharedGalleries" ], "description": "List shared galleries by subscription id or tenant id.", "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/LocationParameter" }, { "name": "sharedTo", "in": "query", "description": "The query parameter to decide what shared galleries to fetch when doing listing operations.", "required": false, "type": "string", "enum": [ "tenant" ], "x-ms-enum": { "name": "SharedToValues", "modelAsString": true, "values": [ { "name": "tenant", "value": "tenant" } ] } } ], "responses": { "200": { "description": "The request has succeeded.", "schema": { "$ref": "#/definitions/SharedGalleryList" } }, "default": { "description": "An unexpected error response.", "schema": { "$ref": "../../common-types/v1/common.json#/definitions/CloudError" } } }, "x-ms-examples": { "List shared galleries.": { "$ref": "./examples/sharedGalleryExamples/SharedGallery_List.json" } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}": { "get": { "operationId": "SharedGalleries_Get", "tags": [ "SharedGalleries" ], "description": "Get a shared gallery by subscription id or tenant id.", "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/LocationParameter" }, { "name": "galleryUniqueName", "in": "path", "description": "The unique name of the Shared Gallery.", "required": true, "type": "string" } ], "responses": { "200": { "description": "Azure operation completed successfully.", "schema": { "$ref": "#/definitions/SharedGallery" } }, "default": { "description": "An unexpected error response.", "schema": { "$ref": "../../common-types/v1/common.json#/definitions/CloudError" } } }, "x-ms-examples": { "Get a shared gallery.": { "$ref": "./examples/sharedGalleryExamples/SharedGallery_Get.json" } } } }, "/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images": { "get": { "operationId": "SharedGalleryImages_List", "tags": [ "SharedGalleryImages" ], "description": "List shared gallery images by subscription id or tenant id.", "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/LocationParameter" }, { "name": "galleryUniqueName", "in": "path", "description": "The unique name of the Shared Gallery.", "required": true, "type": "string" }, { "name": "sharedTo", "in": "query", "description": "The query parameter to decide what shared galleries to fetch when doing listing operations.", "required": false, "type": "string", "enum": [ "tenant" ], "x-ms-enum": { "name": "SharedToValues", "modelAsString": true, "values": [ { "name": "tenant", "value": "tenant" } ] } } ], "responses": { "200": { "description": "The request has succeeded.", "schema": { "$ref": "#/definitions/SharedGalleryImageList" } }, "default": { "description": "An unexpected error response.", "schema": { "$ref": "../../common-types/v1/common.json#/definitions/CloudError" } } }, "x-ms-examples": { "List shared gallery images.": { "$ref": "./examples/sharedGalleryExamples/SharedGalleryImages_List.json" } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}": { "get": { "operationId": "SharedGalleryImages_Get", "tags": [ "SharedGalleryImages" ], "description": "Get a shared gallery image by subscription id or tenant id.", "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/LocationParameter" }, { "name": "galleryUniqueName", "in": "path", "description": "The unique name of the Shared Gallery.", "required": true, "type": "string" }, { "name": "galleryImageName", "in": "path", "description": "The name of the Shared Gallery Image Definition from which the Image Versions are to be listed.", "required": true, "type": "string" } ], "responses": { "200": { "description": "Azure operation completed successfully.", "schema": { "$ref": "#/definitions/SharedGalleryImage" } }, "default": { "description": "An unexpected error response.", "schema": { "$ref": "../../common-types/v1/common.json#/definitions/CloudError" } } }, "x-ms-examples": { "Get a shared gallery image.": { "$ref": "./examples/sharedGalleryExamples/SharedGalleryImage_Get.json" } } } }, "/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}/versions": { "get": { "operationId": "SharedGalleryImageVersions_List", "tags": [ "SharedGalleryImageVersions" ], "description": "List shared gallery image versions by subscription id or tenant id.", "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/LocationParameter" }, { "name": "galleryUniqueName", "in": "path", "description": "The unique name of the Shared Gallery.", "required": true, "type": "string" }, { "name": "galleryImageName", "in": "path", "description": "The name of the Shared Gallery Image Definition from which the Image Versions are to be listed.", "required": true, "type": "string" }, { "name": "sharedTo", "in": "query", "description": "The query parameter to decide what shared galleries to fetch when doing listing operations.", "required": false, "type": "string", "enum": [ "tenant" ], "x-ms-enum": { "name": "SharedToValues", "modelAsString": true, "values": [ { "name": "tenant", "value": "tenant" } ] } } ], "responses": { "200": { "description": "The request has succeeded.", "schema": { "$ref": "#/definitions/SharedGalleryImageVersionList" } }, "default": { "description": "An unexpected error response.", "schema": { "$ref": "../../common-types/v1/common.json#/definitions/CloudError" } } }, "x-ms-examples": { "List shared gallery image versions.": { "$ref": "./examples/sharedGalleryExamples/SharedGalleryImageVersions_List.json" } }, "x-ms-pageable": { "nextLinkName": "nextLink" } } }, "/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}/versions/{galleryImageVersionName}": { "get": { "operationId": "SharedGalleryImageVersions_Get", "tags": [ "SharedGalleryImageVersions" ], "description": "Get a shared gallery image version by subscription id or tenant id.", "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/LocationParameter" }, { "name": "galleryUniqueName", "in": "path", "description": "The unique name of the Shared Gallery.", "required": true, "type": "string" }, { "name": "galleryImageName", "in": "path", "description": "The name of the Shared Gallery Image Definition from which the Image Versions are to be listed.", "required": true, "type": "string" }, { "name": "galleryImageVersionName", "in": "path", "description": "The name of the gallery image version to be created. Needs to follow semantic version name pattern: The allowed characters are digit and period. Digits must be within the range of a 32-bit integer. Format: ..", "required": true, "type": "string" } ], "responses": { "200": { "description": "Azure operation completed successfully.", "schema": { "$ref": "#/definitions/SharedGalleryImageVersion" } }, "default": { "description": "An unexpected error response.", "schema": { "$ref": "../../common-types/v1/common.json#/definitions/CloudError" } } }, "x-ms-examples": { "Get a shared gallery image version.": { "$ref": "./examples/sharedGalleryExamples/SharedGalleryImageVersion_Get.json" } } } }, "/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGallerySubscriptions/{sharedGallerySubscriptionId}/sharedGalleries/{sharedGalleryName}/accept": { "post": { "operationId": "GallerySharing_Accept", "tags": [ "SharedGalleryInvites" ], "description": "Accept sharing of a subscription-level shared gallery.", "parameters": [ { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" }, { "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/LocationParameter" }, { "name": "sharedGallerySubscriptionId", "in": "path", "description": "The name of the SharedGallerySubscription", "required": true, "type": "string", "pattern": "^[^_\\W][\\w-._]{0,79}(?