다음을 통해 공유

AFD Origins - Update

서비스:
Front Door Service
API 버전:
2025-04-15

원본 그룹 내에서 기존 원본을 업데이트합니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}/origins/{originName}?api-version=2025-04-15

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
originGroupName
 path True

string

프로필 내에서 고유한 원본 그룹의 이름입니다.
originName
 path True

string

프로필 내에서 고유한 원본의 이름입니다.
profileName
 path True

string

minLength: 1
maxLength: 260
pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

리소스 그룹 내에서 고유한 Azure Front Door 표준 또는 Azure Front Door Premium의 이름입니다.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId
 path True

string (uuid)

대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version
 query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

요청 본문

Name 형식 Description
properties.azureOrigin

ResourceReference

Azure 원본 리소스에 대한 리소스 참조입니다.
properties.enabledState

EnabledState

backendPools에 정의된 백 엔드에 대해 상태 프로브를 설정할지 여부입니다. 상태 프로브는 단일 지원 백 엔드 풀에 사용하도록 설정된 단일 백 엔드가 있는 경우에만 사용하지 않도록 설정할 수 있습니다.
properties.enforceCertificateNameCheck

boolean

원본 수준에서 인증서 이름 확인을 사용하도록 설정할지 여부
properties.hostName

string

원본의 주소입니다. 도메인 이름, IPv4 주소 및 IPv6 주소가 지원됩니다. 엔드포인트의 모든 원본에서 고유해야 합니다.
properties.httpPort

integer (int32)

minimum: 1
maximum: 65535
exclusiveMinimum: False
exclusiveMaximum: False

HTTP 포트의 값입니다. 1에서 65535 사이여야 합니다.
properties.httpsPort

integer (int32)

minimum: 1
maximum: 65535
exclusiveMinimum: False
exclusiveMaximum: False

HTTPS 포트의 값입니다. 1에서 65535 사이여야 합니다.
properties.originHostHeader

string

각 요청과 함께 원본으로 전송되는 호스트 헤더 값입니다. 이 값을 비워 두면 요청 호스트 이름이 이 값을 결정합니다. Web Apps, Blob Storage 및 Cloud Services와 같은 Azure Front Door 원본은 기본적으로 원본 호스트 이름과 일치하도록 이 호스트 헤더 값이 필요합니다. 엔드포인트에 정의된 호스트 헤더를 재정의합니다.
properties.priority

integer (int32)

minimum: 1
maximum: 5

부하 분산을 위해 지정된 원본 그룹의 원본 우선 순위입니다. 우선 순위가 낮은 원본이 정상인 경우 부하 분산에 더 높은 우선 순위가 사용되지 않습니다. 1에서 5 사이여야 합니다.
properties.sharedPrivateLinkResource

SharedPrivateLinkResourceProperties

프라이빗 원본에 대한 프라이빗 링크 리소스의 속성입니다.
properties.weight

integer (int32)

minimum: 1
maximum: 1000

부하 분산을 위해 지정된 원본 그룹의 원점 가중치입니다. 1에서 1000 사이여야 합니다.

응답

Name 형식 Description
200 OK

AFDOrigin

그래
202 Accepted

AFDOrigin

허용. 처리를 위해 요청이 수락되었으며 작업이 비동기적으로 완료됩니다.

헤더

location: string
Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 Azure Front Door 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

AFDOrigins_Update

샘플 요청

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/origingroup1/origins/origin1?api-version=2025-04-15

{
  "properties": {
    "hostName": "host1.blob.core.windows.net",
    "httpPort": 80,
    "httpsPort": 443,
    "enabledState": "Enabled"
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/origingroups/origingroup1/origins/origin1",
  "type": "Microsoft.Cdn/profiles/origingroups/origins",
  "name": "origin1",
  "properties": {
    "hostName": "host1.blob.core.windows.net",
    "httpPort": 80,
    "httpsPort": 443,
    "originHostHeader": "host1.foo.com",
    "priority": null,
    "weight": null,
    "enabledState": "Enabled",
    "provisioningState": "Succeeded",
    "deploymentStatus": "NotStarted",
    "originGroupName": "origingroup1",
    "sharedPrivateLinkResource": null,
    "enforceCertificateNameCheck": true
  }
}
상태 코드:
202 
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2025-04-15
{
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/origingroups/origingroup1/origins/origin1",
  "type": "Microsoft.Cdn/profiles/origingroups/origins",
  "name": "origin1",
  "properties": {
    "hostName": "host1.blob.core.windows.net",
    "httpPort": 80,
    "httpsPort": 443,
    "originHostHeader": "host1.foo.com",
    "priority": null,
    "weight": null,
    "enabledState": "Enabled",
    "provisioningState": "Updating",
    "deploymentStatus": "NotStarted",
    "originGroupName": "origingroup1",
    "sharedPrivateLinkResource": null,
    "enforceCertificateNameCheck": true
  }
}

정의

Name Description
AFDOrigin

Azure Front Door 원본은 Azure Front Door를 통해 배달되는 콘텐츠의 원본입니다. 엔드포인트가 나타내는 에지 노드에 요청된 콘텐츠가 캐시되지 않은 경우 구성된 원본 중 하나 이상에서 가져오려고 시도합니다.
AFDOriginUpdateParameters

원본 업데이트에 필요한 AFDOrigin 속성입니다.
AfdProvisioningState

프로비전 상태
createdByType

리소스를 만든 ID의 형식입니다.
DeploymentStatus
EnabledState

이 규칙의 사용을 사용하도록 설정할지 여부입니다. 허용되는 값은 'Enabled' 또는 'Disabled'입니다.
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.
ErrorDetail

오류 세부 정보입니다.
ErrorResponse

오류 응답
ResourceReference

다른 리소스에 대한 참조입니다.
SharedPrivateLinkResourceProperties

프라이빗 원본에 연결할 때 사용할 기존 공유 프라이빗 링크 리소스의 속성을 설명합니다.
SharedPrivateLinkResourceStatus

공유 프라이빗 링크 리소스의 상태입니다. 보류 중, 승인됨, 거부됨, 연결 끊김 또는 시간 제한일 수 있습니다.
systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

AFDOrigin

Object

Azure Front Door 원본은 Azure Front Door를 통해 배달되는 콘텐츠의 원본입니다. 엔드포인트가 나타내는 에지 노드에 요청된 콘텐츠가 캐시되지 않은 경우 구성된 원본 중 하나 이상에서 가져오려고 시도합니다.

Name 형식 Default value Description
id

string (arm-id)

리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

리소스의 이름
properties.azureOrigin

ResourceReference

Azure 원본 리소스에 대한 리소스 참조입니다.
properties.deploymentStatus

DeploymentStatus

properties.enabledState

EnabledState

backendPools에 정의된 백 엔드에 대해 상태 프로브를 설정할지 여부입니다. 상태 프로브는 단일 지원 백 엔드 풀에 사용하도록 설정된 단일 백 엔드가 있는 경우에만 사용하지 않도록 설정할 수 있습니다.
properties.enforceCertificateNameCheck

boolean

True

원본 수준에서 인증서 이름 확인을 사용하도록 설정할지 여부
properties.hostName

string

원본의 주소입니다. 도메인 이름, IPv4 주소 및 IPv6 주소가 지원됩니다. 엔드포인트의 모든 원본에서 고유해야 합니다.
properties.httpPort

integer (int32)

minimum: 1
maximum: 65535
exclusiveMinimum: False
exclusiveMaximum: False 		80

HTTP 포트의 값입니다. 1에서 65535 사이여야 합니다.
properties.httpsPort

integer (int32)

minimum: 1
maximum: 65535
exclusiveMinimum: False
exclusiveMaximum: False 		443

HTTPS 포트의 값입니다. 1에서 65535 사이여야 합니다.
properties.originGroupName

string

이 원본을 포함하는 원본 그룹의 이름입니다.
properties.originHostHeader

string

각 요청과 함께 원본으로 전송되는 호스트 헤더 값입니다. 이 값을 비워 두면 요청 호스트 이름이 이 값을 결정합니다. Web Apps, Blob Storage 및 Cloud Services와 같은 Azure Front Door 원본은 기본적으로 원본 호스트 이름과 일치하도록 이 호스트 헤더 값이 필요합니다. 엔드포인트에 정의된 호스트 헤더를 재정의합니다.
properties.priority

integer (int32)

minimum: 1
maximum: 5

부하 분산을 위해 지정된 원본 그룹의 원본 우선 순위입니다. 우선 순위가 낮은 원본이 정상인 경우 부하 분산에 더 높은 우선 순위가 사용되지 않습니다. 1에서 5 사이여야 합니다.
properties.provisioningState

AfdProvisioningState

프로비전 상태
properties.sharedPrivateLinkResource

SharedPrivateLinkResourceProperties

프라이빗 원본에 대한 프라이빗 링크 리소스의 속성입니다.
properties.weight

integer (int32)

minimum: 1
maximum: 1000

부하 분산을 위해 지정된 원본 그룹의 원점 가중치입니다. 1에서 1000 사이여야 합니다.
systemData

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
type

string

리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

AFDOriginUpdateParameters

Object

원본 업데이트에 필요한 AFDOrigin 속성입니다.

Name 형식 Default value Description
properties.azureOrigin

ResourceReference

Azure 원본 리소스에 대한 리소스 참조입니다.
properties.enabledState

EnabledState

backendPools에 정의된 백 엔드에 대해 상태 프로브를 설정할지 여부입니다. 상태 프로브는 단일 지원 백 엔드 풀에 사용하도록 설정된 단일 백 엔드가 있는 경우에만 사용하지 않도록 설정할 수 있습니다.
properties.enforceCertificateNameCheck

boolean

True

원본 수준에서 인증서 이름 확인을 사용하도록 설정할지 여부
properties.hostName

string

원본의 주소입니다. 도메인 이름, IPv4 주소 및 IPv6 주소가 지원됩니다. 엔드포인트의 모든 원본에서 고유해야 합니다.
properties.httpPort

integer (int32)

minimum: 1
maximum: 65535
exclusiveMinimum: False
exclusiveMaximum: False 		80

HTTP 포트의 값입니다. 1에서 65535 사이여야 합니다.
properties.httpsPort

integer (int32)

minimum: 1
maximum: 65535
exclusiveMinimum: False
exclusiveMaximum: False 		443

HTTPS 포트의 값입니다. 1에서 65535 사이여야 합니다.
properties.originGroupName

string

이 원본을 포함하는 원본 그룹의 이름입니다.
properties.originHostHeader

string

각 요청과 함께 원본으로 전송되는 호스트 헤더 값입니다. 이 값을 비워 두면 요청 호스트 이름이 이 값을 결정합니다. Web Apps, Blob Storage 및 Cloud Services와 같은 Azure Front Door 원본은 기본적으로 원본 호스트 이름과 일치하도록 이 호스트 헤더 값이 필요합니다. 엔드포인트에 정의된 호스트 헤더를 재정의합니다.
properties.priority

integer (int32)

minimum: 1
maximum: 5

부하 분산을 위해 지정된 원본 그룹의 원본 우선 순위입니다. 우선 순위가 낮은 원본이 정상인 경우 부하 분산에 더 높은 우선 순위가 사용되지 않습니다. 1에서 5 사이여야 합니다.
properties.sharedPrivateLinkResource

SharedPrivateLinkResourceProperties

프라이빗 원본에 대한 프라이빗 링크 리소스의 속성입니다.
properties.weight

integer (int32)

minimum: 1
maximum: 1000

부하 분산을 위해 지정된 원본 그룹의 원점 가중치입니다. 1에서 1000 사이여야 합니다.

AfdProvisioningState

열거형

프로비전 상태

값 Description
Creating
Deleting
Failed
Succeeded
Updating

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값 Description
Application
Key
ManagedIdentity
User

DeploymentStatus

열거형
값 Description
Failed
InProgress
NotStarted
Succeeded

EnabledState

열거형

이 규칙의 사용을 사용하도록 설정할지 여부입니다. 허용되는 값은 'Enabled' 또는 'Disabled'입니다.

값 Description
Disabled
Enabled

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

Object

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

ResourceReference

Object

다른 리소스에 대한 참조입니다.

Name 형식 Description
id

string

리소스 ID입니다.

SharedPrivateLinkResourceProperties

Object

프라이빗 원본에 연결할 때 사용할 기존 공유 프라이빗 링크 리소스의 속성을 설명합니다.

Name 형식 Description
groupId

string

공유 프라이빗 링크 리소스가 사용할 리소스 공급자의 그룹 ID입니다.
privateLink

ResourceReference

공유 프라이빗 링크 리소스의 리소스 ID입니다.
privateLinkLocation

string

공유 프라이빗 링크 리소스의 위치
requestMessage

string

공유 프라이빗 링크 리소스의 승인을 요청하기 위한 요청 메시지입니다.
status

SharedPrivateLinkResourceStatus

공유 프라이빗 링크 리소스의 상태입니다. 보류 중, 승인됨, 거부됨, 연결 끊김 또는 시간 제한일 수 있습니다.

SharedPrivateLinkResourceStatus

열거형

공유 프라이빗 링크 리소스의 상태입니다. 보류 중, 승인됨, 거부됨, 연결 끊김 또는 시간 제한일 수 있습니다.

값 Description
Approved
Disconnected
Pending
Rejected
Timeout

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string (date-time)

리소스 만들기의 타임스탬프(UTC)입니다.
createdBy

string

리소스를 만든 ID입니다.
createdByType

createdByType

리소스를 만든 ID의 형식입니다.
lastModifiedAt

string (date-time)

리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID의 형식입니다.