次の方法で共有

Origins - Update

サービス:
CDN
API バージョン:
2025-04-15

エンドポイント内の既存の配信元を更新します。

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

URI パラメーター

名前 / 必須 型 説明
endpointName
 path True

string

グローバルに一意であるプロファイルの下のエンドポイントの名前。
originName
 path True

string

エンドポイント内で一意である配信元の名前。
profileName
 path True

string

リソース グループ内で一意である CDN プロファイルの名前。
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前は大文字と小文字が区別されます。
subscriptionId
 path True

string (uuid)

ターゲット サブスクリプションの ID。 値は UUID である必要があります。
api-version
 query True

string

minLength: 1

この操作に使用する API バージョン。

要求本文

名前 型 説明
properties.enabled

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 CDN 配信元では、このホスト ヘッダー値が既定で配信元のホスト名と一致する必要があります。 これにより、エンドポイントで定義されているホスト ヘッダーがオーバーライドされます。
properties.priority

integer (int32)

minimum: 1
maximum: 5

負荷分散のための、指定された配信元グループ内の配信元の優先順位。 優先順位の低い配信元が正常な場合は、優先順位が高いほど負荷分散には使用されません。1 ~ 5 の間である必要があります
properties.privateLinkAlias

string

Private Link リソースのエイリアス。 この省略可能なフィールドに値を設定すると、この配信元が "プライベート" であることを示します
properties.privateLinkApprovalMessage

string

Private Link に接続するための承認要求に含めるカスタム メッセージ。
properties.privateLinkLocation

string

Private Link リソースの場所。 'privateLinkResourceId' が設定されている場合にのみ必要です
properties.privateLinkResourceId

string

Private Link リソースのリソース ID。 この省略可能なフィールドに値を設定すると、このバックエンドが 'Private' であることを示します
properties.weight

integer (int32)

minimum: 1
maximum: 1000

負荷分散のための、指定された配信元グループ内の原点の重み。 1 ~ 1000 の間である必要があります

応答

名前 型 説明
200 OK

Origin

わかりました。 要求は成功しました。
202 Accepted

Origin

受け入れられ、操作は非同期的に完了します。

ヘッダー

location: string
Other Status Codes

ErrorResponse

操作が失敗した理由を説明する CDN エラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

例

Origins_Update

要求のサンプル

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net?api-version=2025-04-15

{
  "properties": {
    "httpPort": 42,
    "httpsPort": 43,
    "originHostHeader": "www.someDomain2.net",
    "priority": 1,
    "weight": 50,
    "enabled": true,
    "privateLinkAlias": "APPSERVER.d84e61f0-0870-4d24-9746-7438fa0019d1.westus2.azure.privatelinkservice"
  }
}

応答のサンプル

状態コード:
200 
{
  "name": "www-someDomain-net",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
  "type": "Microsoft.Cdn/profiles/endpoints/origins",
  "properties": {
    "provisioningState": "Succeeded",
    "resourceState": "Active",
    "hostName": "www.someDomain.net",
    "httpPort": 42,
    "httpsPort": 43,
    "originHostHeader": "www.someDomain2.net",
    "priority": 1,
    "weight": 50,
    "enabled": true,
    "privateEndpointStatus": "Pending",
    "privateLinkApprovalMessage": "Please approve the connection request for this Private Link",
    "privateLinkAlias": "APPSERVER.d84e61f0-0870-4d24-9746-7438fa0019d1.westus2.azure.privatelinkservice"
  }
}
状態コード:
202 
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2025-04-15
{
  "name": "www-someDomain-net",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/www-someDomain-net",
  "type": "Microsoft.Cdn/profiles/endpoints/origins",
  "properties": {
    "provisioningState": "Succeeded",
    "resourceState": "Active",
    "hostName": "www.someDomain.net",
    "httpPort": 42,
    "httpsPort": 43,
    "originHostHeader": "www.someDomain2.net",
    "priority": 1,
    "weight": 50,
    "enabled": true,
    "privateEndpointStatus": "Pending",
    "privateLinkApprovalMessage": "Please approve the connection request for this Private Link",
    "privateLinkAlias": "APPSERVER.d84e61f0-0870-4d24-9746-7438fa0019d1.westus2.azure.privatelinkservice"
  }
}

定義

名前 説明
createdByType

リソースを作成した ID の種類。
ErrorAdditionalInfo

リソース管理エラーの追加情報。
ErrorDetail

エラーの詳細。
ErrorResponse

エラー応答
Origin

CDN 配信元は、CDN 経由で配信されるコンテンツのソースです。 エンドポイントによって表されるエッジ ノードに要求されたコンテンツがキャッシュされていない場合は、構成された 1 つ以上の配信元からそれをフェッチしようとします。
OriginProvisioningState

配信元のプロビジョニング状態。
OriginResourceState

配信元のリソースの状態。
OriginUpdateParameters

配信元の更新に必要な配信元プロパティ。
PrivateEndpointStatus

Private Link への接続の承認状態
systemData

リソースの作成と最後の変更に関連するメタデータ。

createdByType

列挙

リソースを作成した ID の種類。

値 説明
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前 型 説明
info

object

追加情報。
type

string

追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
code

string

エラー コード。
details

ErrorDetail[]

エラーの詳細。
message

string

エラー メッセージ。
target

string

エラーターゲット。

ErrorResponse

Object

エラー応答

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

Origin

Object

CDN 配信元は、CDN 経由で配信されるコンテンツのソースです。 エンドポイントによって表されるエッジ ノードに要求されたコンテンツがキャッシュされていない場合は、構成された 1 つ以上の配信元からそれをフェッチしようとします。

名前 型 説明
id

string (arm-id)

リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

リソースの名前
properties.enabled

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 CDN 配信元では、このホスト ヘッダー値が既定で配信元のホスト名と一致する必要があります。 これにより、エンドポイントで定義されているホスト ヘッダーがオーバーライドされます。
properties.priority

integer (int32)

minimum: 1
maximum: 5

負荷分散のための、指定された配信元グループ内の配信元の優先順位。 優先順位の低い配信元が正常な場合は、優先順位が高いほど負荷分散には使用されません。1 ~ 5 の間である必要があります
properties.privateEndpointStatus

PrivateEndpointStatus

Private Link への接続の承認状態
properties.privateLinkAlias

string

Private Link リソースのエイリアス。 この省略可能なフィールドに値を設定すると、この配信元が "プライベート" であることを示します
properties.privateLinkApprovalMessage

string

Private Link に接続するための承認要求に含めるカスタム メッセージ。
properties.privateLinkLocation

string

Private Link リソースの場所。 'privateLinkResourceId' が設定されている場合にのみ必要です
properties.privateLinkResourceId

string

Private Link リソースのリソース ID。 この省略可能なフィールドに値を設定すると、このバックエンドが 'Private' であることを示します
properties.provisioningState

OriginProvisioningState

配信元のプロビジョニング状態。
properties.resourceState

OriginResourceState

配信元のリソースの状態。
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"

OriginProvisioningState

列挙

配信元のプロビジョニング状態。

値 説明
Creating
Deleting
Failed
Succeeded
Updating

OriginResourceState

列挙

配信元のリソースの状態。

値 説明
Active
Creating
Deleting

OriginUpdateParameters

Object

配信元の更新に必要な配信元プロパティ。

名前 型 説明
properties.enabled

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 CDN 配信元では、このホスト ヘッダー値が既定で配信元のホスト名と一致する必要があります。 これにより、エンドポイントで定義されているホスト ヘッダーがオーバーライドされます。
properties.priority

integer (int32)

minimum: 1
maximum: 5

負荷分散のための、指定された配信元グループ内の配信元の優先順位。 優先順位の低い配信元が正常な場合は、優先順位が高いほど負荷分散には使用されません。1 ~ 5 の間である必要があります
properties.privateLinkAlias

string

Private Link リソースのエイリアス。 この省略可能なフィールドに値を設定すると、この配信元が "プライベート" であることを示します
properties.privateLinkApprovalMessage

string

Private Link に接続するための承認要求に含めるカスタム メッセージ。
properties.privateLinkLocation

string

Private Link リソースの場所。 'privateLinkResourceId' が設定されている場合にのみ必要です
properties.privateLinkResourceId

string

Private Link リソースのリソース ID。 この省略可能なフィールドに値を設定すると、このバックエンドが 'Private' であることを示します
properties.weight

integer (int32)

minimum: 1
maximum: 1000

負荷分散のための、指定された配信元グループ内の原点の重み。 1 ~ 1000 の間である必要があります

PrivateEndpointStatus

列挙

Private Link への接続の承認状態

値 説明
Approved
Disconnected
Pending
Rejected
Timeout

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前 型 説明
createdAt

string (date-time)

リソース作成のタイムスタンプ (UTC)。
createdBy

string

リソースを作成した ID。
createdByType

createdByType

リソースを作成した ID の種類。
lastModifiedAt

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy

string

リソースを最後に変更した ID。
lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。