Swap Deployment

Swap Deployment 非同期操作は、サービスのステージングデプロイ環境と運用デプロイ環境間で仮想 IP アドレススワップを開始します。サービスが現在ステージング環境で実行されている場合は、運用環境にスワップされます。運用環境で実行されている場合は、ステージング環境にスワップされます。

要求

Swap Deployment要求は、次のように指定できます。 <subscription-id> をサブスクリプション ID で、<cloudservice-name> をクラウドサービスの名前でそれぞれ置き換えます。

Method	要求 URI
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>`

URI パラメーター

なし。

要求ヘッダー

要求ヘッダーの説明を次の表に示します。

要求ヘッダー	説明
`Content-Type`	必須。このヘッダーには、`application/xml` を設定します。
`x-ms-version`	必須。この要求に使用する操作のバージョンを指定します。このヘッダーは以上に設定する `2009-10-01` 必要があります。

要求本文

要求本文の形式は次のとおりです。

  
<?xml version="1.0" encoding="utf-8"?>  
<Swap xmlns="http://schemas.microsoft.com/windowsazure">  
  <Production>production-deployment-name</Production>  
  <SourceDeployment>deployment-name-to-be-swapped-with-production</SourceDeployment>  
</Swap>

要求本文の要素を次の表に示します。

要素名	説明
Production	必須。運用デプロイの名前。
SourceDeployment	必須。ソースデプロイの名前。

[応答]

応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。

状態コード

操作に成功すると、状態コード 200 (OK) が返されます。

レスポンスヘッダー

この操作の応答には、次のヘッダーが含まれています。応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。

応答ヘッダー	Description
`x-ms-request-id`	管理サービスに対して行われた要求を一意に識別する値。非同期操作の場合は、ヘッダーの値を指定して Get Operation Status を呼び出して、操作が完了したか、失敗したか、進行中であるかを判断できます。

応答本文

[なし] :

解説

Swap Deployment 操作で指定しているデプロイ名が、現在の運用およびステージングでの名前と一致しない場合、ステータスコード 409 (Conflict) が返されます。

VIP アドレススワップを実行できるのは、サービス定義によって指定されているエンドポイントの数が両方のデプロイで等しい場合だけです。たとえば、これまで HTTP エンドポイントだけを公開していた Web ロールに HTTPS エンドポイントを追加した場合は、VIP アドレスをスワップしてサービスをアップグレードできません。代わりに、運用環境のデプロイを削除して再デプロイする必要があります。デプロイの取得操作を使用して、使用されるエンドポイントに関する情報を取得できます。

最終更新: 2023-08-05