다음을 통해 공유

Microsoft.Resources 배포 2024-03-01

  • 아티클

발언

Bicep의 경우 이 리소스 종류 대신 모듈 사용하여 것이 좋습니다.

Bicep 리소스 정의

다음을 대상으로 하는 작업을 사용하여 배포 리소스 유형을 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Resources/deployments 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.Resources/deployments@2024-03-01' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    debugSetting: {
      detailLevel: 'string'
    }
    expressionEvaluationOptions: {
      scope: 'string'
    }
    mode: 'string'
    onErrorDeployment: {
      deploymentName: 'string'
      type: 'string'
    }
    parameters: {
      {customized property}: {
        reference: {
          keyVault: {
            id: 'string'
          }
          secretName: 'string'
          secretVersion: 'string'
        }
        value: any(Azure.Bicep.Types.Concrete.AnyType)
      }
    }
    parametersLink: {
      contentVersion: 'string'
      uri: 'string'
    }
    template: any(Azure.Bicep.Types.Concrete.AnyType)
    templateLink: {
      contentVersion: 'string'
      id: 'string'
      queryString: 'string'
      relativePath: 'string'
      uri: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

DebugSetting

이름 묘사 값
detailLevel 디버깅을 위해 기록할 정보의 유형을 지정합니다. 허용되는 값은 none, requestContent, responseContent 또는 requestContent와 responseContent를 모두 쉼표로 구분합니다. 기본값은 none입니다. 이 값을 설정할 때 배포 중에 전달하는 정보 유형을 신중하게 고려합니다. 요청 또는 응답에 대한 정보를 로깅하면 배포 작업을 통해 검색되는 중요한 데이터를 노출할 수 있습니다. 문자열

DeploymentParameter

이름 묘사 값
참조 Azure Key Vault 매개 변수 참조입니다. KeyVaultParameterReference
값 매개 변수에 대한 입력 값입니다. 어떤

DeploymentPropertiesOrDeploymentPropertiesExtended

이름 묘사 값
debugSetting 배포의 디버그 설정입니다. DebugSetting
expressionEvaluationOptions 템플릿 식이 부모 템플릿 또는 중첩된 템플릿의 범위 내에서 평가되는지 여부를 지정합니다. 중첩된 템플릿에만 적용됩니다. 지정하지 않으면 기본값이 바깥값입니다. ExpressionEvaluationOptions
모드 리소스를 배포하는 데 사용되는 모드입니다. 이 값은 증분 또는 완료일 수 있습니다. 증분 모드에서는 템플릿에 포함되지 않은 기존 리소스를 삭제하지 않고 리소스를 배포합니다. 전체 모드에서는 리소스가 배포되고 템플릿에 포함되지 않은 리소스 그룹의 기존 리소스가 삭제됩니다. 의도치 않게 리소스를 삭제할 수 있으므로 완료 모드를 사용할 때는 주의해야 합니다. 'Complete'
'증분'(필수)
onErrorDeployment 오류 동작에 대한 배포입니다. OnErrorDeploymentOrOnErrorDeploymentExtended
매개 변수 템플릿의 배포 매개 변수를 정의하는 이름 및 값 쌍입니다. 기존 매개 변수 파일에 연결하는 대신 요청에 직접 매개 변수 값을 제공하려는 경우 이 요소를 사용합니다. parametersLink 속성 또는 매개 변수 속성을 사용하지만 둘 다 사용하지는 않습니다. JObject 또는 잘 구성된 JSON 문자열일 수 있습니다. DeploymentPropertiesParameters
parametersLink 매개 변수 파일의 URI입니다. 이 요소를 사용하여 기존 매개 변수 파일에 연결합니다. parametersLink 속성 또는 매개 변수 속성을 사용하지만 둘 다 사용하지는 않습니다. ParametersLink
템플렛 템플릿 콘텐츠입니다. 기존 템플릿에 연결하는 대신 요청에 직접 템플릿 구문을 전달하려는 경우 이 요소를 사용합니다. JObject 또는 잘 구성된 JSON 문자열일 수 있습니다. templateLink 속성 또는 템플릿 속성을 사용하지만 둘 다 사용하지는 않습니다. 어떤
templateLink 템플릿의 URI입니다. templateLink 속성 또는 템플릿 속성을 사용하지만 둘 다 사용하지는 않습니다. TemplateLink

DeploymentPropertiesParameters

이름 묘사 값

DeploymentTags

이름 묘사 값

ExpressionEvaluationOptions

이름 묘사 값
범위 중첩된 템플릿에서 매개 변수, 변수 및 함수를 평가하는 데 사용할 범위입니다. 'Inner'
'NotSpecified'
'외부'

KeyVaultParameterReference

이름 묘사 값
keyVault Azure Key Vault 참조입니다. KeyVaultReference(필수)
secretName Azure Key Vault 비밀 이름입니다. string(필수)
secretVersion Azure Key Vault 비밀 버전입니다. 문자열

KeyVaultReference

이름 묘사 값
아이디 Azure Key Vault 리소스 ID입니다. string(필수)

Microsoft.Resources/deployments

이름 묘사 값
위치 배포 데이터를 저장할 위치입니다. 문자열
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 1
패턴 = ^[-\w\._\(\)]+$(필수)
속성 배포 속성입니다. DeploymentPropertiesOrDeploymentPropertiesExtended(필수)
범위 배포 범위와 다른 범위에서 리소스를 만들 때 사용합니다. 확장 리소스적용하려면 이 속성을 리소스의 기호 이름으로 설정합니다.
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

OnErrorDeploymentOrOnErrorDeploymentExtended

이름 묘사 값
deploymentName 오류 사례에 사용할 배포입니다. 문자열
형 오류 동작 유형에 대한 배포입니다. 가능한 값은 LastSuccessful 및 SpecificDeployment입니다. 'LastSuccessful'
'SpecificDeployment'
이름 묘사 값
contentVersion 포함된 경우 템플릿의 ContentVersion과 일치해야 합니다. 문자열
uri 매개 변수 파일의 URI입니다. string(필수)
이름 묘사 값
contentVersion 포함된 경우 템플릿의 ContentVersion과 일치해야 합니다. 문자열
아이디 템플릿 사양의 리소스 ID입니다. ID 또는 uri 속성을 사용하지만 둘 다 사용하지는 않습니다. 문자열
queryString templateLink URI와 함께 사용할 쿼리 문자열(예: SAS 토큰)입니다. 문자열
relativePath relativePath 속성을 사용하여 부모에 상대적인 위치에 연결된 템플릿을 배포할 수 있습니다. 부모 템플릿이 TemplateSpec과 연결된 경우 TemplateSpec의 아티팩트를 참조합니다. 부모가 URI와 연결된 경우 자식 배포는 부모 및 relativePath URI의 조합이 됩니다. 문자열
uri 배포할 템플릿의 URI입니다. URI 또는 ID 속성을 사용하지만 둘 다 사용하지는 않습니다. 문자열

ARM 템플릿 리소스 정의

다음을 대상으로 하는 작업을 사용하여 배포 리소스 유형을 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Resources/deployments 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.Resources/deployments",
  "apiVersion": "2024-03-01",
  "name": "string",
  "location": "string",
  "properties": {
    "debugSetting": {
      "detailLevel": "string"
    },
    "expressionEvaluationOptions": {
      "scope": "string"
    },
    "mode": "string",
    "onErrorDeployment": {
      "deploymentName": "string",
      "type": "string"
    },
    "parameters": {
      "{customized property}": {
        "reference": {
          "keyVault": {
            "id": "string"
          },
          "secretName": "string",
          "secretVersion": "string"
        },
        "value": {}
      }
    },
    "parametersLink": {
      "contentVersion": "string",
      "uri": "string"
    },
    "template": {},
    "templateLink": {
      "contentVersion": "string",
      "id": "string",
      "queryString": "string",
      "relativePath": "string",
      "uri": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

DebugSetting

이름 묘사 값
detailLevel 디버깅을 위해 기록할 정보의 유형을 지정합니다. 허용되는 값은 none, requestContent, responseContent 또는 requestContent와 responseContent를 모두 쉼표로 구분합니다. 기본값은 none입니다. 이 값을 설정할 때 배포 중에 전달하는 정보 유형을 신중하게 고려합니다. 요청 또는 응답에 대한 정보를 로깅하면 배포 작업을 통해 검색되는 중요한 데이터를 노출할 수 있습니다. 문자열

DeploymentParameter

이름 묘사 값
참조 Azure Key Vault 매개 변수 참조입니다. KeyVaultParameterReference
값 매개 변수에 대한 입력 값입니다. 어떤

DeploymentPropertiesOrDeploymentPropertiesExtended

이름 묘사 값
debugSetting 배포의 디버그 설정입니다. DebugSetting
expressionEvaluationOptions 템플릿 식이 부모 템플릿 또는 중첩된 템플릿의 범위 내에서 평가되는지 여부를 지정합니다. 중첩된 템플릿에만 적용됩니다. 지정하지 않으면 기본값이 바깥값입니다. ExpressionEvaluationOptions
모드 리소스를 배포하는 데 사용되는 모드입니다. 이 값은 증분 또는 완료일 수 있습니다. 증분 모드에서는 템플릿에 포함되지 않은 기존 리소스를 삭제하지 않고 리소스를 배포합니다. 전체 모드에서는 리소스가 배포되고 템플릿에 포함되지 않은 리소스 그룹의 기존 리소스가 삭제됩니다. 의도치 않게 리소스를 삭제할 수 있으므로 완료 모드를 사용할 때는 주의해야 합니다. 'Complete'
'증분'(필수)
onErrorDeployment 오류 동작에 대한 배포입니다. OnErrorDeploymentOrOnErrorDeploymentExtended
매개 변수 템플릿의 배포 매개 변수를 정의하는 이름 및 값 쌍입니다. 기존 매개 변수 파일에 연결하는 대신 요청에 직접 매개 변수 값을 제공하려는 경우 이 요소를 사용합니다. parametersLink 속성 또는 매개 변수 속성을 사용하지만 둘 다 사용하지는 않습니다. JObject 또는 잘 구성된 JSON 문자열일 수 있습니다. DeploymentPropertiesParameters
parametersLink 매개 변수 파일의 URI입니다. 이 요소를 사용하여 기존 매개 변수 파일에 연결합니다. parametersLink 속성 또는 매개 변수 속성을 사용하지만 둘 다 사용하지는 않습니다. ParametersLink
템플렛 템플릿 콘텐츠입니다. 기존 템플릿에 연결하는 대신 요청에 직접 템플릿 구문을 전달하려는 경우 이 요소를 사용합니다. JObject 또는 잘 구성된 JSON 문자열일 수 있습니다. templateLink 속성 또는 템플릿 속성을 사용하지만 둘 다 사용하지는 않습니다. 어떤
templateLink 템플릿의 URI입니다. templateLink 속성 또는 템플릿 속성을 사용하지만 둘 다 사용하지는 않습니다. TemplateLink

DeploymentPropertiesParameters

이름 묘사 값

DeploymentTags

이름 묘사 값

ExpressionEvaluationOptions

이름 묘사 값
범위 중첩된 템플릿에서 매개 변수, 변수 및 함수를 평가하는 데 사용할 범위입니다. 'Inner'
'NotSpecified'
'외부'

KeyVaultParameterReference

이름 묘사 값
keyVault Azure Key Vault 참조입니다. KeyVaultReference(필수)
secretName Azure Key Vault 비밀 이름입니다. string(필수)
secretVersion Azure Key Vault 비밀 버전입니다. 문자열

KeyVaultReference

이름 묘사 값
아이디 Azure Key Vault 리소스 ID입니다. string(필수)

Microsoft.Resources/deployments

이름 묘사 값
apiVersion api 버전 '2024-03-01'
위치 배포 데이터를 저장할 위치입니다. 문자열
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 1
패턴 = ^[-\w\._\(\)]+$(필수)
속성 배포 속성입니다. DeploymentPropertiesOrDeploymentPropertiesExtended(필수)
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형 리소스 종류 'Microsoft.Resources/deployments'

OnErrorDeploymentOrOnErrorDeploymentExtended

이름 묘사 값
deploymentName 오류 사례에 사용할 배포입니다. 문자열
형 오류 동작 유형에 대한 배포입니다. 가능한 값은 LastSuccessful 및 SpecificDeployment입니다. 'LastSuccessful'
'SpecificDeployment'
이름 묘사 값
contentVersion 포함된 경우 템플릿의 ContentVersion과 일치해야 합니다. 문자열
uri 매개 변수 파일의 URI입니다. string(필수)
이름 묘사 값
contentVersion 포함된 경우 템플릿의 ContentVersion과 일치해야 합니다. 문자열
아이디 템플릿 사양의 리소스 ID입니다. ID 또는 uri 속성을 사용하지만 둘 다 사용하지는 않습니다. 문자열
queryString templateLink URI와 함께 사용할 쿼리 문자열(예: SAS 토큰)입니다. 문자열
relativePath relativePath 속성을 사용하여 부모에 상대적인 위치에 연결된 템플릿을 배포할 수 있습니다. 부모 템플릿이 TemplateSpec과 연결된 경우 TemplateSpec의 아티팩트를 참조합니다. 부모가 URI와 연결된 경우 자식 배포는 부모 및 relativePath URI의 조합이 됩니다. 문자열
uri 배포할 템플릿의 URI입니다. URI 또는 ID 속성을 사용하지만 둘 다 사용하지는 않습니다. 문자열

Terraform(AzAPI 공급자) 리소스 정의

다음을 대상으로 하는 작업을 사용하여 배포 리소스 유형을 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Resources/deployments 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Resources/deployments@2024-03-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      debugSetting = {
        detailLevel = "string"
      }
      expressionEvaluationOptions = {
        scope = "string"
      }
      mode = "string"
      onErrorDeployment = {
        deploymentName = "string"
        type = "string"
      }
      parameters = {
        {customized property} = {
          reference = {
            keyVault = {
              id = "string"
            }
            secretName = "string"
            secretVersion = "string"
          }
          value = ?
        }
      }
      parametersLink = {
        contentVersion = "string"
        uri = "string"
      }
      template = ?
      templateLink = {
        contentVersion = "string"
        id = "string"
        queryString = "string"
        relativePath = "string"
        uri = "string"
      }
    }
  })
}

속성 값

DebugSetting

이름 묘사 값
detailLevel 디버깅을 위해 기록할 정보의 유형을 지정합니다. 허용되는 값은 none, requestContent, responseContent 또는 requestContent와 responseContent를 모두 쉼표로 구분합니다. 기본값은 none입니다. 이 값을 설정할 때 배포 중에 전달하는 정보 유형을 신중하게 고려합니다. 요청 또는 응답에 대한 정보를 로깅하면 배포 작업을 통해 검색되는 중요한 데이터를 노출할 수 있습니다. 문자열

DeploymentParameter

이름 묘사 값
참조 Azure Key Vault 매개 변수 참조입니다. KeyVaultParameterReference
값 매개 변수에 대한 입력 값입니다. 어떤

DeploymentPropertiesOrDeploymentPropertiesExtended

이름 묘사 값
debugSetting 배포의 디버그 설정입니다. DebugSetting
expressionEvaluationOptions 템플릿 식이 부모 템플릿 또는 중첩된 템플릿의 범위 내에서 평가되는지 여부를 지정합니다. 중첩된 템플릿에만 적용됩니다. 지정하지 않으면 기본값이 바깥값입니다. ExpressionEvaluationOptions
모드 리소스를 배포하는 데 사용되는 모드입니다. 이 값은 증분 또는 완료일 수 있습니다. 증분 모드에서는 템플릿에 포함되지 않은 기존 리소스를 삭제하지 않고 리소스를 배포합니다. 전체 모드에서는 리소스가 배포되고 템플릿에 포함되지 않은 리소스 그룹의 기존 리소스가 삭제됩니다. 의도치 않게 리소스를 삭제할 수 있으므로 완료 모드를 사용할 때는 주의해야 합니다. 'Complete'
'증분'(필수)
onErrorDeployment 오류 동작에 대한 배포입니다. OnErrorDeploymentOrOnErrorDeploymentExtended
매개 변수 템플릿의 배포 매개 변수를 정의하는 이름 및 값 쌍입니다. 기존 매개 변수 파일에 연결하는 대신 요청에 직접 매개 변수 값을 제공하려는 경우 이 요소를 사용합니다. parametersLink 속성 또는 매개 변수 속성을 사용하지만 둘 다 사용하지는 않습니다. JObject 또는 잘 구성된 JSON 문자열일 수 있습니다. DeploymentPropertiesParameters
parametersLink 매개 변수 파일의 URI입니다. 이 요소를 사용하여 기존 매개 변수 파일에 연결합니다. parametersLink 속성 또는 매개 변수 속성을 사용하지만 둘 다 사용하지는 않습니다. ParametersLink
템플렛 템플릿 콘텐츠입니다. 기존 템플릿에 연결하는 대신 요청에 직접 템플릿 구문을 전달하려는 경우 이 요소를 사용합니다. JObject 또는 잘 구성된 JSON 문자열일 수 있습니다. templateLink 속성 또는 템플릿 속성을 사용하지만 둘 다 사용하지는 않습니다. 어떤
templateLink 템플릿의 URI입니다. templateLink 속성 또는 템플릿 속성을 사용하지만 둘 다 사용하지는 않습니다. TemplateLink

DeploymentPropertiesParameters

이름 묘사 값

DeploymentTags

이름 묘사 값

ExpressionEvaluationOptions

이름 묘사 값
범위 중첩된 템플릿에서 매개 변수, 변수 및 함수를 평가하는 데 사용할 범위입니다. 'Inner'
'NotSpecified'
'외부'

KeyVaultParameterReference

이름 묘사 값
keyVault Azure Key Vault 참조입니다. KeyVaultReference(필수)
secretName Azure Key Vault 비밀 이름입니다. string(필수)
secretVersion Azure Key Vault 비밀 버전입니다. 문자열

KeyVaultReference

이름 묘사 값
아이디 Azure Key Vault 리소스 ID입니다. string(필수)

Microsoft.Resources/deployments

이름 묘사 값
위치 배포 데이터를 저장할 위치입니다. 문자열
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 1
패턴 = ^[-\w\._\(\)]+$(필수)
parent_id 이 확장 리소스를 적용할 리소스의 ID입니다. string(필수)
속성 배포 속성입니다. DeploymentPropertiesOrDeploymentPropertiesExtended(필수)
태그 리소스 태그 태그 이름 및 값의 사전입니다.
형 리소스 종류 "Microsoft.Resources/deployments@2024-03-01"

OnErrorDeploymentOrOnErrorDeploymentExtended

이름 묘사 값
deploymentName 오류 사례에 사용할 배포입니다. 문자열
형 오류 동작 유형에 대한 배포입니다. 가능한 값은 LastSuccessful 및 SpecificDeployment입니다. 'LastSuccessful'
'SpecificDeployment'
이름 묘사 값
contentVersion 포함된 경우 템플릿의 ContentVersion과 일치해야 합니다. 문자열
uri 매개 변수 파일의 URI입니다. string(필수)
이름 묘사 값
contentVersion 포함된 경우 템플릿의 ContentVersion과 일치해야 합니다. 문자열
아이디 템플릿 사양의 리소스 ID입니다. ID 또는 uri 속성을 사용하지만 둘 다 사용하지는 않습니다. 문자열
queryString templateLink URI와 함께 사용할 쿼리 문자열(예: SAS 토큰)입니다. 문자열
relativePath relativePath 속성을 사용하여 부모에 상대적인 위치에 연결된 템플릿을 배포할 수 있습니다. 부모 템플릿이 TemplateSpec과 연결된 경우 TemplateSpec의 아티팩트를 참조합니다. 부모가 URI와 연결된 경우 자식 배포는 부모 및 relativePath URI의 조합이 됩니다. 문자열
uri 배포할 템플릿의 URI입니다. URI 또는 ID 속성을 사용하지만 둘 다 사용하지는 않습니다. 문자열