你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Deployments - Create Or Update At Subscription Scope

服务:

Resource Management

API 版本:

2021-04-01

在订阅范围内部署资源。
可以直接在请求中提供模板和参数，也可以链接到 JSON 文件。

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2021-04-01

URI 参数

名称	在	必需	类型	说明
deploymentName	path	True	string minLength: 1 maxLength: 64 pattern: ^[-\w\._\(\)]+$	部署的名称。
subscriptionId	path	True	string	Microsoft Azure 订阅 ID。
api-version	query	True	string	用于此操作的 API 版本。

请求正文

名称	必需	类型	说明
properties	True	DeploymentProperties	部署属性。
location		string	用于存储部署数据的位置。
tags		object	部署标记

响应

名称	类型	说明
200 OK	DeploymentExtended	确定 - 返回有关部署的信息，包括预配状态。
201 Created	DeploymentExtended	创建 - 返回有关部署的信息，包括预配状态。
Other Status Codes	CloudError	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Create a deployment that will deploy a templateSpec with the given resourceId

示例请求

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/providers/Microsoft.Resources/deployments/my-deployment?api-version=2021-04-01

{
  "location": "eastus",
  "properties": {
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"
    },
    "parameters": {},
    "mode": "Incremental"
  }
}

Go

package armresources_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresources"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4fd842fb73656039ec94ce367bcedee25a57bd18/specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/PutDeploymentSubscriptionTemplateSpecsWithId.json
func ExampleDeploymentsClient_BeginCreateOrUpdateAtSubscriptionScope() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armresources.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewDeploymentsClient().BeginCreateOrUpdateAtSubscriptionScope(ctx, "my-deployment", armresources.Deployment{
		Location: to.Ptr("eastus"),
		Properties: &armresources.DeploymentProperties{
			Mode:       to.Ptr(armresources.DeploymentModeIncremental),
			Parameters: map[string]any{},
			TemplateLink: &armresources.TemplateLink{
				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.DeploymentExtended = armresources.DeploymentExtended{
	// 	Name: to.Ptr("my-deployment"),
	// 	Type: to.Ptr("Microsoft.Resources/deployments"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/providers/Microsoft.Resources/deployments/my-deployment"),
	// 	Location: to.Ptr("eastus"),
	// 	Properties: &armresources.DeploymentPropertiesExtended{
	// 		CorrelationID: to.Ptr("00000000-0000-0000-0000-000000000000"),
	// 		Dependencies: []*armresources.Dependency{
	// 		},
	// 		Duration: to.Ptr("PT1.2637681S"),
	// 		Mode: to.Ptr(armresources.DeploymentModeIncremental),
	// 		OutputResources: []*armresources.ResourceReference{
	// 		},
	// 		Parameters: map[string]any{
	// 		},
	// 		Providers: []*armresources.Provider{
	// 		},
	// 		ProvisioningState: to.Ptr(armresources.ProvisioningStateSucceeded),
	// 		TemplateHash: to.Ptr("0000000000000000000"),
	// 		TemplateLink: &armresources.TemplateLink{
	// 			ContentVersion: to.Ptr("1.0.0.0"),
	// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"),
	// 		},
	// 		Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-06-05T01:51:58.628Z"); return t}()),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ResourceManagementClient } = require("@azure/arm-resources");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to You can provide the template and parameters directly in the request or link to JSON files.
 *
 * @summary You can provide the template and parameters directly in the request or link to JSON files.
 * x-ms-original-file: specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/examples/PutDeploymentSubscriptionTemplateSpecsWithId.json
 */
async function createADeploymentThatWillDeployATemplateSpecWithTheGivenResourceId() {
  const subscriptionId =
    process.env["RESOURCES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000001";
  const deploymentName = "my-deployment";
  const parameters = {
    location: "eastus",
    properties: {
      mode: "Incremental",
      parameters: {},
      templateLink: {
        id: "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
      },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new ResourceManagementClient(credential, subscriptionId);
  const result = await client.deployments.beginCreateOrUpdateAtSubscriptionScopeAndWait(
    deploymentName,
    parameters
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "location": "eastus",
  "properties": {
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
      "contentVersion": "1.0.0.0"
    },
    "templateHash": "0000000000000000000",
    "parameters": {},
    "mode": "Incremental",
    "provisioningState": "Succeeded",
    "timestamp": "2020-06-05T01:51:58.6288067Z",
    "duration": "PT1.2637681S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [],
    "dependencies": [],
    "outputResources": []
  }
}

状态代码:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "location": "eastus",
  "properties": {
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
      "contentVersion": "1.0.0.0"
    },
    "templateHash": "0000000000000000000",
    "parameters": {},
    "mode": "Incremental",
    "provisioningState": "Accepted",
    "timestamp": "2020-06-05T01:51:58.6288067Z",
    "duration": "PT1.2637681S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [],
    "dependencies": []
  }
}

定义

名称	说明
Alias	别名类型。
AliasPath	别名的路径的类型。
AliasPathAttributes	别名路径引用的令牌的属性。
AliasPathMetadata
AliasPathTokenType	别名路径引用的标记的类型。
AliasPattern	别名路径的模式类型。
AliasPatternType	别名模式的类型
AliasType	别名的类型。
ApiProfile
BasicDependency	部署依赖项信息。
CloudError	资源管理请求的错误响应。
DebugSetting	调试设置。
Dependency	部署依赖项信息。
Deployment	部署操作参数。
DeploymentExtended	部署信息。
DeploymentMode	用于部署资源的模式。 此值可以是增量值，也可以是“完成”。 在增量模式下，部署资源而不删除模板中不包含的现有资源。 在“完成”模式下，将部署资源，并删除模板中不包含的资源组中的现有资源。 使用“完成”模式时请注意，因为可能会无意中删除资源。
DeploymentProperties	部署属性。
DeploymentPropertiesExtended	具有更多详细信息的部署属性。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorResponse	错误响应
ExpressionEvaluationOptions	指定模板表达式是在父模板或嵌套模板的范围内计算的。
ExpressionEvaluationOptionsScopeType	用于计算嵌套模板中的参数、变量和函数的范围。
OnErrorDeployment	针对错误行为进行部署。
OnErrorDeploymentExtended	有关错误行为的部署，并提供了其他详细信息。
OnErrorDeploymentType	错误行为类型的部署。 可能的值为 LastSuccessful 和 SpecificDeployment。
ParametersLink	表示对部署参数的引用的实体。
Provider	资源提供程序信息。
ProviderAuthorizationConsentState	提供程序授权许可状态。
ProviderExtendedLocation	提供程序扩展位置。
ProviderResourceType	资源提供程序管理的资源类型。
ProvisioningState	表示预配的状态。
ResourceReference	资源 ID 模型。
TemplateLink	表示对模板的引用的实体。
ZoneMapping

Alias

Object

别名类型。

名称	类型	说明
defaultMetadata	AliasPathMetadata	默认别名路径元数据。 适用于默认路径和不具有元数据的任何别名路径
defaultPath	string	别名的默认路径。
defaultPattern	AliasPattern	别名的默认模式。
name	string	别名。
paths	AliasPath[]	别名的路径。
type	AliasType	别名的类型。

AliasPath

Object

别名的路径的类型。

名称	类型	说明
apiVersions	string[]	API 版本。
metadata	AliasPathMetadata	别名路径的元数据。 如果缺少，请回退到别名的默认元数据。
path	string	别名的路径。
pattern	AliasPattern	别名路径的模式。

AliasPathAttributes

枚举

别名路径引用的令牌的属性。

值	说明
Modifiable	别名路径引用的标记可由具有“modify”效果的策略修改。
None	别名路径引用的标记没有属性。

AliasPathMetadata

Object

名称	类型	说明
attributes	AliasPathAttributes	别名路径引用的令牌的属性。
type	AliasPathTokenType	别名路径引用的标记的类型。

AliasPathTokenType

枚举

别名路径引用的标记的类型。

值	说明
Any	标记类型可以是任何内容。
Array	标记类型为数组。
Boolean	标记类型为布尔值。
Integer	标记类型为整数。
NotSpecified	未指定标记类型。
Number	标记类型为数字。
Object	标记类型为对象。
String	标记类型为字符串。

AliasPattern

Object

别名路径的模式类型。

名称	类型	说明
phrase	string	别名模式短语。
type	AliasPatternType	别名模式的类型
variable	string	别名模式变量。

AliasPatternType

枚举

别名模式的类型

值	说明
Extract	提取是唯一允许的值。
NotSpecified	不允许指定。

AliasType

枚举

别名的类型。

值	说明
Mask	别名值为机密。
NotSpecified	别名类型未知（与不提供别名类型相同）。
PlainText	别名值不是机密。

ApiProfile

Object

名称	类型	说明
apiVersion	string	API 版本。
profileVersion	string	配置文件版本。

BasicDependency

Object

部署依赖项信息。

名称	类型	说明
id	string	依赖项的 ID。
resourceName	string	依赖项资源名称。
resourceType	string	依赖项资源类型。

CloudError

Object

资源管理请求的错误响应。

名称	类型	说明
error	ErrorResponse	错误响应 所有 Azure 资源管理器 API 的常见错误响应，以返回失败操作的错误详细信息。 （这也遵循 OData 错误响应格式。）

DebugSetting

Object

调试设置。

名称	类型	说明
detailLevel	string	指定要记录以供调试的信息的类型。 允许的值不为 none、requestContent、responseContent，或两者均用逗号分隔的 requestContent 和 responseContent。 默认值为 none。 设置此值时，请仔细考虑在部署期间传入的信息类型。 通过记录有关请求或响应的信息，可能会公开通过部署操作检索的敏感数据。

Dependency

Object

部署依赖项信息。

名称	类型	说明
dependsOn	BasicDependency[]	依赖项列表。
id	string	依赖项的 ID。
resourceName	string	依赖项资源名称。
resourceType	string	依赖项资源类型。

Deployment

Object

部署操作参数。

名称	类型	说明
location	string	用于存储部署数据的位置。
properties	DeploymentProperties	部署属性。
tags	object	部署标记

DeploymentExtended

Object

部署信息。

名称	类型	说明
id	string	部署的 ID。
location	string	部署的位置。
name	string	部署的名称。
properties	DeploymentPropertiesExtended	部署属性。
tags	object	部署标记
type	string	部署的类型。

DeploymentMode

枚举

用于部署资源的模式。 此值可以是增量值，也可以是“完成”。 在增量模式下，部署资源而不删除模板中不包含的现有资源。 在“完成”模式下，将部署资源，并删除模板中不包含的资源组中的现有资源。 使用“完成”模式时请注意，因为可能会无意中删除资源。

值	说明
Complete
Incremental

DeploymentProperties

Object

部署属性。

名称	类型	说明
debugSetting	DebugSetting	部署的调试设置。
expressionEvaluationOptions	ExpressionEvaluationOptions	指定模板表达式是在父模板或嵌套模板的范围内计算的。 仅适用于嵌套模板。 如果未指定，则默认值为外部值。
mode	DeploymentMode	用于部署资源的模式。 此值可以是增量值，也可以是“完成”。 在增量模式下，部署资源而不删除模板中不包含的现有资源。 在“完成”模式下，将部署资源，并删除模板中不包含的资源组中的现有资源。 使用“完成”模式时请注意，因为可能会无意中删除资源。
onErrorDeployment	OnErrorDeployment	错误行为的部署。
parameters	object	定义模板部署参数的名称和值对。 如果要直接在请求中提供参数值，而不是链接到现有参数文件，请使用此元素。 使用 parametersLink 属性或 parameters 属性，但不能同时使用两者。 它可以是 JObject 或格式良好的 JSON 字符串。
parametersLink	ParametersLink	参数文件的 URI。 使用此元素链接到现有参数文件。 使用 parametersLink 属性或 parameters 属性，但不能同时使用两者。
template	object	模板内容。 如果要直接在请求中传递模板语法，而不是链接到现有模板，请使用此元素。 它可以是 JObject 或格式正确的 JSON 字符串。 使用 templateLink 属性或模板属性，但不能同时使用这两者。
templateLink	TemplateLink	模板的 URI。 使用 templateLink 属性或模板属性，但不能同时使用这两者。

DeploymentPropertiesExtended

Object

具有更多详细信息的部署属性。

名称	类型	说明
correlationId	string	部署的相关 ID。
debugSetting	DebugSetting	部署的调试设置。
dependencies	Dependency[]	部署依赖项的列表。
duration	string	模板部署的持续时间。
error	ErrorResponse	错误响应 部署错误。
mode	DeploymentMode	部署模式。 可能的值为 Incremental 和 Complete。
onErrorDeployment	OnErrorDeploymentExtended	错误行为的部署。
outputResources	ResourceReference[]	预配的资源数组。
outputs	object	表示部署输出的键/值对。
parameters	object	部署参数。
parametersLink	ParametersLink	引用参数的 URI。
providers	Provider[]	部署所需的资源提供程序列表。
provisioningState	ProvisioningState	表示预配的状态。
templateHash	string	为模板生成的哈希。
templateLink	TemplateLink	引用模板的 URI。
timestamp	string (date-time)	模板部署的时间戳。
validatedResources	ResourceReference[]	已验证的资源数组。

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorResponse

Object

错误响应

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorResponse[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ExpressionEvaluationOptions

Object

指定模板表达式是在父模板或嵌套模板的范围内计算的。

名称	类型	说明
scope	ExpressionEvaluationOptionsScopeType	用于计算嵌套模板中的参数、变量和函数的范围。

ExpressionEvaluationOptionsScopeType

枚举

用于计算嵌套模板中的参数、变量和函数的范围。

值	说明
Inner
NotSpecified
Outer

OnErrorDeployment

Object

针对错误行为进行部署。

名称	类型	说明
deploymentName	string	要用于错误案例的部署。
type	OnErrorDeploymentType	错误行为类型的部署。 可能的值为 LastSuccessful 和 SpecificDeployment。

OnErrorDeploymentExtended

Object

有关错误行为的部署，并提供了其他详细信息。

名称	类型	说明
deploymentName	string	要用于错误案例的部署。
provisioningState	string	错误部署的预配状态。
type	OnErrorDeploymentType	错误行为类型的部署。 可能的值为 LastSuccessful 和 SpecificDeployment。

OnErrorDeploymentType

枚举

错误行为类型的部署。 可能的值为 LastSuccessful 和 SpecificDeployment。

值	说明
LastSuccessful
SpecificDeployment

ParametersLink

Object

表示对部署参数的引用的实体。

名称	类型	说明
contentVersion	string	如果包含，则必须匹配模板中的 ContentVersion。
uri	string	参数文件的 URI。

Provider

Object

资源提供程序信息。

名称	类型	说明
id	string	提供程序 ID。
namespace	string	资源提供程序的命名空间。
providerAuthorizationConsentState	ProviderAuthorizationConsentState	提供程序授权许可状态。
registrationPolicy	string	资源提供程序的注册策略。
registrationState	string	资源提供程序的注册状态。
resourceTypes	ProviderResourceType[]	提供程序资源类型的集合。

ProviderAuthorizationConsentState

枚举

提供程序授权许可状态。

值	说明
Consented
NotRequired
NotSpecified
Required

ProviderExtendedLocation

Object

提供程序扩展位置。

名称	类型	说明
extendedLocations	string[]	Azure 位置的扩展位置。
location	string	Azure 位置。
type	string	扩展位置类型。

ProviderResourceType

Object

资源提供程序管理的资源类型。

名称	类型	说明
aliases	Alias[]	此资源类型支持的别名。
apiProfiles	ApiProfile[]	资源提供程序的 API 配置文件。
apiVersions	string[]	API 版本。
capabilities	string	此资源类型提供的其他功能。
defaultApiVersion	string	默认 API 版本。
locationMappings	ProviderExtendedLocation[]	此资源类型支持的位置映射。
locations	string[]	可以创建此资源类型的位置的集合。
properties	object	属性。
resourceType	string	资源类型。
zoneMappings	ZoneMapping[]

ProvisioningState

枚举

表示预配的状态。

值	说明
Accepted
Canceled
Created
Creating
Deleted
Deleting
Failed
NotSpecified
Ready
Running
Succeeded
Updating

ResourceReference

Object

资源 ID 模型。

名称	类型	说明
id	string	完全限定的资源 ID。

TemplateLink

Object

表示对模板的引用的实体。

名称	类型	说明
contentVersion	string	如果包含，则必须匹配模板中的 ContentVersion。
id	string	模板规格的资源 ID。请使用 ID 或 uri 属性，但不能同时使用这两个属性。
queryString	string	要与 templateLink URI 一起使用的查询字符串（例如 SAS 令牌）。
relativePath	string	relativePath 属性可用于在相对于父级的位置部署链接模板。 如果父模板与 TemplateSpec 链接，则会引用 TemplateSpec 中的项目。 如果父级已链接到 URI，则子部署将是父 URI 和 relativePath URI 的组合
uri	string	要部署的模板的 URI。 使用 URI 或 ID 属性，但不能同时使用这两个属性。

ZoneMapping

Object

名称	类型	说明
location	string	区域映射的位置。
zones	string[]