DeploymentOperationsExtensions.UpgradeByName メソッド

定義

名前空間:

Microsoft.WindowsAzure.Management.Compute

アセンブリ:

Microsoft.WindowsAzure.Management.Compute.dll

パッケージ:

Microsoft.WindowsAzure.Management.Compute v14.0.0

名前によるデプロイのアップグレード操作では、指定したパッケージと構成を使用して、デプロイ内のロール インスタンスの更新を開始します。 ロール インスタンスの更新の詳細については、「Update an Azure Service at http://msdn.microsoft.com/en-us/library/windowsazure/hh472157.aspx」を参照してください。 この操作は非同期操作です。 要求が処理されたかどうかを確認するには、Get Operation Status を呼び出します。 非同期操作の詳細については、「 での非同期サービス管理要求の http://msdn.microsoft.com/en-us/library/windowsazure/ee460791.aspx追跡」を参照してください。 展開の自動更新を実行するには、Mode 要素を automatic に設定して、展開のアップグレードまたは展開構成の変更を呼び出します。 さらに入力しなくても、更新はそのポイントから続行されます。 Get Operation Status を呼び出して、更新が完了したタイミングを確認できます。 手動更新を実行するには、まず Mode 要素を manual に設定して Upgrade Deployment を呼び出します。 次に、Walk Upgrade Domain を呼び出して、デプロイ内の各ドメインを更新します。 次のドメインを更新する前に Get Operation Status を呼び出して、操作が完了したことを確認する必要があります。 重要: ロール インスタンスを追加または削除する更新プログラムでは、クラウド サービスにデプロイされているすべてのロールに対する構成の更新が行われます。 既存のロール インスタンスでは、すべてのロール インスタンスがクラウド サービスで通信できるように、新しいロール インスタンスについての通知を受ける必要があります。 既定では、デプロイされるクラウド サービスあたりの更新ドメインの数は 5 つです。インプレース更新中はこれらのドメインが一度に 1 つずつ更新されます。 サービス定義ファイル内の更新ドメインの数の変更については、「Azure サービス定義スキーマ (.csdef ファイル)」を参照してください。 Windows Azure で特定のインスタンスが実行されている更新ドメインを確認するには、RoleInstance クラスの UpdateDomain プロパティを使用します。 詳細については、Azure マネージド ライブラリ リファレンスに関するページ http://msdn.microsoft.com/en-us/library/windowsazure/dd179380.aspx を参照してください。 (詳細については、 を参照 http://msdn.microsoft.com/en-us/library/windowsazure/ee460793.aspx してください)

public static Microsoft.Azure.OperationStatusResponse UpgradeByName (this Microsoft.WindowsAzure.Management.Compute.IDeploymentOperations operations, string serviceName, string deploymentName, Microsoft.WindowsAzure.Management.Compute.Models.DeploymentUpgradeParameters parameters);

static member UpgradeByName : Microsoft.WindowsAzure.Management.Compute.IDeploymentOperations * string * string * Microsoft.WindowsAzure.Management.Compute.Models.DeploymentUpgradeParameters -> Microsoft.Azure.OperationStatusResponse

<Extension()>
Public Function UpgradeByName (operations As IDeploymentOperations, serviceName As String, deploymentName As String, parameters As DeploymentUpgradeParameters) As OperationStatusResponse

パラメーター

operations

IDeploymentOperations

Microsoft.WindowsAzure.Management.Compute.IDeploymentOperations への参照。

serviceName

String

必須です。 アップグレードするクラウド サービス。

deploymentName

String

必須です。 アップグレードするデプロイ。

parameters

DeploymentUpgradeParameters

必須です。 名前による展開のアップグレード操作に指定されたパラメーター。

戻り値

Microsoft.Azure.OperationStatusResponse

応答本文には、指定した非同期操作の状態が含まれ、成功したか、失敗したかが示されます。 この状態は、操作状態の取得操作自体に返される HTTP 状態コードとは異なります。 非同期操作が正常に終了した場合、応答本文には正常終了した要求の HTTP ステータス コードが含まれます。 非同期操作が失敗した場合、応答本文には、失敗した要求の HTTP 状態コードと、エラーに関するエラー情報が含まれます。